{{ {{site.data.keyword.en_short}}.keyword.en_short}} CLI
IBM Cloud 의 명령줄 인터페이스(CLI)는 서비스 제공을 위한 추가 기능을 제공합니다. IBM Cloud CLI는 기능 확장을 위한 플러그인 프레임워크를 지원합니다. Event Notifications 플러그인 저장소에서 IBM Cloud CLI 플러그인을 설치할 수 있습니다. Event Notifications 서비스 CLI 플러그인을 사용하면, 제공되는 CLI 명령어를 통해 Event Notifications 서비스 인스턴스를 손쉽게 관리할 수 있습니다.
전제조건
- IBM Cloud 계정 계정이 없는 경우 여기를 클릭하여 계정을 작성하십시오.
- IBM Cloud Event Notifications 서비스의 인스턴스.
- IBM Cloud CLI 패키지를 로컬 시스템에 설치하십시오.
IBM Cloud CLI 에 로그인하면 업데이트가 있을 때 알림이 표시됩니다. Event Notifications CLI 플러그인에 사용 가능한 명령 및 플래그를 사용할 수 있도록 CLI를 최신 상태로 유지하십시오.
참고: 1.15.2 이전 버전의 CLI 플러그인은 더 이상 사용되지 않습니다.
Event Notifications CLI 설치
plugin install 명령어를 사용하여 Event Notifications CLI 플러그인을 설치하십시오.
ibmcloud plugin install en
Event Notifications CLI 명령어
참고 CLI 플러그인 init 명령은 향후 더 이상 사용되지 않습니다
IBM클라우드 등록
설정된 대상 지역의 인스턴스를 나열합니다. 나열된 인스턴스에서 인스턴스 GUID를 검색할 수 있습니다.
ibmcloud en en-list
ibmcloud event-notifications 환경 변수 세트
작업할 리전을 설정하려면 ibmcloud 대상 리전(ibmcloud target -r
-
내보내기 IBMCLOUD_EN_ENDPOINT= https://au-syd.event-notifications.cloud.ibm.com/event-notifications
-
Event Notifications 리전의 공용 엔드포인트를 설정하려면 IBMCLOUD_EN_ENDPOINT 변수를 내보내십시오.
- 댈러스:
https://us-south.event-notifications.cloud.ibm.com/event-notifications - 런던:
https://eu-gb.event-notifications.cloud.ibm.com/event-notifications - 시드니:
https://au-syd.event-notifications.cloud.ibm.com/event-notifications - 프랑크푸르트:
https://eu-de.event-notifications.cloud.ibm.com/event-notifications - 마드리드:
https://eu-es.event-notifications.cloud.ibm.com/event-notifications - 오사카:
https://jp-osa.event-notifications.cloud.ibm.com/event-notifications - 도쿄:
https://jp-tok.event-notifications.cloud.ibm.com/event-notifications - 토론토:
https://ca-tor.event-notifications.cloud.ibm.com/event-notifications - 상파울루:
https://br-sao.event-notifications.cloud.ibm.com/event-notifications - 몬트리올:
https://ca-mon.event-notifications.cloud.ibm.com/event-notifications - 워싱턴 D.C.:
https://us-east.event-notifications.cloud.ibm.com/event-notifications - 첸나이:
https://in-che.event-notifications.cloud.ibm.com/event-notifications - 뭄바이:
https://in-mum.event-notifications.cloud.ibm.com/event-notifications
- 댈러스:
-
Event Notifications 리전의 사설 엔드포인트를 설정하려면 IBMCLOUD_EN_ENDPOINT 변수를 내보내십시오.
- 댈러스:
https://private.us-south.event-notifications.cloud.ibm.com/event-notifications - 런던:
https://private.eu-gb.event-notifications.cloud.ibm.com/event-notifications - 시드니:
https://private.au-syd.event-notifications.cloud.ibm.com/event-notifications - 프랑크푸르트:
https://private.eu-de.event-notifications.cloud.ibm.com/event-notifications - 마드리드:
https://private.eu-es.event-notifications.cloud.ibm.com/event-notifications - 오사카:
https://private.jp-osa.event-notifications.cloud.ibm.com/event-notifications - 도쿄:
https://private.jp-tok.event-notifications.cloud.ibm.com/event-notifications - 토론토:
https://private.ca-tor.event-notifications.cloud.ibm.com/event-notifications - 상파울루:
https://private.br-sao.event-notifications.cloud.ibm.com/event-notifications - 몬트리올:
https://private.ca-mon.event-notifications.cloud.ibm.com/event-notifications - 워싱턴 D.C.:
https://private.us-east.event-notifications.cloud.ibm.com/event-notifications - 첸나이:
https://private.in-che.event-notifications.cloud.ibm.com/event-notifications - 뭄바이:
https://private.in-mum.event-notifications.cloud.ibm.com/event-notifications
- 댈러스:
-
Event Notifications 인스턴스를 설정하려면 EVENT_NOTIFICATIONS_API_KEY 변수를 내보내십시오.
apikey.
EVENT_NOTIFICATIONS_API_KEY는 IBM Cloud 의 API 키 또는 Event Notifications 인스턴스의 서비스 자격 증명 API 키일 수 있습니다.
소스
IBM Cloud Event Notifications 소스에서 작동합니다.
ibmcloud event-notifications source create
- 조치:
Source를 만듭니다.
현재 CLI는 API 소스 생성 기능만 지원합니다.
ibmcloud event-notifications sources-create --instance-id INSTANCE-ID --name NAME [--description DESCRIPTION] [--enabled ENABLED] [--store-notifications STORE-NOTIFICATIONS]
- 제공할 매개변수:
--instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --name NAME(int64)-
API 소스에 지정할 이름입니다.
기본값은
입니다. 최대 길이는255자입니다. 최소 길이는1자입니다. 값은 정규 표현식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/과 일치해야 합니다. --description DESCRIPTION(문자열)-
소스에 대한 설명입니다. 선택사항입니다.
기본값은 ``입니다. 최대 길이는
255자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --enabled ENABLED(부울)-
소스를 활성화하거나 비활성화하는 부울 플래그입니다. 선택사항입니다.
값이 true이면 소스를 활성화하고, false이면 소스를 비활성화합니다.
--store-notifications(부울)-
문제 해결을 위해 수신 이벤트의 페이로드를 확인할 수 있도록 합니다.
기본값은
false입니다.
ibmcloud event-notifications source update
- 조치:
Source를 업데이트하십시오.
ibmcloud event-notifications source-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--enabled ENABLED] [--store-notifications STORE-NOTIFICATIONS]
- 제공할 매개변수:
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --name(int64)-
API 소스 이름.
기본값은 ``입니다. 최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --description(int64)-
API 소스 설명
기본값은 ``입니다. 최대 길이는
255자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --enabled(부울)-
결과 필터링을 위해 문자열을 검색합니다.
값이 true이면 소스를 활성화하고, false이면 소스를 비활성화합니다.
--store-notifications(부울)-
를 활성화하여 문제 해결을 위해 수신되는 이벤트의 페이로드를 볼 수 있습니다.
기본값은 `false`입니다.
`--id` (문자열)
: 소스의 고유 ID입니다. 필수.
최대 길이는 `100`자입니다. 최소 길이는 `1` 자입니다. 값은 정규식 `/[a-zA-Z0-9-:_]*/`(과)와 일치해야 합니다.
ibmcloud event-notifications source list
- 작업: 모든
Source목록을 표시합니다.
ibmcloud event-notifications sources [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
- 제공할 매개변수:
--limit LIMIT(int64)-
페이지 매김 결과에 대한 페이지 한계입니다.
최대값은
100입니다. 최소값은1입니다. --offset OFFSET(int64)-
페이지 매김 결과에 대한 오프셋입니다.
최소값은
0입니다. --search SEARCH(문자열)-
결과를 필터링하기 위한 검색 문자열입니다.
최대 길이는
100자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--force]-
(확인 프롬프트를 생략하려면) 리소스 삭제를 강제 실행하도록 활성화하십시오.
ibmcloud event-notifications source get
- 조치: 구체적인 내용을 확인하세요
Source.
ibmcloud event-notifications source --id ID --instance-id INSTANCE-ID
- 제공할 매개변수:
--id ID(문자열)-
소스의 고유 ID입니다. 필수.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다. --offset OFFSET-
페이지 매김 결과에 대한 오프셋입니다.
--search SEARCH-
결과를 필터링하기 위한 검색 문자열입니다.
--instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--force]-
(확인 프롬프트를 생략하려면) 리소스 삭제를 강제 실행하도록 활성화하십시오.
ibmcloud event-notifications source delete
- 조치: 특정
Source를 삭제합니다.
ibmcloud event-notifications source-delete --instance-id INSTANCE-ID --id ID
- 제공할 매개변수:
--id ID(문자열)-
소스의 고유 ID입니다. 필수.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--force]-
(확인 프롬프트를 생략하려면) 리소스 삭제를 강제 실행하도록 활성화하십시오.
목적지
IBM Cloud Event Notifications 목적지에서 작동합니다.
ibmcloud event-notifications destination create
- 작업: 목적지 생성.
ibmcloud event-notifications destination-create --instance-id INSTANCE-ID --name NAME --type TYPE [--description DESCRIPTION] [--collect-failed-events COLLECT-FAILED-EVENTS] [--config CONFIG] [--certificate CERTIFICATE] [--certificate-content-type CERTIFICATE-CONTENT-TYPE] [--icon16x16 ICON16X16] [--icon16x16-content-type ICON16X16-CONTENT-TYPE] [--icon16x162x ICON16X162X] [--icon16x162x-content-type ICON16X162X-CONTENT-TYPE] [--icon32x32 ICON32X32] [--icon32x32-content-type ICON32X32-CONTENT-TYPE] [--icon32x322x ICON32X322X] [--icon32x322x-content-type ICON32X322X-CONTENT-TYPE] [--icon128x128 ICON128X128] [--icon128x128-content-type ICON128X128-CONTENT-TYPE] [--icon128x1282x ICON128X1282X] [--icon128x1282x-content-type ICON128X1282X-CONTENT-TYPE]
- 제공할 매개변수:
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --name NAME(문자열)-
대상의 이름입니다. 필수.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --type TYPE(문자열)-
대상 유형. 사용 가능한 옵션은 webhook, push_android, push_ios,push_chrome,push_firefox,push_huawei,push_safari,ibmce, ibmcos,msteams,pagerduty,servicenow,slack,smtp_custom,sms_custom, event_streams입니다. 필수.
허용되는 값은 다음과 같습니다:
webhook,push_android,push_ios,push_chrome,push_firefox,push_huawei,push_safari,ibmce,ibmcos,msteams,pagerduty,servicenow,slack,smtp_custom,sms_custom, event_streams. 최소 길이는1자입니다. --collect-failed-events(부울)-
실패한 이벤트를 Cloud Object Storage 버킷에 수집할지 여부.
기본값은 `false`입니다.
`--description DESCRIPTION` (문자열)
: 대상에 대한 설명입니다.
기본값은 ` `입니다. 최대 길이는 `255` 자입니다. 최소 길이는 `0` 자입니다. 값은 정규 표현식 `/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/` 과 일치해야 합니다.
--certificate CERTIFICATE(문자열)-
제공할 인증서 파일 경로입니다. 허용되는 파일 형식은 p8 및 p12 인증서입니다. 인증서를 전달할 파일 위치를 제공하십시오.
--certificate-content-type CERTIFICATE-CONTENT-TYPE(문자열)-
IOS 대상의 경우에 설정될 인증서 내용 유형입니다. 기본값은 ``입니다. 사용 가능한 옵션은 p8 또는 p12 입니다.
--config CONFIG(DestinationConfig예)-
목적지별 매개변수를 설정하는 데 필요한 구성입니다.
--config를 지정하지 않고 대상 위치를 생성하면, 대상 위치는 생성되지만 구성을 완료할 때까지는 작동하지 않습니다.--icon16x16(io.ReadCloser)- 사파리 아이콘 16x16.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon16x16-content-type(문자열)-
Icon16x16 콘텐츠 유형.
--icon16x162x(io.ReadCloser)-
Safari 아이콘 16x16@2x.
The maximum length is
5000characters. The minimum length is1character. --icon16x162x-content-type(문자열)-
Icon16x162x 콘텐츠 유형.
--icon32x32(io.ReadCloser)-
사파리 아이콘 32x32.
The maximum length is
5000characters. The minimum length is1character. --icon32x32-content-type(문자열)-
Icon32x32 콘텐츠 유형.
--icon32x322x(io.ReadCloser)-
Safari 아이콘 32x32@2x.
The maximum length is
5000characters. The minimum length is1character. --icon32x322x-content-type(문자열)-
Icon32x322x 콘텐츠 유형.
--icon128x128(io.ReadCloser)-
Safari 아이콘 128x128.
The maximum length is
5000characters. The minimum length is1character. --icon128x128-content-type(문자열)-
Icon128x128 콘텐츠 유형.
--icon128x1282x(io.ReadCloser)-
Safari 아이콘 128x128@2x.
The maximum length is
5000characters. The minimum length is1character. --icon128x1282x-content-type(문자열)-
Icon128x1282x 콘텐츠 유형.
{
"params" : {
"url" : "exampleString",
"verb" : "get",
"custom_headers" : { },
"sensitive_headers" : [ "exampleString" ]
}
}
참고: Event Notifications 대상 Cloud Functions 더 이상 사용되지 않으며, 대상 카테고리에서 더 이상 지원되지 않습니다.
예제
- 다음 예제는 P8 인증서를 사용하는 iOS 대상(push_ios)에 대한
DestinationConfig객체의 형식을 보여줍니다.pre_prod를 true로 설정하여 대상을 사전 제작 대상으로 구성하거나, 그렇지 않으면 false로 설정하십시오
{
"params" : {
"cert_type" : "p8",
"is_sandbox" : true,
"key_id": "production",
"team_id": "1234",
"bundle_id": "test1",
"pre_prod" : "true" // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예제는 P12 인증서를 사용하는 iOS 대상(push_ios)에 대한 `DestinationConfig` 객체의 형식을 보여줍니다. `pre_prod` 를 *true로* 설정하여 대상을 사전 제작 대상으로 구성하거나, *false로* 설정하십시오.
```json
{
"params" : {
"cert_type" : "p12",
"is_sandbox" : true,
"password": "apnspasswordvalue",
"pre_prod" : "true" true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예제는 Chrome 대상(push_chrome)에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다. `pre_prod` 를 *true로* 설정하여 대상을 사전 제작 대상으로 구성하거나, *false로* 설정하십시오.
```json
{
"params" : {
"api_key": "chromeapikey",
"website_url" : "https://testwebsite.com",
"pre_prod" : "true" true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예제는 Firefox 대상(push_firefox)에 대한 `DestinationConfig` 객체의 형식을 보여줍니다. `pre_prod` 를 *true로* 설정하여 대상을 사전 제작 대상으로 구성하거나, *false로* 설정하십시오.
```json
{
"params" : {
"website_url" : "https://testwebsite.com",
"pre_prod" : "true" // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예는 유형이 incoming_webhook인 슬랙 대상(slack)에 대한 `DestinationConfig` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"type" : "incoming_webhook",
"url" : "https://hooks.slack.com/services/G0gyhsush/TYodsjhs/GHTbfidsimkk"
}
}
```
- 다음 예는 Slack 대상(slack)에 대한 direct_message 유형의 `DestinationConfig` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"type" : "direct_message",
"token" : "vhdwvecwefwefewivcweivcwiwiciwcvwicwec"
}
}
```
- 다음 예제는 Safari 대상(push_safari)에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다. `pre_prod` 를 *true로* 설정하여 대상을 사전 제작 대상으로 구성하거나, *false로* 설정하십시오.
```json
{
"params": {
"cert_type":"p12",
"certificate_name":"Users/Testuser/Documents/safari.p12",
"password":"safarinew",
"url_format_string":"https://test.com",
"website_name":"testwebsite",
"website_push_id":"test",
"website_url":"https://test.com",
"pre_prod" : "true" // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예제는 MS Teams(msteams) 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"url" : "https://xyz.webhook.office.com"
}
}
```
- 다음 예제는 PagerDuty(pagerduty ) 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
목적지를 생성하는 동안에는 라우팅 키만 사용하는 것이 좋습니다. API 키는 더 이상 사용되지 않으며 앞으로는 사용할 수 없습니다.
{: attention}
```json
{
"params" : {
"routing_key" : "routingkeytoconnecttoPD",
"api_key" : "cffunctionnamespaceserviceidapikey"
}
}
```
- 다음 예제는 Webhook(webhook)에 대한 `DestinationConfig` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"url" : "exampleString",
"verb" : "get",
"custom_headers" : { },
"sensitive_headers" : [ "exampleString" ]
}
}
```
- 다음 예제는 Android(push_android) 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"project_id" : "6232305230320",
"private_key" : "36e21epfweort823or8rt832pr8p2r832pr82pr382r8f",
"client_email" : "testuser.123@gmail.com",
"pre_prod" : true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예제는 ServiceNow(servicenow ) 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"client_id" : "359705ceddd100eyfewyyw1f0f9e1c96",
"client_secret": "testsecrets",
"username": "testuser",
"password": "user_password",
"instance_name": "testinstancenje"
}
}
```
- 다음 예제는 ‘ Code Engine (ibmce)’ 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
코드 엔진 목적지 유형: 애플리케이션
```json
{
"params" : {
"type" : "application",
"url" : "https://codeengine.test.com",
"verb" : "get",
"custom_headers" : { },
"sensitive_headers" : [ "exampleString" ]
}
}
```
코드 엔진 목적지 유형: 작업
```json
{
"params" : {
"type" : "job",
"job_name" : "custom-job",
"project_crn" : "crn:v1:bluemix:public:codeengine:us-south:a/e7e5820aeccb40efb78fd69a7858ef23:xxxxxxxxxxxxxx::"
}
}
```
- 다음 예제는 ‘ IBM Cloud Object Storage (ibmcos)’ 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"bucket_name" : "cos-destination-en-bucket",
"instance_id" : "42e13636e-0548-41a0-a178-e95be28464773",
"endpoint" : "https://s3.us-west.cloud-object-storage.appdomain.cloud"
}
}
```
- 다음 예시는 Huawei(push_huawei) 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"client_id" : "359705ceddd100eyfew",
"client_secret": "testsecrets",
"pre_prod" : true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
}
}
```
- 다음 예제는 사용자 지정 이메일(smtp_custom) 수신처에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다. 사용자 지정 이메일 샌드박스(smtp_custom_sandbox) 대상의 경우, 대상 구성 매개변수는 필요하지 않습니다.
프로세스 사용자 지정 도메인 구성 및 확인을 수행하는 방법: <https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-en-destinations-custom-email#en-destinations-custom-email-verify>
```json
{
"params" : {
"domain": "mailx.com"
}
}
```
- 다음 예제는 ‘ Event Streams (event_streams)’ 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"crn": "crn:v1:bluemix:public:messagehub:us-south:a/9f007405a9fe4a5d9345fa8c13357373:a292db6e-af78-4c0b-b3db-7d6794b637g::",
"endpoint": "https://n6627w6t7dgeh2cfgd.svc09.us-south.eventstreams.cloud.ibm.com",
"topic": "demo_topic"
}
}
```
- 다음 예제는 ‘ App Configuration ’(app_configuration) 대상에 대한 ` `DestinationConfig` ` 객체의 형식을 보여줍니다.
```json
{
"params" : {
"type": "features",
"crn": "crn:v1:bluemix:public:apprapp:us-south:a/4a74f2c31f554afc88156b73a1d577c6:dbxxxx93-0xxa-4xx5-axcf-c2faxxxd::",
"environment_id": "stage",
"feature_id": "test"
}
}
```
참고: 사용자 지정 SMS 수신처는 `DestinationConfig` 없이도 생성할 수 있지만, 필수 개인화 번호를 명시적으로 요청하고 구성하기 전까지는 작동하지 않습니다. 맞춤형 번호를 요청하려면 [‘맞춤형 SMS 번호’를](/docs/event-notifications?topic=event-notifications-en-destinations-sms-custom#en-destinations-sms-custom-numbers) 참조하십시오.
### ibmcloud event-notifications destination list {: #en-cli-destination-list-command}
- **작업:** 모든 `Destination` 목록을 표시합니다.
```sh {: pre}
ibmcloud event-notifications destinations [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
- 제공할 매개변수:
--limit LIMIT(int64)-
페이지 매김 결과에 대한 페이지 한계입니다.
최대값은
100입니다. 최소값은1입니다. --offset OFFSET(int64)-
페이지 매김 결과에 대한 오프셋입니다.
최소값은
0입니다. --search SEARCH(문자열)-
결과를 필터링하기 위한 검색 문자열입니다.
최대 길이는
100자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
ibmcloud event-notifications destination get
- 조치: 구체적인 내용을 확인하세요
Destination.
ibmcloud event-notifications destination --id ID --instance-id INSTANCE-ID
- 제공할 매개변수:
--id ID(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
ibmcloud event-notifications destination update
- 조치: 기존
Destination파일을 업데이트합니다.
ibmcloud event-notifications destination-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--collect-failed-events COLLECT-FAILED-EVENTS] [--config CONFIG] [--certificate CERTIFICATE] [--certificate-content-type CERTIFICATE-CONTENT-TYPE] [--icon16x16 ICON16X16] [--icon16x16-content-type ICON16X16-CONTENT-TYPE] [--icon16x162x ICON16X162X] [--icon16x162x-content-type ICON16X162X-CONTENT-TYPE] [--icon32x32 ICON32X32] [--icon32x32-content-type ICON32X32-CONTENT-TYPE] [--icon32x322x ICON32X322X] [--icon32x322x-content-type ICON32X322X-CONTENT-TYPE] [--icon128x128 ICON128X128] [--icon128x128-content-type ICON128X128-CONTENT-TYPE] [--icon128x1282x ICON128X1282X] [--icon128x1282x-content-type ICON128X1282X-CONTENT-TYPE]
- 제공할 매개변수:
--instance-id(문자열)- IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.
--id(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --name(문자열)-
목적지 이름입니다.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --description(문자열)-
목적지 설명입니다.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --collect-failed-events(부울)-
실패한 이벤트를 Cloud Object Storage 버킷에 수집할지 여부.
기본값은
false입니다. --config(DestinationConfig)-
목적지 구성을 설명하는 페이로드입니다.
JSON 문자열 옵션을 제공하거나, 파일 경로 옵션을 제공하여 읽을 JSON 파일을 지정합니다. 파일 경로 옵션은
@로 시작해야 합니다(예:--config=@path/to/file.json). --certificate(io.ReadCloser)-
APNS 인증서.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --certificate-content-type(문자열)-
인증서의 콘텐츠 유형.
--icon16x16(io.ReadCloser)-
사파리 아이콘 16x16.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon16x16-content-type(문자열)-
Icon16x16 콘텐츠 유형.
--icon16x162x(io.ReadCloser)-
Safari 아이콘 16x16@2x.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon16x162x-content-type(문자열)-
Icon16x162x 콘텐츠 유형.
--icon32x32(io.ReadCloser)-
사파리 아이콘 32x32.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon32x32-content-type(문자열)-
Icon32x32 콘텐츠 유형.
--icon32x322x(io.ReadCloser)-
Safari 아이콘 32x32@2x.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon32x322x-content-type(문자열)-
Icon32x322x 콘텐츠 유형.
--icon128x128(io.ReadCloser)-
Safari 아이콘 128x128.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon128x128-content-type(문자열)-
Icon128x128 콘텐츠 유형.
--icon128x1282x(io.ReadCloser)-
Safari 아이콘 128x128@2x.
최대 길이는
5000자입니다. 최소 길이는1자입니다. --icon128x1282x-content-type(문자열)-
Icon128x1282x 콘텐츠 유형.
ibmcloud event-notifications destination delete
- 조치: 기존
Destination을 삭제합니다.
ibmcloud event-notifications destination-delete --id ID --instance-id INSTANCE-ID [--force]
- 제공할 매개변수:
--id ID(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--force](부울)-
(확인 프롬프트를 생략하려면) 리소스 삭제를 강제 실행하도록 활성화하십시오.
ibmcloud event-notifications enabled-countries
SMS 수신처의 국가 세부 정보를 활성화하십시오.
ibmcloud event-notifications enabled-countries --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
예
ibmcloud event-notifications enabled-countries \
--instance-id=exampleString \
--id=exampleString
ibmcloud event-notifications test-destination
목적지를 테스트해 보세요.
ibmcloud event-notifications test-destination --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
예
ibmcloud event-notifications test-destination \
--instance-id=exampleString \
--id=exampleString
ibmcloud event-notifications email-sandbox-destination-update
사용자 지정 도메인을 사용하여 샌드박스 대상을 프로덕션으로 업그레이드하세요.
ibmcloud event-notifications email-sandbox-destination-update --instance-id INSTANCE-ID --id ID --domain DOMAIN
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `32`자입니다. 최소 길이는 `32`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`(과)와 일치해야 합니다.--id(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$/(과)와 일치해야 합니다. --domain(문자열)-
이메일 도메인. 필수.
최대 길이는
250자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications email-sandbox-destination-update \
--instance-id=exampleString \
--id=exampleString \
--domain=exampleString
ibmcloud event-notifications verify-destination-update
사용자 정의 도메인의 SPF 및 DKIM 레코드를 확인합니다.
ibmcloud event-notifications verify-destination-update --instance-id INSTANCE-ID --id ID --type TYPE
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
대상에 대한 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --type(문자열)-
확인 유형. 필수.
최대 길이는
20자입니다. 최소 길이는1자입니다. 값은 정규식/[a-z]/(과)와 일치해야 합니다.
예
ibmcloud event-notifications verify-destination-update \
--instance-id exampleString \
--id exampleString \
--type exampleString
토픽
IBM Cloud Event Notifications 주제에 대해 작업하십시오.
ibmcloud event-notifications topic create
- 작업: 새로운
Topic을 생성합니다.
ibmcloud event-notifications topic-create --name NAME [--description DESCRIPTION] [--sources SOURCES] --instance-id INSTANCE-ID
- 제공할 매개변수:
--name NAME(문자열)-
주제 이름입니다. 필수.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --description DESCRIPTION(문자열)-
주제에 대한 설명입니다.
기본값은 ``입니다. 최대 길이는
255자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--sources SOURCES](TopicCreateSourcesItem[])-
이 주제에 연결할 소스 목록과 각 소스의 필터 구성. 이 목록은 단순히 소스 ID의 나열에 그치는 것이 아닙니다. 각 항목에는 소스 ID와 함께, 해당 소스의 어떤 이벤트가 이 토픽으로 라우팅될지를 결정하는 필터 규칙이 포함되어 있습니다. 전체 구조는 예시를 참고하세요.
예
- 다음 예는 주기 타이머 소스에 대한
TopicCreateSourcesItem[]객체의 형식을 보여줍니다.
[
{
"id" : "exampleString",
"rules" : [
{
"enabled" : true,
"event_schedule_filter": {
"starts_at": "2024-12-23T12:00:00.000Z",
"ends_at": "2024-12-23T20:00:00.000Z",
"expression": "* * * * *"
}
}
]
}
]
```
- 다음 예제는 ` `TopicCreateSourcesItem[]` ` 객체의 형식을 보여줍니다.
```json
[
{
"id" : "exampleString",
"rules" : [
{
"enabled" : true,
"event_type_filter" : "$.*",
"notification_filter" : "exampleString"
}
]
}
]
```
- 다음 예제는 ` `TopicUpdateSourcesItem[]` ` 객체의 형식을 보여줍니다.
```json
[
{
"id" : "exampleString",
"rules" : [
{
"enabled" : true,
"event_type_filter": "$.notification_event_info.event_type == \'cert_manager\'",
"notification_filter" : "$.notification.findings[0].severity == \'MODERATE\'",
"rule_id" : "exampleString"
}
]
}
]
```
### ibmcloud event-notifications topic list {: #en-cli-topic-list-command}
- **작업:** 모든 `Topic` 목록을 표시합니다.
```sh {: pre}
ibmcloud event-notifications topics [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
- 제공할 매개변수:
--limit LIMIT(int64)-
페이지 매김 결과에 대한 페이지 한계입니다.
최대값은
100입니다. 최소값은1입니다. --offset OFFSET(int64)-
페이지 매김 결과에 대한 오프셋입니다.
최소값은
0입니다. --search SEARCH(문자열)-
결과를 필터링하기 위한 검색 문자열입니다.
최대 길이는
100자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
ibmcloud event-notifications topic get
- 조치: 구체적인 내용을 확인하세요
Topic.
ibmcloud event-notifications topic --id ID [--include INCLUDE] --instance-id INSTANCE-ID
- 제공할 매개변수:
--id ID(문자열)-
주제의 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --include INCLUDE(문자열)-
하위 주제를 포함합니다.
기본값은 ``입니다. 최대 길이는
20자입니다. 최소 길이는0자입니다. 값은 정규식/[a-z]/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
ibmcloud event-notifications topic update
- 조치: 기존
Topic파일을 업데이트합니다.
ibmcloud event-notifications topic-replace --id ID [--name NAME] [--description DESCRIPTION] [--sources SOURCES] --instance-id INSTANCE-ID
- 제공할 매개변수:
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --id(문자열)-
주제의 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --name(문자열)-
주제 이름입니다.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --description(문자열)-
주제에 대한 설명입니다.
기본값은 ``입니다. 최대 길이는
255자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/(과)와 일치해야 합니다. --sources(TopicUpdateSourcesItem[])-
이 주제에 추가할 새로운 소스 목록과 해당 필터 구성. 이 목록은 단순히 소스 ID의 나열에 그치는 것이 아닙니다. 각 항목에는 소스 ID와 함께, 해당 소스의 어떤 이벤트가 이 토픽으로 라우팅될지를 결정하는 필터 규칙이 포함되어 있습니다. 전체 구조는 예시를 참고하세요.
이 플래그는 새로운 소스만 추가합니다. 해당 주제에 이미 연결된 출처는 교체하거나 업데이트할 수 없으며, 삭제한 후 다시 추가해야만 합니다. 소스 필터를 수정하려면, 먼저 토픽에서 해당 소스를 제거한 다음 새로운 필터 구성으로 다시 추가하십시오.
ibmcloud event-notifications topic delete
- 조치: 기존
Topic을 삭제합니다.
ibmcloud event-notifications topic-delete --id ID --instance-id INSTANCE-ID [--force]
- 제공할 매개변수:
--id ID(문자열)-
주제의 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--force](부울)-
(확인 프롬프트를 생략하려면) 리소스 삭제를 강제 실행하도록 활성화하십시오.
구독
IBM Cloud Event Notifications 구독으로 운영하십시오.
ibmcloud event-notifications subscription create
- 작업: 새로운
Subscription을 생성합니다.
ibmcloud event-notifications subscription-create --instance-id INSTANCE-ID --name NAME --destination-id DESTINATION-ID --topic-id TOPIC-ID [--description DESCRIPTION] [--attributes ATTRIBUTES]
- 제공할 매개변수:
--name NAME(문자열)-
구독에 대해 설정할 이름입니다.
최대 길이는
50자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. --description DESCRIPTION(문자열)-
구독에 대해 설정할 설명입니다.
기본값은 ``입니다. 최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --destination-id DESTINATION-ID(문자열)-
구독에 대해 설정할 대상 ID입니다.
최대 길이는
150자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --topic-id TOPIC-ID(문자열)-
구독에 대해 설정할 주제 ID입니다.
최대 길이는
150자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --attributes ATTRIBUTES(SubscriptionCreateAttributes)-
구독에 대해 설정해야 할 속성들.
예제
- 다음 예제는 웹훅용
SubscriptionCreateAttributes객체의 형식을 보여줍니다.
{
"signing_enabled" : true,
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13"
}
```
- 다음 예제는 SMS용 `SubscriptionCreateAttributes` 객체의 형식을 보여줍니다.
```json
{
"invited" :["+1xxxxxxxxxx", "+1xxxxxxxxxx"]
}
```
- 다음 예시는 ‘ IBM ’ 이메일용 ‘ `SubscriptionCreateAttributes` ’ 객체의 형식을 보여줍니다.
```json
{
"invited" :["entest@gmail.com"],
"add_notification_payload": true,
"reply_to_mail": "en@ibm.com",
"reply_to_name": "EYS ORG",
"from_name":"ABC ORG"
}
```
- 다음 예제는 Slack 대상 유형에서 incoming_webhook인 경우 `SubscriptionCreateAttributes` 객체의 형식을 보여줍니다.
```json
{
"attachment_color" : "#FF0000",
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
}
```
- 다음 예제는 Slack 대상 유형이 direct_message인 경우, `SubscriptionCreateAttributes` 객체의 형식을 보여줍니다.
```json
{
"channels" : [{ "id": "GHIUIFJHGGH"},{"id": "TSFDIDFOFNF"}],
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
}
- 다음 예제는 ServiceNow 에 대한
SubscriptionCreateAttributes객체의 형식을 보여줍니다.
{
"assigned_to" : "serviceuser@gmail.com",
"assignment_group" : "incidentgroup"
}
```
- 다음 예제는 사용자 지정 이메일용 ` `SubscriptionCreateAttributes` ` 객체의 형식을 보여줍니다.
```json
{
"invited" :["entest@gmail.com"],
"add_notification_payload": true,
"reply_to_mail": "en@ibm.com",
"reply_to_name": "EYS ORG",
}
```
- 다음 예는 사용자 지정 이메일 샌드박스에 대한 `SubscriptionCreateAttributes` 개체의 형식을 보여줍니다.
```json
{
"invited" :["entest@gmail.com"],
"add_notification_payload": true,
"reply_to_mail": "en@ibm.com",
"reply_to_name": "EYS ORG",
"from_name":"ABC ORG",
"from_email":"Testuser@mailx.com",
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
"template_id_invitation": "f1ef32fb-b7dd-4405-xxxx-7b6719cee8aa"
}
```
- 다음 예시는 Pagerduty/ Event Streams 의 ` `SubscriptionCreateAttributes` ` 객체 형식을 보여줍니다.
```json
{
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
}
```
- 다음 예제는 App Configuration 에 대한 ` `SubscriptionCreateAttributes` ` 객체의 형식을 보여줍니다. 대상에 대한 구독을 만들거나 업데이트할 때 **App Configuration** 대상에 대한 구독을 만들거나 업데이트할 때 `attributes` 개체에는 특정 규칙이 있습니다:
- **다음 중 하나를** 포함해야 합니다. `feature_flag_enabled` **또는 **`template_id_notification`
- 두 속성을 함께 포함할 수는 **없습니다**
이를 통해 **기능 플래그 평가나** **알림 템플릿 생성** 중 올바른 사용 사례에 맞춰 구독이 생성되도록 보장하며, 두 가지가 동시에 적용되는 일은 없습니다.
```json
{
"template_id_notification": "e40843c8-xxxx-4717-xxxx-f923f2786a34",
}
```
```json
{
"feature_flag_enabled": false,
}
```
### ibmcloud event-notifications subscription list {: #en-cli-subscription-list-command}
- **작업:** 모든 `Subscription` 목록을 표시합니다.
```sh {: pre}
ibmcloud event-notifications subscriptions [--offset OFFSET] [--limit LIMIT] [--search SEARCH] --instance-id INSTANCE-ID
- 제공할 매개변수:
--limit LIMIT(int64)-
페이지 매김 결과에 대한 페이지 한계입니다.
최대값은
100입니다. 최소값은1입니다. --offset OFFSET(int64)-
페이지 매김 결과에 대한 오프셋입니다.
최소값은
0입니다. --search SEARCH(문자열)-
결과를 필터링하기 위한 검색 문자열입니다.
최대 길이는
100자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
ibmcloud event-notifications subscription get
- 조치: 구체적인 내용을 확인하세요
Subscription.
ibmcloud event-notifications subscription --id ID --instance-id INSTANCE-ID
- 제공할 매개변수:
--id ID(문자열)-
구독의 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다.
ibmcloud event-notifications subscription delete
- 조치: 기존
Subscription을 삭제합니다.
ibmcloud event-notifications subscription-delete --id ID --instance-id INSTANCE-ID [--force]
- 제공할 매개변수:
--id ID(문자열)-
구독의 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--force](부울)-
(확인 프롬프트를 생략하려면) 리소스 삭제를 강제 실행하도록 활성화하십시오.
ibmcloud event-notifications subscription update
- 조치: 기존
Subscription파일을 업데이트합니다.
ibmcloud event-notifications subscription-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--attributes ATTRIBUTES]
- 제공할 매개변수:
--id ID(문자열)-
구독의 고유 ID입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. [--name NAME](문자열)-
구독에 대해 설정할 업데이트된 설명입니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다. --instance-id INSTANCE-ID(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/(과)와 일치해야 합니다. [--description DESCRIPTION](문자열)-
구독에 대해 설정할 업데이트된 설명입니다.
기본값은 ``입니다. 최대 길이는
100자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다. [-attributes ATTRIBUTES](SubscriptionUpdateAttributes)-
구독에 대해 설정할 속성
예제
- 다음 예제는 웹훅용
SubscriptionUpdateAttributes객체의 형식을 보여줍니다.
{
"signing_enabled": true
}
```
- 다음 예제는 ‘ IBM ’ SMS용 ‘ `SubscriptionUpdateAttributes` ’ 객체의 형식을 보여줍니다.
```json
{
"invited": {
"add": ["+8xxxxxxxxxx"],
"remove": ["+1xxxxxxxxxx", "+91xxxxxxxxxx"]
},
"subscribed": {
"remove": ["+1xxxxxxxxxx", "+91xxxxxxxxxx"]
},
"unsubscribed": {
"remove": ["+1xxxxxxxxxx", "+91xxxxxxxxxx"]
}
}
```
- 다음 예시는 ‘ IBM ’ 이메일용 ‘ `SubscriptionUpdateAttributes` ’ 객체의 형식을 보여줍니다.
```json
{
"invited": {
"add": ["example1@gmail.com"],
"remove": []
},
"subscribed": {
"remove": ["example2@gmail.com"]
},
"unsubscribed": {
"remove": ["example3@gmail.com"]
},
"reply_to_mail": "example@ibm.com",
"reply_to_name": "USA news",
"from_name": "IBM",
"add_notification_payload": true
}
```
- 다음 예제는 사용자 지정 이메일용 ` `SubscriptionUpdateAttributes` ` 객체의 형식을 보여줍니다.
```json
{
"invited": {
"add": ["example1@gmail.com"],
"remove": []
},
"subscribed": {
"remove": ["example2@gmail.com"]
},
"unsubscribed": {
"remove": ["example3@gmail.com"]
},
"reply_to_mail": "example@ibm.com",
"reply_to_name": "USA news",
"from_name": "IBM",
"from_email": "test@email.com",
"add_notification_payload": true,
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
"template_id_invitation": "f1ef32fb-b7dd-4405-xxxx-7b6719cee8aa"
}
```
- 다음 예는 사용자 지정 이메일 샌드박스에 대한 `SubscriptionUpdateAttributes` 개체의 형식을 보여줍니다.
```json
{
"invited": {
"add": ["example1@gmail.com"],
"remove": []
},
"subscribed": {
"remove": ["example2@gmail.com"]
},
"unsubscribed": {
"remove": ["example3@gmail.com"]
},
"reply_to_mail": "example@ibm.com",
"reply_to_name": "USA news",
"add_notification_payload": true,
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
"template_id_invitation": "f1ef32fb-b7dd-4405-xxxx-7b6719cee8aa"
}
```
- 다음 예는 슬랙(Slack)의 `SubscriptionUpdateAttributes` 객체 형식을 `incoming_webhook` 로 보여줍니다.
```json
{
"attachment_color" : "#FF0000",
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
}
```
- 다음 예는 슬랙(Slack)의 `SubscriptionUpdateAttributes` 객체 형식을 `direct_message` 로 보여줍니다.
```json
{
"channels": [{"id": "D01CFDTYBH", "operation": "add"}, {"id": "D01GHUTYBH", "operation": "remove"}],
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
}
```
- 다음 예제는 ServiceNow용 `SubscriptionUpdateAttributes` 객체의 형식을 보여줍니다.
```json
{
"assigned_to" : "serviceuser@gmail.com",
"assignment_group" : "incidentgroup"
}
```
- 다음 예시는 Pagerduty/ Event Streams 의 ` `SubscriptionUpdateAttributes` ` 객체 형식을 보여줍니다.
```json
{
"template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
}
```
- 다음 예제는 App Configuration 에 대한 ` `SubscriptionCreateAttributes` ` 객체의 형식을 보여줍니다. 대상에 대한 구독을 만들거나 업데이트할 때 **App Configuration** 대상에 대한 구독을 만들거나 업데이트할 때 `attributes` 개체에는 특정 규칙이 있습니다:
- **다음 중 하나를** 포함해야 합니다. `feature_flag_enabled` **또는 **`template_id_notification`
- 두 속성을 함께 포함할 수는 **없습니다**
이를 통해 **기능 플래그 평가나** **알림 템플릿 생성** 중 올바른 사용 사례에 맞춰 구독이 생성되도록 보장하며, 두 가지가 동시에 적용되지는 않습니다.
```json
{
"template_id_notification": "e40843c8-xxxx-4717-xxxx-f923f2786a34",
}
```
```json
{
"feature_flag_enabled": false,
}
```
## 통합 {: #en-cli-integration}
IBM Cloud Event Notifications 통합을 운영합니다.
### ibmcloud 이벤트 알림 통합 생성 {: #en-cli-integration-create-command}
```sh
ibmcloud event-notifications integration-create --instance-id INSTANCE-ID --type TYPE --metadata METADATA
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는 `36`자입니다. 최소 길이는 `36`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--type(문자열)-
통합 유형 collect_failed_events.
최대 길이는
50자입니다. 최소 길이는1자입니다. 허용되는 값은 수집_실패한_이벤트입니다. --metadata(IntegrationCreateAttributes)-
업데이트를 위한 통합 스키마
통합에 필요한 메타데이터.
예제
- 다음 예제는
IntegrationCreateAttributes객체의 형식을 보여줍니다.
{
"endpoint": "https://s3.us-west.cloud-object-storage.appdomain.cloud",
"crn": "crn:v1:bluemix:public:cloud-object-storage:global:xxxxxxx6db359a81a1dde8f44bxxxxxx:xxxxxxxx-1d48-xxxx-xxxx-xxxxxxxxxxxx::",
"bucket_name": "cloud-object-storage"
}
```
### ibmcloud 이벤트 알림 통합 교체 {: #en-cli-integration-update-command}
`Integration` 를 대체합니다.
```sh
ibmcloud event-notifications integration-replace --instance-id INSTANCE-ID --id ID --type Type --metadata METADATA
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는 `36`자입니다. 최소 길이는 `36`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--type(문자열)-
통합 유형 KMS/hs-crypto(더 이상 사용되지 않음).
최대 길이는
50자입니다. 최소 길이는1자입니다. 허용되는 값은 KMS와 collect_failed_events입니다. 참고: hs-crypto 유형은 현재 더 이상 사용되지 않습니다. Hs-crypto 유형의 새로운 통합 리소스는 지원되지 않습니다. --metadata(IntegrationReplaceAttributes)-
업데이트를 위한 통합 스키마
통합에 필요한 메타데이터.
--id(문자열)-
통합을 위한 고유 식별자. 필수.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다.
예제
- 다음 예제는 kms용
IntegrationReplaceAttributes객체의 형식을 보여줍니다.
{
"endpoint" : "https://qa.us-south.kms.cloud.ibm.com",
"crn" : "crn of key protect",
"root_key_id" : "root key id"
}
```
### ibmcloud 이벤트 알림 통합 목록 {: #en-cli-integration-list-command}
모든 `Integrations`을(를) 나열합니다.
```sh
ibmcloud event-notifications integrations [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는 `36`자입니다. 최소 길이는 `36`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--limit(int64)-
페이지 번호를 매긴 결과에 대한 페이지 한계입니다.
최대값은
100입니다. 최소값은1입니다. --offset(int64)-
페이지 번호를 매긴 결과에 대한 오프셋입니다.
최소값은
0입니다. --search(문자열)-
결과 필터링을 위해 문자열을 검색합니다.
최대 길이는
100자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다.
ibmcloud 이벤트 알림 통합 get
특정 Integration을(를) 가져옵니다.
ibmcloud event-notifications integration --id ID --instance-id INSTANCE-ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 식별자입니다.
최대 길이는 `36`자입니다. 최소 길이는 `36`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
통합을 위한 고유 식별자. 필수.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다.
템플리트
IBM Cloud Event Notifications 템플릿.
ibmcloud event-notifications template-create
새 템플릿을 만듭니다.
ibmcloud event-notifications template-create --instance-id INSTANCE-ID --name NAME --type TYPE --params PARAMS [--description DESCRIPTION]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--name(문자열)-
메시지 템플리트입니다. 필수.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --type(문자열)-
템플릿의 유형. 필수.
최대 길이는
24자입니다. 최소 길이는22자입니다. 값은 정규식/^(smtp_custom.notification|smtp_custom.invitation)$/(과)와 일치해야 합니다. --params(TemplateConfig)-
템플릿 구성을 설명하는 페이로드. 필수.
이 JSON 옵션은 다른 옵션을 가진 개별 필드를 설정함으로써 제공될 수 있습니다. 이 옵션들은 서로 배타적입니다.
JSON 문자열 옵션을 제공하거나, 파일 경로 옵션을 제공하여 읽을 JSON 파일을 지정합니다. 파일 경로 옵션은
@로 시작해야 합니다(예:--params=@path/to/file.json). --description(문자열)-
템플릿 설명.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --params-body(문자열)-
템플릿 본문. 이 옵션은 JSON 옵션 'params'의 하위 필드에 대한 값을 제공합니다. 이 옵션과 상호 배타적입니다.
최대 길이는
20000자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다. --params-subject(문자열)-
템플릿 제목입니다. 이 옵션은 JSON 옵션 'params'의 하위 필드에 대한 값을 제공합니다. 이 옵션과 상호 배타적입니다.
최대 길이는
1000자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다.
예제
- 다음 예제는 이메일용
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은smtp_custom.notification|smtp_custom.invitation
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type smtp_custom.notification \
--params '{"body": "exampleString", "subject": "exampleString"}' \
--description exampleString
- 다음 예제는 Slack용
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은slack.notification입니다.
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type slack.notification \
--params '{"body": "ewoJImJsb2NrcyI6IFsKCQl7CgkJCSJ0eXBlIjogInNlY3Rpb24iLAoJCQkidGV4dCI6IHsKCQkJCSJ0eXBlIjogIm1ya2R3biIsCgkJCQkidGV4dCI6ICJOZXcgUGFpZCBUaW1lIE9mZiByZXF1ZXN0IGZyb20gPGV4YW1wbGUuY29tfEZyZWQgRW5yaXF1ZXo+XG5cbjxodHRwczovL2V4YW1wbGUuY29tfFZpZXcgcmVxdWVzdD4iCgkJCX0KCQl9CgldCn0="}' \
--description exampleString
- 다음 예제는 웹훅용
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은webhook.notification
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type webhook.notification \
--params '{"body": "ewoJImJsb2NrcyI6IFsKCQl7CgkJCSJ0eXBlIjogInNlY3Rpb24iLAoJCQkidGV4dCI6IHsKCQkJCSJ0eXBlIjogIm1ya2R3biIsCgkJCQkidGV4dCI6ICJOZXcgUGFpZCBUaW1lIE9mZiByZXF1ZXN0IGZyb20gPGV4YW1wbGUuY29tfEZyZWQgRW5yaXF1ZXo+XG5cbjxodHRwczovL2V4YW1wbGUuY29tfFZpZXcgcmVxdWVzdD4iCgkJCX0KCQl9CgldCn0="}' \
--description exampleString
- 다음 예제는 Pagerduty용
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은pagerduty.notification
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type pagerduty.notification \
--params '{"body": "ewogICJwYXlsb2FkIjogewogICAgInN1bW1hcnkiOiAie3sgZGF0YS5hbGVydF9kZWZpbml0aW9uLm5hbWV9fSIsCiAgICAidGltZXN0YW1wIjogInt7dGltZX19IiwKICAgICJzZXZlcml0eSI6ICJpbmZvIiwKICAgICJzb3VyY2UiOiAie3sgc291cmNlIH19IgogIH0sCiAgImRlZHVwX2tleSI6ICJ7eyBpZCB9fSIsCiAge3sjZXF1YWwgZGF0YS5zdGF0dXMgInRyaWdnZXJlZCJ9fQogICJldmVudF9hY3Rpb24iOiAidHJpZ2dlciIKICAge3svZXF1YWx9fQoKICB7eyNlcXVhbCBkYXRhLnN0YXR1cyAicmVzb2x2ZWQifX0KICAiZXZlbnRfYWN0aW9uIjogInJlc29sdmUiCiAge3svZXF1YWx9fQoKICAge3sjZXF1YWwgZGF0YS5zdGF0dXMgImFja25vd2xlZGdlZCJ9fQogICAiZXZlbnRfYWN0aW9uIjogImFja25vd2xlZGdlIgogICB7ey9lcXVhbH19Cn0="}' \
--description exampleString
- 다음 예제는 Event Streams 에 대한
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은event_streams.notification
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type event_streams.notification \
--params '{"body": "eyJuYW1lIjoie3tkYXRhLm5hbWV9fSIifQ=="}' \
--description exampleString
- 다음 예는 Code Engine Job에 대한
TemplateConfig개체의 형식을 보여줍니다. 지원되는 유형은ibmcejob.notification
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type ibmcejob.notification\
--params '{"body": "ewogInJ1bl9lbnZfdmFyaWFibGVzIjogWwogICB7ICJuYW1lIjogInJlZ2lvbiIsICJ2YWx1ZSI6ICJ7e2RhdGEucmVnaW9ufX0iLCJ0eXBlIjogImxpdGVyYWwifSwKeyJuYW1lIjoiVkFSMSIsInR5cGUiOiJsaXRlcmFsIiwidmFsdWUiOiJ7e2RhdGEudmFyMX19In0sCnsibmFtZSI6IlZBUjIiLCJ0eXBlIjoibGl0ZXJhbCIsInZhbHVlIjoie3tkYXRhLnZhcjJ9fSJ9Cl0KfQ=="}' \
--description exampleString
- 다음 예는 Code Engine Application/Function에 대한
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은ibmceapp.notification
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type ibmceapp.notification\
--params '{"body": "ewogICJ2YXIxIjogInt7ZGF0YS52YXIxfX0iLAogICJ2YXIyIjogInt7ZGF0YS52YXIyfX0iCn0="}' \
--description exampleString
- 다음 예제는 App Configuration 에 대한
TemplateConfig객체의 형식을 보여줍니다. 지원되는 유형은app_configuration.notification
ibmcloud event-notifications template-create \
--instance-id exampleString \
--name exampleString \
--type app_configuration.notification\
--params '{"body": "eyJlbmFibGVkIjogZmFsc2V9Cg=="}' \
--description exampleString
ibmcloud event-notifications templates
모든 템플릿을 나열합니다. 참고: 컬렉션의 단일 페이지만 검색하도록 하려면, " --all-pages " 옵션을 설정하지 마십시오.
ibmcloud event-notifications templates --instance-id INSTANCE-ID [--limit LIMIT] [--offset OFFSET] [--search SEARCH]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--limit(int64)-
페이지 번호를 매긴 결과에 대한 페이지 한계입니다.
기본값은
10입니다. 최대값은100입니다. 최소값은1입니다. --offset(int64)-
페이지 번호를 매긴 결과에 대한 오프셋입니다.
기본값은
0입니다. 최소값은0입니다. --search(문자열)-
결과 필터링을 위해 문자열을 검색합니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --all-pages(부울)-
템플릿의 컬렉션에 포함된 모든 페이지를 표시하려면 여러 요청을 실행하십시오.
예
ibmcloud event-notifications templates \
--instance-id exampleString \
--limit 10 \
--offset 0 \
--search exampleString
ibmcloud event-notifications template
템플릿에 대한 세부 정보를 확인합니다.
ibmcloud event-notifications template --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `32`자입니다. 최소 길이는 `32`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`(과)와 일치해야 합니다.--id(문자열)-
템플릿의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다.
예
ibmcloud event-notifications template \
--instance-id=exampleString \
--id=exampleString
ibmcloud event-notifications template-replace
템플릿의 세부 정보를 업데이트합니다.
ibmcloud event-notifications template-replace --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--type TYPE] [--params PARAMS]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
템플릿의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --name(문자열)-
템플리트 이름.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --description(문자열)-
템플리트 설명.
최대 길이는
255자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --type(문자열)-
템플릿의 유형.
최대 길이는
24자입니다. 최소 길이는22자입니다. 값은 정규식/^(smtp_custom.notification|smtp_custom.invitation)$/(과)와 일치해야 합니다. --params(TemplateConfig)-
템플릿 구성을 설명하는 페이로드. 이 JSON 옵션은 다른 옵션을 가진 개별 필드를 설정함으로써 제공될 수 있습니다. 이 옵션들은 서로 배타적입니다.
JSON 문자열 옵션을 제공하거나, 파일 경로 옵션을 제공하여 읽을 JSON 파일을 지정합니다. 파일 경로 옵션은
@로 시작해야 합니다(예:--params=@path/to/file.json).
예제
ibmcloud event-notifications template-update \
--instance-id exampleString \
--id exampleString \
--name exampleString \
--description exampleString \
--type exampleString \
--params '{"body": "exampleString", "subject": "exampleString"}'
ibmcloud event-notifications template-delete
템플리트를 삭제합니다.
ibmcloud event-notifications template-delete --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
템플릿의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다.
예
ibmcloud event-notifications template-delete \
--instance-id exampleString \
--id exampleString
ibmcloud event-notifications pre-defined-templates
미리 정의된 모든 템플릿을 나열합니다.
--all-pages 옵션을 설정하지 않으면 이 명령은 컬렉션의 한 페이지만 검색합니다.
ibmcloud event-notifications pre-defined-templates --instance-id INSTANCE-ID --source SOURCE --type TYPE [--limit LIMIT] [--offset OFFSET] [--search SEARCH]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `32`자입니다. 최소 길이는 `32`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`(과)와 일치해야 합니다.--source(문자열)-
소스 유형. 필수.
최대 길이는
50자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다. --type(문자열)-
목적지 유형입니다. 필수.
최대 길이는
50자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다. --limit(int64)-
페이지 번호를 매긴 결과에 대한 페이지 한계입니다.
기본값은
10입니다. 최대값은100입니다. 최소값은1입니다. --offset(int64)-
페이지 번호를 매긴 결과에 대한 오프셋입니다.
기본값은
0입니다. 최소값은0입니다. --search(문자열)-
결과 필터링을 위해 문자열을 검색합니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --all-pages(부울)-
사전 정의된 템플릿에 대해 컬렉션의 모든 페이지를 표시하려면 여러 요청을 호출하십시오.
예
ibmcloud event-notifications pre-defined-templates \
--instance-id=exampleString \
--source=exampleString \
--type=exampleString \
--limit=10 \
--offset=0 \
--search=exampleString
SMTP 구성
IBM Cloud Event Notifications SMTP 구성.
ibmcloud event-notifications smtp-configuration-create
새로운 SMTP 구성을 생성합니다.
ibmcloud event-notifications smtp-configuration-create --instance-id INSTANCE-ID --name NAME --domain DOMAIN [--description DESCRIPTION]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--name(문자열)-
SMTP 구성의 이름입니다. 필수.
최대 길이는
250자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --domain(문자열)-
도메인 이름입니다. 필수.
최대 길이는
512자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다. --description(문자열)-
SMTP 구성에 대한 설명.
최대 길이는
250자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-configuration-create \
--instance-id=exampleString \
--name=exampleString \
--domain=exampleString \
--description=exampleString
ibmcloud event-notifications smtp-configurations
모든 SMTP 설정을 나열합니다. 참고: 컬렉션의 단일 페이지만 검색하도록 하려면, " --all-pages " 옵션을 설정하지 마십시오.
ibmcloud event-notifications smtp-configurations --instance-id INSTANCE-ID [--limit LIMIT] [--offset OFFSET] [--search SEARCH]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--limit(int64)-
페이지 번호를 매긴 결과에 대한 페이지 한계입니다.
기본값은
10입니다. 최대값은100입니다. 최소값은1입니다. --offset(int64)-
페이지 번호를 매긴 결과에 대한 오프셋입니다.
기본값은
0입니다. 최소값은0입니다. --search(문자열)-
결과 필터링을 위해 문자열을 검색합니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --all-pages(부울)-
smtp-configurations 컬렉션의 모든 페이지를 표시하려면 여러 번의 요청을 실행하십시오.
예
ibmcloud event-notifications smtp-configurations \
--instance-id=exampleString \
--limit=10 \
--offset=0 \
--search=exampleString
ibmcloud event-notifications smtp-user-create
새 SMTP 사용자를 생성합니다.
ibmcloud event-notifications smtp-user-create --instance-id INSTANCE-ID --id ID [--description DESCRIPTION] [--username-to-clone USERNAME-TO-CLONE]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --description(문자열)-
SMTP 구성에 대한 설명.
최대 길이는
250자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --username-to-clone(문자열)-
복제할 사용자의 이름을 입력합니다.
최대 길이는
20자입니다. 최소 길이는1자입니다. 값은 정규식/^[a-z0-9]{18}\\d{2}$/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-user-create \
--instance-id=exampleString \
--id=exampleString \
--description=exampleString \
--username-to-clone=exampleString
ibmcloud event-notifications smtp-users
모든 SMTP 사용자를 나열합니다. 참고: 컬렉션의 단일 페이지만 검색하도록 하려면, " --all-pages " 옵션을 설정하지 마십시오.
ibmcloud event-notifications smtp-users --instance-id INSTANCE-ID --id ID [--limit LIMIT] [--offset OFFSET] [--search SEARCH]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --limit(int64)-
페이지 번호를 매긴 결과에 대한 페이지 한계입니다.
기본값은
10입니다. 최대값은100입니다. 최소값은1입니다. --offset(int64)-
페이지 번호를 매긴 결과에 대한 오프셋입니다.
기본값은
0입니다. 최소값은0입니다. --search(문자열)-
결과 필터링을 위해 문자열을 검색합니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --all-pages(부울)-
smtp-users 컬렉션의 모든 페이지를 표시하려면 여러 요청을 실행하십시오.
예
ibmcloud event-notifications smtp-users \
--instance-id=exampleString \
--id=exampleString \
--limit=10 \
--offset=0 \
--search=exampleString
ibmcloud event-notifications smtp-configuration
SMTP 구성에 대한 세부 정보를 확인하세요.
ibmcloud event-notifications smtp-configuration --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-configuration \
--instance-id=exampleString \
--id=exampleString
ibmcloud event-notifications smtp-configuration-update
SMTP 세부 정보 업데이트.
ibmcloud event-notifications smtp-configuration-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --name(문자열)-
SMTP 이름.
최대 길이는
250자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다. --description(문자열)-
SMTP 설명.
최대 길이는
250자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-configuration-update \
--instance-id=exampleString \
--id=exampleString \
--name=exampleString \
--description=exampleString
ibmcloud event-notifications smtp-configuration-delete
SMTP 구성을 삭제합니다.
ibmcloud event-notifications smtp-configuration-delete --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-configuration-delete \
--instance-id=exampleString \
--id=exampleString
ibmcloud event-notifications smtp-user
SMTP 사용자의 세부 정보를 확인합니다.
ibmcloud event-notifications smtp-user --instance-id INSTANCE-ID --id ID --user-id USER-ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --user-id(문자열)-
UserID. 필수.
최대 길이는
256자입니다. 최소 길이는5자입니다. 값은 정규식/.*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-user \
--instance-id=exampleString \
--id=exampleString \
--user-id=exampleString
ibmcloud event-notifications smtp-user-update
SMTP 사용자 세부 정보 업데이트.
ibmcloud event-notifications smtp-user-update --instance-id INSTANCE-ID --id ID --user-id USER-ID [--description DESCRIPTION]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --user-id(문자열)-
UserID. 필수.
최대 길이는
256자입니다. 최소 길이는5자입니다. 값은 정규식/.*/(과)와 일치해야 합니다. --description(문자열)-
SMTP 사용자 설명.
최대 길이는
250자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-user-update \
--instance-id=exampleString \
--id=exampleString \
--user-id=exampleString \
--description=exampleString
ibmcloud event-notifications smtp-user-delete
SMTP 사용자를 삭제합니다.
ibmcloud event-notifications smtp-user-delete --instance-id INSTANCE-ID --id ID --user-id USER-ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --user-id(문자열)-
UserID. 필수.
최대 길이는
256자입니다. 최소 길이는5자입니다. 값은 정규식/.*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-user-delete \
--instance-id=exampleString \
--id=exampleString \
--user-id=exampleString
ibmcloud event-notifications smtp-allowed-ips
SMTP 허용 IP의 세부 정보를 확인하세요.
ibmcloud event-notifications smtp-allowed-ips --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다.
예
ibmcloud event-notifications smtp-allowed-ips \
--instance-id=exampleString \
--id=exampleString
ibmcloud event-notifications smtp-allowed-ips-update
참고: 레거시 허용 목록에 대한 지원은 더 이상 사용되지 않습니다. 컨텍스트 기반 제한을 통해 지원이 활성화되었습니다. 자세한 정보는 여기를 참조하십시오: https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-en-smtp-configurations#en-smtp-configurations-cbr
ibmcloud event-notifications verify-smtp-update
SMTP의 SPF 및 DKIM 레코드를 확인하십시오.
ibmcloud event-notifications verify-smtp-update --instance-id INSTANCE-ID --id ID --type TYPE
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--id(문자열)-
SMTP의 고유 식별자입니다. 필수.
최대 길이는
32자입니다. 최소 길이는32자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --type(문자열)-
SMTP 인증 유형. 필수.
최대 길이는
20자입니다. 최소 길이는1자입니다. 값은 정규식/.*/(과)와 일치해야 합니다.
예
ibmcloud event-notifications verify-smtp-update \
--instance-id=exampleString \
--id=exampleString \
--type=exampleString
메트릭
ibmcloud event-notifications metrics
지표 얻기.
ibmcloud event-notifications metrics ---instance-id INSTANCE-ID --gte GTE --lte LTE [--smtp-config-id SMTP-CONFIG-ID] [--destination-type DESTINATION-TYPE][--destination-id DESTINATION-ID] [--subscription-id SUBSCRIPTION-ID] [--source-id SOURCE-ID] [--email-to EMAIL-TO] [--notification-id NOTIFICATION-ID] [--subject SUBJECT]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--gte(문자열)-
GTE(보다 큼과 같음), UTC 시간으로 시작 타임스탬프. 필수.
최대 길이는
28자입니다. 최소 길이는1자입니다. 값은 정규식/[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/(과)와 일치해야 합니다. --lte(문자열)-
LTE(less than equal), UTC의 종료 타임스탬프. 필수.
최대 길이는
28자입니다. 최소 길이는1자입니다. 값은 정규식/[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/(과)와 일치해야 합니다. --smtp-config-id(문자열)-
SMTP 구성 ID. SMTP 인터페이스 대상에 대한 메트릭을 조회할 때 필수입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --destination-type(문자열)-
지표가 요청되는 대상 유형. 지원되는 값: smtp_custom. 사용자 지정 이메일 수신처에 대한 메트릭을 조회할 때 필수입니다.
허용되는 값은
smtp_custom입니다. --destination-id(문자열)-
대상에 대한 고유 ID입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --subscription-id(문자열)-
구독의 고유 ID입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --source-id(문자열)-
소스의 고유 ID입니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다. --email-to(문자열)-
수신자 이메일 아이디.
최대 길이는
256자입니다. 최소 길이는0자입니다. 값은 정규식/[A-Za-z0-9\\._%+\\-]+@[A-Za-z0-9\\.\\-]+\\.[A-Za-z]{2,}/(과)와 일치해야 합니다. --notification-id(문자열)-
알림 ID.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --subject(문자열)-
이메일 제목.
최대 길이는
256자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다.
예
ibmcloud event-notifications metrics \
--instance-id=exampleString \
--destination-type=smtp_custom \
--gte=exampleString \
--lte=exampleString \
--destination-id=exampleString \
--subscription-id=exampleString \
--source-id=exampleString \
--email-to=exampleString \
--notification-id=exampleString \
--subject=exampleString
ibmcloud event-notifications bounce-metrics
반송률 지표를 확인하세요.
ibmcloud event-notifications bounce-metrics --instance-id INSTANCE-ID --gte GTE --lte LTE [--smtp-config-id SMTP-CONFIG-ID] [--destination-type DESTINATION-TYPE] [--destination-id DESTINATION-ID] [--subscription-id SUBSCRIPTION-ID] [--source-id SOURCE-ID] [--email-to EMAIL-TO] [--notification-id NOTIFICATION-ID] [--subject SUBJECT] [--limit LIMIT] [--offset OFFSET]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `32`자입니다. 최소 길이는 `32`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`(과)와 일치해야 합니다.--gte(문자열)-
GTE(보다 큼과 같음), UTC 시간으로 시작 타임스탬프. 필수.
최대 길이는
28자입니다. 최소 길이는1자입니다. 값은 정규식/[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/(과)와 일치해야 합니다. --lte(문자열)-
LTE(less than equal), UTC의 종료 타임스탬프. 필수.
최대 길이는
28자입니다. 최소 길이는1자입니다. 값은 정규식/[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/(과)와 일치해야 합니다. --smtp-config-id(문자열)-
SMTP 구성 ID. SMTP 인터페이스 대상에 대한 메트릭을 조회할 때 필수입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --destination-type(문자열)-
지표가 요청되는 대상 유형. 지원되는 값: smtp_custom. 사용자 지정 이메일 수신처에 대한 메트릭을 조회할 때 필수입니다.
허용되는 값은
smtp_custom입니다. --destination-id(문자열)-
대상에 대한 고유 ID입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --subscription-id(문자열)-
구독의 고유 ID입니다.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --source-id(문자열)-
소스의 고유 ID입니다.
최대 길이는
100자입니다. 최소 길이는1자입니다. 값은 정규식/[a-zA-Z0-9-:_]*/(과)와 일치해야 합니다. --email-to(문자열)-
수신자 이메일 아이디.
최대 길이는
256자입니다. 최소 길이는0자입니다. 값은 정규식/[A-Za-z0-9\\._%+\\-]+@[A-Za-z0-9\\.\\-]+\\.[A-Za-z]{2,}/(과)와 일치해야 합니다. --notification-id(문자열)-
알림 ID.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다. --subject(문자열)-
이메일 제목.
최대 길이는
256자입니다. 최소 길이는0자입니다. 값은 정규식/[a-zA-Z0-9]/(과)와 일치해야 합니다. --limit(int64)-
페이지 번호를 매긴 결과에 대한 페이지 한계입니다.
기본값은
10입니다. 최대값은100입니다. 최소값은1입니다. --offset(int64)-
페이지 번호를 매긴 결과에 대한 오프셋입니다.
기본값은
0입니다. 최소값은0입니다.
예
ibmcloud event-notifications bounce-metrics \
--instance-id=exampleString \
--destination-type=smtp_custom \
--gte=exampleString \
--lte=exampleString \
--destination-id=exampleString \
--subscription-id=exampleString \
--source-id=exampleString \
--email-to=exampleString \
--notification-id=exampleString \
--subject=exampleString \
--limit=10 \
--offset=0
알림 상태 보기
이 문서에서는 웹훅 대상 테스트 알림에 대한 알림 상태를 가져오기 위한 페이로드 세부 정보를 설명합니다.
ibmcloud event-notifications notifications-status
웹훅 수신처로 전송된 테스트 알림의 상태를 확인합니다. 이 명령어는 웹훅 테스트 알림의 전송 상태를 확인하는 데 특별히 사용됩니다.
ibmcloud event-notifications notifications-status --instance-id INSTANCE-ID --id ID
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `32`자입니다. 최소 길이는 `32`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`(과)와 일치해야 합니다.--id(문자열)-
웹훅 수신처를 테스트할 때 반환되는 알림 ID입니다. 이 ID는 웹훅 수신처로 전송되는 테스트 알림에 한정됩니다. 필수.
최대 길이는
36자입니다. 최소 길이는36자입니다. 값은 정규식/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/(과)와 일치해야 합니다.
예
ibmcloud event-notifications notifications-status \
--instance-id=exampleString \
--id=exampleString
알림 전송
이 문서는 Event Notifications 에 있는 API 소스를 사용하여 이벤트를 전송할 때의 페이로드 세부 사항을 설명합니다. API 소스를 사용하여 백엔드 애플리케이션에서 이벤트를 전송할 수 있습니다. Event Notifications HTTP 호출을 수행하는 두 가지 모드를 지원합니다. 이는 CloudEvents 사양을 따르는 것입니다. 이 모드는 이진 모드와 구조 모드입니다. 자세한 내용은 여기에서 확인하세요 - https://github.com/cloudevents/spec. 바이너리 콘텐츠 모드에서는 이벤트 데이터의 값이 HTTP 요청 또는 응답 본문에 있는 그대로 포함되며, datacontenttype 속성 값을 통해 HTTP Content-Type 헤더에 미디어 유형이 선언됩니다. 그 외의 모든 이벤트 속성은 HTTP 헤더에 매핑됩니다. 모든 속성 이름에는 ‘ce-’ 접두사가 붙으며 헤더에 추가됩니다(data 및 datacontenttype은 제외). CloudEvents 의 필수 속성(specversion, id, type 및 source)이 헤더의 일부로 전달되면 요청은 바이너리 모드로 처리됩니다. 구조화된 모드. 구조화된 콘텐츠 모드에서는 이벤트 메타데이터 속성과 이벤트 데이터가 HTTP 요청 본문에 포함됩니다. 구조화된 모드의 경우, Content-Type 헤더를 application/cloudevents+json으로 설정합니다. CloudEvents 필수 속성(specversion, id, type, source)은 요청 본문에 포함되어야 합니다. 또한, id 데이터는 필수 데이터 콘텐츠 유형으로 제공됩니다. 데이터 콘텐츠 유형은 "application/json"만 지원합니다.
ibmcloud event-notifications send-notifications
인스턴스에서 알림 본문을 전송합니다. Event Notifications 페이로드에 대한 자세한 정보는 여기를 참조하세요.
ibmcloud event-notifications send-notifications --instance-id INSTANCE-ID [--body BODY]
명령 옵션
--instance-id(문자열)-
IBM Cloud Event Notifications 인스턴스의 고유 ID입니다. 필수.
최대 길이는 `256`자입니다. 최소 길이는 `10`자입니다. 값은 정규식 `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`(과)와 일치해야 합니다.--body(NotificationCreate)-
알림 생성 요청을 설명하는 페이로드.
JSON 문자열 옵션을 제공하거나, 파일 경로 옵션을 제공하여 읽을 JSON 파일을 지정합니다. 파일 경로 옵션은
@로 시작해야 합니다(예:--body=@path/to/file.json).
NotificationCreate
다음 예제는 NotificationCreate 객체의 형식을 보여줍니다.
{
"specversion" : "1.0",
"time" : "2019-01-01T12:00:00.000Z",
"id" : "exampleString",
"source" : "exampleString",
"type" : "exampleString",
"ibmenseverity" : "exampleString",
"ibmensourceid" : "exampleString",
"ibmendefaultshort" : "exampleString",
"ibmendefaultlong" : "exampleString",
"ibmensubject" : "exampleString",
"ibmentemplates" : "[\"886f8f4c-8605-47hb-85a1-8682b9377468483\"]",
"ibmenmailto" : "exampleString",
"ibmenslackto": "[\"sgjhgsjaS\",\"agjhgsjaS\"]",
"ibmensmsto" : "exampleString",
"ibmenmms": {"content": "VBORw0KGgoAAAANSUhEUgAAAFoAAAA4CAYAAAB9lO","content_type": "image/png"},
"ibmenmarkdownn": "This is a *italic* message.\n- Item 1\n- Item 2\n**bold text** with more text data\n~~strike through~~\n1. order 1\n2. order 2\n```fenced code block```\n> block code\n`code`\n[Click here](https://example.com) for more info."
"ibmenhtmlbody" : "exampleString",
"subject" : "exampleString",
"attachments": [
{
"content": "VGhpcyBpcyBhIHRlc3QgZG9jdW1lbnQK",
"filename": "test.txt",
"content_type": "text/plain",
"disposition": "attachment"
}
],
"data" : {
"anyKey" : "anyValue"
},
"datacontenttype" : "application/json",
"ibmenpushto" : "{
\"fcm_devices\" : [ \"exampleString\" ],
\"apns_devices\" : [ \"exampleString\" ],
\"huawei_devices\" : [ \"exampleString\" ],
\"safari_devices\" : [ \"exampleString\" ],
\"chrome_devices\" : [ \"exampleString\" ],
\"firefox_devices\" : [ \"exampleString\" ],
\"user_ids\" : [ \"exampleString\" ],
\"tags\" : [ \"exampleString\" ],
\"platforms\" : [ \"push_android\" ]
}",
"ibmenfcmbody" : "{ }",
"ibmenapnsbody" : "{ }",
"ibmenapnsheaders" : "{ }",
"ibmenchromebody" : "{ }",
"ibmenchromeheaders" : "{ }",
"ibmenfirefoxbody" : "{ }",
"ibmenfirefoxheaders" : "{ }",
"ibmenhuaweibody" : "{ }",
"ibmensafaribody" : "{ }"
}
예
필수 매개변수가 있는 경우:
ibmcloud event-notifications send-notifications \
--instance-id=exampleString \
--body='{"specversion": "1.0", "time": "2019-01-01T12:00:00.000Z", "type": "*", "id": "exampleString", "source": "exampleString", "ibmensourceid": "exampleString", "ibmendefaultshort": "short message", "ibmendefaultlong": "long message", "data": {"name": "exampleString"}, "datacontenttype": "application/json"}'
모든 매개변수를 포함하여:
ibmcloud event-notifications send-notifications \
--instance-id=exampleString \
--body='{"specversion": "1.0", "time": "2019-01-01T12:00:00.000Z", "id": "exampleString", "source": "exampleString", "type": "exampleString", "ibmenseverity": "exampleString", "ibmensourceid": "exampleString", "ibmendefaultshort": "exampleString", "ibmendefaultlong": "exampleString", "ibmensubject": "exampleString", "ibmentemplates": [\"template-id\"], "ibmenmailto": "exampleString","ibmenslackto": "[\"sgjhgsjaS\",\"agjhgsjaS\"]", "ibmensmsto": "exampleString","ibmenmms": "{\"content\": \"VBORw0KGgoAAAANSUhEUgAAAFoAAAA4CAYAAAB9lO\",\"content_type\": \"image/png\"}", "ibmenhtmlbody": "exampleString", "subject": "exampleString", "data": {"anyKey": "anyValue"}, "datacontenttype": "application/json", "ibmenpushto": "{\"fcm_devices\": [\"exampleString\"], \"apns_devices\": [\"exampleString\"], \"huawei_devices\": [\"exampleString\"], \"safari_devices\": [\"exampleString\"], \"chrome_devices\": [\"exampleString\"], \"firefox_devices\": [\"exampleString\"], \"user_ids\": [\"exampleString\"], \"tags\": [\"exampleString\"], \"platforms\": [\"push_android\"]}", "ibmenfcmbody": "{}", "ibmenapnsbody": "{}", "ibmenapnsheaders": "{}", "ibmenchromebody": "{}", "ibmenchromeheaders": "{}", "ibmenfirefoxbody": "{}", "ibmenfirefoxheaders": "{}", "ibmenhuaweibody": "{}", "ibmensafaribody": "{}"}'
IOS 알림을 위해 구성할 수 있는 추가 특성
| 특성 | 특성 유형 | 설명 |
|---|---|---|
badge |
정수 | 애플리케이션 아이콘의 배지로서 표시할 숫자입니다. |
interactive_category |
문자열 | 대화식 푸시 알림에 사용되는 카테고리 ID입니다. |
ios_action_key |
문자열 | 조치 키의 제목입니다. |
payload |
JSON 오브젝트 | 알림 메시지의 일부로서 전송된 사용자 정의 JSON 페이로드입니다. |
sound |
문자열 | 애플리케이션 번들에서 사운드 파일의 이름입니다. 이 파일의 사운드는 경보로서 재생됩니다. |
title_loc_key |
문자열 | 현재 현지화에 맞는 Localizable.strings 파일의 title 문자열에 대한 키입니다. 키 문자열은 titleLocArgs 배열에 지정된 변수를 사용하도록 %@ 및 %n$@ 지정자를 사용하여 형식화될 수 있습니다. |
loc_key |
문자열 | 현재 현지화에 맞는 Localizabl.strings 파일의 경보 메시지 문자열에 대한 키입니다. 키 문자열은 locArgs 배열에 지정된 변수를 사용하도록 %@ 및 %n$@ 지정자를 사용하여 형식화될 수 있습니다. |
launch_image |
문자열 | 앱 번들에 포함된 이미지 파일의 파일 이름으로, 파일 확장자가 포함되거나 포함되지 않은 형태입니다. 이 이미지는 사용자가 액션 단추를 탭하거나 액션 슬라이더를 이동할 때 실행 이미지로 사용됩니다. |
title_loc_args |
문자열 | title-loc-key에서 형식 지정자 대신 표시될 변수 문자열 값입니다. |
loc_args |
문자열 | locKey에서 형식 지정자 대신 표시될 변수 문자열 값입니다. |
title |
문자열 | 리치 푸시 알림의 제목입니다(iOS 10 이상에서만 지원됨). |
subtitle |
문자열 | 리치 알림의 하위 제목입니다(iOS 10 이상에서만 지원됨). |
body |
문자열 | iOS 알림의 본문입니다. |
attachment_url |
문자열 | iOS 알림 매체에 대한 링크입니다(동영상, 오디오, GIF, 이미지 - iOS 10 이상에서만 지원됨). |
type |
문자열 | 허용 가능한 값: DEFAULT, MIXED, SILENT. |
apns_collapse_id |
문자열 | 동일한 접기 ID가 사용된 여러 알림은 하나의 알림으로 사용자에게 표시됩니다. |
apns_thread_id |
문자열 | 관련 알림을 그룹화하기 위한 앱 특정 ID입니다. 이 값은 UNNotificationContent 오브젝트의 threadIdentifier 특성에 해당합니다. |
apns_group_summary_arg |
문자열 | 알림이 카테고리의 요약 형식 문자열에 추가하는 문자열입니다. |
apns_group_summary_arg_count |
정수 | 알림이 카테고리의 요약 형식 문자열에 추가하는 항목의 수입니다. |
FCM 알림에 대해 구성할 수 있는 추가 특성
| 특성 | 특성 유형 | 설명 |
|---|---|---|
icon |
문자열 | 알림을 위해 표시되는 아이콘의 이름을 지정합니다. 아이콘이 클라이언트 애플리케이션에 이미 패키징되어 있는지 확인하십시오. |
delay_while_idle |
부울 | true로 설정되면 이 매개변수는 디바이스가 활성화될 때까지 메시지를 보내지 않음을 표시합니다. |
sync |
부울 | 디바이스 그룹 메시징은 그룹의 모든 앱 인스턴스가 최신 메시징 상태를 반영할 수 있도록 허용합니다. |
visibility |
문자열 | 비공개 또는 공개 - 이 알림의 표시 범위로, 보안 잠금 화면에서 알림이 표시되는 방식과 시기에 영향을 미칩니다. |
redact |
문자열 | 가시성이 개인용으로 설정된 경우 지정된 컨텐츠가 디바이스의 보안 잠금 화면에 표시됩니다. |
payload |
JSON 오브젝트 | 알림 메시지의 일부로서 전송된 사용자 정의 JSON 페이로드입니다. |
priority |
문자열 | 이 알림의 우선순위를 표시하는 문자열 값입니다. 허용되는 값은 'max', 'high', 'default', 'low' 및 'min'입니다. 'sound' 필드와 함께 표시되는 높은/낮은 우선 순위 알림은 Android 5.0의 헤드업 알림 또는 higher.sampleval='low'에 사용될 수 있습니다. |
sound |
문자열 | 디바이스에 알림이 수신될 때 재생할 사운드 파일입니다(디바이스에 있음). |
time_to_live |
정수 | 디바이스가 오프라인인 경우 메시지를 GCM 스토리지에 보관해야 하는 시간(초)을 지정합니다. |
lights |
푸시 알림 수신 시 알림 LED 색상을 설정합니다. | |
ledArgb |
문자열 | LED 색상입니다. 하드웨어는 최상의 추정을 수행합니다. |
ledOnMs |
정수 | 깜박이는 동안 LED가 켜지는 시간(밀리초)입니다. 하드웨어는 최상의 추정을 수행합니다. |
ledOffMs |
문자열 | 깜박이는 동안 LED가 오프되는 시간(밀리초)입니다. 하드웨어는 최상의 추정을 수행합니다. |
android_title |
문자열 | 리치 푸시 알림의 제목입니다. |
group_id |
문자열 | 동일한 키를 공유하는 알림 그룹의 일부가 되도록 이 알림을 설정합니다. 그룹화된 알림은 이러한 렌더링을 지원하는 디바이스의 클러스터 또는 스택에 표시될 수 있습니다. |
style |
Android 확장 가능 알림에 대해 지정할 옵션입니다. 확장 가능 알림 유형은 picture_notification, bigtext_notification, inbox_notification입니다. | |
type |
문자열 | 확장 가능한 알림의 유형을 지정합니다. 가능한 값은 bigtext_notification, picture_notification, inbox_notification입니다. |
title |
문자열 | 알림의 제목을 지정합니다. 제목은 알림이 확장될 때 표시됩니다. 3개의 모든 확장 가능 알림에 대해 제목을 지정해야 합니다. |
type |
문자열 | 허용되는 값: DEFAULT, SILENT. |
alert |
문자열 | 알림의 경보 값입니다. |
CLI를 사용한 Event Notifications 프로비저닝을 위한 샘플 스크립트
스크립트는 provision_event_notification.sh 스크립트는 Event Notifications 인스턴스의 프로비저닝 및 구성을 자동화합니다.
CLI를 사용한 플랫폼 알림 통합을 위한 샘플 스크립트
스크립트는 en-platform-notification-src-and-email-dest.sh 스크립트는 플랫폼 알림을 Event Notifications 와 통합하고 알림을 IBM 기본 제공 이메일 또는 사용자 지정 도메인 샌드박스로 라우팅합니다.
CLI를 사용한 IBM Cloud Logs 통합을 위한 샘플 스크립트
스크립트는 en-icl-src-and-email-dest.sh 스크립트는 IBM Cloud Logs 와 Event Notifications 를 통합하고 알림을 IBM 내장 이메일 또는 사용자 지정 도메인 샌드박스로 라우팅합니다.
이 스크립트에서는 IBM Cloud Logs 인스턴스와 Event Notifications 인스턴스가 동일한 계정에 있다고 가정합니다.
CLI 버전 히스토리
Event Notifications의 각 플러그인 버전에 대한 변경사항 요약을 찾아보십시오. 사용 가능한 모든 명령어와 옵션을 사용할 수 있도록 CLI를 최신 상태로 유지하세요.
0.0.5 부터 1.9.0 까지의 CLI 플러그인 버전은 더 이상 사용되지 않습니다.
| 버전 | 릴리스 날짜 | 변경사항 |
|---|---|---|
| 1.5.0 | 2024년 5월 10일 | SMTP 구성 및 슬랙 템플릿 지원. |
| 1.6.0 | 2024년 8월 1일 | CF 대상이 폐지되고 MMS가 지원됩니다. |
| 1.7.0 | 2024년 8월 9일 | 메트릭스 지원과 SMTP 지원 중단으로 인해 SMTP 구성에서 IP를 허용했습니다. |
| 1.8.0 | 2024년 9월 9일 | 슬랙 DM 대상 지원. |
| 1.9.0 | 2024년 10월 11일 | 웹훅 템플릿 지원. |
| 1.10.0 | 2024년 11월 4일 | Cloud Functions 지원 중단 |
| 1.11.0 | 2025년 1월 7일 | 주기 타이머 지원 |
| 1.12.0 | 2025년 2월 27일 | Pagerduty 템플릿 지원 |
| 1.13.0 | 2025년 3월 6일 | Event Streams 대상, 구독 및 템플릿을 지원합니다. |
| 1.14.0 | 2025년 4월 28일 | PagerDuty 대상 사용되지 않는 매개변수 api_key 는 선택 사항으로 표시되어 있습니다. |
| 1.15.0 | 2025년 6월 27일 | 알림용 가격 인하 콘텐츠입니다. |
| 1.16.0 | 2025년 8월 1일 | Code Engine 및 사전 정의 템플릿을 지원합니다. |
| 1.17.0 | 2025년 9월 4일 | 웹훅 대상 테스트 알림 상태 가져오기 명령 지원 |
| 1.18.0 | 2025년 9월 25일 | 앱 구성 대상, 구독 및 템플릿 지원 |
| 1.19.0 | 2025년 10월 30일 | 복제 smtp 사용자 자격 증명 지원 |
| 1.20.0 | 2025년 12월 15일 | 반송률 지표 지원 |
| 1.20.1 | 2026년 1월 19일 | 의 비공개 엔드포인트 지원 메타데이터 및 EN 플러그인 설치 문제 수정 private.cloud.ibm.com |
| 1.20.2 | 2026년 2월 18일 | CLI 플러그인 취약점 수정 패치 업데이트 |
| 1.21.0 | 2026년 4월 7일 | 보기 샌드박스, 이메일 첨부 파일 및 페이로드 디버깅을 위한 소스 옵션 지원을 위한 CLI 플러그인 업데이트 |
| 1.21.1 | 2026년 5월 25일 | init 및 show 명령이 더 이상 사용되지 않으며 en 인스턴스 목록 명령이 추가되었습니다. 설정된 대상 지역에 따라 EN 엔드포인트를 자동으로 설정하도록 수정되었습니다. |
| 1.21.2 | 2026년 6월 29일 | SMTP 메트릭에 대한 버그 수정: SMTP 구성 ID 플래그를 지원하고, 수신처 유형을 선택 사항으로 표시하도록 했습니다. |
| 1.21.3 | 2026년 8월 6일 | CLI 플러그인 취약점 수정, 사용 편의성 및 외관 개선 |