Todos los productos
Search
Centro de documentos

CDN:BatchSetCdnDomainConfig

Última actualización: Sep 11, 2026

Configura varios nombres de dominio acelerados en lote mediante una llamada a BatchSetCdnDomainConfig.

Descripción de la operación

  • El número máximo de veces que cada usuario puede llamar a esta operación por segundo: 3.

  • Después de llamar a BatchSetCdnDomainConfig para configurar funciones de los nombres de dominio, se genera un ConfigId único. Puede usar el ConfigId para actualizar o eliminar configuraciones. Para obtener más información, consulte Uso y consulta de ConfigId.

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

cdn:BatchSetCdnDomainConfig

update

*Dominio.

acs:cdn:*:{#accountId}:domain/{#DomainNames}

Ninguna
  • ram:CreateServiceLinkedRole

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 producto del número de nombres de dominio y el número de funciones especificadas por Functions debe ser menor o igual que 20. Por ejemplo:
    • Si el número de funciones especificadas por Functions es 20, solo puede especificar un nombre de dominio a la vez.

    • Si el número de funciones especificadas por Functions es 1, puede especificar hasta 20 nombres de dominio a la vez.

www.example.com

Functions

string

Sí

La lista de configuraciones de función que desea establecer. Tenga en cuenta los siguientes límites de configuración:

  • El producto del número de nombres de dominio y el número de funciones especificadas por Functions debe ser menor o igual que 20. Por ejemplo:
    • Si el número de funciones especificadas por Functions es 20, solo puede especificar un nombre de dominio a la vez.

    • Si el número de funciones especificadas por Functions es 1, puede especificar hasta 20 nombres de dominio a la vez.

El formato es el siguiente:

  • functionName (nombre de función, obligatorio): para ver las funciones configurables, consulte Lista de funciones. Separe varios parámetros con comas (,).

  • argName (nombre de parámetro, obligatorio): los elementos de configuración de functionName. Puede configurar varios elementos de configuración.

  • argValue (valor de parámetro, obligatorio): los valores de los elementos de configuración de functionName.

  • parentid (ID de condición de regla, opcional): mediante la configuración de la función 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 coincidir con las solicitudes de usuario y filtrarlas mediante la identificación de varios parámetros incluidos en ellas. Después de crear cada condición de regla, se genera un configid correspondiente. Se puede hacer referencia al configid como el parámetro ParentId desde otras funciones. De esta manera, las condiciones de regla se pueden combinar con configuraciones de función para formar configuraciones más flexibles.

Si parentId se establece en -1, se eliminan las condiciones de regla existentes en la configuración.

   "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",
 "parentId": Opcional. El configid de la condición de regla referenciada.
}]

Ejemplo de configuración sin usar parentId: Cuando se usa la función origin_request_header para agregar un encabezado de solicitud HTTP de retorno al origen con una referencia a la condición de regla configid=222728944812032, los parámetros de solicitud son los siguientes:

        "functionArgs": [{
            "argName": "header_operation_type",
            "argValue": "add"
        }, {
            "argName": "header_name",
            "argValue": "Accept-Encoding"
        }, {
            "argName": "header_value",
            "argValue": "gzip"
        }, {
            "argName": "duplicate",
            "argValue": "off"
        }],
        "functionName": "origin_request_header"
}]

Ejemplo de configuración usando parentId: Cuando se usa la función origin_request_header para agregar un encabezado de solicitud HTTP de retorno al origen con una referencia a la condición de regla configid=222728944812032, los parámetros de solicitud son los siguientes:

        "functionArgs": [{
            "argName": "header_operation_type",
            "argValue": "add"
        }, {
            "argName": "header_name",
            "argValue": "Accept-Encoding"
        }, {
            "argName": "header_value",
            "argValue": "gzip"
        }, {
            "argName": "duplicate",
            "argValue": "off"
        }],
        "functionName": "origin_request_header",
        "parentId": 222728944812032
}]

Ejemplo de configuración para quitar la referencia de parentId de una configuración de función que ya usa parentId: La función origin_request_header ya ha referenciado la condición de regla configid=222728944812032 al agregar un encabezado de solicitud HTTP de retorno al origen. Para quitar la referencia a la condición de regla, los parámetros de solicitud son los siguientes:

        "functionArgs": [{
            "argName": "header_operation_type",
            "argValue": "add"
        }, {
            "argName": "header_name",
            "argValue": "Accept-Encoding"
        }, {
            "argName": "header_value",
            "argValue": "gzip"
        }, {
            "argName": "duplicate",
            "argValue": "off"
        }],
        "functionName": "origin_request_header",
        "parentId": -1
}]

