라벨 만들기 및 관리

이 페이지에서는 라벨을 간략히 설명하고 Resource Manager API 및 Google Cloud Console을 사용하여 라벨을 만들고 관리하는 방법을 설명합니다.

라벨이란 무엇인가요?

라벨은 Google Cloud 인스턴스를 체계화하는 데 도움이 되는 키-값 쌍입니다. 각 리소스에 라벨을 연결한 다음 라벨을 기준으로 리소스를 필터링할 수 있습니다. 라벨에 대한 정보가 결제 시스템에 전달되므로 라벨을 기준으로 청구 상세 내역을 확인할 수 있습니다.

라벨의 일반적인 사용 사례

모든 API 호출의 타임스탬프 또는 개별 값과 같은 고유 라벨을 대량으로 만드는 것은 권장하지 않습니다. 다음은 라벨의 몇 가지 일반적인 사용 사례입니다.

  • 팀 또는 비용 센터 라벨: 팀 또는 비용 센터를 기준으로 라벨을 추가하여 서로 다른 팀(예: team:research 및 team:analytics)에서 소유하는 인스턴스를 구분할 수 있습니다. 비용 계산이나 예산 책정에 이 유형의 라벨을 사용할 수 있습니다.

  • 구성요소 라벨: component:redis, component:frontend, component:ingest, component:dashboard를 예시로 들 수 있습니다.

  • 환경 또는 단계 라벨: environment:production과 environment:test를 예로 들 수 있습니다.

  • 상태 라벨: state:active , state:readytodelete, state:archive를 예시로 들 수 있습니다.

  • 가상 머신 라벨: 가상 머신에 라벨을 연결할 수 있습니다. 이전에 정의한 가상 머신 태그는 값이 없는 라벨로 나타납니다.

라벨 요구사항

리소스에 적용된 라벨은 다음 요구사항을 충족해야 합니다.

  • 각 리소스는 여러 개의 라벨(최대 64개)을 가질 수 있습니다.
  • 각 라벨은 키-값 쌍이어야 합니다.
  • 키는 비워 둘 수 없으며 최소 길이는 1자(영문 기준)이고 최대 길이는 63자(영문 기준)입니다. 값은 비워 둘 수 있으며 최대 길이는 63자(영문 기준)입니다.
  • 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
  • 라벨의 키 부분은 고유해야 합니다. 그러나 여러 리소스에 동일한 키를 사용할 수 있습니다.
  • 키는 소문자나 국제 문자로 시작해야 합니다.

Resource Manager API를 사용하여 라벨 만들기 및 관리

라벨이 있는 새 프로젝트를 생성하려면 프로젝트를 만들 때 labels 필드를 설정합니다.

REST

요청:

POST https://cloudresourcemanager.googleapis.com/v1beta1/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}
응답: 

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Python

...

  project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'myproject',
        labels.color: "red"
}).execute()

...


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

  • get() 메서드를 사용하여 프로젝트를 가져옵니다.
  • labels 필드를 수정합니다.
  • update() 메서드를 사용하여 프로젝트를 업데이트합니다.

프로젝트 라벨을 업데이트하는 방법은 프로젝트 업데이트를 참조하세요.

라벨을 사용하여 프로젝트를 필터링하는 방법은 프로젝트 나열을 참조하세요.

권한

projects.update() 메서드를 호출하여 라벨을 추가하거나 수정할 수 있습니다. 그러려면 resourcemanager.projects.update 권한이 필요합니다.

projects.get() 메서드를 호출하여 프로젝트의 라벨을 볼 수 있습니다. 그러려면 resourcemanager.projects.get 권한이 필요합니다.

Cloud Console을 사용하여 라벨 만들기 및 관리

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

  1. Cloud Console에서 라벨 페이지를 엽니다.
    라벨 페이지 열기
  2. 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.
  3. 새 라벨 항목을 추가하려면 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
  4. 라벨 추가를 완료했으면 저장을 클릭합니다.

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

  1. Cloud Console에서 리소스 관리 페이지를 엽니다.
    리소스 관리 페이지 열기
  2. 리소스 관리 페이지에서 라벨을 추가할 조직 및 프로젝트를 선택합니다.
  3. 오른쪽 패널의 라벨 탭에서 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
  4. 라벨 추가를 완료했으면 저장을 클릭합니다.

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

현재 라벨을 지원하는 서비스

현재 Google Cloud 서비스는 다음과 같은 라벨을 지원합니다.

  • Artifact Registry
  • BigQuery
  • Cloud Bigtable
  • Dataflow
  • Dataproc
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Healthcare API
  • Cloud Key Management Service
  • Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Google Kubernetes Engine
  • Cloud Run(완전 관리형)
  • 네트워킹
  • Resource Manager(프로젝트 전용)
  • App Engine(가변형 환경 및 표준 환경)