DescribeInstancesRequest.Builder (alibabacloud-ecs20140526 2.0.3 API)

java.lang.Object
- com.aliyun.sdk.service.ecs20140526.models.DescribeInstancesRequest.Builder

所有已实现的接口:

darabonba.core.RequestModel.Builder<DescribeInstancesRequest,DescribeInstancesRequest.Builder>

封闭类:

DescribeInstancesRequest
```
public static final class DescribeInstancesRequest.Builder
extends Object
```

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`DescribeInstancesRequest.Builder`	`additionalAttributes(List<String> additionalAttributes)` The value of attribute N.
`DescribeInstancesRequest`	`build()`
`DescribeInstancesRequest.Builder`	`deviceAvailable(Boolean deviceAvailable)` > This parameter is currently in invitational preview and unavailable for general users.
`DescribeInstancesRequest.Builder`	`dryRun(Boolean dryRun)` Specifies whether to check the validity of the request without actually making the request.
`DescribeInstancesRequest.Builder`	`eipAddresses(String eipAddresses)` The elastic IP addresses (EIPs) of instances.
`DescribeInstancesRequest.Builder`	`filter(List<DescribeInstancesRequest.Filter> filter)` Filter.
`DescribeInstancesRequest.Builder`	`hpcClusterId(String hpcClusterId)` The ID of the High Performance Computing (HPC) cluster to which the instance belongs.
`DescribeInstancesRequest.Builder`	`httpEndpoint(String httpEndpoint)` Specifies whether the access channel is enabled for instance metadata.
`DescribeInstancesRequest.Builder`	`httpPutResponseHopLimit(Integer httpPutResponseHopLimit)` > This parameter is currently in invitational preview and unavailable for general users.
`DescribeInstancesRequest.Builder`	`httpTokens(String httpTokens)` Specifies whether the security hardening mode (IMDSv2) is forcefully used to access instance metadata.
`DescribeInstancesRequest.Builder`	`imageId(String imageId)` The ID of the image.
`DescribeInstancesRequest.Builder`	`innerIpAddresses(String innerIpAddresses)` The internal IP addresses of instances located in the classic network.
`DescribeInstancesRequest.Builder`	`instanceChargeType(String instanceChargeType)` The billing method of the instance.
`DescribeInstancesRequest.Builder`	`instanceIds(String instanceIds)` The IDs of instances.
`DescribeInstancesRequest.Builder`	`instanceName(String instanceName)` The name of the instance.
`DescribeInstancesRequest.Builder`	`instanceNetworkType(String instanceNetworkType)` The network type of the instance.
`DescribeInstancesRequest.Builder`	`instanceType(String instanceType)` The instance type of the instance.
`DescribeInstancesRequest.Builder`	`instanceTypeFamily(String instanceTypeFamily)` The instance family of the instance.
`DescribeInstancesRequest.Builder`	`internetChargeType(String internetChargeType)` The billing method for network usage.
`DescribeInstancesRequest.Builder`	`ioOptimized(Boolean ioOptimized)` Specifies whether the instance is I/O optimized.
`DescribeInstancesRequest.Builder`	`ipv6Address(List<String> ipv6Address)` IPv6 address N of the elastic network interface (ENI).
`DescribeInstancesRequest.Builder`	`keyPairName(String keyPairName)` The name of the SSH key pair bound to the instance.
`DescribeInstancesRequest.Builder`	`lockReason(String lockReason)` The reason why the instance is locked.
`DescribeInstancesRequest.Builder`	`maxResults(Integer maxResults)` The maximum number of entries to return on each page.
`DescribeInstancesRequest.Builder`	`needSaleCycle(Boolean needSaleCycle)` > This parameter is currently in invitational preview and unavailable for general users.
`DescribeInstancesRequest.Builder`	`nextToken(String nextToken)` The query token.
`DescribeInstancesRequest.Builder`	`ownerAccount(String ownerAccount)` OwnerAccount.
`DescribeInstancesRequest.Builder`	`ownerId(Long ownerId)` OwnerId.
`DescribeInstancesRequest.Builder`	`pageNumber(Integer pageNumber)` The number of the page to return.
`DescribeInstancesRequest.Builder`	`pageSize(Integer pageSize)` The number of entries to return on each page.
`DescribeInstancesRequest.Builder`	`privateIpAddresses(String privateIpAddresses)` The private IP addresses of instances located in VPCs.
`DescribeInstancesRequest.Builder`	`publicIpAddresses(String publicIpAddresses)` The public IP addresses of instances.
`DescribeInstancesRequest.Builder`	`rdmaIpAddresses(String rdmaIpAddresses)` The Remote Direct Memory Access (RDMA) IP address of the HPC instance.
`DescribeInstancesRequest.Builder`	`regionId(String regionId)` The region ID of the instance.
`DescribeInstancesRequest.Builder`	`resourceGroupId(String resourceGroupId)` The ID of the resource group to which the instance belongs.
`DescribeInstancesRequest.Builder`	`resourceOwnerAccount(String resourceOwnerAccount)` ResourceOwnerAccount.
`DescribeInstancesRequest.Builder`	`resourceOwnerId(Long resourceOwnerId)` ResourceOwnerId.
`DescribeInstancesRequest.Builder`	`securityGroupId(String securityGroupId)` The ID of the security group to which the instance belongs.
`DescribeInstancesRequest.Builder`	`sourceRegionId(String sourceRegionId)` SourceRegionId.
`DescribeInstancesRequest.Builder`	`status(String status)` The state of the instance.
`DescribeInstancesRequest.Builder`	`tag(List<DescribeInstancesRequest.Tag> tag)` The tags.
`DescribeInstancesRequest.Builder`	`vpcId(String vpcId)` The ID of the virtual private cloud (VPC) to which the instance belongs.
`DescribeInstancesRequest.Builder`	`vSwitchId(String vSwitchId)` The ID of the vSwitch to which the instance is connected.
`DescribeInstancesRequest.Builder`	`zoneId(String zoneId)` The zone ID of the instance.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - filter
```
public DescribeInstancesRequest.Builder filter(List<DescribeInstancesRequest.Filter> filter)
```
    Filter.
  - sourceRegionId
