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 de um conjunto de registros

Função

Esta API é usada para modificar um conjunto de registros.

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

PUT /v2.1/zones/{zone_id}/recordsets/{recordset_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

zone_id

Sim

String

ID da zona

recordset_id

Sim

String

ID do conjunto de registros a ser consultado

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

name

Sim

String

Nome de domínio totalmente qualificado (FQDN) com sufixo com um nome de zona, que é um nome de host completo terminado com um ponto

description

Não

String

(Opcional) Descrição do nome de domínio. São permitidos no máximo 255 caracteres. Se este parâmetro for deixado em branco, o valor original é retido. É deixado em branco por padrão.

type

Sim

String

Tipo de conjunto de registros. O valor pode ser A, AAAA, MX, CNAME, TXT, NS, SRV ou CAA.

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.

records

Não

Array of strings

Valor do conjunto de registros. As regras de valor variam dependendo do tipo de conjunto de registros.

weight

Não

Integer

Peso do conjunto de registros. Se o weight não for especificado, nenhum peso será definido para o conjunto de registros. Se o weight for definido como 0, o conjunto de registros é secundário. Se o weight for maior que 0, o conjunto de recordes é primário. O valor varia de 0 a 100 e é deixado em branco por padrão.

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

id

String

ID do conjunto de registros

name

String

Nome do conjunto de registros

description

String

Descrição do conjunto de registros

zone_id

String

ID da zona do conjunto de registros

zone_name

String

Nome da zona do conjunto de registros

type

String

Tipo de conjunto de registros. O valor pode ser A, AAAA, MX, CNAME, TXT, NS, SRV ou CAA.

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.

records

Array of strings

Valor do conjunto de registos

created_at

String

Tempo de criação

updated_at

String

Hora da atualização

status

String

Status do recurso

default

Boolean

Se o conjunto de registros é criado por padrão. Um conjunto de registros padrão não pode ser excluído.

project_id

String

ID do projeto do conjunto de registros

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.

line

String

ID da linha de resolução

weight

Integer

Peso do conjunto de recordes

health_check_id

String

ID da verificação de integridade

alias_target

alias_target object

Alias de nome de domínio

Tabela 6 alias_target

Parâmetro

Tipo

Descrição

resource_type

String

Serviço que suporta aliases de nome de domínio.

Opções de valor:

  • cloudsite: CloudSite
  • waf: Web Application Firewall

resource_domain_name

String

Nome de domínio do serviço alvo

Exemplo de solicitações

{
  "name" : "www.example.com.",
  "description" : "This is an example record set.",
  "type" : "A",
  "ttl" : 3600,
  "records" : [ "192.168.10.1", "192.168.10.2" ],
  "weight" : 1
}

Exemplo de respostas

Código de status: 200

Resposta à solicitação de modificação de um conjunto de registros

{
  "id" : "2c9eb155587228570158722b6ac30007",
  "name" : "www.example.com.",
  "description" : "This is an example record set.",
  "type" : "A",
  "ttl" : 3600,
  "records" : [ "192.168.10.1", "192.168.10.2" ],
  "status" : "PENDING_UPDATE",
  "links" : {
    "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
  },
  "zone_id" : "2c9eb155587194ec01587224c9f90149",
  "zone_name" : "example.com.",
  "created_at" : "2016-11-17T12:03:17.827",
  "updated_at" : "2016-11-17T12:56:06.439",
  "default" : false,
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
  "line" : "default_view",
  "weight" : 1,
  "health_check_id" : null
}

Códigos de status

Código de status

Descrição

200

Resposta à solicitação de modificação de um conjunto de registros

Códigos de erro

Consulte Códigos de erro.