BatchSetVodDomainConfigs - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

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

Descrição da operação

Atualmente, a única região de serviço suportada é China (Xangai).
Você pode configurar até 50 nomes de domínio por vez.
Após chamar esta operação para configurar determinados recursos para nomes de domínio, um ConfigId exclusivo é gerado. Você pode usar o ConfigId para atualizar ou excluir configurações de nome de domínio. Esta operação não retorna o ConfigId. Para obter o ConfigId, chame a operação DescribeVodDomainConfigs.

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

vod:BatchSetVodDomainConfigs

update

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DomainNames	string	Sim	Os nomes de domínio acelerados para o ApsaraVideo VOD. Separe vários nomes de domínio com vírgulas (,). Você pode configurar até 50 nomes de domínio por vez.	example.com.
Functions	string	Sim	A lista de recursos. functionName (nome do recurso, obrigatório): Para os recursos que podem ser configurados e seus parâmetros de nome de recurso, consulte Recursos de configuração de nome de domínio. 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. Para obter informações detalhadas sobre os recursos que podem ser configurados para nomes de domínio acelerados, incluindo nomes de recursos e nomes de parâmetros, consulte Recursos de configuração de nome de domínio. Nota Alguns recursos, como filetype_based_ttl_set (tempo de expiração de arquivo), suportam várias regras de configuração. Para atualizar uma regra de configuração específica, especifique o configId dessa regra. Exemplo: `[{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":5068995}]`	[{"functionArgs":[{"argName":"domain_name","argValue":"www.example.com"}],"functionName":"set_req_host_header"}]

Descrição do recurso

Todos os valores de parâmetro são do tipo string.

