ListStacks - - Centro de documentación de Alibaba Cloud

Consulta la lista de pilas.

Descripción

Este tema proporciona un ejemplo sobre cómo consultar la lista de pilas. En este ejemplo, se consultan las pilas desplegadas 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 muestra de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListStacks	La operación que desea ejecutar. Establezca el valor en ListStacks.
PageSize	Long	No	10	El número de entradas por página. Valor máximo: 50. Valor predeterminado: 10.
ParentStackId	String	No	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	El ID de la pila principal.
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.
PageNumber	Long	No	1	El número de página a devolver. Las páginas comienzan desde la página 1. Valor predeterminado: 1.
ShowNestedStack	Boolean	No	true	Especifica si se deben devolver las pilas anidadas. Valor predeterminado: false. Valores válidos: true false Nota Si se especifica el parámetro ParentStackId, debe establecer el parámetro ShowNestedStack en true.
StackId	String	No	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	El ID de la pila. Si desea consultar la información básica de la pila, use este parámetro; no es necesario llamar a la operación GetStack.
Status.N	String	No	CREATE_COMPLETE	El estado N de la pila. Valores válidos: CREATE_IN_PROGRESS: La pila se está creando. CREATE_FAILED: Error al crear la pila. CREATE_COMPLETE: La pila está creada. UPDATE_IN_PROGRESS: La pila se está actualizando. UPDATE_FAILED: Error al actualizar la pila. UPDATE_COMPLETE: La pila está actualizada. DELETE_IN_PROGRESS: La pila se está eliminando. DELETE_FAILED: Error al eliminar la pila. CREATE_ROLLBACK_IN_PROGRESS: Los recursos se están revirtiendo tras el fallo en la creación de la pila. CREATE_ROLLBACK_FAILED: Error al revertir los recursos tras el fallo en la creación de la pila. CREATE_ROLLBACK_COMPLETE: Los recursos se revirtieron tras el fallo en la creación de la pila. ROLLBACK_IN_PROGRESS: Los recursos de la pila se están revirtiendo. ROLLBACK_FAILED: Error al revertir los recursos de la pila. ROLLBACK_COMPLETE: Los recursos de la pila se revirtieron. CHECK_IN_PROGRESS: La pila se está validando. CHECK_FAILED: Error al validar la pila. CHECK_COMPLETE: La pila está validada. REVIEW_IN_PROGRESS: La pila se está revisando. IMPORT_CREATE_IN_PROGRESS: La pila se está creando mediante recursos importados. IMPORT_CREATE_FAILED: Error al crear la pila mediante recursos importados. IMPORT_CREATE_COMPLETE: La pila está creada mediante recursos importados. IMPORT_CREATE_ROLLBACK_IN_PROGRESS: Los recursos se están revirtiendo tras el fallo en la creación de la pila mediante recursos importados. IMPORT_CREATE_ROLLBACK_FAILED: Error al revertir los recursos tras el fallo en la creación de la pila mediante recursos importados. IMPORT_CREATE_ROLLBACK_COMPLETE: Los recursos se revirtieron tras el fallo en la creación de la pila mediante recursos importados. IMPORT_UPDATE_IN_PROGRESS: La pila se está actualizando mediante recursos importados. IMPORT_UPDATE_FAILED: Error al actualizar la pila mediante recursos importados. IMPORT_UPDATE_COMPLETE: La pila está actualizada mediante recursos importados. IMPORT_UPDATE_ROLLBACK_IN_PROGRESS: Los recursos se están revirtiendo tras el fallo en la actualización de la pila mediante recursos importados. IMPORT_UPDATE_ROLLBACK_FAILED: Error al revertir los recursos tras el fallo en la actualización de la pila mediante recursos importados. IMPORT_UPDATE_ROLLBACK_COMPLETE: Los recursos se revirtieron tras el fallo en la actualización de la pila mediante recursos importados.
StackName.N	String	No	MyStack	El nombre de la pila 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. Use el carácter comodín (∗) para búsquedas aproximadas. Valores válidos de N: 1 a 5.
Tag.N.Key	String	No	usage	La clave de la etiqueta N de la pila. Valores válidos de N: 1 a 20.
Tag.N.Value	String	No	test	El valor de la etiqueta N de la pila. Valores válidos de N: 1 a 20.
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" del tema What is Resource Management?.
StackIds.N	String	No	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	El ID de la pila N. Especifique uno o más ID para consultar varias pilas simultáneamente. Valores válidos de N: 1 a 10.

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	2	El número total de pilas.
PageSize	Integer	10	El número de entradas devueltas por página. Valor máximo: 50. Valor predeterminado: 10.
RequestId	String	FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7	El ID de la solicitud.
PageNumber	Integer	1	El número de la página devuelta.
Stacks	Array of Stack		La lista de pilas.
Status	String	CREATE_COMPLETE	El estado de la pila.
UpdateTime	String	2022-03-10T07:44:36	La hora de la última actualización de la pila. Sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss y se muestra en UTC.
DriftDetectionTime	String	2022-03-10T06:46:36	La hora de la última detección de desviaciones correcta en la pila.
StatusReason	String	Stack CREATE completed successfully	El motivo del estado actual de la pila.
CreateTime	String	2022-03-10T06:44:36	La hora de creación de la pila. Sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss y se muestra en UTC.
DisableRollback	Boolean	false	Indica si la reversión está deshabilitada cuando falla la creación de la pila. Valor predeterminado: false. Valores válidos: true false
Tags	Array of Tag		Las etiquetas de la pila.
Key	String	acs:rm:rgId	La clave de la etiqueta de la pila.
Value	String	rg-aek2frunvw7****	El valor de la etiqueta de la pila.
StackName	String	MyStack	El nombre de la pila.
TimeoutInMinutes	Integer	60	El tiempo de espera permitido para crear la pila. Unidad: minutos.
RegionId	String	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.
ParentStackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf692****	El ID de la pila principal.
StackId	String	67805444-a605-45ee-a57f-83908ff6****	El ID de la pila.
StackDriftStatus	String	IN_SYNC	El estado de la pila según la última detección de desviaciones correcta. Valores válidos: DRIFTED: Se está realizando la detección de desviaciones en la pila. NOT_CHECKED: No se ha realizado ninguna detección de desviaciones correcta en la pila. IN_SYNC: La pila se está sincronizando.
StackType	String	ROS	El tipo de la pila. Valores válidos: ROS: Pila de ROS. La pila se crea mediante una plantilla de Resource Orchestration Service (ROS). Terraform: Pila de Terraform. La pila se crea mediante una plantilla de terraform.
ResourceGroupId	String	rg-aek2frunvw7****	El ID del resource group.
ServiceManaged	Boolean	false	Indica si la pila es administrada. Valores válidos: true false
ServiceName	String	ACVS	El nombre del servicio al que pertenece la pila administrada.
OperationInfo	Object		Información complementaria devuelta cuando falla una operación en la pila. Nota Este parámetro se devuelve si falla una operación en la pila. El sistema devuelve como mínimo una subpropiedad. Ejemplo: Ocurrió un error al llamar a la operación de API de otro servicio de Alibaba Cloud.
Code	String	DependencyViolation	El código de error.
Message	String	There is still instance(s) in the specified security group.	El mensaje de error.
RequestId	String	071D6166-3F6B-5C7B-A1F0-0113FBB643A8	El ID de la solicitud iniciada para llamar a la operación de API de otro servicio de Alibaba Cloud.
Action	String	DeleteSecurityGroup	El nombre de la operación de API perteneciente a otro servicio de Alibaba Cloud.
ResourceType	String	ALIYUN::ECS::SecurityGroup	El tipo de recurso en el que falló la operación.
LogicalResourceId	String	EcsSecurityGroup	El ID lógico del recurso en el que falló la operación.

