GetStack - - Centro de documentación de Alibaba Cloud

Consulta la información de una pila.

En este tema se consulta la información de una pila cuyo ID es c754d2a4-28f1-46df-b557-9586173a****. La pila está desplegada en la región China (Hangzhou).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor 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í	GetStack	La operación que desea ejecutar. Establezca el valor en GetStack.
StackId	String	Sí	c754d2a4-28f1-46df-b557-9586173a****	El ID de la pila.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde reside la pila. Puede llamar a la operación DescribeRegions para consultar la lista más reciente de regiones de Alibaba Cloud.
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 las distintas solicitudes. El token puede tener una longitud máxima de 64 caracteres. Para obtener más información, consulte Garantizar la idempotencia.
OutputOption	String	No	Disabled	Especifica si se deben devolver los parámetros de salida de la pila. Valores válidos: Enabled: devuelve los parámetros de salida. Este es el valor predeterminado. Disabled: no devuelve los parámetros de salida. Nota El sistema tarda mucho tiempo en calcular los parámetros de salida. Si no necesita consultarlos, le recomendamos establecer el parámetro OutputOption en Disabled para mejorar la velocidad de respuesta de la operación GetStack.
ShowResourceProgress	String	No	Disabled	Especifica si se debe devolver el parámetro ResourceProgress. Valores válidos: Disabled: no devuelve el parámetro ResourceProgress. Este es el valor predeterminado. EnabledIfCreateStack: devuelve el parámetro ResourceProgress solo si se crea una pila. Nota Una pila se encuentra en uno de los siguientes estados cuando se crea: CREATE_IN_PROGRESS, CREATE_COMPLETE, CREATE_FAILED, CREATE_ROLLBACK_IN_PROGRESS, CREATE_ROLLBACK_COMPLETE o CREATE_ROLLBACK_FAILED.
LogOption	String	No	Stack	La opción para devolver registros. Valores válidos: None: no devuelve registros. Stack: devuelve los registros de la pila. Este es el valor predeterminado. Resource: devuelve los registros de los recursos en la pila. All: devuelve los registros de todos los recursos.

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
Status	String	CREATE_COMPLETE	El estado 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 se creó correctamente. UPDATE_IN_PROGRESS: La pila se está actualizando. UPDATE_FAILED: Error al actualizar la pila. UPDATE_COMPLETE: La pila se actualizó correctamente. DELETE_IN_PROGRESS: La pila se está eliminando. DELETE_FAILED: Error al eliminar la pila. CREATE_ROLLBACK_IN_PROGRESS: Se está revirtiendo la pila tras un error en su creación. CREATE_ROLLBACK_FAILED: Error al revertir la pila tras un error en su creación. CREATE_ROLLBACK_COMPLETE: La pila se revirtió tras un error en su creación. ROLLBACK_IN_PROGRESS: Se están revirtiendo los recursos de la pila. 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 se validó correctamente. 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 se creó mediante recursos importados. IMPORT_CREATE_ROLLBACK_IN_PROGRESS: Se están revirtiendo los recursos tras un error al crear la pila con recursos importados. IMPORT_CREATE_ROLLBACK_FAILED: Error al revertir los recursos tras un error al crear la pila con recursos importados. IMPORT_CREATE_ROLLBACK_COMPLETE: Los recursos se revirtieron tras un error al crear la pila con 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 se actualizó mediante recursos importados. IMPORT_UPDATE_ROLLBACK_IN_PROGRESS: Se están revirtiendo los recursos tras un error al actualizar la pila con recursos importados. IMPORT_UPDATE_ROLLBACK_FAILED: Error al revertir los recursos tras un error al actualizar la pila con recursos importados. IMPORT_UPDATE_ROLLBACK_COMPLETE: Los recursos se revirtieron tras un error al actualizar la pila con recursos importados.
Description	String	Create a VPC.	La descripción de la pila.
Parameters	Array of Parameter		Los parámetros de la pila.
ParameterKey	String	ALIYUN::Region	El nombre del parámetro.
ParameterValue	String	cn-hangzhou	El valor del parámetro.
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6F	El ID de la solicitud.
StatusReason	String	Stack CREATE completed successfully	El motivo por el cual la pila se encuentra en su estado actual.
ParentStackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf692****	El ID de la pila principal.
CreateTime	String	2020-09-16T08:21:40	La hora en que se creó la pila. La hora sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss y se muestra en UTC.
DeletionProtection	String	Disabled	Indica si la protección contra eliminación está habilitada para la pila. Valores válidos: Enabled: La protección contra eliminación está habilitada para la pila. Disabled: La protección contra eliminación está deshabilitada para la pila. Puede eliminar la pila desde la consola de Resource Orchestration Service (ROS) o llamando a la operación DeleteStack. Nota La protección contra eliminación de una pila anidada funciona de la misma manera que la de la pila raíz.
RootStackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf692****	El ID de la pila raíz. Este parámetro se devuelve si la pila especificada es una pila anidada.
TemplateDescription	String	Create a VPC.	La descripción de la plantilla.
StackType	String	ROS	El tipo de la pila. Valores válidos: ROS: Pila de ROS, creada mediante una plantilla de ROS. Terraform: Pila de Terraform, creada mediante una plantilla de Terraform.
RamRoleName	String	test-role	El nombre del rol de RAM. 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 asumirá el rol de todos modos. Debe asegurarse de otorgar al rol únicamente los privilegios mínimos necesarios. Si no especifica este parámetro, ROS asume un rol existente asociado a la pila. Si no hay roles disponibles para que ROS asuma, el servicio utilizará 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.
UpdateTime	String	2020-09-17T08:21:40	La hora en que se actualizó la pila. La hora sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss y se muestra en UTC.
Outputs	Array of Object	[{"Description": "VPC ID","OutputKey": "VpcId","OutputValue": "vpc-bp1m6fww66xbntjyc****"}]	Los parámetros de salida de la pila. Nota Este parámetro se devuelve si el parámetro OutputOption está establecido en Enabled.
DriftDetectionTime	String	2020-09-16T09:21:40	La hora en que se realizó correctamente la última operación de detección de desviaciones.
RegionId	String	cn-hangzhou	El ID de la región donde está desplegada la pila. Puede llamar a la operación DescribeRegions para consultar la lista más reciente de regiones de Alibaba Cloud.
StackDriftStatus	String	IN_SYNC	El estado de la pila en la última detección de desviaciones exitosa. Valores válidos: DRIFTED: La pila presenta desviaciones. NOT_CHECKED: No se ha realizado ninguna detección de desviaciones exitosa en la pila. IN_SYNC: La pila está sincronizada.
NotificationURLs	Array of String	["http://127.XX.XX.1:8080/x", "http://127.0.XX.XX:8080/y"]	Las URL de devolución de llamada que se utilizan para recibir eventos de la pila.
DisableRollback	Boolean	false	Indica si la reversión está deshabilitada cuando falla la creación de la pila. Valores válidos: true: La reversión está deshabilitada cuando falla la creación de la pila. false: La reversión está habilitada cuando falla la creación de la pila. Este es el valor predeterminado.
StackName	String	MyStack	El nombre de la pila. 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.
Tags	Array of Tag		Las etiquetas de la pila.
Key	String	usage	La clave de la etiqueta de la pila.
Value	String	test	El valor de la etiqueta de la pila.
TimeoutInMinutes	Integer	10	El periodo de tiempo límite dentro del cual se puede crear la pila. Unidad: minutos.
StackId	String	c754d2a4-28f1-46df-b557-9586173a****	El ID de la pila.
ResourceGroupId	String	rg-acfmxazb4ph6aiy****	El ID del resource group al que pertenecen las instancias.
ResourceProgress	Object		El progreso de creación de los recursos.
TotalResourceCount	Integer	2	El número total de recursos.
SuccessResourceCount	Integer	1	El número de recursos creados correctamente.
FailedResourceCount	Integer	0	El número de recursos cuya creación falló.
InProgressResourceCount	Integer	1	El número de recursos que se están creando.
PendingResourceCount	Integer	0	El número de recursos pendientes de creación.
InProgressResourceDetails	Array of InProgressResourceDetail		Los detalles del progreso de los recursos que se están creando.
ResourceName	String	WaitCondition	El nombre del recurso.
ResourceType	String	ALIYUN::ROS::WaitCondition	El tipo del recurso.
ProgressValue	Float	5	El valor actual del progreso del recurso.
ProgressTargetValue	Float	10	El valor deseado del progreso del recurso.
Log	Object		Los registros de la pila.
TerraformLogs	Array of TerraformLog		Los registros de la pila de Terraform. Este parámetro se devuelve únicamente para una pila de Terraform. Este parámetro se devuelve si el parámetro LogOption se deja vacío o se establece en Stack o All. Nota Este parámetro no se devuelve para una pila en ejecución. Los registros se generan a partir de la última operación de creación, recreación, actualización o eliminación de la pila.
Command	String	apply	El nombre de un comando de Terraform ejecutado. Valores válidos: apply plan destroy version Para obtener más información sobre los comandos de Terraform, consulte Funciones básicas de CLI.
Stream	String	stdout	El flujo de salida. Valores válidos: stdout: el flujo de salida estándar. stderr: el flujo de error estándar.
Content	String	Apply complete! Resources: 42 added, 0 changed, 0 destroyed.	El contenido del flujo de salida devuelto tras ejecutar el comando.
ResourceLogs	Array of ResourceLog		Los registros de los recursos en la pila. Este parámetro se devuelve si el parámetro LogOption está establecido en Resource o All. Nota Los registros se devuelven para recursos de tipos específicos, como `ALIYUN::ROS::ResourceCleaner`.
ResourceName	String	MyResourceCleaner	El nombre del recurso definido en la plantilla.
Logs	Array of Log		Los registros de todos los recursos.
Keys	Array of String	ResourceDetails	Las palabras clave.
Content	String	[]	El contenido de un registro de recurso.
TemplateId	String	a52f81be-496f-4e1c-a286-8852ab54****	El ID de la plantilla. Este parámetro se devuelve únicamente si la plantilla actual de la pila es una plantilla personalizada o compartida. Si la plantilla es compartida, el valor de este parámetro coincide con el valor del parámetro TemplateARN.
TemplateVersion	String	v1	La versión de la plantilla. Este parámetro se devuelve únicamente si la plantilla actual de la pila es una plantilla personalizada o compartida. Si la plantilla es compartida, este parámetro se devuelve solo cuando el parámetro VersionOption está establecido en AllVersions. Valores válidos: v1 a v100.
TemplateScratchId	String	ts-7f7a704cf71c49a6****	El ID del escenario. Este parámetro se devuelve únicamente si la plantilla actual de la pila se generó a partir de un escenario.
TemplateURL	String	oss://ros/template/demo	La URL del archivo que contiene el cuerpo de la plantilla. Este parámetro se devuelve únicamente si la plantilla actual de la pila proviene de una URL. La URL puede apuntar a una plantilla ubicada en un servidor web HTTP o HTTPS, o en un bucket de Object Storage Service (OSS) de Alibaba Cloud.
Interface	String	{}	La descripción de la interfaz de usuario web en la consola de ROS.
ServiceManaged	Boolean	false	Indica si la pila es una pila administrada. Valores válidos: true false
ServiceName	String	ACVS	El nombre del servicio al que pertenece la pila administrada.
OperationInfo	Object		La información adicional que se muestra cuando ocurre un error en una operación de la pila. Nota Esta propiedad se devuelve bajo condiciones específicas. Se devuelve al menos una subpropiedad. Por ejemplo, cuando se reporta un error al llamar a la API de otro servicio en la nube.
Code	String	DependencyViolation	El código de error devuelto.
Message	String	There is still instance(s) in the specified security group.	El mensaje de error devuelto.
RequestId	String	071D6166-3F6B-5C7B-A1F0-0113FBB643A8	El ID de la solicitud para llamar a la API de otro servicio en la nube.
Action	String	DeleteSecurityGroup	El nombre de la API de otro servicio en la nube.
ResourceType	String	ALIYUN::ECS::SecurityGroup	El tipo de recurso en el que ocurrió el error de operación.
LogicalResourceId	String	EcsSecurityGroup	El ID lógico del recurso en el que ocurrió el error de operación.

