RunInstancesRequest.Builder (alibabacloud-ecs20140526 5.0.19 API)

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

所有已实现的接口:

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

封闭类:

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

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`RunInstancesRequest.Builder`	`affinity(String affinity)` Specifies whether to associate an instance on a dedicated host with the dedicated host.
`RunInstancesRequest.Builder`	`amount(Integer amount)` The desired number of ECS instances that you want to create.
`RunInstancesRequest.Builder`	`arn(List<RunInstancesRequest.Arn> arn)` > This parameter is not publicly available.
`RunInstancesRequest.Builder`	`autoPay(Boolean autoPay)` Specifies whether to automatically complete the payment for instance creation.
`RunInstancesRequest.Builder`	`autoReleaseTime(String autoReleaseTime)` The time when to automatically release the pay-as-you-go instance.
`RunInstancesRequest.Builder`	`autoRenew(Boolean autoRenew)` Specifies whether to enable auto-renewal for the instance.
`RunInstancesRequest.Builder`	`autoRenewPeriod(Integer autoRenewPeriod)` The auto-renewal period of the instance.
`RunInstancesRequest`	`build()`
`RunInstancesRequest.Builder`	`clientToken(String clientToken)` The client token that is used to ensure the idempotence of the request.
`RunInstancesRequest.Builder`	`cpuOptions(RunInstancesRequest.CpuOptions cpuOptions)` CpuOptions.
`RunInstancesRequest.Builder`	`creditSpecification(String creditSpecification)` The performance mode of the burstable instance.
`RunInstancesRequest.Builder`	`dataDisk(List<RunInstancesRequest.DataDisk> dataDisk)` The data disks.
`RunInstancesRequest.Builder`	`dedicatedHostId(String dedicatedHostId)` The ID of the dedicated host on which to create the instance.
`RunInstancesRequest.Builder`	`deletionProtection(Boolean deletionProtection)` Specifies whether to enable release protection for the instance.
`RunInstancesRequest.Builder`	`deploymentSetGroupNo(Integer deploymentSetGroupNo)` The number of the deployment set group to which to deploy the instance.
`RunInstancesRequest.Builder`	`deploymentSetId(String deploymentSetId)` The ID of the deployment set to which to deploy the instance.
`RunInstancesRequest.Builder`	`description(String description)` The description of the instance.
`RunInstancesRequest.Builder`	`dryRun(Boolean dryRun)` Specifies whether to check the validity of the request without actually making the request.
`RunInstancesRequest.Builder`	`hibernationOptions(RunInstancesRequest.HibernationOptions hibernationOptions)` HibernationOptions.
`RunInstancesRequest.Builder`	`hostName(String hostName)` The hostname of the instance.
`RunInstancesRequest.Builder`	`hostNames(List<String> hostNames)` The hostname of instance N.
`RunInstancesRequest.Builder`	`hpcClusterId(String hpcClusterId)` The ID of the high performance computing (HPC) cluster to which the instance belongs.
`RunInstancesRequest.Builder`	`httpEndpoint(String httpEndpoint)` Specifies whether to enable the access channel for instance metadata.
`RunInstancesRequest.Builder`	`httpPutResponseHopLimit(Integer httpPutResponseHopLimit)` The HTTP PUT response hop limit for accessing instance metadata.
`RunInstancesRequest.Builder`	`httpTokens(String httpTokens)` Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata.
`RunInstancesRequest.Builder`	`imageFamily(String imageFamily)` The name of the image family.
`RunInstancesRequest.Builder`	`imageId(String imageId)` The ID of the image.
`RunInstancesRequest.Builder`	`imageOptions(RunInstancesRequest.ImageOptions imageOptions)` Details about the image options.
`RunInstancesRequest.Builder`	`instanceChargeType(String instanceChargeType)` The billing method of the instance.
`RunInstancesRequest.Builder`	`instanceName(String instanceName)` The name of the instance.
`RunInstancesRequest.Builder`	`instanceType(String instanceType)` The instance type.
`RunInstancesRequest.Builder`	`internetChargeType(String internetChargeType)` The billing method for network usage.
`RunInstancesRequest.Builder`	`internetMaxBandwidthIn(Integer internetMaxBandwidthIn)` The maximum inbound public bandwidth.
`RunInstancesRequest.Builder`	`internetMaxBandwidthOut(Integer internetMaxBandwidthOut)` The maximum outbound public bandwidth.
`RunInstancesRequest.Builder`	`ioOptimized(String ioOptimized)` Specifies whether the instance is I/O optimized.
`RunInstancesRequest.Builder`	`ipv6Address(List<String> ipv6Address)` IPv6 address N to be assigned to the primary ENI.
`RunInstancesRequest.Builder`	`ipv6AddressCount(Integer ipv6AddressCount)` The number of IPv6 addresses to randomly generate for the primary ENI.
`RunInstancesRequest.Builder`	`isp(String isp)` > This parameter is in invitational preview and is unavailable.
`RunInstancesRequest.Builder`	`keyPairName(String keyPairName)` The name of the key pair.
`RunInstancesRequest.Builder`	`launchTemplateId(String launchTemplateId)` The ID of the launch template.
`RunInstancesRequest.Builder`	`launchTemplateName(String launchTemplateName)` The name of the launch template.
`RunInstancesRequest.Builder`	`launchTemplateVersion(Long launchTemplateVersion)` The version of the launch template.
`RunInstancesRequest.Builder`	`minAmount(Integer minAmount)` The minimum number of ECS instances that you want to create.
`RunInstancesRequest.Builder`	`networkInterface(List<RunInstancesRequest.NetworkInterface> networkInterface)` The information of the elastic network interfaces (ENIs).
`RunInstancesRequest.Builder`	`networkInterfaceQueueNumber(Integer networkInterfaceQueueNumber)` The number of queues supported by the primary ENI.
`RunInstancesRequest.Builder`	`networkOptions(RunInstancesRequest.NetworkOptions networkOptions)` Details about network options.
`RunInstancesRequest.Builder`	`ownerAccount(String ownerAccount)` OwnerAccount.
`RunInstancesRequest.Builder`	`ownerId(Long ownerId)` OwnerId.
`RunInstancesRequest.Builder`	`password(String password)` The password of the instance.
`RunInstancesRequest.Builder`	`passwordInherit(Boolean passwordInherit)` Specifies whether to use the password preset in the image.
`RunInstancesRequest.Builder`	`period(Integer period)` The subscription period of the instance.
`RunInstancesRequest.Builder`	`periodUnit(String periodUnit)` The unit of the subscription period.
`RunInstancesRequest.Builder`	`privateDnsNameOptions(RunInstancesRequest.PrivateDnsNameOptions privateDnsNameOptions)` > This parameter is in invitational preview and is not publicly available.
`RunInstancesRequest.Builder`	`privateIpAddress(String privateIpAddress)` The private IP address to assign to the instance.
`RunInstancesRequest.Builder`	`privatePoolOptions(RunInstancesRequest.PrivatePoolOptions privatePoolOptions)` PrivatePoolOptions.
`RunInstancesRequest.Builder`	`ramRoleName(String ramRoleName)` The name of the Resource Access Management (RAM) role.
`RunInstancesRequest.Builder`	`regionId(String regionId)` The ID of the region in which to create the instance.
`RunInstancesRequest.Builder`	`resourceGroupId(String resourceGroupId)` The ID of the resource group to which to assign the instance.
`RunInstancesRequest.Builder`	`resourceOwnerAccount(String resourceOwnerAccount)` ResourceOwnerAccount.
`RunInstancesRequest.Builder`	`resourceOwnerId(Long resourceOwnerId)` ResourceOwnerId.
`RunInstancesRequest.Builder`	`schedulerOptions(RunInstancesRequest.SchedulerOptions schedulerOptions)` SchedulerOptions.
`RunInstancesRequest.Builder`	`securityEnhancementStrategy(String securityEnhancementStrategy)` Specifies whether to enable security hardening.
`RunInstancesRequest.Builder`	`securityGroupId(String securityGroupId)` The ID of the security group to which you want to assign the instance.
`RunInstancesRequest.Builder`	`securityGroupIds(List<String> securityGroupIds)` The ID of security group N to which to assign the instance.
`RunInstancesRequest.Builder`	`securityOptions(RunInstancesRequest.SecurityOptions securityOptions)` SecurityOptions.
`RunInstancesRequest.Builder`	`sourceRegionId(String sourceRegionId)` SourceRegionId.
`RunInstancesRequest.Builder`	`spotDuration(Integer spotDuration)` The protection period of the preemptible instance.
`RunInstancesRequest.Builder`	`spotInterruptionBehavior(String spotInterruptionBehavior)` The interruption mode of the preemptible instance.
`RunInstancesRequest.Builder`	`spotPriceLimit(Float spotPriceLimit)` The maximum hourly price of the instance.
`RunInstancesRequest.Builder`	`spotStrategy(String spotStrategy)` The bidding policy for the pay-as-you-go instance.
`RunInstancesRequest.Builder`	`storageSetId(String storageSetId)` The ID of the storage set.
`RunInstancesRequest.Builder`	`storageSetPartitionNumber(Integer storageSetPartitionNumber)` The maximum number of partitions in the storage set.
`RunInstancesRequest.Builder`	`systemDisk(RunInstancesRequest.SystemDisk systemDisk)` SystemDisk.
`RunInstancesRequest.Builder`	`tag(List<RunInstancesRequest.Tag> tag)` The tags to add to the instance, disks, and primary ENI.
`RunInstancesRequest.Builder`	`tenancy(String tenancy)` Specifies whether to create the instance on a dedicated host.
`RunInstancesRequest.Builder`	`uniqueSuffix(Boolean uniqueSuffix)` Specifies whether to automatically append incremental suffixes to the hostname specified by the `HostName` parameter and to the instance name specified by the `InstanceName` parameter when you batch create instances.
`RunInstancesRequest.Builder`	`userData(String userData)` The user data of the instance.
`RunInstancesRequest.Builder`	`vSwitchId(String vSwitchId)` The ID of the vSwitch to which to connect to the instance.
`RunInstancesRequest.Builder`	`zoneId(String zoneId)` The ID of the zone in which to create the instance.

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

