1. Packages
  2. Packages
  3. Ionoscloud
  4. API Docs
  5. objectstoragemanagement
  6. getRegion
Viewing docs for IonosCloud v0.3.0
published on Wednesday, Apr 15, 2026 by ionos-cloud
ionoscloud logo
Viewing docs for IonosCloud v0.3.0
published on Wednesday, Apr 15, 2026 by ionos-cloud

    The Object storage region data source can be used to search for and return an existing S3 Regions.

    Example Usage

    By ID

    import * as pulumi from "@pulumi/pulumi";
    import * as ionoscloud from "@ionos-cloud/sdk-pulumi";
    
    const example = ionoscloud.objectstoragemanagement.getRegion({
        id: "region_id",
    });
    
    import pulumi
    import pulumi_ionoscloud as ionoscloud
    
    example = ionoscloud.objectstoragemanagement.get_region(id="region_id")
    
    package main
    
    import (
    	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud/objectstoragemanagement"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := objectstoragemanagement.GetRegion(ctx, &objectstoragemanagement.GetRegionArgs{
    			Id: "region_id",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ionoscloud = Ionoscloud.Pulumi.Ionoscloud;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Ionoscloud.Objectstoragemanagement.GetRegion.Invoke(new()
        {
            Id = "region_id",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ionoscloud.objectstoragemanagement.ObjectstoragemanagementFunctions;
    import com.pulumi.ionoscloud.objectstoragemanagement.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 example = ObjectstoragemanagementFunctions.getRegion(GetRegionArgs.builder()
                .id("region_id")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: ionoscloud:objectstoragemanagement:getRegion
          arguments:
            id: region_id
    

    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: pulumi.Input[Optional[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: ionoscloud:objectstoragemanagement/getRegion:getRegion
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Id string
    Id of an existing object storage Region that you want to search for.
    Id string
    Id of an existing object storage Region that you want to search for.
    id String
    Id of an existing object storage Region that you want to search for.
    id string
    Id of an existing object storage Region that you want to search for.
    id str
    Id of an existing object storage Region that you want to search for.
    id String
    Id of an existing object storage Region that you want to search for.

    getRegion Result

    The following output properties are available:

    Capability Ionoscloud.GetRegionCapability
    The capabilities of the region
    Endpoint string
    The endpoint URL for the region
    Id string
    The id of the region
    Location string
    The data center location of the region as per Get Location. Can't be used as LocationConstraint on bucket creation.
    StorageClasses List<string>
    The available classes in the region
    Version int
    The version of the region properties
    Website string
    The website URL for the region
    Capability GetRegionCapability
    The capabilities of the region
    Endpoint string
    The endpoint URL for the region
    Id string
    The id of the region
    Location string
    The data center location of the region as per Get Location. Can't be used as LocationConstraint on bucket creation.
    StorageClasses []string
    The available classes in the region
    Version int
    The version of the region properties
    Website string
    The website URL for the region
    capability GetRegionCapability
    The capabilities of the region
    endpoint String
    The endpoint URL for the region
    id String
    The id of the region
    location String
    The data center location of the region as per Get Location. Can't be used as LocationConstraint on bucket creation.
    storageClasses List<String>
    The available classes in the region
    version Integer
    The version of the region properties
    website String
    The website URL for the region
    capability GetRegionCapability
    The capabilities of the region
    endpoint string
    The endpoint URL for the region
    id string
    The id of the region
    location string
    The data center location of the region as per Get Location. Can't be used as LocationConstraint on bucket creation.
    storageClasses string[]
    The available classes in the region
    version number
    The version of the region properties
    website string
    The website URL for the region
    capability GetRegionCapability
    The capabilities of the region
    endpoint str
    The endpoint URL for the region
    id str
    The id of the region
    location str
    The data center location of the region as per Get Location. Can't be used as LocationConstraint on bucket creation.
    storage_classes Sequence[str]
    The available classes in the region
    version int
    The version of the region properties
    website str
    The website URL for the region
    capability Property Map
    The capabilities of the region
    endpoint String
    The endpoint URL for the region
    id String
    The id of the region
    location String
    The data center location of the region as per Get Location. Can't be used as LocationConstraint on bucket creation.
    storageClasses List<String>
    The available classes in the region
    version Number
    The version of the region properties
    website String
    The website URL for the region

    Supporting Types

    GetRegionCapability

    Iam bool
    Indicates if IAM policy based access is supported
    S3select bool
    Indicates if S3 Select is supported
    Iam bool
    Indicates if IAM policy based access is supported
    S3select bool
    Indicates if S3 Select is supported
    iam Boolean
    Indicates if IAM policy based access is supported
    s3select Boolean
    Indicates if S3 Select is supported
    iam boolean
    Indicates if IAM policy based access is supported
    s3select boolean
    Indicates if S3 Select is supported
    iam bool
    Indicates if IAM policy based access is supported
    s3select bool
    Indicates if S3 Select is supported
    iam Boolean
    Indicates if IAM policy based access is supported
    s3select Boolean
    Indicates if S3 Select is supported

    Package Details

    Repository
    ionoscloud ionos-cloud/pulumi-ionoscloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    Viewing docs for IonosCloud v0.3.0
    published on Wednesday, Apr 15, 2026 by ionos-cloud
      Try Pulumi Cloud free. Your team will thank you.