Alibaba Cloud v3.76.0, Apr 8 25

Alibaba Cloud v3.76.0 published on Tuesday, Apr 8, 2025 by Pulumi

alicloud.gpdb.ElasticInstance

Explore with Pulumi AI

Alibaba Cloud v3.76.0 published on Tuesday, Apr 8, 2025 by Pulumi

Example Usage

Create a AnalyticDB for PostgreSQL instance

TypeScript
Python
Go
C#
Java
YAML

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const _default = alicloud.getZones({
    availableResourceCreation: "Gpdb",
});
const defaultNetwork = new alicloud.vpc.Network("default", {
    name: "vpc-123456",
    cidrBlock: "172.16.0.0/16",
});
const defaultSwitch = new alicloud.vpc.Switch("default", {
    zoneId: _default.then(_default => _default.zones?.[0]?.id),
    vpcId: defaultNetwork.id,
    cidrBlock: "172.16.0.0/24",
    vswitchName: "vpc-123456",
});
const adbPgInstance = new alicloud.gpdb.ElasticInstance("adb_pg_instance", {
    engine: "gpdb",
    engineVersion: "6.0",
    segStorageType: "cloud_essd",
    segNodeNum: 4,
    storageSize: 50,
    instanceSpec: "2C16G",
    dbInstanceDescription: "Created by terraform",
    instanceNetworkType: "VPC",
    paymentType: "PayAsYouGo",
    vswitchId: defaultSwitch.id,
});

import pulumi
import pulumi_alicloud as alicloud

default = alicloud.get_zones(available_resource_creation="Gpdb")
default_network = alicloud.vpc.Network("default",
    name="vpc-123456",
    cidr_block="172.16.0.0/16")
default_switch = alicloud.vpc.Switch("default",
    zone_id=default.zones[0].id,
    vpc_id=default_network.id,
    cidr_block="172.16.0.0/24",
    vswitch_name="vpc-123456")
adb_pg_instance = alicloud.gpdb.ElasticInstance("adb_pg_instance",
    engine="gpdb",
    engine_version="6.0",
    seg_storage_type="cloud_essd",
    seg_node_num=4,
    storage_size=50,
    instance_spec="2C16G",
    db_instance_description="Created by terraform",
    instance_network_type="VPC",
    payment_type="PayAsYouGo",
    vswitch_id=default_switch.id)

