Todos os produtos
Search
Central de documentação

Elastic Compute Service:DescribePortRangeLists

Última atualização: Sep 20, 2026

Consulta uma lista de listas de intervalos de portas.

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

ecs:DescribePortRangeLists

list

*PortRangeList.

acs:ecs:{#regionId}:{#accountId}:portrangelist/*

PortRangeList.

acs:ecs:{#regionId}:{#accountId}:portrangelist/{#portRangeListId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

NextToken

string

Não

O token de paginação. Defina este parâmetro como o valor NextToken retornado na chamada anterior a esta operação. Você não precisa definir este parâmetro para a primeira solicitação.

727d41872117f2816343eeb432fbc5bfd21dc824589d2a4be0b5e8707e68181f

MaxResults

integer

Não

O número de entradas por página para uma consulta paginada.

  • Valor máximo: 100.

  • Valor padrão: 10.

10

PortRangeListName

string

Não

O nome da lista de intervalos de portas. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. O nome não pode começar com http://, https://, com.aliyun ou com.alibabacloud. O nome pode conter letras, caracteres chineses, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).

AmostraNomeListaIntervalosPortas

PortRangeListId

array

Não

O ID da lista de intervalos de portas. Valores válidos de N: 0 a 100.

string

Não

O ID da lista de intervalos de portas.

prl-2ze9743****

ResourceGroupId

string

Não

O ID do grupo de recursos. Ao usar este parâmetro para filtrar recursos, a contagem de recursos não pode exceder 1.000. Você pode invocar ListResourceGroups para consultar a lista de grupos de recursos.

Nota

A filtragem pelo grupo de recursos padrão não é suportada.

rg-bp67acfmxazb4p****

Tag

array<object>

Não

As tags vinculadas à lista de intervalos de portas.

object

Não

As informações de par chave-valor da tag vinculada à lista de intervalos de portas.

Key

string

Não

A chave da tag da instância. Valores válidos de N: 1 a 20.

Se você usar uma única tag para filtrar recursos, a contagem de recursos com esta tag não pode exceder 1.000. Se você usar várias tags para filtrar recursos, a contagem de recursos que possuem todas as tags especificadas anexadas não pode exceder 1.000. Se a contagem de recursos exceder 1.000, chame ListTagResources para consultar os recursos.

chave para lista de intervalos de portas

Value

string

Não

O valor da tag.

valor para lista de intervalos de portas

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

NextToken

string

O token de paginação retornado nesta chamada. Se o valor de retorno estiver vazio, não há mais dados disponíveis.

AAAAAdDWBF2

RequestId

string

O ID da solicitação.

6040AD98-11C3-5F78-9346-FCA8E9D8960F

PortRangeLists

array<object>

As informações da lista de intervalos de portas.

array<object>

As informações da lista de intervalos de portas.

PortRangeListId

string

O ID da lista de intervalos de portas.

prl-2ze9743****

PortRangeListName

string

O nome da lista de intervalos de portas.

AmostraNomeListaIntervalosPortas

MaxEntries

integer

O número máximo de entradas suportadas pela lista de intervalos de portas.

20

AssociationCount

integer

O número de recursos associados.

1

Description

string

A descrição da lista de intervalos de portas.

Esta é a descrição

CreationTime

string

A hora em que a lista de intervalos de portas foi criada. A hora está no formato ISO 8601 e é exibida em UTC.

2024-12-04T07:11Z

ResourceGroupId

string

O ID do grupo de recursos ao qual a lista de intervalos de portas pertence.

rg-2zeg82g****

Tags

array<object>

As tags da lista de intervalos de portas.

object

As tags da lista de intervalos de portas.

TagKey

string

A chave da tag da lista de intervalos de portas.

ChaveTeste

TagValue

string

O valor da tag da lista de intervalos de portas.

ValorTeste

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "AAAAAdDWBF2",
  "RequestId": "6040AD98-11C3-5F78-9346-FCA8E9D8960F",
  "PortRangeLists": [
    {
      "PortRangeListId": "prl-2ze9743****",
      "PortRangeListName": "PortRangeListNameSample",
      "MaxEntries": 20,
      "AssociationCount": 1,
      "Description": "Esta é a descrição",
      "CreationTime": "2024-12-04T07:11Z",
      "ResourceGroupId": "rg-2zeg82g****",
      "Tags": [
        {
          "TagKey": "TestKey",
          "TagValue": "TestValue"
        }
      ]
    }
  ]
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 LimitExceed.PortRangeListId The specified number of PortRangeListId exceeds the limit. O número de IDs de catálogo de endereços de porta especificados excede o limite.
400 InvalidParameter The specified parameter is not valid. Os parâmetros da solicitação atual são inválidos. Tente novamente.
404 InvalidRegionId.NotFound The specified parameter RegionId is not valid. O RegionId especificado não existe. Verifique se o produto está disponível nesta região.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.