프로젝트용 라벨 만들기 및 업데이트

이 문서에서는 gcloud CLI, Cloud Resource Manager API,Google Cloud 콘솔을 사용하여 프로젝트용 라벨을 만들고 업데이트하는 방법을 자세히 설명합니다.

참고: Resource Manager 라벨은 프로젝트에만 적용됩니다 (폴더 및 조직은 라벨을 지원하지 않음). 프로젝트에 연결된 라벨은 프로젝트 내의 하위 리소스로 자동 전파되지 않습니다. 특정 서비스 리소스 (예: Compute Engine 인스턴스 또는 Cloud Storage 버킷)에 라벨을 적용하거나 업데이트하려면 리소스의 문서 또는라벨을 지원하는 서비스를 참조하세요.

참고: Pub/Sub는 주제 및 구독 처리량 청구에 대한 라벨을 지원하지만 이그레스 청구 SKU는 라벨을 지원하지 않습니다.

프로젝트용 라벨 만들기

콘솔

단일 프로젝트에 라벨을 추가하는 방법은 다음과 같습니다.

1. 콘솔 Google Cloud 에서 라벨 페이지를 엽니다.

   라벨 페이지 열기

2. 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.

3. 새 라벨 항목을 추가하려면 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.

4. 라벨 추가를 완료했으면 저장을 클릭합니다.

동시에 둘 이상의 프로젝트에 대해 라벨을 추가하는 방법은 다음과 같습니다.

1. Google Cloud 콘솔에서 리소스 관리 페이지를 엽니다.

   리소스 관리 페이지 열기

2. 리소스 관리 페이지에서 라벨을 추가할 프로젝트를 선택합니다.

3. 정보 패널의 라벨 탭에서 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.

4. 라벨 추가를 완료했으면 저장을 클릭합니다.

라벨을 추가한 후에 프로젝트 목록 위의 필터 상자에 라벨 키 또는 값을 입력하여 프로젝트를 필터링할 수 있습니다. 필터 상자에서는 결과를 미리 볼 수 있도록 키와 값을 제안합니다.

gcloud

gcloud CLI를 사용하여 라벨이 있는 새 프로젝트를 만들려면 --labels 플래그와 함께 gcloud projects create 명령어를 사용합니다.

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

기존 프로젝트에 라벨을 추가하려면 --update-labels 플래그와 함께 gcloud projects update 명령어를 사용합니다.

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

각 항목의 의미는 다음과 같습니다.

• PROJECT_ID 는 만들거나 업데이트하려는 프로젝트의 ID입니다.
• KEY1=VALUE1은 추가하려는 라벨의 키-값 쌍입니다.

REST

라벨이 있는 새 프로젝트를 만들려면 projects.create 메서드에 POST 요청을 할 때 labels 필드를 포함합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

기존 프로젝트에 라벨을 추가하려면 projects.patch 메서드를 사용합니다.

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

프로젝트용 라벨 업데이트

콘솔

단일 프로젝트의 라벨을 업데이트하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔에서 라벨 페이지를 엽니다.

   라벨 페이지 열기

2. 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.

3. 프로젝트 라벨을 업데이트합니다.

   1. 라벨을 수정하려면 수정하려는 값을 클릭한 후 원하는 대로 변경합니다.
   2. 라벨을 삭제하려면 마우스 포인터를 키나 값에 올려놓은 후 를 클릭합니다.

4. 라벨 업데이트를 완료했으면 저장을 클릭합니다.

동시에 둘 이상의 프로젝트에 대해 라벨을 업데이트하는 방법은 다음과 같습니다.

1. Google Cloud 콘솔에서 리소스 관리 페이지를 엽니다.

   리소스 관리 페이지 열기

2. 리소스 관리 페이지에서 라벨을 업데이트할 프로젝트를 선택합니다.

3. 정보 패널에서 라벨 탭을 클릭하고 선택한 프로젝트의 라벨을 업데이트합니다.

   1. 라벨을 수정하려면 수정하려는 값을 클릭한 후 원하는 대로 변경합니다.
   2. 라벨을 삭제하려면 마우스 포인터를 키나 값에 올려놓은 후 를 클릭합니다.

4. 라벨 업데이트를 완료했으면 저장 을 클릭합니다.

gcloud

gcloud CLI를 사용하여 프로젝트의 라벨을 업데이트하려면 --update-labels, --remove-labels, --clear-labels 플래그와 함께 gcloud projects update 명령어를 사용합니다.

라벨을 추가하거나 업데이트하려면 다음 안내를 따르세요.

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

특정 라벨을 삭제하려면 다음 안내를 따르세요.

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

프로젝트에서 모든 라벨을 삭제하려면 다음 안내를 따르세요.

gcloud projects update PROJECT_ID \
    --clear-labels

REST

API를 사용하여 프로젝트의 라벨을 업데이트하려면 projects.patch 메서드에 PATCH 요청을 보냅니다.

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

여기서 PROJECT_ID는 업데이트하려는 프로젝트의 ID입니다.