Ejemplos

Solicitudes de ejemplo

http(s)://ros.aliyuncs.com/?Action=GetStack
&StackId=c754d2a4-28f1-46df-b557-9586173a****
&RegionId=cn-hangzhou
&<Common request parameters>

Respuestas de éxito de ejemplo

Formato XML

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

<GetStackResponse>
    <Status>CREATE_COMPLETE</Status>
    <Description>Create a VPC.</Description>
    <Parameters>
        <ParameterKey>ALIYUN::Region</ParameterKey>
        <ParameterValue>cn-hangzhou</ParameterValue>
    </Parameters>
    <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId>
    <StatusReason>Stack CREATE completed successfully</StatusReason>
    <ParentStackId>4a6c9851-3b0f-4f5f-b4ca-a14bf692****</ParentStackId>
    <CreateTime>2020-09-16T08:21:40</CreateTime>
    <DeletionProtection>Disabled</DeletionProtection>
    <RootStackId>4a6c9851-3b0f-4f5f-b4ca-a14bf692****</RootStackId>
    <TemplateDescription>Create a VPC.</TemplateDescription>
    <StackType>ROS</StackType>
    <RamRoleName>test-role</RamRoleName>
    <UpdateTime>2020-09-17T08:21:40</UpdateTime>
    <Outputs/>
    <DriftDetectionTime>2020-09-16T09:21:40</DriftDetectionTime>
    <RegionId>cn-hangzhou</RegionId>
    <StackDriftStatus>IN_SYNC</StackDriftStatus>
    <NotificationURLs>["http://127.XX.XX.1:8080/x", "http://127.0.XX.XX:8080/y"]</NotificationURLs>
    <DisableRollback>false</DisableRollback>
    <StackName>MyStack</StackName>
    <Tags>
        <Key>usage</Key>
        <Value>test</Value>
    </Tags>
    <TimeoutInMinutes>10</TimeoutInMinutes>
    <StackId>c754d2a4-28f1-46df-b557-9586173a****</StackId>
    <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
    <ResourceProgress>
        <TotalResourceCount>2</TotalResourceCount>
        <SuccessResourceCount>1</SuccessResourceCount>
        <FailedResourceCount>0</FailedResourceCount>
        <InProgressResourceCount>1</InProgressResourceCount>
        <PendingResourceCount>0</PendingResourceCount>
        <InProgressResourceDetails>
            <ResourceName>WaitCondition</ResourceName>
            <ResourceType>ALIYUN::ROS::WaitCondition</ResourceType>
            <ProgressValue>5</ProgressValue>
            <ProgressTargetValue>10</ProgressTargetValue>
        </InProgressResourceDetails>
    </ResourceProgress>
    <Log>
        <TerraformLogs>
            <Command>apply</Command>
            <Stream>stdout</Stream>
            <Content>Apply complete! Resources: 42 added, 0 changed, 0 destroyed.</Content>
        </TerraformLogs>
        <ResourceLogs>
            <ResourceName>MyResourceCleaner</ResourceName>
            <Logs>
                <Keys>ResourceDetails</Keys>
                <Content>[]</Content>
            </Logs>
        </ResourceLogs>
    </Log>
    <TemplateId>a52f81be-496f-4e1c-a286-8852ab54****</TemplateId>
    <TemplateVersion>v1</TemplateVersion>
    <TemplateScratchId>ts-7f7a704cf71c49a6****</TemplateScratchId>
    <TemplateURL>oss://ros/template/demo</TemplateURL>
    <Interface>{}</Interface>
    <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>