- 方法详细资料
  - cpuOptions
```
public RunInstancesRequest.Builder cpuOptions(RunInstancesRequest.CpuOptions cpuOptions)
```
    CpuOptions.
  - hibernationOptions
```
public RunInstancesRequest.Builder hibernationOptions(RunInstancesRequest.HibernationOptions hibernationOptions)
```
    HibernationOptions.
  - privatePoolOptions
```
public RunInstancesRequest.Builder privatePoolOptions(RunInstancesRequest.PrivatePoolOptions privatePoolOptions)
```
    PrivatePoolOptions.
  - schedulerOptions
```
public RunInstancesRequest.Builder schedulerOptions(RunInstancesRequest.SchedulerOptions schedulerOptions)
```
    SchedulerOptions.
  - securityOptions
```
public RunInstancesRequest.Builder securityOptions(RunInstancesRequest.SecurityOptions securityOptions)
```
    SecurityOptions.
  - systemDisk
```
public RunInstancesRequest.Builder systemDisk(RunInstancesRequest.SystemDisk systemDisk)
```
    SystemDisk.
  - sourceRegionId
```
public RunInstancesRequest.Builder sourceRegionId(String sourceRegionId)
```
    SourceRegionId.
  - affinity
```
public RunInstancesRequest.Builder affinity(String affinity)
```
    Specifies whether to associate an instance on a dedicated host with the dedicated host. Valid values:
    * default: does not associate the instance with the dedicated host. When you start an instance that was stopped in economical mode, the instance is automatically deployed to another dedicated host in the automatic deployment resource pool if the available resources of the original dedicated host are insufficient. * host: associates the instance with the dedicated host. When you start an instance that was stopped in economical mode, the instance remains on the original dedicated host. If the available resources of the original dedicated host are insufficient, the instance cannot be started. Default value: default.
  - amount
