알림 연락처 관리

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

시작하기 전에

Essential Contacts API 사용 설정

API 사용 설정

필요한 역할

연락처를 관리하는 데 필요한 권한을 얻으려면 연락처가 할당된 프로젝트, 폴더, 조직에 대한 다음 IAM 역할을 부여해 달라고 관리자에게 요청합니다.

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 연락처를 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

연락처를 관리하려면 다음 권한이 필요합니다.

  • 연락처를 보려면 다음 권한이 필요합니다.
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • 연락처를 수정, 삭제, 생성하려면 다음 권한이 필요합니다.
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontcts.contacts.update

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

알림 카테고리

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

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

다음 표를 검토하여 알림 카테고리, 대체 연락처, 권장 연락처에 대해 알아보세요. 지정된 카테고리에 연락처를 지정하지 않으면 알림이 대체 연락처로 전송됩니다.

카테고리 설명 대체 연락처 권장 연락처
전체 다른 모든 카테고리의 모든 알림 N/A N/A 잠재적으로 많은 알림을 라우팅하거나 로깅을 담당하는 사람 또는 자동화된 시스템
결제 청구 및 결제 알림 가격 업데이트, 오류, 크레딧 결제 계정 관리자(roles/billing.admin) Google Cloud 사용과 관련된 예산, 계획, 계정을 관리하는 사람을 포함하여 Google과의 재무 관계를 관리하는 재무 부서 직원 및 사용자
법무 법적 규정 준수 알림 시행 조치, 규정 준수, 정부 고지 결제 계정 관리자(roles/billing.admin) 법률 고문, 규정 준수 관리자, 정부 관계 전문가, 기타 관련 전문
제품 업데이트 Google 제품 변경사항 새 버전, 제품 약관 업데이트, 지원 중단 프로젝트 소유자(roles/owner) Google 제품 및 서비스 변경에 대한 최신 정보를 활용할 수 있는 제품 관리자, 설계자, 엔지니어
보안 보안/개인 정보 보호 문제 알림 취약점, 데이터 이슈, 공격 조직 관리자(roles/resourcemanager.organizationAdmin) 기업 및 고객 데이터 보안과 비즈니스 연속성 보호 책임을 맡고 있는 IT 보안 관리자, 운영 보안 관리자, 기타 사용자
정지 즉각적인 계정 및 프로젝트 정지와 관련된 알림 Apigee 평가 규정 준수, 저작권 침해, 암호화폐 채굴 프로젝트 소유자(roles/owner) IT 인프라 및 비즈니스 애플리케이션을 작동 및 실행하는 사용자
기술 기술 이벤트 및 기타 운영 문제 로깅 구성 오류, 데이터 손실 방지 업데이트, Actions on Google 상태 프로젝트 소유자(roles/owner) IT 애셋 관리와 서비스 중단 방지를 위해 현재 및 예정된 기술 이벤트와 문제에 대한 지식이 필요한 IT 전문가, 안정성 엔지니어, 관리자, 서비스 대행 전문가, 기타 사용자
기술 이슈 프리미엄 지원 고객의 경우 서비스 중단 알림 대상인 기술 카테고리의 하위 카테고리 계획에 없던 서비스 중단, 서비스 문제 N/A 서비스 중단에 대응해야 하는 IT 전문가, 안정성 엔지니어, 관리자, 서비스 대행 전문가, 기타 사용자

지원 언어

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

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

연락처 할당을 위한 권장사항

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

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

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

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

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

2 기술 카테고리 연락처는 많은 이메일 알림을 수신합니다. 이러한 연락처를 폴더 또는 프로젝트 수준에서 할당하여 수신 알림 흐름을 처리하도록 합니다.

서비스 중단 및 알림 중단을 위한 연락처 할당

