更新时间:2022-08-30 GMT+08:00
分享

批量发布或下线API

功能介绍

将多个API发布到一个指定的环境,或将多个API从指定的环境下线。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/HTTPS请求方法以及URI

请求方法

URI

POST

/v1/{project_id}/apigw/instances/{instance_id}/apis/publish[?action]

URI中的参数说明如下表所示。

表2 参数说明

名称

是否必选

类型

说明

project_id

String

项目ID。可从控制台“我的凭证”中获取region下项目ID,管理员权限可查询。

instance_id

String

实例ID,可从API网关控制台的专享版实例信息中获取。

action

String

online:发布

offline:下线

请求消息

表3 参数说明

参数

是否必选

类型

说明

apis

String Array

需要发布或下线的API ID列表

env_id

String

环境ID

remark

String

对本次发布的描述信息

字符长度不超过255

说明:

中文字符必须为UTF-8或者unicode编码。

请求消息样例:

{
	"apis": ["81efcfd94b8747a0b21e8c04144a4e8c","7addcd00cfab433984b1d8bf2fe08aaa"],
	"env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID",
	"remark": "发布到生产环境"
}

响应消息

表4 参数说明

名称

类型

说明

success

Array

发布或下线成功的信息

failure

Array

发布或下线失败的API及错误信息

表5 success参数说明(批量发布)

名称

类型

说明

publish_id

String

发布记录的ID

api_id

String

发布成功的API ID

api_name

String

发布成功的APi名称

env_id

String

发布环境的ID

remark

String

发布描述信息

publish_time

Timestamp

发布时间

version_id

String

版本号

表6 success参数说明(批量下线)

名称

类型

说明

api_id

String

下线成功的API ID

api_name

String

下线成功的API名称

表7 failure参数说明

名称

类型

说明

api_id

String

发布或下线失败的API ID

api_name

String

发布或下线失败的API名称

error_code

String

发布或下线失败的错误码

error_msg

String

发布或下线失败的错误信息

响应消息样例:

{
	"success": [{
		"publish_id": "5b729aa252764739be2c37ef0d66dc63",
		"api_id": "7addcd00cfab433984b1d8bf2fe08aaa",
                "api_name": "testApi",
		"env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID",
		"version_id": "3d9dcb733ba34352b0d02f85fd16b026",
		"remark": "string",
		"publish_time": "2018-07-26T13:18:04.1079916Z"
	}],
	"failure": [{
		"api_id": "81efcfd94b8747a0b21e8c04144a4e8c",
		"error_code": "APIG.3002",
		"error_msg": "api with id 81efcfd94b8747a0b21e8c04144a4e8c not found"
	}]
}

状态码

表8 返回消息说明

状态码

说明

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Server Internal Error

相关文档