Amazon Data Firehose 이벤트 데스티네이션 생성 Amazon Data Firehose 이벤트 목적지 관리

Amazon Data Firehose 이벤트 목적지

Amazon Data Firehose는 여러 유형의 대상으로 실시간 스트리밍 데이터를 전송하는 완전 관리형 서비스입니다. Amazon Data Firehose는 Kinesis 스트리밍 데이터 플랫폼의 일부입니다. Amazon Data Firehose에 대해 자세히 알아보려면 Amazon Data Firehose 개발자 안내서를 참조하십시오.

이 섹션의 일부 예제에서는 이미 설치하고 구성했다고 가정합니다. AWS Command Line Interface설정에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하십시오. AWS CLI

사전 조건

Amazon Data Firehose 이벤트 대상을 생성하려면 먼저 Amazon Data Firehose 전송 스트림을 생성해야 합니다. 스트림 생성에 대한 자세한 내용은 Amazon Data Firehose 개발자 안내서의 Amazon Data Firehose 전송 스트림 생성을 참조하십시오.

중요
이벤트 대상을 생성하려면 Amazon Data Firehose 전송 스트림의 Amazon 리소스 이름 (ARN) 이 필요합니다.
AWS 최종 사용자 메시지가 SMS 전송 스트림에 쓸 수 있도록 허용하는 IAM 역할을 생성해야 합니다 (참조IAMAmazon 데이터 파이어호스에 대한 정책).

중요
이벤트 대상을 생성하려면 IAM 역할의 Amazon 리소스 이름 (ARN) 이 필요합니다.
또한 이벤트 목적지를 연결할 구성 세트를 설정했습니다 (참조)구성 세트 관리.

Amazon Data Firehose 이벤트 데스티네이션 생성

Amazon Data Firehose 이벤트 대상을 생성하려면 먼저 Amazon Data Firehose 스트림을 생성해야 합니다. 로그 그룹 생성에 대한 자세한 내용은 Amazon Data Firehose 개발자 안내서의 Amazon Data Firehose 전송 스트림 생성을 참조하십시오.

AWS 최종 사용자 SMS 메시징과 음성 v2가 스트림으로 데이터를 전송할 수 있도록 허용하는 IAM 역할을 API 생성해야 합니다. 다음 단원에는 이 역할의 요구 사항에 대한 정보가 포함되어 있습니다.

또한 이벤트 대상을 연결할 구성 세트도 이미 설정되어 있습니다(구성 세트 단원 참조).

IAMAmazon 데이터 파이어호스에 대한 정책

다음 예제를 사용하여 Amazon Data Firehose 스트림으로 이벤트를 전송하기 위한 정책을 생성합니다.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
        }
    ]
}

IAM정책에 대한 자세한 내용은 사용 설명서의 IAM 정책 및 권한을 참조하십시오. IAM

다음 예제 명령문에서는 선택 사항이지만 권장되는 SourceArn 조건 SourceAccount 및 조건을 사용하여 AWS 최종 사용자 메시징 SMS 소유자 계정만 구성 집합에 액세스할 수 있는지 확인합니다. 이 예제에서는 다음을 대체합니다.accountId AWS 계정 ID로 region AWS 리전 이름 및 ConfigSetName 구성 세트의 이름과 함께.

정책을 생성한 후 새 IAM 역할을 생성한 다음 정책을 해당 역할에 연결합니다. 역할을 생성할 때 다음 신뢰 정책도 추가합니다.


{
    "Version": "2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
               "aws:SourceAccount": "accountId"
             },
             "ArnLike": {
               "aws:SourceArn": "arn:aws:sms-voice:region:accountId:configuration-set/ConfigSetName"
              }
        }
    }
}

IAM역할 생성에 대한 자세한 내용은 IAM사용 설명서에서 IAM 역할 생성을 참조하십시오.

Amazon Data Firehose 이벤트 목적지 관리

Create Amazon Data Firehose event destination (Console)

AWS 최종 사용자 메시징 SMS 콘솔을 사용하여 Amazon Data Firehose 이벤트 대상을 생성하려면 다음 단계를 따르십시오.

