get Regions
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);
Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
current_region_ds = alicloud.get_regions(current=True)
pulumi.export("currentRegionId", current_region_ds.regions[0].id)
Content copied to clipboard
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.Apply(getRegionsResult => getRegionsResult.Regions[0]?.Id),
};
});
Content copied to clipboard
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
})
}
Content copied to clipboard
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());
}
}
Content copied to clipboard
variables:
currentRegionDs:
fn::invoke:
function: alicloud:getRegions
arguments:
current: true
outputs:
currentRegionId: ${currentRegionDs.regions[0].id}
Content copied to clipboard
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
.
output File
File name where to save data source results (after running pulumi preview
).
NOTE: You will get an error if you set
current
to true andname
to a different value from the one you configured in the provider. It is better to either usename
orcurrent
, but not both at the same time.
See also
Return
A collection of values returned by getRegions.
Parameters
argument
Builder for com.pulumi.alicloud.kotlin.inputs.GetRegionsPlainArgs.