콘솔에서 모든 Block Storage for VPC 볼륨에 대한 정보 보기

Block Storage for VPC 볼륨의 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 인프라 > 인프라 > 스토리지 > Block Storage 볼륨을 클릭합니다.

Block Storage for VPC 의 볼륨은 기본적으로 해당 지역의 모든 리소스 그룹에 대해 10개 단위로 표시됩니다. 페이지 제어의 아래쪽 화살표를 클릭하여 이 사전 설정을 변경하고, 목록을 20권 또는 50권으로 늘리세요. 페이지 컨트롤 화살표를 사용하여 다음 페이지로 이동하거나 되돌아갑니다. 모든 Block Storage for VPC 볼륨의 목록에 다음 정보가 표시됩니다.

모든 볼륨에 대한 세부 정보

필드	설명
지역	이러한 볼륨이 있는 지역(예: 미국 남부)입니다. 아래쪽 화살표를 클릭하면 계정이 있는 다른 지역의 거래량을 확인할 수 있습니다.
이름	개별 볼륨 세부사항을 보려면 볼륨 이름을 클릭하십시오.
상태	모든 행에 대한 기본 필터로 작동하는 볼륨의 상태입니다.
위치	VPC에서 상속한 지역 내 가용성 구역(예: US South 1)입니다.
크기	지정한 볼륨 크기(GB)입니다.
연결 유형	인스턴스에 연결된 보조 볼륨의 경우 데이터, 부트 볼륨으로 연결된 경우 부트, 연결되지 않은 볼륨의 경우 공백입니다.
상태	'Health'는 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개의 탭이 있습니다. 기본적으로, 개요 탭은 볼륨 세부사항에 대해 선택되어 있습니다.

볼륨 세부사항