package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/gpdb"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_default, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
			AvailableResourceCreation: pulumi.StringRef("Gpdb"),
		}, nil)
		if err != nil {
			return err
		}
		defaultNetwork, err := vpc.NewNetwork(ctx, "default", &vpc.NetworkArgs{
			Name:      pulumi.String("vpc-123456"),
			CidrBlock: pulumi.String("172.16.0.0/16"),
		})
		if err != nil {
			return err
		}
		defaultSwitch, err := vpc.NewSwitch(ctx, "default", &vpc.SwitchArgs{
			ZoneId:      pulumi.String(_default.Zones[0].Id),
			VpcId:       defaultNetwork.ID(),
			CidrBlock:   pulumi.String("172.16.0.0/24"),
			VswitchName: pulumi.String("vpc-123456"),
		})
		if err != nil {
			return err
		}
		_, err = gpdb.NewElasticInstance(ctx, "adb_pg_instance", &gpdb.ElasticInstanceArgs{
			Engine:                pulumi.String("gpdb"),
			EngineVersion:         pulumi.String("6.0"),
			SegStorageType:        pulumi.String("cloud_essd"),
			SegNodeNum:            pulumi.Int(4),
			StorageSize:           pulumi.Int(50),
			InstanceSpec:          pulumi.String("2C16G"),
			DbInstanceDescription: pulumi.String("Created by terraform"),
			InstanceNetworkType:   pulumi.String("VPC"),
			PaymentType:           pulumi.String("PayAsYouGo"),
			VswitchId:             defaultSwitch.ID(),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;

return await Deployment.RunAsync(() => 
{
    var @default = AliCloud.GetZones.Invoke(new()
    {
        AvailableResourceCreation = "Gpdb",
    });

    var defaultNetwork = new AliCloud.Vpc.Network("default", new()
    {
        Name = "vpc-123456",
        CidrBlock = "172.16.0.0/16",
    });

    var defaultSwitch = new AliCloud.Vpc.Switch("default", new()
    {
        ZoneId = @default.Apply(@default => @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id)),
        VpcId = defaultNetwork.Id,
        CidrBlock = "172.16.0.0/24",
        VswitchName = "vpc-123456",
    });

    var adbPgInstance = new AliCloud.Gpdb.ElasticInstance("adb_pg_instance", new()
    {
        Engine = "gpdb",
        EngineVersion = "6.0",
        SegStorageType = "cloud_essd",
        SegNodeNum = 4,
        StorageSize = 50,
        InstanceSpec = "2C16G",
        DbInstanceDescription = "Created by terraform",
        InstanceNetworkType = "VPC",
        PaymentType = "PayAsYouGo",
        VswitchId = defaultSwitch.Id,
    });

});

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.GetZonesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.gpdb.ElasticInstance;
import com.pulumi.alicloud.gpdb.ElasticInstanceArgs;
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 default = AlicloudFunctions.getZones(GetZonesArgs.builder()
            .availableResourceCreation("Gpdb")
            .build());

        var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()
            .name("vpc-123456")
            .cidrBlock("172.16.0.0/16")
            .build());

        var defaultSwitch = new Switch("defaultSwitch", SwitchArgs.builder()
            .zoneId(default_.zones()[0].id())
            .vpcId(defaultNetwork.id())
            .cidrBlock("172.16.0.0/24")
            .vswitchName("vpc-123456")
            .build());

        var adbPgInstance = new ElasticInstance("adbPgInstance", ElasticInstanceArgs.builder()
            .engine("gpdb")
            .engineVersion("6.0")
            .segStorageType("cloud_essd")
            .segNodeNum(4)
            .storageSize(50)
            .instanceSpec("2C16G")
            .dbInstanceDescription("Created by terraform")
            .instanceNetworkType("VPC")
            .paymentType("PayAsYouGo")
            .vswitchId(defaultSwitch.id())
            .build());

    }
}

resources:
  defaultNetwork:
    type: alicloud:vpc:Network
    name: default
    properties:
      name: vpc-123456
      cidrBlock: 172.16.0.0/16
  defaultSwitch:
    type: alicloud:vpc:Switch
    name: default
    properties:
      zoneId: ${default.zones[0].id}
      vpcId: ${defaultNetwork.id}
      cidrBlock: 172.16.0.0/24
      vswitchName: vpc-123456
  adbPgInstance:
    type: alicloud:gpdb:ElasticInstance
    name: adb_pg_instance
    properties:
      engine: gpdb
      engineVersion: '6.0'
      segStorageType: cloud_essd
      segNodeNum: 4
      storageSize: 50
      instanceSpec: 2C16G
      dbInstanceDescription: Created by terraform
      instanceNetworkType: VPC
      paymentType: PayAsYouGo
      vswitchId: ${defaultSwitch.id}
variables:
  default:
    fn::invoke:
      function: alicloud:getZones
      arguments:
        availableResourceCreation: Gpdb

Create ElasticInstance Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

new ElasticInstance(name: string, args: ElasticInstanceArgs, opts?: CustomResourceOptions);

@overload
def ElasticInstance(resource_name: str,
                    args: ElasticInstanceArgs,
                    opts: Optional[ResourceOptions] = None)

@overload
def ElasticInstance(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    seg_node_num: Optional[int] = None,
                    seg_storage_type: Optional[str] = None,
                    vswitch_id: Optional[str] = None,
                    storage_size: Optional[int] = None,
                    engine: Optional[str] = None,
                    engine_version: Optional[str] = None,
                    instance_spec: Optional[str] = None,
                    instance_network_type: Optional[str] = None,
                    zone_id: Optional[str] = None,
                    encryption_key: Optional[str] = None,
                    encryption_type: Optional[str] = None,
                    security_ip_lists: Optional[Sequence[str]] = None,
                    db_instance_category: Optional[str] = None,
                    db_instance_description: Optional[str] = None,
                    payment_type: Optional[str] = None,
                    tags: Optional[Mapping[str, str]] = None,
                    payment_duration_unit: Optional[str] = None,
                    payment_duration: Optional[int] = None)

