New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« 存储库计量 API 清除存储库计量归档 »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›REST API ›存储库计量 API

获取存储库计量信息

编辑

获取存储库计量信息

编辑

返回集群存储库计量信息。

请求

编辑

GET /_nodes/<node_id>/_repositories_metering

先决条件

编辑
  • 如果启用了 Elasticsearch 安全功能，你必须具有 monitor 或 manage 集群权限 才能使用此 API。

描述

编辑

你可以使用集群存储库计量 API 来检索集群中的存储库计量信息。

此 API 公开单调不减的计数器，预计客户端会持久存储计算一段时间内的聚合所需的信息。此外，此 API 公开的信息是易失的，这意味着在节点重启后将不存在。

路径参数

编辑
<node_id>
(可选，字符串) 用于限制返回信息的节点 ID 或名称的逗号分隔列表。

所有节点选择选项在此处进行了解释 这里。

响应体

编辑
_nodes

(对象) 包含有关请求选择的节点数量的统计信息。

_nodes 的属性
total
(整数) 请求选择的节点总数。
successful
(整数) 成功响应请求的节点数。
failed
(整数) 拒绝请求或未能响应的节点数。如果此值不为 0，则响应中会包含拒绝或失败的原因。
cluster_name
(字符串) 集群的名称。基于 集群名称设置 设置。
nodes

(对象) 包含请求选择的节点的存储库计量信息。

nodes 的属性
<node_id>

(数组) 节点的存储库计量信息数组。

node_id 中对象的属性
repository_name
(字符串) 存储库名称。
repository_type
(字符串) 存储库类型。
repository_location

(对象) 表示存储库内的唯一位置。

存储库类型为 Azure 的 repository_location 的属性
base_path
(字符串) 存储库存储数据的容器内的路径。
container
(字符串) 容器名称。
存储库类型为 GCP 的 repository_location 的属性
base_path
(字符串) 存储库存储数据的存储桶内的路径。
bucket
(字符串) 存储桶名称。
存储库类型为 S3 的 repository_location 的属性
base_path
(字符串) 存储库存储数据的存储桶内的路径。
bucket
(字符串) 存储桶名称。
repository_ephemeral_id
(字符串) 每次更新存储库时都会更改的标识符。
repository_started_at
(长整型) 存储库创建或更新的时间。以自 Unix 纪元 以来的毫秒数记录。
repository_stopped_at
(可选，长整型) 存储库删除或更新的时间。以自 Unix 纪元 以来的毫秒数记录。
archived
(布尔值) 指示此对象是否已存档的标志。当存储库关闭或更新时，存储库计量信息会被存档并保留一段时间。这允许检索以前的存储库实例的存储库计量信息。
cluster_version
(可选，长整型) 此对象被存档时的集群状态版本，此字段可用作逻辑时间戳以删除所有已存档的指标，直至观察到的版本。此字段仅适用于已存档的存储库计量信息对象。此字段的主要目的是避免在删除存储库计量信息期间可能出现的竞争条件，例如，删除我们尚未观察到的已存档的存储库计量信息。
request_counts

(对象) 一个对象，其中包含按请求类型分组的针对存储库执行的请求数量。

存储库类型为 Azure 的 request_counts 的属性
GetBlobProperties
(长整型) 获取 Blob 属性 请求的数量。
GetBlob
(长整型) 获取 Blob 请求的数量。
ListBlobs
(长整型) 列出 Blob 请求的数量。
PutBlob
(长整型) 放置 Blob 请求的数量。
PutBlock
(长整型) 放置块 的数量。
PutBlockList
(长整型) 放置块列表 请求的数量。

Azure 存储 定价。

存储库类型为 GCP 的 request_counts 的属性
GetObject
(长整型) 获取对象 请求的数量。
ListObjects
(长整型) 列出对象 请求的数量。
InsertObject
(长整型) 插入对象 请求的数量，包括 简单、 多部分 和 可恢复 上传。可恢复上传可以执行多个 http 请求来插入单个对象，但由于它们被 计费 为单个操作，因此它们被视为单个请求。

Google Cloud Storage 定价。

存储库类型为 S3 的 request_counts 的属性
GetObject
(长整型) GetObject 请求的数量。
ListObjects
(长整型) ListObjects 请求的数量。
PutObject
(长整型) PutObject 请求的数量。
PutMultipartObject
(长整型) 多部分 请求的数量，包括 CreateMultipartUpload、UploadPart 和 CompleteMultipartUpload 请求。

Amazon Web Services 简单存储服务 定价。

« 存储库计量 API 清除存储库计量归档 »

On this page

Was this helpful?
Feedback