All Products
Search
Document Center

Elastic Compute Service:DescribeInstances

Last Updated:Feb 04, 2024

Queries the details of one or more Elastic Compute Service (ECS) instances.

Operation description

  • You can specify multiple request parameters to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions. However, if InstanceIds is set to an empty JSON array, it is regarded as a valid filter condition and an empty result is returned.

  • If you are using a Resource Access Management (RAM) user or RAM role that does not have the permissions to call this operation, an empty list is returned. You can include the DryRun parameter in your request to check whether the empty list is caused by lack of permissions.

  • When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in required formats. For more information, see Parameter format overview.

  • You can use one of the following methods to check the responses:

    • Method 1: During a paged query, when you call the DescribeInstances operation to retrieve the first page of results, set MaxResults to specify the maximum number of entries to return in the call. The return value of NextToken is a pagination token, which can be used in the next call to retrieve a new page of results. When you call the DescribeInstances operation to retrieve a new page of results, set NextToken to the NextToken value returned in the previous call and set MaxResults to specify the maximum number of entries to return in this call.

    • Method 2: Use PageSize to specify the number of entries to return on each page and then use PageNumber to specify the number of the page to return.

      You can use only one of the preceding methods. If a large number of entries are to be returned, we recommend that you use method 1. When MaxResults or NextToken is specified, the PageSize and PageNumber request parameters do not take effect and the TotalCount response parameter is invalid.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
VpcIdstringNo

The ID of the virtual private cloud (VPC) to which the instance belongs.

v-bp67acfmxazb4p****
VSwitchIdstringNo

The ID of the vSwitch to which the instance is connected.

vsw-bp67acfmxazb4p****
ZoneIdstringNo

The zone ID of the instance.

cn-hangzhou-g
InstanceNetworkTypestringNo

The network type of the instance. Valid values:

  • classic: classic network
  • vpc: VPC
vpc
SecurityGroupIdstringNo

The ID of the security group to which the instance belongs.

sg-bp67acfmxazb4p****
InstanceIdsstringNo

The IDs of instances. The value can be a JSON array that consists of up to 100 instance IDs. Separate the IDs with commas (,).

["i-bp67acfmxazb4p****", "i-bp67acfmxazb4p****", … "i-bp67acfmxazb4p****"]
PageNumberintegerNo

The number of the page to return.

Pages start from page 1.

Default value: 1.

1
PageSizeintegerNo

The number of entries to return on each page.

Maximum value: 100.

Default value: 10.

10
NextTokenstringNo

The query token. Set the value to the NextToken value returned in the last call to the DescribeInstances operation.

caeba0bbb2be03f84eb48b699f0a4883
MaxResultsintegerNo

The maximum number of entries to return on each page. Maximum value: 100.

Default value:

  • If this parameter is not specified or is set to a value smaller than 10, the default value is 10.
  • If this parameter is set to a value greater than 100, the default value is 100.
10
InnerIpAddressesstringNo

The internal IP addresses of instances located in the classic network. This parameter is valid when InstanceNetworkType is set to classic. The value can be a JSON array that consists of up to 100 IP addresses. Separate the IP addresses with commas (,).

["10.1.1.1", "10.1.2.1", … "10.1.10.1"]
PrivateIpAddressesstringNo

The private IP addresses of instances located in VPCs. This parameter is valid when InstanceNetworkType is set to vpc. The value can be a JSON array that consists of up to 100 IP addresses. Separate the IP addresses with commas (,).

["172.16.1.1", "172.16.2.1", … "172.16.10.1"]
PublicIpAddressesstringNo

The public IP addresses of instances. The value can be a JSON array that consists of up to 100 IP addresses. Separate the IP addresses with commas (,).

["42.1.1.**", "42.1.2.**", … "42.1.10.**"]
EipAddressesstringNo

The elastic IP addresses (EIPs) of instances. This parameter is valid when InstanceNetworkType is set to vpc. The value can be a JSON array that consists of up to 100 IP addresses. Separate the IP addresses with commas (,).

