Todos os produtos
Search
Central de documentação

Resource Orchestration Service:UpdateStackGroup

Última atualização: Oct 12, 2026

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

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ros:UpdateStackGroup

update

*StackGroup.

acs:ros:{#regionId}:{#accountId}:stackgroup/{#StackGroupName}

Template.

acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

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:

  • {"FailureToleranceCount": N}

    O número máximo de contas simultâneas nas quais falhas de pilha são toleradas em cada região. Se o número de pilhas com falha exceder esse valor, a operação na região será interrompida. Se a operação em uma região for interrompida, a operação não continuará em outras regiões.

    Valores válidos de N: 0 a 20.

    Valor padrão: 0.

  • {"FailureTolerancePercentage": N}

    A porcentagem máxima de contas simultâneas nas quais falhas de pilha são toleradas em cada região. Se a porcentagem de pilhas com falha exceder esse valor, a operação na região será interrompida.

    Valores válidos de N: 0 a 100. Se a porcentagem calculada não for um número inteiro, o Resource Orchestration Service (ROS) arredondará a porcentagem para baixo.

    Valor padrão: 0.

  • {"MaxConcurrentCount": N}

    O número máximo de contas simultâneas nas quais as pilhas podem ser implantadas ao mesmo tempo em cada região.

    Valores válidos de N: 1 a 20.

    Valor padrão: 1.

  • {"MaxConcurrentPercentage": N}

    A porcentagem máxima de contas simultâneas nas quais as pilhas podem ser implantadas ao mesmo tempo em cada região.

    Valores válidos de N: 1 a 100. Se a porcentagem calculada não for um número inteiro, o ROS arredondará a porcentagem para baixo.

    Valor padrão: 1.

  • {"RegionConcurrencyType": N}

    O tipo de simultaneidade no nível de região para implantar instâncias de pilha. Valores válidos:

    • SEQUENTIAL (padrão): implanta instâncias de pilha nas regiões especificadas uma a uma. Apenas uma região é implantada por vez.

    • PARALLEL: implanta instâncias de pilha em todas as regiões especificadas em paralelo.

Separe vários parâmetros com vírgulas (,).

Nota
  • Você não pode especificar MaxConcurrentCount e MaxConcurrentPercentage simultaneamente.

  • Você não pode especificar FailureToleranceCount e FailureTolerancePercentage simultaneamente.

{"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:

  • SELF_MANAGED (padrão): o padrão de permissões autogerenciadas. Se você usar este padrão, deverá criar manualmente funções do RAM na conta de administrador e nas contas de execução para estabelecer uma relação de confiança entre elas e, em seguida, realizar a implantação de pilhas nas contas de execução.

  • SERVICE_MANAGED: o padrão de permissões gerenciadas pelo serviço. Se você usar este padrão, o ROS realizará a criação automática de funções vinculadas ao serviço (associadas) para a conta de administrador e as contas de execução. A conta de administrador realiza a implantação de pilhas nas contas de execução usando as funções vinculadas ao serviço.

Nota
  • Se o grupo de pilhas já contiver instâncias de pilha, você não poderá alterar o padrão de autorização.

  • Ao usar o padrão de permissões gerenciadas pelo serviço para implantação de pilhas, a conta atual deve ser a conta de gerenciamento ou uma conta de administrador delegado de um diretório de recursos (pasta), e o acesso confiável deve estar ativado. Para mais informações, consulte Configurações para contas de administrador delegado e Ativar acesso confiável.

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: ativa a implantação automática. Após a ativação da implantação automática, se uma conta de membro for adicionada à pasta de destino, o grupo de pilhas implantará automaticamente uma instância de pilha na conta. Se uma conta de membro for removida da pasta de destino, o grupo de pilhas excluirá automaticamente a instância de pilha na conta.

  • false: desativa a implantação automática. Após a desativação da implantação automática, as instâncias de pilha não serão alteradas quando as contas de membro na pasta de destino forem alteradas.

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:

  • true: retém as pilhas.

  • false: exclui as pilhas.

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:

  • Se você especificar RdFolderIds, mas não especificar AccountIds, as pilhas serão implantadas em todas as contas de membro nas pastas especificadas. Se você selecionar a pasta Root, as pilhas serão implantadas em todas as contas de membro em todo o diretório de recursos.

  • Se você especificar AccountIds, mas não especificar RdFolderIds, as pilhas serão implantadas nas contas de membro especificadas.

  • Se você especificar ambos os parâmetros, as contas especificadas por AccountIds devem pertencer às pastas especificadas por RdFolderIds, e as pilhas serão implantadas nas contas de membro especificadas.

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
  • Esta opção entra em vigor apenas quando módulos são usados no modelo.

  • Por padrão, os módulos não são expandidos na conta atual, e os módulos relevantes devem existir em todas as contas de implantação de destino. Se os módulos forem expandidos na conta atual, os módulos relevantes devem existir na conta atual.

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: atualiza as instâncias existentes nas contas do diretório de recursos especificadas.

  • Configure: modifica o diretório de recursos de implantação de destino sem atualizar as instâncias existentes.

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.