필드	설명
볼륨 세부사항
이름	볼륨을 생성할 때 지정한 볼륨의 이름입니다. 볼륨 이름을 편집하려면 편집 아이콘 을 클릭하십시오. 볼륨 이름은 최대 63자의 소문자 영숫자 문자가 될 수 있고, 하이픈(-)이 포함될 수 있으며, 소문자로 시작되어야 합니다. 볼륨 이름은 계정 및 지역에 대해 고유해야 합니다.
볼륨 ID	시스템 생성 볼륨 ID입니다.
상태	'Health'는 I/O 성능 및 데이터 일관성 등 볼륨의 전반적인 상태를 모니터링합니다. 볼륨 상태는 OK 또는 degraded 입니다. 성능과 용량이 OK 이하이거나 연결 문제가 발생하는 저하된 상태의 볼륨입니다. 스냅샷에서 복원 중인 볼륨도 성능 저하 상태를 표시합니다. 서비스는 사용자가 해결할 수 있도록 하급 상태에 대한 가능한 이유를 표시합니다. 자세한 정보는 Block Storage for VPC 볼륨 상태 를 참조하십시오.
리소스 그룹	리소스 그룹은 VPC를 설정할 때 정의됩니다. 리소스 그룹은 리소스에 대한 액세스를 관리하지만 청구 또는 모니터링에는 영향을 미치지 않습니다.
연결 유형	인스턴스에 연결된 보조 볼륨의 경우 데이터, 부팅 볼륨으로 연결된 경우 부팅 정보, 연결되지 않은 볼륨의 경우 빈 값입니다.
작성 날짜	볼륨이 작성될 때 시스템 생성 날짜입니다.
위치	지역의 가용성 구역입니다.
크기	지정한 볼륨 크기입니다. 볼륨이 가상 서버 인스턴스에 연결되고 볼륨이 해당 범위의 최대 용량이 아닌 경우, 아이콘을 클릭하여 볼륨을 확장할 수 있습니다. 자세한 내용은 Block Storage for VPC 볼륨 용량 확장을 참조하세요.
프로파일	이 필드에는 볼륨 프로필 이 표시됩니다: sdp, 사용자 정의 IOPS 또는 IOPS 계층 프로필 중 하나를 표시합니다.
최대 IOPS	사전 정의된 IOPS 계층의 최대 IOPS 값 또는 사용자 지정 IOPS에 대해 지정한 값입니다.
처리량	이 필드는 스토리지 볼륨의 할당된 대역폭을 나타내며, 초당 기가비트(Gbps)로 측정됩니다. 처리량은 볼륨이 프로비저닝된 IOPS 수에 처리량 승수를 곱한 결과로 계산됩니다. 볼륨 프로필에 따라 처리량 배율은 16KB 또는 256KB가 될 수 있습니다. sdp 프로필로 생성된 볼륨의 경우 처리량 값은 1000~8192Mbps 범위에서 사용자 지정할 수 있습니다.
암호화	IBM 관리 키를 사용한 암호화는 기본적으로 모든 볼륨에서 사용됩니다. 자체 루트 키를 사용하여 데이터를 보호할 수도 있습니다. '암호화' 필드에는 사용자가 프로비저닝한 키 관리 서비스(KMS)의 이름(예: Key Protect )과 고객이 직접 관리하는 서비스가 표시됩니다. 자세한 정보는 고객 관리 암호화를 사용하여 Block Storage for VPC 볼륨 작성 을 참조하십시오.
암호화 인스턴스	선택사항. 고객 관리 암호화 볼륨의 프로비저닝된 KMS 인스턴스에 대한 링크입니다.
키	선택사항. 고객이 관리하는 암호화 볼륨을 보호하는 암호 구문을 암호화하는 데 사용되는 루트 키의 이름과 복사 가능한 ID입니다.
백업 정책	볼륨과 연관된 백업 정책의 수입니다. 백업 정책 탭으로 이동하려면 숫자 링크를 클릭하십시오.
스냅샷	볼륨에서 작성된 스냅샷 수입니다. 스냅샷 및 백업 탭으로 이동하려면 숫자 링크를 클릭하십시오.
복제 역할	이 논문이 재현 연구 관계에서 차지하는 역할: source, replica 또는 none. 이 필드는 ‘ sdp ’ 프로필 볼륨에서만 표시됩니다.
연결된 가상 서버	여기에는 가상 서버 인스턴스에 연결된 볼륨이 나열되어 있습니다. '연결'을 클릭하여 이 볼륨을 연결할 인스턴스를 선택하십시오. 자세한 정보는 인스턴스에 볼륨 연결을 참조하십시오.
상태	이 필드는 볼륨의 전체 수명 주기 상태를 추적합니다. 볼륨 생성부터 볼륨 삭제까지를 포함합니다. 예를 들어, 연결 상태는 볼륨이 인스턴스에 연결되어 있을 때는 ‘ 첨부됨 ’이고, 연결이 진행 중일 때는 ‘ 첨부 ’입니다.
이름	인스턴스 세부사항을 보려면 가상 서버 인스턴스의 이름을 클릭하십시오.
자동 삭제	_사용_으로 설정된 경우 인스턴스 삭제 시 볼륨이 자동으로 삭제됩니다. 자동 삭제를 사용으로 설정하려면 토글을 클릭하십시오.
백업 정책	이 볼륨과 연관된 백업 정책을 표시합니다. 백업 정책을 연관시키기 위해 대상 자원에 대한 백업 정책의 태그를 이 볼륨에 추가할 수 있습니다. 적용 을 클릭하여 백업 정책을 선택한 후 대상 자원에 대한 해당 태그를 볼륨에 적용하십시오.

볼륨 세부 정보 페이지의 ‘ 작업 ’ 메뉴( )에서는 다음과 같은 작업을 수행할 수 있습니다

