查看 Block Storage for VPC 卷

查看 IBM Cloud 块存储卷的详细信息，包括容量、IOPS、加密状态和连接信息。 列出所有卷，或查看单个卷的属性。

sdp 个人资料仅向部分客户开放。 如需申请访问权限，请提交 白名单申请。

在控制台中查看有关Block Storage for VPC卷的信息

列出所有 Block Storage for VPC 卷并查看单个卷的详细信息。 在实例详细信息中查看所附 Block Storage for VPC 卷的详细信息。 查看从 Block Storage for VPC 卷创建的所有快照。

在控制台中查看所有Block Storage for VPC卷的信息

转至 Block Storage for VPC 卷的列表。 在 IBM Cloud 控制台，单击 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 存储 > Block Storage 卷。

默认情况下，您所在地区所有资源组的 Block Storage for VPC 数量以10为一组显示。 点击“页面控制”下拉箭头，将此预设更改为20或50卷。 使用页面控制箭头跳转至下一页或返回。 在所有 Block Storage for VPC 卷的列表中，您会看到以下信息。

所有卷册的详细信息
字段 描述
区域 这些卷所在的区域，例如，美国南部。 单击向下箭头以查看您拥有帐户的其他区域中的卷。
名称 单击卷名可查看各个卷的详细信息。
状态 卷的状态，可充当所有行的缺省过滤器。
地区 区域中的可用性专区，从 VPC 继承（例如，美国南部 1）。
大小 指定的卷大小（以 GB 为单位）。
附件类型 数据（表示连接到实例的辅助卷）、引导（表示作为引导卷连接）或空白（表示未连接的卷）。
运行状况 “健康”功能用于监控卷的整体健康状况，例如 I/O 性能和数据一致性。 卷运行状况状态为 OK 或 degraded。 处于降级状态的卷具有降级的性能，容量或迂到连接问题。 从快照复原的卷也会显示降级状态。 该服务会显示降级状态的可能原因，以便您可以解决任何问题。 有关更多信息，请参阅 Block Storage for VPC 卷运行状况。
加密 缺省情况下，所有卷上都启用了使用 IBM 管理的密钥的加密。 您还可以在 Key Protect 实例中使用自己的根密钥来保护数据。 如需了解更多信息，请参阅《 使用客户管理的加密创建 Block Storage for VPC 卷 》。
标记 应用于卷的用户标记数。 单击此列中的数字以查看或编辑新窗口中的标记。 如果没有标记应用于卷，请单击 添加标记 并在新窗口中添加这些标记。 用户标记可以将卷与用于创建卷备份的 备份策略 相关联。 有关更多信息，请参阅 将与备份策略相关联的用户标记添加到控制台中的卷。
操作 单击操作操作图标 显示您可以采取的特定上下文操作的菜单。

在“操作”菜单（“操作”图标 ）的卷列表页面中，可执行以下操作。 某些操作仅在卷满足特定条件时才可用，例如处于已挂载或未挂载状态。

  • 重命名- 重命名此卷。
  • 连接到服务器 ——将未连接的卷连接到虚拟服务器实例。 只有当卷未挂载时，才可执行此操作。 有关更多信息，请参阅 将卷附加到实例。
  • 从实例中分离- 将已挂载的卷从其虚拟服务器实例中分离。 只有在卷已挂载时，才可执行此操作。 如需了解更多信息，请参阅 “从虚拟服务器实例上卸载卷”。
  • 创建快照- 创建此卷的快照。 当该操作不可用时，可能会显示为灰色。 如需了解更多信息，请参阅 “在控制台中创建快照”。
  • 创建映像 ——从启动卷创建自定义映像。 当该操作不可用时，可能会显示为灰色。 更多信息，请参阅 “从控制台中的卷创建图像”。
  • 添加标签或编辑标签 ——添加或编辑用户标签，并访问该卷上的管理标签。 有关更多信息，请参阅使用标记。
  • 删除- 删除此卷。 当卷已挂载到实例上时，此操作会显示为灰色。 更多信息，请参阅 控制台中的删除数据卷。
  • 迁移卷 ——将此卷迁移到另一个配置文件或配置中。 如需更多信息，请参阅《 迁移块存储卷 》。

查看Block Storage for VPC卷的详细信息

要查看 Block Storage for VPC 卷的详细信息，请转到所有 Block Storage for VPC 卷的列表，然后选择一个卷。

卷名称旁边是与此卷关联的 卷状态 和标记。 用户标签 可识别资源。 当用户标签与备份策略关联时，它们将用于创建卷的 备份快照。 通过 访问权管理标记，您可以创建灵活的资源分组来管理访问权。 有关这些标记的更多信息，请参阅 使用标记。