Ejemplos

Solicitudes de muestra

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

Respuestas de éxito de muestra

Formato XML

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

<ListStacksResponse>
    <TotalCount>2</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7</RequestId>
    <PageNumber>1</PageNumber>
    <Stacks>
        <Status>CREATE_COMPLETE</Status>
        <UpdateTime>2022-03-10T07:44:36</UpdateTime>
        <DriftDetectionTime>2022-03-10T06:46:36</DriftDetectionTime>
        <StatusReason>Stack CREATE completed successfully</StatusReason>
        <CreateTime>2022-03-10T06:44:36</CreateTime>
        <DisableRollback>false</DisableRollback>
        <Tags>
            <Key>acs:rm:rgId</Key>
            <Value>rg-aek2frunvw7****</Value>
        </Tags>
        <StackName>MyStack</StackName>
        <TimeoutInMinutes>60</TimeoutInMinutes>
        <RegionId>cn-hangzhou</RegionId>
        <ParentStackId>4a6c9851-3b0f-4f5f-b4ca-a14bf692****</ParentStackId>
        <StackId>67805444-a605-45ee-a57f-83908ff6****</StackId>
        <StackDriftStatus>IN_SYNC</StackDriftStatus>
        <StackType>ROS</StackType>
        <ResourceGroupId>rg-aek2frunvw7****</ResourceGroupId>
        <ServiceManaged>false</ServiceManaged>
        <ServiceName>ACVS</ServiceName>
        <OperationInfo>
            <Code>DependencyViolation</Code>
            <Message>There is still instance(s) in the specified security group.</Message>
            <RequestId>071D6166-3F6B-5C7B-A1F0-0113FBB643A8</RequestId>
            <Action>DeleteSecurityGroup</Action>
            <ResourceType>ALIYUN::ECS::SecurityGroup</ResourceType>
            <LogicalResourceId>EcsSecurityGroup</LogicalResourceId>
        </OperationInfo>
    </Stacks>
</ListStacksResponse>

Formato JSON

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

{
  "TotalCount" : 2,
  "PageSize" : 10,
  "RequestId" : "FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7",
  "PageNumber" : 1,
  "Stacks" : {
    "Status" : "CREATE_COMPLETE",
    "UpdateTime" : "2022-03-10T07:44:36",
    "DriftDetectionTime" : "2022-03-10T06:46:36",
    "StatusReason" : "Stack CREATE completed successfully",
    "CreateTime" : "2022-03-10T06:44:36",
    "DisableRollback" : false,
    "Tags" : {
      "Key" : "acs:rm:rgId",
      "Value" : "rg-aek2frunvw7****"
    },
    "StackName" : "MyStack",
    "TimeoutInMinutes" : 60,
    "RegionId" : "cn-hangzhou",
    "ParentStackId" : "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
    "StackId" : "67805444-a605-45ee-a57f-83908ff6****",
    "StackDriftStatus" : "IN_SYNC",
    "StackType" : "ROS",
    "ResourceGroupId" : "rg-aek2frunvw7****",
    "ServiceManaged" : false,
    "ServiceName" : "ACVS",
    "OperationInfo" : {
      "Code" : "DependencyViolation",
      "Message" : "There is still instance(s) in the specified security group.",
      "RequestId" : "071D6166-3F6B-5C7B-A1F0-0113FBB643A8",
      "Action" : "DeleteSecurityGroup",
      "ResourceType" : "ALIYUN::ECS::SecurityGroup",
      "LogicalResourceId" : "EcsSecurityGroup"
    }
  }
}

Códigos de error

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