Cloud SQL 인스턴스 태그 연결 및 관리

이 페이지에서는 Cloud SQL 인스턴스에서 태그를 연결, 분리, 나열하는 방법을 설명합니다. Cloud SQL의 태그 개요는 Google Cloud 태그를 사용한 액세스 제어를 참조하세요.

시작하기 전에

태그는 Resource Manager를 통해 관리됩니다. Cloud SQL 인스턴스에 연결하기 전에 태그를 만들고 정의하려면 태그 만들기 및 관리를 참조하세요.

필요한 역할

Cloud SQL 인스턴스에서 태그를 보고 관리하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • Cloud SQL 인스턴스 및 태그 바인딩 관리: 프로젝트에 대한 Cloud SQL 관리자 (roles/cloudsql.admin)
  • Cloud SQL 인스턴스에 태그 연결 및 분리: 태그 값 및 프로젝트에 대한 태그 사용자 (roles/resourcemanager.tagUser)
  • Cloud SQL 인스턴스의 태그 보기 및 나열: 프로젝트의 태그 뷰어 (roles/resourcemanager.tagViewer)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 Cloud SQL 인스턴스에서 태그를 보고 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

Cloud SQL 인스턴스에서 태그를 보고 관리하려면 다음 권한이 필요합니다.

  • 태그가 연결된 인스턴스를 만듭니다.
    • cloudsql.instances.create
    • cloudsql.instances.createTagBinding
    • resourcemanager.tagValueBindings.create
  • 인스턴스에 태그 연결:
    • cloudsql.instances.createTagBinding
    • resourcemanager.tagValueBindings.create
  • 인스턴스에서 태그 분리:
    • cloudsql.instances.deleteTagBinding
    • resourcemanager.tagValueBindings.delete
  • 인스턴스의 태그를 나열합니다.
    • cloudsql.instances.listTagBindings
    • cloudsql.instances.listEffectiveTags
    • resourcemanager.tagKeys.get
    • resourcemanager.tagKeys.list
    • resourcemanager.tagValues.get
    • resourcemanager.tagValues.list

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

태그를 사용하여 Cloud SQL 인스턴스 만들기

태그가 연결된 인스턴스를 만들려면 인스턴스를 만들 때 --tags 플래그를 사용합니다. 이렇게 하면 태그가 조직 정책, 커스텀 조직 정책, IAM 조건과 결합되어 인스턴스 생성 정책을 더 세부적으로 맞춤설정할 수 있습니다.

예를 들어 다음 명령어는 값이 5678인 1234 태그 [gcloud sql instances create tags-instance --tags=tagKeys/1234=tagValues/5678]를 사용하여 gcloud CLI에서 인스턴스를 만듭니다.

Cloud SQL 인스턴스에 태그 연결

Resource Manager를 사용하여 태그를 만들고 정의하면 태그를 Cloud SQL 인스턴스에 연결할 수 있습니다. 태그를 Cloud SQL 인스턴스에 연결하려면 gcloud resource-manager tags bindings create 명령어를 실행하여 태그 바인딩을 만듭니다.

gcloud resource-manager tags bindings create \
--tag-value=TAG_VALUE_ID \
--parent=PARENT \
--location=LOCATION

이전 명령어에서 다음을 바꿉니다.

  • TAG_VALUE_ID: 태그 값의 영구 ID 또는 네임스페이스화된 이름입니다. 예를 들면 tagValues/4567890123 또는 12345678/environment/production입니다. 태그 식별자에 대한 자세한 내용은 태그 정의 및 식별자를 참조하세요.

  • PARENT: 태그를 연결할 Cloud SQL 인스턴스의 전체 리소스 이름입니다. 예를 들면 //sqladmin.googleapis.com/projects/my-project/instances/my-instance입니다.

  • LOCATION: Cloud SQL 리소스의 리전 위치입니다. 예를 들면 us-central1입니다.

Cloud SQL 인스턴스에서 태그 분리

gcloud resource-manager tags bindings delete 명령어는 my-instance에서 태그를 분리합니다.

gcloud resource-manager tags bindings delete \
--tag-value=815471563813/environment/development \
--parent=//sqladmin.googleapis.com/projects/my-project/instances/my-instance \
--location=us-central1

Cloud SQL 인스턴스의 태그 나열

gcloud resource-manager tags bindings list 명령어는 my-instance에 직접 연결된 모든 태그(my-instance가 상속된 태그는 제외)를 나열합니다.

gcloud resource-manager tags bindings list \
    --parent=//sqladmin.googleapis.com/projects/my-project/instances/my-instance \
    --location=us-central1

다음 단계