프리미엄 지원 고객인 경우 기술 이슈 하위 카테고리를 통해 서비스 중단 및 서비스 문제 알림을 수신할 연락처를 할당할 수 있습니다. 이를 통해 다른 기술 알림으로 인한 방해 없이 서비스 중단에 집중해야 할 담당자에게 심각한 서비스 중단 알림을 전달할 수 있습니다.

알림이 적절한 연락처로 전송되도록 기술 이슈 하위 카테고리에 연락처를 할당할 때 다음 상속 동작을 고려합니다.

  • 프로젝트 또는 폴더에 기술 이슈 연락처를 할당하면 서비스 중단 알림이 다음 연락처로만 전송됩니다.

    • 프로젝트 또는 폴더 기술 이슈 연락처
    • 상위 조직 또는 폴더에서 상속된 기술 이슈 연락처
  • 프로젝트 또는 폴더에 기술 이슈 연락처를 할당하지 않으면 서비스 중단 알림이 다음 연락처로만 전송됩니다.

    • 프로젝트 또는 폴더 기술 연락처
    • 상위 조직 또는 폴더에서 상속된 기술 이슈 연락처
  • 기술 이슈 연락처가 할당되거나 상속되지 않고 기술 연락처가 할당되지 않으면 서비스 중단 알림이 전송되지 않습니다.

연락처의 허용된 도메인 제한

새 연락처에 있는 이메일 주소 도메인을 제한하려면 조직 정책 제약조건 constraints/essentialcontacts.allowedContactDomains를 설정합니다. 기존 연락처는 이 제약조건의 영향을 받지 않습니다.

조직 정책 제약조건을 설정하는 방법은 조직 정책 제약조건을 참조하세요.

연락처 나열

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

콘솔

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

    필수 연락처 페이지로 이동

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

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

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. Google Cloud CLI를 사용하면 리소스에 정의된 연락처를 나열하거나 리소스의 모든 연락처 및 상속된 연락처를 나열할 수 있습니다.

    리소스에 정의된 연락처 나열

    특정 프로젝트, 폴더, 조직에 정의된 연락처를 보려면 gcloud essential-contacts list 명령어를 사용합니다.

    gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"
    

    다음 값을 바꿉니다.

    • RESOURCE_TYPE: 연락처를 나열할 리소스 유형입니다. project, folder, organization 값을 사용합니다.
    • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

    또는 리소스 유형이나 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트의 연락처를 나열합니다.

    응답은 다음 예시와 유사합니다.

    ---
    email: my-contact-1@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/1
    notificationCategorySubscriptions:
    - ALL
    ---
    email: my-contact-2@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/2
    notificationCategorySubscriptions:
    - BILLING
    ---
    

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

    하위 리소스(폴더 및 프로젝트)는 해당 상위 항목(조직 및 기타 폴더)에서 연락처를 상속합니다. 리소스의 모든 연락처 및 상속된 연락처를 나열하려면 gcloud essential-contacts compute 명령어를 사용합니다.

    gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \
      --RESOURCE_TYPE="RESOURCE_ID"
    

    다음 값을 바꿉니다.

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

    • NOTIFICATION_CATEGORIES: 연락처를 계산할 알림의 카테고리를 쉼표로 구분한 목록입니다. 목록에는 all, billing, legal, product-updates, security, suspension, technical, technical-incidentsnotification-category-unspecified 값 중 하나가 포함될 수 있습니다. all 값을 선택하면 모든 카테고리에 대한 연락처가 나열됩니다.
    • RESOURCE_TYPE: 연락처를 계산할 리소스 유형입니다. project, folder, organization 값을 사용합니다.
    • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

    리소스 유형 및 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트의 연락처를 나열합니다.

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

    ---
    email: my-contact-1@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/1
    notificationCategorySubscriptions:
    - ALL
    ---
    email: my-contact-2@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/2
    notificationCategorySubscriptions:
    - BILLING
    ---
    email: my-organization-contact@example.com
    languageTag: en-US
    name: organizations/my-organization/contacts/1
    notificationCategorySubscriptions:
    - ALL
    ---
    

