IBM Cloud Docs

在控制台中列出快照

您可以使用 UI 来列出快照和一致性组。

在控制台中列出所有快照

在控制台中，您可以查看创建的所有快照的列表，最近的快照位于列表的开头。您可以过滤列表以查看特定快照。

在 IBM Cloud 控制台，单击 导航菜单 图标 > 基础架构 > 存储 > Block Storage快照。该页面有两个主要选项卡: 快照一致性组和快照。
选择“快照”选项卡。将针对特定区域列出快照。如果要在其他区域中查看快照，请单击箭头以展开列表并选择其他区域。缺省情况下，最新的快照显示在列表的开头。
随着快照列表的增长，请使用过滤器来指示每页要显示的快照数。使用页面导航箭头在列表中前后移动。

表 1 描述了快照列表上显示的所有快照的信息。

所有快照列表
字段	描述
名称	创建快照时提供的名称。单击快照的名称以查看其详细信息。
状态	快照的状态，取决于它是可用 (active 状态)，不可用还是正在创建。有关更多信息，请参阅快照状态。
大小	快照的大小 (以 GB 为单位)。从源卷继承大小。
源卷	它显示从中创建快照的引导卷或数据卷。单击卷的名称以查看其详细信息。
快照副本	快照在其他区域中具有的副本数。
创建日期	创建快照的本地日期和时间。
一致性组	如果快照是快照集的成员，那么此字段显示一致性组的名称。

单击“设置”图标 "设置" 图标以显示可添加到表中的可选字段。

所有快照的可选信息字段列表
字段	描述
加密	它显示 IBM管理的加密或客户管理的加密。从源卷继承加密。
快速复原状态	复原状态为“已启用”，“暂挂”或“已禁用”。
资源组	快照所属的资源组。
是否可引导	是或否。它显示快照是针对引导卷还是数据卷生成的。
创建者	它显示快照是由用户创建还是由备份策略创建。

通过单击“操作”图标，可以显示特定于上下文的操作的菜单。

您还可以从卷详细信息页面列出从 Block Storage for VPC 卷创建的所有快照。有关更多信息，请参阅查看从 Block Storage for VPC 卷创建的所有快照。

在控制台中查看快照详细信息

要查看有关快照的详细信息，请在 VPC 列表的 Block Storage 快照上找到快照。然后，单击快照的名称。详细信息页面在标题中显示快照的名称，其状态以及附加的用户标记。

快照详细信息面板显示下表中描述的信息。

快照详细信息
字段	描述
名称	快照的名称，可通过单击编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 来更改。有关更多信息，请参阅命名快照。
快照标识	快照的可复制 GUID。
是否可引导	是或否。
CRN	快照的可复制 CRN。
资源组	设置 VPC 时定义的资源组。
创建日期	快照资源创建过程启动的日期和时间。
捕获日期	捕获此快照的日期和时间。
创建者	此字段显示 `User` 或 `Backup policy`。如果快照由备份策略创建，那么 UI 还会显示创建备份快照的备份计划的名称。
大小	从源卷继承的快照大小 (以 GB 为单位)。
源卷	从中生成第一个快照的源卷。单击链接以获取卷详细信息。如果删除了卷，那么该名称将显示为没有链接。
加密	提供者管理的加密或客户管理的加密。对于客户管理的加密，将显示 KMS 实例，根密钥名称和根密钥标识。
快速复原面板	使用快速复原可从此快照创建完全供应的卷。单击编辑以在区域中启用或禁用快速复原。
一致性组面板	它显示有关快照所属的一致性组的信息。单击创建虚拟服务器以从一致性组复原卷。

通过单击“操作”图标，可以显示特定于上下文的操作的菜单。

从快照创建卷
编辑快速复原，或删除快照。

在控制台中列出所有快照一致性组

在控制台中，您可以查看您创建的所有一致性组的列表，最近的一致性组位于列表的开头。您可以过滤列表以查看特定一致性组。

在 IBM Cloud 控制台，单击 导航菜单 图标 > 基础架构 > 存储 > Block Storage快照。该页面有两个主要选项卡: 快照一致性组和快照。
选择 快照一致性组 选项卡。将针对特定区域列出这些组。如果要查看其他区域中的一致性组，请单击箭头以展开列表并选择其他区域。缺省情况下，最新快照组显示在列表的开头。
随着一致性组列表的增长，请使用过滤器来指示每页要显示的项数。使用页面导航箭头在列表中前后移动。

