알림 연락처 관리

Cloud Billing과 같은 많은 Google Cloud 서비스에서 Google Cloud 사용자에게 중요한 정보를 전달하기 위해 알림이 전송됩니다. 기본적으로 이러한 알림은 특정 ID 및 액세스 관리(IAM) 역할이 있는 멤버에게 전송됩니다. 필수 연락처를 사용하면 고유한 연락처 목록을 제공하여 알림을 받을 사람을 맞춤설정할 수 있습니다.

시작하기 전에

Essential Contacts API를 사용 설정합니다.

API 사용 설정

필수 권한

필수 연락처를 사용하는 데 필요한 권한은 수행하려는 작업에 따라 달라집니다.

연락처를 볼 수 있는 권한

연락처를 보려면 다음 권한이 포함된 역할이 필요합니다.

  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list

최소 권한 원칙에 따라 이러한 권한을 얻기 위해 관리자에게 필수 연락처 뷰어 역할(roles/essentialContacts.viewer)을 요청합니다.

또는 관리자가 필요한 권한(커스텀 역할 또는 더 많은 권한이 있는 사전 정의된 역할 등)을 포함하는 다른 역할을 부여할 수 있습니다.

연락처가 할당된 프로젝트, 폴더, 조직에 이 역할을 부여합니다.

연락처 관리 권한

연락처를 수정, 삭제, 생성하려면 다음 권한이 포함된 역할이 필요합니다.

  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list
  • essentialcontacts.contacts.create
  • essentialcontacts.contacts.delete
  • essentialcontacts.contacts.update

최소 권한 원칙에 따라 이러한 권한을 얻기 위해 관리자에게 필수 연락처 관리자 역할(roles/essentialContacts.admin)을 요청합니다.

또는 관리자가 필요한 권한(커스텀 역할 또는 더 많은 권한이 있는 사전 정의된 역할 등)을 포함하는 다른 역할을 부여할 수 있습니다.

연락처가 할당된 프로젝트, 폴더, 조직에 이 역할을 부여합니다.

알림 카테고리

연락처를 할당할 수 있는 알림 카테고리는 여러 가지입니다. 카테고리에 대해 연락처를 추가하지 않으면 해당 카테고리의 알림이 멤버의 IAM 역할을 기반으로 선택되는 기본 연락처로 이동합니다. 올바른 사용자에게 프로젝트, 폴더, 조직에 대한 알림이 수신되도록 기본 연락처를 사용하는 대신 커스텀 연락처를 추가하는 것이 좋습니다.

개별 사용자와 Google 그룹을 모두 연락처로 추가할 수 있습니다. 개인별 변경 사항으로 인한 영향을 줄이기 위해서는 Google 그룹을 연락처로 추가하고 해당 그룹의 멤버쉽을 관리해서 알림을 받을 사람을 결정하는 것이 좋습니다. 이렇게 하면 알림이 항상 현재 직원에게 전달됩니다.

다음 표를 검토하여 알림 카테고리, 기본 연락처, 권장 연락처에 대해 알아보세요. 이 정보를 사용하여 각 카테고리에 대해 적합한 연락처를 선택합니다.

카테고리 설명 기본 연락처 권장 연락처
전체 리소스와 관련된 모든 알림 없음 알림 라우팅 또는 로깅을 담당하는 사람 또는 자동화된 시스템
결제 청구 및 결제 알림, 가격 업데이트, 오류, 크레딧 결제 계정 관리자(roles/billing.admin) Google Cloud 사용과 관련된 예산, 계획, 계정을 관리하는 사람을 포함하여 Google과의 재무 관계를 관리하는 재무 부서 직원 및 사용자
법무 시행 조치, 규정 준수, 정부 고지 결제 계정 관리자(roles/billing.admin) 법률 고문, 규정 준수 관리자, 정부 관계 전문가, 기타 관련 전문
제품 업데이트 세 버전, 제품 약관 업데이트, 지원 중단 프로젝트 소유자(roles/owner) Google 제품 및 서비스 변경에 대한 최신 정보를 활용할 수 있는 제품 관리자, 설계자, 엔지니어
보안 보안/개인정보 보호 문제, 알림, 취약점 조직 관리자(roles/resourcemanager.organizationAdmin) 기업 및 고객 데이터 보안과 비즈니스 연속성 보호 책임을 맡고 있는 IT 보안 관리자, 운영 보안 관리자, 기타 사용자
정지 즉각적인 계정 정지와 관련된 알림 프로젝트 소유자(roles/owner) IT 인프라 및 비즈니스 애플리케이션을 작동 및 실행하는 사용자
기술 서비스 중단, 오류, 버그, 기타 기술 문제 프로젝트 소유자(roles/owner) IT 자산의 오작동을 일으킬 수 있는 최신 및 예정된 기술 문제에 대한 지식이 필요한 IT 전문가, 안정성 엔지니어, 관리자, 서비스 대행 전문가, 기타 사용자

