ModifyInvocationAttributeRequest.Builder (alibabacloud-ecs20140526 5.0.19 API)

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

所有已实现的接口:

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

封闭类:

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

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`ModifyInvocationAttributeRequest`	`build()`
`ModifyInvocationAttributeRequest.Builder`	`commandContent(String commandContent)` The content of the command after modification.
`ModifyInvocationAttributeRequest.Builder`	`contentEncoding(String contentEncoding)` The encoding mode of the command content that is specified by `CommandContent`.
`ModifyInvocationAttributeRequest.Builder`	`enableParameter(Boolean enableParameter)` Specifies whether to include custom parameters in the command.
`ModifyInvocationAttributeRequest.Builder`	`frequency(String frequency)` The frequency at which to run the command.
`ModifyInvocationAttributeRequest.Builder`	`instanceId(List<String> instanceId)` The IDs of the ECS instances or managed instances that you want to add to the scheduled command task.
`ModifyInvocationAttributeRequest.Builder`	`invokeId(String invokeId)` The execution ID of the command.
`ModifyInvocationAttributeRequest.Builder`	`ownerAccount(String ownerAccount)` OwnerAccount.
`ModifyInvocationAttributeRequest.Builder`	`ownerId(Long ownerId)` OwnerId.
`ModifyInvocationAttributeRequest.Builder`	`parameters(Map<String,?> parameters)` The key-value pairs of the custom parameters that are passed in if custom parameters are included in the command.
`ModifyInvocationAttributeRequest.Builder`	`regionId(String regionId)` The region ID.
`ModifyInvocationAttributeRequest.Builder`	`resourceOwnerAccount(String resourceOwnerAccount)` ResourceOwnerAccount.
`ModifyInvocationAttributeRequest.Builder`	`resourceOwnerId(Long resourceOwnerId)` ResourceOwnerId.
`ModifyInvocationAttributeRequest.Builder`	`sourceRegionId(String sourceRegionId)` SourceRegionId.

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

- 方法详细资料
  - sourceRegionId
```
public ModifyInvocationAttributeRequest.Builder sourceRegionId(String sourceRegionId)
```
    SourceRegionId.
  - commandContent
