CreateStackInstances - - Centro de documentación de Alibaba Cloud

Crea pilas para las cuentas especificadas en las regiones especificadas.

Antes de llamar a esta operación, asegúrese de haber creado un grupo de pilas. Para obtener más información, consulte CreateStackGroup.

Este tema proporciona un ejemplo sobre cómo crear pilas en un grupo de pilas. En este ejemplo, las pilas se crean en un grupo de pilas llamado MyStackGroup. Las pilas se crean dentro de las cuentas de Alibaba Cloud 151266687691**** y 141261387191****, en las regiones China (Hangzhou) y China (Beijing). Al grupo de pilas se le otorgan permisos autogestionados y se crea en la región China (Hangzhou).

Depuración

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateStackInstances	La operación que desea ejecutar. Establezca el valor en CreateStackInstances.
RegionId	String	Sí	cn-hangzhou	El ID de la región a la que pertenece el grupo de pilas. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
StackGroupName	String	Sí	MyStackGroup	El nombre del grupo de pilas. El nombre debe ser único dentro de una región. El nombre puede tener hasta 255 caracteres e incluir dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.
AccountIds	Array of String	No	["151266687691**", "141261387191**"]	Los ID de las cuentas donde desea usar el modelo de permisos autogestionados para desplegar pilas. Es posible especificar hasta 20 ID de cuenta. Nota Especifique únicamente uno de los parámetros `AccountIds` o `DeploymentTargets`.
RegionIds	Array of String	Sí	["cn-hangzhou","cn-beijing"]	Los ID de las regiones donde desea crear las pilas. Se pueden especificar hasta 20 ID de región.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Utilice el cliente para generar el valor, pero asegúrese de que sea único entre distintas solicitudes. El token puede tener hasta 64 caracteres e incluir letras, dígitos, guiones (-) y guiones bajos (_). Para obtener más información, consulte Garantizar la idempotencia.
OperationDescription	String	No	Create stack instances in hangzhou and beijing	La descripción de la operación de creación de pilas. La descripción debe tener entre 1 y 256 caracteres.
OperationPreferences	Map	No	{"FailureToleranceCount": 1, "MaxConcurrentCount": 2}	Las preferencias personalizadas sobre cómo Resource Orchestration Service (ROS) crea las pilas. Incluye a continuación parámetros: {"FailureToleranceCount": N} El número de cuentas donde pueden producirse errores en la operación de pila por cada región. Si se supera este valor en una región, ROS detiene la operación en dicha región. Cuando la operación se detiene en una región, ya no se ejecuta en las demás. Valores válidos de N: de 0 a 20. Si no especifica el parámetro FailureToleranceCount, se utiliza el valor predeterminado 0. {"FailureTolerancePercentage": N} El porcentaje de cuentas donde pueden producirse errores en la operación de pila respecto al total de cuentas de cada región. Si se supera este valor en una región, ROS detiene la operación en dicha región. Valores válidos de N: de 0 a 100. Si el valor numérico del porcentaje no es un entero, ROS lo redondea hacia abajo al entero más cercano. Si no especifica el parámetro FailureTolerancePercentage, se utiliza el valor predeterminado 0. {"MaxConcurrentCount": N} El número máximo de cuentas donde se despliegan pilas de forma simultánea en cada región. Valores válidos de N: de 1 a 20. Si no especifica el parámetro MaxConcurrentCount, se utiliza el valor predeterminado 1. {"MaxConcurrentPercentage": N} El porcentaje que representa el número máximo de cuentas donde se despliegan pilas de forma simultánea respecto al total de cuentas de cada región. Valores válidos: de 1 a 100. Si el valor numérico del porcentaje no es un entero, ROS lo redondea hacia abajo al entero más cercano. Si no especifica el parámetro MaxConcurrentPercentage, se utiliza el valor predeterminado 1. {"RegionConcurrencyType": N} El modo que desea utilizar para desplegar pilas en varias regiones. Valor predeterminado: SEQUENTIAL. Valores válidos: SEQUENTIAL: despliega las pilas en cada región especificada según el orden definido. ROS despliega las pilas de una región a la vez. PARALLEL: despliega las pilas en paralelo en todas las regiones especificadas. Separe varios parámetros con comas (,). Nota Especifique el parámetro MaxConcurrentCount o MaxConcurrentPercentage. Especifique el parámetro FailureToleranceCount o FailureTolerancePercentage.
TimeoutInMinutes	Long	No	10	El tiempo de espera permitido para crear la pila. Valor predeterminado: 60. Unidad: minutos.
DisableRollback	Boolean	No	false	Indica si se deshabilita la reversión cuando falla la creación de las pilas. Valor predeterminado: false. Valores válidos: true false
ParameterOverrides.N.ParameterKey	String	Sí	Amount	El nombre del parámetro N que desea usar para sobrescribir un parámetro específico. Si no especifica el nombre del parámetro N, ROS utiliza el nombre que definió al crear el grupo de pilas. Valor máximo de N: 200. Nota El parámetro ParameterOverrides es opcional. Si especifica el parámetro ParameterOverrides, debe especificar los parámetros ParameterOverrides.N.ParameterKey y ParameterOverrides.N.ParameterValue.
ParameterOverrides.N.ParameterValue	String	Sí	1	El valor del parámetro N que desea usar para sobrescribir un parámetro específico. Si no especifica el nombre ni el valor del parámetro N, ROS utiliza los valores definidos al crear el grupo de pilas. Valor máximo de N: 200. Nota El parámetro ParameterOverrides es opcional. Si especifica el parámetro ParameterOverrides, debe especificar los parámetros ParameterOverrides.N.ParameterKey y ParameterOverrides.N.ParameterValue.
DeploymentTargets	Object	No		Las carpetas donde desea usar el modelo de permisos gestionados por el servicio para desplegar pilas. Nota Especifique únicamente uno de los parámetros `AccountIds` o `DeploymentTargets`.
RdFolderIds	Array of String	Sí	["fd-4PvlVLOL8v"]	Los ID de las carpetas en el directorio de recursos. Puede agregar hasta cinco ID de carpeta. Es posible crear pilas en todos los miembros de las carpetas especificadas. Si crea pilas en la carpeta Root, estas se generan para todos los miembros del directorio de recursos. Nota Para consultar los ID de las carpetas, vaya a la página Descripción general en la consola de Resource Management. Para obtener más información, consulte Consultar la información básica de una carpeta.

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	14A07460-EBE7-47CA-9757-12CC4761D47A	El ID de la solicitud.
OperationId	String	6da106ca-1784-4a6f-a7e1-e723863d****	El ID de la operación.