```
public RunInstancesRequest.Builder amount(Integer amount)
```
    The desired number of ECS instances that you want to create. Valid values: 1 to 100.
    The number of ECS instances that can be created varies based on the Amount and MinAmount values. * If you do not specify MinAmount, the RunInstances operation creates ECS instances based on the Amount value. If the available resources are insufficient to create the desired number of ECS instances, the RunInstances operation returns an error response and no ECS instances are created. * If you specify MinAmount, take note of the following items: * If the available resources are insufficient to create the minimum number of ECS instances, no ECS instances are created and the RunInstances operation returns an error response. * If the available resources are insufficient to create the desired number of ECS instances but are sufficient to create the minimum number of ECS instances, the RunInstances operation uses the available resources to create ECS instances and returns a success response. In this case, the number of ECS instances that can be created is less than the desired number of ECS instances. * If the available resources are sufficient to create the desired number of ECS instances, the RunInstances operation uses the available resources to create the desired number of ECS instances and returns a success response. Default value: 1.
  - arn
```
public RunInstancesRequest.Builder arn(List<RunInstancesRequest.Arn> arn)
```
    > This parameter is not publicly available.
  - autoPay
```
public RunInstancesRequest.Builder autoPay(Boolean autoPay)
```
    Specifies whether to automatically complete the payment for instance creation. Valid values:
    * true: The payment is automatically completed. ** **Note** Make sure that your account balance is sufficient. Otherwise, your order becomes invalid and is canceled. If your account balance is insufficient, you can set `AutoPay` to `false` to generate an unpaid order. Then, you can log on to the ECS console to pay for the order. * false: An order is generated but no payment is made. ** **Note** When `InstanceChargeType` is set to `PostPaid`, `AutoPay` cannot be set to `false`. Default value: true.
  - autoReleaseTime
```
public RunInstancesRequest.Builder autoReleaseTime(String autoReleaseTime)
```
    The time when to automatically release the pay-as-you-go instance. Specify the time in the [ISO 8601 standard](~~25696~~) in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in UTC.
    * If the value of seconds (`ss`) is not `00`, the start time is automatically rounded to the nearest minute based on the value of minutes (`mm`). * The specified time must be at least 30 minutes later than the current time. * The specified time can be at most three years later than the current time.
  - autoRenew
```
public RunInstancesRequest.Builder autoRenew(Boolean autoRenew)
```
    Specifies whether to enable auto-renewal for the instance. This parameter is valid only when the `InstanceChargeType` parameter is set to `PrePaid`. Valid values:
    * true: enables auto-renewal. * false: does not enable auto-renewal. Default value: false.
  - autoRenewPeriod
```
public RunInstancesRequest.Builder autoRenewPeriod(Integer autoRenewPeriod)
```
    The auto-renewal period of the instance. Valid values:
    * Valid values when PeriodUnit is set to Week: 1, 2, and 3. * Valid values when PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60. Default value: 1.
  - clientToken
```
public RunInstancesRequest.Builder clientToken(String clientToken)
```
    The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.**** For more information, see [How to ensure idempotence](~~25693~~).
  - creditSpecification
```
public RunInstancesRequest.Builder creditSpecification(String creditSpecification)
```
    The performance mode of the burstable instance. Valid values:
    * Standard: the standard mode. For more information, see the "Standard mode" section in [Overview of burstable instances](~~59977~~). * Unlimited: the unlimited mode. For more information, see the "Unlimited mode" section in [Burstable instances](~~59977~~).
  - dataDisk
