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
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
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
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 |
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. |
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. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
self |
String |
Link para o recurso atual |
next |
String |
Link para a próxima página |
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
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
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.