DeleteStackInstances - - Centro de documentación de Alibaba Cloud

Elimina pilas de cuentas específicas en regiones determinadas.

Este tema proporciona un ejemplo sobre cómo eliminar pilas de un grupo de pilas. En este ejemplo, las pilas desplegadas en la cuenta de Alibaba Cloud 151266687691**** dentro de la región China (Beijing) se eliminan de un grupo de pilas llamado MyStackGroup. El grupo de pilas está desplegado en la región China (Hangzhou) y tiene permisos autogestionados.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute 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í	DeleteStackInstances	La operación que desea ejecutar. Establezca el valor en DeleteStackInstances.
RegionId	String	Sí	cn-hangzhou	El ID de la región a la que pertenece el grupo de pilas. Puede llamar 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 de longitud y contener 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 se utiliza el modelo de permisos autogestionados para desplegar pilas. Puede especificar hasta 20 ID de cuenta.
RegionIds	Array of String	Sí	["cn-hangzhou","cn-beijing"]	Los ID de las regiones de las cuales desea eliminar las pilas. Puede especificar hasta 20 ID de región.
RetainStacks	Boolean	Sí	false	Especifica si se conservan las pilas. Valores válidos: true: conserva las pilas. false: elimina las pilas.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre diferentes solicitudes. El token puede tener hasta 64 caracteres de longitud y contener letras, dígitos, guiones (-) y guiones bajos (_). Para obtener más información, consulte Garantizar la idempotencia.
OperationDescription	String	No	Delete stack instances in hangzhou and beijing	La descripción de la operación para eliminar las pilas. La descripción debe tener entre 1 y 256 caracteres de longitud.
OperationPreferences	Map	No	{"FailureToleranceCount": 1, "MaxConcurrentCount": 2}	La configuración que establece para eliminar las pilas. Se incluyen los siguientes parámetros: {"FailureToleranceCount": N} El número de cuentas en las que pueden ocurrir fallos en la operación de pila dentro de cada región. Si se supera el valor de este parámetro en una región, Resource Orchestration Service (ROS) detiene la operación en dicha región. Si la operación se detiene en una región, deja de ejecutarse en las demás regiones. Valores válidos de N: 0 a 20. Si no especifica el parámetro FailureToleranceCount, se utiliza el valor predeterminado 0. {"FailureTolerancePercentage": N} El porcentaje de cuentas en las que pueden ocurrir fallos en la operación de pila respecto al total de cuentas en cada región. Si se supera el valor de este parámetro en una región, ROS detiene la operación en dicha región. Valores válidos de N: 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 en las que se despliegan pilas simultáneamente dentro de cada región. Valores válidos de N: 1 a 20. Si no especifica el parámetro MaxConcurrentCount, se utiliza el valor predeterminado 1. {"MaxConcurrentPercentage": N} El porcentaje del número máximo de cuentas en las que se despliegan pilas simultáneamente respecto al total de cuentas en cada región. Valores válidos de N: 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 pilas en cada región especificada siguiendo la secuencia de regiones indicada. ROS despliega pilas en una región a la vez. PARALLEL: despliega pilas en paralelo en todas las regiones especificadas. Separe varios parámetros con comas (,). Nota Solo puede especificar uno de los parámetros MaxConcurrentCount y MaxConcurrentPercentage. Solo puede especificar uno de los parámetros FailureToleranceCount y FailureTolerancePercentage.
DeploymentTargets	Object	No		Las carpetas en las que se utiliza el modelo de permisos gestionados por el servicio para desplegar pilas.
RdFolderIds	Array of String	Sí	["fd-4PvlVLOL8v"]	Los ID de las carpetas en el directorio de recursos. Puede especificar hasta cinco ID de carpeta. Puede crear pilas dentro de todos los miembros de las carpetas especificadas. Si crea pilas en la carpeta Root, estas se crean dentro de todos los miembros del directorio de recursos. Nota Para consultar los ID de carpeta, vaya a la página Overview 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 muestra

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

Respuestas exitosas de muestra

Formato XML

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

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

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 obtener una lista de códigos de error, consulte Códigos de error del servicio.

Código de error	Mensaje de error	Código de estado HTTP	Descripción
InvalidParameter	The specified parameter {name} is invalid, {reason}.	400	El mensaje de error devuelto porque el parámetro no es válido. name indica el nombre del parámetro. reason indica la causa del error.
StackGroupNotFound	The StackGroup ({name}) could not be found.	404	El mensaje de error devuelto porque el grupo de pilas no existe. name indica el nombre del grupo de pilas.
StackGroupOperationInProgress	Another Operation on StackGroup ({name}) is in progress.	409	El mensaje de error devuelto porque se está ejecutando una operación en el grupo de pilas. name indica el nombre del grupo de pilas.