下表描述了列表中所有一致性组的信息。

所有一致性组列表
字段	描述
名称	创建一致性组时提供的名称。单击组的名称以查看其详细信息。
状态	一致性组的状态，取决于它是可用 (active 状态)，不可用还是正在创建。
源 VSI	它显示了包含一致性组中快照的源卷的虚拟服务器实例。单击虚拟服务器实例的名称以查看其详细信息。
快照成员	作为组成员的快照数。
创建日期	创建快照的本地日期和时间。

单击“设置”图标 "设置" 图标以显示可添加到表中的可选字段。

所有快照的可选信息字段列表
字段	描述
创建者	它显示快照集是由用户创建还是由备份策略创建。
资源组	一致性组所属的资源组。
创建者	它显示快照是由用户创建还是由备份策略创建。

通过单击“操作”图标，可以显示特定于上下文的操作的菜单。

重命名
复制 UUID
复制云资源名称 (CRN)。
创建虚拟服务器
删除(T)

在控制台中查看一致性组的详细信息

要查看有关一致性组的详细信息，请在 VPC 列表的 Block Storage 快照上找到该组。然后，单击一致性组的名称。

概述部分提供有关一致性组以及生成一致性组快照的虚拟服务器实例的详细信息。第一个面板包含有关一致性组的信息。

一致性小组概览。
字段	描述
名称	一致性组的唯一名称。如果要对其进行更新，请单击编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑">。
一致性组标识	此字段显示一致性组的标识字符串。
CRN	一致性组的云资源名称。
创建者	此字段显示 `user` (对于手动创建的快照) 或备份策略 (对于自动快照)。
资源组	一致性组所属的资源组。
创建日期	它显示创建一致性组的日期。
删除快照成员	它显示删除一致性组时是删除还是保留快照。单击切换以更改状态。
区域	在其中创建一致性组的 VPC 区域。

有关更多信息，请参阅管理快照一致性组。

第二个面板包含有关快照集的源卷所连接到的虚拟服务器实例的信息。

虚拟服务器实例概述。
字段	描述
名称	虚拟服务器实例的名称。单击链接以转至实例的详细信息页面。
虚拟服务器实例标识	您可以复制要在其他接口 (例如 CLI，API 或 Terraform) 中使用的标识。
虚拟私有云	在其中创建一致性组的 VPC 的名称。单击链接以转至 VPC 的详细信息页面。
图像	有关操作系统映像的信息。
资源组	虚拟服务器实例所属的资源组。
标记	用于虚拟服务器实例的用户定义标记。

“快照”列表显示一致性组中的快照，并提供表 1 中描述的相同信息和操作。

从 CLI 查看快照

您可以使用 CLI 列出所有快照，卷的所有快照以及有关特定快照的详细信息。

准备工作

在使用 CLI 之前，您必须安装 IBM Cloud CLI 和 VPC CLI 插件。有关更多信息，请参阅 CLI 先决条件。

登录到 IBM Cloud®。
```
ibmcloud login --sso -a cloud.ibm.com
```
此命令会返回 URL 并提示输入密码。在浏览器中转至该 URL 并登录。如果成功，您将获得一次性密码。复制此密码并将其作为响应粘贴到提示上。成功认证后，系统会提示您选择帐户。如果可以访问多个账户，请选择要登录的账户。响应任何剩余提示以完成登录。
将 IBMCLOUD_IS_FEATURE_SNAPSHOT 环境变量设置为 true。
```
export IBMCLOUD_IS_FEATURE_SNAPSHOT=true
```

从 CLI 查看区域中帐户的所有快照

运行 snapshots 命令以列出所有快照。

ibmcloud is snapshots [--json]

以下示例提供了 eu-de 区域中所有资源组中由“测试帐户”用户创建的所有快照的列表。