지원 언어

필수 연락처에서 각 연락처에는 선호 언어가 설정됩니다. 알림 생성자는 알림을 전송할 때 이 설정을 참조할 수 있습니다.

Cloud Console에서 연락처를 추가할 때 Cloud Console은 연락처 생성자의 선호 언어 설정에 따라 연락처의 선호 언어를 자동으로 구성합니다. API를 사용하여 연락처를 추가할 때 언어 코드를 사용해서 연락처의 선호 언어를 수동으로 구성합니다. 이 언어 코드는 필수 연락처에서 지원되는 모든 언어를 참조할 수 있습니다.

연락처 할당 위치 결정

프로젝트, 폴더, 조직 수준에서 연락처를 할당할 수 있습니다.

연락처는 Google Cloud 리소스 계층 구조를 통해 상속됩니다. 따라서 조직 수준에서 연락처를 추가하면 조직에 대한 알림과 해당 조직에 있는 모든 폴더 및 프로젝트에 대한 알림을 수신합니다. 마찬가지로 폴더 수준에서 연락처를 추가하면 폴더에 대한 알림과 해당 폴더에 있는 모든 폴더와 프로젝트에 대한 알림을 수신합니다.

연락처를 할당할 위치는 조직 구조에 따라 달라집니다. 하지만 일반적으로 알림 카테고리에 따라 다음 수준에서 연락처를 할당하는 것이 좋습니다.

권장 수준 알림 카테고리
조직 수준
  • 결제
  • 법무
  • 보안1
폴더/프로젝트 수준
  • 전체
  • 제품 업데이트
  • 보안1
  • 정지
  • 기술

1 보안 연락처를 할당할 수준은 조직의 특정 보안 방침에 따라 달라집니다. 예를 들어 개별 프로젝트 소유자가 자신의 프로젝트에 대해 보안 책임을 수행할 경우, 프로젝트 수준에서 보안 연락처를 할당합니다. 하지만 조직 전체 그룹이 모든 프로젝트의 보안을 관리할 경우, 조직 수준에서 보안 연락처를 할당합니다.

연락처 나열

프로젝트, 폴더, 조직의 모든 연락처를 나열하려면 다음을 수행합니다.

Console

  1. Cloud Console에서 필수 연락처 페이지로 이동합니다.

    필수 연락처 페이지로 이동

  2. 프로젝트, 폴더, 조직의 이름이 페이지 상단에 있는 프로젝트 선택기에 표시되는지 확인합니다. 프로젝트 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

  3. 카테고리별로 연락처를 나열하려면 카테고리를 선택합니다. 연락처를 알파벳 순으로 나열하려면 연락처를 선택합니다.

REST

연락처 나열

특정 프로젝트, 폴더, 조직에 설정된 연락처를 보려면 Essential Contacts API의 contacts.list 메서드를 사용합니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 연락처를 나열할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
  • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다.
  • PAGE_SIZE: 선택사항. 응답에 포함할 연락처 수입니다. 기본값은 50이고 최댓값은 100입니다. 연락처 수가 페이지 크기보다 크면 응답에 다음 결과 페이지를 검색하는 데 사용할 수 있는 페이지 나누기 토큰이 포함됩니다.
  • NEXT_PAGE_TOKEN: 선택사항. 이 메서드의 이전 응답에서 반환된 페이지 나누기 토큰입니다. 지정된 경우, 이전 응답이 종료된 지점에서 연락처 목록이 시작합니다.