各卷的具体信息

该页面有 4 个标签页。 缺省情况下，将为卷详细信息选择“概述”选项卡。

卷详细信息
字段 描述
卷详细信息
名称 您在创建卷时指定的卷名。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以编辑卷名称。 卷名最多可以是 63 个小写字母数字字符，并且包含连字符 (-)，并且必须以小写字母开头。 对于帐户和区域，卷名必须唯一。
卷标识 系统生成的卷标识。
运行状况 “健康”功能用于监控卷的整体健康状况，例如 I/O 性能和数据一致性。 卷运行状况状态为 OK 或 degraded。 处于退化状态的硬盘性能较差，容量较小，或者会出现连接问题。 从快照复原的卷也会显示降级状态。 该服务会显示降级状态的可能原因，以便您可以解决该问题。 有关更多信息，请参阅 Block Storage for VPC 卷运行状况。
资源组 设置 VPC 时定义的资源组。 资源组管理对资源的访问权，但不影响计费或监视功能。
附件类型 数据：对于已挂载到实例上的辅助卷，挂载为启动卷时的数据；对于未挂载的卷，则为空。
创建日期 创建卷时系统生成的日期。
地区 区域中的可用性专区。
大小 指定的卷大小。 当该卷连接到虚拟服务器实例并且该卷在其范围内未达到最大容量时，您可以单击该图标以展开该卷。 更多信息，请参阅 扩展 Block Storage for VPC 卷容量。
Profile 该字段 显示卷配置：sdp、自定义 IOPS 或其中一个 IOPS 层级配置 文件。
最大 IOPS 预定义 IOPS 层级的最大 IOPS 值，或您为自定义 IOPS 指定的值。
吞吐量 该字段显示存储卷的分配带宽，以每秒千兆字节（Gbps）为单位。 吞吐量等于为卷配置的 IOPS 数量乘以吞吐量乘数。 根据 容量配置文件，吞吐量乘数可以是 16 KB 或 256 KB。 对于使用 sdp 配置文件创建的卷，吞吐量值可在 1000-8192 Mbps 的范围内自定义。
加密 缺省情况下，所有卷上都启用了使用 IBM 管理的密钥的加密。 您还可以使用自己的根密钥来保护数据。 “加密”字段显示您供应的密钥管理服务 (KMS) 的名称 (例如，Key Protect) 和 客户管理的。 有关更多信息，请参阅 使用客户管理的加密创建 Block Storage for VPC 卷。
加密实例 可选。 指向客户管理的加密卷的已供应 KMS 实例的链接。
键 可选。 用于加密口令 (用于保护客户管理的加密卷) 的根密钥的名称和可复制标识。
备份策略 与卷关联的备份策略数。 单击数字链接以转至“备份策略”选项卡。
快照 已创建卷的快照数。 单击数字链接以转至“快照和备份”选项卡。
复制角色 本卷在复制关系中的作用：source、replica 或 none。 此字段仅在 sdp 配置文件卷中存在。
连接的虚拟服务器 此处列出了连接到虚拟服务器实例的卷。 单击 连接 以选择要连接此卷的实例。 有关更多信息，请参阅 将卷附加到实例。
状态 该字段跟踪卷的整体生命周期状态，从卷创建到卷删除。 例如，当卷附加到实例时，附加状态为_已附加_ ；当卷正在进行时，附加状态为正在_附加_。
名称 单击虚拟服务器实例的名称以查看实例详细信息。
自动删除 如果 已启用，那么删除实例时将自动删除卷。 单击切换以启用自动删除。
备份策略 显示与此卷关联的备份策略。 要关联备份策略，可以将目标资源的备份策略标记添加到此卷。 单击 应用 以选择备份策略，然后将其针对目标资源的标记应用于卷。

在卷详细信息页面上的“操作”菜单（“操作”图标 ）中，可执行以下操作：

  • 查看活动跟踪 ——查看该卷的活动跟踪日志。
  • 创建快照 ——从已挂载的数据卷或启动卷创建快照。 如需了解更多信息，请参阅 “在控制台中创建快照”。
  • 创建映像 ——从启动卷创建自定义映像。 当该操作不可用时，其按钮会显示为灰色。 更多信息，请参阅 “从控制台中的卷创建图像”。
  • 扩展卷 ——以 1 GB 为增量扩大已挂载卷的大小。 有关详细信息，请参阅 扩展块存储卷容量。
  • 编辑 IOPS 配置文件 ——通过 编辑 IOPS 配置文件 来增加或减少 IOPS，从而更改已连接数据卷的性能特征。
  • 应用备份策略 ——将备份策略应用到此卷。 如需了解更多信息，请参阅 “将备份策略应用于资源”。
  • 迁移卷 ——将此卷迁移到另一个配置文件。 如需更多信息，请参阅《 迁移块存储卷 》。
  • 删除- 删除一个未挂载的卷。 更多信息，请参阅 控制台中的删除数据卷。

