이 문서에서는 스토리지 풀을 나열, 설명, 수정, 삭제하는 방법을 설명합니다.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. Google Cloud
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 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
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
제한사항
하이퍼디스크 스토리지 풀을 관리할 때는 다음 제한사항에 유의하세요.
- 24시간 내에 최대 2회까지 스토리지 풀의 프로비저닝된 용량 또는 성능을 변경할 수 있습니다.
- 풀의 프로비저닝 모델은 변경할 수 없습니다. 표준 용량 스토리지 풀을 고급 용량 스토리지 풀로 변경하거나 고급 성능 스토리지 풀을 표준 성능 스토리지 풀로 변경할 수 없습니다.
- 디스크를 스토리지 풀 내부 또는 외부로 이동하는 것은 허용되지 않습니다. 디스크를 스토리지 풀 내부 또는 외부로 이동하려면 스냅샷에서 디스크를 다시 만들어야 합니다. 자세한 내용은 디스크 유형 변경을 참고하세요.
- 스토리지 풀의 디스크를 클론하거나, 인스턴스 스냅샷을 만들거나, 영구 디스크 비동기 복제를 구성할 수 없습니다.
- 시간당 최대 5개까지 스토리지 풀을 삭제할 수 있습니다.
- 스토리지 풀 관리 명령어는 즉시 성공 또는 실패하지만 작업을 완료하는 데 최대 5분까지 걸리고 변경사항이 표시되려면 최대 30분이 소요됩니다.
하이퍼디스크 스토리지 풀의 전체 제한사항 목록을 보려면 스토리지 풀의 제한사항을 참조하세요.
스토리지 풀을 수정할 때의 값 범위
스토리지 풀을 만들 때 크기, IOPS, 처리량의 새 값은 수정 중인 스토리지 풀 유형의 한도 내에 있어야 합니다. 또한 지원되는 증분 값을 사용하여 새 값만 지정할 수 있습니다.
자세한 성능 프로비저닝 한도는 스토리지 풀 한도를 참조하세요.
프로젝트의 스토리지 풀 나열
프로젝트에 생성된 스토리지 풀을 보려면 Google Cloud 콘솔, Google Cloud CLI, REST를 사용합니다.
Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동선택한 프로젝트 내에 생성된 스토리지 풀이 페이지에 표시됩니다.
선택사항: 필터 막대를 사용해서 위치, 유형, 이름, 남은 풀 용량과 같은 필터 매개변수와 일치하는 스토리지 풀만 표시할 수 있습니다.
현재 프로젝트 내에 생성된 모든 스토리지 풀을 나열하려면 gcloud compute storage-pools list
명령어를 사용합니다.
gcloud compute storage-pools list
결과를 특정 리전 또는 영역으로 제한하려면 --filter
플래그를 사용합니다. 예를 들면 다음과 같습니다.
--filter="zone ~ us
--filter="zone=us-east4-c"
프로젝트 및 영역 내에 생성된 스토리지 풀을 표시하려면 storagePools.list
메서드를 사용하여 GET
요청을 생성합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /storagePools
다음을 바꿉니다.
- PROJECT_ID: 스토리지 풀이 포함된 프로젝트의 ID입니다.
- ZONE: 스토리지 풀이 있는 영역(예:
us-central1-a
)입니다.
스토리지 풀의 디스크 나열
스토리지 풀에 생성된 디스크 목록을 가져오려면 Google Cloud 콘솔, Google Cloud CLI, REST를 사용합니다.
Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동선택한 프로젝트 내에 생성된 스토리지 풀이 페이지에 표시됩니다.
이름 필드에서 보려는 스토리지 풀 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
스토리지 풀 디스크 섹션에서 스토리지 풀에 생성된 디스크를 볼 수 있습니다.
스토리지 풀에 생성된 디스크를 나열하려면 gcloud compute storage-pools list-disks
명령어를 사용합니다.
gcloud compute storage-pools list-disksSTORAGE_POOL_NAME \ [--zone=ZONE ]
다음을 바꿉니다.
- STORAGE_POOL_NAME: 스토리지 풀의 이름입니다.
- ZONE: 선택사항. 스토리지 풀이 있는 영역(예:
us-central1-a
)입니다.
스토리지 풀을 사용 중인 디스크를 나열하려면 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: 스토리지 풀의 이름입니다.
스토리지 풀 설명
스토리지 풀의 세부정보를 보려면 Google Cloud 콘솔, Google Cloud CLI, REST를 사용하면 됩니다.
- Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동 페이지에 나열된 각 스토리지에 대해 다음 정보를 볼 수 있습니다.
- 상태
- 이름
- 위치
- 풀 유형
- 풀 용량
- 남은 풀 용량
- 풀 IOPS
- 남은 풀 IOPS
- 풀에 생성된 디스크 수
이름 필드에서 보려는 스토리지 풀 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
페이지 상단의 타일에서 프로비저닝 및 사용된 용량, 스토리지 풀의 프로비저닝 및 사용된 처리량과 IOPS를 확인할 수 있습니다.
스토리지 풀 설정 섹션에서 생성 시간, 용량 프로비저닝 유형, 성능 프로비저닝 유형, 스토리지 풀의 총 디스크 수, 용량, 처리량, IOPS의 사용률 비율과 같은 스토리지 풀의 추가 속성을 볼 수 있습니다.
스토리지 풀 디스크 섹션에서 스토리지 풀에 생성된 디스크 관련 정보를 볼 수 있습니다.
선택사항: 스토리지 풀 사용량에 관한 자세한 내용은 모니터링 탭을 클릭하여 다양한 스토리지 풀 측정항목의 그래프를 확인하세요. 자세한 내용은 Hyperdisk Storage Pool 모니터링을 참고하세요.
gcloud compute storage-pools describe
명령어를 사용하여 스토리지 풀의 세부정보를 확인합니다.
gcloud compute storage-pools describeSTORAGE_POOL_NAME \ [--zone=ZONE ]
다음을 바꿉니다.
- STORAGE_POOL_NAME: 고유한 스토리지 풀 이름입니다.
- ZONE: 선택사항. 스토리지 풀이 있는 영역(예:
us-central1-a
)입니다.
스토리지 풀 관련 세부정보를 검색하려면 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, 처리량을 늘리려면 프로젝트 및 리전에 사용 가능한 할당량이 있어야 합니다.
- Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동 이름 필드에서 수정하려는 스토리지 풀 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
수정을 클릭합니다.
스토리지 풀 수정 페이지가 열립니다.
선택사항: 스토리지 풀 용량 필드에 풀 프로비저닝 용량의 새 값을 입력합니다. 새 값은 최소 1TiB 이상이고 최대 100TiB 또는 현재 값보다 작거나 같아야 합니다. 최소 크기는 10TiB 미만일 수 없으며 최대 크기는 1,024TiB 이하여야 합니다.
선택사항: 프로비저닝 처리량 필드에 프로비저닝 처리량의 새 값을 입력합니다.
선택사항: 하이퍼디스크 균형 유형의 스토리지 풀의 경우 프로비저닝 IOPS 필드에 프로비저닝 IOPS의 새 값을 입력합니다.
저장을 클릭하여 스토리지 풀을 업데이트합니다.
gcloud compute storage-pools update
명령어를 사용하여 스토리지 풀을 수정합니다.
gcloud compute storage-pools updateSTORAGE_POOL_NAME \ --zone=ZONE \ --provisioned-capacity=POOL_SIZE TiB \ --provisioned-iops=IOPS \ --provisioned-throughput=THROUGHPUT \ --description=DESCRIPTION
다음을 바꿉니다.
- STORAGE_POOL_NAME: 스토리지 풀의 이름입니다.
- ZONE: 선택사항: 스토리지 풀이 있는 영역(예:
us-central1-a
)입니다. - POOL_SIZE: 선택사항: 스토리지 풀 프로비저닝 용량(TiB)입니다.
- IOPS: 선택사항: 스토리지 풀 프로비저닝 IOPS입니다. 이 플래그는 하이퍼디스크 균형 스토리지 풀에만 사용할 수 있습니다.
- THROUGHPUT: 선택사항: 스토리지 풀 프로비저닝 처리량(MBps)입니다.
- DESCRIPTION: 선택사항: 스토리지 풀을 설명하는 문자열입니다.
스토리지 풀을 업데이트하려면 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: 선택사항: MBps로 지정된 스토리지 풀 프로비저닝 처리량의 새 값입니다.
스토리지 풀 삭제
스토리지 풀을 삭제하거나 제거하려면 먼저 스토리지 풀 내에서 모든 디스크를 삭제해야 합니다. 그런 다음 Google Cloud 콘솔, Google Cloud CLI, REST를 사용하여 스토리지 풀을 삭제할 수 있습니다.
스토리지 풀을 삭제하면 되돌릴 수 없습니다. 그러나 스토리지 풀을 삭제해도 스토리지 풀에 생성된 디스크에서 만든 스냅샷은 삭제되지 않습니다. 스냅샷은 별도로 삭제해야 합니다.
- Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
스토리지 풀 페이지로 이동 이름 필드에서 삭제하려는 스토리지 풀의 이름을 클릭합니다.
스토리지 풀 관리 페이지가 열립니다.
스토리지 풀 디스크 섹션에서 스토리지 풀에 나열된 디스크가 없는지 확인합니다.
풀 삭제를 클릭합니다.
gcloud compute storage-pools delete
명령어를 사용하여 스토리지 풀을 삭제합니다.
gcloud compute storage-pools deleteSTORAGE_POOL_NAME \ --zone=ZONE \
다음을 바꿉니다.
- STORAGE_POOL_NAME: 고유한 스토리지 풀 이름입니다.
- ZONE: 선택사항: 스토리지 풀이 있는 영역입니다(예:
us-central1-a
).
스토리지 풀을 삭제하려면 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: 고유한 스토리지 풀 이름입니다.
다음 단계
- 스토리지 풀 자세히 알아보기