Atualiza um grupo de pilhas existente.
Descrição da operação
Este tópico fornece um exemplo de como atualizar o modelo de um grupo de pilhas existente chamado MyStackGroup que usa o modo de permissões autogerenciadas na região da China (Hangzhou) para {"ROSTemplateFormatVersion": "2015-09-01"}.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ros:UpdateStackGroup |
update |
*StackGroup.
Template.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Sim |
O ID da região do grupo de pilhas. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. |
cn-hangzhou |
| StackGroupName |
string |
Sim |
O nome do grupo de pilhas. O nome deve ser exclusivo dentro de uma região. O nome pode ter até 255 caracteres e deve começar com um dígito ou uma letra. Pode conter dígitos, letras, hifens (-) e sublinhados (_). |
MyStackGroup |
| Description |
string |
Não |
A descrição do grupo de pilhas. A descrição deve ter de 1 a 256 caracteres. |
My Stack Group |
| AccountIds |
array |
Não |
A lista de IDs de contas de execução usadas para implantar pilhas no modo de permissões autogerenciadas. Você pode adicionar até 50 IDs de contas de execução. |
["12****"] |
|
string |
Não |
A lista de IDs de contas de execução usadas para implantar pilhas no modo de permissões autogerenciadas. Você pode adicionar até 50 IDs de contas de execução. |
["151266687691****","141261387191****"] |
|
| RegionIds |
array |
Não |
A lista de regiões de destino onde as pilhas são implantadas. Você pode adicionar até 20 regiões. |
["cn-hangzhou", "cn-beijing"] |
|
string |
Não |
A lista de regiões de destino onde as pilhas são implantadas. Você pode adicionar até 20 regiões. |
["cn-hangzhou","cn-beijing"] |
|
| TemplateBody |
string |
Não |
A estrutura do corpo do modelo. O corpo do modelo deve ter de 1 a 524.288 bytes. Se o corpo do modelo for grande, use o método HTTP POST e inclua o parâmetro no corpo da solicitação para evitar falhas de solicitação causadas por uma URL excessivamente longa. Nota
Você deve especificar apenas um dos seguintes parâmetros: TemplateBody, TemplateURL e TemplateId. |
{"ROSTemplateFormatVersion": "2015-09-01"} |
| TemplateURL |
string |
Não |
A URL do arquivo que contém o corpo do modelo. A URL deve apontar para um modelo localizado em um servidor web HTTP ou HTTPS ou em um bucket do Object Storage Service (OSS). O modelo deve ter de 1 a 524.288 bytes. Exemplo de URL de bucket do OSS: oss://ros/template/demo ou oss://ros/template/demo?RegionId=cn-hangzhou. Se a região do bucket do OSS não for especificada, a região do bucket do OSS será a mesma do valor do parâmetro RegionId. Nota
Você deve especificar apenas um dos seguintes parâmetros: TemplateBody, TemplateURL e TemplateId. |
oss://ros-template/demo |
| ClientToken |
string |
Não |
O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode ter até 64 caracteres e pode conter letras, dígitos, hifens (-) e sublinhados (_). Para mais informações, consulte Garantir idempotência. |
123e4567-e89b-12d3-a456-42665544**** |
| OperationDescription |
string |
Não |
A descrição da operação de atualização do grupo de pilhas. |
Update stack instances in hangzhou |
| OperationPreferences |
object |
Não |
As configurações de operação para atualizar o grupo de pilhas. Este parâmetro inclui os seguintes campos:
Separe vários parâmetros com vírgulas (,). Nota
|
{"FailureToleranceCount": 1,"MaxConcurrentCount": 2} |
| AdministrationRoleName |
string |
Não |
O nome da função de administrador do Resource Access Management (RAM) que é assumida pelo ROS quando você cria um grupo de pilhas com permissões autogerenciadas. Se você não especificar este parâmetro, AliyunROSStackGroupAdministrationRole será usado por padrão. O ROS assume essa função para, subsequentemente, assumir a função de execução (AliyunROSStackGroupExecutionRole) e gerenciar as pilhas que correspondem às instâncias de pilha no grupo de pilhas. O nome deve ter de 1 a 64 caracteres e pode conter letras, dígitos e hifens (-). |
AliyunROSStackGroupAdministrationRole |
| ExecutionRoleName |
string |
Não |
O nome da função de execução do RAM que é assumida pela função de administrador (AliyunROSStackGroupAdministrationRole) quando você cria um grupo de pilhas com permissões autogerenciadas. Se você não especificar este parâmetro, AliyunROSStackGroupExecutionRole será usado por padrão. O ROS assume essa função para gerenciar as pilhas que correspondem às instâncias de pilha no grupo de pilhas. O nome deve ter de 1 a 64 caracteres e pode conter letras, dígitos e hifens (-). |
AliyunROSStackGroupExecutionRole |
| TemplateId |
string |
Não |
O ID do modelo. Modelos compartilhados e modelos privados são suportados. Nota
Você deve especificar apenas um dos seguintes parâmetros: TemplateBody, TemplateURL e TemplateId. |
5ecd1e10-b0e9-4389-a565-e4c15efc**** |
| TemplateVersion |
string |
Não |
A versão do modelo. Se você não especificar este parâmetro, a versão mais recente será usada por padrão. Nota
TemplateVersion entra em vigor apenas quando TemplateId é especificado. |
v1 |
| Parameters |
array<object> |
Não |
A lista de parâmetros para o grupo de pilhas. |
|
|
object |
Não |
|||
| ParameterKey |
string |
Sim |
O nome do parâmetro. Se você não especificar o nome e o valor do parâmetro, o ROS usará o valor padrão especificado no modelo. Valor máximo de N: 200. Nota
O parâmetro Parameters é opcional. Se você especificar Parameters, Parameters.N.ParameterKey será obrigatório. |
Amount |
| ParameterValue |
string |
Sim |
O valor do parâmetro. Valor máximo de N: 200. Nota
O parâmetro Parameters é opcional. Se você especificar Parameters, Parameters.N.ParameterValue será obrigatório. |
1 |
| PermissionModel |
string |
Não |
O padrão de autorização. Valores válidos:
Nota
|
SELF_MANAGED |
| AutoDeployment |
object |
Não |
As configurações de implantação automática. Nota
Este parâmetro é obrigatório apenas quando PermissionModel está definido como SERVICE_MANAGED. |
{"Enabled": true, "RetainStacksOnAccountRemoval": true} |
| Enabled |
boolean |
Sim |
Especifica se a implantação automática deve ser ativada. Valores válidos:
|
true |
| RetainStacksOnAccountRemoval |
boolean |
Não |
Especifica se as pilhas nas contas de membro devem ser retidas quando as contas de membro forem removidas da pasta de destino. Valores válidos:
Nota
RetainStacksOnAccountRemoval é obrigatório quando Enabled está definido como true. |
true |
| DeploymentTargets |
object |
Não |
Os destinos de implantação para atualizar pilhas no modo de permissões gerenciadas pelo serviço. |
{"RdFolderIds": ["fd-4PvlVLOL8v"]} |
| RdFolderIds |
array |
Não |
A lista de IDs de pastas no diretório de recursos. |
|
|
string |
Não |
A lista de IDs de pastas no diretório de recursos. Você pode adicionar até 20 IDs de pastas. Você deve especificar pelo menos um dos parâmetros RdFolderIds e AccountIds com base nas seguintes regras:
Nota
Você pode visualizar os IDs das pastas na página Visão geral do console Resource Management. Para mais informações, consulte Visualizar as informações básicas de uma pasta. |
["fd-4PvlVLOL8v"] |
|
| AccountIds |
array |
Não |
A lista de IDs de contas de membro no diretório de recursos (pasta). Você pode adicionar até 30 IDs de contas de membro. Nota
Você pode visualizar os IDs das contas de membro na página Visão geral do console Resource Management. Para mais informações, consulte Visualizar os detalhes de uma conta de membro. |
|
|
string |
Não |
A lista de IDs de contas de membro no diretório de recursos (pasta). Você pode adicionar até 30 IDs de contas de membro. Nota
Você pode visualizar os IDs das contas de membro na página Visão geral do console Resource Management. Para mais informações, consulte Visualizar os detalhes de uma conta de membro. |
["151266687691****","141261387191****"] |
|
| Capabilities |
array |
Não |
A lista de opções para o grupo de pilhas. Comprimento máximo: 1. |
|
|
string |
Não |
As opções para o grupo de pilhas. Valor válido: ExpandModules, que expande módulos na conta atual. Nota
|
ExpandModules |
|
| DeploymentOptions |
array |
Não |
A lista de opções de implantação para atualizar o grupo de pilhas no modo de permissões gerenciadas pelo serviço. Você pode especificar até 1 opção de implantação. |
|
|
string |
Não |
Valores válidos:
|
Deploy |
Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
14A07460-EBE7-47CA-9757-12CC4761D47A |
| OperationId |
string |
O ID da operação. |
6da106ca-1784-4a6f-a7e1-e723863d**** |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
"OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****"
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.