AddDcdnDomain_全站加速_API文档-阿里云OpenAPI开发者门户

接口说明

创建域名之前，您必须先开通 DCDN 服务。具体操作，请参见 OpenDcdnService 。
域名必须已成功备案。
当您首次将新域名添加至阿里云 DCDN 时，需按要求做域名归属权验证。具体操作，请参见 VerifyDcdnDomainOwner 。
每次只能添加一个加速域名，每个用户最多可以添加 50 个域名。
如果源站内容不在阿里云平台上，阿里云平台需要对内容进行审核，审核工作会在下一个工作日前完成。
单用户调用频率：30 次/秒。

流控信息

请求速率为5/1(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

dcdn:AddDcdnDomain	Create	Domain acs:dcdn:*:{#accountId}:domain/{#DomainName}	无	无

请求参数

字段名称	字段详情
DomainNamestring	待添加的加速域名，仅支持添加单个域名。展开详情示例值:example.com参考取值来源: AddDcdnIpaDomain DescribeDcdnWafDomains BatchAddDcdnDomain
ResourceGroupIdstring	资源组 ID。不传该参数时，系统自动补全默认资源组 ID。示例值:rg-acfmyuji4b6r4**
Sourcesstring	回源地址列表。示例值:[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80}]
CheckUrlstring	健康检测 URL。示例值:www.example.com/test.html
Scopestring	加速区域。取值：展开详情示例值:domestic
TopLevelDomainstring	顶级接入域。示例值:yourTopLevelDomain
Tagarray<object>	标签信息。最多 20 个标签。子级条数 <= 21
Scenestring	加速场景。支持：展开详情示例值:apiscene
FunctionTypestring	计算服务类型。取值：展开详情示例值:routine

请求说明

Sources 各字段含义如下所示。

参数	类型	是否必选	描述
type	String	是	源站类型。ipaddr：IP 源站；domain：域名源站；oss：OSS Bucket 为源站。
content	String	是	回源地址，可以是 IP 或域名。
port	Integer	否	可以指定 443、80 端口，也可以自定义端口，默认值 80。443 是 HTTPS 协议回源。
priority	String	否	源站地址对应的优先级，支持 20 和 30，默认 20。20 是主源，30 是备源。
weight	String	否	回源权重，100 以内，默认 10。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:15C66C7B-671A-4297-9187-2C4477247A74

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidDomainName.Malformed	The specified DomainName is invalid.	诊断
400	InvalidSource.Content.Malformed	The specified Source Content is invalid.	诊断
400	MissingSource.Content	The Source Content must be specified.	诊断
400	MissingSource.Type	The Source Type must be specified.	诊断
400	InvalidSource.Type.Malformed	The specified Source Type is invalid.	诊断
400	InvalidSource.Priority.Malformed	The specified Source Priority is invalid.	诊断
400	InvalidScope.Malformed	The specified Scope is invalid.	诊断
400	SourceIp.Exceed	The maximum number of back-to-origin IP addresses is exceeded.	诊断
400	InvalidCertificate	The specified certificate format is invalid.	诊断
400	InvalidCertificate.TooLong	The maximum length of the certificate is exceeded.	诊断
400	CheckSourceHealthFailed	Error checking the security. Provide the valid origin site information.	诊断
400	ExtensiveAndAllBothExist	A wildcard domain name and a domain name with an all. prefix cannot be both specified.	诊断
400	CdnTypeNotSupportExtensiveDomain	Wildcard domain names are not supported.	诊断
400	ExtensiveAndSpecificDomainConflict	The wildcard domain name overlaps a domain name at the same level.	诊断
400	InvalidResourceGroupId.Malformed	The specified ResourceGroupId is invalid.	诊断
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.	诊断
400	InvalidDomainNameLevel	The alicdn.com domain supports a maximum of three levels of domain.	诊断
400	EntityNotExists.ResourceGroup	The resource group does not exist.	诊断
400	InvalidStatus.ResourceGroup	The current status of the resource group does not support this operation.	诊断
400	NotInternationRealIdentity	Real-name registration is required for services offered in Mainland China.	诊断
400	TopLevelDomain.NotFound	The specified TopLevelDomain does not exist.	诊断
400	RecordCheckNotAvailable	The ICP filing interface is unavailable. Please try again later.	诊断
400	IcpBlack	The domain is on the ICP blacklist.	诊断
400	IspBlack	The domain is on the ISP blacklist.	诊断
400	InvalidCheckUrl.Malformed	The specified CheckUrl is invalid.	诊断
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	诊断
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.	诊断
400	DomainInBlacklist	The domain is in the blacklist.	诊断
400	DomainOverLimit	The maximum number of domains is exceeded.	诊断
400	SourceInBlacklist	Source is in the blacklist.	诊断
400	InvalidTagKey	The key should not be null, start with "acs:" or "aliyun", contain "http://" or "https://" or have special symbols:.!@#$%?/^&*)(+={}[]",'<>~·`?;.	诊断
400	InvalidTagValue	The tag value cannot contain these special symbols:http://, https://	诊断
400	ReservedTagKey	The tag key is used internally as a reserved field and is not allowed to be used.	诊断
400	InvalidFunctionType.Malformed	The specified FunctionType is invalid.	诊断
400	InvalidfunctionType.Malformed	FunctionType is malformed.	诊断
400	DomainInRiskList	The domain you added may be at risk. If you have any questions, please submit a ticket.	诊断
400	RegionNoResource	Resource allocation failed. Please submit a work order to contact customer service.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-11-26	变更错误码400
	2024-09-03	变更错误码400
	2023-12-13	变更错误码400
	2023-12-12	变更错误码400
	2023-08-29	变更错误码400 变更请求参数Sources 新增请求参数FunctionType
	2023-01-04	新增返回参数
	2022-11-24	变更错误码400
	2022-10-27	变更错误码400

AddDcdnDomain_全站加速_API文档

接口说明

流控信息

授权信息

请求参数

请求说明

返回参数

返回示例

错误码

变更历史

相关示例