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

Cria um modelo personalizado.

Descrição da operação

Este tópico fornece um exemplo de como criar um modelo chamado MyTemplate na região China (Hangzhou) (cn-hangzhou). O parâmetro TemplateBody é definido como {"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:CreateTemplate

create

*Template

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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 Alibaba Cloud Object Storage Service (OSS), como oss://ros/stack-policy/demo ou oss://ros/stack-policy/demo?RegionId=cn-hangzhou. O corpo do modelo deve ter de 1 a 1.024 bytes de comprimento. Se você não especificar a região do bucket do OSS, o valor do parâmetro RegionId será usado. Nota Você deve especificar apenas um dos parâmetros `TemplateBody` e `TemplateURL`.	oss://ros/template/demo
Description	string	Não	A descrição do modelo. A descrição pode ter até 256 caracteres de comprimento.	It is a demo.
TemplateBody	string	Não	A estrutura do corpo do modelo. O corpo do modelo deve ter de 1 a 524.288 bytes de comprimento. Se o corpo do modelo for grande, especifique o parâmetro no corpo da solicitação para evitar falhas na solicitação causadas por uma URL excessivamente longa. Nota Você pode especificar apenas um dos parâmetros `TemplateBody`, `TemplateURL` e `TemplateId`.	{"ROSTemplateFormatVersion":"2015-09-01"}
TemplateName	string	Sim	O nome do modelo. O nome pode ter até 255 caracteres de comprimento. Deve começar com um dígito, letra ou caractere chinês. Pode conter dígitos, letras, caracteres chineses, hifens (-) e sublinhados (_).	MyTemplate
ResourceGroupId	string	Não	O ID do grupo de recursos. Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?.	rg-acfmxazb4ph6aiy****
Tags	array<object>	Não	As tags do modelo.
	object	Não	As tags do modelo.
Key	string	Sim	A chave da tag do modelo. Nota Tags é um parâmetro opcional. Se você especificar Tags, deverá especificar `Tags.N.Key`.	usage
Value	string	Não	O valor da tag do modelo.	test
ValidationOptions	array	Não	As opções de validação. Por padrão, nenhuma opção está ativada e a validação estrita é realizada.
	string	Não	A opção de validação. Valor válido: BasicValidation: realiza apenas a validação básica na estrutura do modelo.	BasicValidation

Para obter 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.	8C5D90E1-66B6-496C-9371-3807F8DA80A8
TemplateId	string	O ID do modelo.	5ecd1e10-b0e9-4389-a565-e4c15efc****

Exemplos

Resposta de sucesso

JSON formato

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

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.