["42.1.1.**", "42.1.2.**", … "42.1.10.**"]
InstanceChargeTypestringNo

The billing method of the instance. Valid values:

  • PostPaid: pay-as-you-go
  • PrePaid: subscription
PostPaid
InternetChargeTypestringNo

The billing method for network usage. Valid values:

  • PayByBandwidth: pay-by-bandwidth
  • PayByTraffic: pay-by-traffic
Note When the pay-by-traffic billing method for network usage is used, the maximum inbound and outbound bandwidth values are used as upper limits of bandwidths instead of guaranteed performance specifications. In scenarios where demand outstrips resource supplies, these maximum bandwidth values may not be reached. If you want guaranteed bandwidths for your instances, use the pay-by-bandwidth billing method for network usage.
PayByTraffic
InstanceNamestringNo

The name of the instance. Fuzzy search with the asterisk (*) wildcard characters is supported.

Test
ImageIdstringNo

The ID of the image.

m-bp67acfmxazb4p****
StatusstringNo

The state of the instance. Valid values:

  • Pending: The instance is being created.
  • Running: The instance is running.
  • Starting: The instance is being started.
  • Stopping: The instance is being stopped.
  • Stopped: The instance is stopped.
Running
LockReasonstringNo

The reason why the instance is locked. Valid values:

  • financial: The instance is locked due to overdue payments.
  • security: The instance is locked due to security reasons.
  • recycling: The preemptible instance is locked and pending release.
  • dedicatedhostfinancial: The instance is locked due to overdue payments for the dedicated host.
  • refunded: The instance is locked because a refund is made for the instance.
security
Filter.1.KeystringNo

The key of filter 1 used to query resources. Set the value to CreationStartTime. You can specify a time by setting both Filter.1.Key and Filter.1.Value to query resources that were created after the time.

CreationStartTime
Filter.2.KeystringNo

The key of filter 2 used to query resources. Set the value to CreationEndTime. You can specify a time by setting both Filter.2.Key and Filter.2.Value to query resources that were created before the time.

CreationEndTime
Filter.3.KeystringNo

The key of filter 3 used to query resources. Set the value to ExpiredStartTime. You can specify a time by setting both Filter.3.Key and Filter.3.Value to query resources that expire after the time.

ExpiredStartTime
Filter.4.KeystringNo

The key of filter 4 used to query resources. Set the value to ExpiredEndTime. You can specify a time by setting both Filter.4.Key and Filter.4.Value to query resources that expire before the time.

ExpiredEndTime
Filter.1.ValuestringNo

The value of filter 1 used to query resources. Set the value to a time. If you specify this parameter, you must also specify the Filter.1.Key parameter. Specify the time in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.

2017-12-05T22:40Z
Filter.2.ValuestringNo

The value of filter 2 used to query resources. Set the value to a time. If you specify this parameter, you must also specify the Filter.2.Key parameter. Specify the time in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.

2017-12-06T22:40Z
Filter.3.ValuestringNo

The value of filter 3 used to query resources. Set the value to a time. If you specify this parameter, you must also specify the Filter.3.Key parameter. Specify the time in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.

2017-12-07T22:40Z
Filter.4.ValuestringNo

The value of filter 4 used to query resources. Set the value to a time. If you specify this parameter, you must also specify the Filter.4.Key parameter. Specify the time in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.

2017-12-08T22:40Z
IoOptimizedbooleanNo

Specifies whether the instance is I/O optimized.

true
NeedSaleCyclebooleanNo
Note This parameter is currently in invitational preview and unavailable for general users.
false
InstanceTypestringNo

The instance type of the instance.

ecs.g5.large
InstanceTypeFamilystringNo

The instance family of the instance.

ecs.g5
KeyPairNamestringNo

The name of the SSH key pair bound to the instance.

KeyPairNameTest
ResourceGroupIdstringNo

The ID of the resource group to which the instance belongs. If this parameter is specified to query resources, up to 1,000 resources that belong to the specified resource group can be displayed in the response.

