http APIリストについては、公式ドキュメントをご参照ください。ハイパーリンクのログインが見えます。
エージェント
エージェントエンドポイントはローカルエージェントとやり取りするために使われ、一般的に登録や登録確認に使われます
/v1/agent/checks : 返回本地agent注册的所有检查(包括配置文件和HTTP接口)
/v1/agent/services : 返回本地agent注册的所有 服务
/v1/agent/members : 返回agent在集群的gossip pool中看到的成员
/v1/agent/self : 返回本地agent的配置和成员信息
/v1/agent/join/<address> : 触发本地agent加入node
/v1/agent/force-leave/<node>>: 强制删除node
/v1/agent/check/register : 在本地agent增加一个检查项,使用PUT方法传输一个json格式的数据
/v1/agent/check/deregister/<checkID> : 注销一个本地agent的检查项
/v1/agent/check/pass/<checkID> : 设置一个本地检查项的状态为passing
/v1/agent/check/warn/<checkID> : 设置一个本地检查项的状态为warning
/v1/agent/check/fail/<checkID> : 设置一个本地检查项的状态为critical
/v1/agent/service/register : 在本地agent增加一个新的服务项,使用PUT方法传输一个json格式的数据
/v1/agent/service/deregister/<serviceID> : 注销一个本地agent的服务项
例:
現地代理店が登録したすべてのサービスが返却されます
http://itsvse:8500/v1/agent/services
{ "20210305111225232--1862594008": { 「ID」:「20210305111225232--1862594008」 「Service」:「Itsvse.API」、 「タグ」: ["test"], 「メタ」:{ 「製品」:「建築家」 「バージョン」:「3.9.0.0」 }, 「ポート」:9002、 「アドレス」:「192.168.130.7」 「タグ付きアドレス」: { 「lan_ipv4」:{ 「アドレス」:「192.168.130.7」 「ポート」:9002 }, 「wan_ipv4」:{ 「アドレス」:「192.168.130.7」 「ポート」:9002 } }, 「重り」:{ 「合格」:1、 「警告」:1 }, 「EnableTagOverride」:false }, "20210305111244420-950221525": { 「ID」:「20210305111244420-950221525」 「サービス」:「Itsvse.Web.Background」 「タグ」:["テスト2"]、 「メタ」:{ 「製品」:「建築家」 「バージョン」:「3.9.0.0」 }, 「ポート」:9001、 「アドレス」:「192.168.130.7」 「タグ付きアドレス」: { 「lan_ipv4」:{ 「アドレス」:「192.168.130.7」 「ポート」:9001 }, 「wan_ipv4」:{ 「アドレス」:「192.168.130.7」 「ポート」:9001 } }, 「重り」:{ 「合格」:1、 「警告」:1 }, 「EnableTagOverride」:false }, "20210305111246746-1271993326": { 「ID」:「20210305111246746-1271993326」 「サービス」:「Itsvse.Web」 「タグ」:["テスト3"]、 「メタ」:{ 「製品」:「建築家」 「バージョン」:「3.9.0.0」 }, 「ポート」:9003、 「アドレス」:「192.168.130.7」 「タグ付きアドレス」: { 「lan_ipv4」:{ 「アドレス」:「192.168.130.7」 「ポート」:9003 }, 「wan_ipv4」:{ 「アドレス」:「192.168.130.7」 「ポート」:9003 } }, 「重り」:{ 「合格」:1、 「警告」:1 }, 「EnableTagOverride」:false }
}
カタログ
カタログエンドポイントはノード、サービス、チェックの登録/ログアウトに使用されます
/v1/catalog/register : Registers a new node, service, or check (建议用agent方法
/v1/catalog/deregister : Deregisters a node, service, or check (建议用agent方法
/v1/catalog/datacenters : Lists known datacenters
/v1/catalog/nodes : Lists nodes in a given DC
/v1/catalog/services : Lists services in a given DC
/v1/catalog/service/<service> : Lists the nodes in a given service
/v1/catalog/node/<node> : Lists the services provided by a node
注:エージェントとカタログには違いがあります(エージェントは現在のノードの登録データを取得し、カタログはすべて取得)
すべてのサービスに関する情報を入手できます
http://itsvse:8500/v1/catalog/services
{ 「Itsvse.API」: ["test"], 「Itsvse.Web.Background」: [「テスト1」], 「Itsvse.Web」: [「テスト2」] 「コンスル」: []
} 健康
健康エンドポイントは健康状態に関する情報を照会するために使われ、カタログとは分離されています
/v1/healt/node/<node>: 返回node所定义的检查,可用参数?dc=
/v1/health/checks/<service>: 返回和服务相关联的检查,可用参数?dc=
/v1/health/service/<service>: 返回给定datacenter中给定node中service
/v1/health/state/<state>: 返回给定datacenter中指定状态的服务,state可以是"any", "unknown", "passing", "warning", or "critical",可用参数?dc=
セッション
セッションエンドポイントは、セッションの作成、更新、デストーリー、クエリに使用されます
/v1/session/create: Creates a new session
/v1/session/destroy/<session>: Destroys a given session
/v1/session/info/<session>: Queries a given session
/v1/session/node/<node>: Lists sessions belonging to a node
/v1/session/list: Lists all the active sessions
ACL
ACLエンドポイントは、ACLの作成、更新、デストーリー、クエリに使用されます
/v1/acl/create: Creates a new token with policy
/v1/acl/update: Update the policy of a token
/v1/acl/destroy/<id>: Destroys a given token
/v1/acl/info/<id>: Queries the policy of a given token
/v1/acl/clone/<id>: Creates a new token by cloning an existing token
/v1/acl/list: Lists all the active tokens
KV
/v1/kv/keyを入力 /v1/kv/keyを取得します 削除 /v1/kv/k
イェント
イベントエンドポイントは新しいイベントの発生や既存イベントのクエリに使用されます
/v1/event/fire/<name>: 触发一个新的event,用户event需要name和其他可选的参数,使用PUT方法
/v1/event/list: 返回agent知道的events
状況
ステータスエンドポイントやコンスルクラスタが使用されます
/v1/status/leader : 返回当前集群的Raft leader
/v1/status/peers : 返回当前集群中同事
|