/ /

/ /

更改一个快照的有效期

2024 年 8 月 30 日以后，Cloud Manager 将不再支持 MongoDB 3.6 和 4.0 的自动化、备份和监控。请升级您的 MongoDB 部署或迁移到 Atlas。

基本 URL： https://cloud.mongodb.com/api/public/v1.0

Resource

PATCH /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}

请求参数

请求路径参数

名称	类型	说明
PROJECT-ID	字符串	拥有快照的项目的唯一标识符。
CLUSTER-ID	字符串	快照所代表的集群的唯一标识符。
SNAPSHOT-ID	字符串	快照的唯一标识符。

请求查询参数

以下查询参数为可选参数：

名称

类型

必要性

说明

默认

pretty

布尔

Optional

指示响应正文是否应采用美观打印格式的标志。

false

envelope

布尔

Optional

指示是否将响应包装在信封中的标志。

某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题，可在查询中设置 envelope=true。

对于返回一个结果的端点，响应体包括：

名称	说明
`status`	HTTP 响应代码
`content`	预期响应正文

false

请求正文参数

名称	类型	说明
doNotDelete	布尔	指示无法删除快照的指示器。重要提示：您不能设立`doNotDelete`设置为`true` ，并在同一请求中为`expires`设立时间戳。如果这样做， Cloud Manager将返回错误： `Cannot modify snapshot because of invalid fields.`
expires	timestamp	采用 ISO 8601 日期和时间格式（UTC 时间）的日期，在此之后可以删除此快照。如果将`doNotDelete`设置为`true` ，则删除`expires`中的任何现有值。如果`expires`设立为在当前日期和时间或之前的时间戳， Cloud Manager将在下一个机会删除快照。不保证快照会立即删除。如果当前的`expires`时间戳已经过去，则无法对其进行编辑。

响应

