文档首页/ 应用管理与运维平台 ServiceStage/ API参考/ 应用管理API（v3版本）/ 配置管理/ 根据配置文件ID获取配置文件历史
更新时间：2024-12-16 GMT+08:00
查看PDF
分享

根据配置文件ID获取配置文件历史

功能介绍

此API用于通过配置文件ID获取配置文件历史。

URI

GET /v3/{project_id}/cas/configs/{config_id}/histories

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID。获取方法，请参考获取项目ID。

config_id

是

String

配置文件ID。获取方法，请参考获取配置文件信息。
表2 查询参数

参数

是否必选

参数类型

描述

limit

否

integer

指定个数，取值[0, 100]。

offset

否

integer

指定偏移量。

order_by

否

String

排序字段，默认按创建时间排序。

排序字段支持枚举值：

  • create_time，配置文件创建时间。
  • name，配置文件名称。
  • update_time，配置文件修改时间。

order

否

String

排序方式。

  • desc，降序排序，默认排序方式。
  • asc，升序排序。

请求消息

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），默认取值为“application/json;charset=utf8”。

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考认证鉴权。

响应消息

表4 响应参数

参数

参数类型

描述

count

Integer

配置文件历史总数。

histories

Array of objects

配置文件历史列表，请参考表5。
表5 histories

参数

参数类型

描述

config_history_id

String

配置文件历史ID。

config_id

String

配置文件ID。

content

String

配置文件历史内容。

version

String

配置文件历史版本。

create_time

Integer

创建时间。

components

Array of objects

配置文件绑定的组件，请参考表6。

creator

String

创建人。

group_id

String

配置分组ID。

config_name

String

配置文件名称。

description

String

配置文件描述。

sensitive

Boolean

配置文件内容是否加密：

  • true，加密。
  • false，不加密。
表6 components

参数

参数类型

描述

application_id

String

应用ID。

component_id

String

组件ID。

component_name

String

组件名称。

environment_id

String

环境ID。

请求示例

无

响应示例

{
	"count": 2,
	"histories": [{
		"config_history_id": "e9c52a5f-0f7c-48a2-b89c-29dd349d1a35",
		"config_id": "f5a52d93-1587-45cf-b8fe-5c7f204b98d1",
		"content": "testKey = valueModify",
		"type": "properties",
		"version": "v2",
		"create_time": 1717491574202,
		"components": [{
			"application_id": "8a3be48a-6401-4e8c-bbce-033745252227",
			"component_id": "4b611997-4acd-4538-a06b-32fd2475e057",
			"component_name": "component-test",
			"environment_id": "d2d7180c-7739-4cbb-bd8e-0911ba31cf51"
		}],
		"creator": "ss-test",
		"group_id": "4808b50d-d7f3-401b-9175-968cb4f9892b",
		"config_name": "test-config1",
		"description": "",
		"sensitive": false
	},
	{
		"config_history_id": "adacc5dc-a497-4023-b292-3b3cf37347f8",
		"config_id": "f5a52d93-1587-45cf-b8fe-5c7f204b98d1",
		"content": "testKey = testValue",
		"type": "properties",
		"version": "v1",
		"create_time": 1717491445668,
		"components": [{
			"application_id": "8a3be48a-6401-4e8c-bbce-033745252227",
			"component_id": "4b611997-4acd-4538-a06b-32fd2475e057",
			"component_name": "component-test",
			"environment_id": "d2d7180c-7739-4cbb-bd8e-0911ba31cf51"
		}],
		"creator": "ss-test",
		"group_id": "4808b50d-d7f3-401b-9175-968cb4f9892b",
		"config_name": "test-config1",
		"description": "",
		"sensitive": false
	}]
}

状态码

状态码

描述

204

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

错误码格式为：SVCSTG.00100.[Error_ID]，例如：SVCSTG.00100400。错误码说明请参考ServiceStage错误码。

父主题： 配置管理