하이퍼디스크 스토리지 풀 관리

이 문서에서는 스토리지 풀을 나열, 설명, 수정, 삭제하는 방법을 설명합니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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를 사용합니다.

콘솔

  1. Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
    스토리지 풀 페이지로 이동

    선택한 프로젝트 내에 생성된 스토리지 풀이 페이지에 표시됩니다.

  2. 선택사항: 필터 막대를 사용해서 위치, 유형, 이름, 남은 풀 용량과 같은 필터 매개변수와 일치하는 스토리지 풀만 표시할 수 있습니다.

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)입니다.

스토리지 풀의 디스크 나열

스토리지 풀에 생성된 디스크 목록을 가져오려면 Google Cloud 콘솔, Google Cloud CLI, REST를 사용합니다.

콘솔

  1. Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
    스토리지 풀 페이지로 이동

    선택한 프로젝트 내에 생성된 스토리지 풀이 페이지에 표시됩니다.

  2. 이름 필드에서 보려는 스토리지 풀 이름을 클릭합니다.

    스토리지 풀 관리 페이지가 열립니다.

  3. 스토리지 풀 디스크 섹션에서 스토리지 풀에 생성된 디스크를 볼 수 있습니다.

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: 스토리지 풀의 이름입니다.

스토리지 풀 설명

스토리지 풀의 세부정보를 보려면 Google Cloud 콘솔, Google Cloud CLI, REST를 사용하면 됩니다.

콘솔

  1. Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
    스토리지 풀 페이지로 이동

  2. 페이지에 나열된 각 스토리지에 대해 다음 정보를 볼 수 있습니다.

    • 상태
    • 이름
    • 위치
    • 풀 유형
    • 풀 용량
    • 남은 풀 용량
    • 풀 IOPS
    • 남은 풀 IOPS
    • 풀에 생성된 디스크 수

  3. 이름 필드에서 보려는 스토리지 풀 이름을 클릭합니다.

    스토리지 풀 관리 페이지가 열립니다.

  4. 페이지 상단의 타일에서 프로비저닝 및 사용된 용량, 스토리지 풀의 프로비저닝 및 사용된 처리량과 IOPS를 확인할 수 있습니다.

  5. 스토리지 풀 설정 섹션에서 생성 시간, 용량 프로비저닝 유형, 성능 프로비저닝 유형, 스토리지 풀의 총 디스크 수, 용량, 처리량, IOPS의 사용률 비율과 같은 스토리지 풀의 추가 속성을 볼 수 있습니다.

  6. 스토리지 풀 디스크 섹션에서 스토리지 풀에 생성된 디스크 관련 정보를 볼 수 있습니다.

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, 처리량을 늘리려면 프로젝트 및 리전에 사용 가능한 할당량이 있어야 합니다.

콘솔

  1. Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
    스토리지 풀 페이지로 이동

  2. 이름 필드에서 수정하려는 스토리지 풀 이름을 클릭합니다.

    스토리지 풀 관리 페이지가 열립니다.

  3. 수정을 클릭합니다.

    스토리지 풀 수정 페이지가 열립니다.

  4. 선택사항: 스토리지 풀 용량 필드에 풀 프로비저닝 용량의 새 값을 입력합니다. 새 값은 최소 1TiB 이상이고 최대 100TiB 또는 현재 값보다 작거나 같아야 합니다. 최소 크기는 10TiB 미만일 수 없으며 최대 크기는 1,024TiB 이하여야 합니다.

  5. 선택사항: 프로비저닝 처리량 필드에 프로비저닝 처리량의 새 값을 입력합니다.

  6. 선택사항: 하이퍼디스크 균형 유형의 스토리지 풀의 경우 프로비저닝 IOPS 필드에 프로비저닝 IOPS의 새 값을 입력합니다.

  7. 저장을 클릭하여 스토리지 풀을 업데이트합니다.

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입니다. 이 플래그는 하이퍼디스크 균형 스토리지 풀에만 사용할 수 있습니다.
  • THROUGHPUT: 선택사항: 스토리지 풀 프로비저닝 처리량(MBps)입니다.
  • 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: 선택사항: MBps로 지정된 스토리지 풀 프로비저닝 처리량의 새 값입니다.

스토리지 풀 삭제

스토리지 풀을 삭제하거나 제거하려면 먼저 스토리지 풀 내에서 모든 디스크를 삭제해야 합니다. 그런 다음 Google Cloud 콘솔, Google Cloud CLI, REST를 사용하여 스토리지 풀을 삭제할 수 있습니다.

스토리지 풀을 삭제하면 되돌릴 수 없습니다. 그러나 스토리지 풀을 삭제해도 스토리지 풀에 생성된 디스크에서 만든 스냅샷은 삭제되지 않습니다. 스냅샷은 별도로 삭제해야 합니다.

콘솔

  1. Google Cloud 콘솔에서 스토리지 풀 페이지로 이동합니다.
    스토리지 풀 페이지로 이동

  2. 이름 필드에서 삭제하려는 스토리지 풀의 이름을 클릭합니다.

    스토리지 풀 관리 페이지가 열립니다.

  3. 스토리지 풀 디스크 섹션에서 스토리지 풀에 나열된 디스크가 없는지 확인합니다.

  4. 풀 삭제를 클릭합니다.

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: 고유한 스토리지 풀 이름입니다.

다음 단계