func NewElasticInstance(ctx *Context, name string, args ElasticInstanceArgs, opts ...ResourceOption) (*ElasticInstance, error)

public ElasticInstance(string name, ElasticInstanceArgs args, CustomResourceOptions? opts = null)

public ElasticInstance(String name, ElasticInstanceArgs args)
public ElasticInstance(String name, ElasticInstanceArgs args, CustomResourceOptions options)

type: alicloud:gpdb:ElasticInstance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args ElasticInstanceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args ElasticInstanceArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args ElasticInstanceArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args ElasticInstanceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args ElasticInstanceArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

TypeScript
Python
Go
C#
Java
YAML

var elasticInstanceResource = new AliCloud.Gpdb.ElasticInstance("elasticInstanceResource", new()
{
    SegNodeNum = 0,
    SegStorageType = "string",
    VswitchId = "string",
    StorageSize = 0,
    Engine = "string",
    EngineVersion = "string",
    InstanceSpec = "string",
    InstanceNetworkType = "string",
    ZoneId = "string",
    EncryptionKey = "string",
    EncryptionType = "string",
    SecurityIpLists = new[]
    {
        "string",
    },
    DbInstanceCategory = "string",
    DbInstanceDescription = "string",
    PaymentType = "string",
    Tags = 
    {
        { "string", "string" },
    },
    PaymentDurationUnit = "string",
    PaymentDuration = 0,
});

example, err := gpdb.NewElasticInstance(ctx, "elasticInstanceResource", &gpdb.ElasticInstanceArgs{
	SegNodeNum:          pulumi.Int(0),
	SegStorageType:      pulumi.String("string"),
	VswitchId:           pulumi.String("string"),
	StorageSize:         pulumi.Int(0),
	Engine:              pulumi.String("string"),
	EngineVersion:       pulumi.String("string"),
	InstanceSpec:        pulumi.String("string"),
	InstanceNetworkType: pulumi.String("string"),
	ZoneId:              pulumi.String("string"),
	EncryptionKey:       pulumi.String("string"),
	EncryptionType:      pulumi.String("string"),
	SecurityIpLists: pulumi.StringArray{
		pulumi.String("string"),
	},
	DbInstanceCategory:    pulumi.String("string"),
	DbInstanceDescription: pulumi.String("string"),
	PaymentType:           pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	PaymentDurationUnit: pulumi.String("string"),
	PaymentDuration:     pulumi.Int(0),
})

var elasticInstanceResource = new ElasticInstance("elasticInstanceResource", ElasticInstanceArgs.builder()
    .segNodeNum(0)
    .segStorageType("string")
    .vswitchId("string")
    .storageSize(0)
    .engine("string")
    .engineVersion("string")
    .instanceSpec("string")
    .instanceNetworkType("string")
    .zoneId("string")
    .encryptionKey("string")
    .encryptionType("string")
    .securityIpLists("string")
    .dbInstanceCategory("string")
    .dbInstanceDescription("string")
    .paymentType("string")
    .tags(Map.of("string", "string"))
    .paymentDurationUnit("string")
    .paymentDuration(0)
    .build());

elastic_instance_resource = alicloud.gpdb.ElasticInstance("elasticInstanceResource",
    seg_node_num=0,
    seg_storage_type="string",
    vswitch_id="string",
    storage_size=0,
    engine="string",
    engine_version="string",
    instance_spec="string",
    instance_network_type="string",
    zone_id="string",
    encryption_key="string",
    encryption_type="string",
    security_ip_lists=["string"],
    db_instance_category="string",
    db_instance_description="string",
    payment_type="string",
    tags={
        "string": "string",
    },
    payment_duration_unit="string",
    payment_duration=0)

