1. Packages
  2. Linode Provider
  3. API Docs
  4. getRegion
Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

linode.getRegion

linode logo
Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

    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/v5/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,
               opts: Optional[InvokeOptions] = None) -> GetRegionResult
def get_region_output(id: Optional[pulumi.Input[str]] = 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)
public static Output<GetRegionResult> getRegion(GetRegionArgs args, InvokeOptions options)

    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.
    Id string
    The code name of the region to select.
    id String
    The code name of the region to select.
    id string
    The code name of the region to select.
    id str
    The code name of the region to select.
    id String
    The code name of the region to select.

    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.
    Monitors GetRegionMonitors
    PlacementGroupLimits List<GetRegionPlacementGroupLimit>
    Resolvers List<GetRegionResolver>
    SiteType string
    The type of this region.
    Status string
    This region’s current operational status (ok or outage).
    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.
    Monitors GetRegionMonitors
    PlacementGroupLimits []GetRegionPlacementGroupLimit
    Resolvers []GetRegionResolver
    SiteType string
    The type of this region.
    Status string
    This region’s current operational status (ok or outage).
    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.
    monitors GetRegionMonitors
    placementGroupLimits List<GetRegionPlacementGroupLimit>
    resolvers List<GetRegionResolver>
    siteType String
    The type of this region.
    status String
    This region’s current operational status (ok or outage).
    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.
    monitors GetRegionMonitors
    placementGroupLimits GetRegionPlacementGroupLimit[]
    resolvers GetRegionResolver[]
    siteType string
    The type of this region.
    status string
    This region’s current operational status (ok or outage).
    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.
    monitors GetRegionMonitors
    placement_group_limits Sequence[GetRegionPlacementGroupLimit]
    resolvers Sequence[GetRegionResolver]
    site_type str
    The type of this region.
    status str
    This region’s current operational status (ok or outage).
    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.
    monitors Property Map
    placementGroupLimits List<Property Map>
    resolvers List<Property Map>
    siteType String
    The type of this region.
    status String
    This region’s current operational status (ok or outage).

    Supporting Types

    GetRegionMonitors

    Alerts List<string>
    A list of ACLP alerts services supported in the region.
    Metrics List<string>
    A list of ACLP metrics services supported in the region.
    Alerts []string
    A list of ACLP alerts services supported in the region.
    Metrics []string
    A list of ACLP metrics services supported in the region.
    alerts List<String>
    A list of ACLP alerts services supported in the region.
    metrics List<String>
    A list of ACLP metrics services supported in the region.
    alerts string[]
    A list of ACLP alerts services supported in the region.
    metrics string[]
    A list of ACLP metrics services supported in the region.
    alerts Sequence[str]
    A list of ACLP alerts services supported in the region.
    metrics Sequence[str]
    A list of ACLP metrics services supported in the region.
    alerts List<String>
    A list of ACLP alerts services supported in the region.
    metrics List<String>
    A list of ACLP metrics services supported in the region.

    GetRegionPlacementGroupLimit

    MaximumLinodesPerPg int
    The maximum number of Linodes allowed to be assigned to a placement group in this region.
    MaximumPgsPerCustomer int
    The maximum number of placement groups allowed for the current user in this region.
    MaximumLinodesPerPg int
    The maximum number of Linodes allowed to be assigned to a placement group in this region.
    MaximumPgsPerCustomer int
    The maximum number of placement groups allowed for the current user in this region.
    maximumLinodesPerPg Integer
    The maximum number of Linodes allowed to be assigned to a placement group in this region.
    maximumPgsPerCustomer Integer
    The maximum number of placement groups allowed for the current user in this region.
    maximumLinodesPerPg number
    The maximum number of Linodes allowed to be assigned to a placement group in this region.
    maximumPgsPerCustomer number
    The maximum number of placement groups allowed for the current user in this region.
    maximum_linodes_per_pg int
    The maximum number of Linodes allowed to be assigned to a placement group in this region.
    maximum_pgs_per_customer int
    The maximum number of placement groups allowed for the current user in this region.
    maximumLinodesPerPg Number
    The maximum number of Linodes allowed to be assigned to a placement group in this region.
    maximumPgsPerCustomer Number
    The maximum number of placement groups allowed for the current user in this region.

    GetRegionResolver

    Ipv4 string
    The IPv4 addresses for this region’s DNS resolvers, separated by commas.
    Ipv6 string
    The IPv6 addresses for this region’s DNS resolvers, separated by commas.
    Ipv4 string
    The IPv4 addresses for this region’s DNS resolvers, separated by commas.
    Ipv6 string
    The IPv6 addresses for this region’s DNS resolvers, separated by commas.
    ipv4 String
    The IPv4 addresses for this region’s DNS resolvers, separated by commas.
    ipv6 String
    The IPv6 addresses for this region’s DNS resolvers, separated by commas.
    ipv4 string
    The IPv4 addresses for this region’s DNS resolvers, separated by commas.
    ipv6 string
    The IPv6 addresses for this region’s DNS resolvers, separated by commas.
    ipv4 str
    The IPv4 addresses for this region’s DNS resolvers, separated by commas.
    ipv6 str
    The IPv6 addresses for this region’s DNS resolvers, separated by commas.
    ipv4 String
    The IPv4 addresses for this region’s DNS resolvers, separated by commas.
    ipv6 String
    The IPv6 addresses for this region’s DNS resolvers, separated by commas.

    Package Details

    Repository
    Linode pulumi/pulumi-linode
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the linode Terraform Provider.
    linode logo
    Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
    Schema (JSON)
    pulumi/pulumi-linode
      Meet Neo: Your AI Platform Teammate