ListStackInstances - - Centro de documentación de Alibaba Cloud

Consulta las pilas desplegadas en un grupo de pilas.

En este ejemplo, se consultan las pilas desplegadas en un grupo de pilas llamado MyStackGroup. El grupo de pilas tiene permisos autogestionados y está desplegado en la región China (Hangzhou).

Depuración

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListStackInstances	La operación que desea ejecutar. Establezca el valor en ListStackInstances.
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. Debe ser único dentro de una región. 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.
StackInstanceAccountId	String	No	156552876021****	El ID de la cuenta a la que pertenece la pila. Si el grupo de pilas tiene permisos autogestionados, la pila pertenece a una cuenta de Alibaba Cloud. Si el grupo de pilas tiene permisos gestionados por servicio, la pila pertenece a un miembro de un directorio de recursos. Nota Para obtener más información sobre la cuenta, consulte Descripción general.
StackInstanceRegionId	String	No	cn-beijing	El ID de la región a la que pertenece la pila.
PageSize	Long	No	10	El número de entradas por página. Valores válidos: de 1 a 50. Valor predeterminado: 10.
PageNumber	Long	No	1	El número de página que se devolverá. La numeración comienza en la página 1. Valor predeterminado: 1.

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
TotalCount	Integer	1	El número total de pilas.
RequestId	String	85DE34BD-7FF9-480F-8C21-556E9DA93ACD	El ID de la solicitud.
PageSize	Integer	1	El número de entradas devueltas por página.
PageNumber	Integer	1	El número de la página devuelta.
StackInstances	Array of StackInstance		Detalles de las pilas.
Status	String	CURRENT	El estado de la pila. Valores válidos: CURRENT: La pila está actualizada respecto al grupo de pilas. OUTDATED: La pila no está actualizada respecto al grupo de pilas. Las pilas pueden estar en estado OUTDATED por las siguientes razones: Error al crear las pilas mediante la operación CreateStackInstances. Error al actualizar las pilas mediante la operación UpdateStackInstances o UpdateStackGroup, o actualización parcial. La operación de creación o actualización no se completó.
StackGroupId	String	fd0ddef9-9540-4b42-a464-94f77835****	El ID del grupo de pilas.
StackId	String	35ad60e3-6a92-42d8-8812-f0700d45****	El ID de la pila. Nota Este parámetro se devuelve solo si la pila está en estado CURRENT.
DriftDetectionTime	String	2020-02-27T07:47:47	La hora de la última detección de desviaciones correcta en la pila. Nota Este parámetro se devuelve solo si se realiza la detección de desviaciones en el grupo de pilas.
StackDriftStatus	String	IN_SYNC	El estado de la pila durante la última detección de desviaciones correcta en el grupo de pilas. Valores válidos: DRIFTED: La pila presenta desviaciones. NOT_CHECKED: No se ha realizado ninguna detección de desviaciones correcta en la pila. IN_SYNC: La pila se está sincronizando. Nota Este parámetro se devuelve solo si se realiza la detección de desviaciones en el grupo de pilas.
StatusReason	String	User initiated stop	El motivo por el cual la pila está en estado OUTDATED. Nota Este parámetro se devuelve solo si la pila está en estado OUTDATED.
StackGroupName	String	MyStackGroup	El nombre del grupo de pilas.
AccountId	String	156552876021****	El ID de la cuenta a la que pertenece la pila.
RegionId	String	cn-beijing	El ID de la región a la que pertenece la pila.
RdFolderId	String	fd-4PvlVLOL8v	El ID de la carpeta en el directorio de recursos. Nota Este parámetro se devuelve solo si el grupo de pilas tiene permisos gestionados por servicio.

Ejemplos

Solicitudes de ejemplo

http(s)://ros.aliyuncs.com/?Action=ListStackInstances
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&<Common request parameters>

Respuestas correctas de ejemplo

Formato XML

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

<ListStackInstancesResponse>
    <TotalCount>1</TotalCount>
    <RequestId>85DE34BD-7FF9-480F-8C21-556E9DA93ACD</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <StackInstances>
        <Status>OUTDATED</Status>
        <AccountId>156552876021****</AccountId>
        <StatusReason>User initiated stop.</StatusReason>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <RegionId>cn-beijing</RegionId>
    </StackInstances>
</ListStackInstancesResponse>

Formato JSON

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

{
  "TotalCount" : 1,
  "RequestId" : "85DE34BD-7FF9-480F-8C21-556E9DA93ACD",
  "PageSize" : 10,
  "PageNumber" : 1,
  "StackInstances" : [ {
    "Status" : "OUTDATED",
    "AccountId" : "156552876021****",
    "StatusReason" : "User initiated stop.",
    "StackGroupName" : "MyStackGroup",
    "StackGroupId" : "fd0ddef9-9540-4b42-a464-94f77835****",
    "RegionId" : "cn-beijing"
  } ]
}

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	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	Mensaje de error devuelto porque el grupo de pilas no existe. name indica el nombre del grupo de pilas.