Note Resources in the default resource group are displayed in the response regardless of how this parameter is set.
rg-bp67acfmxazb4p****
HpcClusterIdstringNo

The ID of the High Performance Computing (HPC) cluster to which the instance belongs.

hpc-bp67acfmxazb4p****
RdmaIpAddressesstringNo

The Remote Direct Memory Access (RDMA) IP address of the HPC instance.

10.10.10.102
DryRunbooleanNo

Specifies whether to check the validity of the request without actually making the request. Default value: false. Valid values:

  • true: The validity of the request is checked but the request is not made. Check items include whether your AccessKey pair is valid, whether RAM users are granted required permissions, and whether the required parameters are specified. If the check fails, the corresponding error is returned. If the check succeeds, the DryRunOperation error code is returned.
  • false: The validity of the request is checked. If the check succeeds, a 2XX HTTP status code is returned and the request is made.
false
HttpEndpointstringNo

Specifies whether the access channel is enabled for instance metadata. Valid values:

  • enabled
  • disabled

Default value: enabled.

Note For more information about instance metadata, see Overview of ECS instance metadata.
enabled
HttpTokensstringNo

Specifies whether the security hardening mode (IMDSv2) is forcefully used to access instance metadata. Valid values:

  • optional: The security hardening mode (IMDSv2) is not forcefully used.
  • required: The security hardening mode (IMDSv2) is forcefully used. After you set this parameter to required, you cannot access instance metadata in normal mode.

Default value: optional.

Note For more information about modes of accessing instance metadata, see Access mode of instance metadata.
optional
HttpPutResponseHopLimitintegerNo
Note This parameter is currently in invitational preview and unavailable for general users.
0
Ipv6AddressarrayNo

IPv6 address N of the elastic network interface (ENI). You can specify multiple IPv6 addresses. Valid values of N: 1 to 100.

stringNo

The IPv6 address of the elastic network interface(ENI).

2408:4321:180:1701:94c7:bc38:3bfa:****
Tagobject []No

The tags.

keystringNo

The key of tag N of the instance.

Note This parameter will be removed in the future. We recommend that you use the Tag.N.Key parameter to ensure future compatibility.
keyTest
KeystringNo

The key of tag N of the instance. Valid values of N: 1 to 20.

If a single tag is specified to query resources, up to 1,000 resources that have this tag added can be displayed in the response. If multiple tags are specified to query resources, up to 1,000 resources that have all these tags added can be displayed in the response. To query more than 1,000 resources that have specified tags added, call the ListTagResources operation.

TestKey
ValuestringNo

The value of tag N of the instance. Valid values of N: 1 to 20.

TestValue
valuestringNo

The value of tag N of the instance.

Note This parameter will be removed in the future. We recommend that you use the Tag.N.Value parameter to ensure future compatibility.
valueTest
AdditionalAttributesarrayNo

The value of attribute N. Valid values of N: 1 to 20.

stringNo

The value of attribute N. Valid values of N: 1 to 20. Valid values:

  • META_OPTIONS: instance metadata
  • DDH_CLUSTER: dedicated host cluster
  • NETWORK_PRIMARY_ENI_IP: secondary IP address associated with the primary ENI of the instance
  • CPU_OPTIONS_TOPOLOGY_TYPE: CPU topology of the instance
META_OPTIONS

Response parameters

ParameterTypeDescriptionExample
object
NextTokenstring

The query token returned in this call.

caeba0bbb2be03f84eb48b699f0a4883
PageSizeinteger

The number of entries returned per page.

10
PageNumberinteger

The page number of the returned page.

1
RequestIdstring

The ID of the request.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCountinteger

The total number of instances returned.

Note If you specify the MaxResults and NextToken parameters to perform a paged query, the value of the TotalCount response parameter is invalid.
1
Instancesobject []

Details about the instances.

CreationTimestring

The time when the instance was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. For more information, see ISO 8601.

2017-12-10T04:04Z
SerialNumberstring

The serial number of the instance.

51d1353b-22bf-4567-a176-8b3e12e4****
Statusstring

