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 conjuntos de registros/ Criação de um conjunto de registros

Atualizado em 2023-04-24 GMT+08:00

Ver PDF

Criação de um conjunto de registros

Função

Esta API é usada para criar 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

POST /v2/zones/{zone_id}/recordsets

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
zone_id	Sim	String	ID da zona

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. O valor consiste em um máximo de 255 caracteres. Este parâmetro é deixado vazio por padrão.
type	Sim	String	Tipo de conjunto de registros. O valor pode ser A, AAAA, MX, CNAME, TXT, NS, SRV ou CAA.
status	Não	String	Status do recurso
ttl	Não	Integer	Duração do 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. Se o endereço de serviço mudar com frequência, configure TTL para um valor menor.
records	Sim	Array of strings	Valor do conjunto de registros. As regras de valor variam dependendo do tipo de conjunto de registros.
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 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 (somente em zonas públicas), SRV ou CAA (somente em zonas públicas).
ttl	Integer	Duração do 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. Se o endereço de serviço mudar com frequência, configure TTL para um valor menor.
records	Array of strings	Valor do conjunto de registos
create_at	String	Hora em que o conjunto de registros foi criado. Formato: aaaa-MM-dd'T'HH:mm:ss.SSS
update_at	String	Hora em que o conjunto de registros foi atualizado. Formato: aaaa-MM-dd'T'HH:mm:ss.SSS
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.

**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

{
  "name" : "www.example.com.",
  "description" : "This is an example record set.",
  "type" : "A",
  "ttl" : 3600,
  "records" : [ "192.168.10.1", "192.168.10.2" ],
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  } ]
}

Exemplo de respostas

Código de status: 200

Resposta para criação de um conjunto de registros

{
  "id" : "2c9eb155587228570158722b6ac30007",
  "name" : "www.example.com.",
  "description" : "This is an example record set.",
  "type" : "A",
  "ttl" : 300,
  "records" : [ "192.168.10.1", "192.168.10.2" ],
  "status" : "PENDING_CREATE",
  "links" : {
    "self" : "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
  },
  "zone_id" : "2c9eb155587194ec01587224c9f90149",
  "zone_name" : "example.com.",
  "create_at" : "2016-11-17T12:03:17.827",
  "update_at" : null,
  "default" : false,
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c"
}