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.

Central de ajuda/ Domain Name Service/ Referência de API/ APIs/ Gerenciamento de registros PTR/ Modificação do registro PTR de um EIP

Atualizado em 2025-08-19 GMT+08:00

Ver PDF

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 Chamada das API 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.

**Tabela 6** pageLink
Parâmetro	Tipo	Descrição
self	String	Link para o recurso atual
next	String	Link para a próxima página

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"
  }
}