The state of the instance.

Running
DeploymentSetIdstring

The ID of the deployment set in which the instance is deployed.

ds-bp67acfmxazb4p****
KeyPairNamestring

The name of the key pair bound to the instance.

testKeyPairName
SaleCyclestring
Note The parameter is discontinued.
month
SpotStrategystring

The bidding policy for the pay-as-you-go instance. Valid values:

  • NoSpot: The instance is a regular pay-as-you-go instance.
  • SpotWithPriceLimit: The instance is a preemptible instance with a user-defined maximum hourly price.
  • SpotAsPriceGo: The instance is a preemptible instance for which the market price is automatically used as the bid price. The market price can be up to the pay-as-you-go price.
NoSpot
DeviceAvailableboolean

Indicates whether data disks can be attached to the instance.

true
LocalStorageCapacitylong

The capacity of local disks attached to the instance.

1000
Descriptionstring

The description of the instance.

testDescription
SpotDurationinteger

The protection period of the preemptible instance. Unit: hours. Valid values: 0, 1, 2, 3, 4, 5, and 6.

  • Protection periods of 2, 3, 4, 5, and 6 hours are in invitational preview. If you want to set this parameter to one of these values, submit a ticket.
  • A value of 0 indicates that the preemptible instance has no protection period.
Note This parameter is returned when the SpotStrategy parameter is set to SpotWithPriceLimit or SpotAsPriceGo.
1
InstanceNetworkTypestring

The network type of the instance. Valid values:

  • classic
  • vpc
vpc
InstanceNamestring

The name of the instance.

InstanceNameTest
OSNameEnstring

The English name of the operating system of the instance.

CentOS 7.4 64 bit
HpcClusterIdstring

The ID of the HPC cluster to which the instance belongs.

hpc-bp67acfmxazb4p****
SpotPriceLimitfloat

The maximum hourly price of the instance. It can be accurate to three decimal places. This parameter is valid only when the SpotStrategy parameter is set to SpotWithPriceLimit.

0.98
Memoryinteger

The memory size of the instance. Unit: MiB.

16384
OSNamestring

The name of the operating system of the instance.

DeploymentSetGroupNointeger

The number of the deployment set group to which the instance belongs in a deployment set.

1
ImageIdstring

The ID of the image that the instance is running.

m-bp67acfmxazb4p****
VlanIdstring

The virtual LAN (VLAN) ID of the instance.

Note This parameter will be removed in the future. We recommend that you use other parameters to ensure future compatibility.
10
ClusterIdstring

The ID of the cluster to which the instance belongs.

Note This parameter will be removed in the future. We recommend that you use other parameters to ensure future compatibility.
c-bp67acfmxazb4p****
GPUSpecstring

The category of GPUs for the instance type.

NVIDIA V100
AutoReleaseTimestring

The time when to automatically release the pay-as-you-go instance.

2017-12-10T04:04Z
DeletionProtectionboolean

The release protection attribute of the instance. This parameter indicates whether you can use the ECS console or call the DeleteInstance operation to release the instance.

  • true: Release protection is enabled for the instance.
  • false: Release protection is disabled for the instance.
Note This parameter is applicable only to pay-as-you-go instances. It can protect instances against manual releases, but not against automatic releases.
false
StoppedModestring

Indicates whether the instance continues to be billed after it is stopped. Valid values:

  • KeepCharging: The instance is stopped in standard mode. The billing of the instance continues after the instance is stopped, and resources are retained for the instance.
  • StopCharging: The instance is stopped in economical mode. The billing of some resources of the instance stops after the instance is stopped. When the instance is stopped, its resources such as vCPUs, memory, and public IP address are released. The instance may be unable to start again if some required resources are out of stock in the current region.
  • Not-applicable: The instance does not support economical mode.
KeepCharging
GPUAmountinteger

The number of GPUs for the instance type.

4
HostNamestring

The hostname of the instance.

testHostName
InstanceIdstring

The ID of the instance.

i-bp67acfmxazb4p****
InternetMaxBandwidthOutinteger

