All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.aliyun.sdk.service.ecs20140526.models.InvokeCommandRequest Maven / Gradle / Ivy

There is a newer version: 5.0.29
Show newest version
// This file is auto-generated, don't edit it. Thanks.
package com.aliyun.sdk.service.ecs20140526.models;

import darabonba.core.RequestModel;
import darabonba.core.TeaModel;
import com.aliyun.sdk.gateway.pop.models.*;

/**
 * {@link InvokeCommandRequest} extends {@link RequestModel}
 *
 * 

InvokeCommandRequest

*/ public class InvokeCommandRequest extends Request { @com.aliyun.core.annotation.Host @com.aliyun.core.annotation.NameInMap("SourceRegionId") private String sourceRegionId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ClientToken") private String clientToken; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("CommandId") @com.aliyun.core.annotation.Validation(required = true) private String commandId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ContainerId") private String containerId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ContainerName") private String containerName; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Frequency") private String frequency; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("InstanceId") private java.util.List < String > instanceId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Launcher") private String launcher; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("OwnerAccount") private String ownerAccount; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("OwnerId") private Long ownerId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Parameters") private java.util.Map < String, ? > parameters; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("RegionId") @com.aliyun.core.annotation.Validation(required = true) private String regionId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("RepeatMode") private String repeatMode; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ResourceGroupId") private String resourceGroupId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ResourceOwnerAccount") private String resourceOwnerAccount; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ResourceOwnerId") private Long resourceOwnerId; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("ResourceTag") private java.util.List < ResourceTag> resourceTag; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Tag") private java.util.List < Tag> tag; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("TerminationMode") private String terminationMode; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Timed") private Boolean timed; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Timeout") private Long timeout; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("Username") private String username; @com.aliyun.core.annotation.Query @com.aliyun.core.annotation.NameInMap("WindowsPasswordName") private String windowsPasswordName; private InvokeCommandRequest(Builder builder) { super(builder); this.sourceRegionId = builder.sourceRegionId; this.clientToken = builder.clientToken; this.commandId = builder.commandId; this.containerId = builder.containerId; this.containerName = builder.containerName; this.frequency = builder.frequency; this.instanceId = builder.instanceId; this.launcher = builder.launcher; this.ownerAccount = builder.ownerAccount; this.ownerId = builder.ownerId; this.parameters = builder.parameters; this.regionId = builder.regionId; this.repeatMode = builder.repeatMode; this.resourceGroupId = builder.resourceGroupId; this.resourceOwnerAccount = builder.resourceOwnerAccount; this.resourceOwnerId = builder.resourceOwnerId; this.resourceTag = builder.resourceTag; this.tag = builder.tag; this.terminationMode = builder.terminationMode; this.timed = builder.timed; this.timeout = builder.timeout; this.username = builder.username; this.windowsPasswordName = builder.windowsPasswordName; } public static Builder builder() { return new Builder(); } public static InvokeCommandRequest create() { return builder().build(); } @Override public Builder toBuilder() { return new Builder(this); } /** * @return sourceRegionId */ public String getSourceRegionId() { return this.sourceRegionId; } /** * @return clientToken */ public String getClientToken() { return this.clientToken; } /** * @return commandId */ public String getCommandId() { return this.commandId; } /** * @return containerId */ public String getContainerId() { return this.containerId; } /** * @return containerName */ public String getContainerName() { return this.containerName; } /** * @return frequency */ public String getFrequency() { return this.frequency; } /** * @return instanceId */ public java.util.List < String > getInstanceId() { return this.instanceId; } /** * @return launcher */ public String getLauncher() { return this.launcher; } /** * @return ownerAccount */ public String getOwnerAccount() { return this.ownerAccount; } /** * @return ownerId */ public Long getOwnerId() { return this.ownerId; } /** * @return parameters */ public java.util.Map < String, ? > getParameters() { return this.parameters; } /** * @return regionId */ public String getRegionId() { return this.regionId; } /** * @return repeatMode */ public String getRepeatMode() { return this.repeatMode; } /** * @return resourceGroupId */ public String getResourceGroupId() { return this.resourceGroupId; } /** * @return resourceOwnerAccount */ public String getResourceOwnerAccount() { return this.resourceOwnerAccount; } /** * @return resourceOwnerId */ public Long getResourceOwnerId() { return this.resourceOwnerId; } /** * @return resourceTag */ public java.util.List < ResourceTag> getResourceTag() { return this.resourceTag; } /** * @return tag */ public java.util.List < Tag> getTag() { return this.tag; } /** * @return terminationMode */ public String getTerminationMode() { return this.terminationMode; } /** * @return timed */ public Boolean getTimed() { return this.timed; } /** * @return timeout */ public Long getTimeout() { return this.timeout; } /** * @return username */ public String getUsername() { return this.username; } /** * @return windowsPasswordName */ public String getWindowsPasswordName() { return this.windowsPasswordName; } public static final class Builder extends Request.Builder { private String sourceRegionId; private String clientToken; private String commandId; private String containerId; private String containerName; private String frequency; private java.util.List < String > instanceId; private String launcher; private String ownerAccount; private Long ownerId; private java.util.Map < String, ? > parameters; private String regionId; private String repeatMode; private String resourceGroupId; private String resourceOwnerAccount; private Long resourceOwnerId; private java.util.List < ResourceTag> resourceTag; private java.util.List < Tag> tag; private String terminationMode; private Boolean timed; private Long timeout; private String username; private String windowsPasswordName; private Builder() { super(); } private Builder(InvokeCommandRequest request) { super(request); this.sourceRegionId = request.sourceRegionId; this.clientToken = request.clientToken; this.commandId = request.commandId; this.containerId = request.containerId; this.containerName = request.containerName; this.frequency = request.frequency; this.instanceId = request.instanceId; this.launcher = request.launcher; this.ownerAccount = request.ownerAccount; this.ownerId = request.ownerId; this.parameters = request.parameters; this.regionId = request.regionId; this.repeatMode = request.repeatMode; this.resourceGroupId = request.resourceGroupId; this.resourceOwnerAccount = request.resourceOwnerAccount; this.resourceOwnerId = request.resourceOwnerId; this.resourceTag = request.resourceTag; this.tag = request.tag; this.terminationMode = request.terminationMode; this.timed = request.timed; this.timeout = request.timeout; this.username = request.username; this.windowsPasswordName = request.windowsPasswordName; } /** * SourceRegionId. */ public Builder sourceRegionId(String sourceRegionId) { this.putHostParameter("SourceRegionId", sourceRegionId); this.sourceRegionId = sourceRegionId; return this; } /** * 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~~). */ public Builder clientToken(String clientToken) { this.putQueryParameter("ClientToken", clientToken); this.clientToken = clientToken; return this; } /** * The command ID. You can call the [DescribeCommands](~~64843~~) operation to query all available command IDs. *

* * > Common Cloud Assistant commands can be run based on their names. For more information, see [View and run common Cloud Assistant commands](~~429635~~). */ public Builder commandId(String commandId) { this.putQueryParameter("CommandId", commandId); this.commandId = commandId; return this; } /** * The ID of the container. Only 64-bit hexadecimal strings are supported. You can use container IDs that are prefixed with `docker://`, `containerd://`, or `cri-o://` to specify container runtimes. *

* * Take note of the following items: * * * If this parameter is specified, Cloud Assistant runs the command in the specified container of the instance. * * * If this parameter is specified, the command can run only on Linux instances on which Cloud Assistant Agent 2.2.3.344 or later is installed. * * * For information about how to query the version of Cloud Assistant Agent, see [Install Cloud Assistant Agent](~~64921~~). * * For information about how to upgrade Cloud Assistant Agent, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~). * * * If this parameter is specified, the `Username` parameter that is specified in a request to call this operation and the `WorkingDir` parameter that is specified in a request to call the [CreateCommand](~~64844~~) operation do not take effect. You can run the command only in the default working directory of the container by using the default user of the container. For more information, see [Use Cloud Assistant to run commands in containers](~~456641~~). * * * If this parameter is specified, only shell scripts can be run in Linux containers. You cannot add a command in the format similar to `#!/usr/bin/python` at the beginning of a script to specify a script interpreter. For more information, see [Use Cloud Assistant to run commands in containers](~~456641~~). */ public Builder containerId(String containerId) { this.putQueryParameter("ContainerId", containerId); this.containerId = containerId; return this; } /** * The name of the container. *

* * Take note of the following items: * * * If this parameter is specified, Cloud Assistant runs the command in the specified container of the instance. * * * If this parameter is specified, the command can run only on Linux instances on which Cloud Assistant Agent 2.2.3.344 or later is installed. * * * For information about how to query the version of Cloud Assistant Agent, see [Install Cloud Assistant Agent](~~64921~~). * * For information about how to upgrade Cloud Assistant Agent, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~). * * * If this parameter is specified, the `Username` parameter that is specified in a request to call this operation and the `WorkingDir` parameter that is specified in a request to call the [CreateCommand](~~64844~~) operation do not take effect. You can run the command only in the default working directory of the container by using the default user of the container. For more information, see [Use Cloud Assistant to run commands in containers](~~456641~~). * * * If this parameter is specified, only shell scripts can be run in Linux containers. You cannot add a command in the format similar to `#!/usr/bin/python` at the beginning of a script to specify a script interpreter. For more information, see [Use Cloud Assistant to run commands in containers](~~456641~~). */ public Builder containerName(String containerName) { this.putQueryParameter("ContainerName", containerName); this.containerName = containerName; return this; } /** * The schedule on which to run the command. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specific time, or run at specific times based on a cron expression. *

* * * To run a 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. When you specify an interval, take note of the following limits: * * * The interval can be anywhere from 60 seconds to 7 days, but must be longer than the timeout period of 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, assume that you set the interval to 5 minutes and that it takes 2 minutes to run the command each time. Each time the command is run, the system waits 3 minutes before the system runs the command again. * * A task is not immediately executed after the task is created. For example, assume that you set the interval to 5 minutes for a task. The task begins to be executed 5 minutes after it is created. * * * 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

* * You can apply for a quota increase in the Quota Center console. The quota name is Maximum number of instances supported for command execution. */ public Builder instanceId(java.util.List < String > instanceId) { this.putQueryParameter("InstanceId", instanceId); this.instanceId = instanceId; return this; } /** * Launcher. */ public Builder launcher(String launcher) { this.putQueryParameter("Launcher", launcher); this.launcher = launcher; return this; } /** * OwnerAccount. */ public Builder ownerAccount(String ownerAccount) { this.putQueryParameter("OwnerAccount", ownerAccount); this.ownerAccount = ownerAccount; return this; } /** * OwnerId. */ public Builder ownerId(Long ownerId) { this.putQueryParameter("OwnerId", ownerId); this.ownerId = ownerId; return this; } /** * The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10. *

* * * Keys in a Map collection can be up to 64 characters in length, and cannot be empty strings. * * Values in a Map collection can be empty strings. * * The size of the Base64-encoded custom parameters and original command content cannot exceed 18 KB. * * The custom parameter names specified in the value of Parameters must be included in the custom parameters specified when you created the command. You can use empty strings to represent the parameters that are not passed in. * * If you want to disable the custom parameter feature, you can leave this parameter empty. */ public Builder parameters(java.util.Map < String, ? > parameters) { String parametersShrink = shrink(parameters, "Parameters", "json"); this.putQueryParameter("Parameters", parametersShrink); this.parameters = parameters; return this; } /** * The region ID of the command. You can call the [DescribeRegions](~~25609~~) operation to query the most recent region list. */ public Builder regionId(String regionId) { this.putQueryParameter("RegionId", regionId); this.regionId = regionId; return this; } /** * The mode in which you want to run the command. Valid values: *

* * * Once: runs the command immediately. * * Period: runs the command based on a schedule. If you set this parameter to `Period`, you must also configure the `Frequency` parameter. * * NextRebootOnly: runs the command the next time the instance is started. * * EveryReboot: runs the command every time the instance is started. * * Default values: * * * If you do not specify `Frequency`, the default value is `Once`. * * If you specify `Frequency`, `Period` is used as the value of RepeatMode regardless of whether RepeatMode is set to Period. * * Take note of the following items: * * * You can call the [StopInvocation](~~64838~~) operation to stop the pending or scheduled executions of the command. * * If you set this parameter to `Period` or `EveryReboot`, you can call the [DescribeInvocationResults](~~64845~~) operation with `IncludeHistory` set to true to query the results of historical scheduled executions. */ public Builder repeatMode(String repeatMode) { this.putQueryParameter("RepeatMode", repeatMode); this.repeatMode = repeatMode; return this; } /** * The ID of the resource group to which to assign the command executions. When you set this parameter, take note of the following items: *

* * * The instances specified by InstanceId.N must belong to the specified resource group. * * After the command is run, you can call the [DescribeInvocations](~~64840~~) or [DescribeInvocationResults](~~64845~~) operation with ResourceGroupId set to query the execution results in the specified resource group. */ public Builder resourceGroupId(String resourceGroupId) { this.putQueryParameter("ResourceGroupId", resourceGroupId); this.resourceGroupId = resourceGroupId; return this; } /** * ResourceOwnerAccount. */ public Builder resourceOwnerAccount(String resourceOwnerAccount) { this.putQueryParameter("ResourceOwnerAccount", resourceOwnerAccount); this.resourceOwnerAccount = resourceOwnerAccount; return this; } /** * ResourceOwnerId. */ public Builder resourceOwnerId(Long resourceOwnerId) { this.putQueryParameter("ResourceOwnerId", resourceOwnerId); this.resourceOwnerId = resourceOwnerId; return this; } /** * The tags of the instance. If you do not specify InstanceId.N, the command is run on the instances that have the specified tags. */ public Builder resourceTag(java.util.List < ResourceTag> resourceTag) { this.putQueryParameter("ResourceTag", resourceTag); this.resourceTag = resourceTag; return this; } /** * Tag. */ public Builder tag(java.util.List < Tag> tag) { this.putQueryParameter("Tag", tag); this.tag = tag; return this; } /** * Specifies how to stop the command task when a command execution is manually stopped or times out. Valid values: *

* * * Process: stops the process of the command. * * ProcessTree: stops the process tree of the command. In this case, the process of the command and all subprocesses of the process are stopped. */ public Builder terminationMode(String terminationMode) { this.putQueryParameter("TerminationMode", terminationMode); this.terminationMode = terminationMode; return this; } /** * > This parameter is no longer used and does not take effect. */ public Builder timed(Boolean timed) { this.putQueryParameter("Timed", timed); this.timed = timed; return this; } /** * The timeout period for the command execution. Unit: seconds. *

* * * The timeout period cannot be less than 10 seconds. * * A timeout error occurs if the command cannot be run because the process slows down or because a specific module or Cloud Assistant Agent does not exist. When the specified timeout period ends, the command process is forcefully terminated. * * If you do not specify this parameter, the timeout period that is specified when the command is created is used. * * This timeout period is applicable only to this execution. The timeout period of the command is not modified. */ public Builder timeout(Long timeout) { this.putQueryParameter("Timeout", timeout); this.timeout = timeout; return this; } /** * The username to use to run the command on the ECS instances. The username cannot exceed 255 characters in length. *

* * * For Linux instances, the root username is used by default. * * For Windows instances, the System username is used by default. * * You can also specify other usernames that already exist in the instances to run the command. For security purposes, we recommend that you run Cloud Assistant commands as a regular user. For more information, see [Run Cloud Assistant commands as a regular user](~~203771~~). */ public Builder username(String username) { this.putQueryParameter("Username", username); this.username = username; return this; } /** * The name of the password to use to run the command on a Windows instance. The name cannot exceed 255 characters in length. *

* * If you do not want to use the default System user to run the command on Windows instances, specify both WindowsPasswordName and `Username`. To mitigate the risk of password leaks, the password is stored in plaintext in CloudOps Orchestration Service (OOS) Parameter Store, and only the name of the password is passed in by using WindowsPasswordName. For more information, see [Manage encryption parameters](~~186828~~) and [Run Cloud Assistant commands as a regular user](~~203771~~). * * > If you use the root username for Linux instances or the System username for Windows instances to run the command, you do not need to specify WindowsPasswordName. */ public Builder windowsPasswordName(String windowsPasswordName) { this.putQueryParameter("WindowsPasswordName", windowsPasswordName); this.windowsPasswordName = windowsPasswordName; return this; } @Override public InvokeCommandRequest build() { return new InvokeCommandRequest(this); } } public static class ResourceTag extends TeaModel { @com.aliyun.core.annotation.NameInMap("Key") private String key; @com.aliyun.core.annotation.NameInMap("Value") private String value; private ResourceTag(Builder builder) { this.key = builder.key; this.value = builder.value; } public static Builder builder() { return new Builder(); } public static ResourceTag create() { return builder().build(); } /** * @return key */ public String getKey() { return this.key; } /** * @return value */ public String getValue() { return this.value; } public static final class Builder { private String key; private String value; /** * The key of tag N of the instance. *

* * Take note of the following items: * * * This parameter and InstanceId.N are mutually exclusive. * * Valid values of N: 1 to 10. The tag key cannot be an empty string. * * The number of instances that have the specified tags cannot exceed 50. If more than 50 instances have the specified tags, we recommend that you use batch tags such as batch: b1 to group the instances into batches of up to 50 instances. * * The tag key can be up to 64 characters in length. It cannot start with aliyun or acs: and cannot contain http:// or https://. */ public Builder key(String key) { this.key = key; return this; } /** * The value of tag N of the instance. *

* * Take note of the following items: * * * Valid values of N: 1 to 10. * * The tag value can be an empty string. * * The tag value can be up to 128 characters in length and cannot contain http:// or https://. */ public Builder value(String value) { this.value = value; return this; } public ResourceTag build() { return new ResourceTag(this); } } } public static class Tag extends TeaModel { @com.aliyun.core.annotation.NameInMap("Key") private String key; @com.aliyun.core.annotation.NameInMap("Value") private String value; private Tag(Builder builder) { this.key = builder.key; this.value = builder.value; } public static Builder builder() { return new Builder(); } public static Tag create() { return builder().build(); } /** * @return key */ public String getKey() { return this.key; } /** * @return value */ public String getValue() { return this.value; } public static final class Builder { private String key; private String value; /** * The key of tag N to add to the command task. Valid values of N: 1 to 20. The tag key cannot be an empty string. *

* * If a single tag is specified to query resources, up to 1,000 resources that have this tag added can be displayed in the response. If multiple tags are specified to query resources, up to 1,000 resources that have all these tags added can be displayed in the response. To query more than 1,000 resources that have specified tags added, call the [ListTagResources](~~110425~~) operation. * * The tag key can be up to 64 characters in length and cannot start with `acs:` or `aliyun`. It cannot contain `http://` or `https://`. */ public Builder key(String key) { this.key = key; return this; } /** * The value of tag N to add to the command task. Valid values of N: 1 to 20. The tag value can be an empty string. *

* * The tag value can be up to 128 characters in length and cannot contain `http://` or `https://`. */ public Builder value(String value) { this.value = value; return this; } public Tag build() { return new Tag(this); } } } }





© 2015 - 2025 Weber Informatics LLC | Privacy Policy