```
public RunInstancesRequest.Builder dataDisk(List<RunInstancesRequest.DataDisk> dataDisk)
```
    The data disks.
  - dedicatedHostId
```
public RunInstancesRequest.Builder dedicatedHostId(String dedicatedHostId)
```
    The ID of the dedicated host on which to create the instance. Preemptible instances cannot be created on dedicated hosts. If you specify `DedicatedHostId`, `SpotStrategy` and `SpotPriceLimit` are ignored.
    You can call the [DescribeDedicatedHosts](~~134242~~) operation to query the list of dedicated host IDs.
  - deletionProtection
```
public RunInstancesRequest.Builder deletionProtection(Boolean deletionProtection)
```
    Specifies whether to enable release protection for the instance. This parameter determines whether you can use the ECS console or call the [DeleteInstance](~~25507~~) operation to release the instance. Valid values:
    * true: enables release protection for the instance. * false: disables release protection for the instance. Default value: false. > This parameter is applicable to only pay-as-you-go instances. It can protect instances against manual releases, but not against automatic releases.
  - deploymentSetGroupNo
```
public RunInstancesRequest.Builder deploymentSetGroupNo(Integer deploymentSetGroupNo)
```
    The number of the deployment set group to which to deploy the instance. If the deployment set specified by the DeploymentSetId parameter uses the high availability group strategy (AvailabilityGroup), you can use the DeploymentSetGroupNo parameter to specify a deployment set group in the deployment set. Valid values: 1 to 7.
  - deploymentSetId
```
public RunInstancesRequest.Builder deploymentSetId(String deploymentSetId)
```
    The ID of the deployment set to which to deploy the instance.
  - description
```
public RunInstancesRequest.Builder description(String description)
```
    The description of the instance. The description must be 2 to 256 characters in length, and cannot start with `http://` or `https://`.
  - dryRun
```
public RunInstancesRequest.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 required parameters are specified, the request format, service limits, and available ECS resources. If the check fails, the corresponding error code is returned. If the check succeeds, the `DryRunOperation` error code is returned. * false: The validity of the request is checked, and the request is made if the check succeeds.
  - hostName
```
public RunInstancesRequest.Builder hostName(String hostName)
```
    The hostname of the instance. Take note of the following items:
    * The hostname cannot start or end with a period (.) or hyphen (-). It cannot contain consecutive periods (.) or hyphens (-). * For Windows instances, the hostname must be 2 to 15 characters in length and cannot contain periods (.) or contain only digits. It can contain letters, digits, and hyphens (-). * For instances that run other operating systems such as Linux, take note of the following items: * The hostname must be 2 to 64 characters in length. You can use periods (.) to separate a hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-). * You can use the `${instance_id}` placeholder to pass instance IDs into the hostname specified by `HostName`. For example, if you set `HostName` to k8s-${instance_id} and the instance is assigned an ID of `i-123abc****`, the hostname of the instance is `k8s-i-123abc****`. When you create multiple instances, you can perform the following operations: * Batch configure sequential hostnames for the instances. For more information, see [Batch configure sequential names or hostnames for multiple instances](~~196048~~). * Use the `HostNames.N` parameter to configure different hostnames for instances. You cannot specify both the `HostName` and `HostNames.N` parameters.
  - hostNames
```
public RunInstancesRequest.Builder hostNames(List<String> hostNames)
```
    The hostname of instance N. You can use this parameter to specify different hostnames for multiple instances.
  - hpcClusterId
```
public RunInstancesRequest.Builder hpcClusterId(String hpcClusterId)
```
    The ID of the high performance computing (HPC) cluster to which the instance belongs.
    This parameter is required when you create instances of a Supper Computing Cluster (SCC) instance type. For information about how to create an HPC cluster, see [CreateHpcCluster](~~109138~~).
  - httpEndpoint
```
public RunInstancesRequest.Builder httpEndpoint(String httpEndpoint)
```
    Specifies whether to enable the access channel 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 RunInstancesRequest.Builder httpPutResponseHopLimit(Integer httpPutResponseHopLimit)
```
    The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64.
    Default value: 1.
  - httpTokens
```
public RunInstancesRequest.Builder httpTokens(String httpTokens)
```
    Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Valid values:
    * optional: does not forcefully use the security-enhanced mode (IMDSv2). * required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode. Default value: optional. > For more information about the modes of accessing instance metadata, see [Access mode of instance metadata](~~150575~~).
  - imageFamily
```
public RunInstancesRequest.Builder imageFamily(String imageFamily)
```
    The name of the image family. You can set this parameter to obtain the latest available custom image from the specified image family to create instances.
    The name must be 2 to 128 characters in length. The name cannot start with a digit, a special character, http://, or https://. The name can contain letters, digits, periods (.), underscores (\_), hyphens (-), and colons (:). Take note of the following items: * If you specify `ImageId`, you cannot specify ImageFamily. * If you do not specify `ImageId` but use `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template that has `ImageId` specified, you cannot specify ImageFamily. * If you do not specify `ImageId` but use `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template that does not have `ImageId` specified, you can specify ImageFamily. * If you do not specify `ImageId`, `LaunchTemplateId`, or `LaunchTemplateName`, you can specify ImageFamily. > For information about image families that are associated with Alibaba Cloud official images, see [Overview of public images](~~108393~~).
  - imageId
