알림 연락처 관리

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

중요: 알림 전송을 위해 모든 Google Cloud 서비스에서 필수 연락처가 사용되지는 않습니다. 따라서 사용자가 구성한 커스텀 연락처로 일부 Google Cloud 알림이 전달되지 않을 수 있습니다.

시작하기 전에

Enable the Essential Contacts API.

Enable the API

참고: Google Cloud console을 통해 연락처만 관리하려는 경우 API를 사용 설정할 필요가 없습니다.

필요한 역할

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

• 연락처를 보려는 경우: 필수 연락처 뷰어(roles/essentialcontacts.viewer)
• 연락처를 보고, 수정하고, 삭제하고, 만들려는 경우: 필수 연락처 관리자(roles/essentialcontacts.admin)

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

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

필수 권한

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

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

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

알림 카테고리

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

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

참고: 알림을 받으려면 연락처가 Google에서 이메일을 받을 수 있어야 합니다.

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

카테고리	설명	예	대체 연락처	권장 연락처
전체	다른 모든 카테고리의 모든 알림	해당 사항 없음	해당 사항 없음	잠재적으로 많은 알림을 라우팅하거나 로깅을 담당하는 사람 또는 자동화된 시스템
결제	청구 및 결제 알림	가격 업데이트, 오류, 크레딧	결제 계정 관리자(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 전문가, 안정성 엔지니어, 관리자, 서비스 대행 전문가, 기타 사용자

지원 언어

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

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

지원 언어

언어	언어 코드
아프리칸스어	af
알바니아어	sq
암하라어	오전
아랍어	ar
아랍어(이집트)	ar-EG
아르메니아어	hy
아제르바이잔어	az
바스크어	eu
벨라루스어	be
뱅골어	bn
보스니아어	bs
불가리아어	bg
버마어	my
카탈로니아어	ca
중국어	zh
중국어(홍콩)	zh-HK
중국어(타이완)	zh-TW
크로아티아어	시간
체코어	cs
덴마크어	da
네덜란드어	nl
영어	en
영어(호주)	en-AU
영어(영국)	en-GB
영어(미국)	en-US
에스토니아어	et
필리핀어	fil
핀란드어	fi
프랑스어	fr
프랑스어(캐나다)	fr-CA
갈리시아어	gl
독일어	de
조지아어	ka
그리스어	el
구자라트어	gu
히브리어	iw
힌디어	hi
헝가리어	hu
아이슬란드어	is
인도네시아어	id
아일랜드어	ga
이탈리아어	it
일본어	ja
자바어	jv
칸나다어	kn
카자흐어	kk
크메르어	km
한국어	ko
키르기스어	ky
라오어	lo
라트비아어	lv
리투아니아어	lt
마케도니아어	mk
말레이어	ms
말라얄람어	ml
마라타어	mr
몽골어	mn
네팔어	ne
노르웨이어	no
Pashto	ps
페르시아어	fa
폴란드어	pl
포르투갈어	pt
포르투갈어(브라질)	pt-BR
포르투갈어(포르투갈)	pt-PT
펀자브어	pa
루마니아어	ro
러시아어	ru
세르비아어	sr
신드어	sd
신할라어	si
슬로바키아어	sk
슬로베니아어	sl
소말리어	so
스페인어	es
스페인어(남미)	es-419
스와힐리어	sw
스웨덴어	sv
타밀어	ta
텔루구어	te
태국어	th
터키어	tr
투르크멘어	tk
우크라이나어	uk
우르두어	ur
우즈베크어	uz
베트남어	vi
웨일즈어	cy
줄루어	zu

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

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

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

참고: 상위 항목의 연락처를 볼 수 있으면 리소스의 상위 항목에서 상속된 연락처만 볼 수 있습니다. 이 기능을 사용하려면 필수 연락처 뷰어 역할(roles/essentialcontacts.viewer)과 같이 필수 권한이 포함된 상위 항목에 대해 역할이 필요합니다.

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

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

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

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

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

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

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

연락처 나열

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

콘솔

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

   필수 연락처 페이지로 이동

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

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

   참고: 상위 항목(조직 또는 기타 폴더)에서 연락처를 상속 받는 하위 리소스(폴더 또는 프로젝트)에 대해 연락처를 보고 있는 경우, 연락처 보기 권한이 있는 모든 상위 항목에 대해 상속된 연락처가 표시됩니다.
   참고: 조직 또는 폴더에 대한 연락처를 볼 때는 하위 리소스에 대한 연락처가 표시되지 않습니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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: [e-mail]
   languageTag: en-US
   name: projects/my-projects/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   email: [e-mail]
   languageTag: en-US
   name: projects/my-projects/contacts/2
   notificationCategorySubscriptions:
   - BILLING
   ---
   

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

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

   참고: 상위 항목의 연락처를 볼 수 있으면 리소스의 상위 항목에서 상속된 연락처만 볼 수 있습니다. 이 기능을 사용하려면 필수 연락처 뷰어 역할(roles/essentialcontacts.viewer)과 같이 필수 권한이 포함된 상위 항목에 대해 역할이 필요합니다.

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

   다음 값을 바꿉니다.

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

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

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

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

   ---
   email: [e-mail]
   languageTag: en-US
   name: projects/my-projects/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   email: [e-mail]
   languageTag: en-US
   name: projects/my-projects/contacts/2
   notificationCategorySubscriptions:
   - BILLING
   ---
   email: [e-mail]
   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)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

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

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)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

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