The maximum outbound public bandwidth. Unit: Mbit/s.

5
InternetMaxBandwidthIninteger

The maximum inbound public bandwidth. Unit: Mbit/s.

50
InstanceTypestring

The instance type of the instance.

ecs.g5.large
InstanceChargeTypestring

The billing method of the instance. Valid values:

  • PrePaid: subscription
  • PostPaid: pay-as-you-go
PostPaid
RegionIdstring

The region ID of the instance.

cn-hangzhou
IoOptimizedboolean

Indicates whether the instance is I/O optimized.

true
StartTimestring

The time when the instance was last started. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. For more information, see ISO 8601.

2017-12-10T04:04Z
Cpuinteger

The number of vCPUs.

8
LocalStorageAmountinteger

The number of local disks attached to the instance.

2
ExpiredTimestring

The time when the instance expires. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. For more information, see ISO 8601.

2017-12-10T04:04Z
ResourceGroupIdstring

The ID of the resource group to which the instance belongs.

rg-bp67acfmxazb4p****
InternetChargeTypestring

The billing method for network usage. Valid values:

  • PayByBandwidth: pay-by-bandwidth
  • PayByTraffic: pay-by-traffic
PayByTraffic
ZoneIdstring

The zone ID of the instance.

cn-hangzhou-g
Recyclableboolean

Indicates whether the instance can be recycled.

false
ISPstring
Note This parameter is in invitational preview and is unavailable for general users.
null
CreditSpecificationstring

The performance mode of the burstable instance. Valid values:

  • Standard: standard mode. For more information, see the "Standard mode" section in Overview .
  • Unlimited: unlimited mode. For more information, see the "Unlimited mode" section in Overview .
Standard
InstanceTypeFamilystring

The instance family of the instance.

ecs.g5
OSTypestring

The type of the operating system of the instance. Valid values:

  • windows
  • linux
linux
NetworkInterfacesobject []

Details about the ENIs bound to the instance.

Typestring

The type of the ENI. Valid values:

  • Primary
  • Secondary
Primary
MacAddressstring

The media access control (MAC) address of the ENI.

00:16:3e:32:b4:**
PrimaryIpAddressstring

The primary private IP address of the ENI.

172.17.**.***
NetworkInterfaceIdstring

The ID of the ENI.

eni-2zeh9atclduxvf1z****
PrivateIpSetsobject []

Details about the private IP address.

PrivateIpAddressstring

The private IP address of the instance to which the ENI is bound.

172.17.**.**
Primaryboolean

Indicates whether the IP address is the primary private IP address.

true
Ipv6Setsobject []

The IPv6 addresses assigned to the ENI. This parameter has a value only when the AdditionalAttributes.N request parameter is set to NETWORK_PRIMARY_ENI_IP.

Ipv6Addressstring

The IPv6 address assigned to the ENI.

2408:4321:180:1701:94c7:bc38:3bfa:***
Ipv4PrefixSetsobject []

The sets of IPv4 prefix.

Ipv4Prefixstring

The IPv4 prefix.

47.122.*.*/19
Ipv6PrefixSetsobject []

The sets of IPv6 prefix.

Ipv6Prefixstring

The IPv6 prefix.

2001:1111:*:*::/64
OperationLocksobject []

The reasons why the instance was locked.

LockMsgstring

The message returned when the instance was locked.

The specified instance is locked due to financial reason.
LockReasonstring

The reason why the instance was locked. Valid values:

  • financial: The instance was locked due to overdue payments.
  • security: The instance was locked due to security reasons.
  • recycling: The preemptible instance was locked and pending release.
  • dedicatedhostfinancial: The instance was locked due to overdue payments for the dedicated host.
  • refunded: The instance was locked because a refund was made for the instance.
Recycling
Tagsobject []

The tags of the instance.

TagValuestring

The tag value of the instance.

TestValue
TagKeystring

The tag key of the instance.

TestKey
RdmaIpAddressarray

The RDMA IP addresses of the HPC instance.

string

The RDMA IP address.

