GetStackInstance - - Centro de documentación de Alibaba Cloud

Consulta los detalles de una pila desplegada en un grupo de pilas dentro de una cuenta y región específicas.

En este ejemplo, se consultan los detalles de una pila desplegada en la región China (Beijing) dentro de la cuenta de Alibaba Cloud 151266687691****. La pila está desplegada en un grupo de pilas llamado MyStackGroup. Este 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 llamar a esta operación desde OpenAPI Explorer. Esta herramienta 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	No	GetStackInstance	La operación que desea ejecutar. Establezca el valor en GetStackInstance.
RegionId	String	No	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	No	MyStackGroup	El nombre del grupo de pilas. El nombre 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	151266687691****	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.

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	B8A6B693-82C8-419D-8796-DE99EC33CFF9	El ID de la solicitud.
StackInstance	Object		Detalles de la pila.
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: Al llamar a la operación CreateStackInstances para crear pilas, estas no se crearon correctamente. Al llamar a la operación UpdateStackInstances o UpdateStackGroup para actualizar pilas, estas no se actualizaron correctamente o solo se actualizaron algunas. La operación de creación o actualización no ha finalizado.
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 en que se realizó la última detección de desviaciones exitosa en el grupo de pilas. 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 cuando se realizó la última detección de desviaciones exitosa en el grupo de pilas. 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 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.
ParameterOverrides	Array of ParameterOverride		Los parámetros que se utilizan para anular parámetros específicos.
ParameterKey	String	Amount	El nombre del parámetro que se utiliza para anular un parámetro específico.
ParameterValue	String	1	El valor del parámetro que se utiliza para anular un parámetro específico.
StackGroupName	String	MyStackGroup	El nombre del grupo de pilas.
AccountId	String	151266687691****	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=GetStackInstance
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&StackInstanceAccountId=151266687691****
&StackInstanceRegionId=cn-beijing
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<GetStackInstanceResponse>
    <RequestId>B8A6B693-82C8-419D-8796-DE99EC33CFF9</RequestId>
    <StackInstance>
        <Status>OUTDATED</Status>
        <AccountId>151266687691****</AccountId>
        <StatusReason>Cancelled since failure tolerance has exceeded</StatusReason>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <RegionId>cn-beijing</RegionId>
    </StackInstance>
</GetStackInstanceResponse>

Formato JSON

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

{
  "RequestId" : "B8A6B693-82C8-419D-8796-DE99EC33CFF9",
  "StackInstance" : {
    "Status" : "OUTDATED",
    "AccountId" : "151266687691****",
    "StatusReason" : "Cancelled since failure tolerance has exceeded",
    "ParameterOverrides" : [ ],
    "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	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.
StackInstanceNotFound	The StackInstance could not be found.	404	El mensaje de error devuelto porque la pila no existe.