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

Consulta los detalles de los grupos de pilas en una región de Alibaba Cloud.

Descripción de la operación

Este tema proporciona un ejemplo para consultar la lista de grupos de pilas activos 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:ListStackGroups

get

*StackGroup.

acs:ros:{#regionId}:{#accountId}:stackgroup/*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del grupo de pilas. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
Status	string	No	El estado del grupo de pilas. Si no especifica este parámetro, se consultan los grupos de pilas en todos los estados de la región. Valores válidos: ACTIVE: El grupo de pilas está activado. DELETED: El grupo de pilas está eliminado.	ACTIVE
PageSize	integer	No	La configuración de paginación para el número de entradas por página en una consulta paginada. Valores válidos: 1 a 50. Valor predeterminado: 10.	10
PageNumber	integer	No	La configuración de paginación para el número de página en una consulta paginada. Valor mínimo: 1. Valor predeterminado: 1.	1
ResourceGroupId	string	No	El ID del grupo de recursos. Si no especifica este parámetro, se consultan los grupos de pilas en todos los grupos de recursos. Nota Puede obtener el ID del grupo de recursos en la página Grupos de recursos de la consola Administración de recursos. Para obtener más información, consulte Ver la información básica de un grupo de recursos.	rg-acfmzawhxxcj****
Tags	array<object>	No	Las etiquetas del grupo de pilas.
	object	No
Key	string	Sí	La clave de etiqueta del grupo de pilas. Nota Tags es un parámetro opcional. Si especifica Tags, debe especificar Tags.N.Key.	usage
Value	string	No	El valor de etiqueta del grupo de pilas.	test

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
StackGroups	array<object>	Los grupos de pilas.
	array<object>
StackGroupId	string	El ID del grupo de pilas.	fd0ddef9-9540-4b42-a464-94f77835****
Status	string	El estado del grupo de pilas. Valores válidos: ACTIVE: El grupo de pilas está activado. DELETED: El grupo de pilas está eliminado.	ACTIVE
DriftDetectionTime	string	La hora en la que se realizó la última detección de desviaciones correcta en el grupo de pilas. La hora está en el formato YYYY-MM-DDThh:mm:ss.	2020-02-27T07:47:47
Description	string	La descripción del grupo de pilas.	My Stack Group
StackGroupDriftStatus	string	El estado de desviación del grupo de pilas en la última detección de desviaciones correcta. Valores válidos: DRIFTED: El grupo de pilas se ha desviado. NOT_CHECKED: No se ha realizado ninguna detección de desviaciones en el grupo de pilas. IN_SYNC: El grupo de pilas no se ha desviado.	IN_SYNC
StackGroupName	string	El nombre del grupo de pilas.	MyStackGroup
Tags	array<object>	Las etiquetas del grupo de pilas.
	object
Key	string	La clave de etiqueta del grupo de pilas.	usage1
Value	string	El valor de etiqueta del grupo de pilas.	test1
ResourceGroupId	string	El ID del grupo de recursos.	rg-acfmzawhxxcj****
PermissionModel	string	El modelo de permisos. Valores válidos: SELF_MANAGED: Permisos autogestionados. SERVICE_MANAGED: Permisos gestionados por el servicio. Nota Para obtener más información sobre los modelos de permisos de los grupos de pilas, consulte Descripción general.	SELF_MANAGED
AutoDeployment	object	La configuración de despliegue automático.
Enabled	boolean	Especifica si se debe habilitar el despliegue automático. Valores válidos: true: habilita el despliegue automático. Si el despliegue automático está habilitado y se agrega una cuenta de miembro a la carpeta de destino, el grupo de pilas despliega automáticamente instancias de pila en las regiones especificadas de la nueva cuenta. Si se quita una cuenta de la carpeta de destino, el grupo de pilas elimina las instancias de pila de las regiones especificadas de la cuenta. false: deshabilita el despliegue automático. Si el despliegue automático está deshabilitado, las instancias de pila no cambian cuando cambian las cuentas de miembro en la carpeta de destino.	true
RetainStacksOnAccountRemoval	boolean	Especifica si se deben conservar las pilas en las cuentas de miembro cuando las cuentas de miembro se quitan de la carpeta de destino. Valores válidos: true: conserva las pilas. false: elimina las pilas. Nota Este parámetro se devuelve solo cuando Enabled se establece en true.	true
CreateTime	string	La hora en la que se creó el grupo de pilas. La hora está en el formato YYYY-MM-DDThh:mm:ss.	2024-01-05T05:38:31
UpdateTime	string	La hora en la que se actualizó el grupo de pilas. La hora está en el formato YYYY-MM-DDThh:mm:ss.	2024-02-15T16:40:25
TotalCount	integer	El número total de grupos de pilas.	1
RequestId	string	El ID de la solicitud.	14A07460-EBE7-47CA-9757-12CC4761D47A
PageSize	integer	La configuración de paginación para el número de entradas por página en una consulta paginada.	10
PageNumber	integer	La configuración de paginación para el número de página en una consulta paginada.	1

Ejemplos

Respuesta exitosa

JSON Formato

{
  "StackGroups": [
    {
      "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
      "Status": "ACTIVE",
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "Description": "My Stack Group",
      "StackGroupDriftStatus": "IN_SYNC",
      "StackGroupName": "MyStackGroup",
      "Tags": [
        {
          "Key": "usage1",
          "Value": "test1"
        }
      ],
      "ResourceGroupId": "rg-acfmzawhxxcj****",
      "PermissionModel": "SELF_MANAGED",
      "AutoDeployment": {
        "Enabled": true,
        "RetainStacksOnAccountRemoval": true
      },
      "CreateTime": "2024-01-05T05:38:31",
      "UpdateTime": "2024-02-15T16:40:25"
    }
  ],
  "TotalCount": 1,
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "PageSize": 10,
  "PageNumber": 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.