Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Domain Name Service/ Referencia de la API/ Las API/ Gestión de conjuntos de registros multilínea/ Creación de un conjunto de registros

Actualización más reciente 2023-04-24 GMT+08:00

Ver PDF

Creación de un conjunto de registros

Función

Esta API se utiliza para crear un conjunto de registros. Esta API solo se aplica a las zonas públicas.

Depuración

Puede depurar esta API mediante la autenticación automática en API Explorer o usar el código de ejemplo del SDK generado por API Explorer.

URI

POST /v2.1/zones/{zone_id}/recordsets

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
zone_id	Sí	String	ID de zona

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener mediante invocación a una API de IAM. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Nombre de dominio completo (FQDN) con sufijo con un nombre de zona, que es un nombre de host completo terminado con un punto
description	No	String	(Opcional) Descripción del nombre de dominio
type	Sí	String	Tipo de conjunto de registros. El valor puede ser A, AAAA, MX, CNAME, TXT, NS, SRV o CAA.
status	No	String	Estado del conjunto de regsitros. El valor predeterminado es ENABLE.
ttl	No	Integer	Duración del almacenamiento en caché del conjunto de registros (en segundos) en un servidor DNS local. Cuanto más larga sea la duración, más lenta será la actualización.
records	No	Array of strings	Valor del conjunto de registros. Las reglas de valor varían dependiendo del tipo de conjunto de registros.
line	No	String	ID de línea de resolución
tags	No	Array of tag objects	Etiqueta del recurso
weight	No	Integer	Ponderación del conjunto de registros
alias_target	No	alias_target object	Alias de nombre de dominio

**Tabla 4** tag
Parámetro	Obligatorio	Tipo	Descripción
key	Sí	String	Clave de etiqueta. Una clave puede contener hasta 36 caracteres de Unicode. No se puede dejar en blanco. Un valor de etiqueta no puede contener caracteres especiales (=*<>,\|/) ni empezar o terminar con espacios.
value	No	String	Valor de la etiqueta. Un valor de etiqueta contiene un máximo de 43 caracteres de Unicode y se puede dejar en blanco. Un valor de etiqueta no puede contener caracteres especiales (=*<>,\|/) ni empezar o terminar con espacios.

**Tabla 5** alias_target
Parámetro	Obligatorio	Tipo	Descripción
resource_type	No	String	Servicio que admite alias de nombres de dominio. Opciones de valor: cloudsite: CloudSite waf: Web Application Firewall
resource_domain_name	No	String	Nombre de dominio del servicio de destino

Parámetros de respuesta

Código de estado: 200

**Tabla 6** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
id	String	ID de conjunto de registros
name	String	Nombre del conjunto de registros
description	String	Descripción del conjunto de registros
zone_id	String	ID de zona del conjunto de registros
zone_name	String	Nombre de la zona del conjunto de registros
type	String	Tipo de conjunto de registros. El valor puede ser A, AAAA, MX, CNAME, TXT, NS, SRV o CAA.
ttl	Integer	Duración del almacenamiento en caché del conjunto de registros (en segundos) en un servidor DNS local. Cuanto más larga sea la duración, más lenta será la actualización.
records	Array of strings	Valor de conjunto de registro
created_at	String	Hora de creación
updated_at	String	Hora de actualización
status	String	Estado del recurso
default	Boolean	Si el conjunto de registros se crea de forma predeterminada. No se puede eliminar un conjunto de registros predeterminado.
project_id	String	ID de proyecto del conjunto de registros
links	pageLink object	Enlace del recurso actual u otros recursos relacionados. Cuando una respuesta se divide en páginas, se proporciona un siguiente enlace para recuperar todos los resultados.
line	String	ID de línea de resolución
weight	Integer	Ponderación del conjunto de registros
health_check_id	String	ID de comprobación de estado
alias_target	alias_target object	Alias de nombre de dominio

**Tabla 7** pageLink
Parámetro	Tipo	Descripción
self	String	Enlace al recurso actual
next	String	Enlace a la página siguiente

**Tabla 8** alias_target
Parámetro	Tipo	Descripción
resource_type	String	Servicio que admite alias de nombres de dominio. Opciones de valor: cloudsite: CloudSite waf: Web Application Firewall
resource_domain_name	String	Nombre de dominio del servicio de destino

Solicitudes de ejemplo

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

Ejemplo de respuestas

Código de estado: 200

Respuesta a la solicitud de creación de un 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.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
  },
  "zone_id" : "2c9eb155587194ec01587224c9f90149",
  "zone_name" : "example.com.",
  "created_at" : "2016-11-17T12:03:17.827",
  "updated_at" : null,
  "default" : false,
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
  "line" : "default_view",
  "weight" : 1,
  "health_check_id" : null
}