1. Packages
  2. Volcenginecc Provider
  3. API Docs
  4. ecs
  5. Instance
volcenginecc v0.0.4 published on Monday, Nov 3, 2025 by Volcengine

volcenginecc.ecs.Instance

Get Started
volcenginecc logo
volcenginecc v0.0.4 published on Monday, Nov 3, 2025 by Volcengine

    表示一个弹性计算服务(ECS)的实例资源。

    Example Usage

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      ecsInstanceDemo:
        type: volcenginecc:ecs:Instance
        name: EcsInstanceDemo
        properties:
          password: '**********'
          instanceChargeType: PostPaid
          instanceName: EcsInstanceDemo
          spotStrategy: NoSpot
          hostname: EcsInstanceDemo
          description: EcsInstanceDemo Description
          projectName: default
          instanceType: ecs.g4i.large
          deletionProtection: false
          zoneId: cn-beijing-a
          deploymentSetId: dps-ydzccfzqjoaa98kxxxxx
          deploymentSetGroupNumber: 1
          image:
            image_id: image-aagd56zrw2jtdroxxxxx
          vpcId: vpc-rrco37ovjq4gv0x58zxxxxx
          eipAddress:
            charge_type: PayByTraffic
            bandwidth_mbps: 5
            isp: BGP
            release_with_instance: false
            bandwidth_package_id: ""
          primaryNetworkInterface:
            security_group_ids:
              - sg-1v9zvjkmx14w51j8e73xxxxx
            subnet_id: subnet-rrwqhg3qzxfkv0x57gxxxxx
            ipv_6_address_count: 1
          secondaryNetworkInterfaces:
            - security_group_ids:
                - sg-1v9zvjkmx14w51j8e73xxxxx
              subnet_id: subnet-rrwqhg3qzxfkv0x57gxxxxx
          placement:
            affinity: Default
            dedicated_host_cluster_id: ""
            tenancy: Default
            dedicated_host_id: ""
          systemVolume:
            size: 50
            delete_with_instance: true
            volume_type: ESSD_FlexPL
    

    Create Instance Resource

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

    Constructor syntax

    new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);
    @overload
    def Instance(resource_name: str,
                 args: InstanceArgs,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def Instance(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 image: Optional[InstanceImageArgs] = None,
                 zone_id: Optional[str] = None,
                 system_volume: Optional[InstanceSystemVolumeArgs] = None,
                 primary_network_interface: Optional[InstancePrimaryNetworkInterfaceArgs] = None,
                 instance_type: Optional[str] = None,
                 instance_name: Optional[str] = None,
                 key_pair: Optional[InstanceKeyPairArgs] = None,
                 period: Optional[int] = None,
                 description: Optional[str] = None,
                 eip_address: Optional[InstanceEipAddressArgs] = None,
                 hostname: Optional[str] = None,
                 hpc_cluster_id: Optional[str] = None,
                 deployment_set_group_number: Optional[int] = None,
                 instance_charge_type: Optional[str] = None,
                 deletion_protection: Optional[bool] = None,
                 credit_specification: Optional[str] = None,
                 affinity_group_size: Optional[int] = None,
                 operation_system: Optional[InstanceOperationSystemArgs] = None,
                 password: Optional[str] = None,
                 deployment_set_id: Optional[str] = None,
                 period_unit: Optional[str] = None,
                 placement: Optional[InstancePlacementArgs] = None,
                 cpu_max_frequency: Optional[float] = None,
                 project_name: Optional[str] = None,
                 secondary_network_interfaces: Optional[Sequence[InstanceSecondaryNetworkInterfaceArgs]] = None,
                 spot_price_limit: Optional[float] = None,
                 spot_strategy: Optional[str] = None,
                 status: Optional[str] = None,
                 auto_renew_period: Optional[int] = None,
                 tags: Optional[Sequence[InstanceTagArgs]] = None,
                 user_data: Optional[str] = None,
                 vpc_id: Optional[str] = None,
                 auto_renew: Optional[bool] = None)
    func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)
    public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)
    public Instance(String name, InstanceArgs args)
    public Instance(String name, InstanceArgs args, CustomResourceOptions options)
    
    type: volcenginecc:ecs:Instance
    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 InstanceArgs
    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 InstanceArgs
    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 InstanceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args InstanceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args InstanceArgs
    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.

    var instanceResource = new Volcenginecc.Ecs.Instance("instanceResource", new()
    {
        Image = new Volcenginecc.Ecs.Inputs.InstanceImageArgs
        {
            ImageId = "string",
            ImageReleaseVersion = "string",
            KeepImageCredential = false,
            SecurityEnhancementStrategy = "string",
        },
        ZoneId = "string",
        SystemVolume = new Volcenginecc.Ecs.Inputs.InstanceSystemVolumeArgs
        {
            DeleteWithInstance = false,
            ExtraPerformanceIops = 0,
            ExtraPerformanceThroughputMb = 0,
            ExtraPerformanceTypeId = "string",
            Size = 0,
            SnapshotId = "string",
            VolumeId = "string",
            VolumeType = "string",
        },
        PrimaryNetworkInterface = new Volcenginecc.Ecs.Inputs.InstancePrimaryNetworkInterfaceArgs
        {
            SecurityGroupIds = new[]
            {
                "string",
            },
            SubnetId = "string",
            Ipv6AddressCount = 0,
            Ipv6Addresses = new[]
            {
                "string",
            },
            MacAddress = "string",
            NetworkInterfaceId = "string",
            PrimaryIpAddress = "string",
            PrivateIpAddresses = new[]
            {
                "string",
            },
            VpcId = "string",
        },
        InstanceType = "string",
        InstanceName = "string",
        KeyPair = new Volcenginecc.Ecs.Inputs.InstanceKeyPairArgs
        {
            KeyPairId = "string",
            KeyPairName = "string",
        },
        Period = 0,
        Description = "string",
        EipAddress = new Volcenginecc.Ecs.Inputs.InstanceEipAddressArgs
        {
            AllocationId = "string",
            BandwidthMbps = 0,
            BandwidthPackageId = "string",
            ChargeType = "string",
            IpAddress = "string",
            Isp = "string",
            ReleaseWithInstance = false,
        },
        Hostname = "string",
        HpcClusterId = "string",
        DeploymentSetGroupNumber = 0,
        InstanceChargeType = "string",
        DeletionProtection = false,
        CreditSpecification = "string",
        AffinityGroupSize = 0,
        OperationSystem = new Volcenginecc.Ecs.Inputs.InstanceOperationSystemArgs
        {
            Name = "string",
            Type = "string",
        },
        Password = "string",
        DeploymentSetId = "string",
        PeriodUnit = "string",
        Placement = new Volcenginecc.Ecs.Inputs.InstancePlacementArgs
        {
            Affinity = "string",
            DedicatedHostClusterId = "string",
            DedicatedHostId = "string",
            Tenancy = "string",
        },
        CpuMaxFrequency = 0,
        ProjectName = "string",
        SecondaryNetworkInterfaces = new[]
        {
            new Volcenginecc.Ecs.Inputs.InstanceSecondaryNetworkInterfaceArgs
            {
                Ipv6AddressCount = 0,
                PrimaryIpAddress = "string",
                PrivateIpAddresses = new[]
                {
                    "string",
                },
                SecurityGroupIds = new[]
                {
                    "string",
                },
                SubnetId = "string",
                VpcId = "string",
            },
        },
        SpotPriceLimit = 0,
        SpotStrategy = "string",
        Status = "string",
        AutoRenewPeriod = 0,
        Tags = new[]
        {
            new Volcenginecc.Ecs.Inputs.InstanceTagArgs
            {
                Key = "string",
                Value = "string",
            },
        },
        UserData = "string",
        VpcId = "string",
        AutoRenew = false,
    });
    
    example, err := ecs.NewInstance(ctx, "instanceResource", &ecs.InstanceArgs{
    	Image: &ecs.InstanceImageArgs{
    		ImageId:                     pulumi.String("string"),
    		ImageReleaseVersion:         pulumi.String("string"),
    		KeepImageCredential:         pulumi.Bool(false),
    		SecurityEnhancementStrategy: pulumi.String("string"),
    	},
    	ZoneId: pulumi.String("string"),
    	SystemVolume: &ecs.InstanceSystemVolumeArgs{
    		DeleteWithInstance:           pulumi.Bool(false),
    		ExtraPerformanceIops:         pulumi.Int(0),
    		ExtraPerformanceThroughputMb: pulumi.Int(0),
    		ExtraPerformanceTypeId:       pulumi.String("string"),
    		Size:                         pulumi.Int(0),
    		SnapshotId:                   pulumi.String("string"),
    		VolumeId:                     pulumi.String("string"),
    		VolumeType:                   pulumi.String("string"),
    	},
    	PrimaryNetworkInterface: &ecs.InstancePrimaryNetworkInterfaceArgs{
    		SecurityGroupIds: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		SubnetId:         pulumi.String("string"),
    		Ipv6AddressCount: pulumi.Int(0),
    		Ipv6Addresses: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		MacAddress:         pulumi.String("string"),
    		NetworkInterfaceId: pulumi.String("string"),
    		PrimaryIpAddress:   pulumi.String("string"),
    		PrivateIpAddresses: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		VpcId: pulumi.String("string"),
    	},
    	InstanceType: pulumi.String("string"),
    	InstanceName: pulumi.String("string"),
    	KeyPair: &ecs.InstanceKeyPairArgs{
    		KeyPairId:   pulumi.String("string"),
    		KeyPairName: pulumi.String("string"),
    	},
    	Period:      pulumi.Int(0),
    	Description: pulumi.String("string"),
    	EipAddress: &ecs.InstanceEipAddressArgs{
    		AllocationId:        pulumi.String("string"),
    		BandwidthMbps:       pulumi.Int(0),
    		BandwidthPackageId:  pulumi.String("string"),
    		ChargeType:          pulumi.String("string"),
    		IpAddress:           pulumi.String("string"),
    		Isp:                 pulumi.String("string"),
    		ReleaseWithInstance: pulumi.Bool(false),
    	},
    	Hostname:                 pulumi.String("string"),
    	HpcClusterId:             pulumi.String("string"),
    	DeploymentSetGroupNumber: pulumi.Int(0),
    	InstanceChargeType:       pulumi.String("string"),
    	DeletionProtection:       pulumi.Bool(false),
    	CreditSpecification:      pulumi.String("string"),
    	AffinityGroupSize:        pulumi.Int(0),
    	OperationSystem: &ecs.InstanceOperationSystemArgs{
    		Name: pulumi.String("string"),
    		Type: pulumi.String("string"),
    	},
    	Password:        pulumi.String("string"),
    	DeploymentSetId: pulumi.String("string"),
    	PeriodUnit:      pulumi.String("string"),
    	Placement: &ecs.InstancePlacementArgs{
    		Affinity:               pulumi.String("string"),
    		DedicatedHostClusterId: pulumi.String("string"),
    		DedicatedHostId:        pulumi.String("string"),
    		Tenancy:                pulumi.String("string"),
    	},
    	CpuMaxFrequency: pulumi.Float64(0),
    	ProjectName:     pulumi.String("string"),
    	SecondaryNetworkInterfaces: ecs.InstanceSecondaryNetworkInterfaceArray{
    		&ecs.InstanceSecondaryNetworkInterfaceArgs{
    			Ipv6AddressCount: pulumi.Int(0),
    			PrimaryIpAddress: pulumi.String("string"),
    			PrivateIpAddresses: pulumi.StringArray{
    				pulumi.String("string"),
    			},
    			SecurityGroupIds: pulumi.StringArray{
    				pulumi.String("string"),
    			},
    			SubnetId: pulumi.String("string"),
    			VpcId:    pulumi.String("string"),
    		},
    	},
    	SpotPriceLimit:  pulumi.Float64(0),
    	SpotStrategy:    pulumi.String("string"),
    	Status:          pulumi.String("string"),
    	AutoRenewPeriod: pulumi.Int(0),
    	Tags: ecs.InstanceTagArray{
    		&ecs.InstanceTagArgs{
    			Key:   pulumi.String("string"),
    			Value: pulumi.String("string"),
    		},
    	},
    	UserData:  pulumi.String("string"),
    	VpcId:     pulumi.String("string"),
    	AutoRenew: pulumi.Bool(false),
    })
    
    var instanceResource = new com.volcengine.volcenginecc.ecs.Instance("instanceResource", com.volcengine.volcenginecc.ecs.InstanceArgs.builder()
        .image(InstanceImageArgs.builder()
            .imageId("string")
            .imageReleaseVersion("string")
            .keepImageCredential(false)
            .securityEnhancementStrategy("string")
            .build())
        .zoneId("string")
        .systemVolume(InstanceSystemVolumeArgs.builder()
            .deleteWithInstance(false)
            .extraPerformanceIops(0)
            .extraPerformanceThroughputMb(0)
            .extraPerformanceTypeId("string")
            .size(0)
            .snapshotId("string")
            .volumeId("string")
            .volumeType("string")
            .build())
        .primaryNetworkInterface(InstancePrimaryNetworkInterfaceArgs.builder()
            .securityGroupIds("string")
            .subnetId("string")
            .ipv6AddressCount(0)
            .ipv6Addresses("string")
            .macAddress("string")
            .networkInterfaceId("string")
            .primaryIpAddress("string")
            .privateIpAddresses("string")
            .vpcId("string")
            .build())
        .instanceType("string")
        .instanceName("string")
        .keyPair(InstanceKeyPairArgs.builder()
            .keyPairId("string")
            .keyPairName("string")
            .build())
        .period(0)
        .description("string")
        .eipAddress(InstanceEipAddressArgs.builder()
            .allocationId("string")
            .bandwidthMbps(0)
            .bandwidthPackageId("string")
            .chargeType("string")
            .ipAddress("string")
            .isp("string")
            .releaseWithInstance(false)
            .build())
        .hostname("string")
        .hpcClusterId("string")
        .deploymentSetGroupNumber(0)
        .instanceChargeType("string")
        .deletionProtection(false)
        .creditSpecification("string")
        .affinityGroupSize(0)
        .operationSystem(InstanceOperationSystemArgs.builder()
            .name("string")
            .type("string")
            .build())
        .password("string")
        .deploymentSetId("string")
        .periodUnit("string")
        .placement(InstancePlacementArgs.builder()
            .affinity("string")
            .dedicatedHostClusterId("string")
            .dedicatedHostId("string")
            .tenancy("string")
            .build())
        .cpuMaxFrequency(0.0)
        .projectName("string")
        .secondaryNetworkInterfaces(InstanceSecondaryNetworkInterfaceArgs.builder()
            .ipv6AddressCount(0)
            .primaryIpAddress("string")
            .privateIpAddresses("string")
            .securityGroupIds("string")
            .subnetId("string")
            .vpcId("string")
            .build())
        .spotPriceLimit(0.0)
        .spotStrategy("string")
        .status("string")
        .autoRenewPeriod(0)
        .tags(InstanceTagArgs.builder()
            .key("string")
            .value("string")
            .build())
        .userData("string")
        .vpcId("string")
        .autoRenew(false)
        .build());
    
    instance_resource = volcenginecc.ecs.Instance("instanceResource",
        image={
            "image_id": "string",
            "image_release_version": "string",
            "keep_image_credential": False,
            "security_enhancement_strategy": "string",
        },
        zone_id="string",
        system_volume={
            "delete_with_instance": False,
            "extra_performance_iops": 0,
            "extra_performance_throughput_mb": 0,
            "extra_performance_type_id": "string",
            "size": 0,
            "snapshot_id": "string",
            "volume_id": "string",
            "volume_type": "string",
        },
        primary_network_interface={
            "security_group_ids": ["string"],
            "subnet_id": "string",
            "ipv6_address_count": 0,
            "ipv6_addresses": ["string"],
            "mac_address": "string",
            "network_interface_id": "string",
            "primary_ip_address": "string",
            "private_ip_addresses": ["string"],
            "vpc_id": "string",
        },
        instance_type="string",
        instance_name="string",
        key_pair={
            "key_pair_id": "string",
            "key_pair_name": "string",
        },
        period=0,
        description="string",
        eip_address={
            "allocation_id": "string",
            "bandwidth_mbps": 0,
            "bandwidth_package_id": "string",
            "charge_type": "string",
            "ip_address": "string",
            "isp": "string",
            "release_with_instance": False,
        },
        hostname="string",
        hpc_cluster_id="string",
        deployment_set_group_number=0,
        instance_charge_type="string",
        deletion_protection=False,
        credit_specification="string",
        affinity_group_size=0,
        operation_system={
            "name": "string",
            "type": "string",
        },
        password="string",
        deployment_set_id="string",
        period_unit="string",
        placement={
            "affinity": "string",
            "dedicated_host_cluster_id": "string",
            "dedicated_host_id": "string",
            "tenancy": "string",
        },
        cpu_max_frequency=0,
        project_name="string",
        secondary_network_interfaces=[{
            "ipv6_address_count": 0,
            "primary_ip_address": "string",
            "private_ip_addresses": ["string"],
            "security_group_ids": ["string"],
            "subnet_id": "string",
            "vpc_id": "string",
        }],
        spot_price_limit=0,
        spot_strategy="string",
        status="string",
        auto_renew_period=0,
        tags=[{
            "key": "string",
            "value": "string",
        }],
        user_data="string",
        vpc_id="string",
        auto_renew=False)
    
    const instanceResource = new volcenginecc.ecs.Instance("instanceResource", {
        image: {
            imageId: "string",
            imageReleaseVersion: "string",
            keepImageCredential: false,
            securityEnhancementStrategy: "string",
        },
        zoneId: "string",
        systemVolume: {
            deleteWithInstance: false,
            extraPerformanceIops: 0,
            extraPerformanceThroughputMb: 0,
            extraPerformanceTypeId: "string",
            size: 0,
            snapshotId: "string",
            volumeId: "string",
            volumeType: "string",
        },
        primaryNetworkInterface: {
            securityGroupIds: ["string"],
            subnetId: "string",
            ipv6AddressCount: 0,
            ipv6Addresses: ["string"],
            macAddress: "string",
            networkInterfaceId: "string",
            primaryIpAddress: "string",
            privateIpAddresses: ["string"],
            vpcId: "string",
        },
        instanceType: "string",
        instanceName: "string",
        keyPair: {
            keyPairId: "string",
            keyPairName: "string",
        },
        period: 0,
        description: "string",
        eipAddress: {
            allocationId: "string",
            bandwidthMbps: 0,
            bandwidthPackageId: "string",
            chargeType: "string",
            ipAddress: "string",
            isp: "string",
            releaseWithInstance: false,
        },
        hostname: "string",
        hpcClusterId: "string",
        deploymentSetGroupNumber: 0,
        instanceChargeType: "string",
        deletionProtection: false,
        creditSpecification: "string",
        affinityGroupSize: 0,
        operationSystem: {
            name: "string",
            type: "string",
        },
        password: "string",
        deploymentSetId: "string",
        periodUnit: "string",
        placement: {
            affinity: "string",
            dedicatedHostClusterId: "string",
            dedicatedHostId: "string",
            tenancy: "string",
        },
        cpuMaxFrequency: 0,
        projectName: "string",
        secondaryNetworkInterfaces: [{
            ipv6AddressCount: 0,
            primaryIpAddress: "string",
            privateIpAddresses: ["string"],
            securityGroupIds: ["string"],
            subnetId: "string",
            vpcId: "string",
        }],
        spotPriceLimit: 0,
        spotStrategy: "string",
        status: "string",
        autoRenewPeriod: 0,
        tags: [{
            key: "string",
            value: "string",
        }],
        userData: "string",
        vpcId: "string",
        autoRenew: false,
    });
    
    type: volcenginecc:ecs:Instance
    properties:
        affinityGroupSize: 0
        autoRenew: false
        autoRenewPeriod: 0
        cpuMaxFrequency: 0
        creditSpecification: string
        deletionProtection: false
        deploymentSetGroupNumber: 0
        deploymentSetId: string
        description: string
        eipAddress:
            allocationId: string
            bandwidthMbps: 0
            bandwidthPackageId: string
            chargeType: string
            ipAddress: string
            isp: string
            releaseWithInstance: false
        hostname: string
        hpcClusterId: string
        image:
            imageId: string
            imageReleaseVersion: string
            keepImageCredential: false
            securityEnhancementStrategy: string
        instanceChargeType: string
        instanceName: string
        instanceType: string
        keyPair:
            keyPairId: string
            keyPairName: string
        operationSystem:
            name: string
            type: string
        password: string
        period: 0
        periodUnit: string
        placement:
            affinity: string
            dedicatedHostClusterId: string
            dedicatedHostId: string
            tenancy: string
        primaryNetworkInterface:
            ipv6AddressCount: 0
            ipv6Addresses:
                - string
            macAddress: string
            networkInterfaceId: string
            primaryIpAddress: string
            privateIpAddresses:
                - string
            securityGroupIds:
                - string
            subnetId: string
            vpcId: string
        projectName: string
        secondaryNetworkInterfaces:
            - ipv6AddressCount: 0
              primaryIpAddress: string
              privateIpAddresses:
                - string
              securityGroupIds:
                - string
              subnetId: string
              vpcId: string
        spotPriceLimit: 0
        spotStrategy: string
        status: string
        systemVolume:
            deleteWithInstance: false
            extraPerformanceIops: 0
            extraPerformanceThroughputMb: 0
            extraPerformanceTypeId: string
            size: 0
            snapshotId: string
            volumeId: string
            volumeType: string
        tags:
            - key: string
              value: string
        userData: string
        vpcId: string
        zoneId: string
    

    Instance 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 Instance resource accepts the following input properties:

    Image Volcengine.InstanceImage
    实例的镜像。
    InstanceName string
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    InstanceType string

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    PrimaryNetworkInterface Volcengine.InstancePrimaryNetworkInterface
    实例的主网卡。
    SystemVolume Volcengine.InstanceSystemVolume
    实例的系统卷。
    ZoneId string
    实例所在的可用区ID。
    AffinityGroupSize int
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    AutoRenew bool
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    AutoRenewPeriod int
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    CpuMaxFrequency double
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    CreditSpecification string
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    DeletionProtection bool
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    DeploymentSetGroupNumber int
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    DeploymentSetId string
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    Description string
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    EipAddress Volcengine.InstanceEipAddress
    实例的EIP地址。
    Hostname string
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    HpcClusterId string
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    InstanceChargeType string
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    KeyPair Volcengine.InstanceKeyPair
    实例的密钥对名称。
    OperationSystem Volcengine.InstanceOperationSystem
    实例的操作系统类型。
    Password string
    实例的密码。
    Period int
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    PeriodUnit string
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    Placement Volcengine.InstancePlacement
    实例的部署信息。
    ProjectName string
    实例所属的项目名称。
    SecondaryNetworkInterfaces List<Volcengine.InstanceSecondaryNetworkInterface>
    SpotPriceLimit double
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    SpotStrategy string
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    Status string
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    Tags List<Volcengine.InstanceTag>
    UserData string
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    VpcId string
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    Image InstanceImageArgs
    实例的镜像。
    InstanceName string
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    InstanceType string

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    PrimaryNetworkInterface InstancePrimaryNetworkInterfaceArgs
    实例的主网卡。
    SystemVolume InstanceSystemVolumeArgs
    实例的系统卷。
    ZoneId string
    实例所在的可用区ID。
    AffinityGroupSize int
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    AutoRenew bool
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    AutoRenewPeriod int
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    CpuMaxFrequency float64
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    CreditSpecification string
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    DeletionProtection bool
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    DeploymentSetGroupNumber int
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    DeploymentSetId string
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    Description string
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    EipAddress InstanceEipAddressArgs
    实例的EIP地址。
    Hostname string
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    HpcClusterId string
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    InstanceChargeType string
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    KeyPair InstanceKeyPairArgs
    实例的密钥对名称。
    OperationSystem InstanceOperationSystemArgs
    实例的操作系统类型。
    Password string
    实例的密码。
    Period int
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    PeriodUnit string
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    Placement InstancePlacementArgs
    实例的部署信息。
    ProjectName string
    实例所属的项目名称。
    SecondaryNetworkInterfaces []InstanceSecondaryNetworkInterfaceArgs
    SpotPriceLimit float64
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    SpotStrategy string
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    Status string
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    Tags []InstanceTagArgs
    UserData string
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    VpcId string
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    image InstanceImage
    实例的镜像。
    instanceName String
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instanceType String

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    primaryNetworkInterface InstancePrimaryNetworkInterface
    实例的主网卡。
    systemVolume InstanceSystemVolume
    实例的系统卷。
    zoneId String
    实例所在的可用区ID。
    affinityGroupSize Integer
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    autoRenew Boolean
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    autoRenewPeriod Integer
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpuMaxFrequency Double
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    creditSpecification String
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletionProtection Boolean
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deploymentSetGroupNumber Integer
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deploymentSetId String
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description String
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eipAddress InstanceEipAddress
    实例的EIP地址。
    hostname String
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpcClusterId String
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    instanceChargeType String
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    keyPair InstanceKeyPair
    实例的密钥对名称。
    operationSystem InstanceOperationSystem
    实例的操作系统类型。
    password String
    实例的密码。
    period Integer
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    periodUnit String
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement InstancePlacement
    实例的部署信息。
    projectName String
    实例所属的项目名称。
    secondaryNetworkInterfaces List<InstanceSecondaryNetworkInterface>
    spotPriceLimit Double
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spotStrategy String
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status String
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    tags List<InstanceTag>
    userData String
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpcId String
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    image InstanceImage
    实例的镜像。
    instanceName string
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instanceType string

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    primaryNetworkInterface InstancePrimaryNetworkInterface
    实例的主网卡。
    systemVolume InstanceSystemVolume
    实例的系统卷。
    zoneId string
    实例所在的可用区ID。
    affinityGroupSize number
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    autoRenew boolean
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    autoRenewPeriod number
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpuMaxFrequency number
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    creditSpecification string
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletionProtection boolean
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deploymentSetGroupNumber number
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deploymentSetId string
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description string
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eipAddress InstanceEipAddress
    实例的EIP地址。
    hostname string
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpcClusterId string
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    instanceChargeType string
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    keyPair InstanceKeyPair
    实例的密钥对名称。
    operationSystem InstanceOperationSystem
    实例的操作系统类型。
    password string
    实例的密码。
    period number
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    periodUnit string
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement InstancePlacement
    实例的部署信息。
    projectName string
    实例所属的项目名称。
    secondaryNetworkInterfaces InstanceSecondaryNetworkInterface[]
    spotPriceLimit number
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spotStrategy string
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status string
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    tags InstanceTag[]
    userData string
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpcId string
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    image InstanceImageArgs
    实例的镜像。
    instance_name str
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instance_type str

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    primary_network_interface InstancePrimaryNetworkInterfaceArgs
    实例的主网卡。
    system_volume InstanceSystemVolumeArgs
    实例的系统卷。
    zone_id str
    实例所在的可用区ID。
    affinity_group_size int
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    auto_renew bool
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    auto_renew_period int
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpu_max_frequency float
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    credit_specification str
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletion_protection bool
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deployment_set_group_number int
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deployment_set_id str
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description str
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eip_address InstanceEipAddressArgs
    实例的EIP地址。
    hostname str
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpc_cluster_id str
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    instance_charge_type str
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    key_pair InstanceKeyPairArgs
    实例的密钥对名称。
    operation_system InstanceOperationSystemArgs
    实例的操作系统类型。
    password str
    实例的密码。
    period int
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    period_unit str
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement InstancePlacementArgs
    实例的部署信息。
    project_name str
    实例所属的项目名称。
    secondary_network_interfaces Sequence[InstanceSecondaryNetworkInterfaceArgs]
    spot_price_limit float
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spot_strategy str
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status str
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    tags Sequence[InstanceTagArgs]
    user_data str
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpc_id str
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    image Property Map
    实例的镜像。
    instanceName String
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instanceType String

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    primaryNetworkInterface Property Map
    实例的主网卡。
    systemVolume Property Map
    实例的系统卷。
    zoneId String
    实例所在的可用区ID。
    affinityGroupSize Number
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    autoRenew Boolean
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    autoRenewPeriod Number
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpuMaxFrequency Number
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    creditSpecification String
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletionProtection Boolean
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deploymentSetGroupNumber Number
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deploymentSetId String
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description String
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eipAddress Property Map
    实例的EIP地址。
    hostname String
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpcClusterId String
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    instanceChargeType String
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    keyPair Property Map
    实例的密钥对名称。
    operationSystem Property Map
    实例的操作系统类型。
    password String
    实例的密码。
    period Number
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    periodUnit String
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement Property Map
    实例的部署信息。
    projectName String
    实例所属的项目名称。
    secondaryNetworkInterfaces List<Property Map>
    spotPriceLimit Number
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spotStrategy String
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status String
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    tags List<Property Map>
    userData String
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpcId String
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。

    Outputs

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

    CpuMemory Volcengine.InstanceCpuMemory
    实例的CPU选项。
    CreatedAt string
    实例的创建时间。
    ExpiredAt string
    实例的过期时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceId string
    ECS实例的ID。
    UpdatedAt string
    实例的更新时间。
    CpuMemory InstanceCpuMemory
    实例的CPU选项。
    CreatedAt string
    实例的创建时间。
    ExpiredAt string
    实例的过期时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceId string
    ECS实例的ID。
    UpdatedAt string
    实例的更新时间。
    cpuMemory InstanceCpuMemory
    实例的CPU选项。
    createdAt String
    实例的创建时间。
    expiredAt String
    实例的过期时间。
    id String
    The provider-assigned unique ID for this managed resource.
    instanceId String
    ECS实例的ID。
    updatedAt String
    实例的更新时间。
    cpuMemory InstanceCpuMemory
    实例的CPU选项。
    createdAt string
    实例的创建时间。
    expiredAt string
    实例的过期时间。
    id string
    The provider-assigned unique ID for this managed resource.
    instanceId string
    ECS实例的ID。
    updatedAt string
    实例的更新时间。
    cpu_memory InstanceCpuMemory
    实例的CPU选项。
    created_at str
    实例的创建时间。
    expired_at str
    实例的过期时间。
    id str
    The provider-assigned unique ID for this managed resource.
    instance_id str
    ECS实例的ID。
    updated_at str
    实例的更新时间。
    cpuMemory Property Map
    实例的CPU选项。
    createdAt String
    实例的创建时间。
    expiredAt String
    实例的过期时间。
    id String
    The provider-assigned unique ID for this managed resource.
    instanceId String
    ECS实例的ID。
    updatedAt String
    实例的更新时间。

    Look up Existing Instance Resource

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

    public static get(name: string, id: Input<ID>, state?: InstanceState, opts?: CustomResourceOptions): Instance
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            affinity_group_size: Optional[int] = None,
            auto_renew: Optional[bool] = None,
            auto_renew_period: Optional[int] = None,
            cpu_max_frequency: Optional[float] = None,
            cpu_memory: Optional[InstanceCpuMemoryArgs] = None,
            created_at: Optional[str] = None,
            credit_specification: Optional[str] = None,
            deletion_protection: Optional[bool] = None,
            deployment_set_group_number: Optional[int] = None,
            deployment_set_id: Optional[str] = None,
            description: Optional[str] = None,
            eip_address: Optional[InstanceEipAddressArgs] = None,
            expired_at: Optional[str] = None,
            hostname: Optional[str] = None,
            hpc_cluster_id: Optional[str] = None,
            image: Optional[InstanceImageArgs] = None,
            instance_charge_type: Optional[str] = None,
            instance_id: Optional[str] = None,
            instance_name: Optional[str] = None,
            instance_type: Optional[str] = None,
            key_pair: Optional[InstanceKeyPairArgs] = None,
            operation_system: Optional[InstanceOperationSystemArgs] = None,
            password: Optional[str] = None,
            period: Optional[int] = None,
            period_unit: Optional[str] = None,
            placement: Optional[InstancePlacementArgs] = None,
            primary_network_interface: Optional[InstancePrimaryNetworkInterfaceArgs] = None,
            project_name: Optional[str] = None,
            secondary_network_interfaces: Optional[Sequence[InstanceSecondaryNetworkInterfaceArgs]] = None,
            spot_price_limit: Optional[float] = None,
            spot_strategy: Optional[str] = None,
            status: Optional[str] = None,
            system_volume: Optional[InstanceSystemVolumeArgs] = None,
            tags: Optional[Sequence[InstanceTagArgs]] = None,
            updated_at: Optional[str] = None,
            user_data: Optional[str] = None,
            vpc_id: Optional[str] = None,
            zone_id: Optional[str] = None) -> Instance
    func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)
    public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)
    public static Instance get(String name, Output<String> id, InstanceState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:ecs:Instance    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:
    AffinityGroupSize int
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    AutoRenew bool
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    AutoRenewPeriod int
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    CpuMaxFrequency double
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    CpuMemory Volcengine.InstanceCpuMemory
    实例的CPU选项。
    CreatedAt string
    实例的创建时间。
    CreditSpecification string
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    DeletionProtection bool
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    DeploymentSetGroupNumber int
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    DeploymentSetId string
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    Description string
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    EipAddress Volcengine.InstanceEipAddress
    实例的EIP地址。
    ExpiredAt string
    实例的过期时间。
    Hostname string
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    HpcClusterId string
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    Image Volcengine.InstanceImage
    实例的镜像。
    InstanceChargeType string
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    InstanceId string
    ECS实例的ID。
    InstanceName string
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    InstanceType string

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    KeyPair Volcengine.InstanceKeyPair
    实例的密钥对名称。
    OperationSystem Volcengine.InstanceOperationSystem
    实例的操作系统类型。
    Password string
    实例的密码。
    Period int
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    PeriodUnit string
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    Placement Volcengine.InstancePlacement
    实例的部署信息。
    PrimaryNetworkInterface Volcengine.InstancePrimaryNetworkInterface
    实例的主网卡。
    ProjectName string
    实例所属的项目名称。
    SecondaryNetworkInterfaces List<Volcengine.InstanceSecondaryNetworkInterface>
    SpotPriceLimit double
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    SpotStrategy string
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    Status string
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    SystemVolume Volcengine.InstanceSystemVolume
    实例的系统卷。
    Tags List<Volcengine.InstanceTag>
    UpdatedAt string
    实例的更新时间。
    UserData string
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    VpcId string
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    ZoneId string
    实例所在的可用区ID。
    AffinityGroupSize int
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    AutoRenew bool
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    AutoRenewPeriod int
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    CpuMaxFrequency float64
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    CpuMemory InstanceCpuMemoryArgs
    实例的CPU选项。
    CreatedAt string
    实例的创建时间。
    CreditSpecification string
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    DeletionProtection bool
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    DeploymentSetGroupNumber int
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    DeploymentSetId string
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    Description string
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    EipAddress InstanceEipAddressArgs
    实例的EIP地址。
    ExpiredAt string
    实例的过期时间。
    Hostname string
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    HpcClusterId string
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    Image InstanceImageArgs
    实例的镜像。
    InstanceChargeType string
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    InstanceId string
    ECS实例的ID。
    InstanceName string
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    InstanceType string

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    KeyPair InstanceKeyPairArgs
    实例的密钥对名称。
    OperationSystem InstanceOperationSystemArgs
    实例的操作系统类型。
    Password string
    实例的密码。
    Period int
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    PeriodUnit string
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    Placement InstancePlacementArgs
    实例的部署信息。
    PrimaryNetworkInterface InstancePrimaryNetworkInterfaceArgs
    实例的主网卡。
    ProjectName string
    实例所属的项目名称。
    SecondaryNetworkInterfaces []InstanceSecondaryNetworkInterfaceArgs
    SpotPriceLimit float64
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    SpotStrategy string
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    Status string
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    SystemVolume InstanceSystemVolumeArgs
    实例的系统卷。
    Tags []InstanceTagArgs
    UpdatedAt string
    实例的更新时间。
    UserData string
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    VpcId string
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    ZoneId string
    实例所在的可用区ID。
    affinityGroupSize Integer
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    autoRenew Boolean
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    autoRenewPeriod Integer
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpuMaxFrequency Double
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    cpuMemory InstanceCpuMemory
    实例的CPU选项。
    createdAt String
    实例的创建时间。
    creditSpecification String
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletionProtection Boolean
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deploymentSetGroupNumber Integer
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deploymentSetId String
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description String
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eipAddress InstanceEipAddress
    实例的EIP地址。
    expiredAt String
    实例的过期时间。
    hostname String
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpcClusterId String
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    image InstanceImage
    实例的镜像。
    instanceChargeType String
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    instanceId String
    ECS实例的ID。
    instanceName String
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instanceType String

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    keyPair InstanceKeyPair
    实例的密钥对名称。
    operationSystem InstanceOperationSystem
    实例的操作系统类型。
    password String
    实例的密码。
    period Integer
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    periodUnit String
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement InstancePlacement
    实例的部署信息。
    primaryNetworkInterface InstancePrimaryNetworkInterface
    实例的主网卡。
    projectName String
    实例所属的项目名称。
    secondaryNetworkInterfaces List<InstanceSecondaryNetworkInterface>
    spotPriceLimit Double
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spotStrategy String
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status String
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    systemVolume InstanceSystemVolume
    实例的系统卷。
    tags List<InstanceTag>
    updatedAt String
    实例的更新时间。
    userData String
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpcId String
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    zoneId String
    实例所在的可用区ID。
    affinityGroupSize number
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    autoRenew boolean
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    autoRenewPeriod number
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpuMaxFrequency number
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    cpuMemory InstanceCpuMemory
    实例的CPU选项。
    createdAt string
    实例的创建时间。
    creditSpecification string
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletionProtection boolean
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deploymentSetGroupNumber number
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deploymentSetId string
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description string
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eipAddress InstanceEipAddress
    实例的EIP地址。
    expiredAt string
    实例的过期时间。
    hostname string
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpcClusterId string
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    image InstanceImage
    实例的镜像。
    instanceChargeType string
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    instanceId string
    ECS实例的ID。
    instanceName string
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instanceType string

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    keyPair InstanceKeyPair
    实例的密钥对名称。
    operationSystem InstanceOperationSystem
    实例的操作系统类型。
    password string
    实例的密码。
    period number
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    periodUnit string
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement InstancePlacement
    实例的部署信息。
    primaryNetworkInterface InstancePrimaryNetworkInterface
    实例的主网卡。
    projectName string
    实例所属的项目名称。
    secondaryNetworkInterfaces InstanceSecondaryNetworkInterface[]
    spotPriceLimit number
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spotStrategy string
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status string
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    systemVolume InstanceSystemVolume
    实例的系统卷。
    tags InstanceTag[]
    updatedAt string
    实例的更新时间。
    userData string
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpcId string
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    zoneId string
    实例所在的可用区ID。
    affinity_group_size int
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    auto_renew bool
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    auto_renew_period int
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpu_max_frequency float
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    cpu_memory InstanceCpuMemoryArgs
    实例的CPU选项。
    created_at str
    实例的创建时间。
    credit_specification str
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletion_protection bool
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deployment_set_group_number int
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deployment_set_id str
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description str
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eip_address InstanceEipAddressArgs
    实例的EIP地址。
    expired_at str
    实例的过期时间。
    hostname str
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpc_cluster_id str
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    image InstanceImageArgs
    实例的镜像。
    instance_charge_type str
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    instance_id str
    ECS实例的ID。
    instance_name str
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instance_type str

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    key_pair InstanceKeyPairArgs
    实例的密钥对名称。
    operation_system InstanceOperationSystemArgs
    实例的操作系统类型。
    password str
    实例的密码。
    period int
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    period_unit str
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement InstancePlacementArgs
    实例的部署信息。
    primary_network_interface InstancePrimaryNetworkInterfaceArgs
    实例的主网卡。
    project_name str
    实例所属的项目名称。
    secondary_network_interfaces Sequence[InstanceSecondaryNetworkInterfaceArgs]
    spot_price_limit float
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spot_strategy str
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status str
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    system_volume InstanceSystemVolumeArgs
    实例的系统卷。
    tags Sequence[InstanceTagArgs]
    updated_at str
    实例的更新时间。
    user_data str
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpc_id str
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    zone_id str
    实例所在的可用区ID。
    affinityGroupSize Number
    亲和组规格,取值:2。 :::tip - 当前仅高性能计算NPU型hpcpci3实例(邀测)支持亲和组。 - 该功能正在邀测中,如需试用,请联系客户经理申请。 :::
    autoRenew Boolean
    实例到期后是否自动续费,取值: - true:自动续费。 - false(默认):不自动续费。 :::tip 仅当参数InstanceChargeType取值为PrePaid时生效。 :::
    autoRenewPeriod Number
    每次自动续费的时长。 - 仅当参数AutoRenew取值为True时,该参数生效,默认值为1。 - PeriodUnit取值为Month时,该参数取值为1、2、3、6、12。
    cpuMaxFrequency Number
    指定CPU最大频率,单位:GHz,取值范围:CPU的主频到睿频之间。 :::tip - 当前仅g3al、c3al、r3al、g4i、c4i、r4i、g4ie、c4ie、r4ie实例支持设置该参数。规格的主频/睿频及更多信息,请参见实例规格介绍

    • 该功能正在邀测中,如需使用,请联系客户经理申请。 :::
    cpuMemory Property Map
    实例的CPU选项。
    createdAt String
    实例的创建时间。
    creditSpecification String
    突发性能实例的运行模式,取值: - Standard:标准模式。 - Unlimited:无性能约束模式(暂不支持)。 :::tip - 仅当InstanceTypeId取值为ecs.t2系列,即突发性能实例时该参数生效。 - 不传或传入空值时,突发性能实例默认为Standard标准模式。 :::
    deletionProtection Boolean
    实例删除保护属性,指定是否支持通过控制台或API删除实例。取值: - true:开启实例删除保护。 - false(默认):关闭实例删除保护。 开启实例删除保护后,在控制台或调用API删除实例时,会收到删除失败的错误码。如需删除,请先关闭实例删除保护。
    deploymentSetGroupNumber Number
    当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号,取值范围:1~7。
    deploymentSetId String
    实例需要加入的部署集ID。 - 您可以调用DescribeDeploymentSets接口,查询已创建的部署集。

    • 关于部署集的更多信息,请参见部署集
    description String
    实例的描述,默认为空字符串。 - 必须以字母或中文开头。 - 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“,”和中文句号“。”

    • 长度限制在255个字符以内。
    eipAddress Property Map
    实例的EIP地址。
    expiredAt String
    实例的过期时间。
    hostname String
    实例主机名,即实例操作系统内部的计算机名。 - Linux实例: - 允许使用字母、数字、点号“.”或中划线“-”。 - 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。 - Linux系统长度限制在2~63个字符之间。 - Windows实例: - 允许使用字母、数字或中划线“-”,不能完全是数字。 - 不能以中划线开头或结尾,且不能连续使用中划线。 - Windows系统长度限制在2~15个字符之间。
    hpcClusterId String
    实例所属的高性能计算集群ID。 :::tip 仅当创建高性能计算GPU型实例时,该参数生效且为必填项。 :::
    image Property Map
    实例的镜像。
    instanceChargeType String
    实例和云盘的计费类型,取值: - PostPaid:按量计费。 - PrePaid:包年包月。请确认您的账号支持余额支付或者信控支付,否则将返回InvalidInstanceChargeType的错误提示。
    instanceId String
    ECS实例的ID。
    instanceName String
    实例的名称。 - 以字母或中文开头。 - 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。 - 长度限制为1~128个字符。
    instanceType String

    实例规格。 - 产品选型:您可以参考实例规格介绍或者调用DescribeInstanceTypes查看实例规格的性能数据,也可以参考实例选型最佳实践了解如何选择实例规格。

    查询库存:您可以调用DescribeAvailableResource查询可用区中计算资源的库存信息。

    keyPair Property Map
    实例的密钥对名称。
    operationSystem Property Map
    实例的操作系统类型。
    password String
    实例的密码。
    period Number
    购买资源的时长(N)。 - PeriodUnitMonth(默认)时,取值:1、2、3、4、5、6、7、8、9、12、24、36、48、60。 - PeriodUnitYear时,取值:1、2、3、4、5。 :::tip 仅当InstanceChargeType取值为PrePaid时生效,且为必填。
    periodUnit String
    购买资源的时长单位。取值: - Month(默认):月。 - Year:年。 :::tip 仅当InstanceChargeType取值为PrePaid时生效。
    placement Property Map
    实例的部署信息。
    primaryNetworkInterface Property Map
    实例的主网卡。
    projectName String
    实例所属的项目名称。
    secondaryNetworkInterfaces List<Property Map>
    spotPriceLimit Number
    竞价实例的每小时最高价格。 - 支持小数点后3位的精度。 - 仅当SpotStrategy取值为SpotWithPriceLimit时生效。 - 当SpotStrategy取值为SpotWithPriceLimit时,您可以自定义设置竞价实例的价格上限,当市场价格高于您的出价时,实例会被释放;当SpotStrategy取值为SpotAsPriceGo时,则代表您接受系统自动出价,跟随当前市场实际价格,此时无需填写该参数。
    spotStrategy String
    竞价策略。取值: - NoSpot(默认):非竞价实例。 - SpotWithPriceLimit:设置价格上限的竞ga价实例。 - SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的竞价实例。
    status String
    实例的状态。实例的状态,取值: CREATING:创建中 RUNNING:运行中 STOPPING:停止中 STOPPED:已停止 REBOOTING: 重启中 STARTING:启动中 REBUILDING:重装中 RESIZING:更配中 ERROR:错误 DELETING:删除中。
    systemVolume Property Map
    实例的系统卷。
    tags List<Property Map>
    updatedAt String
    实例的更新时间。
    userData String
    实例的自定义数据,默认为空。最终传入的UserData会被Base64转码。 - Linux实例:脚本内容不能超过16KB,且必须经过Base64编码。 - Windows实例:脚本内容不能超过8KB,且无需Base64编码。
    vpcId String
    实例所属的私有网络ID。您可以调用DescribeVpcs接口获取目标地域下的VPC信息。
    zoneId String
    实例所在的可用区ID。

    Supporting Types

    InstanceCpuMemory, InstanceCpuMemoryArgs

    CoreCount int
    实例的核数。
    CpuNumber int
    实例的CPU数量。
    MemorySize int
    实例的内存大小,单位MB。
    ThreadsPerCore int
    实例的每核线程数。
    CoreCount int
    实例的核数。
    CpuNumber int
    实例的CPU数量。
    MemorySize int
    实例的内存大小,单位MB。
    ThreadsPerCore int
    实例的每核线程数。
    coreCount Integer
    实例的核数。
    cpuNumber Integer
    实例的CPU数量。
    memorySize Integer
    实例的内存大小,单位MB。
    threadsPerCore Integer
    实例的每核线程数。
    coreCount number
    实例的核数。
    cpuNumber number
    实例的CPU数量。
    memorySize number
    实例的内存大小,单位MB。
    threadsPerCore number
    实例的每核线程数。
    core_count int
    实例的核数。
    cpu_number int
    实例的CPU数量。
    memory_size int
    实例的内存大小,单位MB。
    threads_per_core int
    实例的每核线程数。
    coreCount Number
    实例的核数。
    cpuNumber Number
    实例的CPU数量。
    memorySize Number
    实例的内存大小,单位MB。
    threadsPerCore Number
    实例的每核线程数。

    InstanceEipAddress, InstanceEipAddressArgs

    AllocationId string
    实例的分配ID。
    BandwidthMbps int
    公网IP的带宽上限,默认值为1,单位:Mbps。

    • ChargeType传入PayByBandwidth:取值范围1~500。
    • ChargeType传入PayByTraffic:取值范围1~200。
    BandwidthPackageId string
    共享带宽包的ID,表示将公网IP加入到共享带宽包。

    • 您可以调用DescribeBandwidthPackages接口,查询共享带宽包的ID。
    • 公网IP加入到共享带宽包必须同时满足如下条件:
      • 二者的安全防护类型相同。
      • 二者的地域相同。
      • 公网IP的计费方式必须是按量计费。
      • 共享带宽包为IPv4类型。
    ChargeType string
    公网IP的计费方式,取值:

    • PayByBandwidth(默认):按量计费-按带宽上限计费。
    • PayByTraffic:按量计费-按实际流量计费。
    • PrePaid:包年包月。 :::tip 实例的计费类型InstanceChargeType取值为PostPaid时,该参数取值不能为PrePaid。 :::
    IpAddress string
    实例的IP地址。
    Isp string
    公网IP的线路类型,默认为BGP。取值:

    • BGP:BGP(多线)。
    • 若您的账号已申请并开通了静态单线权限,则可传入如下取值:
      • ChinaMobile:中国移动静态单线。
      • ChinaTelecom:中国电信静态单线。
      • ChinaUnicom:中国联通静态单线。
    • 若您的账号已申请并开通了BGP单线权限,则可传入SingleLine_BGP。
    • 若您的账号已申请并开通了静态BGP权限,则可传入Static_BGP。
    ReleaseWithInstance bool
    实例是否随实例释放。
    AllocationId string
    实例的分配ID。
    BandwidthMbps int
    公网IP的带宽上限,默认值为1,单位:Mbps。

    • ChargeType传入PayByBandwidth:取值范围1~500。
    • ChargeType传入PayByTraffic:取值范围1~200。
    BandwidthPackageId string
    共享带宽包的ID,表示将公网IP加入到共享带宽包。

    • 您可以调用DescribeBandwidthPackages接口,查询共享带宽包的ID。
    • 公网IP加入到共享带宽包必须同时满足如下条件:
      • 二者的安全防护类型相同。
      • 二者的地域相同。
      • 公网IP的计费方式必须是按量计费。
      • 共享带宽包为IPv4类型。
    ChargeType string
    公网IP的计费方式,取值:

    • PayByBandwidth(默认):按量计费-按带宽上限计费。
    • PayByTraffic:按量计费-按实际流量计费。
    • PrePaid:包年包月。 :::tip 实例的计费类型InstanceChargeType取值为PostPaid时,该参数取值不能为PrePaid。 :::
    IpAddress string
    实例的IP地址。
    Isp string
    公网IP的线路类型,默认为BGP。取值:

    • BGP:BGP(多线)。
    • 若您的账号已申请并开通了静态单线权限,则可传入如下取值:
      • ChinaMobile:中国移动静态单线。
      • ChinaTelecom:中国电信静态单线。
      • ChinaUnicom:中国联通静态单线。
    • 若您的账号已申请并开通了BGP单线权限,则可传入SingleLine_BGP。
    • 若您的账号已申请并开通了静态BGP权限,则可传入Static_BGP。
    ReleaseWithInstance bool
    实例是否随实例释放。
    allocationId String
    实例的分配ID。
    bandwidthMbps Integer
    公网IP的带宽上限,默认值为1,单位:Mbps。

    • ChargeType传入PayByBandwidth:取值范围1~500。
    • ChargeType传入PayByTraffic:取值范围1~200。
    bandwidthPackageId String
    共享带宽包的ID,表示将公网IP加入到共享带宽包。

    • 您可以调用DescribeBandwidthPackages接口,查询共享带宽包的ID。
    • 公网IP加入到共享带宽包必须同时满足如下条件:
      • 二者的安全防护类型相同。
      • 二者的地域相同。
      • 公网IP的计费方式必须是按量计费。
      • 共享带宽包为IPv4类型。
    chargeType String
    公网IP的计费方式,取值:

    • PayByBandwidth(默认):按量计费-按带宽上限计费。
    • PayByTraffic:按量计费-按实际流量计费。
    • PrePaid:包年包月。 :::tip 实例的计费类型InstanceChargeType取值为PostPaid时,该参数取值不能为PrePaid。 :::
    ipAddress String
    实例的IP地址。
    isp String
    公网IP的线路类型,默认为BGP。取值:

    • BGP:BGP(多线)。
    • 若您的账号已申请并开通了静态单线权限,则可传入如下取值:
      • ChinaMobile:中国移动静态单线。
      • ChinaTelecom:中国电信静态单线。
      • ChinaUnicom:中国联通静态单线。
    • 若您的账号已申请并开通了BGP单线权限,则可传入SingleLine_BGP。
    • 若您的账号已申请并开通了静态BGP权限,则可传入Static_BGP。
    releaseWithInstance Boolean
    实例是否随实例释放。
    allocationId string
    实例的分配ID。
    bandwidthMbps number
    公网IP的带宽上限,默认值为1,单位:Mbps。

    • ChargeType传入PayByBandwidth:取值范围1~500。
    • ChargeType传入PayByTraffic:取值范围1~200。
    bandwidthPackageId string
    共享带宽包的ID,表示将公网IP加入到共享带宽包。

    • 您可以调用DescribeBandwidthPackages接口,查询共享带宽包的ID。
    • 公网IP加入到共享带宽包必须同时满足如下条件:
      • 二者的安全防护类型相同。
      • 二者的地域相同。
      • 公网IP的计费方式必须是按量计费。
      • 共享带宽包为IPv4类型。
    chargeType string
    公网IP的计费方式,取值:

    • PayByBandwidth(默认):按量计费-按带宽上限计费。
    • PayByTraffic:按量计费-按实际流量计费。
    • PrePaid:包年包月。 :::tip 实例的计费类型InstanceChargeType取值为PostPaid时,该参数取值不能为PrePaid。 :::
    ipAddress string
    实例的IP地址。
    isp string
    公网IP的线路类型,默认为BGP。取值:

    • BGP:BGP(多线)。
    • 若您的账号已申请并开通了静态单线权限,则可传入如下取值:
      • ChinaMobile:中国移动静态单线。
      • ChinaTelecom:中国电信静态单线。
      • ChinaUnicom:中国联通静态单线。
    • 若您的账号已申请并开通了BGP单线权限,则可传入SingleLine_BGP。
    • 若您的账号已申请并开通了静态BGP权限,则可传入Static_BGP。
    releaseWithInstance boolean
    实例是否随实例释放。
    allocation_id str
    实例的分配ID。
    bandwidth_mbps int
    公网IP的带宽上限,默认值为1,单位:Mbps。

    • ChargeType传入PayByBandwidth:取值范围1~500。
    • ChargeType传入PayByTraffic:取值范围1~200。
    bandwidth_package_id str
    共享带宽包的ID,表示将公网IP加入到共享带宽包。

    • 您可以调用DescribeBandwidthPackages接口,查询共享带宽包的ID。
    • 公网IP加入到共享带宽包必须同时满足如下条件:
      • 二者的安全防护类型相同。
      • 二者的地域相同。
      • 公网IP的计费方式必须是按量计费。
      • 共享带宽包为IPv4类型。
    charge_type str
    公网IP的计费方式,取值:

    • PayByBandwidth(默认):按量计费-按带宽上限计费。
    • PayByTraffic:按量计费-按实际流量计费。
    • PrePaid:包年包月。 :::tip 实例的计费类型InstanceChargeType取值为PostPaid时,该参数取值不能为PrePaid。 :::
    ip_address str
    实例的IP地址。
    isp str
    公网IP的线路类型,默认为BGP。取值:

    • BGP:BGP(多线)。
    • 若您的账号已申请并开通了静态单线权限,则可传入如下取值:
      • ChinaMobile:中国移动静态单线。
      • ChinaTelecom:中国电信静态单线。
      • ChinaUnicom:中国联通静态单线。
    • 若您的账号已申请并开通了BGP单线权限,则可传入SingleLine_BGP。
    • 若您的账号已申请并开通了静态BGP权限,则可传入Static_BGP。
    release_with_instance bool
    实例是否随实例释放。
    allocationId String
    实例的分配ID。
    bandwidthMbps Number
    公网IP的带宽上限,默认值为1,单位:Mbps。

    • ChargeType传入PayByBandwidth:取值范围1~500。
    • ChargeType传入PayByTraffic:取值范围1~200。
    bandwidthPackageId String
    共享带宽包的ID,表示将公网IP加入到共享带宽包。

    • 您可以调用DescribeBandwidthPackages接口,查询共享带宽包的ID。
    • 公网IP加入到共享带宽包必须同时满足如下条件:
      • 二者的安全防护类型相同。
      • 二者的地域相同。
      • 公网IP的计费方式必须是按量计费。
      • 共享带宽包为IPv4类型。
    chargeType String
    公网IP的计费方式,取值:

    • PayByBandwidth(默认):按量计费-按带宽上限计费。
    • PayByTraffic:按量计费-按实际流量计费。
    • PrePaid:包年包月。 :::tip 实例的计费类型InstanceChargeType取值为PostPaid时,该参数取值不能为PrePaid。 :::
    ipAddress String
    实例的IP地址。
    isp String
    公网IP的线路类型,默认为BGP。取值:

    • BGP:BGP(多线)。
    • 若您的账号已申请并开通了静态单线权限,则可传入如下取值:
      • ChinaMobile:中国移动静态单线。
      • ChinaTelecom:中国电信静态单线。
      • ChinaUnicom:中国联通静态单线。
    • 若您的账号已申请并开通了BGP单线权限,则可传入SingleLine_BGP。
    • 若您的账号已申请并开通了静态BGP权限,则可传入Static_BGP。
    releaseWithInstance Boolean
    实例是否随实例释放。

    InstanceImage, InstanceImageArgs

    ImageId string
    实例的镜像ID。
    ImageReleaseVersion string
    实例的镜像发布版本。
    KeepImageCredential bool
    实例是否保留镜像凭证。
    SecurityEnhancementStrategy string
    实例的安全增强策略。Active:开启安全加固,仅对公共镜像生效。InActive:关闭安全加固,对所有镜像生效。
    ImageId string
    实例的镜像ID。
    ImageReleaseVersion string
    实例的镜像发布版本。
    KeepImageCredential bool
    实例是否保留镜像凭证。
    SecurityEnhancementStrategy string
    实例的安全增强策略。Active:开启安全加固,仅对公共镜像生效。InActive:关闭安全加固,对所有镜像生效。
    imageId String
    实例的镜像ID。
    imageReleaseVersion String
    实例的镜像发布版本。
    keepImageCredential Boolean
    实例是否保留镜像凭证。
    securityEnhancementStrategy String
    实例的安全增强策略。Active:开启安全加固,仅对公共镜像生效。InActive:关闭安全加固,对所有镜像生效。
    imageId string
    实例的镜像ID。
    imageReleaseVersion string
    实例的镜像发布版本。
    keepImageCredential boolean
    实例是否保留镜像凭证。
    securityEnhancementStrategy string
    实例的安全增强策略。Active:开启安全加固,仅对公共镜像生效。InActive:关闭安全加固,对所有镜像生效。
    image_id str
    实例的镜像ID。
    image_release_version str
    实例的镜像发布版本。
    keep_image_credential bool
    实例是否保留镜像凭证。
    security_enhancement_strategy str
    实例的安全增强策略。Active:开启安全加固,仅对公共镜像生效。InActive:关闭安全加固,对所有镜像生效。
    imageId String
    实例的镜像ID。
    imageReleaseVersion String
    实例的镜像发布版本。
    keepImageCredential Boolean
    实例是否保留镜像凭证。
    securityEnhancementStrategy String
    实例的安全增强策略。Active:开启安全加固,仅对公共镜像生效。InActive:关闭安全加固,对所有镜像生效。

    InstanceKeyPair, InstanceKeyPairArgs

    KeyPairId string
    实例的公钥。
    KeyPairName string
    实例的密钥对名称。
    KeyPairId string
    实例的公钥。
    KeyPairName string
    实例的密钥对名称。
    keyPairId String
    实例的公钥。
    keyPairName String
    实例的密钥对名称。
    keyPairId string
    实例的公钥。
    keyPairName string
    实例的密钥对名称。
    key_pair_id str
    实例的公钥。
    key_pair_name str
    实例的密钥对名称。
    keyPairId String
    实例的公钥。
    keyPairName String
    实例的密钥对名称。

    InstanceOperationSystem, InstanceOperationSystemArgs

    Name string
    实例的操作系统名称。
    Type string
    实例的操作系统类型。Linux:Linux系统。Windows:Windows系统。
    Name string
    实例的操作系统名称。
    Type string
    实例的操作系统类型。Linux:Linux系统。Windows:Windows系统。
    name String
    实例的操作系统名称。
    type String
    实例的操作系统类型。Linux:Linux系统。Windows:Windows系统。
    name string
    实例的操作系统名称。
    type string
    实例的操作系统类型。Linux:Linux系统。Windows:Windows系统。
    name str
    实例的操作系统名称。
    type str
    实例的操作系统类型。Linux:Linux系统。Windows:Windows系统。
    name String
    实例的操作系统名称。
    type String
    实例的操作系统类型。Linux:Linux系统。Windows:Windows系统。

    InstancePlacement, InstancePlacementArgs

    Affinity string
    针对节省停机模式的ECS实例,停止后会释放部分资源,本参数用于查看ECS实例重新启动时是否仍固定部署在原宿主机上。取值:Host:启用节省停机模式的实例重新启动时,仍会部署在原宿主机上。Default(默认):启用节省停机模式的实例重新启动时,会优先迁移到支持自动部署的宿主机;若支持自动部署的宿主机资源不足,则在原宿主机上进行启动。
    DedicatedHostClusterId string
    实例的专用主机集群ID。
    DedicatedHostId string
    实例的专用主机ID。
    Tenancy string
    是否在专有宿主机上创建实例,取值:Default(默认):创建普通云服务器实例。Host:创建专有宿主机实例。若您不指定DedicatedHostId,则由系统自动选择专有宿主机放置实例
    Affinity string
    针对节省停机模式的ECS实例,停止后会释放部分资源,本参数用于查看ECS实例重新启动时是否仍固定部署在原宿主机上。取值:Host:启用节省停机模式的实例重新启动时,仍会部署在原宿主机上。Default(默认):启用节省停机模式的实例重新启动时,会优先迁移到支持自动部署的宿主机;若支持自动部署的宿主机资源不足,则在原宿主机上进行启动。
    DedicatedHostClusterId string
    实例的专用主机集群ID。
    DedicatedHostId string
    实例的专用主机ID。
    Tenancy string
    是否在专有宿主机上创建实例,取值:Default(默认):创建普通云服务器实例。Host:创建专有宿主机实例。若您不指定DedicatedHostId,则由系统自动选择专有宿主机放置实例
    affinity String
    针对节省停机模式的ECS实例,停止后会释放部分资源,本参数用于查看ECS实例重新启动时是否仍固定部署在原宿主机上。取值:Host:启用节省停机模式的实例重新启动时,仍会部署在原宿主机上。Default(默认):启用节省停机模式的实例重新启动时,会优先迁移到支持自动部署的宿主机;若支持自动部署的宿主机资源不足,则在原宿主机上进行启动。
    dedicatedHostClusterId String
    实例的专用主机集群ID。
    dedicatedHostId String
    实例的专用主机ID。
    tenancy String
    是否在专有宿主机上创建实例,取值:Default(默认):创建普通云服务器实例。Host:创建专有宿主机实例。若您不指定DedicatedHostId,则由系统自动选择专有宿主机放置实例
    affinity string
    针对节省停机模式的ECS实例,停止后会释放部分资源,本参数用于查看ECS实例重新启动时是否仍固定部署在原宿主机上。取值:Host:启用节省停机模式的实例重新启动时,仍会部署在原宿主机上。Default(默认):启用节省停机模式的实例重新启动时,会优先迁移到支持自动部署的宿主机;若支持自动部署的宿主机资源不足,则在原宿主机上进行启动。
    dedicatedHostClusterId string
    实例的专用主机集群ID。
    dedicatedHostId string
    实例的专用主机ID。
    tenancy string
    是否在专有宿主机上创建实例,取值:Default(默认):创建普通云服务器实例。Host:创建专有宿主机实例。若您不指定DedicatedHostId,则由系统自动选择专有宿主机放置实例
    affinity str
    针对节省停机模式的ECS实例,停止后会释放部分资源,本参数用于查看ECS实例重新启动时是否仍固定部署在原宿主机上。取值:Host:启用节省停机模式的实例重新启动时,仍会部署在原宿主机上。Default(默认):启用节省停机模式的实例重新启动时,会优先迁移到支持自动部署的宿主机;若支持自动部署的宿主机资源不足,则在原宿主机上进行启动。
    dedicated_host_cluster_id str
    实例的专用主机集群ID。
    dedicated_host_id str
    实例的专用主机ID。
    tenancy str
    是否在专有宿主机上创建实例,取值:Default(默认):创建普通云服务器实例。Host:创建专有宿主机实例。若您不指定DedicatedHostId,则由系统自动选择专有宿主机放置实例
    affinity String
    针对节省停机模式的ECS实例,停止后会释放部分资源,本参数用于查看ECS实例重新启动时是否仍固定部署在原宿主机上。取值:Host:启用节省停机模式的实例重新启动时,仍会部署在原宿主机上。Default(默认):启用节省停机模式的实例重新启动时,会优先迁移到支持自动部署的宿主机;若支持自动部署的宿主机资源不足,则在原宿主机上进行启动。
    dedicatedHostClusterId String
    实例的专用主机集群ID。
    dedicatedHostId String
    实例的专用主机ID。
    tenancy String
    是否在专有宿主机上创建实例,取值:Default(默认):创建普通云服务器实例。Host:创建专有宿主机实例。若您不指定DedicatedHostId,则由系统自动选择专有宿主机放置实例

    InstancePrimaryNetworkInterface, InstancePrimaryNetworkInterfaceArgs

    SecurityGroupIds List<string>
    实例的安全组ID。
    SubnetId string
    实例的子网ID。
    Ipv6AddressCount int
    实例的IPv6地址数量。
    Ipv6Addresses List<string>
    实例的IPv6地址。
    MacAddress string
    实例的MAC地址。
    NetworkInterfaceId string
    实例的网络接口ID。
    PrimaryIpAddress string
    实例的主IP地址。
    PrivateIpAddresses List<string>
    实例的私有IP地址。
    VpcId string
    实例的VPC ID。
    SecurityGroupIds []string
    实例的安全组ID。
    SubnetId string
    实例的子网ID。
    Ipv6AddressCount int
    实例的IPv6地址数量。
    Ipv6Addresses []string
    实例的IPv6地址。
    MacAddress string
    实例的MAC地址。
    NetworkInterfaceId string
    实例的网络接口ID。
    PrimaryIpAddress string
    实例的主IP地址。
    PrivateIpAddresses []string
    实例的私有IP地址。
    VpcId string
    实例的VPC ID。
    securityGroupIds List<String>
    实例的安全组ID。
    subnetId String
    实例的子网ID。
    ipv6AddressCount Integer
    实例的IPv6地址数量。
    ipv6Addresses List<String>
    实例的IPv6地址。
    macAddress String
    实例的MAC地址。
    networkInterfaceId String
    实例的网络接口ID。
    primaryIpAddress String
    实例的主IP地址。
    privateIpAddresses List<String>
    实例的私有IP地址。
    vpcId String
    实例的VPC ID。
    securityGroupIds string[]
    实例的安全组ID。
    subnetId string
    实例的子网ID。
    ipv6AddressCount number
    实例的IPv6地址数量。
    ipv6Addresses string[]
    实例的IPv6地址。
    macAddress string
    实例的MAC地址。
    networkInterfaceId string
    实例的网络接口ID。
    primaryIpAddress string
    实例的主IP地址。
    privateIpAddresses string[]
    实例的私有IP地址。
    vpcId string
    实例的VPC ID。
    security_group_ids Sequence[str]
    实例的安全组ID。
    subnet_id str
    实例的子网ID。
    ipv6_address_count int
    实例的IPv6地址数量。
    ipv6_addresses Sequence[str]
    实例的IPv6地址。
    mac_address str
    实例的MAC地址。
    network_interface_id str
    实例的网络接口ID。
    primary_ip_address str
    实例的主IP地址。
    private_ip_addresses Sequence[str]
    实例的私有IP地址。
    vpc_id str
    实例的VPC ID。
    securityGroupIds List<String>
    实例的安全组ID。
    subnetId String
    实例的子网ID。
    ipv6AddressCount Number
    实例的IPv6地址数量。
    ipv6Addresses List<String>
    实例的IPv6地址。
    macAddress String
    实例的MAC地址。
    networkInterfaceId String
    实例的网络接口ID。
    primaryIpAddress String
    实例的主IP地址。
    privateIpAddresses List<String>
    实例的私有IP地址。
    vpcId String
    实例的VPC ID。

    InstanceSecondaryNetworkInterface, InstanceSecondaryNetworkInterfaceArgs

    Ipv6AddressCount int
    实例的IPv6地址数量。
    PrimaryIpAddress string
    实例的主IP地址。
    PrivateIpAddresses List<string>
    实例的私有IP地址。
    SecurityGroupIds List<string>
    实例的安全组ID。
    SubnetId string
    实例的子网ID。
    VpcId string
    实例的VPC ID。
    Ipv6AddressCount int
    实例的IPv6地址数量。
    PrimaryIpAddress string
    实例的主IP地址。
    PrivateIpAddresses []string
    实例的私有IP地址。
    SecurityGroupIds []string
    实例的安全组ID。
    SubnetId string
    实例的子网ID。
    VpcId string
    实例的VPC ID。
    ipv6AddressCount Integer
    实例的IPv6地址数量。
    primaryIpAddress String
    实例的主IP地址。
    privateIpAddresses List<String>
    实例的私有IP地址。
    securityGroupIds List<String>
    实例的安全组ID。
    subnetId String
    实例的子网ID。
    vpcId String
    实例的VPC ID。
    ipv6AddressCount number
    实例的IPv6地址数量。
    primaryIpAddress string
    实例的主IP地址。
    privateIpAddresses string[]
    实例的私有IP地址。
    securityGroupIds string[]
    实例的安全组ID。
    subnetId string
    实例的子网ID。
    vpcId string
    实例的VPC ID。
    ipv6_address_count int
    实例的IPv6地址数量。
    primary_ip_address str
    实例的主IP地址。
    private_ip_addresses Sequence[str]
    实例的私有IP地址。
    security_group_ids Sequence[str]
    实例的安全组ID。
    subnet_id str
    实例的子网ID。
    vpc_id str
    实例的VPC ID。
    ipv6AddressCount Number
    实例的IPv6地址数量。
    primaryIpAddress String
    实例的主IP地址。
    privateIpAddresses List<String>
    实例的私有IP地址。
    securityGroupIds List<String>
    实例的安全组ID。
    subnetId String
    实例的子网ID。
    vpcId String
    实例的VPC ID。

    InstanceSystemVolume, InstanceSystemVolumeArgs

    DeleteWithInstance bool
    实例是否随实例删除。
    ExtraPerformanceIops int
    实例的额外性能IOPS。
    ExtraPerformanceThroughputMb int
    实例的额外性能吞吐量,单位MB。
    ExtraPerformanceTypeId string
    额外性能的类型,取值如下:Balance:均衡型额外性能。IOPS:IOPS型额外性能。Throughput:吞吐量型额外性能。
    Size int
    实例的大小,单位GiB。
    SnapshotId string
    实例的快照ID。
    VolumeId string
    实例的卷ID。
    VolumeType string
    云盘类型,取值说明如下:PTSSD:性能型SSD。ESSD_PL0:极速型SSD云盘,PL0规格。ESSD_FlexPL: 极速型SSD云盘,FlexPL规格。TSSD_TL0:吞吐型SSD云盘。
    DeleteWithInstance bool
    实例是否随实例删除。
    ExtraPerformanceIops int
    实例的额外性能IOPS。
    ExtraPerformanceThroughputMb int
    实例的额外性能吞吐量,单位MB。
    ExtraPerformanceTypeId string
    额外性能的类型,取值如下:Balance:均衡型额外性能。IOPS:IOPS型额外性能。Throughput:吞吐量型额外性能。
    Size int
    实例的大小,单位GiB。
    SnapshotId string
    实例的快照ID。
    VolumeId string
    实例的卷ID。
    VolumeType string
    云盘类型,取值说明如下:PTSSD:性能型SSD。ESSD_PL0:极速型SSD云盘,PL0规格。ESSD_FlexPL: 极速型SSD云盘,FlexPL规格。TSSD_TL0:吞吐型SSD云盘。
    deleteWithInstance Boolean
    实例是否随实例删除。
    extraPerformanceIops Integer
    实例的额外性能IOPS。
    extraPerformanceThroughputMb Integer
    实例的额外性能吞吐量,单位MB。
    extraPerformanceTypeId String
    额外性能的类型,取值如下:Balance:均衡型额外性能。IOPS:IOPS型额外性能。Throughput:吞吐量型额外性能。
    size Integer
    实例的大小,单位GiB。
    snapshotId String
    实例的快照ID。
    volumeId String
    实例的卷ID。
    volumeType String
    云盘类型,取值说明如下:PTSSD:性能型SSD。ESSD_PL0:极速型SSD云盘,PL0规格。ESSD_FlexPL: 极速型SSD云盘,FlexPL规格。TSSD_TL0:吞吐型SSD云盘。
    deleteWithInstance boolean
    实例是否随实例删除。
    extraPerformanceIops number
    实例的额外性能IOPS。
    extraPerformanceThroughputMb number
    实例的额外性能吞吐量,单位MB。
    extraPerformanceTypeId string
    额外性能的类型,取值如下:Balance:均衡型额外性能。IOPS:IOPS型额外性能。Throughput:吞吐量型额外性能。
    size number
    实例的大小,单位GiB。
    snapshotId string
    实例的快照ID。
    volumeId string
    实例的卷ID。
    volumeType string
    云盘类型,取值说明如下:PTSSD:性能型SSD。ESSD_PL0:极速型SSD云盘,PL0规格。ESSD_FlexPL: 极速型SSD云盘,FlexPL规格。TSSD_TL0:吞吐型SSD云盘。
    delete_with_instance bool
    实例是否随实例删除。
    extra_performance_iops int
    实例的额外性能IOPS。
    extra_performance_throughput_mb int
    实例的额外性能吞吐量,单位MB。
    extra_performance_type_id str
    额外性能的类型,取值如下:Balance:均衡型额外性能。IOPS:IOPS型额外性能。Throughput:吞吐量型额外性能。
    size int
    实例的大小,单位GiB。
    snapshot_id str
    实例的快照ID。
    volume_id str
    实例的卷ID。
    volume_type str
    云盘类型,取值说明如下:PTSSD:性能型SSD。ESSD_PL0:极速型SSD云盘,PL0规格。ESSD_FlexPL: 极速型SSD云盘,FlexPL规格。TSSD_TL0:吞吐型SSD云盘。
    deleteWithInstance Boolean
    实例是否随实例删除。
    extraPerformanceIops Number
    实例的额外性能IOPS。
    extraPerformanceThroughputMb Number
    实例的额外性能吞吐量,单位MB。
    extraPerformanceTypeId String
    额外性能的类型,取值如下:Balance:均衡型额外性能。IOPS:IOPS型额外性能。Throughput:吞吐量型额外性能。
    size Number
    实例的大小,单位GiB。
    snapshotId String
    实例的快照ID。
    volumeId String
    实例的卷ID。
    volumeType String
    云盘类型,取值说明如下:PTSSD:性能型SSD。ESSD_PL0:极速型SSD云盘,PL0规格。ESSD_FlexPL: 极速型SSD云盘,FlexPL规格。TSSD_TL0:吞吐型SSD云盘。

    InstanceTag, InstanceTagArgs

    Key string
    实例的键。
    Value string
    实例的值。
    Key string
    实例的键。
    Value string
    实例的值。
    key String
    实例的键。
    value String
    实例的值。
    key string
    实例的键。
    value string
    实例的值。
    key str
    实例的键。
    value str
    实例的值。
    key String
    实例的键。
    value String
    实例的值。

    Import

    $ pulumi import volcenginecc:ecs/instance:Instance example "instance_id"
    

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

    Package Details

    Repository
    volcenginecc volcengine/pulumi-volcenginecc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the volcenginecc Terraform Provider.
    volcenginecc logo
    volcenginecc v0.0.4 published on Monday, Nov 3, 2025 by Volcengine
      Meet Neo: Your AI Platform Teammate