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 zonas privadas> Eliminación de una zona privada

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

Ver PDF

Eliminación de una zona privada

Función

Esta API se utiliza para eliminar una zona privada.

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

DELETE /v2/zones/{zone_id}

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
zone_id	Sí	String	ID de la zona que se va a eliminar

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.

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
id	String	ID de zona, que es un UUID utilizado para identificar la zona
name	String	Nombre de la zona
description	String	Descripción de la zona
email	String	Dirección de correo electrónico del administrador de la zona
zone_type	String	Tipo de zona. El valor puede ser public o private.
ttl	Integer	Valor de TTL del registro de SOA establecido en la zona
serial	Integer	Número de secuencia utilizado para identificar cambios en el archivo de zona en el conjunto de registros de SOA de la zona. El número de secuencia se utiliza para la sincronización entre los nodos maestro y esclavo.
status	String	Estado
record_num	Integer	Número de conjuntos de registros en la zona
pool_id	String	ID de grupo de la zona, que es asignado por el sistema
project_id	String	ID del proyecto de la zona
created_at	String	Hora de creación
updated_at	String	Hora de actualización
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.
masters	Array of strings	Servidores de DNS maestros, de los cuales los servidores esclavos obtienen información de DNS
routers	Array of RouterWithStatus objects	Lista de las VPC asociadas a la zona

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

**Tabla 5** RouterWithStatus
Parámetro	Tipo	Descripción
status	String	Estado del recurso
router_id	String	ID de la VPC asociada a la zona
router_region	String	Región de la VPC

Código de estado: 400

**Tabla 6** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
code	String	Código de error Mínimo: 8 Máximo: 36
message	String	Descripción Mínimo: 2 Máximo: 512

Código de estado: 404

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
code	String	Código de error Mínimo: 8 Máximo: 36
message	String	Descripción Mínimo: 2 Máximo: 512

Código de estado: 500

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
code	String	Código de error Mínimo: 8 Máximo: 36
message	String	Descripción Mínimo: 2 Máximo: 512

Solicitudes de ejemplo

Ninguna

Ejemplo de respuestas

Código de estado: 200

Respuesta a la solicitud de eliminación de una zona privada

{
  "id" : "ff8080825b8fc86c015b94bc6f8712c3",
  "name" : "example.com.",
  "description" : "This is an example zone.",
  "email" : "xx@example.com",
  "ttl" : 300,
  "serial" : 1,
  "masters" : [ ],
  "status" : "PENDING_DELETE",
  "links" : {
    "self" : "https://Endpoint/v2/zones/ff8080825b8fc86c015b94bc6f8712c3"
  },
  "pool_id" : "ff8080825ab738f4015ab7513298010e",
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
  "zone_type" : "private",
  "created_at" : "2017-04-22T10:05:23.110",
  "updated_at" : "2017-04-22T10:05:23.959",
  "record_num" : 0,
  "routers" : [ {
    "status" : "ACTIVE",
    "router_id" : "19664294-0bf6-4271-ad3a-94b8c79c6558",
    "router_region" : "xx"
  }, {
    "status" : "ACTIVE",
    "router_id" : "f0791650-db8c-4a20-8a44-a06c6e24b15b",
    "router_region" : "xx"
  } ]
}