getRegions

This data source provides Alibaba Cloud regions.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const currentRegionDs = alicloud.getRegions({
current: true,
});
export const currentRegionId = currentRegionDs.then(currentRegionDs => currentRegionDs.regions?.[0]?.id);
import pulumi
import pulumi_alicloud as alicloud
current_region_ds = alicloud.get_regions(current=True)
pulumi.export("currentRegionId", current_region_ds.regions[0].id)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var currentRegionDs = AliCloud.GetRegions.Invoke(new()
{
Current = true,
});
return new Dictionary<string, object?>
{
["currentRegionId"] = currentRegionDs&#46;Apply(getRegionsResult => getRegionsResult&#46;Regions[0]?.Id),
};
});
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
currentRegionDs, err := alicloud.GetRegions(ctx, &alicloud.GetRegionsArgs{
Current: pulumi.BoolRef(true),
}, nil)
if err != nil {
return err
}
ctx.Export("currentRegionId", currentRegionDs.Regions[0].Id)
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetRegionsArgs;
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 currentRegionDs = AlicloudFunctions.getRegions(GetRegionsArgs.builder()
.current(true)
.build());
ctx.export("currentRegionId", currentRegionDs.regions()[0].id());
}
}
variables:
currentRegionDs:
fn::invoke:
function: alicloud:getRegions
arguments:
current: true
outputs:
currentRegionId: ${currentRegionDs.regions[0].id}

Return

A collection of values returned by getRegions.

Parameters

argument

A collection of arguments for invoking getRegions.


suspend fun getRegions(current: Boolean? = null, name: String? = null, outputFile: String? = null): GetRegionsResult

Return

A collection of values returned by getRegions.

Parameters

current

Set to true to match only the region configured in the provider.

name

The name of the region to select, such as eu-central-1.

outputFile

File name where to save data source results (after running pulumi preview).

NOTE: You will get an error if you set current to true and name to a different value from the one you configured in the provider. It is better to either use name or current, but not both at the same time.

See also


suspend fun getRegions(argument: suspend GetRegionsPlainArgsBuilder.() -> Unit): GetRegionsResult

Return

A collection of values returned by getRegions.

Parameters

argument

Builder for com.pulumi.alicloud.kotlin.inputs.GetRegionsPlainArgs.

See also