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

Llama a la operación BatchSetDcdnDomainConfigs para configurar varios nombres de dominio a la vez.

Descripción de la operación

Frecuencia de llamadas por usuario único: 30 llamadas por segundo.

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:BatchSetDcdnDomainConfigs

update

*dominio.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DomainNames	string	Sí	Los nombres de dominio acelerados. Separe varios nombres de dominio con comas (,). Tenga en cuenta los siguientes límites de configuración: El resultado de multiplicar el "Número de nombres de dominio" por el "Número de funciones" debe ser menor o igual que 20. Por ejemplo: Si el número de funciones configuradas a la vez es 20, solo puede especificar 1 nombre de dominio a la vez. Si el número de funciones configuradas a la vez es 1, puede especificar hasta 20 nombres de dominio a la vez.	example.com,example.org
Functions	string	Sí	La lista de funciones. Tenga en cuenta los siguientes límites de configuración: El resultado de multiplicar el "Número de nombres de dominio" por el "Número de funciones" debe ser menor o igual que 20. Por ejemplo: Si el número de funciones configuradas a la vez es 20, solo puede especificar 1 nombre de dominio a la vez. Si el número de funciones configuradas a la vez es 1, puede especificar hasta 20 nombres de dominio a la vez. El formato es el siguiente: functionName (nombre de la función): Para conocer las funciones configurables, consulte Lista de funciones. Separe varios parámetros con comas (,). argName: El elemento de configuración de functionName. Puede configurar varios elementos de configuración. argValue: El valor del elemento de configuración de functionName. parentid (ID de condición de regla, opcional): Al configurar la función de característica condition (motor de reglas) en Parámetros de funciones de configuración de nombres de dominio, puede crear condiciones de regla. Las condiciones de regla pueden filtrar solicitudes de usuario y establecer coincidencias con ellas mediante la identificación de diversos parámetros incluidos en las solicitudes. Después de crear cada condición de regla, se genera un configid correspondiente. El configid puede usarse como el parámetro ParentId y otras funciones de característica pueden hacer referencia a él. De esta manera, las condiciones de regla se pueden combinar con configuraciones de funciones para formar configuraciones más flexibles. `[ { "functionArgs": [ { "argName": "Parámetro de función A", "argValue": "Valor del parámetro de función A" }, { "argName": "Parámetro de función B", "argValue": "Valor del parámetro de función B" } ], "functionName": "Nombre de función" } ]`	[{"functionArgs":[{"argName":"switch","argValue":"on"},{"argName":"region","argValue":"*"}],"functionName":"ipv6"}]

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	04F0F334-1335-436C-A1D7-6C044FE73368
DomainConfigList	object
DomainConfigModel	array<object>	La lista de configuraciones de nombres de dominio.
	object
ConfigId	integer	El ID de la configuración. Si el valor devuelto es 0, la configuración no se aplicó. Debe volver a configurar los ajustes.	123456
DomainName	string	El nombre de dominio.	www.example.com
FunctionName	string	El nombre de la función.	set_resp_header

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "DomainConfigList": {
    "DomainConfigModel": [
      {
        "ConfigId": 123456,
        "DomainName": "www.example.com",
        "FunctionName": "set_resp_header"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidFunctions.Malformed	The specified Functions is invalid.	Esta configuración no es compatible. Especifique una configuración válida.
400	InvalidArgValue.Malformed	The specified ArgValue is invalid.	El valor de ArgValue no es válido. Introduzca un valor válido.
400	Invalid%s.ValueNotSupported	[%s] is not supported.	Esta configuración no es compatible. Realice la consulta nuevamente.
400	Invalid%s.Malformed	The specified ArgValue [%s] is invalid.	El ArgValue especificado no es compatible. Introduzca un ArgValue válido.
400	MissingParameter	You must specify ArgValue.	Falta un parámetro obligatorio.
400	InvalidRule.Malformed	%s	%s
400	InvalidHeaderKey.ValueNotSupported	The specified value of parameter HeaderKey is not supported.	El valor de HeaderKey no es válido.
400	MissingParameter%s	The specified value of ArgName %s is missing.	Falta un parámetro obligatorio.
400	InvalidParameter	Domain already exists in high ddos.	El parámetro no es válido.
400	ConfigExceedLimit	Count of config entries exceeds the limit.	El número de configuraciones supera el límite.
400	EdgeScriptCountExceedLimit	The number of rules exceeds the default limit (1). To increase the limit, submit a ticket.
400	EdgeScripOptionsHasInnerConfig	The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket.	La extensión tiene una configuración de backend o los parámetros de configuración no son válidos. Si tiene dudas, envíe un ticket.
400	EdgeScriptGrammarNotSupport	A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket.	Existe una regla personalizada de backend o los parámetros de configuración no son válidos. Si tiene dudas, envíe un ticket.
400	EdgeScriptNotSupportJs	JavaScript rules are not supported. For more information, submit a ticket.	Las reglas de JS no están disponibles. Si tiene dudas, envíe un ticket.
400	ServiceInvokeFailed	Failed to invoke service.	La llamada al servicio interno falló.
400	ConfigParentExceedLimit	Config Parent exceed limit.	El número de reglas de condición avanzada referenciadas supera 5.
400	BatchSetBusinessError	some configs error:%s	Se produjo un error de configuración: %s.
400	Function.InvalidParentId	The specified parentId does not exist.	La condición de regla especificada no existe.
400	Domain.DDosQuotaFull	The user’s domain quota for DDos is full.	El número de nombres de dominio protegidos ha alcanzado el límite superior. Actualice su plan para aumentar la cuota de nombres de dominio.
400	AccountArrears	The user‘s account is in arrears.	Su cuenta tiene un pago pendiente. No se puede realizar la operación.
400	DDosExpired	The user‘s DDoS protection has expired.	Su protección contra DDoS ha caducado. No se puede realizar la operación.
400	Domain.DDosAlreadyExists	This specified domain has been in DDoS.	El nombre de dominio ya está conectado a Alibaba Cloud Anti-DDoS. Quítelo antes de conectarlo a la protección contra DDoS de DCDN.
400	Domain.PortConfiguring	This specified domain's special ports are configuring.	La configuración de puerto especial para el nombre de dominio está en curso. Inténtelo de nuevo más tarde.
400	Domain.PortAllocateError	Your port resource allocation failed, please try again in 30 minutes.	Falló la asignación de recursos de puerto personalizado. Inténtelo de nuevo después de 30 minutos. Si el problema persiste tras varios intentos, envíe un ticket.

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.