cloudshell:~$ ibmcloud is snapshots [--json]
Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                                           Status     Source volume                               Bootable   Resource group   Created
r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7   bear-peroxide-viewable-oxidant                 stable     r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:49:48+00:00
r138-f95ef79e-5452-4a2a-b674-923c8ab84923   csi-plan-6kraq5zm-x7ss0u3h-3dbc4108a6b6-4356   stable     r010-a32b3fc7-8cd1-4b6e-ab97-f9837024fc03   false      defaults         2023-01-18T15:35:19+00:00
r138-9ad969ee-64b2-409a-b1e8-a3093446ad4e   csi-plan-nmplujx4-67413149ce61-4740            unusable   r010-63524a21-889d-4c44-95d1-4d2332394975   false      defaults         2023-01-18T13:40:28+00:00
r138-0f005da7-026c-453a-aa9b-2bc6f5cc6961   demo2-8be140e9561c-4381                        stable     r010-5a558256-ca83-4534-973f-f7a3b80aebe7   true       defaults         2023-02-01T00:41:23+00:00
r138-f7030231-bc5b-4672-8454-2f30271578f6   my-hpcs-snapshot                               stable     r010-921c3c6f-6a0a-4914-bdc5-3e8c9167ec30   false      defaults         2022-02-11T16:54:35+00:00
r138-e6664842-b370-496a-9ae7-da3fb647707c   snappy-snap-snap                               stable     r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:53:57+00:00

有关可用快照命令选项的更多信息，请参阅 ibmcloud is snapshots。

从 CLI 查看卷的所有快照

运行 snapshots 命令并指定卷标识。

ibmcloud is snapshots --volume VOLUME-ID [--json]

以下示例显示了对卷 r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa 生成的所有三个快照。

cloudshell:~$ ibmcloud is snapshots --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa
Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                             Status   Source volume                               Bootable   Resource group   Created
r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7   bear-peroxide-viewable-oxidant   stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:49:48+00:00
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146   cli-snapshot-test                stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      defaults         2023-02-17T20:15:43+00:00
r138-e6664842-b370-496a-9ae7-da3fb647707c   snappy-snap-snap                 stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:53:57+00:00

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshots。

从 CLI 查看一致性组中的所有快照

运行 snapshots 命令并指定一致性组标识，名称或 CRN。

ibmcloud is snapshots --volume CONSISTENCY_GROUP_ID

以下示例使用一致性组的标识来列出作为集合成员的快照。

ibmcloud is snapshots --snapshot-consistency-group r174-7c8762e2-c1b9-424e-b773-23240d1780dd

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name            Status   Source volume                               Bootable   Resource group   Created
r174-b8cac978-a990-4824-a15c-604856982efe   snapshot-no-2   stable   r174-0641e516-09a1-4291-96ca-af254017123e   true       Default          2023-09-05T23:14:40+05:30
r174-7311f226-8259-46be-9bfa-5b2cd08bdf2f   snapshot-no-1   stable   r174-bf595773-9922-4dd4-9a3c-998b10022e0c   false      Default          2023-09-05T23:14:40+05:30

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshots。

从 CLI 查看快照的详细信息

运行 snapshots 命令并指定快照标识。

ibmcloud is snapshots SNAPSHOT_ID [--json]

以下示例显示了 us-south 区域中可引导快照的详细信息。

cloudshell:~$ ibmcloud is snapshot r006-2cd91284-1c46-499d-b1c5-ebe248b8ff12
Getting snapshot r006-2cd91284-1c46-499d-b1c5-ebe248b8ff12 under account Test Account as user test.user@ibm.com...

ID                              r006-2cd91284-1c46-499d-b1c5-ebe248b8ff12
Name                            my-bootable-snapshot
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-2cd91284-1c46-499d-b1c5-ebe248b8ff12
Status                          stable
Clones                          Zone   Available   Created

Source volume                   ID                                          Name             CRN                                                          Resource type
                                r010-85ad4f39-1bd1-4d1e-95c0-ec4caf21b4dc   my-boot-volume   crn:v1:bluemix:public:is:us-south:a/a1234567::volume:r010-85ad4f39-1bd1-4d1e-95c0-ec4caf21b4dc   volume

Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -

Minimum capacity(GB)            100
Size(GB)                        5
Source Image                    ID                                          Name              Region CRN                                                         Resource type
                                r010-f68ef7b3-1c5e-4ef7-8040-7ae0f5bf04fd   my-custom-image   us-south  crn:v1:bluemix:public:is:us-south:a/a1234567::image:r010-f68ef7b3-1c5e-4ef7-8040-7ae0f5bf04fd   image

Operating system                Name                 Vendor      Version                                     Family         Architecture   Display name
                                ubuntu-22-04-amd64   Canonical   22.04 LTS Jammy Jellyfish Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 22.04 LTS Jammy Jellyfish Minimal Install (amd64)      

Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                         2024-04-18T18:19:10+00:00
Captured at                     2024-02-21T21:45:41+00:00
Tags                            -
Service Tags                    -
Storage Generation              1