```
public RunInstancesRequest.Builder imageId(String imageId)
```
    The ID of the image. You can call the [DescribeImages](~~25534~~) operation to query available images. If you do not use `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template and do not set `ImageFamily` to obtain the latest available custom image from a specified image family, you must specify `ImageId`.
  - imageOptions
```
public RunInstancesRequest.Builder imageOptions(RunInstancesRequest.ImageOptions imageOptions)
```
    Details about the image options.
  - instanceChargeType
```
public RunInstancesRequest.Builder instanceChargeType(String instanceChargeType)
```
    The billing method of the instance. Valid values:
    * PrePaid: subscription * PostPaid: pay-as-you-go Default value: PostPaid. If you set this parameter to PrePaid, make sure that your account has sufficient balance or credit. Otherwise, an `InvalidPayMethod` error is returned.
  - instanceName
```
public RunInstancesRequest.Builder instanceName(String instanceName)
```
    The name of the instance. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (\_), periods (.), and hyphens (-). The default value of this parameter is the `InstanceId` value.
    When you batch create instances, you can batch configure sequential names for the instances. The sequential names can contain brackets (\[ ]) and commas (,). For more information, see [Batch configure sequential names or hostnames for multiple instances](~~196048~~).
  - instanceType
```
public RunInstancesRequest.Builder instanceType(String instanceType)
```
    The instance type. If you do not use `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template, you must set the `InstanceType` parameter.
    * Select an instance type. See [Instance families](~~25378~~) or call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of an instance type, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types. * Query available resources. Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
  - internetChargeType
```
public RunInstancesRequest.Builder internetChargeType(String internetChargeType)
```
    The billing method for network usage. Valid values:
    * PayByBandwidth: pay-by-bandwidth * PayByTraffic: pay-by-traffic Default value: PayByTraffic. > When the **pay-by-traffic** billing method for network usage is used, the maximum inbound and outbound bandwidths are used as the 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 instance, use the **pay-by-bandwidth** billing method for network usage.
  - internetMaxBandwidthIn
```
public RunInstancesRequest.Builder internetMaxBandwidthIn(Integer internetMaxBandwidthIn)
```
    The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:
    * When the purchased outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of InternetMaxBandwidthIn are 1 to 10, and the default value is 10. * When the purchased outbound public bandwidth is greater than 10 Mbit/s, the valid values of this parameter are 1 to the `InternetMaxBandwidthOut` value and the default value is the `InternetMaxBandwidthOut` value.
  - internetMaxBandwidthOut
```
public RunInstancesRequest.Builder internetMaxBandwidthOut(Integer internetMaxBandwidthOut)
```
    The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100.
    Default value: 0.
  - ioOptimized
```
public RunInstancesRequest.Builder ioOptimized(String ioOptimized)
```
    Specifies whether the instance is I/O optimized. For instances of [retired instance types](~~55263~~), the default value is none. For instances of other instance types, the default value is optimized. Valid values:
    * none: The instance is not I/O optimized. * optimized: The instance is I/O optimized.
  - ipv6Address
```
public RunInstancesRequest.Builder ipv6Address(List<String> ipv6Address)
```
    IPv6 address N to be assigned to the primary ENI. Valid values of N: 1 to 10.
    Example: `Ipv6Address.1=2001:db8:1234:1a00::***`. Take note of the following items: * If the `Ipv6Address.N` parameter is specified, you must set the `Amount` parameter to 1 and leave the `Ipv6AddressCount` parameter empty. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot set `Ipv6Addresses.N` or `Ipv6AddressCount` and must set `NetworkInterface.N.Ipv6Addresses.N` or `NetworkInterface.N.Ipv6AddressCount`.
  - ipv6AddressCount
```
public RunInstancesRequest.Builder ipv6AddressCount(Integer ipv6AddressCount)
```
    The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10.
    Take note of the following items: * You cannot specify both the `Ipv6Addresses.N` and `Ipv6AddressCount` parameters. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot specify `Ipv6Address.N` or `Ipv6AddressCount` but can specify `NetworkInterface.N.Ipv6Address.N` or `NetworkInterface.N.Ipv6AddressCount`.
  - isp
```
public RunInstancesRequest.Builder isp(String isp)
```
    > This parameter is in invitational preview and is unavailable.
  - keyPairName
```
public RunInstancesRequest.Builder keyPairName(String keyPairName)
```
    The name of the key pair.
    > For Windows instances, this parameter is ignored. This parameter is empty by default. The `Password` parameter takes effect even if the KeyPairName parameter is specified.
  - launchTemplateId
```
public RunInstancesRequest.Builder launchTemplateId(String launchTemplateId)
```
    The ID of the launch template. For more information, call the [DescribeLaunchTemplates](~~73759~~) operation.
    To use a launch template to create an instance, you must use the `LaunchTemplateId` or `LaunchTemplateName` parameter to specify the launch template.
  - launchTemplateName