const elasticInstanceResource = new alicloud.gpdb.ElasticInstance("elasticInstanceResource", {
    segNodeNum: 0,
    segStorageType: "string",
    vswitchId: "string",
    storageSize: 0,
    engine: "string",
    engineVersion: "string",
    instanceSpec: "string",
    instanceNetworkType: "string",
    zoneId: "string",
    encryptionKey: "string",
    encryptionType: "string",
    securityIpLists: ["string"],
    dbInstanceCategory: "string",
    dbInstanceDescription: "string",
    paymentType: "string",
    tags: {
        string: "string",
    },
    paymentDurationUnit: "string",
    paymentDuration: 0,
});

type: alicloud:gpdb:ElasticInstance
properties:
    dbInstanceCategory: string
    dbInstanceDescription: string
    encryptionKey: string
    encryptionType: string
    engine: string
    engineVersion: string
    instanceNetworkType: string
    instanceSpec: string
    paymentDuration: 0
    paymentDurationUnit: string
    paymentType: string
    securityIpLists:
        - string
    segNodeNum: 0
    segStorageType: string
    storageSize: 0
    tags:
        string: string
    vswitchId: string
    zoneId: string

ElasticInstance Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The ElasticInstance resource accepts the following input properties:

Engine string

Database engine: gpdb.

EngineVersion string

Database version. Valid value is 6.0.

InstanceSpec string

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

SegNodeNum int

The number of segment nodes. Minimum is 4, max is 256, step is 4.

SegStorageType string

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

StorageSize int

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

VswitchId string

The virtual switch ID to launch ADB PG instances in one VPC.

DbInstanceCategory string

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

DbInstanceDescription string

The description of ADB PG instance. It is a string of 2 to 256 characters.

EncryptionKey string

The ID of the encryption key. Note: If the encryption_type parameter is set to CloudDisk, you must specify this parameter to the encryption key that is in the same region as the disk that is specified by the EncryptionType parameter. Otherwise, leave this parameter empty.

EncryptionType string

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

InstanceNetworkType string

The network type of ADB PG instance. Only VPC supported now.

PaymentDuration int

The subscription period. Valid values: [1~12]. It is valid when payment_type is Subscription.
NOTE: Will not take effect after modifying payment_duration for now, if you want to renew a PayAsYouGo instance, need to do in on aliyun console.

PaymentDurationUnit string

The unit of the subscription period. Valid values: Month, Year. It is valid when payment_type is Subscription.
NOTE: Will not take effect after modifying payment_duration_unit for now, if you want to renew a PayAsYouGo instance, need to do in on aliyun console.

PaymentType string

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

SecurityIpLists List<string>

List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]).

Tags Dictionary<string, string>

A mapping of tags to assign to the resource.

ZoneId string

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

Engine string

Database engine: gpdb.

EngineVersion string

Database version. Valid value is 6.0.

InstanceSpec string

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

SegNodeNum int

The number of segment nodes. Minimum is 4, max is 256, step is 4.

SegStorageType string

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

StorageSize int

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

VswitchId string

The virtual switch ID to launch ADB PG instances in one VPC.

DbInstanceCategory string

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

DbInstanceDescription string

The description of ADB PG instance. It is a string of 2 to 256 characters.

EncryptionKey string

EncryptionType string

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

InstanceNetworkType string

The network type of ADB PG instance. Only VPC supported now.

PaymentDuration int

PaymentDurationUnit string

PaymentType string

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

SecurityIpLists []string

Tags map[string]string

A mapping of tags to assign to the resource.

ZoneId string

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

engine String

Database engine: gpdb.

engineVersion String

Database version. Valid value is 6.0.

instanceSpec String

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

segNodeNum Integer

The number of segment nodes. Minimum is 4, max is 256, step is 4.

segStorageType String

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

storageSize Integer

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

vswitchId String

The virtual switch ID to launch ADB PG instances in one VPC.

dbInstanceCategory String

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

dbInstanceDescription String

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryptionKey String

encryptionType String

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

instanceNetworkType String

The network type of ADB PG instance. Only VPC supported now.

