인스턴스를 생성하면 Google Cloud Managed Lustre를 사용하여 인스턴스를 나열, 가져오기, 업데이트, 삭제할 수 있습니다.
관리형 Lustre 인스턴스를 업데이트할 때는 설명과 라벨만 수정할 수 있습니다.
인스턴스 나열
프로젝트의 모든 인스턴스를 나열하려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 관리형 Lustre 페이지로 이동합니다.
프로젝트의 인스턴스가 나열됩니다.
gcloud CLI
gcloud lustre instances list 명령어를 사용합니다.
gcloud lustre instances list --location=LOCATION
LOCATION을 특정 영역으로 바꿔 해당 위치의 모든 인스턴스를 나열합니다. 모든 위치의 프로젝트를 보려면 값으로 -을 입력합니다. 예를 들면 다음과 같습니다.
gcloud lustre instances list --location=-
REST
REST API를 사용하여 인스턴스를 나열하려면 다음 엔드포인트로 요청을 전송합니다.
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]
다음 값을 지정해야 합니다.
PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
ZONE은 모든 인스턴스를 나열할 영역입니다. 모든 영역의 인스턴스를 나열하려면
-를 값으로 사용합니다.
자세한 내용은 instances.list API 참조를 확인하세요.
인스턴스 가져오기
인스턴스의 세부정보를 가져오려면 다음을 실행하세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 관리형 Lustre 페이지로 이동합니다.
인스턴스 이름을 클릭하여 특정 인스턴스의 세부정보를 확인합니다.
gcloud CLI
gcloud lustre instances describe 명령어를 사용합니다.
gcloud lustre instances describe INSTANCE_NAME --location=LOCATION
REST
REST API를 사용하여 특정 인스턴스에 관한 세부정보를 가져오려면 다음 엔드포인트로 요청을 보냅니다.
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]
다음 값을 지정해야 합니다.
PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
ZONE은 Managed Lustre에서 지원하는 유효한 Google Cloud 영역이어야 합니다. 전체 목록은 지원되는 위치를 참고하세요.
INSTANCE_NAME은 반환할 관리형 Lustre 인스턴스의 이름입니다.
자세한 내용은 instances.get API 참조를 확인하세요.
인스턴스 업데이트
기존 인스턴스의 다음 속성을 업데이트할 수 있습니다.
- 설명
- labels
- 스토리지 용량
인스턴스의 스토리지 용량 증가에 대한 자세한 내용은 인스턴스의 용량 늘리기를 참고하세요.
인스턴스를 업데이트하려면 다음 단계를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 관리형 Lustre 페이지로 이동합니다.
업데이트할 인스턴스의 인스턴스 이름을 클릭합니다. 인스턴스 개요 페이지가 표시됩니다.
수정을 클릭합니다.
새 값을 입력합니다.
제출을 클릭합니다.
Google Cloud CLI
gcloud lustre instances update 명령어를 사용합니다.
gcloud lustre instances update INSTANCE_NAME \
--location=LOCATION \
--capacity-gib=NEW_CAPACITY \
--description=NEW_DESCRIPTION
각 항목의 의미는 다음과 같습니다.
- INSTANCE_NAME은 업데이트할 인스턴스입니다.
- LOCATION은 인스턴스가 있는 영역입니다.
- NEW_CAPACITY은 이 인스턴스의 새 스토리지 용량(기비바이트(GiB))입니다. 값은 허용되는 최대 용량을 초과할 수 없으며 단계 크기의 배수여야 합니다. 자세한 내용은 인스턴스 용량 늘리기를 참고하세요.
- NEW_DESCRIPTION은 설명 필드의 새 값으로, 기존 설명을 덮어씁니다.
라벨을 업데이트하려면 gcloud lustre instances update 문서에서 사용 가능한 명령어를 확인하세요.
REST
REST API를 사용하여 인스턴스를 업데이트하려면 특정 엔드포인트에 PATCH 요청을 보냅니다.
PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]
{
"capacityGib": 72000,
"description": "updated description",
"labels": {
"key1": "value1"
}
}
다음 값을 지정해야 합니다.
- PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
- ZONE은 인스턴스의 Google Cloud 영역입니다.
- INSTANCE_NAME은 업데이트할 관리형 Lustre 인스턴스의 이름입니다.
- UPDATE_MASK는 업데이트할 필드의 쉼표로 구분된 목록입니다. 마스크에 있으면 필드를 덮어씁니다.
요청 본문에는 다음 필드 중 하나 이상이 포함되어야 합니다.
capacityGiB은 이 인스턴스의 새 스토리지 용량(기비바이트(GiB))입니다. 값은 허용되는 최대 용량을 초과할 수 없으며 단계 크기의 배수여야 합니다. 자세한 내용은 인스턴스 용량 늘리기를 참고하세요.description: 이 인스턴스에 대한 새로운 설명입니다.labels은 이 인스턴스의 새 라벨 세트입니다.labels값은 하나 이상의 key:value 쌍을 포함하는 JSON 객체입니다.
자세한 내용은 instances.patch API 참조를 확인하세요.
인스턴스 삭제
인스턴스를 삭제하려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 관리형 Lustre 페이지로 이동합니다.
삭제할 인스턴스 옆에 있는 점 3개 메뉴를 선택합니다.
인스턴스 삭제를 선택합니다. 삭제를 다시 클릭하여 삭제를 확인합니다.
gcloud CLI
gcloud lustre instances delete 명령어를 사용합니다.
gcloud lustre instances delete INSTANCE_NAME --location=LOCATION
삭제를 확인하라는 메시지가 표시됩니다. Y을 입력하거나 Enter 키를 눌러 계속합니다.
REST
REST API를 사용하여 인스턴스를 삭제하려면 다음 엔드포인트로 요청을 전송합니다.
DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]
다음 값을 지정해야 합니다.
PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
ZONE은 인스턴스가 있는 Google Cloud 영역입니다.
INSTANCE_NAME은 삭제할 관리형 Lustre 인스턴스의 이름입니다.
자세한 내용은 instances.delete API 참조를 확인하세요.
삭제 요청은 장기 실행 요청이며 작업 상태를 쿼리할 수 있는 작업 ID를 반환합니다. 자세한 내용은 operations.get 참조를 확인하세요.