Todos os produtos
Search
Central de documentação

AnalyticDB:DescribeDBInstanceIPArrayList

Última atualização: Jun 29, 2026

Consulta as listas de permissões de endereços IP que têm acesso permitido a uma instância do AnalyticDB for PostgreSQL.

Descrição da operação

Você pode chamar esta operação para consultar as listas de permissões de endereços IP que têm acesso permitido a uma instância do AnalyticDB for PostgreSQL.

Limites

Você pode chamar esta operação até 1.000 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, o throttling será acionado. Como resultado, seus negócios podem ser afetados. Recomendamos que você observe o limite ao chamar esta operação.

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

gpdb:DescribeDBInstanceIPArrayList

get

*DBInstance

acs:gpdb:*:{#accountId}:dbinstance/{#DBInstanceId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ResourceGroupId

string

Não

O ID do grupo de recursos ao qual a instância pertence. Para informações sobre como obter o ID de um grupo de recursos, consulte Exibir informações básicas de um grupo de recursos.

null

DBInstanceId

string

Sim

O ID da instância.

Nota

Você pode chamar a operação DescribeDBInstances para consultar detalhes sobre todas as instâncias do AnalyticDB for PostgreSQL em uma região, incluindo IDs de instâncias.

gp-bp***************

DBInstanceIPArrayName

string

Não

O nome da lista de permissões de endereços IP. Se você não especificar este parâmetro, a lista de permissões padrão será consultada.

Nota

Cada instância suporta até 50 listas de permissões de endereços IP.

Default

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

CB7AA0BF-BE41-480E-A3DC-C97BF85A391B

Items

object

DBInstanceIPArray

array<object>

As listas de permissões de endereços IP consultadas.

object

DBInstanceIPArrayName

string

The name of the IP address whitelist.

Default

SecurityIPList

string

The IP addresses listed in the whitelist. Up to 1,000 IP addresses are contained in a whitelist and separated by commas (,). The IP addresses must use one of the following formats:

  • 0.0.0.0/0

  • 10.23.12.24. This is a standard IP address.

  • 10.23.12.24/24. This is a CIDR block. The value /24 indicates that the prefix of the CIDR block is 24-bit long. You can replace 24 with a value in the range of 1 to 32.

127.0.0.1

DBInstanceIPArrayAttribute

string

The attribute of the IP address whitelist. By default, this parameter is empty. A whitelist with the hidden attribute is not displayed in the console.

hidden

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CB7AA0BF-BE41-480E-A3DC-C97BF85A391B",
  "Items": {
    "DBInstanceIPArray": [
      {
        "DBInstanceIPArrayName": "Default",
        "SecurityIPList": "127.0.0.1",
        "DBInstanceIPArrayAttribute": "hidden"
      }
    ]
  }
}

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.