Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2023-04-24 GMT+08:00

Consulta de registros PTR de um EIP

Função

Consulta de registros PTR de um EIP

Depuração

Você pode depurar esta API por meio da autenticação automática no API Explorer ou usar o código de exemplo do SDK gerado pelo API Explorer.

URI

GET /v2/reverse/floatingips

Tabela 1 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

marker

Não

String

Iniciar o ID do recurso da consulta de paginação. Se o parâmetro for deixado em branco, somente os recursos na primeira página serão consultados. É deixado em branco por padrão.

limit

Não

Integer

Número de recursos em cada página. O valor varia de 0 a 500. Os valores comumente usados são 10, 20 e 50. O valor padrão é 500.

offset

Não

Integer

Iniciar deslocamento da consulta de paginação A consulta começará a partir do próximo recurso do valor deslocamento.

O valor varia de 0 a 2147483647. O valor padrão é 0.

Se o marker não for deixado em branco, a consulta será iniciada a partir do recurso especificado pelo marker.

enterprise_project_id

Não

String

ID do projeto corporativo associado ao registro PTR. O valor contém no máximo 36 caracteres.

Valor padrão: 0

tags

Não

String

Tag de recurso.

O formato é o seguinte: chave1,valor1|chave2,valor2.

Várias tags são separadas por barra vertical (|). A chave e o valor de cada tag são separados por vírgula (,).

status

Não

String

Status do recurso

Parâmetros de solicitação

Tabela 2 Parâmetros do cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. Ele pode ser obtido pela chamada de uma API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

links

pageLink object

Link do recurso atual ou outros recursos relacionados. Quando uma resposta é dividida em páginas, um próximo link é fornecido para recuperar todos os resultados.

metadata

metadata object

Número de recursos que atendem à condição de consulta

floatingips

Array of ListPtrRecordsFloatingResp objects

Lista de IDs de registros PTR de um EIP

Tabela 4 metadata

Parâmetro

Tipo

Descrição

total_count

Integer

Número de recursos que atendem aos critérios de filtro. O número é irrelevante para limit ou offset.

Tabela 5 ListPtrRecordsFloatingResp

Parâmetro

Tipo

Descrição

id

String

ID de registro PTR, que está no formato {region}:{floatingip_id}

ptrdname

String

Nome de domínio do registro PTR

description

String

Descrição do registro PTR

ttl

Integer

Duração do cache do registro PTR (em segundos) em um servidor do DNS local. Quanto maior a duração, mais lenta a atualização terá efeito.

address

String

EIP

status

String

Status do recurso

action

String

Operação solicitada no recurso. Opções de valor: CREATE, UPDATE, DELETE, NONE, CREATE, UPDATE e DELETE****NONE: nenhuma operação será realizada.

links

pageLink object

Link do recurso atual ou outros recursos relacionados. Quando uma resposta é dividida em páginas, um próximo link é fornecido para recuperar todos os resultados.

tags

Array of tag objects

Tag de recurso

enterprise_project_id

String

ID do projeto corporativo associado ao registro PTR. O valor contém no máximo 36 caracteres.

Tabela 7 tag

Parâmetro

Tipo

Descrição

key

String

Chave da tag. Uma chave pode conter até 36 caracteres Unicode. Não pode ser deixada em branco. Um valor de tag não pode conter caracteres especiais (=*<>,|/) nem iniciar ou terminar com espaços.

value

String

Valor da tag. Um valor de tag contém no máximo 43 caracteres Unicode e pode ser deixado em branco. Um valor de tag não pode conter caracteres especiais (=*<>,|/) nem iniciar ou terminar com espaços.

Código de status: 400

Tabela 8 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

code

String

Código de erro

Mínimo: 8

Máximo: 36

message

String

Descrição

Mínimo: 2

Máximo: 512

Código de status: 500

Tabela 9 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

code

String

Código de erro

Mínimo: 8

Máximo: 36

message

String

Descrição

Mínimo: 2

Máximo: 512

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Resposta à solicitação de consulta da lista de registros PTR

{
  "links" : {
    "self" : "https://Endpoint/v2/reverse/floatingips",
    "next" : "https://Endpoint/v2/zones?id=&limit=1&marker=region_id:c5504932-bf23-4171-b655-b87a6bc59334"
  },
  "metadata" : {
    "total_count" : 1
  },
  "floatingips" : [ {
    "id" : "region_id:c5504932-bf23-4171-b655-b87a6bc59334",
    "ptrdname" : "www.example.com.",
    "description" : "Description for this PTR record",
    "address" : "10.154.52.138",
    "action" : "NONE",
    "ttl" : 300,
    "status" : "ACTIVE",
    "links" : {
      "self" : "https://Endpoint/v2/reverse/floatingips/region_id:c5504932-bf23-4171-b655-b87a6bc59334"
    }
  } ]
}

Códigos de status

Código de status

Descrição

200

Resposta à solicitação de consulta da lista de registros PTR

400

Resposta de erro

500

Resposta de erro

Códigos de erro

Consulte Códigos de erro.