에서 AWS 최종 사용자 메시징 SMS 콘솔을 엽니다. https://console.aws.amazon.com/sms-voice/
탐색 창의 구성에서 구성 세트를 선택합니다.
구성 집합 페이지에서 이벤트 대상을 추가할 구성 집합을 선택합니다.
구성 세트 세부 정보 페이지에서 대상 이벤트 추가를 선택합니다.
이벤트 세부 정보 섹션에서 이벤트 대상 이름에 친숙한 이름을 입력합니다.
대상 유형 드롭다운에서 Amazon Data Firehose를 선택합니다.
IAM역할 arn에는 ARN 역할의 이름을 입력합니다. IAM IAM역할 arn에 대한 자세한 내용은 을 참조하십시오. IAMAmazon 데이터 파이어호스에 대한 정책
전송 스트림 ARN arn의 경우 이벤트를 전송할 Amazon Data Firehose 로그 그룹을 입력합니다.
이벤트 게시를 활성화합니다.
이벤트 유형에서 다음을 선택합니다.
- 모든 SMS 이벤트 (권장) - 이 옵션을 선택하면 나열된 모든 SMS 이벤트를 Amazon Data SMS,MMS, 음성의 이벤트 유형 Firehose로 보낼 수 있습니다.
- 사용자 지정 SMS 이벤트 — Amazon Data Firehose로 전송할 특정 SMS 이벤트를 선택합니다. 이벤트 목록을 편집하려면 SMS이벤트 선택 편집을 선택합니다. SMS이벤트 선택 편집에서 Amazon Data Firehose로 전송하려는 이벤트만 선택합니다. 선택 항목 저장을 선택합니다.
- 모든 음성 이벤트 (권장) - 이 옵션을 선택하면 목록에 있는 모든 음성 이벤트를 Amazon Data SMS,MMS, 음성의 이벤트 유형 Firehose로 보낼 수 있습니다.
- 사용자 지정 음성 이벤트 — Amazon Data Firehose로 전송할 특정 음성 이벤트를 선택합니다. 이벤트 목록을 편집하려면 음성 이벤트 선택 편집을 선택합니다. 음성 이벤트 선택 편집에서 Amazon Data Firehose로 전송하려는 이벤트만 선택합니다. 선택 저장을 선택합니다.
- 모든 MMS 이벤트 (권장) - 이 옵션을 선택하면 나열된 모든 MMS 이벤트를 Amazon Data SMS,MMS, 음성의 이벤트 유형 Firehose로 보낼 수 있습니다.
- 사용자 지정 MMS 이벤트 — Amazon Data Firehose로 전송할 특정 MMS 이벤트를 선택합니다. 이벤트 목록을 편집하려면 MMS이벤트 선택 편집을 선택합니다. MMS이벤트 선택 편집에서 Amazon Data Firehose로 전송하려는 이벤트만 선택합니다. 선택 항목 저장을 선택합니다.
이벤트 생성(Create event)을 선택합니다.

Create Amazon Data Firehose event destination (AWS CLI)

IAM역할과 Amazon Data Firehose 전송 스트림을 생성한 후 이벤트 대상을 생성할 수 있습니다.

create-event-destination명령을 사용하여 이벤트 대상을 생성할 수 있습니다.


$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream

위의 명령에서 다음과 같이 변경하세요.

Replace eventDestinationName 이벤트 대상을 설명하는 이름을 사용하십시오.
Replace configurationSet 이벤트 대상을 연결하려는 구성 집합의 이름을 입력합니다.
Replace eventTypes 에 나열된 이벤트 유형 중 하나 이상과 함께SMS,MMS, 음성의 이벤트 유형.
의 IamRoleArn 값을 에서 설명한 정책이 있는 IAM 역할의 Amazon 리소스 이름 (ARN) 으로 IAMAmazon 데이터 파이어호스에 대한 정책 대체하십시오.
의 DeliveryStreamArn 값을 이벤트를 전송하려는 Amazon Data Firehose ARN 스트림의 값으로 바꾸십시오.

Update Amazon Data Firehose event destination (Console)

AWS 최종 사용자 메시징 SMS 콘솔을 사용하여 Amazon Data Firehose 이벤트 대상을 업데이트하려면 다음 단계를 따르십시오.

