이 페이지에서는 라벨을 간략히 설명하고 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() ...
기존 프로젝트에 라벨을 추가하는 방법은 다음과 같습니다.
프로젝트 라벨을 업데이트하는 방법은 프로젝트 업데이트를 참조하세요.
라벨을 사용하여 프로젝트를 필터링하는 방법은 프로젝트 나열을 참조하세요.
권한
projects.update()
메서드를 호출하여 라벨을 추가하거나 수정할 수 있습니다. 그러려면 resourcemanager.projects.update
권한이 필요합니다.
projects.get()
메서드를 호출하여 프로젝트의 라벨을 볼 수 있습니다. 그러려면 resourcemanager.projects.get
권한이 필요합니다.
Cloud Console을 사용하여 라벨 만들기 및 관리
단일 프로젝트에 라벨을 추가하는 방법은 다음과 같습니다.
- Cloud Console에서 라벨 페이지를 엽니다.
라벨 페이지 열기 - 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.
- 새 라벨 항목을 추가하려면 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
- 라벨 추가를 완료했으면 저장을 클릭합니다.
동시에 둘 이상의 프로젝트에 대해 라벨을 추가하는 방법은 다음과 같습니다.
- Cloud Console에서 리소스 관리 페이지를 엽니다.
리소스 관리 페이지 열기 - 리소스 관리 페이지에서 라벨을 추가할 조직 및 프로젝트를 선택합니다.
- 오른쪽 패널의 라벨 탭에서 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
- 라벨 추가를 완료했으면 저장을 클릭합니다.
라벨을 추가한 후에 프로젝트 목록 위의 필터 상자에 라벨 키 또는 값을 입력하여 프로젝트를 필터링할 수 있습니다. 필터 상자에서는 결과를 미리 볼 수 있도록 키와 값을 제안합니다.
현재 라벨을 지원하는 서비스
현재 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(가변형 환경 및 표준 환경)