Todos los productos
Search
Centro de documentos

:DescribeApplicationGroups

Última actualización: Sep 05, 2026

Consulta la información de los grupos de instancias de una aplicación.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Encabezados de solicitud

Esta operación utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Parámetros de solicitud comunes y parámetros de respuesta comunes.

Sintaxis de solicitud

GET /pop/v1/sam/app/describeApplicationGroups HTTP/1.1

Parámetros de solicitud

Parámetro

Tipo

Posición

Obligatorio

Ejemplo

Descripción

AppId

String

Query

Sí

d700e680-aa4d-4ec1-afc2-6566b5ff****

El ID de la aplicación.

CurrentPage

Integer

Query

No

1

El número de página que se devolverá.

PageSize

Integer

Query

No

10

El número de entradas que se devolverán en cada página.

Parámetros de respuesta

ParámetroTipoEjemploDescripción
RequestIdString91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

El ID de la solicitud.

MessageStringsuccess

El mensaje devuelto.

TraceIdString0a98a02315955564772843261e****

El ID del rastreo. Se utiliza para consultar los detalles de una solicitud.

DataArray of ApplicationGroup

La información de los grupos de instancias de la aplicación.

JdkStringOpen JDK 8

La versión del kit de desarrollo de Java (JDK) de la que depende el paquete de despliegue de la aplicación. Este parámetro no es válido cuando el parámetro PackageType está establecido en Image.

ImageUrlStringregistry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest

La dirección de la imagen. Este parámetro es obligatorio cuando el parámetro PackageType está establecido en Image.

PackageUrlStringregistry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest

La dirección del paquete de despliegue. Este parámetro es obligatorio cuando el parámetro PackageType está establecido en FatJar, War o PhpZip.

PackageTypeStringImage

El tipo de paquete de despliegue de la aplicación. Valores válidos:

  • Si utiliza un paquete de Java, establezca este valor en FatJar, War o Image.
  • Si utiliza un paquete de PHP, son válidos los siguientes valores:
    • PhpZip
    • IMAGE_PHP_5_4
    • IMAGE_PHP_5_4_ALPINE
    • IMAGE_PHP_5_5
    • IMAGE_PHP_5_5_ALPINE
    • IMAGE_PHP_5_6
    • IMAGE_PHP_5_6_ALPINE
    • IMAGE_PHP_7_0
    • IMAGE_PHP_7_0_ALPINE
    • IMAGE_PHP_7_1
    • IMAGE_PHP_7_1_ALPINE
    • IMAGE_PHP_7_2
    • IMAGE_PHP_7_2_ALPINE
    • IMAGE_PHP_7_3
    • IMAGE_PHP_7_3_ALPINE
PackageVersionString1.0.0

La versión del paquete de despliegue. Este parámetro es obligatorio cuando el parámetro PackageType está establecido en FatJar, War o PhpZip. El valor del parámetro se generará automáticamente cuando utilice una imagen para desplegar la aplicación y especifique el parámetro ImageUrl.

GroupNameString_DEFAULT_GROUP

El nombre del grupo.

GroupIdStringb2a8a925-477a-eswa-b823-d5e22500****

El ID del grupo.

WebContainerStringApache Tomcat 7

La versión del contenedor Apache Tomcat de la que depende el paquete de despliegue de la aplicación. Este parámetro no es válido cuando el parámetro PackageType está establecido en Image.

ReplicasInteger10

El número total de instancias.

EdasContainerVersionString3.5.3

La versión del contenedor, como Ali-Tomcat, en la que se ejecuta una aplicación High-speed Service Framework (HSF).

RunningInstancesInteger1

El número de instancias en ejecución.

GroupTypeInteger0

El tipo de grupo.

ErrorCodeStringEste parámetro se deja vacío.

El código de error.

  • El parámetro ErrorCode no se devuelve cuando la solicitud es exitosa.
  • El parámetro ErrorCode se devuelve cuando la solicitud falla. Para obtener más información, consulte Códigos de error en este tema.
CodeString200

El código de estado HTTP. Valores válidos:

  • 2xx: indica que la solicitud fue exitosa.
  • 3xx: indica que la solicitud fue redirigida.
  • 4xx: indica que la solicitud no era válida.
  • 5xx: indica que ocurrió un error del servidor.
SuccessBooleantrue

Indica si se obtuvo la información de los grupos de instancias de una aplicación. Valores válidos:

  • true: indica que se obtuvo la información.
  • false: indica que no se pudo obtener la información.

Ejemplos

Solicitudes de ejemplo

GET /pop/v1/sam/app/describeApplicationGroups?AppId=d700e680-aa4d-4ec1-afc2-6566b5ff****&CurrentPage=1&PageSize=10 HTTP/1.1
Host:sae.aliyuncs.com
Content-Type:application/json

Respuestas exitosas de ejemplo

Formato XML

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

<DescribeApplicationGroupsResponse>
    <RequestId>91F93257-7A4A-4BD3-9A7E-2F6EAE6D****</RequestId>
    <Message>success</Message>
    <TraceId>0a98a02315955564772843261e****</TraceId>
    <Data>
        <Jdk>Open JDK 8</Jdk>
        <ImageUrl>registry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest</ImageUrl>
        <PackageUrl>registry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest</PackageUrl>
        <PackageType>Image</PackageType>
        <PackageVersion>1.0.0</PackageVersion>
        <GroupName>_DEFAULT_GROUP</GroupName>
        <GroupId>b2a8a925-477a-eswa-b823-d5e22500****</GroupId>
        <WebContainer>Apache Tomcat 7</WebContainer>
        <Replicas>10</Replicas>
        <EdasContainerVersion>3.5.3</EdasContainerVersion>
        <RunningInstances>1</RunningInstances>
        <GroupType>0</GroupType>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeApplicationGroupsResponse>

Formato JSON

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

{
  "RequestId" : "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message" : "success",
  "TraceId" : "0a98a02315955564772843261e****",
  "Data" : [ {
    "Jdk" : "Open JDK 8",
    "ImageUrl" : "registry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest",
    "PackageUrl" : "registry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest",
    "PackageType" : "Image",
    "PackageVersion" : "1.0.0",
    "GroupName" : "_DEFAULT_GROUP",
    "GroupId" : "b2a8a925-477a-eswa-b823-d5e22500****",
    "WebContainer" : "Apache Tomcat 7",
    "Replicas" : 10,
    "EdasContainerVersion" : "3.5.3",
    "RunningInstances" : 1,
    "GroupType" : 0
  } ],
  "Code" : "200",
  "Success" : true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.