调用 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:
&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>