10.10.10.102
SecurityGroupIdsarray

The IDs of the security groups to which the instance belongs.

string

The ID of the security group.

sg-bp67acfmxazb4p****
PublicIpAddressarray

The public IP addresses of the instance.

string

The public IP address.

121.40.**.**
InnerIpAddressarray

The internal IP addresses of the instance located in the classic network.

string

The internal IP address.

10.170.**.**
VpcAttributesobject

The VPC attributes of the instance.

VpcIdstring

The ID of the VPC.

vpc-2zeuphj08tt7q3brd****
NatIpAddressstring

The NAT IP address of the instance. It is used by ECS instances in different VPCs for communication.

172.17.**.**
VSwitchIdstring

The ID of the vSwitch.

vsw-2zeh0r1pabwtg6wcs****
PrivateIpAddressarray

The private IP addresses of the instance.

string

The private IP address.

172.17.**.**
EipAddressobject

Details about the EIP associated with the instance.

IsSupportUnassociateboolean

Indicates whether the EIP can be disassociated.

true
InternetChargeTypestring

The billing method of the EIP. Valid values:

  • PayByBandwidth
  • PayByTraffic
PayByTraffic
IpAddressstring

The EIP.

42.112.**.**
Bandwidthinteger

The maximum public bandwidth of the EIP. Unit: Mbit/s.

5
AllocationIdstring

The ID of the EIP.

eip-2ze88m67qx5z****
HibernationOptionsobject
Note This parameter is in invitational preview and is unavailable for general users.
Configuredboolean
Note This parameter is in invitational preview and is unavailable for general users.
false
DedicatedHostAttributeobject

Details about the dedicated host. It is an array that consists of the DedicatedHostClusterId, DedicatedHostId, and DedicatedHostName parameters.

DedicatedHostIdstring

The ID of the dedicated host.

dh-bp67acfmxazb4p****
DedicatedHostNamestring

The name of the dedicated host.

testDedicatedHostName
DedicatedHostClusterIdstring

The ID of the dedicated host cluster.

dc-bp67acfmxazb4h****
EcsCapacityReservationAttrobject

Details about the capacity reservation related to the instance.

CapacityReservationPreferencestring

The preference of the capacity reservation.

cr-bp67acfmxazb4p****
CapacityReservationIdstring

The ID of the capacity reservation.

cr-bp67acfmxazb4p****
DedicatedInstanceAttributeobject

The attributes of the instance on the dedicated host.

Affinitystring

Indicates whether the instance on the dedicated host is associated with the dedicated host. Valid values:

  • default: The instance is not associated with the dedicated host. When the instance is started from economical mode, the instance may be automatically deployed on another dedicated host in the automatic deployment resource pool.
  • host: The instance is associated with the dedicated host. When the instance is started from economical mode, the instance is still deployed on the original dedicated host.
default
Tenancystring

Indicates whether the instance is hosted on a dedicated host. Valid values:

  • default: The instance is not hosted on a dedicated host.
  • host: The instance is hosted on a dedicated host.
default
CpuOptionsobject

Details about the CPU options.

Numastring

The number of threads allocated. Valid value: 2.

2
CoreCountinteger

The number of physical CPU cores.

2
ThreadsPerCoreinteger

The number of threads per CPU core.

4
TopologyTypestring

The CPU topology type of the instance. Valid values:

  • ContinuousCoreToHTMapping: Hyper-Threading (HT) continuous mode

  • DiscreteCoreToHTMapping: HT discrete mode

ContinuousCoreToHTMapping
MetadataOptionsobject

Details about the metadata options.

HttpEndpointstring

Indicates whether the access channel is enabled for instance metadata. Valid values:

  • enabled
  • disabled
enabled
HttpPutResponseHopLimitinteger
Note This parameter is unavailable.
0
HttpTokensstring

Indicates whether the security hardening mode (IMDSv2) is forcefully used to access instance metadata. Valid values:

  • optional: The security hardening mode (IMDSv2) is not forcefully used.
  • required: The security hardening mode (IMDSv2) is forcefully used.
