Todos os produtos
Search
Central de documentação

Serverless App Engine:DescribeApplicationGroups

Última atualização: Jun 28, 2026

Obtém grupos de instâncias de aplicativo usando DescribeApplicationGroups.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

sae:DescribeApplicationGroups

get

*All Resource

*

Nenhuma Nenhuma

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

AppId

string

Sim

O ID do aplicativo.

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

CurrentPage

integer

Não

O número da página a ser retornada.

1

PageSize

integer

Não

O número de entradas por página.

10

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

Message

string

A mensagem retornada.

success

TraceId

string

O ID de rastreamento usado para consultar os detalhes de uma solicitação.

0a98a02315955564772843261e****

Data

array<object>

Uma lista de grupos de aplicativos.

object

Jdk

string

A versão do JDK exigida pelo pacote de implantação. Este parâmetro não é suportado quando o tipo de pacote é definido como Image.

Open JDK 8

ImageUrl

string

A URL da imagem. Este parâmetro é obrigatório quando o tipo de pacote é definido como Image.

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

PackageUrl

string

A URL do pacote de implantação. Este parâmetro é obrigatório quando o tipo de pacote é definido como FatJar, War ou PhpZip.

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

PackageType

string

O tipo do pacote de implantação. Valores válidos:

  • Para aplicativos Java, os tipos suportados são FatJar, War e Image.

  • Para aplicativos PHP, os tipos suportados são:

    • 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

Image

PackageVersion

string

A versão do pacote de implantação. Este parâmetro é obrigatório quando o tipo de pacote é definido como FatJar, War ou PhpZip. Este parâmetro é gerado automaticamente se você implantar o aplicativo usando uma imagem.

1.0.0

PackageVersionId

string

O ID da versão do pacote de implantação.

GroupName

string

O nome do grupo de aplicativos.

_DEFAULT_GROUP

GroupId

string

O ID do grupo de aplicativos.

b2a8a925-477a-eswa-b823-d5e22500****

WebContainer

string

A versão do contêiner Tomcat exigida pelo pacote de implantação. Este parâmetro não é suportado quando o tipo de pacote é definido como Image.

Apache Tomcat 7

Replicas

integer

O número total de instâncias.

10

EdasContainerVersion

string

A versão do ambiente de tempo de execução do aplicativo no High-Speed Service Framework (HSF), como um contêiner Ali-Tomcat.

3.5.3

RunningInstances

integer

O número de instâncias em execução.

1

GroupType

integer

O tipo do grupo de aplicativos.

0

ErrorCode

string

O código de erro.

  • Este parâmetro não é retornado se a solicitação for bem-sucedida.

  • Este parâmetro é retornado se a solicitação falhar. Para mais informações, consulte a seção de códigos de erro.

Code

string

O código de status HTTP ou o código de erro POP. Valores válidos:

  • 2xx: A solicitação é bem-sucedida.

  • 3xx: A solicitação é redirecionada.

  • 4xx: A solicitação é inválida.

  • 5xx: Ocorre um erro de servidor.

200

Success

boolean

Indica se os grupos de aplicativos foram obtidos com sucesso. Valores válidos:

  • true: Os grupos de aplicativos foram obtidos.

  • false: Os grupos de aplicativos não foram obtidos.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "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",
      "PackageVersionId": "",
      "GroupName": "_DEFAULT_GROUP",
      "GroupId": "b2a8a925-477a-eswa-b823-d5e22500****",
      "WebContainer": "Apache Tomcat 7",
      "Replicas": 10,
      "EdasContainerVersion": "3.5.3",
      "RunningInstances": 1,
      "GroupType": 0
    }
  ],
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.