要查看该卷中通过手动操作或备份策略创建的快照列表，请单击 “快照和备份”选项卡。

查看 Block Storage for VPC 卷的所有快照

如果您创建了 Block Storage for VPC 启动或数据卷的快照，您可以在卷详细信息页面的第二个选项卡上看到快照。

单击 “快照和备份”选项卡，即可查看快照列表。 该列表包含以下列：名称、状态、大小、源卷、快照副本数、创建日期（本地） 和一致性组。 该列表还显示了快照是由用户创建的，还是由 备份策略 创建的。 快照按降序显示，首先显示最近创建的快照。

您可以从“卷详细信息”页面查看快照的详细信息，创建快照以及管理快照。 例如，从“操作”菜单 "操作" 图标 中，可以删除最新的快照。 有关更多信息，请参阅下列其中一个主题：

查看与某个卷关联的所有备份策略

在卷详细信息页面的第 3 个选项卡上查看与 Block Storage for VPC 卷关联的所有备份策略。 将列出具有应用于此卷的用户标记的所有策略。

单击“备份策略”选项卡。 将列出具有应用于此卷的用户标记的所有策略。 该列表提供了以下信息：

与Block Storage for VPC卷相关联的备份策略。
字段 描述
策略名称 单击策略名称以转至该备份策略。
状态 备份策略的状态。
上次运行时间（本地） 创建该备份的备份策略的最后一次计划运行时间（以当地时间显示）。

您可以点击 “附加” 为该卷应用新的备份策略。 在侧面板中，从菜单中选择备份策略，然后选择要应用于卷的策略标记。 您还可以查看可帮助您决定是否使用该策略的计划详细信息。 如果满意，请单击 应用策略和标记。

当您想要将卷添加到策略时，请将备份策略中针对目标资源的标签中 的用户标签添加到卷中。 当您从备份策略中移除卷上的标记时，该卷将不再受该策略的备份。

有关更多信息，请参阅 将备份策略应用于资源。

查看批量作业

卷详细信息页面上的“批量作业”选项卡列出了与该卷关联的迁移任务。 表格中的每一行都提供了以下信息：

与 Block Storage for VPC 卷相关的卷操作。
字段 描述
作业标识 迁移任务的系统生成的ID。
作业状态 迁移任务的当前状态。
作业开始时间 迁移任务的开始日期和时间。
作业完成时间 迁移任务完成的日期和时间。

有关卷迁移的更多信息，请参阅《 迁移块存储卷 》。

在实例详细信息中查看附加的 Block Storage for VPC 卷详细信息

您还可以从 “虚拟服务器”实例详细信息页面查看有关已挂载的 Block Storage for VPC 卷的信息：

  1. 在 IBM Cloud 控制台，单击 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 虚拟服务器实例，然后选择一个实例。

  2. 在连接的块存储卷下，单击卷名以转至卷详细信息页面。

从 CLI 查看 Block Storage for VPC 卷

通过 CLI 查看有关 Block Storage for VPC 卷的详细信息或有关所有卷的摘要信息。

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

查看CLI的所有卷

运行以下命令以列出所有卷的摘要信息：

ibmcloud is volumes [--json]

指定资源组标识或名称将过滤列表，以仅显示属于该资源组的卷。 如果省略此参数，则默认为所有资源组。 还可以查看特定可用性专区中的所有卷。 缺省情况下，每个页面都会显示前 25 个卷。

以下示例显示了可用性专区中所有资源组的所有卷。

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

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

从CLI查看卷的详细信息

运行以下命令可显示特定卷的详细信息。 您可以使用卷的名称或ID来识别卷。

ibmcloud is volume VOLUME_ID [--json]

请参阅以下示例。

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

在该示例中，卷附加到虚拟服务器实例，因此卷附加和实例的名称和ID也会显示在命令输出中。 Active 属性为 true，因为卷所连接的虚拟服务器实例正在运行。 Busy 属性的值为 false，表示该卷不执行必须序列化的操作。

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

引导卷的额外 CLI 属性

请求查看启动卷的详细信息时，响应中会返回一些额外的属性。 请参阅以下示例：

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

允许使用属性继承自父引导卷创建的源映像或快照。 使用 CLI 或 API，可以在创建实例或更新启动卷时覆盖这些值。 您必须拥有 is.volume.volume.manage-allowed-use IAM 角色才能进行这些更新。