요청:

GET essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-contact-1@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-contact-2@my-domain.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

연락처 및 상속된 연락처 나열

하위 리소스(폴더 및 프로젝트)는 해당 상위 항목(조직 및 기타 폴더)에서 연락처를 상속합니다. 모든 연락처 및 리소스에 대해 상속된 연락처를 나열하려면 Essential Contacts API의 contacts.compute 메서드를 사용합니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 연락처를 계산할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
  • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다.
  • NOTIFICATION_CATEGORY: 연락처를 계산할 알림의 카테고리입니다. 이 필드를 반복하여 여러 알림 카테고리의 연락처를 나열할 수 있습니다. NOTIFICATION_CATEGORYALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, NOTIFICATION_CATEGORY_UNSPECIFIED 값 중 하나일 수 있습니다. ALL 값을 선택하면 모든 카테고리에 대한 연락처가 나열됩니다.
  • PAGE_SIZE: 선택사항. 응답에 포함할 연락처 수입니다. 기본값은 50이고 최댓값은 100입니다. 연락처 수가 페이지 크기보다 크면 응답에 다음 결과 페이지를 검색하는 데 사용할 수 있는 페이지 나누기 토큰이 포함됩니다.
  • NEXT_PAGE_TOKEN: 선택사항. 이 메서드의 이전 응답에서 반환된 페이지 나누기 토큰입니다. 지정된 경우, 이전 응답이 종료된 지점에서 연락처 목록이 시작합니다.

요청:

GET essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

응답에 모든 연락처 및 리소스에 대해 상속된 연락처가 나열됩니다.

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-project-contact-1@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-project-contact-2@my-domain.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "my-organization-contact@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

개별 연락처 관리

Cloud Console의 필수 연락처 페이지에서 또는 REST API를 사용하여 개별 연락처를 관리할 수 있습니다.

연락처 추가

연락처를 추가하려면 다음을 수행합니다.

Console

  1. Cloud Console에서 필수 연락처 페이지로 이동합니다.

    필수 연락처 페이지로 이동

  2. 프로젝트, 폴더, 조직의 이름이 페이지 상단에 있는 프로젝트 선택기에 표시되는지 확인합니다. 프로젝트 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

  3. 연락처 추가를 클릭합니다.

  4. 이메일이메일 확인 필드에 연락처의 이메일 주소를 입력합니다.

  5. 알림 카테고리 드롭다운 메뉴에서 연락처에 알림을 제공하려는 알림 카테고리를 선택합니다. 알림 카테고리 및 권장 연락처 목록을 보려면 이 페이지에서 연락처 식별을 참조하세요.

  6. 저장을 클릭합니다.

REST

새 연락처를 추가하려면 Essential Contacts API의 contacts.create 메서드를 사용합니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 연락처를 나열할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
  • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다.
  • EMAIL: 연락처의 이메일 주소입니다. 연락처를 만든 후에는 이 필드를 변경할 수 없습니다.
  • NOTIFICATION_CATEGORY_1NOTIFICATION_CATEGORY_2: 연락처에 알림을 제공하려는 알림 카테고리입니다. 이 값은 ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL 중 하나일 수 있습니다.

    각 카테고리의 권장 연락처 목록은 이 페이지에서 연락처 식별을 참조하세요.

  • LANGUAGE: 연락처의 기본 알림 언어에 대한 언어 코드입니다. 모든 지원되는 언어에 대한 언어 코드를 포함할 수 있습니다.

요청:

POST essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts

요청 본문:

