BatchAddDcdnDomain - Edge Security Acceleration - Centro de documentación de Alibaba Cloud

Llama a `BatchAddDcdnDomain` para agregar varios nombres de dominio.

Descripción de la operación

Requisitos previos:

Debe activar DCDN antes de agregar un nombre de dominio acelerado.
Si selecciona Solo China continental o Global como región de aceleración, el nombre de dominio acelerado debe tener un registro ICP válido.
Debe completar la verificación de propiedad del dominio cuando agrega un nombre de dominio a Alibaba Cloud DCDN por primera vez. Para obtener más información, consulte VerifyDcdnDomainOwner.
Solo puede agregar un nombre de dominio acelerado por llamada. Cada usuario tiene una cuota predeterminada de 50 nombres de dominio. Para agregar más, envíe una solicitud en Quota Center.
Cada usuario puede llamar a esta operación hasta 100 veces por hora.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dcdn:BatchAddDcdnDomain

create

*Domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DomainName	string	Sí	Los nombres de dominio que se van a acelerar con DCDN. Puede especificar hasta 20 nombres de dominio, separados por comas.	example.com,example.org
ResourceGroupId	string	No	El ID del grupo de recursos. Si omite este parámetro, el sistema utiliza el grupo de recursos predeterminado.	testID
Sources	string	Sí	Una cadena JSON que especifica los servidores de origen.	[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80,"weight":"15"}]
CheckUrl	string	No	La URL de comprobación de estado.	www.example.com/test.html
Scope	string	No	La región de aceleración. Valores válidos: `domestic` (predeterminado): Solo China continental. `overseas`: Global (excluyendo China continental). `global`: Global.	domestic
TopLevelDomain	string	No	El dominio principal.	example.com

La siguiente tabla describe los campos del parámetro Sources.

Parámetro	Tipo	Obligatorio	Descripción
type	String	Sí	El tipo de origen. Valores válidos: ipaddr: Un origen IP. domain: Un origen de dominio. oss: Un bucket de OSS. fc_domain: Un origen de Function Compute.
content	String	Sí	La dirección IP o el nombre de dominio del origen.
port	Integer	No	El puerto de origen. Valores válidos: 80: El puerto predeterminado. 443: Para conexiones HTTPS. Un número de puerto personalizado.
priority	String	No	La prioridad del origen. Valores válidos: 20: Origen principal (predeterminado). 30: Origen de respaldo.
weight	String	No	El peso del origen, un número entero del 1 al 100 (predeterminado: 10).

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	15C66C7B-671A-4297-9187-2C4477247A74

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDomainName.Malformed	The specified DomainName is invalid.	The specified domain name is invalid.
400	InvalidSources.Malformed	The specified Sources is invalid.	The specified Sources parameter is invalid. It can be IP address or domain name. Up to 20 IP addresses are supported and they must be separated by commas (,). Only a single domain name is supported.
400	InvalidScope.Malformed	The specified Scope is invalid.	The value specified for the Scope parameter is invalid.
400	InvalidSource.Priority.Malformed	The specified Source Priority is invalid.	The value specified for the priority field in the Sources parameter is invalid.
400	SourceIp.Exceed	The maximum number of back-to-origin IP addresses is exceeded.	The number of origin IP addresses exceeds the upper limit.
400	InvalidCertificate	The specified certificate format is invalid.	The format of the specified certificate is invalid.
400	InvalidCertificate.TooLong	The maximum length of the certificate is exceeded.	The maximum length of the specified certificate content has been reached.
400	CheckSourceHealthFailed	Error checking the security. Provide the valid origin site information.	The origin check failed. Please provide the correct origin information.
400	ExtensiveAndAllBothExist	A wildcard domain name and a domain name with an all. prefix cannot be both specified.	Wildcard domain names and domain names that start with "all." cannot both exist.
400	CdnTypeNotSupportExtensiveDomain	Wildcard domain names are not supported.	Wildcard domain names are not supported.
400	ExtensiveAndSpecificDomainConflict	The wildcard domain name overlaps a domain name at the same level.	Wildcard domain names and specific domain names of the same level as the wildcard domain names are mutually exclusive. Enter another domain name.
400	InvalidResourceGroupId.Malformed	The specified ResourceGroupId is invalid.	The value specified for the ResourceGroupId parameter is invalid. Specify a valid value and try again.
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.	The root domain name of this domain name is used by another account. Submit a ticket to apply for new domain names.
400	InvalidDomainNameLevel	The alicdn.com domain supports a maximum of three levels of domain.	alicdn.com supports up to three domain levels for wildcard domain names.
400	TopLevelDomain.NotFound	The specified TopLevelDomain does not exist.	The specified top-level domain name does not exist.
400	EntityNotExists.ResourceGroup	The resource group does not exist.	The specified resource group does not exist.
400	EntityNotExist.ResourceGroup	The resource group does not exist.	The specified resource group does not exist.
400	InvalidStatus.ResourceGroup	The current status of the resource group does not support this operation.	This operation is not supported while the resource group is in the current state.
400	NotInternationRealIdentity	Real-name registration is required for services offered in Mainland China.	You have not passed real-name verification. According to the regulations issued by MIIT, you must pass real-name verification if you want to purchase information services in the Chinese mainland.
400	RecordCheckNotAvailable	The ICP filing interface is unavailable. Please try again later.	The operation for ICP filing is unavailable. Try again later.
400	IcpBlack	The domain is on the ICP blacklist.	The domain name is on the blacklist of the MIIT.
400	IspBlack	The domain is on the ISP blacklist.	The domain name is on the blacklist of Alibaba Cloud.
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	The first time a domain name is added to DCDN, you must prove the ownership of the domain name. You must add a DNS record or upload a verification file for the domain name before it can be added to DCDN.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.	The top-level domain name does not match the domain name type.
400	DomainOverLimit	The maximum number of domains is exceeded.	The maximum number of domain names has been reached.
400	DomainInRiskList	The domain you added may be at risk. If you have any questions, please submit a ticket.	The domain name you added may be at risk. If you have any questions, please submit a work order.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.