optional
ImageOptionsobject

Details about the image options.

LoginAsNonRootboolean

Indicates whether the instance that uses the image supports logons of the ecs-user user. Valid values:

  • true: The instance that uses the image supports logons of the ecs-user user.
  • false: The instance that uses the image does not support logons of the ecs-user user.
false
SpotInterruptionBehaviorstring

The interruption mode of the preemptible instance when the system initiates a preemptible instance interruption operation. Valid values:

  • Terminate: releases the instance.

  • Stop: stops the instance in economical mode.

Terminate

Examples

Sample success responses

JSONformat

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "PageSize": 10,
  "PageNumber": 1,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 1,
  "Instances": {
    "Instance": [
      {
        "CreationTime": "2017-12-10T04:04Z",
        "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e4****",
        "Status": "Running",
        "DeploymentSetId": "ds-bp67acfmxazb4p****",
        "KeyPairName": "testKeyPairName",
        "SaleCycle": "month",
        "SpotStrategy": "NoSpot",
        "DeviceAvailable": true,
        "LocalStorageCapacity": 1000,
        "Description": "testDescription",
        "SpotDuration": 1,
        "InstanceNetworkType": "vpc",
        "InstanceName": "InstanceNameTest",
        "OSNameEn": "CentOS  7.4 64 bit",
        "HpcClusterId": "hpc-bp67acfmxazb4p****",
        "SpotPriceLimit": 0.98,
        "Memory": 16384,
        "OSName": "",
        "DeploymentSetGroupNo": 1,
        "ImageId": "m-bp67acfmxazb4p****",
        "VlanId": "10",
        "ClusterId": "c-bp67acfmxazb4p****",
        "GPUSpec": "NVIDIA V100",
        "AutoReleaseTime": "2017-12-10T04:04Z",
        "DeletionProtection": false,
        "StoppedMode": "KeepCharging",
        "GPUAmount": 4,
        "HostName": "testHostName",
        "InstanceId": "i-bp67acfmxazb4p****",
        "InternetMaxBandwidthOut": 5,
        "InternetMaxBandwidthIn": 50,
        "InstanceType": "ecs.g5.large",
        "InstanceChargeType": "PostPaid",
        "RegionId": "cn-hangzhou",
        "IoOptimized": true,
        "StartTime": "2017-12-10T04:04Z",
        "Cpu": 8,
        "LocalStorageAmount": 2,
        "ExpiredTime": "2017-12-10T04:04Z",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "InternetChargeType": "PayByTraffic",
        "ZoneId": "cn-hangzhou-g",
        "Recyclable": false,
        "ISP": "null",
        "CreditSpecification": "Standard",
        "InstanceTypeFamily": "ecs.g5",
        "OSType": "linux",
        "NetworkInterfaces": {
          "NetworkInterface": [
            {
              "Type": "Primary",
              "MacAddress": "00:16:3e:32:b4:**",
              "PrimaryIpAddress": "172.17.**.***",
              "NetworkInterfaceId": "eni-2zeh9atclduxvf1z****",
              "PrivateIpSets": {
                "PrivateIpSet": [
                  {
                    "PrivateIpAddress": "172.17.**.**",
                    "Primary": true
                  }
                ]
              },
              "Ipv6Sets": {
                "Ipv6Set": [
                  {
                    "Ipv6Address": "2408:4321:180:1701:94c7:bc38:3bfa:***"
                  }
                ]
              },
              "Ipv4PrefixSets": {
                "Ipv4PrefixSet": [
                  {
                    "Ipv4Prefix": "47.122.*.*/19"
                  }
                ]
              },
              "Ipv6PrefixSets": {
                "Ipv6PrefixSet": [
                  {
                    "Ipv6Prefix": "2001:1111:*:*::/64"
                  }
                ]
              }
            }
          ]
        },
        "OperationLocks": {
          "LockReason": [
            {
              "LockMsg": "The specified instance is locked due to financial reason.",
              "LockReason": "Recycling"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "TagValue": "TestValue",
              "TagKey": "TestKey"
            }
          ]
        },
        "RdmaIpAddress": {
          "IpAddress": [
            "10.10.10.102"
          ]
        },
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-bp67acfmxazb4p****"
          ]
        },
        "PublicIpAddress": {
          "IpAddress": [
            "121.40.**.**"
          ]
        },
        "InnerIpAddress": {
          "IpAddress": [
            "10.170.**.**"
          ]
        },
        "VpcAttributes": {
          "VpcId": "vpc-2zeuphj08tt7q3brd****",
          "NatIpAddress": "172.17.**.**",
          "VSwitchId": "vsw-2zeh0r1pabwtg6wcs****",
          "PrivateIpAddress": {
            "IpAddress": [
              "172.17.**.**"
            ]
          }
        },
        "EipAddress": {
          "IsSupportUnassociate": true,
          "InternetChargeType": "PayByTraffic",
          "IpAddress": "42.112.**.**",
          "Bandwidth": 5,
          "AllocationId": "eip-2ze88m67qx5z****"
        },
        "HibernationOptions": {
          "Configured": false
        },
        "DedicatedHostAttribute": {
          "DedicatedHostId": "dh-bp67acfmxazb4p****",
          "DedicatedHostName": "testDedicatedHostName",
          "DedicatedHostClusterId": "dc-bp67acfmxazb4h****"
        },
        "EcsCapacityReservationAttr": {
          "CapacityReservationPreference": "cr-bp67acfmxazb4p****",
          "CapacityReservationId": "cr-bp67acfmxazb4p****"
        },
        "DedicatedInstanceAttribute": {
          "Affinity": "default",
          "Tenancy": "default"
        },
        "CpuOptions": {
          "Numa": "2",
          "CoreCount": 2,
          "ThreadsPerCore": 4,
          "TopologyType": "ContinuousCoreToHTMapping"
        },
        "MetadataOptions": {
          "HttpEndpoint": "enabled",
          "HttpPutResponseHopLimit": 0,
          "HttpTokens": "optional"
        },
        "ImageOptions": {
          "LoginAsNonRoot": false
        },
        "SpotInterruptionBehavior": "Terminate"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidTag.MismatchThe specified Tag.n.Key and Tag.n.Value are not match.The specified Tag.N.Key and Tag.N.Value parameters do not correspond to each other.
400InvalidTagCountThe specified tags are beyond the permitted range.The number of specified tags exceeds the upper limit.
400InvalidHpcClusterId.NotFoundThe specified HpcClusterId is not found.The specified HpcClusterId parameter does not exist.
400InvalidHpcClusterId.CreatingThe specified HpcClusterId is creating.The specified HPC cluster is being created.
400InternalErrorThe request processing has failed due to some unknown error, exception or failure.An internal error has occurred. Try again later.
404InvalidInstanceChargeType.NotFoundThe InstanceChargeType does not exist in our records.The specified instance billing method does not exist.
404InvalidInternetChargeType.ValueNotSupportedThe specified InternetChargeType is not valid.The specified InternetChargeType parameter is invalid.
404InvalidLockReason.NotFoundThe specified LockReason is not found.The specified lockout reason does not exist.
404InvalidFilterKey.NotFoundInvalid filter.%s.-
404InvalidFilterValueInvalid filter.%s.-
404InvalidNetworkType.NotFoundThe specified InstanceNetworkType is not found.-
404InvalidStatus.NotFoundThe specified Status is not found.The specified resource state does not exist.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-12-14The Error code has changed. The response structure of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 404
Output ParametersThe response structure of the API has changed.
2023-12-11The Error code has changed. The response structure of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 404
Output ParametersThe response structure of the API has changed.
2021-12-13The Error code has changed. The response structure of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 404
Output ParametersThe response structure of the API has changed.
2021-05-20The API operation is not deprecated.. The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
API Deprecation DescriptionThe API operation is not deprecated..
Error CodesThe Error code has changed.
    Error Codes 404 change
    delete Error Codes: 400
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: Ipv6Address