使用说明

OpenAPI 4.0 接口是混合云目前针对 4.0 资源池纳管后，对第三方使用的接口。

接口使用前提条件：

确定项目建设的资源池底座是4.0

确定项目使用的混合云云管版本（最低1.12.12及以上版本）支持 openapi4.0

根据文档接口评估功能满足情况，不满足需求的功能，通过项目提需求，排期提供。

1.15及以下版本，调用方式为http://云管web访问的IP地址+12315端口
1.16及以上版本，调用方式为

配置host<云管ip> ct-global.ctapi.ctyun.local

使用 http://ct-global.ctapi.ctyun.local:12320 访问，需要注意如果需要平台接入单独联系一下混合云支持

调用接口入参和返回主要需要兼容多余字段增加
比如：接口 A 在第一期发布时入参时a,b两个参数，返回有 c,d字段，第二期兼容格式迭代，入参为a,b,c(非必填)，返回为 c,d,e字段。

调用接口需要签名认证，具体查看网关签名说明

接口限流单用户单接口并发1个/s，不同用户并发之间互不影响

与负责环境的运维工作人员确认调用网关的具体地址路径。

获取签名认证所需的ak/sk信息。
-获取用户型ak/sk：通过云管界面用户信息获取ctyun-eop-ak,ctyun-eop-sk ，注意不建议使用超管创建和管理资源。特殊情况下使用超管创建和管理资源需云管版本1.14.16后才支持api管理其资源。
未命名图片.png

依据网关签名说明或混合云签名算法demo构造网关签名认证所需的请求头信息。

根据上述获取的信息调用接口，示例如下：

调用接口所需信息	描述	范例值
调用接口及入参	通过部署的网关地址端口调用接口	http://ip:port/v4/vpc/get-nat-gateway-attribute?regionID=nm8&natGatewayID=natgw-u4z12jh88f
请求头参数	新增请求头hybrid-date	20230403T154057Z
请求头参数	新增请求头ctyun-hybrid-request-id	0y13p5g41hwr
请求头参数	新增请求头Hybrid-Authorization	470bbc5b-10f5-4d7f-bae6-2275046380b3 Header=hybrid-date;ctyun-hybrid-request-id Signature=ejXRxfQRbpKRzDKd24QV55Bgih4j4iQJVVZdfBa6xLY=

若请求返回信息为网关常见问题说明中签名插件常见问题，则网关签名认证未能通过，请返回上一步骤确认构造签名认证所需请求头信息中存在的问题。

若返回信息为接口文档中对应返回示例，则接口调用成功。

调用成功示例:
{
"description":"成功",
"errorCode":"SUCCESS",
"message":"success",
"returnObj":{},
"statusCode":800
}