```
public ModifyInvocationAttributeRequest.Builder commandContent(String commandContent)
```
    The content of the command after modification. The command content can be plaintext or Base64-encoded. Take note of the following items:
    * You can specify whether to retain the command after the command is run when you created the command. If you specified to retain the command, the Base64-encoded command content cannot exceed 18 KB in size. If you specified not to retain the command, the Base64-encoded command content cannot exceed 24 KB in size. * If the command content is Base64-encoded, set `ContentEncoding` to Base64. * If you set `EnableParameter` to true, the custom parameter feature is enabled and you can configure custom parameters based on the following rules: * You can define custom parameters in the `{{}}` format. Within `{{}}`, the spaces and line feeds before and after the parameter names are ignored. * The number of custom parameters cannot exceed 20. * A custom parameter name can contain letters, digits, underscores (\_), and hyphens (-). The name is case-insensitive. The ACS:: prefix cannot be used to specify non-built-in environment parameters. * Each custom parameter name cannot exceed 64 bytes in length. * You can specify built-in environment parameters as custom parameters. Then, when you run the command, these parameters are automatically specified by Cloud Assistant. You can specify the following built-in environment parameters: * `{{ACS::RegionId}}`: the region ID. * `{{ACS::AccountId}}`: the UID of the Alibaba Cloud account. * `{{ACS::InstanceId}}`: the instance ID. If you want to specify `{{ACS::InstanceId}}` as a built-in environment variable, make sure that the Cloud Assistant Agent version is not earlier than the following ones: * Linux: 2.2.3.309 * Windows: 2.1.3.309 * `{{ACS::InstanceName}}`: the instance name. When the command is run on multiple instances, if you want to specify `{{ACS::InstanceName}}` as a built-in environment variable, make sure that the Cloud Assistant Agent version is not earlier than the following ones: * Linux: 2.2.3.344 * Windows: 2.1.3.344 * `{{ACS::InvokeId}}`: the ID of the task. If you want to specify `{{ACS::InvokeId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following ones: * Linux: 2.2.3.309 * Windows: 2.1.3.309 * `{{ACS::CommandId}}`: the command ID. If you want to specify `{{ACS::CommandId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following ones: * Linux: 2.2.3.309 * Windows: 2.1.3.309
  - contentEncoding
```
public ModifyInvocationAttributeRequest.Builder contentEncoding(String contentEncoding)
```
    The encoding mode of the command content that is specified by `CommandContent`. Valid values (case-insensitive):
    * PlainText: The command content is not encoded. * Base64: The command content is encoded in Base64. Default value: PlainText. If the value is invalid, the PlainText mode is used.
  - enableParameter
```
public ModifyInvocationAttributeRequest.Builder enableParameter(Boolean enableParameter)
```
    Specifies whether to include custom parameters in the command.
    * If you want to enable the custom parameter feature, or configure `Parameters` to modify the custom parameters in the command, set EnableParameter to `true`. * If you do not want to configure `Parameters` to modify the custom parameters in the command, leave EnableParameter empty or set it to `false`.
  - frequency
```
public ModifyInvocationAttributeRequest.Builder frequency(String frequency)
```
    The frequency at which to run the command. This parameter takes effect only when `RepeatMode` is set to `Period`. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specific point in time, or run at designated points in time based on a cron expression.
    * To run the command at a fixed interval, use a rate expression to specify the interval. You can specify the interval in seconds, minutes, hours, or days. This option is suitable for scenarios in which tasks need to be executed at a fixed interval. Specify the interval in the following format: `rate( )`. For example, specify `rate(5m)` to run the command every 5 minutes. Take note of the following limits when you specify an interval: * The specified interval must be in the range of 60 seconds to 7 days and must be longer than the timeout period specified when you created the scheduled task. * The interval is the amount of time that elapses between two consecutive executions. The interval is irrelevant to the amount of time that is required to run the command once. For example, you set the interval to 5 minutes and the command requires 2 minutes to run once. Each time the command running is complete, the system waits 3 minutes instead of 5 minutes before the system runs the command again. * The point in time at which the command is run the next time is calculated based on the creation time of the task (the [CreationTime](~~64840~~) value returned by the `DescribeInvocations` operation) and the modified execution interval. * To run a command only once at a specific time, specify a point in time and a time zone. Specify the point in time in the `at(yyyy-MM-dd HH:mm:ss )` format, which indicates `at(Year-Month-Day Hours:Minutes:Seconds )`. If you do not specify a time zone, the Coordinated Universal Time (UTC) time zone is used by default. You can specify a time zone in the following forms: * The time zone name. Examples: `Asia/Shanghai` and `America/Los_Angeles`. * The time offset from GMT. Examples: `GMT+8:00` (UTC+8) and `GMT-7:00` (UTC-7). If you use the GMT format, you cannot add leading zeros to the hour value. * The time zone abbreviation. Only UTC is supported. For example, to configure a command to run only once at 13:15:30 on June 6, 2022 (Shanghai time), set the time to `at(2022-06-06 13:15:30 Asia/Shanghai)`. To configure a command to run only once at 13:15:30 on June 6, 2022 (UTC-7), set the time to `at(2022-06-06 13:15:30 GMT-7:00)`. * To run a command at designated points in time, use a cron expression to define the schedule. Specify a schedule in the ` ` format. The cron expression is in the ` ` format. The system calculates the execution times of the command based on the specified cron expression and time zone and runs the command as scheduled. If you do not specify a time zone, the system time zones of the instances on which you want to run the command are used by default. For information about cron expressions, see [Cron expressions](~~64769~~). You can specify the time zone in the following forms: * The time zone name. Examples: `Asia/Shanghai` and `America/Los_Angeles`. * The time offset from GMT. Examples: `GMT+8:00` (UTC+8) and `GMT-7:00` (UTC-7). If you use the GMT format, you cannot add leading zeros to the hour value. * The time zone abbreviation. Only UTC is supported. For example, to configure a command to run at 10:15:00 every day in 2022 (Shanghai time), set the schedule to `0 15 10 ? * * 2022 Asia/Shanghai`. To configure a command to run every half an hour from 10:00:00 to 11:30:00 every day in 2022 (UTC+8), set the schedule to `0 0/30 10-11 * * ? 2022 GMT+8:00`. To configure a command to run every 5 minutes from 14:00:00 to 14:55:00 every October every two years from 2022 in UTC, set the schedule to `0 0/5 14 * 10 ? 2022/2 UTC`. ** **Note** The minimum interval must be 10 seconds or longer and cannot be shorter than the timeout period of scheduled executions.
  - instanceId
```
public ModifyInvocationAttributeRequest.Builder instanceId(List<String> instanceId)
```
    The IDs of the ECS instances or managed instances that you want to add to the scheduled command task.
  - invokeId
```
public ModifyInvocationAttributeRequest.Builder invokeId(String invokeId)
```
    The execution ID of the command.
  - ownerAccount
```
public ModifyInvocationAttributeRequest.Builder ownerAccount(String ownerAccount)
```
    OwnerAccount.
  - ownerId
```
public ModifyInvocationAttributeRequest.Builder ownerId(Long ownerId)
```
    OwnerId.
  - parameters
```
public ModifyInvocationAttributeRequest.Builder parameters(Map<String,?> parameters)
```
    The key-value pairs of the custom parameters that are passed in if custom parameters are included in the command.
    You can specify 0 to 10 custom parameters. Take note of the following items: * The key of a custom parameter can be up to 64 characters in length and cannot be an empty string. * The value of a custom parameter can be an empty string. * If you specified to retain the command when you create the command task, the total size of the custom parameters and original command content that are encoded in Base64 cannot exceed 18 KB. If you specified not to retain the command when you create the command task, the total size of the custom parameters and original command content that are encoded in Base64 cannot exceed 24 KB. * The custom parameter names that are specified by Parameters must be included in the custom parameter names that you specified when you created the command. You can use empty strings to represent the parameters that are not passed in. This parameter is empty by default, which indicates not to modify the key-value pairs of the custom parameters.
  - regionId
```
public ModifyInvocationAttributeRequest.Builder regionId(String regionId)
```
    The region ID.
  - resourceOwnerAccount
```
public ModifyInvocationAttributeRequest.Builder resourceOwnerAccount(String resourceOwnerAccount)
```
    ResourceOwnerAccount.
  - resourceOwnerId
```
public ModifyInvocationAttributeRequest.Builder resourceOwnerId(Long resourceOwnerId)
```
    ResourceOwnerId.
  - build
```
public ModifyInvocationAttributeRequest build()
```

类 ModifyInvocationAttributeRequest.Builder

方法概要

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

方法详细资料

sourceRegionId

commandContent

contentEncoding

enableParameter

frequency

instanceId

invokeId

ownerAccount

ownerId

parameters

regionId

resourceOwnerAccount

resourceOwnerId

build