```
public DescribeInstancesRequest.Builder sourceRegionId(String sourceRegionId)
```
    SourceRegionId.
  - additionalAttributes
```
public DescribeInstancesRequest.Builder additionalAttributes(List<String> additionalAttributes)
```
    The value of attribute N. Valid values of N: 1 to 20.
  - deviceAvailable
```
public DescribeInstancesRequest.Builder deviceAvailable(Boolean deviceAvailable)
```
    > This parameter is currently in invitational preview and unavailable for general users.
  - dryRun
```
public DescribeInstancesRequest.Builder dryRun(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.
  - eipAddresses
```
public DescribeInstancesRequest.Builder eipAddresses(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 (,).
  - hpcClusterId
```
public DescribeInstancesRequest.Builder hpcClusterId(String hpcClusterId)
```
    The ID of the High Performance Computing (HPC) cluster to which the instance belongs.
  - httpEndpoint
```
public DescribeInstancesRequest.Builder httpEndpoint(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~~).
  - httpPutResponseHopLimit
```
public DescribeInstancesRequest.Builder httpPutResponseHopLimit(Integer httpPutResponseHopLimit)
```
    > This parameter is currently in invitational preview and unavailable for general users.
  - httpTokens
```
public DescribeInstancesRequest.Builder httpTokens(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~~).
  - imageId
```
public DescribeInstancesRequest.Builder imageId(String imageId)
```
    The ID of the image.
  - innerIpAddresses
```
public DescribeInstancesRequest.Builder innerIpAddresses(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 (,).
  - instanceChargeType
```
public DescribeInstancesRequest.Builder instanceChargeType(String instanceChargeType)
```
    The billing method of the instance. Valid values:
    * PostPaid: pay-as-you-go * PrePaid: subscription
  - instanceIds
```
public DescribeInstancesRequest.Builder instanceIds(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 (,).
  - instanceName
```
public DescribeInstancesRequest.Builder instanceName(String instanceName)
```
    The name of the instance. Fuzzy search with the asterisk (\*) wildcard characters is supported.
  - instanceNetworkType
```
public DescribeInstancesRequest.Builder instanceNetworkType(String instanceNetworkType)
```
    The network type of the instance. Valid values:
    * classic: classic network * vpc: VPC
  - instanceType
```
public DescribeInstancesRequest.Builder instanceType(String instanceType)
```
    The instance type of the instance.
  - instanceTypeFamily
```
public DescribeInstancesRequest.Builder instanceTypeFamily(String instanceTypeFamily)
```
    The instance family of the instance.
  - internetChargeType
```
public DescribeInstancesRequest.Builder internetChargeType(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.
  - ioOptimized
```
public DescribeInstancesRequest.Builder ioOptimized(Boolean ioOptimized)
```
    Specifies whether the instance is I/O optimized.
  - ipv6Address
```
public DescribeInstancesRequest.Builder ipv6Address(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.
  - keyPairName
```
public DescribeInstancesRequest.Builder keyPairName(String keyPairName)
```
    The name of the SSH key pair bound to the instance.
  - lockReason
```
public DescribeInstancesRequest.Builder lockReason(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.
  - maxResults
```
public DescribeInstancesRequest.Builder maxResults(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.
  - needSaleCycle
```
public DescribeInstancesRequest.Builder needSaleCycle(Boolean needSaleCycle)
```
    > This parameter is currently in invitational preview and unavailable for general users.
  - nextToken
```
public DescribeInstancesRequest.Builder nextToken(String nextToken)
```
    The query token. Set the value to the `NextToken` value returned in the last call to the DescribeInstances operation.
  - ownerAccount
```
public DescribeInstancesRequest.Builder ownerAccount(String ownerAccount)
```
    OwnerAccount.
  - ownerId
```
public DescribeInstancesRequest.Builder ownerId(Long ownerId)
```
    OwnerId.
  - pageNumber
```
public DescribeInstancesRequest.Builder pageNumber(Integer pageNumber)
```
    The number of the page to return.
    Pages start from page 1. Default value: 1.
  - pageSize
```
public DescribeInstancesRequest.Builder pageSize(Integer pageSize)
```
    The number of entries to return on each page.
    Maximum value: 100. Default value: 10.
  - privateIpAddresses
```
public DescribeInstancesRequest.Builder privateIpAddresses(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 (,).
  - publicIpAddresses
```
public DescribeInstancesRequest.Builder publicIpAddresses(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 (,).
  - rdmaIpAddresses
```
public DescribeInstancesRequest.Builder rdmaIpAddresses(String rdmaIpAddresses)
```
    The Remote Direct Memory Access (RDMA) IP address of the HPC instance.
  - regionId
```
public DescribeInstancesRequest.Builder regionId(String regionId)
```
    The region ID of the instance. You can call the [DescribeRegions](~~25609~~) operation to query the most recent region list.
  - resourceGroupId
```
public DescribeInstancesRequest.Builder resourceGroupId(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.
  - resourceOwnerAccount
```
public DescribeInstancesRequest.Builder resourceOwnerAccount(String resourceOwnerAccount)
```
    ResourceOwnerAccount.
  - resourceOwnerId
```
public DescribeInstancesRequest.Builder resourceOwnerId(Long resourceOwnerId)
```
    ResourceOwnerId.
  - securityGroupId
```
public DescribeInstancesRequest.Builder securityGroupId(String securityGroupId)
```
    The ID of the security group to which the instance belongs.
  - status
```
public DescribeInstancesRequest.Builder status(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.
  - tag
```
public DescribeInstancesRequest.Builder tag(List<DescribeInstancesRequest.Tag> tag)
```
    The tags.
  - vSwitchId
```
public DescribeInstancesRequest.Builder vSwitchId(String vSwitchId)
```
    The ID of the vSwitch to which the instance is connected.
  - vpcId
```
public DescribeInstancesRequest.Builder vpcId(String vpcId)
```
    The ID of the virtual private cloud (VPC) to which the instance belongs.
  - zoneId
```
public DescribeInstancesRequest.Builder zoneId(String zoneId)
```
    The zone ID of the instance.
  - build
```
public DescribeInstancesRequest build()
```

类 DescribeInstancesRequest.Builder

方法概要

从类继承的方法 java.lang.Object

方法详细资料

filter

sourceRegionId

additionalAttributes

deviceAvailable

dryRun

eipAddresses

hpcClusterId

httpEndpoint

httpPutResponseHopLimit

httpTokens

imageId

innerIpAddresses

instanceChargeType

instanceIds

instanceName

instanceNetworkType

instanceType

instanceTypeFamily

internetChargeType

ioOptimized

ipv6Address

keyPairName

lockReason

maxResults

needSaleCycle

nextToken

ownerAccount

ownerId

pageNumber

pageSize

privateIpAddresses

publicIpAddresses

rdmaIpAddresses

regionId

resourceGroupId

resourceOwnerAccount

resourceOwnerId

securityGroupId

status

tag

vSwitchId

vpcId

zoneId

build