{
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/my-project/contacts/3",
  "email": "my-new-contact@my-domain.com",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

연락처 변경

연락처를 할당할 카테고리를 변경하려면 다음을 수행합니다.

Console

  1. Cloud Console에서 필수 연락처 페이지로 이동합니다.

    필수 연락처 페이지로 이동

  2. 프로젝트, 폴더, 조직의 이름이 페이지 상단에 있는 프로젝트 선택기에 표시되는지 확인합니다. 프로젝트 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

  3. 보기 기준 옆에서 연락처를 선택합니다.

  4. 카테고리를 변경하려는 연락처 옆에서 를 클릭합니다.

  5. 알림 카테고리 드롭다운 메뉴에서 원하는 알림 카테고리를 선택하고 저장을 클릭합니다.

REST

기존 연락처의 알림 구독 또는 기본 언어를 변경하려면 Essential Contacts API의 contacts.patch 메서드를 사용합니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 연락처를 나열할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
  • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다.
  • CONTACT_ID: 연락처의 숫자 ID입니다. 프로젝트, 폴더, 조직에 있는 모든 연락처의 ID를 보려면 연락처 목록을 표시합니다.
  • UPDATE_MASK: 선택사항. 변경한 연락처 필드를 설명하는 마스크입니다. 마스크 형식은 쉼표로 구분된 정규화된 필드 이름 목록입니다(예: notificationCategorySubscriptions,languageTag).
  • EMAIL: 연락처의 이메일 주소입니다. 이 필드는 요청에 포함하는 CONTACT_ID와 연결된 이메일 주소와 일치해야 합니다.
  • NOTIFICATION_CATEGORY_1NOTIFICATION_CATEGORY_2: 선택사항. 연락처에 알림을 제공하려는 업데이트된 알림 카테고리입니다. 이 값은 ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL 중 하나일 수 있습니다.

    각 카테고리의 권장 연락처 목록은 이 페이지에서 연락처 식별을 참조하세요.

  • LANGUAGE: 연락처의 기본 알림 언어에 대한 언어 코드입니다. 모든 지원되는 언어에 대한 언어 코드를 포함할 수 있습니다.

요청:

PATCH essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

요청 본문:

{
  "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID",
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/my-project/contacts/2",
  "email": "my-new-contact@my-domain.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

연락처 삭제

연락처를 삭제하려면 다음을 수행합니다.

Console

  1. Cloud Console에서 필수 연락처 페이지로 이동합니다.

    필수 연락처 페이지로 이동

  2. 프로젝트, 폴더, 조직의 이름이 페이지 상단에 있는 프로젝트 선택기에 표시되는지 확인합니다. 프로젝트 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

  3. 보기 기준 옆에서 연락처를 선택합니다.

  4. 삭제하려는 연락처의 이메일 주소 옆에서 를 클릭합니다. 대화상자에서 연락처를 삭제할지 확인합니다.

REST

연락처를 삭제하려면 Essential Contacts API의 contacts.delete 메서드를 사용합니다.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 연락처를 나열할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
  • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다.
  • CONTACT_ID: 연락처의 숫자 ID입니다. 프로젝트, 폴더, 조직에 있는 모든 연락처의 ID를 보려면 연락처 목록을 표시합니다.

요청:

DELETE essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

요청이 성공하면 응답 본문이 비어 있습니다.

카테고리별 연락처 관리

Cloud Console에서 필수 연락처 페이지의 카테고리 탭으로 이동하여 카테고리별로 연락처를 관리할 수도 있습니다.

단일 카테고리에 할당된 연락처를 추가, 변경, 삭제하려면 다음을 수행합니다.

  1. Cloud Console에서 필수 연락처 페이지로 이동합니다.

    필수 연락처 페이지로 이동

  2. 프로젝트, 폴더, 조직의 이름이 페이지 상단에 있는 프로젝트 선택기에 표시되는지 확인합니다. 프로젝트 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

  3. 보기 기준 옆에 있는 카테고리를 선택합니다.

  4. 관리하려는 연락처의 카테고리와 동일한 행에서 를 클릭합니다.

  5. 카테고리에 할당된 연락처를 관리합니다.

    • 새 연락처를 추가하려면 연락처 추가를 클릭한 다음 이 페이지에 설명된 연락처 추가 단계를 따릅니다.
    • 연락처가 할당된 카테고리를 변경하려면 변경하려는 카테고리의 연락처 옆에서 를 클릭합니다. 그런 후 알림 카테고리 드롭다운 메뉴에서 원하는 알림 카테고리를 선택하고 저장을 클릭합니다.

    • 연락처를 삭제하려면 연락처의 이메일 주소 옆에 있는 를 클릭합니다.

다음 단계