Creación por lotes de conjuntos de registros para líneas
Función
Esta API se utiliza para crear conjuntos de registros por lotes para líneas. Esta es una operación atómica. Si un parámetro no pasa la verificación, la creación falla. Solo se admiten zonas públicas.
Método de invocación
Para obtener más información, consulte Invocación a las API.
URI
POST /v2.1/zones/{zone_id}/recordsets/batch/lines
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 |
---|---|---|---|
name |
Sí |
String |
Sufijo FQDN 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. Se permite un máximo de 255 caracteres. |
type |
Sí |
String |
Tipo de conjunto de registros. El valor puede ser A, AAAA, MX, CNAME, TXT, NS, SRV o CAA. |
lines |
Sí |
Array of batchCreateRecordSetWithLine objects |
Línea de resolución. Puede crear un máximo de 50 conjuntos de registros. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
line |
Sí |
String |
ID de línea de resolución |
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 1. 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
Creación de un conjunto de registros A para varias líneas, con el tipo de línea establecido en default_view, el valor establecido de registro en 3.3.3.3, TTL en 300s y ponderación en 1
POST https://{endpoint}/zones/{zone_id}/recordsets/batch/lines { "name" : "www.example.com.", "description" : "This is an example record set.", "type" : "A", "lines" : [ { "line" : "default_view", "records" : [ "3.3.3.3" ], "ttl" : 300, "weight" : 1 } ] }
Ejemplo de respuestas
Código de estado: 200
Respuesta a la solicitud de creación de conjuntos de registros para líneas 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
Creación de un conjunto de registros A para varias líneas, con el tipo de línea establecido en default_view, el valor establecido de registro en 3.3.3.3, TTL en 300s y ponderación en 1
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 |
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 CreateRecordSetWithBatchLinesSolution { 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(); CreateRecordSetWithBatchLinesRequest request = new CreateRecordSetWithBatchLinesRequest(); CreateRSetBatchLinesReq body = new CreateRSetBatchLinesReq(); List<String> listLinesRecords = new ArrayList<>(); listLinesRecords.add("3.3.3.3"); List<BatchCreateRecordSetWithLine> listbodyLines = new ArrayList<>(); listbodyLines.add( new BatchCreateRecordSetWithLine() .withLine("default_view") .withTtl(300) .withWeight(1) .withRecords(listLinesRecords) ); body.withLines(listbodyLines); body.withType("A"); body.withDescription("This is an example record set."); body.withName("www.example.com."); request.withBody(body); try { CreateRecordSetWithBatchLinesResponse response = client.createRecordSetWithBatchLines(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
Creación de un conjunto de registros A para varias líneas, con el tipo de línea establecido en default_view, el valor establecido de registro en 3.3.3.3, TTL en 300s y ponderación en 1
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 |
# 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 = CreateRecordSetWithBatchLinesRequest() listRecordsLines = [ "3.3.3.3" ] listLinesbody = [ BatchCreateRecordSetWithLine( line="default_view", ttl=300, weight=1, records=listRecordsLines ) ] request.body = CreateRSetBatchLinesReq( lines=listLinesbody, type="A", description="This is an example record set.", name="www.example.com." ) response = client.create_record_set_with_batch_lines(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
Creación de un conjunto de registros A para varias líneas, con el tipo de línea establecido en default_view, el valor establecido de registro en 3.3.3.3, TTL en 300s y ponderación en 1
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 |
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.CreateRecordSetWithBatchLinesRequest{} var listRecordsLines = List<String>{ "3.3.3.3", } ttlLines:= int32(300) weightLines:= int32(1) var listLinesbody = []model.BatchCreateRecordSetWithLine{ { Line: "default_view", Ttl: &ttlLines, Weight: &weightLines, Records: listRecordsLines, }, } descriptionCreateRSetBatchLinesReq:= "This is an example record set." request.Body = &model.CreateRSetBatchLinesReq{ Lines: listLinesbody, Type: "A", Description: &descriptionCreateRSetBatchLinesReq, Name: "www.example.com.", } response, err := client.CreateRecordSetWithBatchLines(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 creación de conjuntos de registros para líneas por lotes |
Códigos de error
Consulte Códigos de error.