public class DescribeInstancesRequest
extends com.aliyun.tea.TeaModel
限定符和类型 | 类和说明 |
---|---|
static class |
DescribeInstancesRequest.DescribeInstancesRequestFilter |
static class |
DescribeInstancesRequest.DescribeInstancesRequestTag |
限定符和类型 | 字段和说明 |
---|---|
List<String> |
additionalAttributes
The value of attribute N.
|
Boolean |
deviceAvailable
> This parameter is currently in invitational preview and unavailable for general users.
|
Boolean |
dryRun
Specifies whether to check the validity of the request without actually making the request.
|
String |
eipAddresses
The elastic IP addresses (EIPs) of instances.
|
List<DescribeInstancesRequest.DescribeInstancesRequestFilter> |
filter |
String |
hpcClusterId
The ID of the High Performance Computing (HPC) cluster to which the instance belongs.
|
String |
httpEndpoint
Specifies whether the access channel is enabled for instance metadata.
|
Integer |
httpPutResponseHopLimit
> This parameter is currently in invitational preview and unavailable for general users.
|
String |
httpTokens
Specifies whether the security hardening mode (IMDSv2) is forcefully used to access instance metadata.
|
String |
imageId
The ID of the image.
|
String |
innerIpAddresses
The internal IP addresses of instances located in the classic network.
|
String |
instanceChargeType
The billing method of the instance.
|
String |
instanceIds
The IDs of instances.
|
String |
instanceName
The name of the instance.
|
String |
instanceNetworkType
The network type of the instance.
|
String |
instanceType
The instance type of the instance.
|
String |
instanceTypeFamily
The instance family of the instance.
|
String |
internetChargeType
The billing method for network usage.
|
Boolean |
ioOptimized
Specifies whether the instance is I/O optimized.
|
List<String> |
ipv6Address
IPv6 address N of the elastic network interface (ENI).
|
String |
keyPairName
The name of the SSH key pair bound to the instance.
|
String |
lockReason
The reason why the instance is locked.
|
Integer |
maxResults
The maximum number of entries to return on each page.
|
Boolean |
needSaleCycle
> This parameter is currently in invitational preview and unavailable for general users.
|
String |
nextToken
The query token.
|
String |
ownerAccount |
Long |
ownerId |
Integer |
pageNumber
The number of the page to return.
|
Integer |
pageSize
The number of entries to return on each page.
|
String |
privateIpAddresses
The private IP addresses of instances located in VPCs.
|
String |
publicIpAddresses
The public IP addresses of instances.
|
String |
rdmaIpAddresses
The Remote Direct Memory Access (RDMA) IP address of the HPC instance.
|
String |
regionId
The region ID of the instance.
|
String |
resourceGroupId
The ID of the resource group to which the instance belongs.
|
String |
resourceOwnerAccount |
Long |
resourceOwnerId |
String |
securityGroupId
The ID of the security group to which the instance belongs.
|
String |
status
The state of the instance.
|
List<DescribeInstancesRequest.DescribeInstancesRequestTag> |
tag
The tags.
|
String |
vpcId
The ID of the virtual private cloud (VPC) to which the instance belongs.
|
String |
vSwitchId
The ID of the vSwitch to which the instance is connected.
|
String |
zoneId
The zone ID of the instance.
|
构造器和说明 |
---|
DescribeInstancesRequest() |
@NameInMap(value="Filter") public List<DescribeInstancesRequest.DescribeInstancesRequestFilter> filter
@NameInMap(value="AdditionalAttributes") public List<String> additionalAttributes
The value of attribute N. Valid values of N: 1 to 20.
@NameInMap(value="DeviceAvailable") public Boolean deviceAvailable
> This parameter is currently in invitational preview and unavailable for general users.
@NameInMap(value="DryRun") public Boolean dryRun
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.
@NameInMap(value="EipAddresses") public String eipAddresses
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 (,).
@NameInMap(value="HpcClusterId") public String hpcClusterId
The ID of the High Performance Computing (HPC) cluster to which the instance belongs.
@NameInMap(value="HttpEndpoint") public String httpEndpoint
Specifies whether the access channel is enabled for instance metadata. Valid values:
* enabled
* disabled
Default value: enabled.
> For more information about instance metadata, see [Overview of ECS instance metadata](~~49122~~).
@NameInMap(value="HttpPutResponseHopLimit") public Integer httpPutResponseHopLimit
> This parameter is currently in invitational preview and unavailable for general users.
@NameInMap(value="HttpTokens") public String httpTokens
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.
> For more information about modes of accessing instance metadata, see [Access mode of instance metadata](~~150575~~).
@NameInMap(value="ImageId") public String imageId
The ID of the image.
@NameInMap(value="InnerIpAddresses") public String innerIpAddresses
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 (,).
@NameInMap(value="InstanceChargeType") public String instanceChargeType
The billing method of the instance. Valid values:
* PostPaid: pay-as-you-go
* PrePaid: subscription
@NameInMap(value="InstanceIds") public String instanceIds
The IDs of instances. The value can be a JSON array that consists of up to 100 instance IDs. Separate the IDs with commas (,).
@NameInMap(value="InstanceName") public String instanceName
The name of the instance. Fuzzy search with the asterisk (\*) wildcard characters is supported.
@NameInMap(value="InstanceNetworkType") public String instanceNetworkType
The network type of the instance. Valid values:
* classic: classic network
* vpc: VPC
@NameInMap(value="InstanceType") public String instanceType
The instance type of the instance.
@NameInMap(value="InstanceTypeFamily") public String instanceTypeFamily
The instance family of the instance.
@NameInMap(value="InternetChargeType") public String internetChargeType
The billing method for network usage. Valid values:
* PayByBandwidth: pay-by-bandwidth
* PayByTraffic: pay-by-traffic
> 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.
@NameInMap(value="IoOptimized") public Boolean ioOptimized
Specifies whether the instance is I/O optimized.
@NameInMap(value="Ipv6Address") public List<String> ipv6Address
IPv6 address N of the elastic network interface (ENI). You can specify multiple IPv6 addresses. Valid values of N: 1 to 100.
@NameInMap(value="KeyPairName") public String keyPairName
The name of the SSH key pair bound to the instance.
@NameInMap(value="LockReason") public String lockReason
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.
@NameInMap(value="MaxResults") public Integer maxResults
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.
@NameInMap(value="NeedSaleCycle") public Boolean needSaleCycle
> This parameter is currently in invitational preview and unavailable for general users.
@NameInMap(value="NextToken") public String nextToken
The query token. Set the value to the `NextToken` value returned in the last call to the DescribeInstances operation.
@NameInMap(value="OwnerAccount") public String ownerAccount
@NameInMap(value="OwnerId") public Long ownerId
@NameInMap(value="PageNumber") public Integer pageNumber
The number of the page to return.
Pages start from page 1.
Default value: 1.
@NameInMap(value="PageSize") public Integer pageSize
The number of entries to return on each page.
Maximum value: 100.
Default value: 10.
@NameInMap(value="PrivateIpAddresses") public String privateIpAddresses
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 (,).
@NameInMap(value="PublicIpAddresses") public String publicIpAddresses
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 (,).
@NameInMap(value="RdmaIpAddresses") public String rdmaIpAddresses
The Remote Direct Memory Access (RDMA) IP address of the HPC instance.
@NameInMap(value="RegionId") public String regionId
The region ID of the instance. You can call the [DescribeRegions](~~25609~~) operation to query the most recent region list.
@NameInMap(value="ResourceGroupId") public String resourceGroupId
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.
> Resources in the default resource group are displayed in the response regardless of how this parameter is set.
@NameInMap(value="ResourceOwnerAccount") public String resourceOwnerAccount
@NameInMap(value="ResourceOwnerId") public Long resourceOwnerId
@NameInMap(value="SecurityGroupId") public String securityGroupId
The ID of the security group to which the instance belongs.
@NameInMap(value="Status") public String status
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.
@NameInMap(value="Tag") public List<DescribeInstancesRequest.DescribeInstancesRequestTag> tag
The tags.
@NameInMap(value="VSwitchId") public String vSwitchId
The ID of the vSwitch to which the instance is connected.
@NameInMap(value="VpcId") public String vpcId
The ID of the virtual private cloud (VPC) to which the instance belongs.
@NameInMap(value="ZoneId") public String zoneId
The zone ID of the instance.
public static DescribeInstancesRequest build(Map<String,?> map) throws Exception
Exception
public DescribeInstancesRequest setFilter(List<DescribeInstancesRequest.DescribeInstancesRequestFilter> filter)
public List<DescribeInstancesRequest.DescribeInstancesRequestFilter> getFilter()
public DescribeInstancesRequest setAdditionalAttributes(List<String> additionalAttributes)
public DescribeInstancesRequest setDeviceAvailable(Boolean deviceAvailable)
public Boolean getDeviceAvailable()
public DescribeInstancesRequest setDryRun(Boolean dryRun)
public Boolean getDryRun()
public DescribeInstancesRequest setEipAddresses(String eipAddresses)
public String getEipAddresses()
public DescribeInstancesRequest setHpcClusterId(String hpcClusterId)
public String getHpcClusterId()
public DescribeInstancesRequest setHttpEndpoint(String httpEndpoint)
public String getHttpEndpoint()
public DescribeInstancesRequest setHttpPutResponseHopLimit(Integer httpPutResponseHopLimit)
public Integer getHttpPutResponseHopLimit()
public DescribeInstancesRequest setHttpTokens(String httpTokens)
public String getHttpTokens()
public DescribeInstancesRequest setImageId(String imageId)
public String getImageId()
public DescribeInstancesRequest setInnerIpAddresses(String innerIpAddresses)
public String getInnerIpAddresses()
public DescribeInstancesRequest setInstanceChargeType(String instanceChargeType)
public String getInstanceChargeType()
public DescribeInstancesRequest setInstanceIds(String instanceIds)
public String getInstanceIds()
public DescribeInstancesRequest setInstanceName(String instanceName)
public String getInstanceName()
public DescribeInstancesRequest setInstanceNetworkType(String instanceNetworkType)
public String getInstanceNetworkType()
public DescribeInstancesRequest setInstanceType(String instanceType)
public String getInstanceType()
public DescribeInstancesRequest setInstanceTypeFamily(String instanceTypeFamily)
public String getInstanceTypeFamily()
public DescribeInstancesRequest setInternetChargeType(String internetChargeType)
public String getInternetChargeType()
public DescribeInstancesRequest setIoOptimized(Boolean ioOptimized)
public Boolean getIoOptimized()
public DescribeInstancesRequest setIpv6Address(List<String> ipv6Address)
public DescribeInstancesRequest setKeyPairName(String keyPairName)
public String getKeyPairName()
public DescribeInstancesRequest setLockReason(String lockReason)
public String getLockReason()
public DescribeInstancesRequest setMaxResults(Integer maxResults)
public Integer getMaxResults()
public DescribeInstancesRequest setNeedSaleCycle(Boolean needSaleCycle)
public Boolean getNeedSaleCycle()
public DescribeInstancesRequest setNextToken(String nextToken)
public String getNextToken()
public DescribeInstancesRequest setOwnerAccount(String ownerAccount)
public String getOwnerAccount()
public DescribeInstancesRequest setOwnerId(Long ownerId)
public Long getOwnerId()
public DescribeInstancesRequest setPageNumber(Integer pageNumber)
public Integer getPageNumber()
public DescribeInstancesRequest setPageSize(Integer pageSize)
public Integer getPageSize()
public DescribeInstancesRequest setPrivateIpAddresses(String privateIpAddresses)
public String getPrivateIpAddresses()
public DescribeInstancesRequest setPublicIpAddresses(String publicIpAddresses)
public String getPublicIpAddresses()
public DescribeInstancesRequest setRdmaIpAddresses(String rdmaIpAddresses)
public String getRdmaIpAddresses()
public DescribeInstancesRequest setRegionId(String regionId)
public String getRegionId()
public DescribeInstancesRequest setResourceGroupId(String resourceGroupId)
public String getResourceGroupId()
public DescribeInstancesRequest setResourceOwnerAccount(String resourceOwnerAccount)
public String getResourceOwnerAccount()
public DescribeInstancesRequest setResourceOwnerId(Long resourceOwnerId)
public Long getResourceOwnerId()
public DescribeInstancesRequest setSecurityGroupId(String securityGroupId)
public String getSecurityGroupId()
public DescribeInstancesRequest setStatus(String status)
public String getStatus()
public DescribeInstancesRequest setTag(List<DescribeInstancesRequest.DescribeInstancesRequestTag> tag)
public List<DescribeInstancesRequest.DescribeInstancesRequestTag> getTag()
public DescribeInstancesRequest setVSwitchId(String vSwitchId)
public String getVSwitchId()
public DescribeInstancesRequest setVpcId(String vpcId)
public String getVpcId()
public DescribeInstancesRequest setZoneId(String zoneId)
public String getZoneId()
Copyright © 2023. All rights reserved.