```
public RunInstancesRequest.Builder launchTemplateName(String launchTemplateName)
```
    The name of the launch template.
    To use a launch template to create an instance, you must use the `LaunchTemplateId` or `LaunchTemplateName` parameter to specify the launch template.
  - launchTemplateVersion
```
public RunInstancesRequest.Builder launchTemplateVersion(Long launchTemplateVersion)
```
    The version of the launch template. If you set the `LaunchTemplateId` or `LaunchTemplateName` parameter but do not set the version number of the launch template, the default template version is used.
  - minAmount
```
public RunInstancesRequest.Builder minAmount(Integer minAmount)
```
    The minimum number of ECS instances that you want to create. Valid values: 1 to 100.
    The number of ECS instances that can be created varies based on the Amount and MinAmount values. * If you do not specify MinAmount, the RunInstances operation creates ECS instances based on the Amount value. If the available resources are insufficient to create the desired number of ECS instances, the RunInstances operation returns an error response and no ECS instances are created. * If you specify MinAmount, take note of the following items: * If the available resources are insufficient to create the minimum number of ECS instances, no ECS instances are created and the RunInstances operation returns an error response. * If the available resources are insufficient to create the desired number of ECS instances but are sufficient to create the minimum number of ECS instances, the RunInstances operation uses the available resources to create ECS instances and returns a success response. In this case, the number of ECS instances that can be created is less than the desired number of ECS instances. * If the available resources are sufficient to create the desired number of ECS instances, the RunInstances operation uses the available resources to create the desired number of ECS instances and returns a success response.
  - networkInterface
```
public RunInstancesRequest.Builder networkInterface(List<RunInstancesRequest.NetworkInterface> networkInterface)
```
    The information of the elastic network interfaces (ENIs).
  - networkInterfaceQueueNumber
```
public RunInstancesRequest.Builder networkInterfaceQueueNumber(Integer networkInterfaceQueueNumber)
```
    The number of queues supported by the primary ENI. Take note of the following items:
    * The value of this parameter cannot exceed the maximum number of queues per ENI allowed for the instance type. * The total number of queues for all ENIs on the instance cannot exceed the queue quota for the instance type. To query the maximum number of queues per ENI and the queue quota for an instance type, you can call the [DescribeInstanceTypes](~~25620~~) operation to query the `MaximumQueueNumberPerEni` and `TotalEniQueueQuantity` values. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot specify `NetworkInterfaceQueueNumber` but can specify `NetworkInterface.N.QueueNumber`.
  - networkOptions
```
public RunInstancesRequest.Builder networkOptions(RunInstancesRequest.NetworkOptions networkOptions)
```
    Details about network options.
  - ownerAccount
```
public RunInstancesRequest.Builder ownerAccount(String ownerAccount)
```
    OwnerAccount.
  - ownerId
```
public RunInstancesRequest.Builder ownerId(Long ownerId)
```
    OwnerId.
  - password
