BatchAddCdnDomain - CDN: Central de Documentação do Alibaba Cloud

Adiciona vários nomes de domínio acelerados à Content Delivery Network (CDN). Você pode adicionar até 50 nomes de domínio acelerados em uma única chamada.

Descrição da operação

Antes de adicionar nomes de domínio acelerados, ative a Content Delivery Network (CDN). Para mais informações, consulte Ativar o CDN.
Se a região de aceleração estiver definida como China continental ou global, os nomes de domínio acelerados devem ter um registro ICP.
Você pode especificar vários nomes de domínio em uma única chamada. Separe vários nomes de domínio com vírgulas (,). Há suporte para no máximo 50 nomes de domínio em uma única chamada.
Você pode chamar esta operação até 100 vezes por hora.

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

create

*Domínio.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CdnType	string	Sim	O tipo de negócio do nome de domínio acelerado. Valores válidos: web: Imagens e arquivos pequenos. download: Downloads de arquivos grandes. video: Streaming de vídeo e áudio sob demanda.	web
DomainName	string	Sim	Os nomes de domínio acelerados que você deseja adicionar ao CDN. Separe vários nomes de domínio com vírgulas (,).	example.com,aliyundoc.com
ResourceGroupId	string	Não	O ID do grupo de recursos. Se você não especificar este parâmetro, o ID do grupo de recursos padrão será usado.	rg-acfmyuji4b6r4**
Sources	string	Sim	A lista de endereços de busca na origem.	[ { "content": "192.0.2.0", "type": "ipaddr", "priority": "20", "port": 80, "weight": "15" } ]
CheckUrl	string	Não	A URL de teste.	url
Scope	string	Não	A região de aceleração. Valores válidos: domestic: A China continental. overseas: Global (exceto a China continental). global: Global.	domestic
TopLevelDomain	string	Não	O domínio de nível superior.	example.com

A tabela a seguir descreve os campos no parâmetro Sources.

Parâmetro	Tipo	Obrigatório	Descrição
type	String	Sim	O tipo de servidor de origem. ipaddr: Endereço IP. domain: Nome de domínio. oss: Bucket do OSS. fc_domain: Nome de domínio do Function Compute.
content	String	Sim	O endereço de busca na origem, que pode ser um endereço IP ou um nome de domínio.
port	Integer	Não	O número da porta. Você pode especificar 443, 80 (padrão) ou uma porta personalizada. A porta 443 é usada para busca na origem via HTTPS.
priority	String	Não	A prioridade dos endereços do servidor de origem. Valores válidos: 20 (padrão) e 30. Um valor de 20 especifica o servidor de origem primário, e um valor de 30 especifica o servidor de origem secundário.
weight	String	Não	O peso de busca na origem. O valor deve ser um número inteiro de até 100. Valor padrão: 10.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	15C66C7B-671A-4297-9187-2C4477247A74

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDomainName.Malformed	Specified DomainName is malformed.	O formato do nome de domínio é inválido ou nomes de domínio curinga não são suportados para adição em lote.
400	MissingParameter	The input parameter cdnType that is mandatory for processing this request is not supplied.	O parâmetro EndTime está ausente.
400	InvalidCdnType.Malformed	Specified CdnType is malformed.	O valor especificado para o parâmetro CdnType não é suportado. Valores válidos: web (distribuição de imagens e arquivos pequenos), download (aceleração de download de arquivos grandes), video (aceleração de streaming de áudio e vídeo sob demanda) e liveStream (aceleração de mídia de streaming ao vivo).
400	InvalidSources.Malformed	Specified Sources is malformed.	O formato do parâmetro Sources é inválido. O valor pode ser endereços IP ou um nome de domínio. São suportados no máximo 20 endereços IP, separados por vírgulas. Apenas um nome de domínio pode ser especificado. Endereços IP e nomes de domínio não podem ser especificados simultaneamente.
400	InvalidSourceType.Malformed	Specified CdnType is malformed.	O formato do parâmetro SourceType é inválido.
400	InvalidSource.Priority.Malformed	The specified Source Priority is invalid.
400	InvalidTypeAndContent.MissMatch	InvalidTypeAndContent.MissMatch
400	InvalidScope.Malformed	Specified Scope is malformed.	O formato do escopo é inválido.
400	SourceIp.Exceed	The Certificate you provided is malformed	O formato do certificado é inválido.
400	InvalidCertificate	The Certificate you provided is malformed	O formato do certificado é inválido.
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length	O comprimento do certificado e da chave privada excede o limite.
400	InnerAddDomainDenied	Your account has not bind aoneId, can not add domain.	Sua conta não está vinculada a um aoneId. Você não pode adicionar um nome de domínio.
400	CheckSourceHealthFailed	sources ip or source domain check health failed,please input right source.	O endereço IP de origem ou o nome de domínio de origem é inválido. Insira uma origem válida.
400	ExtensiveAndAllBothExist	Extensive domain and the domain begins with all. can not exist at the same time.	Um nome de domínio curinga e um nome de domínio que começa com "all." não podem coexistir.
400	CdnTypeNotSupportExtensiveDomain	Extensive domain not supported for this cdn type.	O nome de domínio curinga não suporta este tipo de serviço. Atualmente, nomes de domínio curinga suportam apenas aceleração de imagens e arquivos pequenos, aceleração de download de arquivos grandes e aceleração de streaming de vídeo/áudio sob demanda.
400	ExtensiveAndSpecificDomainConflict	The number of wildcard domain names exceeds the limit.
400	InvalidResourceGroupId.Malformed	Specified ResourceGroupId is malformed.	O formato do parâmetro ResourceGroupId é inválido.
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.
400	InvalidDomainNameLevel	Domain name suffixed with alicdn.com only support third level.	Os nomes de domínio sob alicdn.com (para nomes de domínio curinga) suportam até três níveis.
400	InvalidTopLevelDomain.Malformed	Specified TopLevelDomain is malformed.	O parâmetro TopLevelDomain é inválido.
400	TopLevelDomain.NotFound	TopLevelDomain is not exist.	O TopLevelDomain não existe.
400	EntityNotExists.ResourceGroup	The resource group does not exist.	O grupo de recursos não existe.
400	EntityNotExist.ResourceGroup	The resource group does not exist.	O grupo de recursos não existe.
400	InvalidStatus.ResourceGroup	It is not allowed to do this operation because of the current status of resource-group.	O status atual do grupo de recursos não permite esta operação.
400	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	De acordo com as leis da República Popular da China, os usuários que compram e utilizam serviços de informação na China devem concluir o registro de nome real.
400	RecordCheckNotAvailable	The ICP filing interface is unavailable. Please try again later.	Ocorreu um erro durante a verificação do registro ICP. Tente novamente mais tarde.
400	IcpBlack	The domain is on the ICP blacklist.
400	IspBlack	The domain is on the ISP blacklist.
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	Ao adicionar um novo nome de domínio à Content Delivery Network (CDN) pela primeira vez, você deve autenticar a propriedade do nome de domínio. Você só poderá adicionar o nome de domínio com sucesso após configurar a resolução DNS ou a autenticação por arquivo conforme necessário.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.	O domínio de nível superior e o tipo de nome de domínio não correspondem.
400	DomainOverLimit	The maximum number of domains is exceeded.	O número de nomes de domínio atingiu o limite superior.
400	DomainInRiskList	The domain you added may be at risk. If you have any questions, please submit a ticket.	O nome de domínio adicionado pode representar um risco. Se você tiver alguma dúvida, abra um ticket.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.