$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": "[e-mail]",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "[e-mail]",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

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

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

참고: 상위 항목의 연락처를 볼 수 있으면 리소스의 상위 항목에서 상속된 연락처만 볼 수 있습니다. 이 기능을 사용하려면 필수 연락처 뷰어 역할(roles/essentialcontacts.viewer)과 같이 필수 권한이 포함된 상위 항목에 대해 역할이 필요합니다.

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

• RESOURCE_TYPE: 연락처를 계산할 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
• RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
• NOTIFICATION_CATEGORY: 연락처를 계산할 알림의 카테고리입니다. 이 필드를 반복하여 여러 알림 카테고리의 연락처를 나열할 수 있습니다. NOTIFICATION_CATEGORY는 ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, NOTIFICATION_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)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

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

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)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

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

$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": "[e-mail]",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "[e-mail]",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "[e-mail]",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

개별 필수 연락처 관리

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

참고: 알림을 받으려면 연락처가 Google에서 이메일을 받을 수 있어야 합니다.

연락처 추가

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

콘솔

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

   필수 연락처 페이지로 이동

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

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

   

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

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

6. 저장을 클릭합니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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_1 및 NOTIFICATION_CATEGORY_2: 연락처에 알림을 제공하려는 알림 카테고리입니다. 이 값은 ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL 중 하나일 수 있습니다.

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

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

요청:

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

요청 본문:

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

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

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts
  

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts" | Select-Object -Expand Content
  

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

{
  "name": "projects/my-project/contacts/3",
  "email": "[e-mail]",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

연락처 변경

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

참고: 연락처의 이메일 주소는 변경할 수 없습니다. 이메일 주소를 변경하려면 업데이트된 이메일 주소로 새 연락처를 추가하고 이전 연락처를 삭제합니다.

콘솔

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

   필수 연락처 페이지로 이동

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

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

   

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

   

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

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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_1 및 NOTIFICATION_CATEGORY_2: 선택사항. 연락처에 알림을 제공하려는 업데이트된 알림 카테고리입니다. 이 값은 ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL 중 하나일 수 있습니다.

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

• 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"
}

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

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"
  

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

Invoke-WebRequest `
  -Method PATCH `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"" | Select-Object -Expand Content
  

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

{
  "name": "projects/my-project/contacts/2",
  "email": "[e-mail]",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

연락처 삭제

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

콘솔

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

   필수 연락처 페이지로 이동

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

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

   

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

   

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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

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

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

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

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID
  

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 경로로 설정해야 합니다.

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

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

Invoke-WebRequest `
  -Method DELETE `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID" | Select-Object -Expand Content
  

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

카테고리별 연락처 관리

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

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

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

   필수 연락처 페이지로 이동

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

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

   

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

   

   

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

   • 새 연락처를 추가하려면 연락처 추가를 클릭한 다음 이 페이지에 설명된 연락처 추가 단계를 따릅니다.

   • 연락처가 할당된 카테고리를 변경하려면 변경하려는 카테고리의 연락처 옆에서 를 클릭합니다. 그런 후 알림 카테고리 드롭다운 메뉴에서 원하는 알림 카테고리를 선택하고 저장을 클릭합니다.

     참고: 연락처의 이메일 주소는 변경할 수 없습니다. 이메일 주소를 변경하려면 업데이트된 이메일 주소로 새 연락처를 추가하고 이전 연락처를 삭제합니다.

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

이메일 전송 확인

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

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

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

   필수 연락처 페이지로 이동

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

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

   

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

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

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

   참고: 24시간마다 최대 1개의 테스트 이메일을 카테고리 및 리소스별로 각 연락처에 보낼 수 있습니다.

7. 각 연락처에 연락하여 [e-mail]에서 테스트 이메일을 받았는지 확인합니다.

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 값 중 하나가 포함될 수 있습니다.

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

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

참고: 알림을 받으려면 연락처가 Google에서 이메일을 받을 수 있어야 합니다.

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

다음 단계

• 확인 목적으로 도메인을 프로젝트에 연결하는 방법 알아보기
• 알림 환경설정 관리 방법 알아보기