这些属性由布尔 通用表达式语言的表达式组成。 当表达式求值为 true 时，允许使用启动卷或从启动卷创建的映像来配置虚拟服务器实例或裸机服务器。 当表达式被评估为 false 时，供应将被阻止。 有关更多信息，请参阅 为自定义图像添加允许使用表达式。

使用 API 查看 Block Storage for VPC 卷

通过对 VPC REST API 进行调用，以编程方式查看 Block Storage for VPC 卷。 您可以列出所有卷并查看特定卷的详细信息。

开始之前，请确保 设置 API 环境。

使用API查看所有卷

发出 GET /volumes 调用以列出有关所有卷的摘要信息。 请参阅以下示例。

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

成功的响应如下例所示。 此示例显示了三个数据卷。 列表中的第二个连接到一个实例。

[
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "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",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
    }
  }
]

使用 API 查看卷详细信息

发出 GET /volumes/{id} 调用以查看卷的详细信息。 请参阅以下示例。

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

成功响应提供卷的详细信息，包括容量和 IOPS，卷状态以及卷是否连接到实例。

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

启动卷的额外 API 属性

当您请求查看启动卷的详细信息时，GET /volumes 和 GET /volumes/{id} 请求的响应中会返回一些额外的属性。

  • active 属性指示卷所连接到的虚拟服务器实例是正在运行还是已停止。 什么时候 active = true，实例正在运行，并且需要正在运行的实例的操作（例如 从启动卷创建映像） 也可以进行。

  • busy 属性指示此卷是否正在执行必须序列化的操作。 如果操作需要序列化，那么除非此属性为 false，否则操作将失败。

  • 允许使用表达式继承自父引导卷创建时的源映像或快照。 只能在分离的启动卷上更新允许使用表达式。 使用 CLI 或 API，可以在创建实例或更新启动卷时覆盖这些值。 您必须拥有 is.volume.volume.manage-allowed-use IAM 角色才能进行这些更新。 这些属性由布尔 通用表达式语言的表达式组成。 当表达式求值为 true 时，允许使用启动卷或从启动卷创建的映像来配置虚拟服务器实例或裸机服务器。 当表达式被评估为 false 时，供应将被阻止。 有关更多信息，请参阅 为自定义图像添加允许使用表达式。

请参阅以下示例。

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

使用Terraform查看 Block Storage for VPC 的卷

您可以使用Terraform查看您的 Block Storage for VPC 卷的信息。

要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud Provider 插件。 更多信息，请参阅 《Terraform入门 》。

VPC基础设施服务使用特定的区域终端，默认情况下，该终端的目标地址为 us-south。 如果您的VPC是在其他区域创建的，请确保在 provider.tf 文件中的提供商块中指定相应的区域。

请参阅以下示例，了解如何定位默认区域之外的区域 us-south。

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

使用Terraform查看所有卷

将属于某个账户的卷列表作为只读数据源导入。 您可以按卷名称、区域名称、附件状态、加密类型、操作系统系列（适用于启动卷）或操作系统架构（适用于启动卷）进行过滤。

data "ibm_is_volumes" "example" {
}

导出的属性包括卷总数和卷列表。 嵌套属性包括卷ID、名称、创建日期、大小、IOPS、CRN、访问权限和用户标签、配置文件、加密类型和密钥、生命周期状态、运行状况和原因、操作系统以及其他属性。

更多信息，请参阅 ibm_is_volumes。

使用Terraform查看流量详情

将卷的详细信息作为只读数据源导入。 您必须通过ID或名称来识别音量。

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

导出的属性包括卷总数和卷列表。 嵌套属性包括卷ID、名称、创建日期、大小、IOPS、CRN、访问权限和用户标签、配置文件、加密类型和密钥、生命周期状态、运行状况和原因、操作系统以及其他属性。

更多信息，请参阅 ibm_is_volume。

启动卷的额外 Terraform 属性

允许使用表达式继承自父引导卷创建时的源映像或快照。 只能在分离的启动卷上更新允许使用表达式。 使用 Terraform，可以在创建实例或更新启动卷时覆盖这些值。 您必须拥有 is.volume.volume.manage-allowed-use IAM 角色才能进行这些更新。 这些属性由布尔 通用表达式语言的表达式组成。 当表达式求值为 true 时，允许使用启动卷或从启动卷创建的映像来配置虚拟服务器实例或裸机服务器。 当表达式被评估为 false 时，供应将被阻止。 有关更多信息，请参阅 为自定义图像添加允许使用表达式。

后续步骤

创建更多卷，或管理现有的 Block Storage for VPC 卷。