paymentDuration Integer

paymentDurationUnit String

paymentType String

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

securityIpLists List<String>

tags Map<String,String>

A mapping of tags to assign to the resource.

zoneId String

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

engine string

Database engine: gpdb.

engineVersion string

Database version. Valid value is 6.0.

instanceSpec string

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

segNodeNum number

The number of segment nodes. Minimum is 4, max is 256, step is 4.

segStorageType string

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

storageSize number

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

vswitchId string

The virtual switch ID to launch ADB PG instances in one VPC.

dbInstanceCategory string

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

dbInstanceDescription string

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryptionKey string

encryptionType string

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

instanceNetworkType string

The network type of ADB PG instance. Only VPC supported now.

paymentDuration number

paymentDurationUnit string

paymentType string

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

securityIpLists string[]

tags {[key: string]: string}

A mapping of tags to assign to the resource.

zoneId string

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

engine str

Database engine: gpdb.

engine_version str

Database version. Valid value is 6.0.

instance_spec str

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

seg_node_num int

The number of segment nodes. Minimum is 4, max is 256, step is 4.

seg_storage_type str

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

storage_size int

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

vswitch_id str

The virtual switch ID to launch ADB PG instances in one VPC.

db_instance_category str

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

db_instance_description str

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryption_key str

encryption_type str

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

instance_network_type str

The network type of ADB PG instance. Only VPC supported now.

payment_duration int

payment_duration_unit str

payment_type str

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

security_ip_lists Sequence[str]

tags Mapping[str, str]

A mapping of tags to assign to the resource.

zone_id str

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

engine String

Database engine: gpdb.

engineVersion String

Database version. Valid value is 6.0.

instanceSpec String

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

segNodeNum Number

The number of segment nodes. Minimum is 4, max is 256, step is 4.

segStorageType String

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

storageSize Number

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

vswitchId String

The virtual switch ID to launch ADB PG instances in one VPC.

dbInstanceCategory String

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

dbInstanceDescription String

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryptionKey String

encryptionType String

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

instanceNetworkType String

The network type of ADB PG instance. Only VPC supported now.

paymentDuration Number

paymentDurationUnit String

paymentType String

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

securityIpLists List<String>

tags Map<String>

A mapping of tags to assign to the resource.

zoneId String

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

Outputs

All input properties are implicitly available as output properties. Additionally, the ElasticInstance resource produces the following output properties:

ConnectionString string: ADB PG instance connection string.
Id string: The provider-assigned unique ID for this managed resource.
Port string: (Available in 1.196.0+) The connection port of the instance.
Status string: Instance status.

ConnectionString string: ADB PG instance connection string.
Id string: The provider-assigned unique ID for this managed resource.
Port string: (Available in 1.196.0+) The connection port of the instance.
Status string: Instance status.

connectionString String: ADB PG instance connection string.
id String: The provider-assigned unique ID for this managed resource.
port String: (Available in 1.196.0+) The connection port of the instance.
status String: Instance status.

connectionString string: ADB PG instance connection string.
id string: The provider-assigned unique ID for this managed resource.
port string: (Available in 1.196.0+) The connection port of the instance.
status string: Instance status.

connection_string str: ADB PG instance connection string.
id str: The provider-assigned unique ID for this managed resource.
port str: (Available in 1.196.0+) The connection port of the instance.
status str: Instance status.

connectionString String: ADB PG instance connection string.
id String: The provider-assigned unique ID for this managed resource.
port String: (Available in 1.196.0+) The connection port of the instance.
status String: Instance status.

Look up Existing ElasticInstance Resource

Get an existing ElasticInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

TypeScript
Python
Go
C#
Java
YAML

