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 de várias linhas/ Modificação de conjuntos de registros em lote

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

Ver PDF

Modificação de conjuntos de registros em lote

Função

Esta API é usada para modificar conjuntos de registros em lote. Esta operação é atômica. Ela modifica todos os conjuntos de registros ou não modifica nenhum conjunto de registros. Somente zonas públicas são suportadas.

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

**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
recordsets	Sim	Array of batchUpdateRecordSet objects	Lista de configurações de registro

**Tabela 4** batchUpdateRecordSet
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	ID do conjunto de registros
description	Não	String	Descrição do conjunto de registros
ttl	Não	Integer	A duração do cache do conjunto de registros, em segundos. O valor varia de 300 a 2147483647. O valor padrão é 300.
weight	Não	Integer	Peso do recorde estabelecido. O valor padrão é null. Se weight for definido como null, nenhum peso será definido para o conjunto de registros. Se weight for definido como 0, o conjunto de registros é secundário. Se weight for maior que 0, o conjunto de recordes é primário. O valor varia de 0 a 100. Para conjuntos de registros com o mesmo nome de domínio, tipo e linha, as regras são as seguintes: - Definir pesos para todos os conjuntos de registros ou não definir nenhum peso.- Se nenhum peso é definido, apenas um conjunto de registros pode ser criado. - Quando um peso é definido, um máximo de 20 conjuntos de registros podem ser criados.
records	Sim	Array of strings	Valor do conjunto de registros. As regras de valor variam dependendo do tipo de conjunto de registros.

Parâmetros de resposta

Código de status: 200

**Tabela 5** Parâmetros de corpo de resposta
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.
recordsets	Array of QueryRecordSetWithLineResp objects	Lista de configurações de registro
metadata	metadata object	Número de recursos que atendem à condição de consulta

**Tabela 6** QueryRecordSetWithLineResp
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
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 de verificação de saúde
alias_target	alias_target object	alias de nome de domínio

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

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

**Tabela 9** metadata
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.

Exemplo de solicitações

{
  "recordsets" : [ {
    "id" : "2c9eb155587194ec01587224c9f9014a",
    "description" : "This is an type A record set.",
    "ttl" : 3600,
    "weight" : 10,
    "records" : [ "192.168.10.1", "192.168.10.2" ]
  }, {
    "id" : "2c9eb155587194ec01587224c9f9014c",
    "description" : "This is an type AAAA record set.",
    "ttl" : 300,
    "weight" : 5,
    "records" : [ "fe80:0:0:0:202:b3ff:fe1e:8329", "ff03:0db8:85a3:0:0:8a2e:0370:7334" ]
  } ]
}

Exemplo de respostas

Código de status: 200

Resposta à solicitação de modificação de conjuntos de registros em lote

{
  "links" : {
    "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/batch/lines"
  },
  "recordsets" : [ {
    "id" : "2c9eb155587228570158722b6ac30007",
    "name" : "www.example.com.",
    "description" : "This is an example record set.",
    "type" : "A",
    "ttl" : 300,
    "records" : [ "192.168.10.2", "192.168.10.1" ],
    "status" : "PENDING_CREATE",
    "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" : null,
    "health_check_id" : "e55c6f3dc4e34c8e86353b664ae0e89f",
    "default" : false,
    "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
    "line" : "default_view",
    "weight" : 0
  }, {
    "id" : "2c9eb155587228570158722b6ac30008",
    "name" : "www.example.com.",
    "description" : "This is an example record set.",
    "type" : "A",
    "ttl" : 300,
    "records" : [ "192.168.10.2", "192.168.10.1" ],
    "status" : "PENDING_CREATE",
    "links" : {
      "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30008"
    },
    "zone_id" : "2c9eb155587194ec01587224c9f90149",
    "zone_name" : "example.com.",
    "created_at" : "2016-11-17T12:03:17.827",
    "updated_at" : null,
    "health_check_id" : "e55c6f3dc4e34c8e86353b664ae0e89c",
    "default" : false,
    "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
    "line" : "Abroad",
    "weight" : 0
  } ],
  "metadata" : {
    "total_count" : 2
  }
}