REST

Essential Contacts REST API를 사용하면 리소스에 정의된 연락처를 나열하거나 리소스의 모든 연락처 및 상속된 연락처를 나열할 수 있습니다.

리소스에 정의된 연락처 나열

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

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

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

요청:

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

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

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
  

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
  

요청을 보내면 다음과 비슷한 JSON 응답이 표시됩니다.

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

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

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

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

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

요청:

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

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

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORIES&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

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

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

개별 필수 연락처 관리

Google Cloud console의 필수 연락처 페이지 또는 REST API를 사용하여 연락처를 추가, 삭제하거나 연락처에 알림 카테고리를 할당할 수 있습니다.

연락처 추가

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

콘솔

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

    필수 연락처 페이지로 이동

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

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

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

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

  6. 저장을 클릭합니다.

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. 새 연락처를 추가하려면 gcloud essential-contacts create 명령어를 사용합니다.

    gcloud essential-contacts create --email="EMAIL" \
        --notification-categories="NOTIFICATION_CATEGORIES" \
        --language="LANGUAGE" \
        --RESOURCE_TYPE="RESOURCE_ID"

    다음 값을 바꿉니다.

    • EMAIL: 연락처의 이메일 주소입니다. 연락처를 만든 후에는 이 필드를 변경할 수 없습니다.
    • NOTIFICATION_CATEGORIES: 연락처에 커뮤니케이션을 제공하려는 알림 카테고리의 쉼표로 구분된 목록입니다. 목록에는 all, billing, legal, product-updates, security, suspension, technical, technical-incidents, notification-category-unspecified 값이 포함될 수 있습니다. all 값을 선택하면 모든 카테고리에 대한 연락처가 나열됩니다.

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

    • LANGUAGE: 연락처의 기본 알림 언어에 대한 언어 코드입니다. 모든 지원되는 언어에 대한 언어 코드를 포함할 수 있습니다.
    • RESOURCE_TYPE: 연락처를 만들려는 리소스 유형입니다. project, folder 또는 organization 값을 사용합니다.
    • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

    리소스 유형과 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트에 연락처를 만듭니다.

    명령어가 성공하면 응답이 반환되지 않습니다.

REST

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

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

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

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

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

요청:

POST essentialcontacts.googleapis.com/v1/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@example.com",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

연락처 변경

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

콘솔

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

    필수 연락처 페이지로 이동

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

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

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

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

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. 기존 연락처를 업데이트하려면 gcloud essential-contacts update 명령어를 사용합니다.

    gcloud essential-contacts update CONTACT_ID \
        --notification-categories="NOTIFICATION_CATEGORIES" \
        --language="LANGUAGE"
        --RESOURCE_TYPE="RESOURCE_ID"

    다음 값을 바꿉니다.

    • CONTACT_ID: 업데이트하려는 연락처의 숫자 ID입니다. 프로젝트, 폴더, 조직에 있는 모든 연락처의 ID를 보려면 연락처 목록을 표시합니다. 숫자 ID는 연락처 이름에서 contacts 다음에 오는 모든 문자입니다.
    • NOTIFICATION_CATEGORIES: 연락처가 새로 커뮤니케이션을 수신할 알림 카테고리를 쉼표로 구분한 목록입니다. 이 목록은 기존 알림 카테고리 목록을 대체합니다.

      목록에는 all, billing, legal, product-updates, security, suspension, technical, technical-incidents, notification-category-unspecified 값이 포함될 수 있습니다. all 값을 선택하면 모든 카테고리에 대한 연락처가 나열됩니다.

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

    • LANGUAGE: 연락처의 기본 알림 언어에 대한 언어 코드입니다. 모든 지원되는 언어에 대한 언어 코드를 포함할 수 있습니다.
    • RESOURCE_TYPE: 연락처가 정의된 리소스 유형입니다. project, folder, organization 값을 사용합니다.
    • RESOURCE_ID: 연락처가 정의된 Google Cloud 프로젝트, 조직, 또는 폴더의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

    리소스 유형과 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트에서 지정된 ID가 있는 연락처를 업데이트합니다. 지정된 ID가 있는 연락처가 없으면 gcloud CLI가 오류를 반환합니다.

    명령어가 성공하면 응답이 반환되지 않습니다.

