ALIYUN::ECS::Invocation executa um comando do Cloud Assistant em instâncias do Elastic Compute Service (ECS).
Sintaxe
{
"Type": "ALIYUN::ECS::Invocation",
"Properties": {
"Frequency": String,
"CommandId": String,
"Parameters": Map,
"InstanceIds": List,
"Sync": Boolean,
"CommandName": String,
"WindowsPasswordName": String,
"Timeout": Integer,
"RepeatMode": String,
"ResourceGroupId": String,
"ContainerName": String,
"ContainerId": String,
"Launcher": String,
"Username": String,
"Tags": List
}
}Propriedades
Property | Type | Required | Editable | Description | Constraint |
Frequency | String | No | No | A agenda de execução do comando. Para informações sobre as estruturas de valor, consulte Cron expression. | Nenhuma. |
CommandId | String | No | Yes | O id do comando. | Nenhuma. |
InstanceIds | List | Yes | Yes | Os IDs das instâncias ECS nas quais o comando será executado. | Especifique até 20 IDs de instância. |
Parameters | Map | No | Yes | Os pares chave-valor dos parâmetros personalizados a serem passados ao comando quando o recurso de parâmetros personalizados está ativado. Exemplo: | Especifique até 10 parâmetros personalizados. Nenhuma chave em uma coleção Map pode ser uma string vazia; cada chave pode ter no máximo 64 caracteres. Cada valor em uma coleção Map pode ser uma string vazia. Após a codificação em Base64 dos parâmetros personalizados e do conteúdo original do comando, o tamanho total não pode ultrapassar 16 KB. O conjunto de nomes de parâmetros personalizados deve ser um subconjunto do conjunto de parâmetros definido ao criar o comando. Use strings vazias para representar os parâmetros não informados. |
Sync | Boolean | No | No | Define se o comando deve ser executado de forma síncrona. | Valores válidos:
|
Launcher | String | No | No | O launcher para a execução do script. | O valor pode ter no máximo 1 KB. |
CommandName | String | No | No | O nome do comando. | Nenhuma. |
WindowsPasswordName | String | No | No | O nome de usuário da senha utilizada para executar o comando em instâncias Windows. | O nome pode ter no máximo 255 caracteres. Para não usar o usuário padrão do sistema ao executar o comando em instâncias Windows, especifique as propriedades WindowsPasswordName e Nota Ao usar o usuário root em instâncias Linux ou o usuário System em instâncias Windows para executar o comando, não é necessário especificar a propriedade WindowsPasswordName. |
Timeout | Integer | No | Yes | O período de tempo limite para a execução do comando. Unidade: segundos. | Observe os seguintes pontos ao especificar esta propriedade:
|
RepeatMode | String | No | No | O modo de execução do comando. | Valores válidos:
Valores padrão:
Observe os seguintes pontos ao especificar esta propriedade:
|
ResourceGroupId | String | No | No | O id do grupo de recursos. | Observe os seguintes pontos ao especificar esta propriedade:
|
ContainerName | String | No | No | O nome do container. | Observe os seguintes pontos ao especificar esta propriedade:
|
ContainerId | String | No | No | O id do container. | Apenas strings hexadecimais de 64 bits são suportadas. IDs de container com os prefixos Observe os seguintes pontos ao especificar esta propriedade:
|
Username | String | No | No | O nome de usuário utilizado para executar o comando nas instâncias. | O nome de usuário pode ter no máximo 255 caracteres.
Também é possível especificar outros nomes de usuário já existentes nas instâncias para executar o comando. Por questões de segurança, recomenda-se executar os comandos do Cloud Assistant como um usuário comum. Para mais informações, consulte Run Cloud Assistant commands as a regular user. |
Tags | List | No | No | As tags. | Especifique até 20 tags no seguinte formato: Para mais informações, consulte Tags properties. |
Sintaxe de Tags
"Tags": [
{
"Value": String,
"Key": String
}
]Propriedades de Tags
|
Property |
Type |
Required |
Editable |
Description |
Constraint |
|
Key |
String |
Yes |
No |
A chave da tag. |
A chave da tag deve ter entre 1 e 128 caracteres e não pode conter |
|
Value |
String |
No |
No |
O valor da tag. |
O valor da tag pode ter no máximo 128 caracteres e não pode conter |
Valores de retorno
Fn::GetAtt
InvokeId: o id de invocação do comando.
InvokeInstances: as instâncias nas quais o comando foi executado.
InvokeResults: os resultados da execução do comando.
Para executar o comando apenas uma vez, consulte ALIYUN::ECS::RunCommand.
Exemplos
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
CommandId:
Type: String
Description: The id of command.
InstanceId:
Type: String
AssociationProperty: ALIYUN::ECS::Instance::InstanceId
Resources:
Invocation:
Type: ALIYUN::ECS::Invocation
Properties:
CommandId:
Ref: CommandId
InstanceIds:
- Ref: InstanceId
Outputs:
InvokeId:
Description: The id of command execution.
Value:
Fn::GetAtt:
- Invocation
- InvokeId {
"ROSTemplateFormatVersion": "2015-09-01",
"Parameters": {
"CommandId": {
"Type": "String",
"Description": "The id of command."
},
"InstanceId": {
"Type": "String",
"AssociationProperty": "ALIYUN::ECS::Instance::InstanceId"
}
},
"Resources": {
"Invocation": {
"Type": "ALIYUN::ECS::Invocation",
"Properties": {
"CommandId": {
"Ref": "CommandId"
},
"InstanceIds": [
{
"Ref": "InstanceId"
}
]
}
}
},
"Outputs": {
"InvokeId": {
"Description": "The id of command execution.",
"Value": {
"Fn::GetAtt": [
"Invocation",
"InvokeId"
]
}
}
}
}