UpdateTemplate - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

Descrição da operação

Ao atualizar um modelo, observe o seguinte:

Se você especificar TemplateBody ou TemplateURL, a versão do modelo será incrementada em 1 após uma atualização bem-sucedida. Por exemplo, a versão muda de v1 para v2.
Se nem TemplateBody nem TemplateURL forem especificados, a versão do modelo permanecerá inalterada.
Um modelo pode ter até 100 versões. Se o limite de versões for atingido, a atualização do modelo falhará e você precisará recriar o modelo.

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:UpdateTemplate

update

*template

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TemplateURL	string	Não	O local 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 Alibaba Cloud OSS (por exemplo, oss://ros/template/demo, oss://ros/template/demo?RegionId=cn-hangzhou), com um tamanho máximo de 524.288 bytes. Nota Se a região do OSS não for especificada, o valor padrão será a mesma região do parâmetro RegionId na solicitação. Você pode especificar apenas um entre TemplateBody ou TemplateURL. O comprimento máximo da URL é de 1.024 bytes.	oss://ros/template/demo
TemplateName	string	Não	O nome do modelo. O comprimento não deve exceder 255 caracteres (codificação utf-8) e deve começar com um número, letra ou caractere chinês. Pode incluir números, letras, caracteres chineses, hifens (-) e sublinhados (_).	MyTemplate
Description	string	Não	A descrição do modelo. O comprimento máximo é de 256 caracteres.	It is a demo.
TemplateBody	string	Não	A estrutura do corpo do modelo. O comprimento deve estar entre 1 e 524.288 bytes. Se o conteúdo for longo, recomenda-se usar HTTP POST + Body Param para passar o parâmetro no corpo da solicitação, a fim de evitar falha na solicitação devido a uma URL excessivamente longa. Nota Você deve especificar apenas um entre TemplateBody, TemplateURL, TemplateId ou TemplateScratchId.	{"ROSTemplateFormatVersion":"2015-09-01"}
TemplateId	string	Sim	O ID do modelo. Suporta modelos compartilhados e privados.	5ecd1e10-b0e9-4389-a565-e4c15efc****
ValidationOptions	array	Não	Opções de validação. Por padrão, nenhuma opção está ativada e a validação rigorosa é executada.
	string	Não	Opções de validação. Valores válidos: BasicValidation: Realiza apenas a validação estrutural básica no conteúdo do modelo.	BasicValidation
RotateStrategy	string	Não	Estratégia de rotação de versões do modelo. Valores válidos: None (padrão): Sem rotação. Ocorre um erro quando o limite de versões é atingido. DeleteOldestNonSharedVersionWhenLimitExceeded: Rotaciona e exclui versões de modelo não compartilhadas. Nota Se todas as versões do modelo forem compartilhadas, elas não poderão ser rotacionadas e excluídas. A versão mais recente atual não será rotacionada e excluída. Independentemente de a exclusão por rotação ser usada ou não, o número da versão do modelo não pode exceder v65000.	None
IsDraft	boolean	Não	Especifica se a versão Draft (rascunho) deve ser atualizada. Valores válidos: false (padrão): Se o conteúdo do modelo for fornecido, uma nova versão será criada e a versão Draft será limpa. Caso contrário, a versão mais recente atual será modificada. true: Modifica a versão Draft. A versão Draft só pode ser obtida por meio da API GetTemplate. A API ListTemplateVersions não a retornará. O parâmetro TemplateVersion em outras APIs não pode especificar Draft.	false

Para obter detalhes sobre os 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.	8C5D90E1-66B6-496C-9371-3807F8DA80A8
TemplateId	string	O ID do modelo.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	A versão do modelo afetada por esta operação.	v2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "8C5D90E1-66B6-496C-9371-3807F8DA80A8",
  "TemplateId": "5ecd1e10-b0e9-4389-a565-e4c15efc****",
  "TemplateVersion": "v2"
}

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.