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

Modificação do registro PTR de um EIP

Função

Esta API é usada para modificar o registro 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

PATCH /v2/reverse/floatingips/{region}:{floatingip_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

region

Sim

String

Região da zona

floatingip_id

Sim

String

ID do registro PTR a ser modificado

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.

Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

ptrdname

Sim

String

Nome de domínio do registro PTR

description

Não

String

Descrição do registro PTR

ttl

Não

Integer

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

tags

Não

Array of tag objects

Tag de recurso

Tabela 4 tag

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

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

Não

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.

Parâmetros de resposta

Código de status: 200

Tabela 5 Parâmetros de corpo de resposta

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 armazenamento em cache do conjunto de registros (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.

Exemplo de solicitações

{
  "ptrdname" : "www.example.com",
  "description" : "Description for this PTR record",
  "ttl" : 300
}

Exemplo de respostas

Código de status: 200

Resposta à solicitação de modificação do registro PTR de um EIP

{
  "id" : "region_id:c5504932-bf23-4171-b655-b87a6bc59334",
  "ptrdname" : "www.example.com.",
  "description" : "Description for this PTR record",
  "address" : "10.154.52.138",
  "action" : "CREATE",
  "ttl" : 300,
  "status" : "PENDING_CREATE",
  "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 modificação do registro PTR de um EIP

Códigos de erro

Consulte Códigos de erro.