[{"functionArgs": [{"argName": "key","argValue": "Content-Encoding"},{"argName": "value","argValue": "gzip"}],"functionName": "set_resp_header"} ]

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 configuración. Si se devuelve el valor 0, la configuración no se aplicó. Vuelva a configurar la función.

1234567

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": 1234567,
        "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 incorrectly formatted. El formato de configuración no es válido.
400 InvalidArgValue.Malformed The specified ArgValue is invalid. El formato del parámetro no es válido. Revise y actualice el parámetro, e inténtelo de nuevo.
400 Invalid%s.ValueNotSupported [%s] is not supported.
400 Invalid%s.Malformed The specified ArgValue [%s] is invalid.
400 MissingParameter%s The specified value of ArgName[%s] is missing. El parámetro no puede estar vacío.
400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid. El parámetro de función especificado no es válido.
400 MissingParameter The specified ArgValue is missing.
400 InvalidHeaderKey.ValueNotSupported The specified value of parameter HeaderKey is not supported. El parámetro de encabezado HTTP especificado no es válido y supera el rango permitido. Valores válidos: Content-Type, Cache-Control, Content-Disposition, Content-Language, Expires, Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Allow-Headers, Access-Control-Max-Age, Access-Control-Expose-Headers y Access-Control-Allow-Credentials.
400 TooManyDomains The count of domain is over 50.
400 InvalidRule.Malformed %s
400 ConfigurationConflicts The staging environment has a configuration in effect and cannot modify the production environment configuration. La configuración del entorno de preproducción no coincide con la configuración del entorno de producción. No puede modificar directamente la configuración del entorno de producción. Complete la configuración requerida en el entorno de preproducción y luego publíquela en el entorno de producción para sobrescribir la configuración existente.
400 InvalidFunction.NotSupported The domain is not supported to set the function. El nombre de dominio no admite esta función.
400 InvalidDomain.BelongToConfigGroup This Domain activated in configuration group and should modify by config group.
400 EntityNotExist.Role EntityNotExist.Role
400 MissingParameterFunctions The specified value of Functions is missing.
400 NoPermission.SLR The current user does not have permission to create servicelinkedrole. Please contact the Alibaba Cloud account or administrator to authorize AliyunCDNFullAccess or custom policy:Service Name:cdn-ddos.cdn.aliyuncs.com,Role: AliyunServiceRoleForCDNAccessingDDoS,Permission: ram: CreateServiceLinkedRole La cuenta actual no tiene la autorización para crear un rol vinculado al servicio. Póngase en contacto con el propietario de la cuenta de Alibaba Cloud o con el administrador de permisos para otorgar el permiso AliyunCDNFullAccess o asociar una política de acceso personalizada que permita la creación de roles vinculados al servicio. La información de la política de acceso personalizada es la siguiente: Nombre del servicio: cdn-ddos.cdn.aliyuncs.com. Nombre del rol vinculado al servicio: AliyunServiceRoleForCDNAccessingDDoS. Permiso necesario para ejecutar esta operación: ram:CreateServiceLinkedRole.
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. El número de reglas supera el límite predeterminado. Para aumentar el límite, envíe un 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 configuraciones de backend o los parámetros de la configuración no son válidos. Si tiene alguna duda, 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. Existen reglas personalizadas de backend o los parámetros de la configuración no son válidos. Si tiene alguna duda, envíe un ticket.
400 EdgeScriptNotSupportJs JavaScript rules are not supported. For more information, submit a ticket. Las reglas JS no están habilitadas. Si tiene alguna duda, envíe un ticket.
400 ServiceInvokeFailed Failed to invoke service. No se pudo invocar el servicio interno.
400 ConfigParentExceedLimit Config parent exceed limit. El número de reglas de condición avanzada referenciadas supera el umbral.
400 Function.InvalidParentId The specified parentId does not exist. La condición de regla especificada no existe.
400 BatchSetBusinessError some configs error:%s Se produjo un error de configuración: %s.
400 ConfigDuplicate Duplicate configuration. This function has already been configured and cannot be added repeatedly. La configuración está duplicada.
400 FunctionArgError The function parameter of the domain configuration is incorrect. Los parámetros de función de la configuración del nombre de dominio no son válidos.

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.