Todos os produtos
Search
Central de documentação

Resource Management:ListResources

Última atualização: Oct 16, 2026

Consulta os recursos nos grupos de recursos acessíveis à conta atual.

Descrição da operação

Nota

Esta API pode ser chamada assumindo uma função RAM, mas as políticas de sessão para a função não são suportadas.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ResourceGroupId

string

Não

O ID do grupo de recursos.

rg-uPJpP****

Service

string

Não

O código do serviço de nuvem.

Você pode obter o código na coluna Código do serviço de nuvem em Serviços de nuvem que suportam grupos de recursos.

ecs

Region

string

Não

O ID da região.

cn-hangzhou

ResourceType

string

Não

O tipo de recurso.

Você pode obter o tipo de recurso na coluna Tipo de recurso em Serviços de nuvem que suportam grupos de recursos.

instance

ResourceId

string

Não

O ID do recurso.

i-23v38****

PageNumber

integer

Não

O número da página.

Valor mínimo: 1. Valor padrão: 1.

1

PageSize

integer

Não

O número de entradas por página.

Valores válidos: 1 a 100. Valor padrão: 10.

10

Count

boolean

Não

Especifica se deve ser consultado o número total de recursos. Valor padrão: true. Valores válidos:

  • true: Consulta o número total de recursos e retorna o valor no parâmetro TotalCount.

  • false: Não consulta o número total de recursos. O parâmetro TotalCount retorna -1 e a lista de recursos ainda é retornada em páginas com base nos parâmetros PageNumber e PageSize.

ResourceTypes

array<object>

Não

A lista de tipos de recursos. Há suporte para no máximo 50 tipos de recursos.

Nota

Se você especificar as configurações de ResourceTypes, os parâmetros de solicitação Service e ResourceType especificados separadamente não entrarão em vigor.

object

Não

A lista de tipos de recursos.

ResourceType

string

Não

O tipo de recurso.

Valores válidos de N: 1 a 50.

Você pode obter o tipo de recurso na coluna Tipo de recurso em Serviços de nuvem que suportam grupos de recursos.

Nota

Os parâmetros Service e ResourceType em ResourceTypes devem ser especificados ao mesmo tempo. Caso contrário, eles não entrarão em vigor.

instance

Service

string

Não

O código do serviço de nuvem.

Valores válidos de N: 1 a 50.

Você pode obter o código na coluna Código do serviço de nuvem em Serviços de nuvem que suportam grupos de recursos.

Nota

Os parâmetros Service e ResourceType em ResourceTypes devem ser especificados ao mesmo tempo. Caso contrário, eles não entrarão em vigor.

ecs

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

PageNumber

integer

O número da página.

1

PageSize

integer

O número de entradas por página.

10

RequestId

string

O ID da solicitação.

04F0F334-1335-436C-A1D7-6C044FE73368

Resources

object

Resource

array<object>

As informações do recurso.

object

As informações do recurso.

CreateDate

string

A hora em que o recurso foi criado. A hora é exibida em UTC.

2015-01-23T12:33:18Z

RegionId

string

O ID da região.

cn-hangzhou

ResourceGroupId

string

O ID do grupo de recursos.

rg-uPJpP****

ResourceId

string

O ID do recurso.

i-23v38****

ResourceType

string

O tipo de recurso.

instance

Service

string

O código do serviço de nuvem.

ecs

TotalCount

integer

O número total de entradas.

1

Exemplos

Resposta de sucesso

JSON formato

{
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "Resources": {
    "Resource": [
      {
        "CreateDate": "2015-01-23T12:33:18Z",
        "RegionId": "cn-hangzhou",
        "ResourceGroupId": "rg-uPJpP****",
        "ResourceId": "i-23v38****",
        "ResourceType": "instance",
        "Service": "ecs"
      }
    ]
  },
  "TotalCount": 1
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.ResourceIds The ResourceIds is invalid. O parâmetro ResourceIds é inválido.
400 LimitExceeded.ResourceIds The maximum number of ResourceId is exceeded. O número de valores de ResourceId excede o limite.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.