調用 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 對象列表,請參見BSN 對象列表
表 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>137828743593****</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>137828743593****</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>137828743593****</aliUid>
      <opSource>2</opSource>
      <resourceType>1</resourceType>
    </bsnDO>
  </datas>
</GetBsnByResourceResponse>

JSON 格式

{
  "datas": {
  "bsnDO": [
   {
     "resourceId": "ATX140519190523990c6f",
     "sn": "4f9f0d9c-cc50-4eaf-a116-69448375e0f8", "status": "1",
     "aliUid": "137828743593****",
     "opSource": "2",
     "resourceType": "1"
   },
   {
     "resourceId": "ATX140519190523990c6f",
     "sn": "49d744b0-8b0a-4c93-b2b4-0e47d9d661b1",
     "status": "1",
     "aliUid": "137828743593****",
     "opSource": "2",
     "resourceType": "1"
   },
   {
     "resourceId": "ATX140519190523990c6f",
     "sn": "4867de58-9d37-11e3-91d8-a4badb4d407b", "status": "1",
     "aliUid": "137828743593****",
     "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>