REST

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

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

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

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

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

요청:

PATCH essentialcontacts.googleapis.com/v1/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@example.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

연락처 삭제

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

콘솔

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

    필수 연락처 페이지로 이동

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

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

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

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. 기존 연락처를 삭제하려면 gcloud essential-contacts delete 명령어를 사용합니다.

    gcloud essential-contacts delete CONTACT_ID \
        --RESOURCE_TYPE="RESOURCE_ID"

    다음 값을 바꿉니다.

    • CONTACT_ID: 삭제하려는 연락처의 숫자 ID입니다. 프로젝트, 폴더, 조직에 있는 모든 연락처의 ID를 보려면 연락처 목록을 표시합니다. 숫자 ID는 연락처 이름에서 contacts 다음에 오는 모든 문자입니다.
    • RESOURCE_TYPE: 연락처가 정의된 리소스 유형입니다. project, folder, organization 값을 사용합니다.
    • RESOURCE_ID: 연락처가 정의된 Google Cloud 프로젝트, 조직, 또는 폴더의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

    리소스 유형 및 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트에서 지정된 ID가 있는 연락처를 삭제합니다. 지정된 ID가 있는 연락처가 없으면 gcloud CLI가 오류를 반환합니다.

    명령어가 성공하면 응답이 반환되지 않습니다.

REST

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

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

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

요청:

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

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

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

카테고리별 연락처 관리

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

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

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

    필수 연락처 페이지로 이동

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

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

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

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

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

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

이메일 전송 확인

각 카테고리의 연락처에 테스트 이메일을 보내면 이메일 계정이 Google Cloud에서 이메일을 받을 수 있는지 확인할 수 있습니다.

특정 카테고리의 연락처에 테스트 이메일을 보내려면 다음 안내를 따르세요.

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

    필수 연락처 페이지로 이동

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

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

  4. 테스트 이메일을 전송할 연락처의 카테고리와 동일한 행에서 을 클릭합니다.

  5. 이메일을 보낼 연락처 옆의 체크박스를 선택합니다.

  6. 보내기를 클릭합니다. 선택한 연락처로 테스트 이메일이 전송됩니다.

  7. 각 연락처에 연락하여 GCP-gcp-contacts-noreply@google.com에서 테스트 이메일을 받았는지 확인합니다.

Terraform을 사용한 연락처 관리

Terraform을 사용하여 알림 연락처를 관리할 수 있습니다. 연락처의 형식은 다음과 같습니다(Terraform 언어).

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = NOTIFICATION_CATEGORIES
}

연락처를 만들 때 다음 값을 바꿉니다.

  • RESOURCE_TYPE: 연락처를 나열할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
  • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • EMAIL: 연락처의 이메일 주소입니다. 연락처를 만든 후에는 이 필드를 변경할 수 없습니다.
  • LANGUAGE: 선택사항. 연락처의 기본 알림 언어에 대한 언어 코드입니다. 모든 지원되는 언어에 대한 언어 코드를 포함할 수 있습니다.
  • NOTIFICATION_CATEGORIES: 연락처에서 알림을 받을 알림 카테고리의 배열입니다. 예를 들면 ["BILLING", "LEGAL"]입니다.

    이 배열에는 ALL, BILLING, LEGAL ,PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL ,TECHNICAL_INCIDENTS 값 중 하나가 포함될 수 있습니다.

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

연락처를 추가, 수정, 삭제하려면 Terraform 구성 파일에서 연락처 리소스를 추가, 수정 또는 삭제합니다.

자세한 내용은 Terraform 필수 연락처 문서를 참조하세요.

다음 단계