Modificación por lotes de conjuntos de registros
Función
Esta API se utiliza para modificar conjuntos de registros por lotes. Esta operación es atómica. Modifica todos los conjuntos de registros o no modifica ningún conjunto de registros. Solo se admiten zonas públicas.
Método de invocación
Para obtener más información, consulte Invocación a las API.
URI
PUT /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 |
---|---|---|---|
recordsets |
Sí |
Array of batchUpdateRecordSet objects |
Lista de conjuntos de registros |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
id |
Sí |
String |
ID de conjunto de registros |
description |
No |
String |
Descripción del conjunto de registros |
ttl |
No |
Integer |
Duración del almacenamiento en caché del conjunto de registros, en segundos. El valor oscila entre 300 y 2147483647. El valor predeterminado es 300. |
weight |
No |
Integer |
Ponderación del conjunto de registros. El valor predeterminado es null. Si weight se establece en null, no se establece ninguna ponderación para el conjunto de registros. Si weight se ajusta a 0, el conjunto de registros es secundario. Si weight es mayor que 0, el conjunto de registros es uno primario. El valor oscila entre 0 y 100. Para los conjuntos de registros con el mismo nombre de dominio, tipo y línea, las reglas son las siguientes: - Establecer pondraciones para todos los conjuntos de registros o no establecer ningún peso. - Si no se establece ninguna ponderación, solo se puede crear un conjunto de registros. - Cuando se establece una ponderación, se puede crear un máximo de 20 conjuntos de registros. |
records |
Sí |
Array of strings |
Valor del conjunto de registros. Las reglas de valor varían dependiendo del tipo de conjunto de registros. |
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
Modificación de conjuntos de registros por lotes, con el TTL del conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014a) establecido en 3600s, valor a 192.168.10.1 y 192.168.10.2, y ponderación a 10, y el TTL de otro conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014c) a 300s, valor a fe80:0:0:0:202:b3ff:fe1e:8329 y ff03:0db8:85a3:0:0:8a2e:0370. 7334, y ponderación a 5
PUT https://{endpoint}/v2.1/zones/{zone_id}/recordsets { "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" ] } ] }
Ejemplo de respuestas
Código de estado: 200
Respuesta a la solicitud de conjuntos de registros de modificación por lotes
{ "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 } }
Código de muestra del SDK
El código de ejemplo del SDK es el siguiente.
Java
Modificación de conjuntos de registros por lotes, con el TTL del conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014a) establecido en 3600s, valor a 192.168.10.1 y 192.168.10.2, y ponderación a 10, y el TTL de otro conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014c) a 300s, valor a fe80:0:0:0:202:b3ff:fe1e:8329 y ff03:0db8:85a3:0:0:8a2e:0370.7334, and weight to 5
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 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
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 BatchUpdateRecordSetWithLineSolution { 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(); BatchUpdateRecordSetWithLineRequest request = new BatchUpdateRecordSetWithLineRequest(); BatchUpdateRecordSetWithLineReq body = new BatchUpdateRecordSetWithLineReq(); List<String> listRecordsetsRecords = new ArrayList<>(); listRecordsetsRecords.add("fe80:0:0:0:202:b3ff:fe1e:8329"); listRecordsetsRecords.add("ff03:0db8:85a3:0:0:8a2e:0370:7334"); List<String> listRecordsetsRecords1 = new ArrayList<>(); listRecordsetsRecords1.add("192.168.10.1"); listRecordsetsRecords1.add("192.168.10.2"); List<BatchUpdateRecordSet> listbodyRecordsets = new ArrayList<>(); listbodyRecordsets.add( new BatchUpdateRecordSet() .withId("2c9eb155587194ec01587224c9f9014a") .withDescription("This is an type A record set.") .withTtl(3600) .withWeight(10) .withRecords(listRecordsetsRecords1) ); listbodyRecordsets.add( new BatchUpdateRecordSet() .withId("2c9eb155587194ec01587224c9f9014c") .withDescription("This is an type AAAA record set.") .withTtl(300) .withWeight(5) .withRecords(listRecordsetsRecords) ); body.withRecordsets(listbodyRecordsets); request.withBody(body); try { BatchUpdateRecordSetWithLineResponse response = client.batchUpdateRecordSetWithLine(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
Modificación de conjuntos de registros por lotes, con el TTL del conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014a) establecido en 3600s, valor a 192.168.10.1 y 192.168.10.2, y ponderación a 10, y el TTL de otro conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014c) a 300s, valor a fe80:0:0:0:202:b3ff:fe1e:8329 y ff03:0db8:85a3:0:0:8a2e:0370.7334, and weight to 5
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 54 55 56 |
# 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 = BatchUpdateRecordSetWithLineRequest() listRecordsRecordsets = [ "fe80:0:0:0:202:b3ff:fe1e:8329", "ff03:0db8:85a3:0:0:8a2e:0370:7334" ] listRecordsRecordsets1 = [ "192.168.10.1", "192.168.10.2" ] listRecordsetsbody = [ BatchUpdateRecordSet( id="2c9eb155587194ec01587224c9f9014a", description="This is an type A record set.", ttl=3600, weight=10, records=listRecordsRecordsets1 ), BatchUpdateRecordSet( id="2c9eb155587194ec01587224c9f9014c", description="This is an type AAAA record set.", ttl=300, weight=5, records=listRecordsRecordsets ) ] request.body = BatchUpdateRecordSetWithLineReq( recordsets=listRecordsetsbody ) response = client.batch_update_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
Modificación de conjuntos de registros por lotes, con el TTL del conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014a) establecido en 3600s, valor a 192.168.10.1 y 192.168.10.2, y ponderación a 10, y el TTL de otro conjunto de registros (ID: 2c9eb155587194ec01587224c9f9014c) a 300s, valor a fe80:0:0:0:202:b3ff:fe1e:8329 y ff03:0db8:85a3:0:0:8a2e:0370.7334, and weight to 5
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 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 |
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.BatchUpdateRecordSetWithLineRequest{} var listRecordsRecordsets = []string{ "fe80:0:0:0:202:b3ff:fe1e:8329", "ff03:0db8:85a3:0:0:8a2e:0370:7334", } var listRecordsRecordsets1 = []string{ "192.168.10.1", "192.168.10.2", } descriptionRecordsets:= "This is an type A record set." ttlRecordsets:= int32(3600) weightRecordsets:= int32(10) descriptionRecordsets1:= "This is an type AAAA record set." ttlRecordsets1:= int32(300) weightRecordsets1:= int32(5) var listRecordsetsbody = []model.BatchUpdateRecordSet{ { Id: "2c9eb155587194ec01587224c9f9014a", Description: &descriptionRecordsets, Ttl: &ttlRecordsets, Weight: &weightRecordsets, Records: listRecordsRecordsets1, }, { Id: "2c9eb155587194ec01587224c9f9014c", Description: &descriptionRecordsets1, Ttl: &ttlRecordsets1, Weight: &weightRecordsets1, Records: listRecordsRecordsets, }, } request.Body = &model.BatchUpdateRecordSetWithLineReq{ Recordsets: listRecordsetsbody, } response, err := client.BatchUpdateRecordSetWithLine(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 conjuntos de registros de modificación por lotes |
Códigos de error
Consulte Códigos de error.