```
public RunInstancesRequest.Builder password(String password)
```
    The password of the instance. The password must be 8 to 30 characters in length and contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Special characters include:
    ()`~!@#$%^&*-_+=|{}[]:;\"<>,.?/ For Windows instances, the password cannot start with a forward slash (/). > If the `Password` parameter is specified, we recommend that you send requests over HTTPS to prevent password leaks.
  - passwordInherit
```
public RunInstancesRequest.Builder passwordInherit(Boolean passwordInherit)
```
    Specifies whether to use the password preset in the image. Valid values:
    * true: uses the preset password. * false: does not use the preset password. Default value: false. > If you set this parameter to true, make sure that you leave the Password parameter empty and the selected image has a preset password.
  - period
```
public RunInstancesRequest.Builder period(Integer period)
```
    The subscription period of the instance. The unit is specified by the `PeriodUnit` parameter. This parameter is valid and required only when `InstanceChargeType` is set to `PrePaid`. If the `DedicatedHostId` parameter is specified, the value of Period must not exceed the subscription period of the specified dedicated host. Valid values:
    * Valid values when PeriodUnit is set to Week: 1, 2, 3, and 4. * Valid values when PeriodUnit is set to Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, and 60.
  - periodUnit
```
public RunInstancesRequest.Builder periodUnit(String periodUnit)
```
    The unit of the subscription period. Default value: Month. Valid values:
    * Week * Month
  - privateDnsNameOptions
```
public RunInstancesRequest.Builder privateDnsNameOptions(RunInstancesRequest.PrivateDnsNameOptions privateDnsNameOptions)
```
    > This parameter is in invitational preview and is not publicly available.
  - privateIpAddress
```
public RunInstancesRequest.Builder privateIpAddress(String privateIpAddress)
```
    The private IP address to assign to the instance. To assign a private IP address to an instance that resides in a VPC, make sure that the IP address is an idle IP address within the CIDR block of the vSwitch specified by `VSwitchId`.
    Take note of the following items: * If `PrivateIpAddress` is specified, take note of the following items: * If `Amount` is set to 1, a single instance is created and the specified private IP address is assigned to the instance. * If `Amount` is set to a numeric value greater than 1, the specified number of instances are created and consecutive private IP addresses starting from the specified one are assigned to the instances. In this case, you cannot specify parameters that start with `NetworkInterface.N` to attach secondary ENIs to the instances. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot specify `PrivateIpAddress` but can specify `NetworkInterface.N.PrimaryIpAddress`. > The first IP address and last three IP addresses of each vSwitch CIDR block are reserved. You cannot specify the IP addresses. For example, if a vSwitch CIDR block is 192.168.1.0/24, the IP addresses 192.168.1.0, 192.168.1.253, 192.168.1.254, and 192.168.1.255 are reserved.
  - ramRoleName
```
public RunInstancesRequest.Builder ramRoleName(String ramRoleName)
```
    The name of the Resource Access Management (RAM) role. You can call the [ListRoles](~~28713~~) operation provided by RAM to query the instance RAM roles that you created.
  - regionId
```
public RunInstancesRequest.Builder regionId(String regionId)
```
    The ID of the region in which to create the instance. You can call the [DescribeRegions](~~25609~~) operation to query the most recent region list.
  - resourceGroupId
```
public RunInstancesRequest.Builder resourceGroupId(String resourceGroupId)
```
    The ID of the resource group to which to assign the instance.
  - resourceOwnerAccount
```
public RunInstancesRequest.Builder resourceOwnerAccount(String resourceOwnerAccount)
```
    ResourceOwnerAccount.
  - resourceOwnerId
```
public RunInstancesRequest.Builder resourceOwnerId(Long resourceOwnerId)
```
    ResourceOwnerId.
  - securityEnhancementStrategy
```
public RunInstancesRequest.Builder securityEnhancementStrategy(String securityEnhancementStrategy)
```
    Specifies whether to enable security hardening. Valid values:
    * Active: enables security hardening. This value is applicable only to public images. * Deactive: does not enable security hardening. This value is applicable to all images.
  - securityGroupId
```
public RunInstancesRequest.Builder securityGroupId(String securityGroupId)
```
    The ID of the security group to which you want to assign the instance. Instances in the same security group can communicate with each other. The maximum number of instances allowed in a security group varies based on the type of the security group. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota~~).
    > The network type of the new instance is the same as the network type of the security group specified by `SecurityGroupId`. For example, if the specified security group is of the VPC type, the new instance is also of the VPC type and you must specify `VSwitchId`. If you do not use `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template, you must specify a security group ID. Take note of the following items: * You can set `SecurityGroupId` to specify a single security group or set `SecurityGroupIds.N` to specify one or more security groups. However, you cannot specify both `SecurityGroupId` and `SecurityGroupIds.N` in the same request. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot specify `SecurityGroupId` or `SecurityGroupIds.N` but can specify `NetworkInterface.N.SecurityGroupId` or `NetworkInterface.N.SecurityGroupIds.N`.
  - securityGroupIds
```
public RunInstancesRequest.Builder securityGroupIds(List<String> securityGroupIds)
```
    The ID of security group N to which to assign the instance. The valid values of N vary based on the maximum number of security groups to which an instance can belong. For more information, see the [Security group limits](~~101348~~) section of the "Limits" topic.
    Take note of the following items: * You cannot specify both `SecurityGroupId` and `SecurityGroupIds.N` in the same request. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot specify `SecurityGroupId` or `SecurityGroupIds.N` but can specify `NetworkInterface.N.SecurityGroupId` or `NetworkInterface.N.SecurityGroupIds.N`.
  - spotDuration
```
public RunInstancesRequest.Builder spotDuration(Integer spotDuration)
```
    The protection period of the preemptible instance. Unit: hours. Default value: 1. Valid values:
    * 1: After a preemptible instance is created, Alibaba Cloud ensures that the instance is not automatically released within 1 hour. After the 1-hour protection period ends, the system compares the bid price with the market price and checks the resource inventory to determine whether to retain or release the instance. * 0: After a preemptible instance is created, Alibaba Cloud does not ensure that the instance runs for 1 hour. The system compares the bid price with the market price and checks the resource inventory to determine whether to retain or release the instance. Alibaba Cloud sends an ECS system event to notify you 5 minutes before the instance is released. Preemptible instances are billed by second. We recommend that you specify an appropriate protection period based on your business requirements.
  - spotInterruptionBehavior
```
public RunInstancesRequest.Builder spotInterruptionBehavior(String spotInterruptionBehavior)
```
    The interruption mode of the preemptible instance. Valid values:
    * Terminate: The instance is released. * Stop: The instance is stopped in economical mode. For information about the economical mode, see [Economical mode](~~63353~~). Default value: Terminate.
  - spotPriceLimit
```
public RunInstancesRequest.Builder spotPriceLimit(Float spotPriceLimit)
```
    The maximum hourly price of the instance. The value is accurate to three decimal places. This parameter is valid only when the `SpotStrategy` parameter is set to `SpotWithPriceLimit`.
  - spotStrategy
