Linode v4.30.1 published on Thursday, Nov 21, 2024 by Pulumi
linode.getRegion
Explore with Pulumi AI
linode.getRegion
provides details about a specific Linode region. See all regions here.
For more information, see the Linode APIv4 docs.
Example Usage
The following example shows how the resource might be used to obtain additional information about a Linode region.
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const region = linode.getRegion({
id: "us-east",
});
import pulumi
import pulumi_linode as linode
region = linode.get_region(id="us-east")
package main
import (
"github.com/pulumi/pulumi-linode/sdk/v4/go/linode"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := linode.GetRegion(ctx, &linode.GetRegionArgs{
Id: "us-east",
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var region = Linode.GetRegion.Invoke(new()
{
Id = "us-east",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetRegionArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var region = LinodeFunctions.getRegion(GetRegionArgs.builder()
.id("us-east")
.build());
}
}
variables:
region:
fn::invoke:
Function: linode:getRegion
Arguments:
id: us-east
Using getRegion
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getRegion(args: GetRegionArgs, opts?: InvokeOptions): Promise<GetRegionResult>
function getRegionOutput(args: GetRegionOutputArgs, opts?: InvokeOptions): Output<GetRegionResult>
def get_region(id: Optional[str] = None,
resolvers: Optional[Sequence[GetRegionResolver]] = None,
opts: Optional[InvokeOptions] = None) -> GetRegionResult
def get_region_output(id: Optional[pulumi.Input[str]] = None,
resolvers: Optional[pulumi.Input[Sequence[pulumi.Input[GetRegionResolverArgs]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetRegionResult]
func GetRegion(ctx *Context, args *GetRegionArgs, opts ...InvokeOption) (*GetRegionResult, error)
func GetRegionOutput(ctx *Context, args *GetRegionOutputArgs, opts ...InvokeOption) GetRegionResultOutput
> Note: This function is named GetRegion
in the Go SDK.
public static class GetRegion
{
public static Task<GetRegionResult> InvokeAsync(GetRegionArgs args, InvokeOptions? opts = null)
public static Output<GetRegionResult> Invoke(GetRegionInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRegionResult> getRegion(GetRegionArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: linode:index/getRegion:getRegion
arguments:
# arguments dictionary
The following arguments are supported:
- Id string
- The code name of the region to select.
- Resolvers
List<Get
Region Resolver>
- Id string
- The code name of the region to select.
- Resolvers
[]Get
Region Resolver
- id String
- The code name of the region to select.
- resolvers
List<Get
Region Resolver>
- id string
- The code name of the region to select.
- resolvers
Get
Region Resolver[]
- id str
- The code name of the region to select.
- resolvers
Sequence[Get
Region Resolver]
- id String
- The code name of the region to select.
- resolvers List<Property Map>
getRegion Result
The following output properties are available:
- Capabilities List<string>
- A list of capabilities of this region.
- Country string
- The country the region resides in.
- Id string
- Label string
- Detailed location information for this Region, including city, state or region, and country.
- Placement
Group List<GetLimits Region Placement Group Limit> - Site
Type string - The type of this region.
- Status string
- This region’s current operational status (ok or outage).
- Resolvers
List<Get
Region Resolver>
- Capabilities []string
- A list of capabilities of this region.
- Country string
- The country the region resides in.
- Id string
- Label string
- Detailed location information for this Region, including city, state or region, and country.
- Placement
Group []GetLimits Region Placement Group Limit - Site
Type string - The type of this region.
- Status string
- This region’s current operational status (ok or outage).
- Resolvers
[]Get
Region Resolver
- capabilities List<String>
- A list of capabilities of this region.
- country String
- The country the region resides in.
- id String
- label String
- Detailed location information for this Region, including city, state or region, and country.
- placement
Group List<GetLimits Region Placement Group Limit> - site
Type String - The type of this region.
- status String
- This region’s current operational status (ok or outage).
- resolvers
List<Get
Region Resolver>
- capabilities string[]
- A list of capabilities of this region.
- country string
- The country the region resides in.
- id string
- label string
- Detailed location information for this Region, including city, state or region, and country.
- placement
Group GetLimits Region Placement Group Limit[] - site
Type string - The type of this region.
- status string
- This region’s current operational status (ok or outage).
- resolvers
Get
Region Resolver[]
- capabilities Sequence[str]
- A list of capabilities of this region.
- country str
- The country the region resides in.
- id str
- label str
- Detailed location information for this Region, including city, state or region, and country.
- placement_
group_ Sequence[Getlimits Region Placement Group Limit] - site_
type str - The type of this region.
- status str
- This region’s current operational status (ok or outage).
- resolvers
Sequence[Get
Region Resolver]
- capabilities List<String>
- A list of capabilities of this region.
- country String
- The country the region resides in.
- id String
- label String
- Detailed location information for this Region, including city, state or region, and country.
- placement
Group List<Property Map>Limits - site
Type String - The type of this region.
- status String
- This region’s current operational status (ok or outage).
- resolvers List<Property Map>
Supporting Types
GetRegionPlacementGroupLimit
- Maximum
Linodes intPer Pg - The maximum number of Linodes allowed to be assigned to a placement group in this region.
- Maximum
Pgs intPer Customer - The maximum number of placement groups allowed for the current user in this region.
- Maximum
Linodes intPer Pg - The maximum number of Linodes allowed to be assigned to a placement group in this region.
- Maximum
Pgs intPer Customer - The maximum number of placement groups allowed for the current user in this region.
- maximum
Linodes IntegerPer Pg - The maximum number of Linodes allowed to be assigned to a placement group in this region.
- maximum
Pgs IntegerPer Customer - The maximum number of placement groups allowed for the current user in this region.
- maximum
Linodes numberPer Pg - The maximum number of Linodes allowed to be assigned to a placement group in this region.
- maximum
Pgs numberPer Customer - The maximum number of placement groups allowed for the current user in this region.
- maximum_
linodes_ intper_ pg - The maximum number of Linodes allowed to be assigned to a placement group in this region.
- maximum_
pgs_ intper_ customer - The maximum number of placement groups allowed for the current user in this region.
- maximum
Linodes NumberPer Pg - The maximum number of Linodes allowed to be assigned to a placement group in this region.
- maximum
Pgs NumberPer Customer - The maximum number of placement groups allowed for the current user in this region.
GetRegionResolver
Package Details
- Repository
- Linode pulumi/pulumi-linode
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
linode
Terraform Provider.