以下示例显示了 eu-de 区域中不可引导快照的详细信息，该区域在 eu-de-1 区域中还具有快速复原克隆。

cloudshell:~$ ibmcloud is snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Getting snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

ID                         r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name                       cli-snapshot-test
CRN                        crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status                     stable
Clones                     Zone      Available   Created
                           eu-de-1   true        2023-02-17T20:15:46+00:00

Source volume              ID                                          Name
                           r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   block-test1

Bootable                   false
Encryption                 provider_managed
Encryption key             -
Minimum capacity(GB)       20
Size(GB)                   1
Snapshot Consistency Group ID                                                    Name                    Snapshot Consistency Group ID                                         Name                                   CRN                                                                    Resource type
                           r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44 multiple-snapshots-consistency-group-1   crn:v1:bluemix:public:is:eu-de:a/a1234567:snapshot-consistency-group:r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44   snapshot_consistency_group

Resource group             ID                                 Name
                           6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                    2023-12-05T20:15:43+00:00
Captured at                2023-12-05T20:15:44+00:00
Tags                       env:prod,env:test
Service Tags               -
Storage Generation         1

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshots。

从 CLI 查看所有快速复原快照克隆

您可以通过发出 ibmcloud is snapshot-clones 命令来列出快照的所有可用快速复原克隆。以下示例列出标识为 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快照的可用快速复原快照克隆。

$ ibmcloud is snapshot-clones r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Listing zonal clones of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone      Available   Created
eu-de-1   true        2023-02-17T20:15:46+00:00
eu-de-3   true        2023-02-17T20:29:21+00:00

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshot-clones。

从 CLI 查看快速复原快照克隆的详细信息

您可以运行 ibmcloud is snapshot-clone 命令以列出特定快速复原快照克隆的详细信息。以下示例展示了如何列出快照 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快速还原快照克隆的详细信息，该快照位于 eu-de-3 区域。

$ ibmcloud is snapshot-clone r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
Getting zonal clone eu-de-3 of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

Zone        eu-de-3
Available   true
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshot-clone。

从 CLI 查看远程区域快照副本的详细信息

您可以运行 ibmcloud is snaphot 命令来列出特定远程区域快照副本的详细信息。下面的示例显示了如何列出 us-south 区域中远程区域快照 (my-cli-snapshot-crc) 的详细信息。响应会提供有关父快照 (cli-snap-crc-test)、父卷以及创建快照的备份策略的信息。

ibmcloud is snapshot my-cli-snapshot-crc
Getting snapshot my-cli-snapshot-crc-target under account Test Account as user test.user@ibm.com...

ID                     r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Status                 stable
Clones                 Zone   Available   Created

Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   -remote-814bfc1e108b   us-east         crn:v1:bluemix:public:is:us-east-a/a1234567::volume:r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   volume

Backup policy plan     ID                                          Name                   Resource type
                       r014-d659eb15-ff07-4d54-8dd8-808a037e1b61   -remote-808a037e1b61   backup_policy_plan

Snapshot Copies        -
Bootable               false
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                Remote Region   CRN                                                                                                                       Resource type
                       r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   cli-snap-crc-test   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   snapshot

Minimum capacity(GB)   100
Size(GB)               1
Source Image           -
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                2024-06-18T17:21:24+00:00
Captured at            2024-06-18T17:21:20+00:00
Tags                   -
Service Tags           -
Storage Generation     1

从 CLI 查看所有快照一致性组

运行 snapshot-consistency-groups 命令以列出区域中的所有一致性组。

ibmcloud is snapshot-consistency-groups

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshot-consistency-groups。

从 CLI 查看快照一致性组的详细信息

运行 snapshot-consistency-group 命令以列出区域中特定一致性组的详细信息。

ibmcloud is snapshot-consistency-group CONSISTENCY_GROUP_ID

有关可用命令选项的更多信息，请参阅 ibmcloud is snapshot-consistency-group。

使用 API 列出快照

您可以使用 API 列出快照。

使用 API 列出所有快照

您可以通过调用 VPC API 中的 /snapshots 方法，以编程方式列出卷的所有快照，如以下样本请求中所示。缺省情况下，该列表首先显示最新的快照，然后按降序显示较旧的快照。