public static get(name: string, id: Input<ID>, state?: ElasticInstanceState, opts?: CustomResourceOptions): ElasticInstance

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        connection_string: Optional[str] = None,
        db_instance_category: Optional[str] = None,
        db_instance_description: Optional[str] = None,
        encryption_key: Optional[str] = None,
        encryption_type: Optional[str] = None,
        engine: Optional[str] = None,
        engine_version: Optional[str] = None,
        instance_network_type: Optional[str] = None,
        instance_spec: Optional[str] = None,
        payment_duration: Optional[int] = None,
        payment_duration_unit: Optional[str] = None,
        payment_type: Optional[str] = None,
        port: Optional[str] = None,
        security_ip_lists: Optional[Sequence[str]] = None,
        seg_node_num: Optional[int] = None,
        seg_storage_type: Optional[str] = None,
        status: Optional[str] = None,
        storage_size: Optional[int] = None,
        tags: Optional[Mapping[str, str]] = None,
        vswitch_id: Optional[str] = None,
        zone_id: Optional[str] = None) -> ElasticInstance

func GetElasticInstance(ctx *Context, name string, id IDInput, state *ElasticInstanceState, opts ...ResourceOption) (*ElasticInstance, error)

public static ElasticInstance Get(string name, Input<string> id, ElasticInstanceState? state, CustomResourceOptions? opts = null)

public static ElasticInstance get(String name, Output<String> id, ElasticInstanceState state, CustomResourceOptions options)

resources:  _:    type: alicloud:gpdb:ElasticInstance    get:      id: ${id}

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

ConnectionString string

ADB PG instance connection string.

DbInstanceCategory string

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

DbInstanceDescription string

The description of ADB PG instance. It is a string of 2 to 256 characters.

EncryptionKey string

EncryptionType string

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

Engine string

Database engine: gpdb.

EngineVersion string

Database version. Valid value is 6.0.

InstanceNetworkType string

The network type of ADB PG instance. Only VPC supported now.

InstanceSpec string

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

PaymentDuration int

PaymentDurationUnit string

PaymentType string

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

Port string

(Available in 1.196.0+) The connection port of the instance.

SecurityIpLists List<string>

SegNodeNum int

The number of segment nodes. Minimum is 4, max is 256, step is 4.

SegStorageType string

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

Status string

Instance status.

StorageSize int

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

Tags Dictionary<string, string>

A mapping of tags to assign to the resource.

VswitchId string

The virtual switch ID to launch ADB PG instances in one VPC.

ZoneId string

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

ConnectionString string

ADB PG instance connection string.

DbInstanceCategory string

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

DbInstanceDescription string

The description of ADB PG instance. It is a string of 2 to 256 characters.

EncryptionKey string

EncryptionType string

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

Engine string

Database engine: gpdb.

EngineVersion string

Database version. Valid value is 6.0.

InstanceNetworkType string

The network type of ADB PG instance. Only VPC supported now.

InstanceSpec string

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

PaymentDuration int

PaymentDurationUnit string

PaymentType string

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

Port string

(Available in 1.196.0+) The connection port of the instance.

SecurityIpLists []string

SegNodeNum int

The number of segment nodes. Minimum is 4, max is 256, step is 4.

SegStorageType string

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

Status string

Instance status.

StorageSize int

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

Tags map[string]string

A mapping of tags to assign to the resource.

VswitchId string

The virtual switch ID to launch ADB PG instances in one VPC.

ZoneId string

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

connectionString String

ADB PG instance connection string.

dbInstanceCategory String

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

dbInstanceDescription String

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryptionKey String

encryptionType String

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

engine String

Database engine: gpdb.

engineVersion String

Database version. Valid value is 6.0.

instanceNetworkType String

The network type of ADB PG instance. Only VPC supported now.

instanceSpec String

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

paymentDuration Integer

paymentDurationUnit String

paymentType String

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

port String

(Available in 1.196.0+) The connection port of the instance.

securityIpLists List<String>

segNodeNum Integer

The number of segment nodes. Minimum is 4, max is 256, step is 4.

segStorageType String

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

status String

Instance status.

storageSize Integer

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

tags Map<String,String>

A mapping of tags to assign to the resource.

vswitchId String

The virtual switch ID to launch ADB PG instances in one VPC.

zoneId String

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

connectionString string

ADB PG instance connection string.

dbInstanceCategory string

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

dbInstanceDescription string

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryptionKey string

encryptionType string

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

