Todos os produtos
Search
Central de documentação

CDN:BatchSetCdnDomainConfig

Última atualização: Sep 11, 2026

Configura vários nomes de domínio acelerados em lote ao chamar BatchSetCdnDomainConfig.

Descrição da operação

  • O número máximo de vezes que cada usuário pode chamar esta operação por segundo: 3.

  • Após chamar BatchSetCdnDomainConfig para configurar recursos para nomes de domínio, um ConfigId exclusivo é gerado. Você pode usar o ConfigId para atualizar ou excluir configurações. Para mais informações, consulte Uso e consulta de ConfigId.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cdn:BatchSetCdnDomainConfig

update

*Domínio.

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

Nenhuma
  • ram:CreateServiceLinkedRole

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DomainNames

string

Sim

Os nomes de domínio acelerados. Separe vários nomes de domínio com vírgulas (,). Observe os seguintes limites de configuração:

  • O produto do número de nomes de domínio e o número de recursos especificados por Functions deve ser menor ou igual a 20. Por exemplo:
    • Se o número de recursos especificados por Functions for 20, você poderá especificar apenas um nome de domínio por vez.

    • Se o número de recursos especificados por Functions for 1, você poderá especificar até 20 nomes de domínio por vez.

www.example.com

Functions

string

Sim

A lista de configurações de recursos que você deseja definir. Observe os seguintes limites de configuração:

  • O produto do número de nomes de domínio e o número de recursos especificados por Functions deve ser menor ou igual a 20. Por exemplo:
    • Se o número de recursos especificados por Functions for 20, você poderá especificar apenas um nome de domínio por vez.

    • Se o número de recursos especificados por Functions for 1, você poderá especificar até 20 nomes de domínio por vez.

O formato é o seguinte:

  • functionName (nome do recurso, obrigatório): Para recursos configuráveis, consulte Lista de recursos. Separe vários parâmetros com vírgulas (,).

  • argName (nome do parâmetro, obrigatório): Os itens de configuração de functionName. Você pode configurar vários itens de configuração.

  • argValue (valor do parâmetro, obrigatório): Os valores dos itens de configuração de functionName.

  • parentid (ID da condição da regra, opcional): Ao configurar a função condition (mecanismo de regras) em Parâmetros de recursos de configuração de nome de domínio, você pode criar condições de regra. As condições de regra podem corresponder e filtrar solicitações de usuário identificando vários parâmetros transportados nas solicitações do usuário. Após a criação de cada condição de regra, um configid correspondente é gerado. O configid pode ser referenciado como o parâmetro ParentId por outras funções de recurso. Dessa forma, as condições de regra podem ser combinadas com configurações de recursos para formar configurações mais flexíveis.

Se parentId for definido como -1, as condições de regra existentes na configuração serão excluídas.

   "functionArgs": [{
     "argName": "Parâmetro de recurso A", 
     "argValue": "Valor do parâmetro de recurso A"
    }, 
  {
    "argName": "Parâmetro de recurso B", 
    "argValue": "Valor do parâmetro de recurso B"
     }], 
 "functionName": "Nome do recurso",
 "parentId": Opcional. O configid da condição de regra referenciada.
}]

Exemplo de configuração sem usar parentId: Ao usar a função origin_request_header para adicionar um cabeçalho de solicitação HTTP de retorno à origem com uma referência à condição de regra configid=222728944812032, os parâmetros da solicitação são os seguintes:

        "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"
}]

Exemplo de configuração usando parentId: Ao usar a função origin_request_header para adicionar um cabeçalho de solicitação HTTP de retorno à origem com uma referência à condição de regra configid=222728944812032, os parâmetros da solicitação são os seguintes:

        "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
}]

Exemplo de configuração para remover a referência parentId de uma configuração de recurso que já usa parentId: A função origin_request_header já referenciou a condição de regra configid=222728944812032 ao adicionar um cabeçalho de solicitação HTTP de retorno à origem. Para remover a referência à condição de regra, os parâmetros da solicitação são os seguintes:

        "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 resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

04F0F334-1335-436C-A1D7-6C044FE73368

DomainConfigList

object

DomainConfigModel

array<object>

A lista de configurações de nomes de domínio.

object

ConfigId

integer

O ID da configuração. Se o valor 0 for retornado, a configuração não foi aplicada. Reconfigure o recurso.

1234567

DomainName

string

O nome de domínio.

www.example.com

FunctionName

string

O nome do recurso.

set_resp_header

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidFunctions.Malformed The specified Functions is incorrectly formatted. O formato da configuração é inválido.
400 InvalidArgValue.Malformed The specified ArgValue is invalid. O formato do parâmetro é inválido. Verifique e atualize o parâmetro e tente novamente.
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. O parâmetro não pode estar vazio.
400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid. O parâmetro de recurso especificado é inválido.
400 MissingParameter The specified ArgValue is missing.
400 InvalidHeaderKey.ValueNotSupported The specified value of parameter HeaderKey is not supported. O parâmetro de cabeçalho HTTP especificado é inválido e excede o intervalo 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 e 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. A configuração no ambiente de staging é inconsistente com a configuração do ambiente de produção. Você não pode modificar diretamente a configuração do ambiente de produção. Conclua a configuração necessária no ambiente de staging e publique-a no ambiente de produção para substituir a configuração existente.
400 InvalidFunction.NotSupported The domain is not supported to set the function. O nome de domínio não suporta este recurso.
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 A conta atual não tem autorização para criar uma função vinculada a serviço. Entre em contato com o proprietário da conta Alibaba Cloud ou com o administrador de gerenciamento de permissões para conceder a permissão AliyunCDNFullAccess ou associar uma política de acesso personalizada que permita a criação de funções vinculadas a serviço. As informações da política de acesso personalizada são as seguintes: Nome do serviço: cdn-ddos.cdn.aliyuncs.com. Nome da função vinculada a serviço: AliyunServiceRoleForCDNAccessingDDoS. Permissão necessária para executar esta operação: ram:CreateServiceLinkedRole.
400 ConfigExceedLimit Count of config entries exceeds the limit. O número de configurações excede o limite.
400 EdgeScriptCountExceedLimit The number of rules exceeds the default limit. O número de regras excede o limite padrão. Para aumentar o limite, abra um ticket.
400 EdgeScripOptionsHasInnerConfig The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket. A extensão possui configurações de backend ou os parâmetros da configuração são inválidos. Se você tiver alguma dúvida, abra um ticket.
400 EdgeScriptGrammarNotSupport A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket. Existem regras personalizadas de backend ou os parâmetros da configuração são inválidos. Se você tiver alguma dúvida, abra um ticket.
400 EdgeScriptNotSupportJs JavaScript rules are not supported. For more information, submit a ticket. As regras JS não estão ativadas. Se você tiver alguma dúvida, abra um ticket.
400 ServiceInvokeFailed Failed to invoke service. Falha ao chamar o serviço interno.
400 ConfigParentExceedLimit Config parent exceed limit. O número de regras de condição avançada referenciadas excede o limite.
400 Function.InvalidParentId The specified parentId does not exist. A condição de regra especificada não existe.
400 BatchSetBusinessError some configs error:%s Ocorreu um erro de configuração: %s.
400 ConfigDuplicate Duplicate configuration. This function has already been configured and cannot be added repeatedly. A configuração está duplicada.
400 FunctionArgError The function parameter of the domain configuration is incorrect. Os parâmetros da função da configuração do nome de domínio são inválidos.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.