获取参数 API
编辑获取参数 API
编辑根据提供的标准检索参数。
请求
编辑GET <kibana host>:<port>/api/synthetics/params/{id?}
GET <kibana host>:<port>/s/<space_id>/api/synthetics/params/{id?}
先决条件
编辑您必须在可观测性部分的Synthetics功能中拥有read
权限,请参阅Kibana 功能权限。
查询参数
编辑-
id
- (可选,字符串)参数的唯一标识符。 如果提供此参数,此 API 将按其 ID 检索特定参数。 如果未提供,它将检索所有参数的列表。
响应示例
编辑API 响应包括作为 JSON 对象的参数,其中每个参数对象具有以下属性
-
id
(字符串): 参数的唯一标识符。 -
key
(字符串): 参数的键。
如果用户对 Synthetics 应用程序具有只读权限,则将包含以下附加属性
-
description
(字符串,可选):参数的描述。 -
tags
(字符串数组,可选):与参数关联的标签数组。 -
namespaces
(字符串数组): 与参数关联的命名空间。
如果用户具有写入权限,则将包含以下附加属性
-
value
(字符串): 与参数关联的值。
以下是通过 ID 检索单个参数的请求示例
GET /api/synthetics/params/unique-parameter-id
以下是通过 ID 检索单个参数的响应示例
对于具有只读权限的用户
{ "id": "unique-parameter-id", "key": "your-api-key", "description": "Param to use in browser monitor", "tags": ["authentication", "security"], "namespaces": ["namespace1", "namespace2"] }
对于具有写入权限的用户
{ "id": "unique-parameter-id", "key": "your-param-key", "description": "Param to use in browser monitor", "tags": ["authentication", "security"], "namespaces": ["namespace1", "namespace2"], "value": "your-param-value" }
以下是检索参数列表的响应示例
对于具有只读权限的用户
[ { "id": "param1-id", "key": "param1", "description": "Description for param1", "tags": ["tag1", "tag2"], "namespaces": ["namespace1"] }, { "id": "param2-id", "key": "param2", "description": "Description for param2", "tags": ["tag3"], "namespaces": ["namespace2"] } ]
对于具有写入权限的用户
[ { "id": "param1-id", "key": "param1", "description": "Description for param1", "tags": ["tag1", "tag2"], "namespaces": ["namespace1"], "value": "value1" }, { "id": "param2-id", "key": "param2", "description": "Description for param2", "tags": ["tag3"], "namespaces": ["namespace2"], "value": "value2" } ]