NerdGraph API를 사용하여 경고 알림 채널을 관리할 수 있습니다.
팁
NerdGraph 및 NerdGraph 탐색기를 시작하는 데 도움이 필요하면 NerdGraph 소개 를 참조하세요.
알림 채널 받기
notificationChannels
쿼리를 사용하면 계정당 모든 알림 채널을 통해 페이지를 매길 수 있습니다. 또한 notificationChannel
쿼리를 사용하여 해당 ID로 특정 알림 채널을 가져올 수 있습니다.
팁
특정 비밀 필드(예: 암호 또는 API 키)는 반환된 필드에서 난독화됩니다.
알림 채널 만들기
경고 알림 채널을 생성하려면 생성하려는 특정 유형의 알림 채널(예: 이메일, Slack 등)과 이를 구성하는 데 필요한 세부정보(채널에 따라 다름)를 알아야 합니다. 유형). 알림 채널이 생성되면 하나 이상의 경고 정책 과 연결할 수 있습니다. 연결되면 해당 채널은 조건을 위반할 때 해당 정책의 알림을 받습니다.
주의
기존 알림 채널 유형에 대해 쿼리할 수 있지만 해당 유형의 하위 집합만 생성할 수 있습니다. 특히 사용자 채널 유형에는 편집 가능한 필드가 없으며 Campfire 및 HipChat 채널 유형은 모두 더 이상 사용되지 않습니다.
알림 채널 업데이트
경고 알림 채널을 업데이트하려면 변경하려는 특정 알림 채널 유형(예: 이메일, Slack 등)과 이를 구성하는 데 필요한 세부정보(채널에 따라 다름)를 알아야 합니다. 유형). 다른 GraphQL API와 일관되게 채널의 ID 외에 다른 정보를 몰라도 채널의 단일 필드를 업데이트할 수 있습니다.
주의
기존 알림 채널 유형에 대해 쿼리할 수 있지만 해당 유형의 하위 집합만 업데이트할 수 있습니다. 특히 사용자 채널 유형에는 편집 가능한 필드가 없으며 Campfire 및 HipChat 채널 유형은 모두 더 이상 사용되지 않습니다.
알림 채널 삭제
알림 채널은 계정 아이디와 채널 아이디로만 삭제할 수 있습니다. 채널을 삭제하면 모든 정책에서 연결이 해제되므로 해당 채널에 더 이상 알림이 전송되지 않습니다.
mutation {
alertsNotificationChannelDelete(accountId: YOUR_ACCOUNT_ID,
id: YOUR_CHANNEL_ID) {
id
error {
description
errorType
notificationChannelId
}
}
}
채널을 정책에 연결
경고 알림 채널을 만드는 것만으로는 충분하지 않습니다. 채널을 만든 후에는 하나 이상의 정책 에 연결해야 합니다. 정책에 연결되면 해당 정책의 조건이 위반될 때 채널에서 경고 알림을 받을 수 있습니다.
이 예에서는 두 개의 채널을 정책과 연결합니다.
mutation {
alertsNotificationChannelsAddToPolicy(accountId: YOUR_ACCOUNT_ID,
notificationChannelIds: [FIRST_CHANNEL_ID, SECOND_CHANNEL_ID],
policyId: YOUR_POLICY_ID
) {
notificationChannels {
id
}
policyId
errors {
description
errorType
notificationChannelId
}
}
}
정책에서 채널 분리
알림 채널이 그 유용성보다 오래 지속된 경우(예: 폐기된 이메일 목록), 알림 알림을 보내는 정책 (들)에서 해당 채널을 분리할 때가 되었습니다. 이 API 호출은 채널 자체를 그대로 유지하지만 지정된 정책에서 제거합니다.
이 예에서는 정책에서 2개의 채널을 제거하고(다른 채널은 그대로 둠) 해당 2개의 채널 ID가 제거되었다는 확인을 받습니다.
mutation {
alertsNotificationChannelsRemoveFromPolicy(accountId: YOUR_ACCOUNT_ID,
notificationChannelIds: [FIRST_CHANNEL_ID, SECOND_CHANNEL_ID],
policyId: YOUR_POLICY_ID
) {
notificationChannels {
id
}
policyId
errors {
description
errorType
notificationChannelId
}
}
}
팁
정책에서 경고 알림 채널을 제거해도 다른 정책에서 사용 중일 수 있으므로 채널이 삭제 되지 않습니다 . 반면에 채널을 삭제하면 연결된 모든 정책이 해당 채널에 대한 경고 알림 전송을 중지합니다.