ContinueCreateStack - - Centro de documentación de Alibaba Cloud

Continúa la creación de una pila cuya creación falló previamente.

Este tema proporciona un ejemplo sobre cómo continuar la creación de una pila que no se creó correctamente. En este ejemplo, la pila con ID 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** no se pudo crear en la región China (Hangzhou).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ContinueCreateStack	La operación que desea ejecutar. Establezca el valor en ContinueCreateStack.
StackId	String	Sí	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	El ID de la pila.
RegionId	String	Sí	cn-hangzhou	El ID de región de la pila. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
RamRoleName	String	No	test-role	El nombre del rol de RAM. Resource Orchestration Service (ROS) asume el rol de RAM para crear la pila y utiliza las credenciales del rol para llamar a las API de los servicios de Alibaba Cloud. ROS asume el rol de RAM para realizar operaciones en la pila. Si tiene permisos para operar en la pila pero no para usar el rol de RAM, ROS asume el rol de RAM de todos modos. Asegúrese de otorgar al rol de RAM únicamente los privilegios mínimos necesarios. Si no especifica este parámetro, ROS asume el rol de RAM existente asociado a la pila. Si no hay roles de RAM disponibles, ROS utiliza una credencial temporal generada a partir de las credenciales de su cuenta. El nombre del rol de RAM puede tener una longitud máxima de 64 bytes.
Mode	String	No	Recreate	El modo en que ROS continúa la creación de la pila. Valor predeterminado: Recreate. Valores válidos: Recreate Si establece este parámetro en Recreate, ROS continúa creando únicamente los siguientes tipos de recursos: Recursos cuya creación falló Recursos que especifique en el parámetro RecreatingResources.N Dependencias de los recursos que especifique en el parámetro RecreatingResources.N Recursos que aún no se han creado Nota Los parámetros RecreatingResources.N, TemplateBody y TemplateURL, así como la sección Parameters, solo surten efecto cuando el parámetro Mode se establece en Recreate. Ignore ROS ignora y descarta los recursos cuya creación falló y los que no se han creado, y marca la pila como creada correctamente. El cuerpo de la plantilla utilizada para crear la pila ha cambiado. Nota Este valor solo es válido para pilas de ROS.
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 entre 1 y 524,288 bytes. Si la longitud del cuerpo de la plantilla excede el límite superior, se recomienda agregar parámetros al cuerpo de la solicitud HTTP POST para evitar fallos en la solicitud causados por URL excesivamente largas. Una plantilla de ROS está sujeta a los siguientes límites: Solo puede modificar las siguientes secciones en la plantilla: Description, Metadata, Resources y Outputs. No puede agregar ni eliminar secciones de la plantilla. La sección Resources está sujeta a los siguientes límites: No puede eliminar recursos ni cambiar el cuerpo de la plantilla para los recursos cuya creación no desea continuar. Puede eliminar recursos o cambiar el cuerpo de la plantilla para los recursos cuya creación desea continuar. Puede agregar recursos a esta sección. Nota Este parámetro solo surte efecto cuando el parámetro Mode se establece en Recreate. Solo puede especificar uno de los siguientes parámetros: TemplateBody, TemplateURL y TemplateId. Si no especifica estos parámetros, se utiliza la plantilla existente.
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 Object Storage Service (OSS), como oss://ros/template/demo u oss://ros/template/demo?RegionId=cn-hangzhou. El cuerpo de la plantilla puede tener una longitud máxima de 524,288 bytes. Si no especifica el ID de región del bucket de OSS, se utiliza el valor del parámetro RegionId. Nota Este parámetro solo surte efecto cuando el parámetro Mode se establece en Recreate. Cuando especifica el parámetro TemplateURL en una plantilla, esta queda sujeta a los límites descritos para el parámetro TemplateBody en este tema. Solo puede especificar uno de los siguientes parámetros: TemplateBody, TemplateURL y TemplateId. Si no especifica estos parámetros, se utiliza la plantilla existente.
DryRun	Boolean	No	false	Especifica si solo se debe validar la pila en la solicitud. Valor predeterminado: false. Valores válidos: true: solo valida la pila. false: valida y continúa la creación de la pila.
TemplateId	String	No	5ecd1e10-b0e9-4389-a565-e4c15efc****	El ID de la plantilla. Este parámetro aplica tanto a plantillas compartidas como privadas. Nota Este parámetro surte efecto cuando el parámetro `Mode` se establece en `Recreate`. Cuando especifica el parámetro TemplateId en una plantilla, esta queda sujeta a los límites descritos para el parámetro `TemplateBody` en este tema. Solo puede especificar uno de los siguientes parámetros: `TemplateBody`, `TemplateURL` y `TemplateId`. Si no especifica estos parámetros, se utiliza la plantilla existente.
TemplateVersion	String	No	v1	La versión de la plantilla. Este parámetro solo surte efecto cuando se especifica el parámetro TemplateId.
RecreatingResources.N	String	No	WebServer	El recurso N que ROS continúa creando después de que fallara su creación inicial. Puede agregar nuevos recursos a la lista de recursos que ROS continuará creando. ROS también creará todas las dependencias de los nuevos recursos. Nota Este parámetro solo surte efecto para pilas de ROS.
Parameters.N.ParameterKey	String	Sí	Amount	El nombre del parámetro de plantilla N que desea utilizar para sobrescribir otro parámetro. Si no especifica el nombre y el valor de un parámetro de plantilla, ROS utiliza el nombre y el valor definidos en la operación anterior realizada para crear la pila. Valor máximo de N: 200. Nota Este parámetro solo surte efecto cuando el parámetro Mode se establece en Recreate.
Parameters.N.ParameterValue	String	Sí	12	El valor del parámetro de plantilla N que desea utilizar para sobrescribir otro parámetro. Valor máximo de N: 200. Para las pilas de ROS, se aplican los siguientes límites a los parámetros de plantilla utilizados para sobrescribir otros parámetros: No puede cambiar los valores de condición en la sección Conditions de una plantilla de true a false o de false a true. Los recursos que ROS continúa creando son los únicos que pueden hacer referencia a los parámetros de plantilla. Nota Este parámetro solo surte efecto cuando el parámetro Mode se establece en Recreate.
Parallelism	Long	No	1	El número máximo de operaciones simultáneas que se pueden ejecutar sobre los recursos. De forma predeterminada, este parámetro está vacío. Puede establecerlo en un número entero mayor o igual a 0. Nota Si establece este parámetro en un entero mayor que 0, se utiliza dicho valor. Si establece este parámetro en 0, no se impone ningún límite para las pilas de ROS. Sin embargo, para las pilas de Terraform se utiliza el valor predeterminado de Terraform, que generalmente es 10. Si deja este parámetro vacío, se utiliza el valor que especificó en la solicitud anterior. Si lo dejó vacío en la solicitud anterior, no se impone ningún límite para las pilas de ROS. No obstante, para las pilas de Terraform se utiliza el valor predeterminado de Terraform, que suele ser 10. Si establece este parámetro en un valor específico, ROS asocia dicho valor con la pila. Esto afectará las operaciones subsecuentes sobre la pila.
RecreatingOptions.N	String	No	CreateNewPrepaidInstance	La opción N que adopta ROS al continuar la creación de la pila. Este parámetro surte efecto cuando el parámetro `Mode` se establece en `Recreate`. Valores válidos: TryToFixSignalFailureByRerunEcsCommand: ROS intenta corregir las señales existentes de tipo FAILURE. Cuando falla la creación de recursos ALIYUN::ROS::WaitCondition, ROS utiliza los recursos asociados ALIYUN::ECS::RunCommand y ALIYUN::ECS::Invocation ya creados, junto con sus dependencias correspondientes, para recrear los recursos ALIYUN::ROS::WaitCondition. Nota Este valor solo es válido para pilas de ROS. IgnoreExistingSignalFailure: ROS ignora las señales existentes de tipo FAILURE. Si falla la creación de recursos ALIYUN::ROS::WaitCondition, estos se considerarán creados correctamente cuando ROS continúe la creación de la pila. Nota Este valor solo es válido para pilas de ROS. AutoRecreatingResources: ROS recrea automáticamente los recursos cuyo contenido de plantilla o parámetros referenciados hayan sido modificados, así como sus dependencias relevantes. Esta opción facilita la configuración del parámetro RecreatingResources.N; sin embargo, también podría provocar la recreación innecesaria de algunos recursos. Nota Este valor solo es válido para pilas de ROS. CreateNewPrepaidInstance: ROS crea una nueva instancia de suscripción si falla la creación de recursos de suscripción, o si utiliza ROS para recrear recursos de suscripción que ya se crearon correctamente. Nota Este valor solo es válido para pilas de ROS. Si ya existe una instancia de suscripción creada, ROS la conservará, ya que los recursos de suscripción no se pueden eliminar. Si no establece el parámetro RecreatingOptions.N en CreateNewPrepaidInstance, ROS intentará reutilizar una instancia existente. Si ROS reutiliza la instancia, no podrá modificar las propiedades del recurso, o solo podrá modificar un número reducido de ellas.

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	B288A0BE-D927-4888-B0F7-B35EF84B6E6	El ID de la solicitud.
StackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	El ID de la pila.
DryRunResult	Object		El resultado de la validación.
ParametersAllowedToBeModified	Array of String	description	Los parámetros que se pueden modificar. La modificación de estos parámetros no provoca un error de validación. Nota Este parámetro solo se devuelve si el parámetro DryRun se establece en `true`. El valor de ParametersAllowedToBeModified varía según los valores de los parámetros Mode, Template*, RecreatingResources.N y RecreatingOptions.N.
ParametersConditionallyAllowedToBeModified	Array of String	name	Los parámetros que se pueden modificar bajo condiciones específicas. Los nuevos valores de los parámetros determinan si la modificación provoca un error de validación. Nota Este parámetro solo se devuelve si el parámetro DryRun se establece en `true`. El valor de ParametersConditionallyAllowedToBeModified varía según los valores de los parámetros Mode, Template*, RecreatingResources.N y RecreatingOptions.N.
ParametersNotAllowedToBeModified	Array of String	cidr	Los parámetros que no se pueden modificar. La modificación de estos parámetros provoca un error de validación. Nota Este parámetro solo se devuelve si el parámetro DryRun se establece en `true`. El valor de ParametersNotAllowedToBeModified varía según los valores de los parámetros Mode, Template*, RecreatingResources.N y RecreatingOptions.N.

