调用 ProductBindBsn 生成备案服务号。

根据参数指定的账户、云产品类型和实例 ID 生成备案服务号。每个实例可以生成的服务号个数不能超过商务合作确认的限量。

  • 只有正常运行状态下的云产品实例,可以生成备案服务号。
  • 无公网 IP 的云产品无需备案,无法生成备案服务号。
  • 合作伙伴使用自有 IP 云产品无法生成备案服务号。

请求参数

名称 类型 是否必填 示例值 描述
Action String ProductBindBsn 操作接口名,系统规定参数,取值:ProductBindBsn
resourceType Integer 1

指当前需要生成备案服务号的云产品类型,取值:

  • 1:ECS
  • 2:SLB
  • 3:ACE
  • 4:云市场
  • 5:WEBAPP
  • 6:NAT
  • 7:NAT64
  • 8:ENS
  • 9:云虚拟主机
resourceId String 41****34 新生成备案服务号绑定的云产品实例 ID
aliuid Long 456*******163 云产品实例拥有者的阿里云账号 ID
num Integer 4 一次调用生成的备案服务号个数,最大 20 个

返回参数

名称 类型 描述
datas List<BsnPopDO> 新生成并绑定到指定账号和实例的备案服务号列表,服务号状态为已绑定时,可以到备案平台提交备案。BSN 对象列表,请参见表 1
表 1. BSN 对象列表
名称 类型 示例值 描述
aliUid Long 456*******163 备案服务号绑定的云产品实例拥有者的阿里云账号 ID
resourceType Integer 1

备案服务号绑定的云产品类型

  • 1:ECS
  • 2:SLB
  • 3:ACE
  • 4:云市场
  • 5:WEBAPP
  • 6:NAT
  • 7:NAT64
  • 8:ENS
  • 9:云虚拟主机
resourceId String ATX140*******c6f 备案服务号绑定的云产品实例 ID
sn String 4f9f0d9c-*******69448375e0f8 备案服务号,一个备案服务号可以到阿里云备案平台提交一个网站备案
status Integer 1 备案服务号的状态:
  • 0:未绑定,备案服务号还未绑定产品实例
  • 1:已绑定,备案服务号已绑定产品实例,可到备案平台提交备案,已绑定服务号不可解绑
  • 2:已备案,备案服务号提交的备案已经完成
  • 3:已失效,因管理原因,备案服务号作废
  • 4:备案中,备案服务号已经提交备案请求,处于审核过程中
beianNum String - 备案服务号提交备案成功后,工信部下发的网站备案号,备案未成功时此参数值为空
opSource Integer 2 恒等于 2,调用方不必关注

请求示例

https://bsn.aliyuncs.com/?Action=ProductBindBsn
&resourceType=1
&resourceId=412***634
&aliuid=456*******163
&num=4
&<公共请求参数>

返回示例

XML 格式

<GetBsnByResourceResponse>
  <datas>
    <bsnDO>
      <beianNum></beianNum>
      <resourceId>ATX140519190523990c6f</resourceId>
      <sn>4f9f0d9c-cc50-4eaf-a116-69448375e0f8</sn>
      <status>1</status>
      <aliUid>137*******210</aliUid>
      <opSource>2</opSource>
      <resourceType>1</resourceType>
    </bsnDO>
    <bsnDO>
      <beianNum></beianNum>
      <resourceId>ATX140519190523990c6f</resourceId>
      <sn>49d744b0-8b0a-4c93-b2b4-0e47d9d661b1</sn>
      <status>1</status>
      <aliUid>137*******210</aliUid>
      <opSource>2</opSource>
      <resourceType>1</resourceType>
    </bsnDO>
    <bsnDO>
      <beianNum></beianNum>
      <resourceId>ATX140519190523990c6f</resourceId>
      <sn>4867de58-9d37-11e3-91d8-a4badb4d407b</sn>
      <status>1</status>
      <aliUid>137*******210</aliUid>
      <opSource>2</opSource>
      <resourceType>1</resourceType>
    </bsnDO>
  </datas>
</GetBsnByResourceResponse>

JSON 格式

{
  "datas": {
  "bsnDO": [
   {
     "resourceId": "ATX140519190523990c6f",
     "sn": "4f9f0d9c-cc50-4eaf-a116-69448375e0f8", "status": "1",
     "aliUid": "1378287435933210",
     "opSource": "2",
     "resourceType": "1"
   },
   {
     "resourceId": "ATX140519190523990c6f",
     "sn": "49d744b0-8b0a-4c93-b2b4-0e47d9d661b1",
     "status": "1",
     "aliUid": "1378287435933210",
     "opSource": "2",
     "resourceType": "1"
   },
   {
     "resourceId": "ATX140519190523990c6f",
     "sn": "4867de58-9d37-11e3-91d8-a4badb4d407b", "status": "1",
     "aliUid": "1378287435933210",
     "opSource": "2",
     "resourceType": "1"
   }
  ]
 }
}

错误码

HttpCode 错误码 错误信息
400 401 账号 ID 无效
400 402 实例无效
400 403 当前实例无可备案 IP
400 409 UID 不属于当前操作的 BID,绑定失败
400 410 试用产品不能绑定备案服务号
400 411 该产品类型不能绑定备案服务号
400 412 绑定账号不是实例拥有者
400 413 当前实例状态不适合备案
400 414 此实例 ID 累计时长不足 3 个月,不支持申请备案服务号
400 415 UID 不属于当前操作的 MPK,绑定失败
400 504 操作失败
400 507 接口异常
400 509 查询实例信息异常,请稍后再试
400 511 读取数据异常,请稍后再试
400 602 必填参数不能为空
400 603 备案服务号限制为每次 1-20 个
400 609 该实例绑定备案服务号个数已达上限

添加 JAVA 的 maven 依赖

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-beian</artifactId>
    <version>2.0.11</version>
</dependency>

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.4.7</version> 
</dependency>