AddCdnDomain_内容分发_API文档-阿里云OpenAPI开发者门户

接口说明

添加域名之前，您需要先开通 CDN 服务。具体操作，请参见开通 CDN 服务。
加速域名必须已成功备案。
每次只能添加一个加速域名，每个用户最多可以添加 50 个域名。
源站内容如果不在阿里云平台上，需进行审核，审核工作会在下一个工作日前完成。
单个用户的调用频率：30 次/秒。

注意事项

通过接口添加了域名之后，将会有 3～5 分钟的域名生效时间，在这段时间内请不要添加任何配置，待域名状态处于 online 以后再进行下一步的配置。

流控信息

请求速率为5/1(s)。更多流控信息，请前往配额中心查看

授权信息

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

具体说明如下：展开详情

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

cdn:AddCdnDomain	Create	Domain acs:cdn:*:{#accountId}:domain/{#DomainName}	无	无

请求参数

字段名称	字段详情
CdnTypestring	加速域名的业务类型。取值：展开详情示例值:web枚举值:downloadwebvideo参考取值来源: DescribeCdnTypes
DomainNamestring	需要接入 CDN 的加速域名。展开详情示例值:.example.com参考取值来源: DescribeDomainQpsData BatchSetCdnDomainConfig SetCdnDomainStagingConfig ListRealtimeLogDeliveryDomains
ResourceGroupIdstring	资源组 ID。展开详情示例值:rg-acfmyuji4b6r4**
Sourcesstring	回源地址列表。示例值:[ { "content": "192.0.2.0", "type": "ipaddr", "priority": "20", "port": 80, "weight": "15" } ]
CheckUrlstring	健康检测 URL。示例值:www.example.com/test.html
Scopestring	加速区域。取值：展开详情示例值:domestic
TopLevelDomainstring	顶级接入域。示例值:example.com
Tagarray<object>	标签信息列表。最大可填入 20 个标签信息。子级条数 <= 21子级条数 >= 1

请求说明

Sources 参数的各字段含义如下表所示。

参数	类型	是否必选	描述
type	String	是	源站类型。取值： ipaddr：IP 源站。 domain：域名源站。 oss：OSS Bucket 为源站。 fc_domain：函数计算为源站。
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	Specified DomainName is malformed.	诊断
400	MissingParameter	The input parameter cdnType that is mandatory for processing this request is not supplied.	诊断
400	InvalidCdnType.Malformed	Specified CdnType is malformed.	诊断
400	InvalidSources.Malformed	Specified Sources is malformed.	诊断
400	InvalidSourceType.Malformed	Specified CdnType is malformed.	诊断
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.	诊断
400	SourceIp.Exceed	The Certificate you provided is malformed	诊断
400	InvalidCertificate	The Certificate you provided is malformed	诊断
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length	诊断
400	InnerAddDomainDenied	Your account has not bind aoneId, can not add domain.	诊断
400	CheckSourceHealthFailed	sources ip or source domain check health failed,please input right source.	诊断
400	ExtensiveAndAllBothExist	Extensive domain and the domain begins with all. can not exist at the same time.	诊断
400	CdnTypeNotSupportExtensiveDomain	Extensive domain not supported for this cdn type.	诊断
400	ExtensiveAndSpecificDomainConflict	The number of wildcard domain names exceeds the limit.	诊断
400	InvalidResourceGroupId.Malformed	Specified ResourceGroupId is malformed.	诊断
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.	诊断
400	InvalidTopLevelDomain.Malformed	Specified TopLevelDomain is malformed.	诊断
400	TopLevelDomain.NotFound	TopLevelDomain is not exist.	诊断
400	EntityNotExists.ResourceGroup	The resource group does not exist.	诊断
400	EntityNotExist.ResourceGroup	The resource group does not exist.	诊断
400	InvalidStatus.ResourceGroup	It is not allowed to do this operation because of the current status of resource-group.	诊断
400	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	诊断
400	Abs.CheckUrl.Malformed	The CheckUrl you provided is malformed.	诊断
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	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	InvalidTagKey	The specified TagKey is invalid.	诊断
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.	诊断
400	ReservedTagKey	The tag key is used internally as a reserved field and is not allowed to be used.	诊断
400	DomainOverLimit	The maximum number of domains is exceeded.	诊断
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.	诊断
403	AccountException	Account exception. Please open ticket to make an appeal.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-11-26	变更错误码400
	2024-11-15	变更请求参数Tag
	2024-09-03	变更错误码400
	2023-12-12	变更错误码400
	2023-08-08	删除请求参数GlobalResourcePlan
	2023-06-27	新增请求参数GlobalResourcePlan 删除返回参数
	2023-01-04	变更错误码400 新增返回参数
	2022-11-23	变更错误码400

AddCdnDomain_内容分发_API文档

接口说明

注意事项

流控信息

授权信息

请求参数

请求说明

返回参数

返回示例

错误码

变更历史

相关示例