1. Packages
  2. Gcore Provider
  3. API Docs
  4. getCloudRegions
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core
gcore logo
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core

    Regions represent available Gcore cloud data centers with information about supported services and volume types.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const exampleCloudRegions = gcore.getCloudRegions({
        displayName: "Luxembourg",
        product: "inference",
    });
    
    import pulumi
    import pulumi_gcore as gcore
    
    example_cloud_regions = gcore.get_cloud_regions(display_name="Luxembourg",
        product="inference")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := gcore.GetCloudRegions(ctx, &gcore.GetCloudRegionsArgs{
    			DisplayName: pulumi.StringRef("Luxembourg"),
    			Product:     pulumi.StringRef("inference"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var exampleCloudRegions = Gcore.GetCloudRegions.Invoke(new()
        {
            DisplayName = "Luxembourg",
            Product = "inference",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.GcoreFunctions;
    import com.pulumi.gcore.inputs.GetCloudRegionsArgs;
    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 exampleCloudRegions = GcoreFunctions.getCloudRegions(GetCloudRegionsArgs.builder()
                .displayName("Luxembourg")
                .product("inference")
                .build());
    
        }
    }
    
    variables:
      exampleCloudRegions:
        fn::invoke:
          function: gcore:getCloudRegions
          arguments:
            displayName: Luxembourg
            product: inference
    

    Using getCloudRegions

    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 getCloudRegions(args: GetCloudRegionsArgs, opts?: InvokeOptions): Promise<GetCloudRegionsResult>
    function getCloudRegionsOutput(args: GetCloudRegionsOutputArgs, opts?: InvokeOptions): Output<GetCloudRegionsResult>
    def get_cloud_regions(display_name: Optional[str] = None,
                          max_items: Optional[float] = None,
                          order_by: Optional[str] = None,
                          product: Optional[str] = None,
                          show_volume_types: Optional[bool] = None,
                          opts: Optional[InvokeOptions] = None) -> GetCloudRegionsResult
    def get_cloud_regions_output(display_name: Optional[pulumi.Input[str]] = None,
                          max_items: Optional[pulumi.Input[float]] = None,
                          order_by: Optional[pulumi.Input[str]] = None,
                          product: Optional[pulumi.Input[str]] = None,
                          show_volume_types: Optional[pulumi.Input[bool]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetCloudRegionsResult]
    func GetCloudRegions(ctx *Context, args *GetCloudRegionsArgs, opts ...InvokeOption) (*GetCloudRegionsResult, error)
    func GetCloudRegionsOutput(ctx *Context, args *GetCloudRegionsOutputArgs, opts ...InvokeOption) GetCloudRegionsResultOutput

    > Note: This function is named GetCloudRegions in the Go SDK.

    public static class GetCloudRegions 
    {
        public static Task<GetCloudRegionsResult> InvokeAsync(GetCloudRegionsArgs args, InvokeOptions? opts = null)
        public static Output<GetCloudRegionsResult> Invoke(GetCloudRegionsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetCloudRegionsResult> getCloudRegions(GetCloudRegionsArgs args, InvokeOptions options)
    public static Output<GetCloudRegionsResult> getCloudRegions(GetCloudRegionsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gcore:index/getCloudRegions:getCloudRegions
      arguments:
        # arguments dictionary

    The following arguments are supported:

    DisplayName string
    Filter regions by display name. Case-insensitive exact match.
    MaxItems double
    Max items to fetch, default: 1000
    OrderBy string
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    Product string
    If defined then return only regions that support given product. Available values: "containers", "inference".
    ShowVolumeTypes bool
    If true, null available_volume_type is replaced with a list of available volume types.
    DisplayName string
    Filter regions by display name. Case-insensitive exact match.
    MaxItems float64
    Max items to fetch, default: 1000
    OrderBy string
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    Product string
    If defined then return only regions that support given product. Available values: "containers", "inference".
    ShowVolumeTypes bool
    If true, null available_volume_type is replaced with a list of available volume types.
    displayName String
    Filter regions by display name. Case-insensitive exact match.
    maxItems Double
    Max items to fetch, default: 1000
    orderBy String
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    product String
    If defined then return only regions that support given product. Available values: "containers", "inference".
    showVolumeTypes Boolean
    If true, null available_volume_type is replaced with a list of available volume types.
    displayName string
    Filter regions by display name. Case-insensitive exact match.
    maxItems number
    Max items to fetch, default: 1000
    orderBy string
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    product string
    If defined then return only regions that support given product. Available values: "containers", "inference".
    showVolumeTypes boolean
    If true, null available_volume_type is replaced with a list of available volume types.
    display_name str
    Filter regions by display name. Case-insensitive exact match.
    max_items float
    Max items to fetch, default: 1000
    order_by str
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    product str
    If defined then return only regions that support given product. Available values: "containers", "inference".
    show_volume_types bool
    If true, null available_volume_type is replaced with a list of available volume types.
    displayName String
    Filter regions by display name. Case-insensitive exact match.
    maxItems Number
    Max items to fetch, default: 1000
    orderBy String
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    product String
    If defined then return only regions that support given product. Available values: "containers", "inference".
    showVolumeTypes Boolean
    If true, null available_volume_type is replaced with a list of available volume types.

    getCloudRegions Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    Items List<GetCloudRegionsItem>
    The items returned by the data source
    OrderBy string
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    ShowVolumeTypes bool
    If true, null available_volume_type is replaced with a list of available volume types.
    DisplayName string
    Filter regions by display name. Case-insensitive exact match.
    MaxItems double
    Max items to fetch, default: 1000
    Product string
    If defined then return only regions that support given product. Available values: "containers", "inference".
    Id string
    The provider-assigned unique ID for this managed resource.
    Items []GetCloudRegionsItem
    The items returned by the data source
    OrderBy string
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    ShowVolumeTypes bool
    If true, null available_volume_type is replaced with a list of available volume types.
    DisplayName string
    Filter regions by display name. Case-insensitive exact match.
    MaxItems float64
    Max items to fetch, default: 1000
    Product string
    If defined then return only regions that support given product. Available values: "containers", "inference".
    id String
    The provider-assigned unique ID for this managed resource.
    items List<GetCloudRegionsItem>
    The items returned by the data source
    orderBy String
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    showVolumeTypes Boolean
    If true, null available_volume_type is replaced with a list of available volume types.
    displayName String
    Filter regions by display name. Case-insensitive exact match.
    maxItems Double
    Max items to fetch, default: 1000
    product String
    If defined then return only regions that support given product. Available values: "containers", "inference".
    id string
    The provider-assigned unique ID for this managed resource.
    items GetCloudRegionsItem[]
    The items returned by the data source
    orderBy string
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    showVolumeTypes boolean
    If true, null available_volume_type is replaced with a list of available volume types.
    displayName string
    Filter regions by display name. Case-insensitive exact match.
    maxItems number
    Max items to fetch, default: 1000
    product string
    If defined then return only regions that support given product. Available values: "containers", "inference".
    id str
    The provider-assigned unique ID for this managed resource.
    items Sequence[GetCloudRegionsItem]
    The items returned by the data source
    order_by str
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    show_volume_types bool
    If true, null available_volume_type is replaced with a list of available volume types.
    display_name str
    Filter regions by display name. Case-insensitive exact match.
    max_items float
    Max items to fetch, default: 1000
    product str
    If defined then return only regions that support given product. Available values: "containers", "inference".
    id String
    The provider-assigned unique ID for this managed resource.
    items List<Property Map>
    The items returned by the data source
    orderBy String
    Order by field and direction. Available values: "createdat.asc", "createdat.desc", "displayname.asc", "displayname.desc".
    showVolumeTypes Boolean
    If true, null available_volume_type is replaced with a list of available volume types.
    displayName String
    Filter regions by display name. Case-insensitive exact match.
    maxItems Number
    Max items to fetch, default: 1000
    product String
    If defined then return only regions that support given product. Available values: "containers", "inference".

    Supporting Types

    GetCloudRegionsItem

    AccessLevel string
    The access level of the region. Available values: "core", "edge".
    AvailableVolumeTypes List<string>
    List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    Coordinates GetCloudRegionsItemCoordinates
    Coordinates of the region
    Country string
    Two-letter country code, ISO 3166-1 alpha-2
    CreatedAt string
    Region creation date and time
    CreatedOn string
    This field is deprecated. Use created_at instead.

    Deprecated: Deprecated

    DdosEndpointId double
    DDoS endpoint ID

    Deprecated: Deprecated

    DisplayName string
    Human-readable region name
    EndpointType string
    Endpoint type Available values: "admin", "internal", "public".
    ExternalNetworkId string
    External network ID for Neutron
    FileShareTypes List<string>
    List of available file share types
    HasAi bool
    Region has AI capability
    HasAiGpu bool
    Region has AI GPU capability
    HasBaremetal bool
    Region has bare metal capability
    HasBasicVm bool
    Region has basic vm capability
    HasDbaas bool
    Region has DBAAS service
    HasDdos bool
    Region has Advanced DDoS Protection capability
    HasK8s bool
    Region has managed kubernetes capability
    HasKvm bool
    Region has KVM virtualization capability
    HasSfs bool
    Region has SFS capability
    Id double
    Region ID
    KeystoneId double
    Foreign key to Keystone entity
    KeystoneName string
    Technical region name
    MetricsDatabaseId double
    Foreign key to Metrics database entity
    State string
    Region state Available values: "ACTIVE", "DELETED", "DELETING", "DELETION_FAILED", "INACTIVE", "MAINTENANCE", "NEW".
    VlanPhysicalNetwork string
    Physical network name to create vlan networks
    Zone string
    Geographical zone Available values: "AMERICAS", "APAC", "EMEA", "RUSSIAANDCIS".
    AccessLevel string
    The access level of the region. Available values: "core", "edge".
    AvailableVolumeTypes []string
    List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    Coordinates GetCloudRegionsItemCoordinates
    Coordinates of the region
    Country string
    Two-letter country code, ISO 3166-1 alpha-2
    CreatedAt string
    Region creation date and time
    CreatedOn string
    This field is deprecated. Use created_at instead.

    Deprecated: Deprecated

    DdosEndpointId float64
    DDoS endpoint ID

    Deprecated: Deprecated

    DisplayName string
    Human-readable region name
    EndpointType string
    Endpoint type Available values: "admin", "internal", "public".
    ExternalNetworkId string
    External network ID for Neutron
    FileShareTypes []string
    List of available file share types
    HasAi bool
    Region has AI capability
    HasAiGpu bool
    Region has AI GPU capability
    HasBaremetal bool
    Region has bare metal capability
    HasBasicVm bool
    Region has basic vm capability
    HasDbaas bool
    Region has DBAAS service
    HasDdos bool
    Region has Advanced DDoS Protection capability
    HasK8s bool
    Region has managed kubernetes capability
    HasKvm bool
    Region has KVM virtualization capability
    HasSfs bool
    Region has SFS capability
    Id float64
    Region ID
    KeystoneId float64
    Foreign key to Keystone entity
    KeystoneName string
    Technical region name
    MetricsDatabaseId float64
    Foreign key to Metrics database entity
    State string
    Region state Available values: "ACTIVE", "DELETED", "DELETING", "DELETION_FAILED", "INACTIVE", "MAINTENANCE", "NEW".
    VlanPhysicalNetwork string
    Physical network name to create vlan networks
    Zone string
    Geographical zone Available values: "AMERICAS", "APAC", "EMEA", "RUSSIAANDCIS".
    accessLevel String
    The access level of the region. Available values: "core", "edge".
    availableVolumeTypes List<String>
    List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    coordinates GetCloudRegionsItemCoordinates
    Coordinates of the region
    country String
    Two-letter country code, ISO 3166-1 alpha-2
    createdAt String
    Region creation date and time
    createdOn String
    This field is deprecated. Use created_at instead.

    Deprecated: Deprecated

    ddosEndpointId Double
    DDoS endpoint ID

    Deprecated: Deprecated

    displayName String
    Human-readable region name
    endpointType String
    Endpoint type Available values: "admin", "internal", "public".
    externalNetworkId String
    External network ID for Neutron
    fileShareTypes List<String>
    List of available file share types
    hasAi Boolean
    Region has AI capability
    hasAiGpu Boolean
    Region has AI GPU capability
    hasBaremetal Boolean
    Region has bare metal capability
    hasBasicVm Boolean
    Region has basic vm capability
    hasDbaas Boolean
    Region has DBAAS service
    hasDdos Boolean
    Region has Advanced DDoS Protection capability
    hasK8s Boolean
    Region has managed kubernetes capability
    hasKvm Boolean
    Region has KVM virtualization capability
    hasSfs Boolean
    Region has SFS capability
    id Double
    Region ID
    keystoneId Double
    Foreign key to Keystone entity
    keystoneName String
    Technical region name
    metricsDatabaseId Double
    Foreign key to Metrics database entity
    state String
    Region state Available values: "ACTIVE", "DELETED", "DELETING", "DELETION_FAILED", "INACTIVE", "MAINTENANCE", "NEW".
    vlanPhysicalNetwork String
    Physical network name to create vlan networks
    zone String
    Geographical zone Available values: "AMERICAS", "APAC", "EMEA", "RUSSIAANDCIS".
    accessLevel string
    The access level of the region. Available values: "core", "edge".
    availableVolumeTypes string[]
    List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    coordinates GetCloudRegionsItemCoordinates
    Coordinates of the region
    country string
    Two-letter country code, ISO 3166-1 alpha-2
    createdAt string
    Region creation date and time
    createdOn string
    This field is deprecated. Use created_at instead.

    Deprecated: Deprecated

    ddosEndpointId number
    DDoS endpoint ID

    Deprecated: Deprecated

    displayName string
    Human-readable region name
    endpointType string
    Endpoint type Available values: "admin", "internal", "public".
    externalNetworkId string
    External network ID for Neutron
    fileShareTypes string[]
    List of available file share types
    hasAi boolean
    Region has AI capability
    hasAiGpu boolean
    Region has AI GPU capability
    hasBaremetal boolean
    Region has bare metal capability
    hasBasicVm boolean
    Region has basic vm capability
    hasDbaas boolean
    Region has DBAAS service
    hasDdos boolean
    Region has Advanced DDoS Protection capability
    hasK8s boolean
    Region has managed kubernetes capability
    hasKvm boolean
    Region has KVM virtualization capability
    hasSfs boolean
    Region has SFS capability
    id number
    Region ID
    keystoneId number
    Foreign key to Keystone entity
    keystoneName string
    Technical region name
    metricsDatabaseId number
    Foreign key to Metrics database entity
    state string
    Region state Available values: "ACTIVE", "DELETED", "DELETING", "DELETION_FAILED", "INACTIVE", "MAINTENANCE", "NEW".
    vlanPhysicalNetwork string
    Physical network name to create vlan networks
    zone string
    Geographical zone Available values: "AMERICAS", "APAC", "EMEA", "RUSSIAANDCIS".
    access_level str
    The access level of the region. Available values: "core", "edge".
    available_volume_types Sequence[str]
    List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    coordinates GetCloudRegionsItemCoordinates
    Coordinates of the region
    country str
    Two-letter country code, ISO 3166-1 alpha-2
    created_at str
    Region creation date and time
    created_on str
    This field is deprecated. Use created_at instead.

    Deprecated: Deprecated

    ddos_endpoint_id float
    DDoS endpoint ID

    Deprecated: Deprecated

    display_name str
    Human-readable region name
    endpoint_type str
    Endpoint type Available values: "admin", "internal", "public".
    external_network_id str
    External network ID for Neutron
    file_share_types Sequence[str]
    List of available file share types
    has_ai bool
    Region has AI capability
    has_ai_gpu bool
    Region has AI GPU capability
    has_baremetal bool
    Region has bare metal capability
    has_basic_vm bool
    Region has basic vm capability
    has_dbaas bool
    Region has DBAAS service
    has_ddos bool
    Region has Advanced DDoS Protection capability
    has_k8s bool
    Region has managed kubernetes capability
    has_kvm bool
    Region has KVM virtualization capability
    has_sfs bool
    Region has SFS capability
    id float
    Region ID
    keystone_id float
    Foreign key to Keystone entity
    keystone_name str
    Technical region name
    metrics_database_id float
    Foreign key to Metrics database entity
    state str
    Region state Available values: "ACTIVE", "DELETED", "DELETING", "DELETION_FAILED", "INACTIVE", "MAINTENANCE", "NEW".
    vlan_physical_network str
    Physical network name to create vlan networks
    zone str
    Geographical zone Available values: "AMERICAS", "APAC", "EMEA", "RUSSIAANDCIS".
    accessLevel String
    The access level of the region. Available values: "core", "edge".
    availableVolumeTypes List<String>
    List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    coordinates Property Map
    Coordinates of the region
    country String
    Two-letter country code, ISO 3166-1 alpha-2
    createdAt String
    Region creation date and time
    createdOn String
    This field is deprecated. Use created_at instead.

    Deprecated: Deprecated

    ddosEndpointId Number
    DDoS endpoint ID

    Deprecated: Deprecated

    displayName String
    Human-readable region name
    endpointType String
    Endpoint type Available values: "admin", "internal", "public".
    externalNetworkId String
    External network ID for Neutron
    fileShareTypes List<String>
    List of available file share types
    hasAi Boolean
    Region has AI capability
    hasAiGpu Boolean
    Region has AI GPU capability
    hasBaremetal Boolean
    Region has bare metal capability
    hasBasicVm Boolean
    Region has basic vm capability
    hasDbaas Boolean
    Region has DBAAS service
    hasDdos Boolean
    Region has Advanced DDoS Protection capability
    hasK8s Boolean
    Region has managed kubernetes capability
    hasKvm Boolean
    Region has KVM virtualization capability
    hasSfs Boolean
    Region has SFS capability
    id Number
    Region ID
    keystoneId Number
    Foreign key to Keystone entity
    keystoneName String
    Technical region name
    metricsDatabaseId Number
    Foreign key to Metrics database entity
    state String
    Region state Available values: "ACTIVE", "DELETED", "DELETING", "DELETION_FAILED", "INACTIVE", "MAINTENANCE", "NEW".
    vlanPhysicalNetwork String
    Physical network name to create vlan networks
    zone String
    Geographical zone Available values: "AMERICAS", "APAC", "EMEA", "RUSSIAANDCIS".

    GetCloudRegionsItemCoordinates

    Latitude string
    Longitude string
    Latitude string
    Longitude string
    latitude String
    longitude String
    latitude string
    longitude string
    latitude String
    longitude String

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    gcore logo
    Viewing docs for gcore 2.0.0-alpha.2
    published on Tuesday, Mar 24, 2026 by g-core
      Try Pulumi Cloud free. Your team will thank you.