GetStackInstance - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Consulta los detalles de las instancias de pila asociadas a un grupo de pilas especificado.

Descripción de la operación

Este tema proporciona un ejemplo para consultar los detalles de las instancias de pila que pertenecen al grupo de pilas MyStackGroup en la región China (Beijing) y a la cuenta de Alibaba Cloud 151266687691****. El grupo de pilas utiliza el modo de permisos autogestionados y reside en la región China (Hangzhou).

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ros:GetStackInstance

get

*StackInstance.

acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de región del grupo de pilas. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
StackGroupName	string	Sí	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 debe comenzar con un dígito o una letra. Puede contener dígitos, letras, guiones (-) y guiones bajos (_).	MyStackGroup
StackInstanceAccountId	string	Sí	El ID de la cuenta de ejecución a la que pertenece la pila. En el patrón de permisos autogestionados, esta cuenta es una cuenta de Alibaba Cloud. En el patrón de permisos gestionados por el servicio, esta cuenta es una de las cuentas miembro de una carpeta de recursos. Nota Para obtener más información sobre las cuentas de ejecución, consulte Descripción general.	151266687691****
StackInstanceRegionId	string	Sí	La región a la que pertenece la pila.	cn-beijing
OutputOption	string	No	Especifica si se debe devolver el parámetro Outputs (la lista de salidas de la pila). Valores válidos: Enabled: devuelve el parámetro Outputs. Disabled: no devuelve el parámetro Outputs. Este es el valor predeterminado. Nota Calcular Outputs consume mucho tiempo. Si no necesita la información de Outputs, establezca OutputOption en Disabled para mejorar la velocidad de respuesta de la API.	Disabled

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	B8A6B693-82C8-419D-8796-DE99EC33CFF9
StackInstance	object	Los detalles de la instancia de pila.
Status	string	El estado de la instancia de pila. Valores válidos: CURRENT: La instancia de pila está actualizada. OUTDATED: La instancia de pila no está actualizada con respecto al grupo de pilas. Posibles causas: La instancia de pila no se pudo crear durante la operación CreateStackInstances. La instancia de pila no se pudo actualizar o solo se actualizó parcialmente durante la operación UpdateStackInstances o UpdateStackGroup. La operación de creación o actualización no se ha completado.	CURRENT
StackGroupId	string	El ID del grupo de pilas.	fd0ddef9-9540-4b42-a464-94f77835****
StackId	string	El ID de la pila. Nota Este parámetro se devuelve solo cuando el estado de la instancia de pila es CURRENT.	35ad60e3-6a92-42d8-8812-f0700d45****
DriftDetectionTime	string	La hora en la que se realizó la última detección de derivas exitosa en el grupo de pilas. La hora se muestra en el formato YYYY-MM-DDThh:mm:ss. Nota Este parámetro se devuelve solo si se ha realizado la detección de derivas en el grupo de pilas.	2020-02-27T07:47:47
StackDriftStatus	string	El estado de deriva de la instancia de pila basado en la última detección de derivas exitosa. Valores válidos: DRIFTED: La instancia de pila presenta derivas. NOT_CHECKED: No se ha realizado ninguna detección de derivas exitosa en la instancia de pila. IN_SYNC: La instancia de pila está sincronizada. Nota Este parámetro se devuelve solo si se ha realizado la detección de derivas en el grupo de pilas.	IN_SYNC
StatusReason	string	El motivo del estado de la instancia. Nota Este parámetro se devuelve solo cuando el estado de la instancia de pila es OUTDATED.	User initiated stop
ParameterOverrides	array<object>	La lista de reemplazos de parámetros.
	object
ParameterKey	string	La clave del reemplazo de parámetro.	Amount
ParameterValue	string	El valor del reemplazo de parámetro.	1
StackGroupName	string	El nombre del grupo de pilas.	MyStackGroup
AccountId	string	El ID de la cuenta de ejecución a la que pertenece la pila.	151266687691****
RegionId	string	La región a la que pertenece la pila.	cn-beijing
RdFolderId	string	El ID de la carpeta en el directorio de recursos. Nota Este parámetro se devuelve solo para los grupos de pilas que utilizan el modo de permisos gestionados por el servicio.	fd-4PvlVLOL8v
Outputs	array<object>	La lista de salidas de la pila. Nota Este parámetro se devuelve cuando OutputOption se establece en Enabled.
	object	La lista de salidas de la pila. Nota Este parámetro se devuelve cuando OutputOption se establece en Enabled.	[{'OutputKey': 'rds_connection_string', 'OutputValue': 'rm-gw868n4lzy0i7kzx3.mysql.germany.rds.aliyuncs.com'}]

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "B8A6B693-82C8-419D-8796-DE99EC33CFF9",
  "StackInstance": {
    "Status": "CURRENT",
    "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
    "StackId": "35ad60e3-6a92-42d8-8812-f0700d45****",
    "DriftDetectionTime": "2020-02-27T07:47:47",
    "StackDriftStatus": "IN_SYNC",
    "StatusReason": "User initiated stop",
    "ParameterOverrides": [
      {
        "ParameterKey": "Amount",
        "ParameterValue": "1"
      }
    ],
    "StackGroupName": "MyStackGroup",
    "AccountId": "151266687691****",
    "RegionId": "cn-beijing",
    "RdFolderId": "fd-4PvlVLOL8v",
    "Outputs": [
      {
        "test": "test",
        "test2": 1
      }
    ]
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.