에서 AWS 최종 사용자 메시징 SMS 콘솔을 엽니다. https://console.aws.amazon.com/sms-voice/
탐색 창의 구성에서 구성 세트를 선택합니다.
구성 집합 페이지에서 이벤트 대상을 추가할 구성 집합을 선택합니다.
구성 집합 페이지에서 편집할 구성 집합을 선택합니다.
구성 세트 세부 정보 페이지에서 Amazon Data Firehose 이벤트 대상을 선택한 다음 편집을 선택합니다.
IAM역할 arn에 ARN 역할의 IAM 이름을 입력합니다. IAM역할 arn에 대한 자세한 내용은 을 참조하십시오. IAMAmazon 데이터 파이어호스에 대한 정책
전송 스트림 ARN arn의 경우 이벤트를 전송할 Amazon Data Firehose 로그 그룹을 입력합니다.
이벤트 유형에서 다음을 선택합니다.
- 모든 SMS 이벤트 (권장) - 이 옵션을 선택하면 나열된 모든 SMS 이벤트를 Amazon Data SMS,MMS, 음성의 이벤트 유형 Firehose로 보낼 수 있습니다.
- 사용자 지정 SMS 이벤트 — 이 옵션을 선택하고 전송할 CloudWatch 특정 SMS 이벤트를 선택합니다. 이벤트 목록을 편집하려면 SMS이벤트 선택 편집을 선택합니다. SMS이벤트 선택 편집에서 Amazon Data Firehose로 전송하려는 이벤트만 선택합니다. 선택 항목 저장을 선택합니다.
- 모든 음성 이벤트 (권장) - 이 옵션을 선택하면 목록에 있는 모든 음성 이벤트를 Amazon Data SMS,MMS, 음성의 이벤트 유형 Firehose로 보낼 수 있습니다.
- 사용자 지정 음성 이벤트 — 이 옵션을 선택하면 Amazon Data Firehose로 전송할 특정 음성 이벤트를 선택할 수 있습니다. 이벤트 목록을 편집하려면 음성 이벤트 선택 편집을 선택합니다. 음성 이벤트 선택 편집에서 Amazon Data Firehose로 전송하려는 이벤트만 선택합니다. 선택 저장을 선택합니다.
- 모든 MMS 이벤트 (권장) - 이 옵션을 선택하면 나열된 모든 MMS 이벤트를 Amazon Data SMS,MMS, 음성의 이벤트 유형 Firehose로 보낼 수 있습니다.
- 사용자 지정 MMS 이벤트 — 이 옵션을 선택하고 전송할 CloudWatch 특정 MMS 이벤트를 선택합니다. 이벤트 목록을 편집하려면 MMS이벤트 선택 편집을 선택합니다. MMS이벤트 선택 편집에서 Amazon Data Firehose로 전송하려는 이벤트만 선택합니다. 선택 항목 저장을 선택합니다.
이벤트 편집을 선택합니다.

Update Amazon Data Firehose event destination (AWS CLI)

update-event-destination명령을 사용하여 이벤트 대상을 업데이트할 수 있습니다.

Amazon Data Firehose 이벤트 대상을 업데이트하는 절차는 이벤트 대상을 생성하는 프로세스와 유사합니다.


$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream

위의 명령에서 다음과 같이 변경하세요.

Replace eventDestinationName 수정하려는 이벤트 대상의 이름과 함께.
Replace configurationSet 이벤트 대상을 연결하려는 구성 집합의 이름을 포함합니다. 이벤트 대상을 다른 구성 세트와 연결할 수 있습니다.
Replace eventTypes 에 나열된 이벤트 유형 중 하나를 사용합니다SMS,MMS, 음성의 이벤트 유형.
의 IamRoleArn 값을 에서 설명한 정책이 있는 IAM 역할의 Amazon 리소스 이름 (ARN) 으로 IAMAmazon 데이터 파이어호스에 대한 정책 대체하십시오.
의 DeliveryStreamArn 값을 이벤트를 전송하려는 Amazon Data Firehose ARN 스트림의 값으로 바꾸십시오.

Delete an Amazon Data Firehose event destination (Console)

이벤트 대상을 삭제하는 절차는 삭제하려는 이벤트 대상의 유형에 관계없이 동일합니다.

콘솔에서 Amazon Data Firehose 이벤트 대상을 삭제하려면

에서 AWS 최종 사용자 메시징 SMS 콘솔을 엽니다. https://console.aws.amazon.com/sms-voice/
탐색 창의 구성에서 구성 세트를 선택합니다.
구성 집합 페이지에서 이벤트 대상을 제거할 구성 집합을 선택합니다.
모든 대상 섹션에서 이벤트 대상을 선택한 다음 삭제를 선택합니다.

Delete an Amazon Data Firehose event destination (AWS CLI)

delete-event-destination명령을 사용하여 이벤트 대상을 삭제할 수 있습니다.

이벤트 대상을 삭제하는 절차는 삭제하려는 이벤트 대상의 유형에 관계없이 동일합니다.

에서 Amazon Data Firehose 이벤트 대상을 삭제하려면 AWS CLI

명령줄 프롬프트에 다음 명령을 실행합니다.
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
위의 명령에서 다음과 같이 변경하세요.
- Replace eventDestinationName 삭제하려는 이벤트 대상의 이름 또는 Amazon 리소스 이름 (ARN) 과 함께 입력합니다.
- Replace configurationSetName 이벤트 대상이 연결된 구성 세트의 이름 또는 ARN 이름을 포함합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

아마존 CloudWatch 이벤트 목적지

아마존 SNS 이벤트 목적지