BatchAddDcdnDomain_全站加速_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

前提条件

  • 创建加速域名之前,必须先开通 DCDN 服务
  • 加速域名已完成备案。
  • 当您首次将新域名添加至阿里云 DCDN 时,需按要求做域名归属权验证。具体操作,请参见 VerifyDcdnDomainOwner
说明
  • 源站内容,如果不在阿里云平台上,需要审核,审核工作会在下一工作日前完成。
  • 单次配置的域名数量不超过 50 个。
  • 单用户调用频率:30 次/秒。
  • 流控信息

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

    授权信息

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

    具体说明如下:展开详情

    操作访问级别资源类型条件关键字关联操作
    dcdn:BatchAddDcdnDomain
    Create
    Domain
    acs:dcdn:*:{#accountId}:domain/{#domainName}

    请求参数

    字段名称字段详情
    DomainNamestring

    DCDN 加速域名,一个用户最多添加 20 个域名。多个域名使用半角逗号(,)分隔。

    示例值:example.com,example.org参考取值来源:
      AddDcdnIpaDomain
      DescribeDcdnWafDomains
      BatchSetDcdnDomainConfigs
    ResourceGroupIdstring

    资源组 ID,不传时,自动补全默认资源组 ID。

    示例值:testID
    Sourcesstring

    回源地址列表。

    示例值:[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80,"weight":"15"}]
    CheckUrlstring

    健康检测 URL。

    示例值:www.example.com/test.html
    Scopestring

    加速区域。取值:展开详情

    示例值:domestic
    TopLevelDomainstring

    顶级接入域。

    示例值:example.com

    请求说明

    Sources 各字段含义如下所示:

    参数类型是否必选描述
    typeString源站类型。取值:
    ipaddr:IP 源站。
    domain:域名源站。
    oss:OSS Bucket 为源站。
    fc_domain:函数计算源站。
    contentString回源地址,可以是 IP 或域名。
    portInteger端口。取值:
    80:默认端口。
    443:支持 HTTPS 协议回源。
    自定义端口。
    priorityString源站地址对应的优先级。取值:
    20:主源(默认值)。
    30:备源。
    weightString回源权重,100 以内,默认值为 10。

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:15C66C7B-671A-4297-9187-2C4477247A74

    返回示例

    错误码

    全局错误码
    HTTP 状态码错误码错误信息操作
    400
    InvalidDomainName.Malformed
    The specified DomainName is invalid.诊断
    400
    InvalidSources.Malformed
    The specified Sources is invalid.诊断
    400
    InvalidScope.Malformed
    The specified Scope is invalid.诊断
    400
    InvalidSource.Priority.Malformed
    The specified Source Priority 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
    TopLevelDomain.NotFound
    The specified TopLevelDomain does not exist.诊断
    400
    EntityNotExists.ResourceGroup
    The resource group does not exist.诊断
    400
    EntityNotExist.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
    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
    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.诊断

    变更历史

    变更时间变更内容概要操作
    2024-09-03
    变更错误码400
    2022-10-27
    变更错误码400

    相关示例

    DCDN添加/删除加速域名示例
    2021-12-17