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

이 문서에서는 Resource Manager API 및 Google Cloud 콘솔을 사용하여 프로젝트용 라벨을 만들고 업데이트하는 방법을 자세히 설명합니다. 라벨을 사용하여 비용을 파악하는 방법과 라벨을 지원하는 서비스에 대한 세부정보를 제공합니다.

프로젝트용 라벨 만들기

콘솔

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

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

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

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

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

리소스 관리 페이지 열기
리소스 관리 페이지에서 라벨을 추가할 프로젝트를 선택합니다.
정보 패널의 라벨 탭에서 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
라벨 추가를 완료했으면 저장을 클릭합니다.

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

REST

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

요청:

POST https://cloudresourcemanager.googleapis.com/v3/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",
}

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

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

라벨을 추가하면 라벨을 기준으로 프로젝트를 필터링할 수 있습니다. 라벨을 사용하여 프로젝트를 필터링하는 방법에 대한 자세한 내용은 프로젝트 나열을 참조하세요.

프로젝트용 라벨 업데이트

콘솔

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

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

라벨 페이지 열기
프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.
프로젝트 라벨을 업데이트합니다.
1. 라벨을 수정하려면 수정하려는 값을 클릭한 후 원하는 대로 변경합니다.
2. 라벨을 삭제하려면 마우스 포인터를 키나 값에 올려놓은 후 를 클릭합니다.
라벨 업데이트를 완료했으면 저장을 클릭합니다.

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

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

리소스 관리 페이지 열기
리소스 관리 페이지에서 라벨을 업데이트할 프로젝트를 선택합니다.
정보 패널에서 라벨 탭을 클릭하고 선택한 프로젝트의 라벨을 업데이트합니다.
1. 라벨을 수정하려면 수정하려는 값을 클릭한 후 원하는 대로 변경합니다.
2. 라벨을 삭제하려면 마우스 포인터를 키나 값에 올려놓은 후 를 클릭합니다.
라벨 업데이트를 완료했으면 저장을 클릭합니다.

REST

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

projects.get() 메서드를 사용하여 project 객체를 가져옵니다.
업데이트할 라벨을 수정합니다.
projects.patch 메서드를 호출합니다.

다음 예시에서는 color:blue 라벨을 업데이트합니다.

다음 코드 스니펫은 color 라벨 값을 blue에서 red로 변경합니다.

요청:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

여기서 PROJECT_NAME은 업데이트하려는 프로젝트의 이름입니다.

JSON 요청 본문:

{
    "labels":
      {
        "color": "red"
      }
}

응답:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}