curl -X GET \
  "$vpc_api_endpoint/v1/snapshots?version=2022-12-16&generation=2" \
  -H "Authorization: $iam_token"

您可以使用资源组标识，源卷标识或源卷 CRN 来过滤列表，并使用以下选项进一步过滤结果:

限制-控制页面上显示的快照数。
启动-指定要启动列表的快照 (按标识)。
排序-控制对页面进行排序的顺序，例如按创建日期或按快照名称的字母顺序。

例如，以下调用会过滤列表以显示为单个卷创建的快照，并将结果限制为每页 5 个快照。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots?version=2022-08-16&generation=2" \
-H "Authorization: $iam_token" \
-d '{
      "limit": 5,
      "source_volume":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

成功回复的示例如下

{
    "first": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots?limit=50"
    },
    "limit": 5,
    "snapshots": [
      {
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-18T20:18:18Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/f945d446-0d46-478a-a298-acba907d45d1",
        "id": " f945d446-0d46-478a-a298-acba907d45d1",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "id": "de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      },
      {
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-17T20:11:28Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/e5bfa329-0e36-433f-a3bb-0df632e79263",
        "id": "e5bfa329-0e36-433f-a3bb-0df632e79263",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot-2",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "id": "23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      }
    ],
    "total_count": 2
  }

使用 API 列出快照的详细信息

您可以通过在 VPC API 中调用 /snapshots 方法并指定快照标识 (如以下样本请求中所示)，以编程方式检索单个快照的详细信息。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

成功回复的示例如下

{
  "bootable": true,
  "clones": [],
  "captured_at": "2022-12-16T20:19:12Z",
  "created_at": "2021-12-16T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": true,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d",
  "id": "7528eb61-bc01-4763-a67a-a414a103f96d",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "id": "59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "id": "dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "name": "ubuntu-20-04-minimal-amd64-1"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "id": "c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

使用 API 查看所有快速复原快照克隆

您可以通过在 VPC API 中调用 /snapshots/clones 方法并指定快照标识，以编程方式列出所有快速复原克隆，如以下样本请求中所示。

发出 GET /v1/snapshots/{id}/clones 请求以列出所有快速复原快照克隆。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

成功响应将提供有关快速复原快照克隆的信息。

{
  "clones": [
    {
      "available": true,
      "created_at": "2022-12-16T19:55:28.537Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
      }
    },
    {
      "available": true,
      "created_at": "2022-12-16T19:58:22.337Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
      }
    }
  ]
}

使用 API 查看快速复原快照克隆的详细信息

您可以通过在 VPC API 中调用 /snapshots/clones 方法并指定快照标识和区域，以编程方式检索单个快速复原克隆的详细信息，如以下样本请求中所示。

发出 GET /v1/snapshots/{id}/clones/{zone-name} 请求以检索由标识和区域名称指定的单个快速复原快照克隆。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones/us-south-1?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

成功响应将显示有关快速复原快照克隆的以下信息。

{
  "available": true,
  "created_at": "2022-12-16T20:15:35.164Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

使用 API 查看远程区域快照副本的详细信息

您可以通过在 VPC API 中调用 /snapshots 方法并指定快照标识 (如以下样本请求中所示)，以编程方式检索单个快照的详细信息。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

成功响应将显示类似于以下示例的信息。

{
  "bootable": true,
  "created_at": "2023-05-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "id": "r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "gpu_supported": [],
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "region": "us-east",
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "id": "r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "name": "ibm-ubuntu-20-04-minimal-amd64-1"
  },
  "source_snapshot": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-511a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-511a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-snapshot-data"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-411a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-411a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

使用 API 查看所有快照一致性组

您可以通过调用 VPC API 中的 /snapshot_consistency_groups 方法以编程方式列出所有一致性组，如以下样本请求中所示。

GET /snapshot_consistency_groups

使用 API 查看快照一致性组的详细信息

您可以通过在 VPC API 中调用 /snapshot_consistency_groups 方法，以编程方式检索一致性组的详细信息，如以下样本请求中所示。

GET /snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207

成功回复的示例如下

{
    "created_at": "2023-12-05T22:40:42Z",
    "id": "r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "delete_snapshots_on_delete": true,
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "name": "my-consistency-group-snapshots",
    "resource_group": {
        "id": "a41ca701e1c041c1bb224564ff645770",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/a41ca701e1c041c1bb224564ff645770",
        "name": "Default"
    },
    "lifecycle_state": "stable",
    "resource_type": "snapshot_consistency_group",
    "service_tags": [
        "is.instance:0727_44fda9fe-eeef-4e71-8fa4-4c3f7300e645"
    ],
    "snapshots": [
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "id": "r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "name": "my-test-scg-1",
            "resource_type": "snapshot"
        },
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "id": "r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "name": "my-test-scg-2",
            "resource_type": "snapshot"
        }
    ]
}