`Name`	类型	说明
`clusterId`	字符串	快照所代表集群的唯一标识符。
`complete`	布尔	指示快照已创建的标志。如果快照创建作业仍在进行中，则为`false` 。
`created`	文档	时间戳的组成部分。
`created` `.date`	timestamp	iso 8601 - 拍摄快照的时间。
`created` `.increment`	整型	此快照在此时发生的操作顺序。要了解时间戳在 MongoDB 中的工作原理，请参阅时间戳。
`doNotDelete`	布尔	指示无法删除快照的标志。
`expires`	timestamp	采用 ISO8601 日期和时间格式的时间戳（以 UTC 表示），之后可以删除此快照。如果将`doNotDelete`设置为`true` ，则删除`expires`中的所有值。如果`expires`值早于当前日期和时间，则无法编辑。
`groupId`	字符串	拥有快照的项目的唯一标识符。
`id`	字符串	快照的唯一标识符。
`isPossibly` `Inconsistent`	布尔	指示此快照一致性的标志。 `isPossiblyInconsistent`仅针对分片集群快照显示。要拍摄处于一致状态的分片集群的快照，备份会在创建快照之前暂时关闭负载均衡器。在某些情况下，无法及时关闭负载均衡器。然后在负载均衡器仍在运行的情况下创建快照。如果发生这种情况，则快照可能处于不一致状态（例如，数据块迁移可能正在进行中）。
`lastOplog` `AppliedTimestamp`	文档	应用了最后一个 oplog 条目的时间戳组件。
`lastOplog` `AppliedTimestamp` `.date`	timestamp	应用最后一个oplog时，采用 ISO8601 日期和时间格式（UTC 时间）的时间戳。
`lastOplog` `AppliedTimestamp` `.increment`	整型	在此确切时间点应用最后一个oplog的操作顺序。要了解时间戳在 MongoDB 中的工作原理，请参阅时间戳。
`links`	对象数组	指向子资源和/或相关资源的一个或多个链接。响应中的所有 `links` 数组至少包含一个名为 `self` 的链接。URL之间的关系在 Web 链接规范中进行了解释。
`namespaceFilterList`	对象	此快照中包含或排除的命名空间。
`namespaceFilterList` `.filterList`	字符串数组	以逗号分隔的列表，其中包含以独占方式包含在快照中或显式排除在快照中的数据库或命名空间的任意组合。默认值为空数组 ( `[]` )。
`namespaceFilterList` `.filterType`	字符串	用于确定如何为此快照筛选命名空间的标签。如果将此值设置为`denyList` ，则快照中会排除`namespaceFilterList.filterList`中的命名空间。如果将此值设置为`accessList` ，则快照中仅包含`namespaceFilterList.filterList`中的命名空间。默认值为 `denyList`。
`missingShards`	对象数组	快照缺少的分片列表。 `missingShards`仅针对分片集群快照显示。在稳定状态下，该数组为空。如果在创建快照时备份无法连接到分片，则快照中会省略该分片。数组中的每个文档都是包含`self`链接的集群文档。
`missingShards` `.id`	字符串	缺失分片的唯一标识符。
`missingShards` `.groupId`	字符串	拥有缺失分片的项目的唯一标识符。
`missingShards` `.typeName`	字符串	缺失分片代表的服务器类型： `CONFIG_SERVER_REPLICA_SET` `REPLICA_SET` `CONFIG_SHARD_REPLICA_SET`
`missingShards` `.clusterName`	字符串	缺失分片的集群名称。
`missingShards` `.shardName`	字符串	缺失分片的名称。
`missingShards` `.replicaSetName`	字符串	缺失分片中副本集的名称。
`missingShards` `.lastHeartbeat`	timestamp	从缺失分片收到最后一次心跳时的 UTC 时间的 ISO8601 日期和时间格式的时间戳。
`parts`	对象数组	构成完整快照的各个部分。对于副本集，此数组包含单个文档。对于分片集群，此数组包含每个分片的一份文档以及配置服务器的一份文档。
`parts` `.clusterId`	字符串	副本集的唯一标识符。
`parts` `.compressionSetting`	字符串	快照的压缩方法。
`parts` `.dataSizeBytes`	数字	快照中数据的总大小（以字节为单位）。
`parts` `.encryptionEnabled`	布尔	快照数据加密状态的指示器。
`parts` `.fileSizeBytes`	数字	数据文件的总大小（以字节为单位）。
`parts` `.masterKeyUUID`	字符串	用于加密快照数据的 KMIP 主密钥ID 。`parts.masterKeyUUID`仅当此快照具有`parts.encryptionEnabled : true` 时，才会显示。
`parts` `.mongodVersion`	字符串	`mongod`创建快照时副本集主节点正在运行的版本。
`parts` `.replicaSetName`	字符串	副本集的名称。
`parts` `.storageSizeBytes`	数字	为文档存储分配的空间总大小。
`parts` `.typeName`	字符串	该部分代表的服务器类型： `REPLICA_SET` `CONFIG_SERVER_REPLICA_SET` `CONFIG_SHARD_REPLICA_SET`

`links` 阵列

links大量包含一个或多个指向子资源和/或相关资源的链接。URL 之间的关系在Web 链接规范中进行了解释

关系	说明
self	此资源的 URL 端点。

请求示例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request PATCH "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}?pretty=true" \
     --data '
     {
       "doNotDelete": true
     }'

响应示例

响应标头

HTTP/1.1 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

HTTP/1.1 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}

响应体

{
  "id" : "{SNAPSHOT-ID}",
  "CLUSTER-ID" : "{CLUSTER-ID}",
  "complete" : true,
  "created" : {
    "date" : "2014-07-09T15:24:37Z",
    "increment" : 1
  },
  "doNotDelete" : true,
  "GROUP-ID" : "{PROJECT-ID}",
  "lastOplogAppliedTimestamp" : {
    "date" : "2017-08-21T09:14:51Z",
    "increment" : 1
  },
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}",
   "rel" : "self"
  } ],
  "namespaceFilterList" : {
    "filterList" : [ ],
    "filterType" : "denyList"
  },
  "parts" : [ {
    "CLUSTER-ID" : "{CLUSTER-ID}",
    "dataSizeBytes" : 17344,
    "fileSizeBytes" : 67108864,
    "mongodVersion" : "2.6.3",
    "replicaSetName" : "rs0",
    "storageSizeBytes" : 10502144,
    "typeName" : "REPLICA_SET"
  } ],
}

后退

获取一个（集群）

来年

删除一个

Resource

请求参数

请求路径参数

请求查询参数

请求正文参数

响应

links 阵列

请求示例

响应示例

响应标头

响应体

`links` 阵列