Tous les produits
Search
Centre de documentation

:DescribeApplicationGroups

Dernière mise à jour :Aug 11, 2026

Récupère les informations sur les groupes d'instances d'une application.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la rubrique Paramètres de requête communs et paramètres de réponse communs.

Syntaxe de la requête

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

Paramètres de requête

Paramètre Type Emplacement Obligatoire Exemple Description
AppId String Query Oui d700e680-aa4d-4ec1-afc2-6566b5ff****

L'ID de l'application.

CurrentPage Integer Query Non 1

Le numéro de la page à renvoyer.

PageSize Integer Query Non 10

Le nombre d'éléments à renvoyer par page.

Paramètres de réponse

ParamètreTypeExempleDescription
RequestIdString91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

L'ID de la requête.

MessageStringsuccess

Le message renvoyé.

TraceIdString0a98a02315955564772843261e****

L'ID de trace. Utilisez cet ID pour consulter les détails de la requête.

DataArray of ApplicationGroup

Les informations sur les groupes d'instances de l'application.

JdkStringOpen JDK 8

La version du kit de développement Java (JDK) dont dépend le package de déploiement de l'application. Ce paramètre est ignoré si le paramètre PackageType est défini sur Image.

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

L'adresse de l'image. Ce paramètre est requis si le paramètre PackageType est défini sur Image.

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

L'adresse du package de déploiement. Ce paramètre est requis si le paramètre PackageType est défini sur FatJar, War ou PhpZip.

PackageTypeStringImage

Le type du package de déploiement de l'application. Valeurs valides :

  • Pour un package Java, définissez cette valeur sur FatJar, War ou Image.
  • Pour un package PHP, les valeurs suivantes sont valides :
    • 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 version du package de déploiement. Ce paramètre est requis si le paramètre PackageType est défini sur FatJar, War ou PhpZip. La valeur est générée automatiquement si vous déployez l'application à l'aide d'une image et spécifiez le paramètre ImageUrl.

GroupNameString_DEFAULT_GROUP

Le nom du groupe.

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

L'ID du groupe.

WebContainerStringApache Tomcat 7

La version du conteneur Apache Tomcat dont dépend le package de déploiement de l'application. Ce paramètre est ignoré si le paramètre PackageType est défini sur Image.

ReplicasInteger10

Le nombre total d'instances.

EdasContainerVersionString3.5.3

La version du conteneur (par exemple, Ali-Tomcat) dans lequel s'exécute une application High-speed Service Framework (HSF).

RunningInstancesInteger1

Le nombre d'instances en cours d'exécution.

GroupTypeInteger0

Le type du groupe.

ErrorCodeStringCe paramètre est laissé vide.

Le code d'erreur.

  • Le paramètre ErrorCode n'est pas renvoyé en cas de succès de la requête.
  • Le paramètre ErrorCode est renvoyé en cas d'échec de la requête. Pour plus d'informations, consultez la section Codes d'erreur de cette rubrique.
CodeString200

Le code d'état HTTP. Valeurs valides :

  • 2xx : la requête a abouti.
  • 3xx : la requête a été redirigée.
  • 4xx : la requête n'est pas valide.
  • 5xx : une erreur de serveur s'est produite.
SuccessBooleantrue

Indique si les informations sur les groupes d'instances de l'application ont été récupérées. Valeurs valides :

  • true : les informations ont été récupérées.
  • false : échec de la récupération des informations.

Exemples

Exemple de requête

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

Exemple de réponse en cas de succès

Format 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>

Format 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
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.