创建私有位置 API
编辑创建私有位置 API编辑
使用以下架构创建私有位置。
请求编辑
POST <kibana 主机>:<端口>/api/synthetics/private_locations
POST <kibana 主机>:<端口>/s/<空间 ID>/api/synthetics/private_locations
先决条件编辑
您必须在 Kibana 功能权限 的可观测性 部分中拥有 Synthetics 和 Uptime 功能的 所有 权限。
请求正文编辑
请求正文应包含以下属性
-
标签 - （必填，字符串）私有位置的标签。
-
代理策略 ID - （必填，字符串）与私有位置关联的代理策略的 ID。
-
标签 - （可选，字符串数组）用于对私有位置进行分类的标签数组。
-
地理位置 -
（可选，对象）位置的地理坐标（WGS84）。它应包含以下属性
-
纬度（必填，数字）：位置的纬度。 -
经度（必填，数字）：位置的经度。
-
示例编辑
以下是创建私有位置的 POST 请求示例
POST /api/private_locations
{
"label": "Private Location 1",
"agentPolicyId": "abcd1234",
"tags": ["private", "testing"],
"geo": {
"lat": 40.7128,
"lon": -74.0060
}
}
API 如下返回创建的私有位置
{
"id": "abcd1234",
"label": "Private Location 1",
"agentPolicyId": "abcd1234",
"tags": ["private", "testing"],
"geo": {
"lat": 40.7128,
"lon": -74.0060
}
}
如果 agentPolicyId 已被现有私有位置使用，或者 label 已存在，则 API 将返回 400 错误请求 响应，并显示相应的错误消息。