获取一台配置服务器的一张快照
重要
在使用 MongoDB 3.4 时已弃用
从MongoDB 3.4开始,不再支持镜像配置服务器部署(也称为 SCCC )。 以下API方法仅适用于SCCC配置服务器。 副本设立配置服务器(也称为CSRS )使用 “为一个集群获取一个快照”方法。 要学习;了解如何将配置服务器从SCCC转换为CSRS ,请参阅MongoDB Server手册中的将配置服务器升级到副本集。
基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots/{SNAPSHOT-ID}
请求参数
请求路径参数
请求查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 美观打印 的标志 格式。 | false | ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
| false |
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应
名称 | 类型 | 说明 |
---|---|---|
clusterId | 快照代表的集群的 ID。 | |
完成 | 布尔 | 指示快照已创建。 如果快照创建作业仍在进行中,则为 false 。 |
已创建 | 文档 | |
created.date | timestamp | ISO8601 中拍摄快照的确切时间点 UTC 格式的日期和时间。 |
created.increment | 整型 | |
doNotDelete | 布尔 | 指示无法删除快照的指示器。 如果将 |
expires | timestamp | ISO8601 的日期 UTC 格式的日期和时间,在此之后可以删除此 快照 。 如果将 如果 |
groupId | ObjectId | |
id | ObjectId | |
lastOplogAppliedTimestamp | 文档 | 应用了最后一个 oplog 条目的时间戳组件。 |
lastOplogAppliedTimestamp.date | timestamp | |
lastOplogAppliedTimestamp.increment | 整型 | |
链接 | 对象数组 | 指向子资源和/或相关资源的一个或多个链接。 响应中的所有 |
命名空间筛选器列表 | 对象数组 | |
namespaceFilterList.filterList | 字符串数组 | 以逗号分隔的列表,其中包含快照中独占包含或显式排除的数据库或命名空间的任意组合。 默认值为空数组 ( |
namespaceFilterList.filterType | 字符串 | 一个值,用于确定如何为此快照筛选命名空间。
默认值为 |
零件 | 对象数组 | 构成完整快照的各个部分。 该数组包含一个文档。 |
parts.dataSizeBytes | 数字 | 快照中数据的总大小(以字节为单位)。 |
parts.encryptionEnabled | 布尔 | 快照数据加密状态的指示器。 |
parts.fileSizeBytes | 数字 | 数据文件的总大小(以字节为单位)。 |
parts.hostId | 字符串 | 配置服务器的 ID。 |
parts.masterKeyUUID | ObjectId | 用于加密快照数据的KMIP主密钥ID 。 parts.masterKeyUUID 仅当此快照具有parts.encryptionEnabled : true 时,才会显示 。 |
parts.mongodVersion | 字符串 | 创建快照时正在运行的 mongod 版本。 |
parts.storageSizeBytes | 数字 | 为文档存储分配的空间总大小。 |
parts.typeName | 字符串 | 该部分代表的服务器类型:
|
请求示例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots?pretty=true"
响应示例
响应标头
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
{ "CLUSTER-ID" : "{CLUSTER-ID}", "complete" : true, "created" : { "date" : "2016-08-21T23:47:38Z", "increment" : 1 }, "doNotDelete" : false, "expires" : "2017-08-20T23:47:38Z", "GROUP-ID" : "{PROJECT-ID}", "HOST-ID" : "{HOST-ID}", "id" : "{SNAPSHOT-ID}", "lastOplogAppliedTimestamp" : { "date" : "2017-08-21T09:14:51Z", "increment" : 1 }, "links" : [ { "href" : "https://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots/{SNAPSHOT-ID}", "rel" : "self" } ], "namespaceFilterList" : { "filterList" : [ ], "filterType" : "blacklist" }, "parts" : [ { "dataSizeBytes" : 503779557, "encryptionEnabled" : false, "fileSizeBytes" : 2855605344, "HOST-ID" : "{HOST-ID}", "mongodVersion" : "4.0.9", "storageSizeBytes" : 547516416, "typeName" : "REPLICA_SET" } ] }