实体表示对象或资源需要监听华体会联盟hth可创建实体监听网站 网页服务 或机房服务器 或服务器实例实体只代表监测系统中的一个项举个例子,如果你想监听集群中每个服务器,你就会为每个服务器创建实体无法创建单个实体代表整个集群
实体可多检查相关多检查使你能够检查同一主机多服务,对同一个实体设置多检查,而不是多实体单检查
创建监视系统新实体时,应具体说明下列信息:
属性化
| 名称 | 描述性 | 验证 |
|---|---|---|
| 标签标签 | 定义实体名称 | 1至255字符间字符串长 非空字符串 |
| 代理器_id | 代理实体受约束 | 可选性 字符串匹配regex /^[-.\w]{1,255}$/ |
| i_地址 | hashIP地址可用此实体检查引用 | 可选性 哈希[ string, string介于1至64字符间长:IPv4或IPv6地址 数组或对象数组或项目介于0至64 |
| 管理式 | 华体会联盟hth实体是否由Rackspace托管云管理 | 可选性 布尔 |
| 元数据 | 任意密钥/值在警示阶段传递 | 可选性 哈希[ string, string介于1至255字符间长:String,String介于1至255字符间长 *数项数组或对象0至256 |
| 里头 | 华体会联盟hthracspace云标识符华体会联盟hth仅适用于racspace云服务器 | 可选性 字符串 |
使用下列实体API运维创建和管理实体
创建实体
POST/实体
使用有效属性集创建新实体实体属性表格内
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 201 | 好 | 地址头含有连接新创建实体的链路 |
| 400 | 坏请求 | 系统请求中接收无效值 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
实例创建实体:JSON请求
{{
标签: 布兰德新实体
i_地址
"entity_ip_addresses_hash_key": "127.0.0.4",
B:127.0.05
C127.0.06.
测试127.0.07
},
元数据
全名: 金字塔
上下上下下下下
Can: go
内值无效
}
}
操作不返回响应体
列表实体账号
获取/实体
列表关联实体
操作可分解信息见粘贴集合.
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 二百 | 好 | 请求完成 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
示例列表实体记账:JSON响应
{{
值:
{{
id: enAAA
标签: 布兰德新实体
i_地址
"entity_ip_addresses_hash_key": "127.0.0.4",
B:127.0.05
C127.0.06.
测试127.0.07
},
元数据
全名: 金字塔
上下上下下下下
Can: go
内值无效
}
}
万事通
元数据
计数数数:1
限值: 50
标志号:Null
ext_marce:Null
exthref无效
}
}
通过ID获取实体
Get/entity/{entityId}
返回指定实体信息
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 二百 | 好 | 请求完成 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 404 | 未找到 | URL、实体或帐户请求系统中找不到 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
示例通过ID获取实体:JSON响应
{{
id: enAAA
标签: 布兰德新实体
i_地址
"entity_ip_addresses_hash_key": "127.0.0.4",
B:127.0.05
C127.0.06.
测试127.0.07
},
元数据
全名: 金字塔
上下上下下下下
Can: go
内值无效
}
}
以ID更新实体
PUT/实体/{实体Id}
更新实体实体Id.可部分更新实体提交更新请求时,只指定要更新的参数
华体会联盟hthRackspace托管云资源多字段由Rackspace管理如果您更新这些实体,您只能更新元数据并代理器_id字段使用a其它属性,像标签标签并i_地址更新源系统信息举个例子,如果你更新MyCloud控制板云服务器实例标签,匹配实体标签数秒内自动更新完整实体属性表参考实体属性表.
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 204 | 好 | 服务器满足请求,但无需返回实体实体 |
| 400 | 坏请求 | 系统请求中接收无效值 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 404 | 未找到 | URL、实体或帐户请求系统中找不到 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
实例更新实体:JSON请求
{{
标签: 布兰德新实体2
}
下操作不返回响应体
逐ID删除实体
DELETE/实体/{实体Id}
从您的账号删除指定实体并删除为该实体定义的任何检查和报警
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 204 | 好 | 服务器满足请求不返回响应体 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 404 | 未找到 | URL、实体或帐户请求系统中找不到 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
操作不返回响应体