调用ModifyCdnDomain修改加速域名信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyCdnDomain |
操作接口名,系统规定参数。取值:ModifyCdnDomain。 |
DomainName | String | 是 | example.com |
加速域名,仅支持修改单个域名。 |
Sources | String | 否 | [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80,"weight":"15"}] |
回源地址列表。 说明 不支持同时传入Sources和TopLevelDomain参数,如果您同时传入Sources和TopLevelDomain参数,TopLevelDomain将不生效。
|
ResourceGroupId | String | 否 | rg-acfmyuji4b6r4** |
资源组ID。 |
TopLevelDomain | String | 否 | your.top.domain.com |
顶级接入域。只有白名单用户CDN_TOP_LEVEL_DOMAIN_GREY_USER_LIST设置才有效。 说明 不支持同时传入Sources和TopLevelDomain参数,如果您同时传入Sources和TopLevelDomain参数,TopLevelDomain将不生效。
|
Sources各字段含义如下所示。
参数 |
类型 |
是否必选 |
描述 |
---|---|---|---|
type |
String |
是 |
源站类型。 ipaddr:IP源站。 domain:域名源站。 oss:OSS Bucket为源站。 fc_domain:函数计算源站。 |
content |
String |
是 |
回源地址,可以是IP或域名。 |
port |
Integer |
否 |
端口,可以指定80、443,也可以自定义端口,默认值为80。443是HTTPS协议回源。 |
priority |
String |
否 |
源站地址对应的优先级,支持20和30,默认值为20。20是主源,30是备源。 |
weight |
String |
否 |
回源权重,100以内,默认值为10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
http(s)://cdn.aliyuncs.com/?Action=ModifyCdnDomain
&SourceType=domain
&DomainName=example.com
&Sources=[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80,"weight":"15"}]
&<公共请求参数>
正常返回示例
XML
格式
<ModifyCdnDomainResponse>
<RequestId>94E3559F-7B6A-4A5E-AFFD-44E2A208A249</RequestId>
</ModifyCdnDomainResponse>
JSON
格式
{ "RequestId": "94E3559F-7B6A-4A5E-AFFD-44E2A208A249" }
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | EntityNotExists.ResourceGroup | The resource group does not exist. | 资源组不存在。 |
400 | TopLevelDomain.NotFound | TopLevelDomain is not exist. | TopLevelDomain不存在。 |
访问错误中心查看更多错误码。