engine string

Database engine: gpdb.

engineVersion string

Database version. Valid value is 6.0.

instanceNetworkType string

The network type of ADB PG instance. Only VPC supported now.

instanceSpec string

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

paymentDuration number

paymentDurationUnit string

paymentType string

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

port string

(Available in 1.196.0+) The connection port of the instance.

securityIpLists string[]

segNodeNum number

The number of segment nodes. Minimum is 4, max is 256, step is 4.

segStorageType string

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

status string

Instance status.

storageSize number

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

tags {[key: string]: string}

A mapping of tags to assign to the resource.

vswitchId string

The virtual switch ID to launch ADB PG instances in one VPC.

zoneId string

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

connection_string str

ADB PG instance connection string.

db_instance_category str

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

db_instance_description str

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryption_key str

encryption_type str

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

engine str

Database engine: gpdb.

engine_version str

Database version. Valid value is 6.0.

instance_network_type str

The network type of ADB PG instance. Only VPC supported now.

instance_spec str

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

payment_duration int

payment_duration_unit str

payment_type str

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

port str

(Available in 1.196.0+) The connection port of the instance.

security_ip_lists Sequence[str]

seg_node_num int

The number of segment nodes. Minimum is 4, max is 256, step is 4.

seg_storage_type str

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

status str

Instance status.

storage_size int

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

tags Mapping[str, str]

A mapping of tags to assign to the resource.

vswitch_id str

The virtual switch ID to launch ADB PG instances in one VPC.

zone_id str

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

connectionString String

ADB PG instance connection string.

dbInstanceCategory String

The edition of the instance. Valid values: Basic, HighAvailability. Default value: HighAvailability.

dbInstanceDescription String

The description of ADB PG instance. It is a string of 2 to 256 characters.

encryptionKey String

encryptionType String

The type of the encryption. Valid values: CloudDisk. Note: Disk encryption cannot be disabled after it is enabled.

engine String

Database engine: gpdb.

engineVersion String

Database version. Valid value is 6.0.

instanceNetworkType String

The network type of ADB PG instance. Only VPC supported now.

instanceSpec String

The specification of segment nodes.

When db_instance_category is HighAvailability, Valid values: 2C16G, 4C32G, 16C128G.
When db_instance_category is Basic, Valid values: 2C8G, 4C16G, 8C32G, 16C64G.

paymentDuration Number

paymentDurationUnit String

paymentType String

Valid values are PayAsYouGo, Subscription. Default to PayAsYouGo.

port String

(Available in 1.196.0+) The connection port of the instance.

securityIpLists List<String>

segNodeNum Number

The number of segment nodes. Minimum is 4, max is 256, step is 4.

segStorageType String

The disk type of segment nodes. Valid values: cloud_essd, cloud_efficiency.

status String

Instance status.

storageSize Number

The storage capacity of per segment node. Unit: GB. Minimum is 50, max is 4000, step is 50.

tags Map<String>

A mapping of tags to assign to the resource.

vswitchId String

The virtual switch ID to launch ADB PG instances in one VPC.

zoneId String

The Zone to launch the ADB PG instance. If specified, must be consistent with the zone where the vswitch is located.

Import

AnalyticDB for PostgreSQL can be imported using the id, e.g.

$ pulumi import alicloud:gpdb/elasticInstance:ElasticInstance adb_pg_instance gp-bpxxxxxxxxxxxxxx

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: Alibaba Cloud pulumi/pulumi-alicloud
License: Apache-2.0
Notes: This Pulumi package is based on the alicloud Terraform Provider.

Alibaba Cloud v3.76.0 published on Tuesday, Apr 8, 2025 by Pulumi

pulumi/pulumi-alicloud

alicloud.gpdb.ElasticInstance

On this page

On this page

Example Usage

Create a AnalyticDB for PostgreSQL instance

Create ElasticInstance Resource

Constructor syntax

Parameters

Constructor example

ElasticInstance Resource Properties

Inputs

Outputs

Look up Existing ElasticInstance Resource

Import

Package Details

On this page

On this page