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

Adiciona um nome de domínio acelerado.

Descrição da operação

Antes de adicionar um nome de domínio, você deve ativar a Content Delivery Network (CDN). Para mais informações, consulte Ativar a CDN.
Se a área acelerada estiver definida como China continental ou global, o nome de domínio acelerado deve ter um registro ICP.
Você pode adicionar apenas um nome de domínio acelerado por vez. Por padrão, cada usuário pode adicionar até 50 nomes de domínio. Para adicionar mais nomes de domínio, solicite um aumento de cota no Quota Center.
Cada usuário pode invocar esta operação até 100 vezes por hora.

Precauções

Após adicionar um nome de domínio invocando esta operação, há um período de vigência de 3 a 5 minutos para o nome de domínio. Não adicione nenhuma configuração durante este período. Aguarde até que o status do nome de domínio mude para online antes de prosseguir com outras configurações.

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

create

*Domínio.

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

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/áudio sob demanda Valores válidos: download : downloads de arquivos grandes. web : imagens e arquivos pequenos. video : streaming de vídeo/áudio sob demanda.	web
DomainName	string	Sim	O nome de domínio acelerado a ser adicionado à CDN. Nomes de domínio curinga são suportados. Um nome de domínio curinga deve começar com um ponto (.), como .example.com.	.example.com
ResourceGroupId	string	Não	O ID do grupo de recursos. Se você não especificar este parâmetro, o sistema usará automaticamente o ID do grupo de recursos padrão.	rg-acfmyuji4b6r4**
Sources	string	Sim	A lista de endereços de origem.	[ { "content": "192.0.2.0", "type": "ipaddr", "priority": "20", "port": 80, "weight": "15" } ]
CheckUrl	string	Não	A URL para verificações de integridade.	www.example.com/test.html
Scope	string	Não	A região acelerada. Valores válidos: domestic (padrão): 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
Tag	array<object>	Não	A lista de tags. Você pode especificar até 20 tags.
	object	Não
Key	string	Não	A chave da tag.	env
Value	string	Não	O valor da tag.	value

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. Valores válidos: ipaddr: endereço IP. domain: nome de domínio. oss: bucket do OSS. fc_domain: Function Compute.
content	String	Sim	O endereço de 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 a porta 443 ou 80, ou usar uma porta personalizada. O valor padrão é 80. A porta 443 suporta busca de origem HTTPS.
priority	String	Não	A prioridade dos endereços do servidor de origem. Valores válidos: 20 e 30. Valor padrão: 20. Um valor de 20 especifica o servidor de origem primário, e 30 especifica o servidor de origem secundário.
weight	String	Não	O peso de busca de origem. Valores válidos: 0 a 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	The specified source type does not match the specified source content.
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	Abs.CheckUrl.Malformed	The CheckUrl you provided is malformed.
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	DomainInBlacklist	The domain is in the blacklist.	O nome de domínio está na lista negra.
400	InvalidTagKey	The specified TagKey is invalid.	O parâmetro TagKey é inválido.
400	InvalidTagValue	The specified TagValue is invalid.
400	InvalidTagKey.Repeated	The specified TagKey is duplicated.
400	InvalidTag	The specified Tag is Invalid.
400	InvalidTagKey.OverLimit	The number of Tag can not over limit 20.
400	SourceInBlacklist	Source is in the blacklist.	O servidor de origem está na lista negra.
400	ReservedTagKey	The tag key is used internally as a reserved field and is not allowed to be used.	A chave da tag é usada como um campo reservado internamente e não pode ser utilizada.
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.
400	RegionNoResource	Resource allocation failed. Please submit a work order to contact customer service.	Falha na alocação de recursos. Abra um ticket para entrar em contato com o suporte ao cliente.
403	AccountException	Account exception. Please open ticket to make an appeal.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.