Consulta informações sobre os grupos de instâncias de uma aplicação.
Depuração
Cabeçalhos da requisição
Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Parâmetros de requisição comuns e parâmetros de resposta comuns.
Sintaxe da requisição
GET /pop/v1/sam/app/describeApplicationGroups HTTP/1.1
Parâmetros da requisição
|
Parâmetro |
Tipo |
Posição |
Obrigatório |
Exemplo |
Descrição |
|
AppId |
String |
Query |
Sim |
d700e680-aa4d-4ec1-afc2-6566b5ff**** |
ID da aplicação. |
|
CurrentPage |
Integer |
Query |
Não |
1 |
Número da página a retornar. |
|
PageSize |
Integer |
Query |
Não |
10 |
Quantidade de entradas a retornar por página. |
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| RequestId | String | 91F93257-7A4A-4BD3-9A7E-2F6EAE6D**** | ID da requisição. |
| Message | String | success | Mensagem retornada. |
| TraceId | String | 0a98a02315955564772843261e**** | ID do rastreamento. Serve para consultar detalhes de uma requisição. |
| Data | Array of ApplicationGroup | Informações sobre os grupos de instâncias da aplicação. | |
| Jdk | String | Open JDK 8 | Versão do Java Development Kit (JDK) exigida pelo pacote de implantação da aplicação. Este parâmetro torna-se inválido se PackageType estiver definido como Image. |
| ImageUrl | String | registry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest | Endereço da imagem. Obrigatório quando PackageType for Image. |
| PackageUrl | String | registry-vpc.cn-hangzhou.aliyuncs.com/demo/nginx:latest | Endereço do pacote de implantação. Obrigatório quando PackageType for FatJar, War ou PhpZip. |
| PackageType | String | Image | Tipo do pacote de implantação da aplicação. Valores válidos:
|
| PackageVersion | String | 1.0.0 | Versão do pacote de implantação. Obrigatório quando PackageType for FatJar, War ou PhpZip. O sistema gera esse valor automaticamente ao implantar a aplicação via imagem com o parâmetro ImageUrl especificado. |
| GroupName | String | _DEFAULT_GROUP | Nome do grupo. |
| GroupId | String | b2a8a925-477a-eswa-b823-d5e22500**** | ID do grupo. |
| WebContainer | String | Apache Tomcat 7 | Versão do contêiner Apache Tomcat exigida pelo pacote de implantação da aplicação. Este parâmetro torna-se inválido se PackageType estiver definido como Image. |
| Replicas | Integer | 10 | Número total de instâncias. |
| EdasContainerVersion | String | 3.5.3 | Versão do contêiner (como Ali-Tomcat) onde a aplicação High-speed Service Framework (HSF) é executada. |
| RunningInstances | Integer | 1 | Quantidade de instâncias em execução. |
| GroupType | Integer | 0 | Tipo do grupo. |
| ErrorCode | String | Este parâmetro é deixado vazio. | Código de erro.
|
| Code | String | 200 | Código de status HTTP. Valores válidos:
|
| Success | Boolean | true | Indica se as informações sobre os grupos de instâncias da aplicação foram obtidas. Valores válidos:
|
Exemplos
Exemplos de requisições
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
Exemplos de respostas de sucesso
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 erro
Para obter uma lista de códigos de erro, visite o Centro de Erros de API.