Recurso	Descrição	Parâmetro
referer_white_list_set	Especifica a lista de permissões de referenciador.	refer_domain_allow_list: os referenciadores a serem adicionados à lista de permissões. Separe vários referenciadores com vírgulas (,). allow_empty: especifica se um referenciador vazio é permitido. Valores válidos: on e off.
referer_black_list_set	Especifica a lista de bloqueios de referenciador.	refer_domain_deny_list: os referenciadores a serem adicionados à lista de bloqueios. Separe vários referenciadores com vírgulas (,). allow_empty: especifica se um referenciador vazio é permitido. Valores válidos: on e off.
filetype_based_ttl_set	Especifica o período de tempo após o qual um arquivo expira.	ttl: o tempo de expiração do conteúdo em cache. Unidade: segundos. file_type: o tipo de arquivo. Separe vários tipos de arquivo com vírgulas (,). Exemplo: txt,jpg. weight: o peso do arquivo no cache. Valores válidos: 1 a 199.
path_based_ttl_set	Especifica o período de tempo após o qual um diretório expira.	ttl: o tempo de expiração do conteúdo em cache. Unidade: segundos. path: o diretório, que deve começar com uma barra (/). weight: o peso do diretório no cache. Valores válidos: 1 a 99.
oss_auth	Configura a autenticação para o acesso a um bucket do Object Storage Service (OSS).	oss_bucket_id: o ID do bucket.
ip_black_list_set	Especifica a lista de bloqueios de endereços IP.	ip_list: os endereços IP a serem adicionados à lista de permissões. Separe vários endereços IP com vírgulas (,).
ip_allow_list_set	Especifica a lista de permissões de endereços IP.	ip_list: os endereços IP a serem adicionados à lista de permissões. Separe vários endereços IP com vírgulas (,).
ip_white_list_set	Especifica as regras autodefinidas para o limite de taxa.	ip_list: os endereços IP a serem adicionados à lista de permissões. Separe vários endereços IP com vírgulas (,).
error_page	Redireciona uma página de erro para uma página especificada.	error_code: o código de erro. rewrite_page: a página para a qual a página de erro é redirecionada.
set_req_host_header	Modifica o cabeçalho personalizado das solicitações de retorno à origem.	domain_name: o cabeçalho de host personalizado das solicitações de retorno à origem.
set_hashkey_args	Ignora os parâmetros de URL especificados.	hashkey_args: os parâmetros a serem reservados. Separe vários parâmetros com vírgulas (,). disable: especifica se todos os parâmetros devem ser ignorados. Um valor de on indica que todos os parâmetros são ignorados. Um valor de off indica que nenhum dos parâmetros é ignorado.
aliauth	Configura a autenticação do Alibaba Cloud.	auth_type: o tipo de autenticação. Valores válidos: no_auth, type_a, type_b e type_c. auth_key1: a chave de autenticação primária. auth_key2: a chave de autenticação secundária. ali_auth_delta: o tempo de buffer personalizado para autenticação. ali_auth_remote_desc: a string de correspondência de padrão.
set_resp_header	Especifica um cabeçalho de resposta. Para verificar a configuração, você pode conferir a mensagem de resposta em um navegador.	key: o nome do cabeçalho de resposta. 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 e Access-Control-Expose-Headers. value: o conteúdo do cabeçalho de resposta. Se você quiser excluir o cabeçalho, insira null.
https_force	Configura o redirecionamento forçado para HTTPS.	enable: especifica se o redirecionamento forçado para HTTPS deve ser ativado. Valores válidos: on e off.
http_force	Configura o redirecionamento forçado para HTTP.	enable: especifica se o redirecionamento forçado para HTTP deve ser ativado. Valores válidos: on e off.
l2_oss_key	Configura a autenticação de chave privada para solicitações de retorno à origem de nós L2 para buckets privados do OSS.	private_oss_auth: especifica se o acesso a um bucket privado do OSS deve ser autenticado. Valores válidos: on e off.
green_manager	Configura a detecção de pornografia.	enable: especifica se a detecção de pornografia deve ser ativada. Valores válidos: on e off.
range	Configura o fracionamento de objetos.	enable: especifica se o fracionamento de objetos deve ser ativado. Valores válidos: on, off e force.
video_seek	Configura a busca de vídeo.	enable: especifica se a busca de vídeo deve ser ativada. Valores válidos: on e off.
set_hashkey_args	Ignora os parâmetros de URL especificados.	hashkey_args: os parâmetros a serem reservados. Separe vários parâmetros com vírgulas (,). disable: especifica se todos os parâmetros devem ser ignorados. Um valor de on indica que todos os parâmetros são ignorados. Um valor de off indica que nenhum dos parâmetros é ignorado.
tmd_signature	Especifica as regras autodefinidas para o limite de taxa.	name: o nome da regra, que deve ser exclusivo no nome de domínio. path: o caminho da URI. Você pode especificar caminhos de URI duplicados. No entanto, você deve verificar a validade deles. pathType: a regra de correspondência. Valores válidos: 0 e 1. Um valor de 0 indica uma correspondência de prefixo. Um valor de 1 indica uma correspondência exata. interval: o intervalo no qual os dados são monitorados. Unidade: segundos. O intervalo deve ser maior ou igual a 10 segundos. count: o número de visitas de um endereço IP. action: a operação a ser executada após as condições especificadas serem atendidas. Valores válidos: 0 e 1. Um valor de 0 indica bloqueio. Um valor de 1 indica detecção de bot. ttl: o período de tempo durante o qual o acesso é bloqueado. Unidade: segundos.
ali_business	Configura recursos personalizados.	ali_business_type: obrigatório. O tipo de negócio. ali_business_table: a string de correspondência de padrão.
hls_token_rewrite	Configura a criptografia e reescrita de M3U8.	enable: obrigatório. Especifica se a criptografia e reescrita de M3U8 devem ser ativadas. Valores válidos: on e off. hls_token_arg_name: o nome do parâmetro anexado. Se você não especificar o nome, o nome de parâmetro MtsHlsUriToken será usado.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	04F0F334-1335-436C-****-6C044FE73368

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "04F0F334-1335-436C-****-6C044FE73368"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	InvalidFunctions.Malformed	The specified Functions is incorrectly formatted.
400	InvalidArgValue.Malformed	The specified ArgValue is invalid.
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.
400	InvalidFunctionArgs.Malformed	The specified FunctionArgs is invalid.
400	MissingParameter	The specified ArgValue is missing.
400	InvalidHeaderKey.ValueNotSupported	The specified value of parameter HeaderKey is not supported.
400	TooManyDomains	The count of domain is over 50.
400	InvalidRule.Malformed	%s
400	InvalidFunction.NotSupported	The domain is not supported to set the function.
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
400	ConfigExceedLimit	Count of config entries exceeds the limit.
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.
400	EdgeScriptGrammarNotSupport	A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket.
400	EdgeScriptNotSupportJs	JavaScript rules are not supported. For more information, submit a ticket.
400	ServiceInvokeFailed	Failed to invoke service.
400	ConfigurationConflicts	Failed to modify the parameter settings in the production environment because the parameter settings are different from those in the staging environment. Set parameters in the staging environment before you publish them to the production environment.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.