</GetStackResponse>

Formato JSON

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

{
  "Status" : "CREATE_COMPLETE",
  "Description" : "Create a VPC.",
  "Parameters" : {
    "ParameterKey" : "ALIYUN::Region",
    "ParameterValue" : "cn-hangzhou"
  },
  "RequestId" : "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "StatusReason" : "Stack CREATE completed successfully",
  "ParentStackId" : "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
  "CreateTime" : "2020-09-16T08:21:40",
  "DeletionProtection" : "Disabled",
  "RootStackId" : "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
  "TemplateDescription" : "Create a VPC.",
  "StackType" : "ROS",
  "RamRoleName" : "test-role",
  "UpdateTime" : "2020-09-17T08:21:40",
  "Outputs" : "",
  "DriftDetectionTime" : "2020-09-16T09:21:40",
  "RegionId" : "cn-hangzhou",
  "StackDriftStatus" : "IN_SYNC",
  "NotificationURLs" : "[\"http://127.XX.XX.1:8080/x\", \"http://127.0.XX.XX:8080/y\"]",
  "DisableRollback" : false,
  "StackName" : "MyStack",
  "Tags" : {
    "Key" : "usage",
    "Value" : "test"
  },
  "TimeoutInMinutes" : 10,
  "StackId" : "c754d2a4-28f1-46df-b557-9586173a****",
  "ResourceGroupId" : "rg-acfmxazb4ph6aiy****",
  "ResourceProgress" : {
    "TotalResourceCount" : 2,
    "SuccessResourceCount" : 1,
    "FailedResourceCount" : 0,
    "InProgressResourceCount" : 1,
    "PendingResourceCount" : 0,
    "InProgressResourceDetails" : {
      "ResourceName" : "WaitCondition",
      "ResourceType" : "ALIYUN::ROS::WaitCondition",
      "ProgressValue" : 5,
      "ProgressTargetValue" : 10
    }
  },
  "Log" : {
    "TerraformLogs" : {
      "Command" : "apply",
      "Stream" : "stdout",
      "Content" : "Apply complete! Resources: 42 added, 0 changed, 0 destroyed."
    },
    "ResourceLogs" : {
      "ResourceName" : "MyResourceCleaner",
      "Logs" : {
        "Keys" : "ResourceDetails",
        "Content" : "[]"
      }
    }
  },
  "TemplateId" : "a52f81be-496f-4e1c-a286-8852ab54****",
  "TemplateVersion" : "v1",
  "TemplateScratchId" : "ts-7f7a704cf71c49a6****",
  "TemplateURL" : "oss://ros/template/demo",
  "Interface" : "{}",
  "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.

HttpCode	Código de error	Mensaje de error	Descripción
404	StackNotFound	The Stack ({name}) could not be found.	El mensaje de error devuelto porque la pila especificada no existe. name indica el nombre o el ID de la pila.