Eliminación por lotes de conjuntos de registros en una zona
Función
Esta API se utiliza para eliminar por lotes conjuntos de registros en una zona. Si los conjuntos de registros que se van a eliminar no existen, los conjuntos de registros se consideran eliminados de forma predeterminada. La respuesta solo contiene conjuntos de registros que realmente se han eliminado.
Método de invocación
Para obtener más información, consulte Invocación a las API.
URI
DELETE /v2.1/zones/{zone_id}/recordsets
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
zone_id |
Sí |
String |
ID de zona |
Parámetros 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ámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
recordset_ids |
Sí |
Array of strings |
Lista de ID de conjuntos de registros. Puede especificar un máximo de 100 ID. |
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripció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. |
recordsets |
Array of QueryRecordSetWithLineResp objects |
Lista de conjuntos de registros |
metadata |
metadata object |
Número de recursos que cumplen la condición de consulta |
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 establecido del registro |
created_at |
String |
Hora en la que se creó el conjunto de registros |
updated_at |
String |
Hora en la que se actualizó el conjunto de registros |
status |
String |
Estado del recurso |
default |
Boolean |
Si el conjunto de registros es generado por el sistema. No se puede eliminar un conjunto de registros generado por el sistema. |
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 |
bundle |
String |
Especificación, que es la especificación predeterminada. Este campo está reservado. |
Parámetro |
Tipo |
Descripción |
---|---|---|
self |
String |
Enlace al recurso actual |
next |
String |
Enlace a la página siguiente |
Ejemplo de solicitudes
Eliminación de conjuntos de registros agregados a una zona en lotes
DELETE https://{endpoint}/v2.1/zones/{zone_id}/recordsets { "recordset_ids" : [ "2c9eb155587194ec01587224c9f9014a", "2c9eb155587194ec01587224c9f9014c" ] }
Ejemplo de respuestas
Código de estado: 200
Respuesta a la solicitud de eliminación por lotes de conjuntos de registros en una zona
{ "links" : { "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets" }, "recordsets" : [ { "id" : "2c9eb155587194ec01587224c9f9014a", "name" : "example.com.", "type" : "A", "ttl" : 300, "records" : [ "1.1.1.1" ], "status" : "PENDING_DELETE", "links" : { "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014a" }, "zone_id" : "2c9eb155587194ec01587224c9f90149", "zone_name" : "example.com.", "created_at" : "2016-11-17T11:56:03.439", "updated_at" : "2016-11-17T11:56:06.439", "default" : false, "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c", "line" : "default_view", "weight" : null, "set_id" : null }, { "id" : "2c9eb155587194ec01587224c9f9014c", "name" : "1.example.com.", "type" : "A", "ttl" : 172800, "records" : [ "2.2.2.2" ], "status" : "PENDING_DELETE", "links" : { "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014c" }, "zone_id" : "2c9eb155587194ec01587224c9f90149", "zone_name" : "example.com.", "created_at" : "2016-11-17T11:56:03.439", "updated_at" : "2016-11-17T11:56:06.439", "default" : false, "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c", "line" : "default_view", "weight" : null, "set_id" : null } ], "metadata" : { "total_count" : 2 } }
Código de muestra del SDK
El código de ejemplo del SDK es el siguiente.
Java
Eliminación de conjuntos de registros agregados a una zona en lotes
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.dns.v2.region.DnsRegion; import com.huaweicloud.sdk.dns.v2.*; import com.huaweicloud.sdk.dns.v2.model.*; import java.util.List; import java.util.ArrayList; public class BatchDeleteRecordSetWithLineSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); DnsClient client = DnsClient.newBuilder() .withCredential(auth) .withRegion(DnsRegion.valueOf("cn-north-4")) .build(); BatchDeleteRecordSetWithLineRequest request = new BatchDeleteRecordSetWithLineRequest(); BatchDeleteRecordSetWithLineRequestBody body = new BatchDeleteRecordSetWithLineRequestBody(); List<String> listbodyRecordsetIds = new ArrayList<>(); listbodyRecordsetIds.add("2c9eb155587194ec01587224c9f9014a"); listbodyRecordsetIds.add("2c9eb155587194ec01587224c9f9014c"); body.withRecordsetIds(listbodyRecordsetIds); request.withBody(body); try { BatchDeleteRecordSetWithLineResponse response = client.batchDeleteRecordSetWithLine(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } |
Python
Eliminación de conjuntos de registros agregados a una zona en lotes
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
# coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkdns.v2.region.dns_region import DnsRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkdns.v2 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.getenv("CLOUD_SDK_AK") sk = os.getenv("CLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) \ client = DnsClient.new_builder() \ .with_credentials(credentials) \ .with_region(DnsRegion.value_of("cn-north-4")) \ .build() try: request = BatchDeleteRecordSetWithLineRequest() listRecordsetIdsbody = [ "2c9eb155587194ec01587224c9f9014a", "2c9eb155587194ec01587224c9f9014c" ] request.body = BatchDeleteRecordSetWithLineRequestBody( recordset_ids=listRecordsetIdsbody ) response = client.batch_delete_record_set_with_line(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) |
Go
Eliminación de conjuntos de registros agregados a una zona en lotes
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" dns "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dns/v2" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dns/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dns/v2/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := dns.NewDnsClient( dns.DnsClientBuilder(). WithRegion(region.ValueOf("cn-north-4")). WithCredential(auth). Build()) request := &model.BatchDeleteRecordSetWithLineRequest{} var listRecordsetIdsbody = []string{ "2c9eb155587194ec01587224c9f9014a", "2c9eb155587194ec01587224c9f9014c", } request.Body = &model.BatchDeleteRecordSetWithLineRequestBody{ RecordsetIds: listRecordsetIdsbody, } response, err := client.BatchDeleteRecordSetWithLine(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } |
Más información
Para obtener un código de ejemplo del SDK de más lenguajes de programación, consulta la pestaña Código de ejemplo en Explorador de API. El código de ejemplo del SDK se puede generar automáticamente.
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
Respuesta a la solicitud de eliminación por lotes de conjuntos de registros en una zona |
Códigos de error
Consulte Códigos de error.