이 문서에서는 스토리지 풀을 나열, 설명, 수정, 삭제하는 방법을 설명합니다.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Cloud de Confiance by S3NS 서비스 및 API에 액세스하기 위해 ID를 확인합니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Cloud de Confiance console to access Cloud de Confiance by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다. 로그인한 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
gcloud init - Set a default region and zone.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다. 로그인한 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
gcloud init자세한 내용은 Cloud de Confiance 인증 문서의 REST 사용을 위한 인증을 참조하세요.
필수 역할 및 권한
스토리지 풀을 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
Compute 인스턴스 관리자(v1)(
roles/compute.instanceAdmin.v1) - 서비스 계정으로 실행할 수 있는 VM 인스턴스에 연결: 서비스 계정 사용자(v1)(
roles/iam.serviceAccountUser역할)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 스토리지 풀을 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
스토리지 풀을 관리하려면 다음 권한이 필요합니다.
-
프로젝트 및 영역의 스토리지 풀 나열:
compute.storagePools.list -
스토리지 풀 내의 디스크 나열:
compute.storagePools.get -
스토리지 풀의 속성 보기:
compute.storagePools.get -
스토리지 풀의 프로비저닝된 용량 또는 성능 업데이트:
-
compute.storagePools.get -
compute.storagePools.update
-
-
스토리지 풀 삭제:
compute.storagePools.delete
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
제한사항
Hyperdisk 스토리지 풀을 관리할 때는 다음 제한사항에 유의하세요.
- 24시간 내에 최대 2회까지 스토리지 풀의 프로비저닝된 용량 또는 성능을 변경할 수 있습니다.
- 풀의 프로비저닝 모델은 변경할 수 없습니다. 표준 용량 스토리지 풀을 고급 용량 스토리지 풀로 변경하거나 고급 성능 스토리지 풀을 표준 성능 스토리지 풀로 변경할 수 없습니다.
- 디스크를 스토리지 풀 내부 또는 외부로 이동하는 것은 허용되지 않습니다. 디스크를 스토리지 풀 내부 또는 외부로 이동하려면 스냅샷에서 디스크를 다시 만들어야 합니다. 자세한 내용은 디스크 유형 변경을 참조하세요.
- 스토리지 풀의 디스크를 클론하거나, 인스턴스 스냅샷을 만들거나, 비동기 복제를 구성할 수 없습니다.
- 시간당 최대 5개까지 스토리지 풀을 삭제할 수 있습니다.
- 스토리지 풀 관리 명령어는 즉시 성공 또는 실패하지만 작업을 완료하는 데 최대 5분까지 걸리고 변경사항이 표시되려면 최대 30분이 소요됩니다.
Hyperdisk 스토리지 풀의 전체 제한사항 목록을 보려면 스토리지 풀의 제한사항을 참조하세요.
스토리지 풀을 수정할 때의 값 범위
스토리지 풀을 만들 때 크기, IOPS, 처리량의 새 값은 수정 중인 스토리지 풀 유형의 한도 내에 있어야 합니다. 또한 지원되는 증분 값을 사용하여 새 값만 지정할 수 있습니다.
자세한 성능 프로비저닝 한도는 스토리지 풀 한도를 참조하세요.
프로젝트의 스토리지 풀 나열
프로젝트에 생성된 스토리지 풀을 보려면Cloud de Confiance 콘솔, Google Cloud CLI, REST를 사용합니다.
콘솔
Cloud de Confiance 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동선택한 프로젝트 내에 생성된 스토리지 풀이 페이지에 표시됩니다.
(선택사항) 필터 막대를 사용해서 위치, 유형, 이름, 남은 풀 용량과 같은 필터 매개변수와 일치하는 스토리지 풀만 표시할 수 있습니다.
gcloud
현재 프로젝트 내에 생성된 모든 스토리지 풀을 나열하려면
gcloud compute storage-pools list명령어를 사용합니다.gcloud compute storage-pools list
결과를 특정 리전 또는 영역으로 제한하려면
--filter플래그를 사용합니다. 예를 들면 다음과 같습니다.--filter="zone ~ us--filter="zone=us-east4-c"
REST
프로젝트 및 영역 내에 생성된 스토리지 풀을 표시하려면
storagePools.list메서드를 사용하여GET요청을 생성합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools
다음을 바꿉니다.
- PROJECT_ID: 스토리지 풀이 포함된 프로젝트의 ID
- ZONE: 스토리지 풀이 있는 영역(예:
us-central1-a)
스토리지 풀의 디스크 나열
스토리지 풀에 생성된 디스크 목록을 가져오려면Cloud de Confiance 콘솔, Google Cloud CLI, REST를 사용합니다.
콘솔
Cloud de Confiance 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동선택한 프로젝트 내에 생성된 스토리지 풀이 페이지에 표시됩니다.
이름 필드에서 보려는 스토리지 풀 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
스토리지 풀 디스크 섹션에서 스토리지 풀에 생성된 디스크를 볼 수 있습니다.
gcloud
스토리지 풀에 생성된 디스크를 나열하려면
gcloud compute storage-pools list-disks명령어를 사용합니다.gcloud compute storage-pools list-disks STORAGE_POOL_NAME \ [--zone=ZONE]다음을 바꿉니다.
- STORAGE_POOL_NAME: 스토리지 풀의 이름
- ZONE: (선택사항) 스토리지 풀이 있는 영역(예:
us-central1-a)
REST
스토리지 풀을 사용 중인 디스크를 나열하려면
storagePools.listDisks메서드를 사용하여GET요청을 생성합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks
다음을 바꿉니다.
- PROJECT_ID: 스토리지 풀이 포함된 프로젝트의 ID
- ZONE: 스토리지 풀이 있는 영역(예:
us-central1-a) - STORAGE_POOL_NAME: 스토리지 풀의 이름
스토리지 풀 설명
스토리지 풀의 세부정보를 보려면 Cloud de Confiance 콘솔, Google Cloud CLI 또는 REST를 사용하면 됩니다.
콘솔
- Cloud de Confiance 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동 페이지에 나열된 각 스토리지에 대해 다음 정보를 볼 수 있습니다.
- 상태
- 이름
- 위치
- 풀 유형
- 풀 용량
- 남은 풀 용량
- 풀 IOPS
- 남은 풀 IOPS
- 풀에 생성된 디스크 수
이름 필드에서 보려는 스토리지 풀 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
페이지 상단의 타일에서 프로비저닝 및 사용된 용량, 스토리지 풀의 프로비저닝 및 사용된 처리량과 IOPS를 확인할 수 있습니다.
스토리지 풀 설정 섹션에서 생성 시간, 용량 프로비저닝 유형, 성능 프로비저닝 유형, 스토리지 풀의 총 디스크 수, 용량, 처리량, IOPS의 사용률 비율과 같은 스토리지 풀의 추가 속성을 볼 수 있습니다.
스토리지 풀 디스크 섹션에서 스토리지 풀에 생성된 디스크 관련 정보를 볼 수 있습니다.
(선택사항) 스토리지 풀 사용량에 관한 자세한 내용은 모니터링 탭을 클릭하여 다양한 스토리지 풀 측정항목의 그래프를 확인하세요. 자세한 내용은 Hyperdisk Storage Pool 만들기를 참조하세요.
gcloud
gcloud compute storage-pools describe명령어를 사용하여 스토리지 풀의 세부정보를 확인합니다.gcloud compute storage-pools describe STORAGE_POOL_NAME \ [--zone=ZONE]다음을 바꿉니다.
- STORAGE_POOL_NAME: 고유한 스토리지 풀 이름
- ZONE: (선택사항) 스토리지 풀이 있는 영역(예:
us-central1-a)
REST
스토리지 풀 관련 세부정보를 검색하려면
storagePools.get메서드를 사용하여GET요청을 생성합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
다음을 바꿉니다.
- PROJECT_ID: 스토리지 풀이 포함된 프로젝트의 ID
- ZONE: 스토리지 풀이 있는 영역(예:
us-central1-a) - STORAGE_POOL_NAME: 스토리지 풀의 이름
스토리지 풀의 프로비저닝 용량, IOPS, 처리량 업데이트
스토리지 풀의 프로비저닝 용량, IOPS, 처리량을 늘리거나 줄일 수 있습니다. 스토리지 풀의 용량, IOPS, 처리량을 늘리려면 프로젝트 및 리전에 사용 가능한 할당량이 있어야 합니다.
콘솔
- Cloud de Confiance 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동 이름 필드에서 수정하려는 스토리지 풀 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
수정을 클릭합니다.
스토리지 풀 수정 페이지가 열립니다.
(선택사항) 스토리지 풀 용량 필드에 풀 프로비저닝 용량의 새 값을 입력합니다. 새 값은 최소 1TiB 이상이고 최대 100TiB 또는 현재 값보다 작거나 같아야 합니다. 최소 크기는 10TiB 미만일 수 없으며 최대 크기는 1,024TiB 이하여야 합니다.
(선택사항) 프로비저닝 처리량 필드에 프로비저닝 처리량의 새 값을 입력합니다.
(선택사항) Hyperdisk Balanced 유형의 스토리지 풀의 경우 프로비저닝 IOPS 필드에 프로비저닝 IOPS의 새 값을 입력합니다.
저장을 클릭하여 스토리지 풀을 업데이트합니다.
gcloud
gcloud compute storage-pools update명령어를 사용하여 스토리지 풀을 수정합니다.gcloud compute storage-pools update STORAGE_POOL_NAME \ --zone=ZONE \ --provisioned-capacity=POOL_SIZETiB \ --provisioned-iops=IOPS \ --provisioned-throughput=THROUGHPUT \ --description=DESCRIPTION다음을 바꿉니다.
- STORAGE_POOL_NAME: 스토리지 풀의 이름
- ZONE: (선택사항) 스토리지 풀이 있는 영역(예:
us-central1-a) - POOL_SIZE: (선택사항) 스토리지 풀 프로비저닝 용량(TiB)
- IOPS: (선택사항) 스토리지 풀 프로비저닝 IOPS. 이 플래그는 Hyperdisk Balanced 스토리지 풀에만 사용할 수 있습니다.
- THROUGHPUT: (선택사항) 스토리지 풀 프로비저닝 처리량(MiB/s)
- DESCRIPTION: (선택사항) 스토리지 풀을 설명하는 문자열
REST
스토리지 풀을 업데이트하려면
storagePools.update메서드를 사용하여PATCH요청을 생성합니다.PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME { "description": "DESCRIPTION", "poolProvisionedCapacityGb": "SIZE", "poolProvisionedIops": "IOPS", "poolProvisionedThroughput": "THROUGHPUT" }다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
- ZONE: 스토리지 풀이 있는 영역(예:
us-central1-a) - STORAGE_POOL_NAME: 스토리지 풀의 이름
- DESCRIPTION: (선택사항) 스토리지 풀을 설명하는 텍스트 필드
- SIZE: (선택사항) 새 스토리지 풀 프로비저닝 용량(GiB)
- IOPS: (선택사항) 스토리지 풀 프로비저닝 IOPS의 새 값. 스토리지 풀에
hyperdisk-balanced유형의 디스크가 포함된 경우에만 이 속성을 지정할 수 있습니다. - THROUGHPUT: (선택사항) MiB/s로 지정된 스토리지 풀 프로비저닝 처리량의 새 값
스토리지 풀 삭제
스토리지 풀을 삭제하거나 제거하려면 먼저 스토리지 풀 내에서 모든 디스크를 삭제해야 합니다. 그런 다음 Cloud de Confiance 콘솔, Google Cloud CLI 또는 REST를 사용하여 스토리지 풀을 삭제할 수 있습니다.
스토리지 풀을 삭제하면 되돌릴 수 없습니다. 그러나 스토리지 풀을 삭제해도 스토리지 풀에 생성된 디스크에서 만든 스냅샷은 삭제되지 않습니다. 스냅샷은 별도로 삭제해야 합니다.
콘솔
- Cloud de Confiance 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동 이름 필드에서 삭제하려는 스토리지 풀의 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
스토리지 풀 디스크 섹션에서 스토리지 풀에 나열된 디스크가 없는지 확인합니다.
풀 삭제를 클릭합니다.
gcloud
gcloud compute storage-pools delete명령어를 사용하여 스토리지 풀을 삭제합니다.gcloud compute storage-pools delete STORAGE_POOL_NAME \ --zone=ZONE \다음을 바꿉니다.
- STORAGE_POOL_NAME: 고유한 스토리지 풀 이름
- ZONE: (선택사항) 스토리지 풀이 있는 영역(예:
us-central1-a)
REST
스토리지 풀을 삭제하려면
storagePools.delete메서드에 대해DELETE요청을 생성합니다.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
- ZONE: 스토리지 풀이 있는 영역(예:
us-central1-a) - STORAGE_POOL_NAME: 고유한 스토리지 풀 이름
다음 단계
- 스토리지 풀 자세히 알아보기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-10-30(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-10-30(UTC)"],[],[]] -