```
public RunInstancesRequest.Builder spotStrategy(String spotStrategy)
```
    The bidding policy for the pay-as-you-go instance. This parameter is valid only when the `InstanceChargeType` parameter is set to `PostPaid`. Valid values:
    * NoSpot: The instance is created as a pay-as-you-go instance. * SpotWithPriceLimit: The instance is created as a preemptible instance with a user-defined maximum hourly price. * SpotAsPriceGo: The instance is created as a preemptible instance for which the market price at the time of purchase is automatically used as the bid price. Default value: NoSpot.
  - storageSetId
```
public RunInstancesRequest.Builder storageSetId(String storageSetId)
```
    The ID of the storage set.
  - storageSetPartitionNumber
```
public RunInstancesRequest.Builder storageSetPartitionNumber(Integer storageSetPartitionNumber)
```
    The maximum number of partitions in the storage set. Valid values: greater than or equal to 2.
  - tag
```
public RunInstancesRequest.Builder tag(List<RunInstancesRequest.Tag> tag)
```
    The tags to add to the instance, disks, and primary ENI.
  - tenancy
```
public RunInstancesRequest.Builder tenancy(String tenancy)
```
    Specifies whether to create the instance on a dedicated host. Valid values:
    * default: creates the instance on a non-dedicated host. * host: creates the instance on a dedicated host. If you do not set the `DedicatedHostId` parameter, Alibaba Cloud selects a dedicated host for the instance. Default value: default.
  - uniqueSuffix
```
public RunInstancesRequest.Builder uniqueSuffix(Boolean uniqueSuffix)
```
    Specifies whether to automatically append incremental suffixes to the hostname specified by the `HostName` parameter and to the instance name specified by the `InstanceName` parameter when you batch create instances. The incremental suffixes can range from 001 to 999. Valid values:
    * true * false Default value: false. When the `HostName` or `InstanceName` value is set in the `name_prefix[begin_number,bits]` format without `name_suffix`, the `UniqueSuffix` parameter does not take effect. The names are sorted in the specified sequence. For more information, see [Batch configure sequential names or hostnames for multiple instances](~~196048~~).
  - userData
```
public RunInstancesRequest.Builder userData(String userData)
```
    The user data of the instance. You must specify Base64-encoded data. The instance user data cannot exceed 32 KB in size before Base64 encoding.
    For information about the limits, formats, and running frequencies of instance user data, see [Instance user data](~~49121~~). > To ensure security, we recommend that you do not use plaintext to pass in confidential information, such as passwords or private keys, as user data. If you need to pass in confidential information, we recommend that you encrypt and encode the information in Base64 and then decode and decrypt the information in the same manner in the instance.
  - vSwitchId
```
public RunInstancesRequest.Builder vSwitchId(String vSwitchId)
```
    The ID of the vSwitch to which to connect to the instance. You must set this parameter when you create an instance of the VPC type. The specified vSwitch and security group must belong to the same VPC. You can call the [DescribeVSwitches](~~35748~~) operation to query available vSwitches.
    Take note of the following items: * If you specify the `VSwitchId` parameter, the zone specified by the `ZoneId` parameter must be the zone where the specified vSwitch is located. You can also leave the `ZoneId` parameter empty. Then, the system selects the zone where the specified vSwitch resides. * If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot specify `VSwitchId` but can specify `NetworkInterface.N.VSwitchId`.
  - zoneId
```
public RunInstancesRequest.Builder zoneId(String zoneId)
```
    The ID of the zone in which to create the instance. You can call the [DescribeZones](~~25610~~) operation to query the most recent zone list.
    > If you specify the `VSwitchId` parameter, the zone specified by the `ZoneId` parameter must be the zone where the vSwitch is located. You can also leave the `ZoneId` parameter empty. Then, the system selects the zone where the specified vSwitch is located. This parameter is empty by default.
  - build
```
public RunInstancesRequest build()
```

类 RunInstancesRequest.Builder

方法概要

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

方法详细资料

cpuOptions

hibernationOptions

privatePoolOptions

schedulerOptions

securityOptions

systemDisk

sourceRegionId

affinity

amount

arn

autoPay

autoReleaseTime

autoRenew

autoRenewPeriod

clientToken

creditSpecification

dataDisk

dedicatedHostId

deletionProtection

deploymentSetGroupNo

deploymentSetId

description

dryRun

hostName

hostNames

hpcClusterId

httpEndpoint

httpPutResponseHopLimit

httpTokens

imageFamily

imageId

imageOptions

instanceChargeType

instanceName

instanceType

internetChargeType

internetMaxBandwidthIn

internetMaxBandwidthOut

ioOptimized

ipv6Address

ipv6AddressCount

isp

keyPairName

launchTemplateId

launchTemplateName

launchTemplateVersion

minAmount

networkInterface

networkInterfaceQueueNumber

networkOptions

ownerAccount

ownerId

password

passwordInherit

period

periodUnit

privateDnsNameOptions

privateIpAddress

ramRoleName

regionId

resourceGroupId

resourceOwnerAccount

resourceOwnerId

securityEnhancementStrategy

securityGroupId

securityGroupIds

spotDuration

spotInterruptionBehavior

spotPriceLimit

spotStrategy

storageSetId

storageSetPartitionNumber

tag

tenancy

uniqueSuffix

userData