• 활동 추적 보기- 이 볼륨에 대한 활동 추적 로그를 확인합니다.
• 스냅샷 생성- 연결된 데이터 볼륨 또는 부팅 볼륨에서 스냅샷을 생성합니다. 자세한 내용은 콘솔에서 스냅샷 생성을 참조하십시오.
• 이미지 생성- 부팅 볼륨을 기반으로 사용자 지정 이미지를 생성합니다. 이 작업은 사용할 수 없을 때 회색으로 표시됩니다. 자세한 내용은 콘솔에서 볼륨으로 이미지 만들기를 참고하세요.
• 볼륨 확장- 연결된 볼륨의 크기를 1 GB 단위로 늘립니다. 자세한 정보는 블록 스토리지 볼륨 용량 확장을 참조하십시오.
• IOPS 프로필 편집- IOPS 프로필을 편집하여 IOPS를 늘리거나 줄임으로써 연결된 데이터 볼륨의 성능 특성을 변경합니다.
• 백업 정책 적용- 이 볼륨에 백업 정책을 적용합니다. 자세한 내용은 ‘리소스에 백업 정책 적용’을 참조하십시오.
• 볼륨 마이그레이션- 이 볼륨을 다른 프로필로 마이그레이션합니다. 자세한 내용은 ‘블록 스토리지 볼륨 마이그레이션’을 참조하십시오.
• 삭제- 연결되지 않은 볼륨을 삭제합니다. 자세한 내용은 콘솔에서 데이터 볼륨 삭제를 참고하세요.

수동으로 또는 백업 정책에 따라 생성된 이 볼륨의 스냅샷 목록을 보려면 [ 스냅샷 및 백업 ] 탭을 클릭하십시오.

인스턴스 세부사항에서 첨부된 Block Storage for VPC 볼륨 세부사항 보기

또한 가상 서버 인스턴스 세부 정보 페이지에서 연결된 Block Storage for VPC 볼륨에 대한 정보를 확인할 수 있습니다:

1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 인프라 > 인프라 > 컴퓨팅 > 가상 서버 인스턴스을 클릭하고 인스턴스를 선택합니다.

2. 연결된 블록 스토리지 볼륨에서 볼륨 이름을 클릭하여 볼륨 세부사항 페이지로 이동하십시오.

CLI에서 모든 볼륨 보기

모든 볼륨에 대한 요약 정보를 확인하려면 다음 명령을 실행하십시오:

ibmcloud is volumes [--json]

리소스 그룹 ID 또는 이름을 지정하면 리소스 그룹에 속하는 볼륨으로 목록이 필터링됩니다. 이 인수를 생략하면 기본적으로 모든 리소스 그룹이 선택됩니다. 또한 특정 가용성 구역에서 모든 볼륨을 볼 수 있습니다. 기본적으로 페이지당 첫 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 입니다. false 값이 있는 Busy 속성은 이 볼륨이 직렬화해야 하는 작업을 수행하고 있지 않음을 나타냅니다.

사용 가능한 명령 옵션에 대한 자세한 정보는 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로 모든 볼륨 보기

모든 볼륨에 대한 요약 정보를 나열하려면 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으로 모든 볼륨 보기

계정에 속한 볼륨 목록을 읽기 전용 데이터 소스로 가져옵니다. 볼륨 이름, 영역 이름, 첨부 상태, 암호화 유형, 운영 체제 계열(부팅 볼륨에 적용 가능) 또는 운영 체제 아키텍처(부팅 볼륨에 적용 가능)를 기준으로 필터링할 수 있습니다.

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을 사용하면 인스턴스를 생성할 때 또는 부팅 볼륨을 업데이트하여 이러한 값을 재정의할 수 있습니다. 이러한 업데이트를 수행하려면 is.volume.volume.manage-allowed-use IAM 역할이 있어야 합니다. 이러한 속성은 부울 공용 표현식 언어 표현식으로 구성됩니다. 표현식이 true 로 평가되면 부팅 볼륨 또는 부팅 볼륨에서 생성된 이미지로 가상 서버 인스턴스 또는 베어메탈 서버 프로비저닝이 허용됩니다. 표현식이 false 로 평가되면 프로비저닝이 차단됩니다. 자세한 내용은 사용자 지정 이미지에 허용된 사용 표현식 추가하기를 참조하세요.