Ejemplos

Solicitudes de ejemplo

http(s)://ros.aliyuncs.com/?Action=CreateStackInstances
&AccountIds=["151266687691****","141261387191****"]
&RegionId=cn-hangzhou
&RegionIds=["cn-hangzhou","cn-beijing"]
&StackGroupName=MyStackGroup
&<Common request parameters>

Respuestas de ejemplo exitosas

Formato XML

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

<CreateStackInstancesResponse>
        <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
        <OperationId>6da106ca-1784-4a6f-a7e1-e723863d****</OperationId>
</CreateStackInstancesResponse>

Formato JSON

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

{
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "OperationId" : "6da106ca-1784-4a6f-a7e1-e723863d****"
}

Códigos de error

Para consultar la lista de códigos de error, visite Códigos de error del servicio.

Código de error	Mensaje de error	Código de estado HTTP	Descripción
StackInstanceExists	The StackInstance ({instance}) already exists.	409	Este mensaje de error se devuelve porque la pila ya existe en la cuenta y la región especificadas. instance indica el nombre de la pila.
StackGroupOperationInProgress	Another Operation on StackGroup ({name}) is in progress.	409	Este mensaje de error se devuelve porque hay otra operación en curso en el grupo de pilas. name indica el nombre del grupo de pilas.