使用 Terraform 查看快照

您可以使用 Terraform 来查看快照。

要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud 提供者插件。有关更多信息，请参阅 Terraform 入门。

VPC 基础架构服务使用特定区域端点，缺省情况下该端点以 us-south 为目标。如果 VPC 是在另一个区域中创建的，请确保将 provider.tf 文件中的提供程序块中的相应区域作为目标。

请参阅以下以非缺省 us-south 区域为目标的示例。

provider "ibm" {
  region = "eu-de"
}

使用 Terraform 列出所有快照

将快照集合的详细信息作为只读数据源导入。您可以按 source_volume，resource_group 和 name 等对快照集合进行过滤。

data "ibm_is_snapshots" "example" {
}

有关更多信息，请参阅 ibm_is_snapshot。

使用 Terraform 列出快照的详细信息

将快照的详细信息作为只读数据源导入。您可以指定快照标识或快照名称。

data "ibm_is_snapshot" "example" {
  identifier = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

data "ibm_is_snapshot" "example" {
  name = "snappy-snap-snap"
}

有关更多信息，请参阅 ibm_is_snapshot。

列出所有快速复原快照克隆

将快照的所有快速复原克隆的详细信息作为只读数据源导入。

data "ibm_is_snapshot_clones" "ds_snapshotclones" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

有关更多信息，请参阅 ibm_is_snapshot_clones。

列出使用 Terraform 的快速复原克隆的详细信息

将区域中快照的快速复原克隆的详细信息作为只读数据源导入。

data "ibm_is_snapshot_clone" "ds_snapshotclone" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
  zone     = "eu-de-1"
}

有关更多信息，请参阅 ibm_is_snapshot_clone。

使用 Terraform 列出所有一致性组

将一致性组集合的详细信息作为只读数据源导入。

data "ibm_is_snapshot_consistency_groups" "example" {
}

有关更多信息，请参阅 ibm_is_consistency_groups。

列出具有 Terraform 的一致性组的详细信息

将快照一致性组的详细信息作为只读数据源导入。可以通过一致性组的标识或名称来指定一致性组。

data "ibm_is_snapshot_consistency_group" "example" {
  identifier = ibm_is_snapshot_consistency_group.is_snapshot_consistency_group.id
}

data "ibm_is_snapshot_consistency_group" "example" {
  name = "my-data-consistency-group"
}

有关更多信息，请参阅 ibm_is_consistency_group。

IBM Cloud

查看 Block Storage for VPC 快照和一致性组

在控制台中列出快照

在控制台中列出所有快照

在控制台中查看快照详细信息

在控制台中列出所有快照一致性组

在控制台中查看一致性组的详细信息

从 CLI 查看快照

准备工作

从 CLI 查看区域中帐户的所有快照

从 CLI 查看卷的所有快照

从 CLI 查看一致性组中的所有快照

从 CLI 查看快照的详细信息

从 CLI 查看所有快速复原快照克隆

从 CLI 查看快速复原快照克隆的详细信息

从 CLI 查看远程区域快照副本的详细信息

从 CLI 查看所有快照一致性组

从 CLI 查看快照一致性组的详细信息

使用 API 列出快照

使用 API 列出所有快照

使用 API 列出快照的详细信息

使用 API 查看所有快速复原快照克隆

使用 API 查看快速复原快照克隆的详细信息

使用 API 查看远程区域快照副本的详细信息

使用 API 查看所有快照一致性组

使用 API 查看快照一致性组的详细信息

使用 Terraform 查看快照

使用 Terraform 列出所有快照

使用 Terraform 列出快照的详细信息

列出所有快速复原快照克隆

列出使用 Terraform 的快速复原克隆的详细信息

使用 Terraform 列出所有一致性组

列出具有 Terraform 的一致性组的详细信息

后续步骤