Ejemplos

Solicitudes de ejemplo

http(s)://ros.aliyuncs.com/?Action=ContinueCreateStack
&RegionId=cn-hangzhou
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<ContinueCreateStackResponse>
    <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6</RequestId>
    <StackId>4a6c9851-3b0f-4f5f-b4ca-a14bf691****</StackId>
</ContinueCreateStackResponse>

Formato JSON

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

{
  "RequestId" : "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId" : "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
}

Códigos de error

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	CircularDependency	Circular Dependency Found: {reason}.	Se devuelve este mensaje porque la plantilla contiene dependencias circulares. reason indica la causa del error.
400	InvalidSchema	{reason}.	Se devuelve este mensaje 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 porque la propiedad de recurso referenciada en la sección Outputs de la plantilla no es válida. 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 porque el tipo de valor de la propiedad de recurso definida 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 porque la plantilla contiene una referencia no válida. name indica el nombre de la referencia. referencer indica el nombre del elemento que hace la referencia.
400	InvalidTemplateSection	The template section is invalid: {section}.	Se devuelve este mensaje 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 porque la versión de la plantilla no es válida. reason indica la causa del error.
400	StackValidationFailed	{reason}.	Se devuelve este mensaje porque falló la validación de la pila. reason indica la causa del error.
400	UnknownUserParameter	The Parameter ({name}) was not defined in template.	Se devuelve este mensaje porque el parámetro especificado no está definido en la plantilla. name indica el nombre del parámetro.
400	UserParameterMissing	The Parameter {name} was not provided.	Se devuelve este mensaje porque no se proporcionó un valor para el parámetro definido en la plantilla. name indica el nombre del parámetro.
400	ContinueCreateStackValidationFailed	{reason}.	Se devuelve este mensaje porque falló la validación de la operación para continuar la creación de la pila. reason indica la causa del error.
404	ResourceNotFound	The Resource ({name}) could not be found in Stack {stack}.	Se devuelve este mensaje porque el recurso no existe en la pila. name indica el nombre del recurso. stack indica el nombre o ID de la pila.
404	StackNotFound	The Stack ({name}) could not be found.	Se devuelve este mensaje porque la pila no existe. name indica el nombre o ID de la pila.
409	ActionInProgress	Stack {name} already has an action ({action}) in progress.	Se devuelve este mensaje porque la pila se encuentra en proceso de modificación. name indica el nombre o ID de la pila. action indica la operación de cambio en curso.
404	TemplateNotFound	The Tempalte ({ ID }) could not be found.	Se devuelve este mensaje porque la plantilla no existe. ID indica el ID de la plantilla.
404	TemplateNotFound	The Template { ID } with version { version } could not be found.	Se devuelve este mensaje porque la plantilla o su versión no existen. ID indica el ID de la plantilla. version indica la versión de la plantilla.