调用ResolveAndRouteServiceInCen接口为本地网络添加访问云服务的配置。
背景信息
云服务指使用阿里云云服务地址段100.64.0.0/10提供服务的云产品,例如对象存储OSS(Object Storage Service)、日志服务SLS(Log Service)、数据传输服务DTS(Data Transmission Service)等。如果您的本地网络需要访问云服务,您需要将本地网络关联的边界路由器VBR(Virtual Border Router)实例或云连接网CCN(Cloud Connect Network)实例加载至云企业网,并且将云服务所在地域的一个专有网络VPC(Virtual Private Cloud)实例加载至该云企业网。加载后,您的本地网络可通过云企业网访问云服务所在地域的VPC实例,并通过该VPC访问云服务。
使用说明
-
VBR实例关联的本地网络只能通过云企业网访问和其同地域的云服务。
例如:云服务所在地域为华北2(北京),那么只有华北2(北京)地域下的VBR实例关联的本地网络可以访问云服务。
- ResolveAndRouteServiceInCen接口属于异步接口,即系统会先返回一个RequestId,但云服务配置并未添加完成,系统后台的添加任务仍在进行。您可以调用DescribeRouteServicesInCen接口查询云服务的状态。
- 当云服务处于Creating状态时,表示云服务配置正在添加中,在该状态下,您只能对云服务配置执行查询操作,不能执行其他操作。
- 当云服务处于Active状态时,表示云服务配置添加完成。
- 当云服务处于Failed状态时,表示云服务配置添加失败。
前提条件
在调用ResolveAndRouteServiceInCen接口前,确保满足以下条件:
- 您本地网络连接的VBR或CCN实例已经加载到云企业网。
- 云服务所在地域已有VPC实例加载至云企业网。具体操作,请参见AttachCenChildInstance。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ResolveAndRouteServiceInCen |
系统规定参数。取值:ResolveAndRouteServiceInCen。 |
| ClientToken | String | 否 | 02fb3da4**** |
客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
|
| CenId | String | 是 | cen-ckwa2hhmuislse**** |
云企业网实例ID。 |
| Host | String | 是 | 100.118.28.0/24 |
云服务IP地址或地址段。 说明 通常云服务会使用多个地址或地址段,建议您重复调用本接口,添加该云服务所有地址或地址段。
|
| HostRegionId | String | 是 | cn-hangzhou |
云服务所在的地域ID。 |
| HostVpcId | String | 是 | vpc-o6woh5s494zueq40v**** |
云服务关联的VPC实例ID。 |
| Description | String | 否 | descname |
云服务的描述信息。 描述信息可以为空或填写2~256个字符,必须以中文或者大小写字母开始,可包含数字、短划线(-)、半角句号(.)和下划线(_),不能以 |
| AccessRegionIds.N | String | 是 | cn-hangzhou |
访问云服务的地域ID。 您可以通过调用DescribeChildInstanceRegions接口获取地域ID。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | C0245BEF-52AC-44A8-A776-EF96FD26A5CA |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ResolveAndRouteServiceInCen
&ClientToken=02fb3da4****
&CenId=cen-ckwa2hhmuislse****
&Host=100.118.28.0/24
&HostRegionId=cn-hangzhou
&HostVpcId=vpc-o6woh5s494zueq40v****
&Description=descname
&公共请求参数
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ResolveAndRouteServiceInCenResponse>
<RequestId>C0245BEF-52AC-44A8-A776-EF96FD26A5CA</RequestId>
</ResolveAndRouteServiceInCenResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C0245BEF-52AC-44A8-A776-EF96FD26A5CA"
}
错误码
访问错误中心查看更多错误码。