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> Consulta de un conjunto de registros

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

Ver PDF

Consulta de un conjunto de registros

Función

Esta API se utiliza para consultar un conjunto de registros.

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

GET /v2/zones/{zone_id}/recordsets/{recordset_id}

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
zone_id	Sí	String	ID de zona Mínimo: 32 Máximo: 36
recordset_id	Sí	String	ID del conjunto de registros que se va a consultar Mínimo: 32 Máximo: 36

Parámetros de solicitud

Ninguna

Parámetros de respuesta

Código de estado: 200

**Tabla 2** 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
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
create_at	String	Hora de creación
update_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.

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

Solicitudes de ejemplo

Ninguna

Ejemplo de respuestas

Código de estado: 200

Respuesta a la solicitud de consulta 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.2", "192.168.10.1" ],
  "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" : "2016-11-17T12:03:18.827",
  "default" : false,
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c"
}