CreateTemplate - - Centro de documentación de Alibaba Cloud

Cree una plantilla.

Este tema proporciona un ejemplo sobre cómo crear una plantilla. En este ejemplo, se crea una plantilla llamada MyTemplate en la región China (Hangzhou). El parámetro TemplateBody se establece en {"ROSTemplateFormatVersion": "2015-09-01"}.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que invoque esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de muestra de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateTemplate	La operación que desea ejecutar. Establezca el valor en CreateTemplate.
TemplateURL	String	No	oss://ros/template/demo	La URL del archivo que contiene el cuerpo de la plantilla. La URL debe apuntar a una plantilla ubicada en un servidor web HTTP o HTTPS, o en un bucket de Alibaba Cloud Object Storage Service (OSS), como oss://ros/stack-policy/demo u oss://ros/stack-policy/demo?RegionId=cn-hangzhou. El cuerpo de la plantilla debe tener una longitud de 1 a 1,024 bytes. Si no especifica la región del bucket de OSS, se utiliza el valor del parámetro RegionId. Nota Debe especificar el parámetro TemplateBody o TemplateURL.
Description	String	No	It is a demo.	La descripción de la plantilla. La descripción puede tener hasta 256 caracteres.
TemplateBody	String	No	{"ROSTemplateFormatVersion":"2015-09-01"}	La estructura que contiene el cuerpo de la plantilla. El cuerpo de la plantilla debe tener una longitud de 1 a 524,288 bytes. Si la longitud del cuerpo de la plantilla supera el límite superior, le recomendamos agregar parámetros al cuerpo de la solicitud HTTP POST para evitar fallos en la solicitud causados por URL excesivamente largas. Nota Debe especificar el parámetro TemplateBody o TemplateURL. Puede crear una plantilla de Terraform según sus requisitos empresariales. A continuación, el código de muestra proporciona un ejemplo de cómo crear una plantilla de Terraform: `{ "ROSTemplateFormatVersion": "2015-09-01", "Transform": "Aliyun::Terraform-v1.0", "Workspace": { "main.tf": "variable \"name\" { default = \"auto_provisioning_group\"}" }, "Outputs": {} }` Para obtener más información sobre las plantillas de Terraform, consulte Estructura de las plantillas de Terraform.
TemplateName	String	Sí	MyTemplate	El nombre de la plantilla. El nombre puede tener hasta 255 caracteres y contener dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.
ResourceGroupId	String	No	rg-acfmxazb4ph6aiy****	El ID del resource group. Para obtener más información sobre los resource groups, consulte la sección "Resource Group" de ¿Qué es Resource Management?
Tags.N.Key	String	Sí	usage	La clave de la etiqueta N que desea agregar a la plantilla. Nota El parámetro Tags es opcional. Si especifica el parámetro Tags, debe especificar el parámetro Tags.N.Key.
Tags.N.Value	String	No	test	El valor de la etiqueta N que desea agregar a la plantilla.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	8C5D90E1-66B6-496C-9371-3807F8DA80A8	El ID de la solicitud.
TemplateId	String	5ecd1e10-b0e9-4389-a565-e4c15efc****	El ID de la plantilla.

Ejemplos

Solicitudes de muestra

http(s)://ros.aliyuncs.com/?Action=CreateTemplate
&TemplateName=MyTemplate
&TemplateBody={"ROSTemplateFormatVersion":"2015-09-01"}
&<Common request parameters>

Respuestas exitosas de muestra

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTemplateResponse>
        <RequestId>8C5D90E1-66B6-496C-9371-3807F8DA80A8</RequestId>
        <TemplateId>5ecd1e10-b0e9-4389-a565-e4c15efc****</TemplateId>
</CreateTemplateResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidSchema	{reason}.	Se devuelve este mensaje de error porque el formato de la plantilla no es válido. reason indica la causa del error.
400	InvalidTemplateAttribute	The Referenced Attribute ({resource} {name}) is incorrect.	Se devuelve este mensaje de error porque la plantilla contiene una referencia no válida a la propiedad del recurso en la sección Outputs. resource indica el nombre del recurso. name indica el nombre de la propiedad.
400	InvalidTemplatePropertyType	The specified value type of ({resource} {section}) is incorrect.	Se devuelve este mensaje de error porque el tipo de valor de la propiedad del recurso definido en una sección de la plantilla no es válido. resource indica el nombre del recurso. section indica el nombre de la sección.
400	InvalidTemplateReference	The specified reference "{name}" (in {referencer}) is incorrect.	Se devuelve este mensaje de error porque la plantilla contiene una referencia no válida. name indica el nombre de la referencia. referencer indica el nombre del referente.
400	InvalidTemplateSection	The template section is invalid: {section}.	Se devuelve este mensaje de error porque la plantilla contiene una sección no válida. section indica el nombre de la sección.
400	InvalidTemplateVersion	The template version is invalid: {reason}.	Se devuelve este mensaje de error porque la versión de la plantilla no es válida. reason indica la causa del error.