# mulesoft Amazon Sns Connector - Full Documentation # Amazon SNS - アップグレードおよび移行 ## [](#サポートされているアップグレードパス)サポートされているアップグレードパス
開始バージョン 終了バージョン

4.3.1

4.4.0
## [](#このリリースでの変更)このリリースでの変更 - TLS の設定機能を追加。 - `aws-java-sdk`​ を 1.11.611 から 1.11.649 にアップグレード。 - `aws-connector-commons`​ を 2.0.0 から 2.2.0 にアップグレード。 ## [](#要件)要件 アップグレードを実行する前に、システムが次の要件を満たしていることを確認します。
アプリケーション/サービス バージョン

Mule

4.1.1 以降

Amazon Java SDK for RDS

v1.11.649

Java

1.8.0_x

Anypoint Studio

7.0 以降
パッチ更新の更新された互換性情報については、​[「Amazon SNS Connector リリースノート」](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​を参照してください。 ## [](#アップグレード前提条件)アップグレード前提条件 アップグレードを実行する前に、以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成します。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.5 Connector リファレンス Amazon SNS Connector バージョン 4.5.0 リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4) ## [](#設定)設定 * * * ### [](#config)デフォルト設定 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Globally Defined Default Topic ARN (グローバルに定義されるデフォルトトピック ARN)。

String (文字列)

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。インスタンスが期限切れとみなされた瞬間にインスタンスが期限切れになるという意味ではありません。必要に応じて、インスタンスがパージされます。
#### [](#接続種別)接続種別 ##### [](#config_basic)Basic (基本) ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (トピックをテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
##### [](#config_role)Role (ロール) ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Role ARN (ロール ARN)

String (文字列)

ロール ARN は、クロスアカウントアクセスを取得することを前提とするロールを一意に特定します。

x

Custom STS Endpoint (カスタム STS エンドポイント)

String (文字列)

カスタム STS エンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。

Test Topic ARN (トピック ARN をテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
## [](#操作)操作 - [Add Permission](#addPermission) - [Confirm Subscription](#confirmSubscription) - [Create Platform Application](#createPlatformApplication) - [Create Platform Endpoint](#createPlatformEndpoint) - [Create Topic](#createTopic) - [Delete Endpoint](#deleteEndpoint) - [Delete Platform Application](#deletePlatformApplication) - [Delete Topic](#deleteTopic) - [Get Endpoint Attributes](#getEndpointAttributes) - [Get Platform Application Attributes](#getPlatformApplicationAttributes) - [Get Subscription Attributes](#getSubscriptionAttributes) - [Get Topic Attributes](#getTopicAttributes) - [List Endpoints By Platform Application](#listEndpointsByPlatformApplication) - [List Platform Applications](#listPlatformApplications) - [List Subscriptions](#listSubscriptions) - [List Subscriptions By Topic](#listSubscriptionsByTopic) - [List Topics](#listTopics) - [Publish](#publish) - [Remove Permission](#removePermission) - [Set Endpoint Attributes](#setEndpointAttributes) - [Set Platform Application Attributes](#setPlatformApplicationAttributes) - [Set Subscription Attributes](#setSubscriptionAttributes) - [Set Topic Attributes](#setTopicAttributes) - [Subscribe](#subscribe) - [Unsubscribe](#unsubscribe) ### [](#addPermission)Add Permission ​`` ステートメントをトピックのアクセス制御ポリシーに追加し、指定されたアクションへのアクセス権を指定の AWS アカウントに付与します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)​を参照してください。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

新しいポリシーステートメントの一意の識別子。

x

Account Ids (アカウント ID)

Array of String (文字列の配列)

指定されたアクションへのアクセス権を付与するユーザー (プリンシパル) の AWS アカウント ID。ユーザーには AWS アカウントが必要ですが、このサービスにサインアップする必要はありません。

x

Action Names (アクション名)

Array of String (文字列の配列)

指定されたプリンシパルに許可するアクション。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力)出力

型

String (文字列)
### [](#次の設定の場合)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#confirmSubscription)Confirm Subscription ​`` confirmSubscription アクションは、以前の Subscribe アクションでエンドポイントに送信されたトークンを検証して、エンドポイントのオーナーにメッセージを受信する意思があるかどうかを確認します。トークンが有効な場合、このアクションは新しいサブスクリプションを作成し、その Amazon リソース名 (ARN) を返します。AuthenticateOnUnsubscribe フラグが ​`true`​ に設定されている場合にのみ、このコールで AWS 署名が必要になります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)​を参照してください。 #### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクリプションを確認するトピックの ARN。

x

Token (トークン)

String (文字列)

Subscribe​ アクション中にエンドポイントに送信される有効期間の短いトークン。

x

Authenticate On Unsubscribe (サブスクライブ解除時に認証)

String (文字列)

サブスクリプションの未認証のサブスクライブ解除を許可しません。このパラメーターの値が ​true​ で、要求に AWS 署名が含まれている場合、トピックのオーナーとサブスクリプションのオーナーのみがエンドポイントをサブスクライブ解除できます。unsubscribe アクションでは、AWS 認証が必要です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-2)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-2)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-2)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformApplication)Create Platform Application ​`` デバイスやモバイルアプリケーションを登録できるいずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを作成します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)​を参照してください。 #### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

アプリケーション名は、大文字と小文字の ASCII 文字、数値、アンダースコア、ハイフン、ピリオドで構成されている必要があり、1 ～ 256 文字にする必要があります。

x

プラットフォーム

String (文字列)

ADM (Amazon Device Messaging)、APNS (Apple Push Notification Service)、​APNS_SANDBOX​、GCM (Google Cloud Messaging) のプラットフォームがサポートされています。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-3)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-3)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-3)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformEndpoint)Create Platform Endpoint ​`` いずれかのサポート対象プッシュ通知サービスのデバイスやモバイルアプリケーションのエンドポイントを作成します。CreatePlatformEndpoint では、CreatePlatformApplication から返される PlatformApplicationArn が必要です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)​を参照してください。 #### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

CreatePlatformApplication から返される PlatformApplicationArn は、エンドポイントを作成するために使用されます。

x

Token (トークン)

String (文字列)

デバイスのアプリケーションの通知サービスによって作成される一意の識別子。トークンの特定の名前は、使用されている通知サービスによって異なります。たとえば、通知サービスとして APNS (Apple Push Notification Service) を使用する場合、デバイストークンが必要です。GCM (Google Cloud Messaging) または ADM (Amazon Device Messaging) を使用する場合、登録 ID がデバイストークンに相当します。

x

Custom User Data (カスタムユーザーデータ)

String (文字列)

エンドポイントに関連付ける任意のユーザーデータ。Amazon SNS はこのデータを使用しません。データは UTF-8 形式で 2KB 未満にする必要があります。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-4)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-4)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-4)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createTopic)Create Topic ​`` CreateTopic アクションは、通知をパブリッシュできるトピックを作成します。ユーザーは、最大 100 件のトピックを作成できます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)​を参照してください。 #### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Name (トピック名)

String (文字列)

作成するトピックの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-5)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-5)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-5)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteEndpoint)Delete Endpoint ​`` Amazon SNS からデバイスやモバイルアプリケーションのエンドポイントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)​を参照してください。 #### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

削除するエンドポイントの EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-6)出力

型

String (文字列)
### [](#次の設定の場合-6)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-6)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deletePlatformApplication)Delete Platform Application ​`` いずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)​を参照してください。 #### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

削除するプラットフォームアプリケーションオブジェクトの PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-7)出力

型

String (文字列)
### [](#次の設定の場合-7)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-7)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteTopic)Delete Topic ​`` DeleteTopic アクションは、トピックとそのすべてのサブスクリプションを削除します。トピックを削除すると、以前にトピックに送信された一部のメッセージがサブスクライバーに配信されなくなる可能性があります。このアクションは羃等であるため、存在しないトピックを削除しても、エラーにはなりません。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)​を参照してください。 #### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

削除するトピックの ARN。

x

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
### [](#次の設定の場合-8)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-8)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getEndpointAttributes)Get Endpoint Attributes ​`` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

GetEndpointAttributes 入力の EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-9)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-9)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getPlatformApplicationAttributes)Get Platform Application Attributes ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

GetPlatformApplicationAttributesInput の PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-9)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-10)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-10)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getSubscriptionAttributes)Get Subscription Attributes ​`` GetSubscriptionAttributes アクションは、サブスクリプションのすべてのプロパティを返します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

取得するプロパティのサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-10)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-11)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-11)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getTopicAttributes)Get Topic Attributes ​`` GetTopicAttributes アクションは、トピックのすべてのプロパティを返します。返されるトピックプロパティは、ユーザーの認証によって異なる可能性があります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-15)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

取得するプロパティのトピックの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-11)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-12)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-12)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#listEndpointsByPlatformApplication)List Endpoints By Platform Application ​`` サポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイントとエンドポイント属性をリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)​を参照してください。 #### [](#パラメーター-16)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

プラットフォームアプリケーションの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-12)出力

型

[​エンドポイント​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-13)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-13)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listPlatformApplications)List Platform Applications ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトをリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)​を参照してください。 #### [](#パラメーター-17)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-13)出力

型

[​Platform Application (プラットフォームアプリケーション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-14)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-14)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptions)List Subscriptions ​`` ListSubscriptions アクションは、リクエスターのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい ListSubscriptions コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)​を参照してください。 #### [](#パラメーター-18)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-14)出力

型

[​Subscription (サブスクリプション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-15)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-15)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptionsByTopic)List Subscriptions By Topic ​`` SubscriptionsByTopic アクションは、特定のトピックへのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい SubscriptionsByTopic コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)​を参照してください。 #### [](#パラメーター-19)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

トピックの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-15)出力

型

[​Subscription (サブスクリプション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-16)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-16)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listTopics)List Topics ​`` ListTopics アクションは、要求者のトピックのリストを返します。各コールは、最大 100 件に制限されたトピックのリストを返します。それ以上のトピックがある場合、NextToken も返されます。新しい ListTopics コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)​を参照してください。 #### [](#パラメーター-20)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-16)出力

型

[String] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-17)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-17)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#publish)Publish ​`` Publish アクションは、メッセージをすべてのトピックのサブスクライブされたエンドポイントに送信します。返された messageId はメッセージが保存されていることを示し、Amazon SNS はすぐにそのメッセージをトピックのサブスクライバーに配信しようとします。サブスクライブされた各エンドポイントへの送信メッセージの形式は、選択した通知プロトコルによって異なります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Publish.html)​を参照してください。 #### [](#パラメーター-21)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Message (メッセージ)

String (文字列)

トピックに送信するメッセージ。

#[payload]

Subject (件名)

String (文字列)

メッセージがメールエンドポイントに配信されるときの「件名」行として使用されるパラメーター (省略可能)。この項目は、他のエンドポイントに配信される標準 JSON メッセージにも含まれます (存在する場合)。

Message Structure (メッセージ構造)

String (文字列)

プロトコルごとに異なるメッセージを送信する場合、MessageStructure を ​json​ に設定します。

Message Attributes (メッセージ属性)

Object (オブジェクト)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性。

Topic Arn (トピック ARN)

String (文字列)

パブリッシュするトピックの Amazon リソース名 (ARN)。この項目と [Target Arn (対象 ARN)] 項目は相互に排他的です。

Target Arn (対象 ARN)

String (文字列)

パブリッシュするプラットフォームエンドポイントの Amazon リソース名 (ARN)。この項目と [Topic Arn (トピック ARN)] 項目は相互に排他的です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-17)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-18)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-18)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#removePermission)Remove Permission ​`` RemovePermission アクションは、トピックのアクセス制御ポリシーからステートメントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)​を参照してください。 #### [](#パラメーター-22)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

削除するステートメントの一意の表示ラベル。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-18)出力

型

String (文字列)
### [](#次の設定の場合-19)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-19)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setEndpointAttributes)Set Endpoint Attributes ​`` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-23)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

エンドポイント

[Endpoint (エンドポイント)]

SetEndpointAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-19)出力

型

String (文字列)
### [](#次の設定の場合-20)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-20)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setPlatformApplicationAttributes)Set Platform Application Attributes ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-24)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Attributes (プラットフォームアプリケーション属性)

Platform Application (プラットフォームアプリケーション)

SetPlatformApplicationAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-20)出力

型

String (文字列)
### [](#次の設定の場合-21)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-21)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setSubscriptionAttributes)Set Subscription Attributes ​`` SubscriptionAttributes アクションは、サブスクリプションのオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-25)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

サブスクリプションの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-21)出力

型

String (文字列)
### [](#次の設定の場合-22)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-22)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setTopicAttributes)Set Topic Attributes ​`` TopicAttributes アクションは、トピックオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-26)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

トピックの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-22)出力

型

String (文字列)
### [](#次の設定の場合-23)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-23)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#subscribe)Subscribe ​`` Subscribe アクションは、エンドポイントに確認メッセージを送信してエンドポイントをサブスクライブする準備をします。実際にサブスクリプションを作成するには、エンドポイントのオーナーは確認メッセージのトークンを使用して confirmSubscription アクションをコールする必要があります。確認トークンは 3 日間有効です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)​を参照してください。 #### [](#パラメーター-27)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクライブするトピックの ARN。

x

Protocol (プロトコル)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

  • EMAIL

  • EMAIL_JSON​

  • SMS

  • SQS

  • APPLICATION

  • LAMBDA

使用するプロトコル。

x

エンドポイント

String (文字列)

通知を受信するエンドポイント。エンドポイントはプロトコルによって異なります。

  • HTTP - エンドポイントは ​http://​ で始まる URL になります。

  • HTTPS - エンドポイントは ​https://​ で始まる URL になります。

  • EMAIL - エンドポイントはメールアドレスになります。

  • EMAIL_JSON​ - エンドポイントはメールアドレスになります。

  • SMS - エンドポイントは SMS 対応デバイスの電話番号になります。

  • SQS - エンドポイントは Amazon SQS キューの ARN になります。

  • APPLICATION - エンドポイントはモバイルアプリケーションやデバイスのエンドポイントになります。

  • LAMBDA - エンドポイントは AWS Lambda 関数の ARN になります。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-23)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-24)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-24)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#unsubscribe)Unsubscribe ​`` Unsubscribe アクションは、サブスクリプションを削除します。サブスクリプションで削除の認証が必要な場合、サブスクリプションのオーナーまたはトピックのオーナーのみがサブスクライブ解除でき、AWS 署名が必要になります。Unsubscribe コールで認証が必要なく、リクエスターがサブスクリプションのオーナーでない場合、最終キャンセルメッセージがエンドポイントに配信されるため、Unsubscribe 要求が意図したものでなかった場合にエンドポイントのオーナーは簡単にトピックに再サブスクライブできます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)​を参照してください。 #### [](#パラメーター-28)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

削除するサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-24)出力

型

String (文字列)
### [](#次の設定の場合-25)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-25)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ## [](#型)型 ### [](#Tls)TLS
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

トラストストア

サーバーの場合、トラストストアには信頼済みのクライアントの証明書が格納されています。クライアントの場合、トラストストアには信頼済みサーバーの証明書が格納されています。

Key Store (キーストア)

Key Store (キーストア)

サーバーの場合、キーストアにはサーバーの非公開キーと公開キーが格納されています。クライアントの場合、キーストアにはクライアントの非公開キーと公開キーが格納されています。

Revocation Check (取り消し確認)

証明書が失効したことを検証します。
### [](#TrustStore)トラストストア
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。
### [](#KeyStore)Key Store (キーストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、ファイルにある最初のキーがデフォルトで使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。
### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。
### [](#custom-ocsp-responder)Custom OCSP Responder (カスタム OCSP レスポンダー)
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。
### [](#crl-file)CRL File (CRL ファイル)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。
### [](#Reconnection)Reconnection (再接続)
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。
### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続を試みる回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

unsubscribe
### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位
### [](#RequestIDAttribute)Request ID Attribute (要求 ID 属性)
項目 型 説明 デフォルト値 必須

Request Id (要求 ID)

String (文字列)
### [](#Endpoint)エンドポイント
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Endpoint Arn (エンドポイント ARN)

String (文字列)
### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームを使用し、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。
### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大数。これ以上の量が必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位
### [](#PlatformApplication)Platform Application (プラットフォームアプリケーション)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)
### [](#Subscription)Subscription (サブスクリプション)
項目 型 説明 デフォルト値 必須

エンドポイント

String (文字列)

Owner (オーナー)

String (文字列)

Protocol (プロトコル)

String (文字列)

Subscription Arn (サブスクリプション ARN)

String (文字列)

Topic Arn (トピック ARN)

String (文字列)
## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.5 Studio 設定 Anypoint Studio で Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) をインストールおよび設定する手順は、次のとおりです。 1. コネクタをインストールします。 2. コネクタの入力元を設定します。 3. コネクタを設定します。 ## [](#install-connector)Exchange を使用した Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの Exchange ​**(X)**​ アイコンをクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で、​**「Amazon SNS Connector」**​を検索します。 5. **\[Amazon SNS Connector\]**​ を選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ## [](#studio-でのコネクタのインストール)Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 3. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目にコネクタの名前を入力します。 4. **\[Available modules (使用可能なモジュール)\]**​ で、そのコネクタ名をクリックします。 5. **\[Add (追加)\]**​ をクリックします。 6. **\[Finish (完了)\]**​ をクリックします。 ## [](#入力元の設定)入力元の設定 **HTTP リスナー**​や​**スケジューラー**​などのコネクタの入力元を設定します。 ## [](#コネクタの設定)コネクタの設定 Mule アプリケーションで Amazon SNS Connector を使用するには、アプリケーションのすべての Amazon SNS Connector で使用できるグローバル Amazon SNS 要素を設定します。 1. コネクタの操作を Studio キャンバスにドラッグします。 2. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 3. **\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウで、​**\[Connector Configuration (コネクタ設定)\]**​ を展開し、​**\[Amazon SNS Configuration (Amazon SNS 設定)\]**​ をクリックします。 ![「Global Element Configuration (グローバル要素設定)」 ウィザード](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-config-global-wizard.png) 4. **\[OK\]**​ をクリックします。 5. グローバル要素のプロパティを指定します。 ![「Global Element Properties (グローバル要素のプロパティ)」](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-global-config.png) 6. パラメーターを次のように設定します。
パラメーター 説明

Name (名前)

設定が参照される名前。

Session Token (セッショントークン)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (テストトピック)

接続のテストに使用するトピック。

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

一時的なログイン情報を使用するかどうかを制御するチェックボックス。

Region Endpoint (リージョンエンドポイント)

トピックリージョンエンドポイント。

Globally Defined Default Topic Arn (グローバルに定義されるデフォルトトピック ARN)

接続性をテストするトピック ARN。
7. **\[Proxy (プロキシ)\]**​ タブ、​**\[Security (セキュリティ)\]**​ タブ、​**\[Advanced (詳細)\]**​ タブをデフォルトのエントリのままにします。 8. **\[Test Connection (接続をテスト)\]**​ をクリックして、グローバル設定のパラメーターが正しいことと、Mule から Amazon SNS のインスタンスに正常に接続できることを確認します。 9. **\[OK\]**​ をクリックします。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.5 コネクタの例 コネクタの一般的なユースケースを次に挙げます。 - SNS メッセージを Amazon SQS キューに送信する - Amazon SNS メッセージを HTTP/HTTPS エンドポイントに送信する ## [](#amazon-sns-メッセージの-amazon-sqs-キューへの送信)Amazon SNS メッセージの Amazon SQS キューへの送信 Amazon SNS は、Amazon Simple Queue Service (Amazon SQS) と緊密に連携します。Amazon SNS と Amazon SQS を併用すれば、次のメッセージをアプリケーションに配信できます。 - イベントの迅速な通知が必要なメッセージ。 - 他のアプリケーションが後で処理するために Amazon SQS キューで保持されるメッセージ。 Amazon SQS キューを Amazon SNS トピックにサブスクライブするときに、メッセージをトピックにパブリッシュできます。Amazon SNS は、サブスクライブされたキューに Amazon SQS メッセージを送信します。 AWS マネジメントコンソールを使用して、Amazon SQS キューを Amazon SNS トピックにサブスクライブするプロセスを簡略化します。 ## [](#send-http)Amazon SNS メッセージの HTTP/HTTPS エンドポイントへの送信 Amazon SNS を使用して、通知メッセージを 1 つ以上の HTTP または HTTPS エンドポイントに送信できます。Amazon SNS トピックにエンドポイントをサブスクライブすると、トピックへの通知をパブリッシュできます。これにより、Amazon SNS はサブスクライブしたエンドポイントに通知の内容を配信する HTTP POST 要求を送信します。 ## [](#例-コネクタを使用して-sns-メッセージを-amazon-sqs-キューに送信)例: コネクタを使用して SNS メッセージを Amazon SQS キューに送信 次の図は、このユースケースのフロー例を示しています。 ![send-messages-to-SQS](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-use-case-flow.png) この例を試す前に、Anypoint Studio にアクセスし、\[Mule Palette (Mule パレット)\] に ​**Amazon SNS**​ と ​**Amazon SQS**​ のエントリが表示されていることを確認します。 表示されていない場合、​[「Exchange を使用した Studio でのコネクタのインストール」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-studio#install-connector)​の指示に従って両方のコネクタをインストールします。 コネクタを使用して Amazon SNS メッセージを Amazon SQS キューに送信する Mule アプリケーションを設定する手順は、次のとおりです。 1. Anypoint Studio で新しい Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で​**「HTTP」**​を検索し、​**Listener**​ 操作を選択します。 ![select-listener](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-select-listener.png) 3. **Listener**​ 操作をキャンバスにドラッグします。 4. **Listener**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 5. デフォルトを受け入れます。 6. **Listener**​ 設定の ​**\[General (一般)\]**​ タブで、​**\[Display Name (表示名)\]**​ 項目を ​`HTTP`​、​**\[Path (パス)\]**​ 項目を \`/'' に設定します。 ![http-properties](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-http-properties.png) 7. \[Mule Palette (Mule パレット)\] で​**「SNS」**​を検索し、​**Publish**​ 操作を選択します。 ![publish-selection](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-publish-selection.png) 8. **Publish**​ 操作を ​**HTTP Listener**​ コンポーネントの右にドラッグします。 9. **Publish**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 10. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

Name (名前)

設定の参照に使用される名前。

Amazon_SNS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列。

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン
次の画像は、Publish 操作のサンプルグローバル要素を示しています。 ![sns-global-configuration](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-global-config.png) 11. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 12. **\[Global Elements (グローバル要素)\]**​ タブをクリックします。 13. **\[Amazon SNS Configuration (Configuration) (Amazon SNS 設定 (設定))\]**​ を選択して、​**\[Edit (編集)\]**​ をクリックします。 14. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SNS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - そうでない場合は、見直して、誤ったパラメーターを修正してからもう一度テストします。 15. フローに戻って ​**\[Publish\]**​ を選択します。 16. 残りのパラメーターを設定します。
パラメーター 値

Display Name (表示名)

Publish​ または別の名前。

[Basic Settings (基本設定)] セクション

Connector configuration (コネクタ設定)

Amazon_SNS_configuration​ (作成したグローバル要素への参照名)

[General (一般)] セクション

Message (メッセージ)

`​Hello World!`

Subject (件名)

Testing publish to queue

Message structure (メッセージ構造)

JSON

Message attributes (メッセージ属性)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性

[Topic Properties (トピックプロパティ)] セクション

Topic arn (トピック ARN)

パブリッシュするトピックの Amazon リソース名 (ARN)

Target arn (対象 ARN)

パブリッシュするプラットフォームエンドポイントの Amazon リソース名 (ARN)
次の画像は、Publish Message 操作のサンプル設定を示しています。 ![sns-publish-message-props](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-publish-message.png) 17. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` `default`​ JSON キーは、SQS にとって特別な意味を持ちます。使用されるプロトコルに関係なく、キーの値はすべてのサブスクライバーにメッセージとして送信されます。Publish Message 操作でこのキーを指定する必要があります。必要に応じて、HTTP や SQS などの特定のトランスポートプロトコルに送信するメッセージを定義する他の最上位キーを指定できます。詳細は、Amazon Simple Notification Service ドキュメントの [「Publish」](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html#API_Publish_RequestParameters)​を参照してください。 ### [](#publish-操作によって処理されたデータの表示)Publish 操作によって処理されたデータの表示 同じ例を使用して、Mule コンソールで Publish 操作によって処理されたデータを表示する Logger コンポーネントを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Logger」**​コンポーネントを検索し、Amazon SNS Connector (​**Publish**​) の右にドラッグします。 2. **Logger**​ コンポーネントを次のように設定します。
パラメーター 値

Display Name (表示名)

Logger​ または別の名前

Message (メッセージ)

Message: #[payload]

Level (レベル)

INFO
![sns-logger](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-logger.png) ### [](#receive-sns)SNS メッセージの受信 同じ例を使用して、Amazon SQS が Amazon SNS によってパブリッシュされたメッセージを受信できるようにする 2 番目のフローを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Flow」**​を検索し、​**Flow**​ コンポーネントをキャンバスにドラッグします。 2. \[Mule Palette (Mule パレット)\] で、​**「SQS」**​を検索し、​**Receive messages**​ 操作を選択して ​**Flow**​ コンポーネントの左にドラッグします。 3. 新しいコンポーネントを選択します。 4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横のある ​**\[+\]**​ をクリックし、新しい Amazon SQS Connector グローバル要素を追加します。 5. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

Name (名前)

設定への参照に使用される名前。

Amazon_SQS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン

Test Queue ARN (キュー ARN をテスト)

接続をテストするために次のステップで使用されるキュー ARN。

テストキュー ARN の形式は ​arn:aws:sqs:region:account-id:queue-name​ です。
次の画像は、Receive messages 操作のサンプルグローバル要素を示しています。 ![sns-sqs-config](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-sqs-global-config.png) 6. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SQS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 8. Amazon SQS Connector のプロパティエディターで、残りのパラメーターを設定します。
パラメーター 値

[Basic Settings (基本設定)] セクション

Display Name (表示名)

Amazon SQS (Streaming)​ または別の名前

Connector configuration (コネクタ設定)*

Amazon_SQS_Configuration​ (作成したグローバル要素への参照名)

Queue url (キュー URL)

次の形式のキュー URL - ​https://sqs.region.amazonaws.com/account-id/queue-name

[General (一般)]​ グループの他の項目

デフォルト値
設定内の SQS キューが SNS トピックに​**サブスクライブ**​されていることを確認します。 次に例を示します。 ![sns-sqs-config](/mulesoft/current/ja-jp/amazon-sns-connector/4.5/_images/amazon-sns-sqs-config.png) 9. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 10. Amazon SQS Connector の後に ​**Logger**​ スコープを追加して、Mule コンソールの ​**Receive**​ 操作で渡されるデータを出力します。​**Logger**​ を次のように設定します。
パラメーター 値

Display Name (表示名)

Display Message​ または別の名前

Message (メッセージ)

Received Message: #[payload]

Level (レベル)

INFO
11. プロジェクトを保存します。 プロジェクトを Mule アプリケーションとして実行する手順は、次のとおりです。 1. Package Explorer でプロジェクトを右クリックし、​**\[Run As (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ を選択します。 2. Web ブラウザーを開き、URL ​`http://localhost:8081/`​ を入力して応答を確認します。 ロガーには、ブラウザーのパブリッシュされたメッセージ ID と、Mule コンソールの受信メッセージが表示されます。 ### [](#example-code)デモ Mule アプリケーションの XML コード このユースケース例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを XML エディターに貼り付けます。必要に応じて、環境に合わせて値を変更します。 ```xml ``` ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.5 の XML と Maven のサポート (Studio XML エディターまたはテキストエディターから) XML で Mule アプリケーションを手動でコーディングする場合、次のアクションを実行してコネクタへのアクセス権を取得する必要があります。 1. コネクタの名前空間を XML フローに追加する。 2. 連動関係情報を Apache Maven ​`pom.xml`​ ファイルに追加する。 Studio ビジュアルエディターでパレットからキャンバスにコネクタをドラッグすると、コネクタの名前空間とスキーマの場所が自動的に XML コードに入力されます。 ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 次のコードを設定 XML のヘッダーの ​``​ タグ内に貼り付けます。 ```xml http://www.mulesoft.org/schema/mule/sns http://www.mulesoft.org/schema/mule/sns/current/mule-sns.xsd ``` 次の例は、​``​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。 ```xml ``` ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします。 ```xml com.mulesoft.connectors mule-amazon-sns-connector x.x.x mule-plugin ``` `x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得するには、​ [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ でコネクタにアクセスし、​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ## [](#次のステップ)次のステップ 名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.5 の追加設定情報 ## [](#iam-ユーザー権限)IAM ユーザー権限 AWS Identity and Access Management (IAM) ユーザーに Amazon SNS Connector を使用するには、そのユーザーが次の条件を満たしている必要があります。 - Amazon Security Token Service ​`AssumeRole`​ アクションを実行する権限を持つ特定のロールの信頼済みエンティティである。 - すべての SNS Connector の読み取り操作を実行するには、少なくとも ​`AmazonSNSReadOnlyAccess`​ ポリシーを用意する。 - すべての SNS Connector 操作を実行するには、​`AmazonSNSFullAccess`​ ポリシーを用意する。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.6 Connector の例 コネクタの一般的なユースケースを次に挙げます。 - SNS メッセージを Amazon SQS キューに送信する - Amazon SNS メッセージを HTTP/HTTPS エンドポイントに送信する ## [](#amazon-sns-メッセージの-amazon-sqs-キューへの送信)Amazon SNS メッセージの Amazon SQS キューへの送信 Amazon SNS は、Amazon Simple Queue Service (Amazon SQS) と緊密に連携します。Amazon SNS と Amazon SQS を併用すれば、次のメッセージをアプリケーションに配信できます。 - イベントの迅速な通知が必要なメッセージ。 - 他のアプリケーションが後で処理するために Amazon SQS キューで保持されるメッセージ。 Amazon SQS キューを Amazon SNS トピックにサブスクライブするときに、メッセージをトピックにパブリッシュできます。Amazon SNS は、サブスクライブされたキューに Amazon SQS メッセージを送信します。 AWS マネジメントコンソールを使用して、Amazon SQS キューを Amazon SNS トピックにサブスクライブするプロセスを簡略化します。 ## [](#send-http)Amazon SNS メッセージの HTTP/HTTPS エンドポイントへの送信 Amazon SNS を使用して、通知メッセージを 1 つ以上の HTTP または HTTPS エンドポイントに送信できます。Amazon SNS トピックにエンドポイントをサブスクライブすると、トピックへの通知をパブリッシュできます。これにより、Amazon SNS はサブスクライブしたエンドポイントに通知のコンテンツを配信する HTTP POST 要求を送信します。 ## [](#例-コネクタを使用して-sns-メッセージを-amazon-sqs-キューに送信)例: コネクタを使用して SNS メッセージを Amazon SQS キューに送信 次の図は、このユースケースのフロー例を示しています。 ![send-messages-to-SQS](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-use-case-flow.png) この例を試す前に、Anypoint Studio にアクセスし、\[Mule Palette (Mule パレット)\] に ​**Amazon SNS**​ と ​**Amazon SQS**​ のエントリが表示されていることを確認します。 表示されていない場合、​[「Exchange を使用した Studio でのコネクタのインストール」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-studio#install-connector)​の指示に従って両方のコネクタをインストールします。 コネクタを使用して Amazon SNS メッセージを Amazon SQS キューに送信する Mule アプリケーションを設定する手順は、次のとおりです。 1. Anypoint Studio で新しい Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で​**「HTTP」**​を検索し、​**Listener**​ 操作を選択します。 ![select-listener](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-select-listener.png) 3. **Listener**​ 操作をキャンバスにドラッグします。 4. **Listener**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 5. デフォルトを受け入れます。 6. **Listener**​ 設定の ​**\[General (一般)\]**​ タブで、​**\[Display Name (表示名)\]**​ 項目を ​`HTTP`​、​**\[Path (パス)\]**​ 項目を \`/'' に設定します。 ![http-properties](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-http-properties.png) 7. \[Mule Palette (Mule パレット)\] で​**「SNS」**​を検索し、​**Publish**​ 操作を選択します。 ![publish-selection](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-publish-selection.png) 8. **Publish**​ 操作を ​**HTTP Listener**​ コンポーネントの右にドラッグします。 9. **Publish**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 10. 次のようにグローバル要素を設定します。
パラメーター 説明 値

Name (名前)

設定の参照に使用される名前。

Amazon_SNS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列。

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン
次の画像は、Publish 操作のサンプルグローバル要素を示しています。 ![sns-global-configuration](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-global-config.png) 11. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 12. **\[Global Elements (グローバル要素)\]**​ タブをクリックします。 13. **\[Amazon SNS Configuration (Configuration) (Amazon SNS 設定 (設定))\]**​ を選択して、​**\[Edit (編集)\]**​ をクリックします。 14. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SNS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - そうでない場合は、見直して、誤ったパラメーターを修正してからもう一度テストします。 15. フローに戻って ​**\[Publish\]**​ を選択します。 16. 残りのパラメーターを設定します。
パラメーター 値

Display Name (表示名)

Publish​ または別の名前。

[Basic Settings (基本設定)] セクション

Connector configuration (コネクタ設定)

Amazon_SNS_configuration​ (作成したグローバル要素への参照名)

[General (一般)] セクション

Message (メッセージ)

`​Hello World!`

Subject (件名)

Testing publish to queue

Message structure (メッセージ構造)

JSON

Message attributes (メッセージ属性)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性。

[Target Platform (対象プラットフォーム)] セクション

Topic arn (トピック ARN)

パブリッシュするトピックの Amazon リソース名 (ARN)。

Target arn (対象 ARN)

パブリッシュするプラットフォームエンドポイントの Amazon リソース名 (ARN)。

Phone number (電話番号)

パブリッシュ先のデバイスの電話番号。
次の画像は、Publish Message 操作のサンプル設定を示しています。 ![sns-publish-message-props](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-publish-message.png) 17. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` `default`​ JSON キーは、SNS にとって特別な意味を持ちます。使用されるプロトコルに関係なく、キーの値はすべてのサブスクライバーにメッセージとして送信されます。Publish Message 操作でこのキーを指定する必要があります。必要に応じて、HTTP や SQS などの特定のトランスポートプロトコルに送信するメッセージを定義する他の最上位キーを指定できます。詳細は、Amazon Simple Notification Service ドキュメントの [「Publish」](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html#API_Publish_RequestParameters)​を参照してください。 ### [](#publish-操作によって処理されたデータの表示)Publish 操作によって処理されたデータの表示 同じ例を使用して、Mule コンソールで Publish 操作によって処理されたデータを表示する Logger コンポーネントを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Logger」**​コンポーネントを検索し、Amazon SNS Connector (​**Publish**​) の右にドラッグします。 2. **Logger**​ コンポーネントを次のように設定します。
パラメーター 値

Display Name (表示名)

Logger​ または別の名前

Message (メッセージ)

Message: #[payload]

Level (レベル)

INFO
![sns-logger](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-logger.png) ### [](#receive-sns)SNS メッセージの受信 同じ例を使用して、Amazon SQS が Amazon SNS によってパブリッシュされたメッセージを受信できるようにする 2 番目のフローを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Flow」**​を検索し、​**Flow**​ コンポーネントをキャンバスにドラッグします。 2. \[Mule Palette (Mule パレット)\] で、​**「SQS」**​を検索し、​**Receive messages**​ 操作を選択して ​**Flow**​ コンポーネントの左にドラッグします。 3. 新しいコンポーネントを選択します。 4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横のある ​**\[+\]**​ をクリックし、新しい Amazon SQS Connector グローバル要素を追加します。 5. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

名前

設定への参照に使用される名前。

Amazon_SQS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン

Test Queue ARN (キュー ARN をテスト)

接続をテストするために次のステップで使用されるキュー ARN。

テストキュー ARN の形式は ​arn:aws:sqs:region:account-id:queue-name​ です。
次の画像は、Receive messages 操作のサンプルグローバル要素を示しています。 ![sns-sqs-config](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-sqs-global-config.png) 6. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SQS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 8. Amazon SQS Connector のプロパティエディターで、残りのパラメーターを設定します。
パラメーター 値

[Basic Settings (基本設定)] セクション

Display Name (表示名)

Amazon SQS (Streaming)​ または別の名前

Connector configuration (コネクタ設定)*

Amazon_SQS_Configuration​ (作成したグローバル要素への参照名)

Queue url (キュー URL)

次の形式のキュー URL - ​https://sqs.region.amazonaws.com/account-id/queue-name

[General (一般)]​ グループの他の項目

デフォルト値
設定内の SQS キューが SNS トピックに​**サブスクライブ**​されていることを確認します。 次に例を示します。 ![sns-sqs-config](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-sqs-config.png) 9. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 10. Amazon SQS Connector の後に ​**Logger**​ スコープを追加して、Mule コンソールの ​**Receive**​ 操作で渡されるデータを出力します。​**Logger**​ を次のように設定します。
パラメーター 値

Display Name (表示名)

Display Message​ または別の名前

Message (メッセージ)

Received Message: #[payload]

Level (レベル)

INFO
11. プロジェクトを保存します。 プロジェクトを Mule アプリケーションとして実行する手順は、次のとおりです。 1. Package Explorer でプロジェクトを右クリックし、​**\[Run As (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ を選択します。 2. Web ブラウザーを開き、URL ​`http://localhost:8081/`​ を入力して応答を確認します。 ロガーには、ブラウザーのパブリッシュされたメッセージ ID と、Mule コンソールの受信メッセージが表示されます。 ### [](#example-code)デモ Mule アプリケーションの XML コード このユースケース例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを XML エディターに貼り付けます。必要に応じて、環境に合わせて値を変更します。 ```xml ``` ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.6 Connector リファレンス リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4) ## [](#設定)設定 * * * ### [](#config)デフォルト設定 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Globally Defined Default Topic ARN (グローバルに定義されるデフォルトトピック ARN)。

String (文字列)

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。インスタンスが期限切れとみなされた瞬間にインスタンスが期限切れになるという意味ではありません。必要に応じて、インスタンスがパージされます。
#### [](#接続種別)接続種別 ##### [](#config_basic)Basic (基本) ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (トピックをテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
##### [](#config_role)Role (ロール) ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Role ARN (ロール ARN)

String (文字列)

ロール ARN は、クロスアカウントアクセスを取得することを前提とするロールを一意に特定します。

x

Custom STS Endpoint (カスタム STS エンドポイント)

String (文字列)

カスタム STS エンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。

Test Topic ARN (トピック ARN をテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
## [](#操作)操作 - [Add Permission](#addPermission) - [Confirm Subscription](#confirmSubscription) - [Create Platform Application](#createPlatformApplication) - [Create Platform Endpoint](#createPlatformEndpoint) - [Create Topic](#createTopic) - [Delete Endpoint](#deleteEndpoint) - [Delete Platform Application](#deletePlatformApplication) - [Delete Topic](#deleteTopic) - [Get Endpoint Attributes](#getEndpointAttributes) - [Get Platform Application Attributes](#getPlatformApplicationAttributes) - [Get Subscription Attributes](#getSubscriptionAttributes) - [Get Topic Attributes](#getTopicAttributes) - [List Endpoints By Platform Application](#listEndpointsByPlatformApplication) - [List Platform Applications](#listPlatformApplications) - [List Subscriptions](#listSubscriptions) - [List Subscriptions By Topic](#listSubscriptionsByTopic) - [List Topics](#listTopics) - [Publish](#publish) - [Remove Permission](#removePermission) - [Set Endpoint Attributes](#setEndpointAttributes) - [Set Platform Application Attributes](#setPlatformApplicationAttributes) - [Set Subscription Attributes](#setSubscriptionAttributes) - [Set Topic Attributes](#setTopicAttributes) - [Subscribe](#subscribe) - [Unsubscribe](#unsubscribe) ### [](#addPermission)Add Permission ​`` ステートメントをトピックのアクセス制御ポリシーに追加し、指定されたアクションへのアクセス権を指定の AWS アカウントに付与します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)​を参照してください。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

新しいポリシーステートメントの一意の識別子。

x

Account Ids (アカウント ID)

Array of String (文字列の配列)

指定されたアクションへのアクセス権を付与するユーザー (プリンシパル) の AWS アカウント ID。ユーザーには AWS アカウントが必要ですが、このサービスにサインアップする必要はありません。

x

Action Names (アクション名)

Array of String (文字列の配列)

指定されたプリンシパルに許可するアクション。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力)出力

型

String (文字列)
### [](#次の設定の場合)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#confirmSubscription)Confirm Subscription ​`` confirmSubscription アクションは、以前の Subscribe アクションでエンドポイントに送信されたトークンを検証して、エンドポイントのオーナーにメッセージを受信する意思があるかどうかを確認します。トークンが有効な場合、このアクションは新しいサブスクリプションを作成し、その Amazon リソース名 (ARN) を返します。AuthenticateOnUnsubscribe フラグが ​`true`​ に設定されている場合にのみ、このコールで AWS 署名が必要になります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)​を参照してください。 #### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクリプションを確認するトピックの ARN。

x

Token (トークン)

String (文字列)

Subscribe​ アクション中にエンドポイントに送信される有効期間の短いトークン。

x

Authenticate On Unsubscribe (サブスクライブ解除時に認証)

String (文字列)

サブスクリプションの未認証のサブスクライブ解除を許可しません。このパラメーターの値が ​true​ で、要求に AWS 署名が含まれている場合、トピックのオーナーとサブスクリプションのオーナーのみがエンドポイントをサブスクライブ解除できます。unsubscribe アクションでは、AWS 認証が必要です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-2)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-2)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-2)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformApplication)Create Platform Application ​`` デバイスやモバイルアプリケーションを登録できるいずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを作成します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)​を参照してください。 #### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

アプリケーション名は、大文字と小文字の ASCII 文字、数値、アンダースコア、ハイフン、ピリオドで構成されている必要があり、1 ～ 256 文字にする必要があります。

x

プラットフォーム

String (文字列)

ADM (Amazon Device Messaging)、APNS (Apple Push Notification Service)、​APNS_SANDBOX​、GCM (Google Cloud Messaging) のプラットフォームがサポートされています。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-3)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-3)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-3)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformEndpoint)Create Platform Endpoint ​`` いずれかのサポート対象プッシュ通知サービスのデバイスやモバイルアプリケーションのエンドポイントを作成します。CreatePlatformEndpoint では、CreatePlatformApplication から返される PlatformApplicationArn が必要です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)​を参照してください。 #### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

CreatePlatformApplication から返される PlatformApplicationArn は、エンドポイントを作成するために使用されます。

x

Token (トークン)

String (文字列)

デバイスのアプリケーションの通知サービスによって作成される一意の識別子。トークンの特定の名前は、使用されている通知サービスによって異なります。たとえば、通知サービスとして APNS (Apple Push Notification Service) を使用する場合、デバイストークンが必要です。GCM (Google Cloud Messaging) または ADM (Amazon Device Messaging) を使用する場合、登録 ID がデバイストークンに相当します。

x

Custom User Data (カスタムユーザーデータ)

String (文字列)

エンドポイントに関連付ける任意のユーザーデータ。Amazon SNS はこのデータを使用しません。データは UTF-8 形式で 2KB 未満にする必要があります。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-4)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-4)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-4)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createTopic)Create Topic ​`` CreateTopic アクションは、通知をパブリッシュできるトピックを作成します。ユーザーは、最大 100 件のトピックを作成できます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)​を参照してください。 #### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Name (トピック名)

String (文字列)

作成するトピックの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-5)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-5)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-5)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteEndpoint)Delete Endpoint ​`` Amazon SNS からデバイスやモバイルアプリケーションのエンドポイントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)​を参照してください。 #### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

削除するエンドポイントの EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-6)出力

型

String (文字列)
### [](#次の設定の場合-6)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-6)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deletePlatformApplication)Delete Platform Application ​`` いずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)​を参照してください。 #### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

削除するプラットフォームアプリケーションオブジェクトの PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-7)出力

型

String (文字列)
### [](#次の設定の場合-7)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-7)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteTopic)Delete Topic ​`` DeleteTopic アクションは、トピックとそのすべてのサブスクリプションを削除します。トピックを削除すると、以前にトピックに送信された一部のメッセージがサブスクライバーに配信されなくなる可能性があります。このアクションは羃等であるため、存在しないトピックを削除しても、エラーにはなりません。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)​を参照してください。 #### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

削除するトピックの ARN。

x

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
### [](#次の設定の場合-8)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-8)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getEndpointAttributes)Get Endpoint Attributes ​`` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

GetEndpointAttributes 入力の EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-9)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-9)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getPlatformApplicationAttributes)Get Platform Application Attributes ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

GetPlatformApplicationAttributesInput の PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-9)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-10)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-10)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getSubscriptionAttributes)Get Subscription Attributes ​`` GetSubscriptionAttributes アクションは、サブスクリプションのすべてのプロパティを返します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

取得するプロパティのサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-10)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-11)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-11)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getTopicAttributes)Get Topic Attributes ​`` GetTopicAttributes アクションは、トピックのすべてのプロパティを返します。返されるトピックプロパティは、ユーザーの認証によって異なる可能性があります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-15)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

取得するプロパティのトピックの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-11)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-12)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-12)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#listEndpointsByPlatformApplication)List Endpoints By Platform Application ​`` サポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイントとエンドポイント属性をリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)​を参照してください。 #### [](#パラメーター-16)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

プラットフォームアプリケーションの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-12)出力

型

[​エンドポイント​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-13)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-13)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listPlatformApplications)List Platform Applications ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトをリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)​を参照してください。 #### [](#パラメーター-17)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-13)出力

型

[​Platform Application (プラットフォームアプリケーション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-14)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-14)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptions)List Subscriptions ​`` ListSubscriptions アクションは、リクエスターのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい ListSubscriptions コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)​を参照してください。 #### [](#パラメーター-18)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-14)出力

型

[​Subscription (サブスクリプション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-15)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-15)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptionsByTopic)List Subscriptions By Topic ​`` SubscriptionsByTopic アクションは、特定のトピックへのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい SubscriptionsByTopic コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)​を参照してください。 #### [](#パラメーター-19)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

トピックの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-15)出力

型

[​Subscription (サブスクリプション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-16)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-16)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listTopics)List Topics ​`` ListTopics アクションは、要求者のトピックのリストを返します。各コールは、最大 100 件に制限されたトピックのリストを返します。それ以上のトピックがある場合、NextToken も返されます。新しい ListTopics コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)​を参照してください。 #### [](#パラメーター-20)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-16)出力

型

[String] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-17)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-17)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#publish)Publish ​`` Publish アクションは、メッセージをすべてのトピックのサブスクライブされたエンドポイントに送信します。返された messageId はメッセージが保存されていることを示し、Amazon SNS はすぐにそのメッセージをトピックのサブスクライバーに配信しようとします。サブスクライブされた各エンドポイントへの送信メッセージの形式は、選択した通知プロトコルによって異なります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Publish.html)​を参照してください。 #### [](#パラメーター-21)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Message (メッセージ)

String (文字列)

トピックに送信するメッセージ。

#[payload]

Subject (件名)

String (文字列)

メッセージがメールエンドポイントに配信されるときの「件名」行として使用されるパラメーター (省略可能)。この項目は、他のエンドポイントに配信される標準 JSON メッセージにも含まれます (存在する場合)。

Message Structure (メッセージ構造)

String (文字列)

プロトコルごとに異なるメッセージを送信する場合、MessageStructure を ​json​ に設定します。

Message Attributes (メッセージ属性)

Object (オブジェクト)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性。

Topic Arn (トピック ARN)

String (文字列)

パブリッシュするトピックの Amazon リソース名 (ARN)。この項目と [Target Arn (対象 ARN)] 項目は相互に排他的です。

Target Arn (対象 ARN)

String (文字列)

パブリッシュするプラットフォームエンドポイントの Amazon リソース名 (ARN)。この項目と [Topic Arn (トピック ARN)] 項目は相互に排他的です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-17)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-18)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-18)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#removePermission)Remove Permission ​`` RemovePermission アクションは、トピックのアクセス制御ポリシーからステートメントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)​を参照してください。 #### [](#パラメーター-22)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

削除するステートメントの一意の表示ラベル。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-18)出力

型

String (文字列)
### [](#次の設定の場合-19)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-19)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setEndpointAttributes)Set Endpoint Attributes ​`` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-23)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

エンドポイント

[Endpoint (エンドポイント)]

SetEndpointAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-19)出力

型

String (文字列)
### [](#次の設定の場合-20)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-20)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setPlatformApplicationAttributes)Set Platform Application Attributes ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-24)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Attributes (プラットフォームアプリケーション属性)

Platform Application (プラットフォームアプリケーション)

SetPlatformApplicationAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-20)出力

型

String (文字列)
### [](#次の設定の場合-21)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-21)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setSubscriptionAttributes)Set Subscription Attributes ​`` SubscriptionAttributes アクションは、サブスクリプションのオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-25)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

サブスクリプションの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-21)出力

型

String (文字列)
### [](#次の設定の場合-22)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-22)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setTopicAttributes)Set Topic Attributes ​`` TopicAttributes アクションは、トピックオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-26)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

トピックの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-22)出力

型

String (文字列)
### [](#次の設定の場合-23)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-23)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#subscribe)Subscribe ​`` Subscribe アクションは、エンドポイントに確認メッセージを送信してエンドポイントをサブスクライブする準備をします。実際にサブスクリプションを作成するには、エンドポイントのオーナーは確認メッセージのトークンを使用して confirmSubscription アクションをコールする必要があります。確認トークンは 3 日間有効です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)​を参照してください。 #### [](#パラメーター-27)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクライブするトピックの ARN。

x

Protocol (プロトコル)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

  • EMAIL

  • EMAIL_JSON​

  • SMS

  • SQS

  • APPLICATION

  • LAMBDA

使用するプロトコル。

x

エンドポイント

String (文字列)

通知を受信するエンドポイント。エンドポイントはプロトコルによって異なります。

  • HTTP - エンドポイントは ​http://​ で始まる URL になります。

  • HTTPS - エンドポイントは ​https://​ で始まる URL になります。

  • EMAIL - エンドポイントはメールアドレスになります。

  • EMAIL_JSON​ - エンドポイントはメールアドレスになります。

  • SMS - エンドポイントは SMS 対応デバイスの電話番号になります。

  • SQS - エンドポイントは Amazon SQS キューの ARN になります。

  • APPLICATION - エンドポイントはモバイルアプリケーションやデバイスのエンドポイントになります。

  • LAMBDA - エンドポイントは AWS Lambda 関数の ARN になります。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-23)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-24)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-24)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#unsubscribe)Unsubscribe ​`` Unsubscribe アクションは、サブスクリプションを削除します。サブスクリプションで削除の認証が必要な場合、サブスクリプションのオーナーまたはトピックのオーナーのみがサブスクライブ解除でき、AWS 署名が必要になります。Unsubscribe コールで認証が必要なく、リクエスターがサブスクリプションのオーナーでない場合、最終キャンセルメッセージがエンドポイントに配信されるため、Unsubscribe 要求が意図したものでなかった場合にエンドポイントのオーナーは簡単にトピックに再サブスクライブできます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)​を参照してください。 #### [](#パラメーター-28)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

削除するサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-24)出力

型

String (文字列)
### [](#次の設定の場合-25)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-25)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ## [](#型)型 ### [](#Tls)TLS
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

トラストストア

サーバーの場合、トラストストアには信頼済みのクライアントの証明書が格納されています。クライアントの場合、トラストストアには信頼済みサーバーの証明書が格納されています。

Key Store (キーストア)

Key Store (キーストア)

サーバーの場合、キーストアにはサーバーの非公開キーと公開キーが格納されています。クライアントの場合、キーストアにはクライアントの非公開キーと公開キーが格納されています。

Revocation Check (取り消し確認)

証明書が失効したことを検証します。
### [](#TrustStore)トラストストア
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。
### [](#KeyStore)Key Store (キーストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、ファイルにある最初のキーがデフォルトで使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。
### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。
### [](#custom-ocsp-responder)Custom OCSP Responder (カスタム OCSP レスポンダー)
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。
### [](#crl-file)CRL File (CRL ファイル)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。
### [](#Reconnection)Reconnection (再接続)
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。
### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続を試みる回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

unsubscribe
### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位
### [](#RequestIDAttribute)Request ID Attribute (要求 ID 属性)
項目 型 説明 デフォルト値 必須

Request Id (要求 ID)

String (文字列)
### [](#Endpoint)エンドポイント
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Endpoint Arn (エンドポイント ARN)

String (文字列)
### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームを使用し、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。
### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大数。これ以上の量が必要な場合、ディスク上の内容がバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位
### [](#PlatformApplication)Platform Application (プラットフォームアプリケーション)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)
### [](#Subscription)Subscription (サブスクリプション)
項目 型 説明 デフォルト値 必須

エンドポイント

String (文字列)

Owner (オーナー)

String (文字列)

Protocol (プロトコル)

String (文字列)

Subscription Arn (サブスクリプション ARN)

String (文字列)

Topic Arn (トピック ARN)

String (文字列)
## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.6 Studio 設定 Anypoint Studio で Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) をインストールおよび設定する手順は、次のとおりです。 1. コネクタをインストールします。 2. コネクタの入力元を設定します。 3. コネクタを設定します。 ## [](#install-connector)Exchange を使用した Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの Exchange ​**(X)**​ アイコンをクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で、​**「Amazon SNS Connector」**​を検索します。 5. **\[Amazon SNS Connector\]**​ を選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ## [](#studio-でのコネクタのインストール)Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 3. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目にコネクタの名前を入力します。 4. **\[Available modules (使用可能なモジュール)\]**​ で、そのコネクタ名をクリックします。 5. **\[Add (追加)\]**​ をクリックします。 6. **\[Finish (完了)\]**​ をクリックします。 ## [](#入力元の設定)入力元の設定 **HTTP リスナー**​や​**スケジューラー**​などのコネクタの入力元を設定します。 ## [](#コネクタの設定)コネクタの設定 Mule アプリケーションで Amazon SNS Connector を使用するには、アプリケーションのすべての Amazon SNS Connector で使用できるグローバル Amazon SNS 要素を設定します。 1. コネクタの操作を Studio キャンバスにドラッグします。 2. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 3. **\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウで、​**\[Connector Configuration (コネクタ設定)\]**​ を展開し、​**\[Amazon SNS Configuration (Amazon SNS 設定)\]**​ をクリックします。 ![「Global Element Configuration (グローバル要素設定)」 ウィザード](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-config-global-wizard.png) 4. **\[OK\]**​ をクリックします。 5. グローバル要素のプロパティを指定します。 ![「Global Element Properties (グローバル要素のプロパティ)」](/mulesoft/current/ja-jp/amazon-sns-connector/4.6/_images/amazon-sns-global-config.png) 6. パラメーターを次のように設定します。
パラメーター 説明

Name (名前)

設定が参照される名前。

Session Token (セッショントークン)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (テストトピック)

接続のテストに使用するトピック。

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

一時的なログイン情報を使用するかどうかを制御するチェックボックス。

Region Endpoint (リージョンエンドポイント)

トピックリージョンエンドポイント。

Globally Defined Default Topic Arn (グローバルに定義されるデフォルトトピック ARN)

接続性をテストするトピック ARN。
7. **\[Proxy (プロキシ)\]**​ タブ、​**\[Security (セキュリティ)\]**​ タブ、​**\[Advanced (詳細)\]**​ タブをデフォルトのエントリのままにします。 8. **\[Test Connection (接続をテスト)\]**​ をクリックして、グローバル設定のパラメーターが正しいことと、Mule から Amazon SNS のインスタンスに正常に接続できることを確認します。 9. **\[OK\]**​ をクリックします。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.6 の XML と Maven のサポート (Studio XML エディターまたはテキストエディターから) XML で Mule アプリケーションを手動でコーディングする場合、次のアクションを実行してコネクタへのアクセス権を取得する必要があります。 1. コネクタの名前空間を XML フローに追加する。 2. 連動関係情報を Apache Maven ​`pom.xml`​ ファイルに追加する。 Studio ビジュアルエディターでパレットからキャンバスにコネクタをドラッグすると、コネクタの名前空間とスキーマの場所が自動的に XML コードに入力されます。 ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 次のコードを設定 XML のヘッダーの ​``​ タグ内に貼り付けます。 ```xml http://www.mulesoft.org/schema/mule/sns http://www.mulesoft.org/schema/mule/sns/current/mule-sns.xsd ``` 次の例は、​``​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。 ```xml ``` ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします。 ```xml com.mulesoft.connectors mule-amazon-sns-connector x.x.x mule-plugin ``` `x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得するには、​ [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ でコネクタにアクセスし、​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ## [](#次のステップ)次のステップ 名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.6 の追加設定情報 ## [](#iam-ユーザー権限)IAM ユーザー権限 AWS Identity and Access Management (IAM) ユーザーに Amazon SNS Connector を使用するには、そのユーザーが次の条件を満たしている必要があります。 - Amazon Security Token Service ​`AssumeRole`​ アクションを実行する権限を持つ特定のロールの信頼済みエンティティである。 - すべての SNS Connector の読み取り操作を実行するには、少なくとも ​`AmazonSNSReadOnlyAccess`​ ポリシーを用意する。 - すべての SNS Connector 操作を実行するには、​`AmazonSNSFullAccess`​ ポリシーを用意する。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.7 Connector の例 コネクタの一般的なユースケースを次に挙げます。 - SNS メッセージを Amazon SQS キューに送信する - Amazon SNS メッセージを HTTP/HTTPS エンドポイントに送信する ## [](#amazon-sns-メッセージの-amazon-sqs-キューへの送信)Amazon SNS メッセージの Amazon SQS キューへの送信 Amazon SNS は、Amazon Simple Queue Service (Amazon SQS) と緊密に連携します。Amazon SNS と Amazon SQS を併用すれば、次のメッセージをアプリケーションに配信できます。 - イベントの迅速な通知が必要なメッセージ。 - 他のアプリケーションが後で処理するために Amazon SQS キューで保持されるメッセージ。 Amazon SQS キューを Amazon SNS トピックにサブスクライブするときに、メッセージをトピックにパブリッシュできます。Amazon SNS は、サブスクライブされたキューに Amazon SQS メッセージを送信します。 AWS マネジメントコンソールを使用して、Amazon SQS キューを Amazon SNS トピックにサブスクライブするプロセスを簡略化します。 ## [](#send-http)Amazon SNS メッセージの HTTP/HTTPS エンドポイントへの送信 Amazon SNS を使用して、通知メッセージを 1 つ以上の HTTP または HTTPS エンドポイントに送信できます。Amazon SNS トピックにエンドポイントをサブスクライブすると、トピックへの通知をパブリッシュできます。これにより、Amazon SNS はサブスクライブしたエンドポイントに通知のコンテンツを配信する HTTP POST 要求を送信します。 ## [](#例-コネクタを使用して-sns-メッセージを-amazon-sqs-キューに送信)例: コネクタを使用して SNS メッセージを Amazon SQS キューに送信 次の図は、このユースケースのフロー例を示しています。 ![メッセージを-SQS に送信](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-use-case-flow.png) この例を試す前に、Anypoint Studio にアクセスし、\[Mule Palette (Mule パレット)\] に ​**Amazon SNS**​ と ​**Amazon SQS**​ のエントリが表示されていることを確認します。 表示されていない場合、​[「Exchange を使用した Studio でのコネクタのインストール」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.7/amazon-sns-connector-studio#install-connector)​の指示に従って両方のコネクタをインストールします。 コネクタを使用して Amazon SNS メッセージを Amazon SQS キューに送信する Mule アプリケーションを設定する手順は、次のとおりです。 1. Anypoint Studio で新しい Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で​**「HTTP」**​を検索し、​**Listener**​ 操作を選択します。 ![Listener を選択](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-select-listener.png) 3. **Listener**​ 操作をキャンバスにドラッグします。 4. **Listener**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 5. デフォルトを受け入れます。 6. **Listener**​ 設定の ​**\[General (一般)\]**​ タブで、​**\[Display Name (表示名)\]**​ 項目を ​`HTTP`​、​**\[Path (パス)\]**​ 項目を \`/'' に設定します。 ![HTTP プロパティ](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-http-properties.png) 7. \[Mule Palette (Mule パレット)\] で​**「SNS」**​を検索し、​**Publish**​ 操作を選択します。 ![Publish を選択](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-publish-selection.png) 8. **Publish**​ 操作を ​**HTTP Listener**​ コンポーネントの右にドラッグします。 9. **Publish**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 10. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

Name (名前)

設定の参照に使用される名前。

Amazon_SNS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列。

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン
次の画像は、Publish 操作のサンプルグローバル要素を示しています。 ![SNS グローバル設定](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-global-config.png) 11. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 12. **\[Global Elements (グローバル要素)\]**​ タブをクリックします。 13. **\[Amazon SNS Configuration (Configuration) (Amazon SNS 設定 (設定))\]**​ を選択して、​**\[Edit (編集)\]**​ をクリックします。 14. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SNS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - そうでない場合は、見直して、誤ったパラメーターを修正してからもう一度テストします。 15. フローに戻って ​**\[Publish\]**​ を選択します。 16. \[General (一般)\] タブで次のパラメーターを設定します。
パラメーター 値 説明

Display Name (表示名)

Publish

パブリッシュ操作の名前。

[Basic Settings (基本設定)] セクション

Connector configuration (コネクタ設定)

Amazon_SNS_configuration

作成したグローバル要素への参照名。

[Target Platform (対象プラットフォーム)] セクション

Topic arn (トピック ARN)

arn:aws:sns:us-east-1:123456789012:TopicName

パブリッシュするトピックの Amazon リソース名 (ARN)。

Target arn (対象 ARN)

パブリッシュするプラットフォームエンドポイントの Amazon リソース名 (ARN)。

Phone number (電話番号)

パブリッシュ先のデバイスの電話番号。

Message Parameters (メッセージパラメーター)

メッセージ

`​Hello World!`

メッセージ本文
次の画像は、Publish Message 操作のサンプル設定 (\[General (一般)\] タブ) を示しています。 ![SNS パブリッシュメッセージプロパティ](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-publish-message-general.png) 17. \[Advanced (詳細)\] タブで次のパラメーターを設定します。
パラメーター 値 説明

Message Parameters (メッセージパラメーター)

Subject (件名)

Testing publish to queue

メッセージがメールエンドポイントに配信されるときの件名行。

Message structure (メッセージ構造)

JSON

プロトコルごとに異なるメッセージ構造。

Message attributes (メッセージ属性)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性。

FIFO Parameters (FIFO パラメーター)

Message Group ID (メッセージグループ ID)

メッセージが特定のメッセージグループに属していることを指定するトークン。FIFO トピックにパブリッシュする場合、必須です。

Message Deduplication ID (メッセージ重複排除 ID)

FIFO トピックにパブリッシュする場合にメッセージの重複排除で使用するトークン。Amazon SNS で生成された値を上書きすることができます。コンテンツベースの重複排除が無効になっている場合、必須です。
次の画像は、Publish Message 操作のサンプル設定 (\[Advanced (詳細)\] タブ) を示しています。 ![SNS パブリッシュメッセージプロパティ](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-publish-message-advanced.png) 18. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` `default`​ JSON キーは、SNS にとって特別な意味を持ちます。使用されるプロトコルに関係なく、キーの値はすべてのサブスクライバーにメッセージとして送信されます。Publish Message 操作でこのキーを指定する必要があります。必要に応じて、HTTP や SQS などの特定のトランスポートプロトコルに送信するメッセージを定義する他の最上位キーを指定できます。詳細は、Amazon Simple Notification Service ドキュメントの [「Publish」](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html#API_Publish_RequestParameters)​を参照してください。 ### [](#publish-操作によって処理されたデータの表示)Publish 操作によって処理されたデータの表示 同じ例を使用して、Mule コンソールで Publish 操作によって処理されたデータを表示する Logger コンポーネントを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Logger」**​コンポーネントを検索し、Amazon SNS Connector (​**Publish**​) の右にドラッグします。 2. **Logger**​ コンポーネントを次のように設定します。
パラメーター 値

Display Name (表示名)

Logger​ または別の名前

メッセージ

Message: #[payload]

Level (レベル)

INFO
![SNS logger](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-logger.png) ### [](#receive-sns)SNS メッセージの受信 同じ例を使用して、Amazon SQS が Amazon SNS によってパブリッシュされたメッセージを受信できるようにする 2 番目のフローを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Flow」**​を検索し、​**Flow**​ コンポーネントをキャンバスにドラッグします。 2. \[Mule Palette (Mule パレット)\] で、​**「SQS」**​を検索し、​**Receive messages**​ 操作を選択して ​**Flow**​ コンポーネントの左にドラッグします。 3. 新しいコンポーネントを選択します。 4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横のある ​**\[+\]**​ をクリックし、新しい Amazon SQS Connector グローバル要素を追加します。 5. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

名前

設定への参照に使用される名前。

Amazon_SQS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン

Test Queue ARN (キュー ARN をテスト)

接続をテストするために次のステップで使用されるキュー ARN。

テストキュー ARN の形式は ​arn:aws:sqs:region:account-id:queue-name​ です。
次の画像は、Receive messages 操作のサンプルグローバル要素を示しています。 ![SNS SQS 設定](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-sqs-global-config.png) 6. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SQS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 8. Amazon SQS Connector のプロパティエディターで、残りのパラメーターを設定します。
パラメーター 値

[Basic Settings (基本設定)] セクション

Display Name (表示名)

Amazon SQS (Streaming)​ または別の名前

Connector configuration (コネクタ設定)*

Amazon_SQS_Configuration​ (作成したグローバル要素への参照名)

Queue url (キュー URL)

次の形式のキュー URL - ​https://sqs.region.amazonaws.com/account-id/queue-name

[General (一般)]​ グループの他の項目

デフォルト値
設定内の SQS キューが SNS トピックに​**サブスクライブ**​されていることを確認します。 例: ![SNS SQS 設定](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-sqs-config.png) 9. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 10. Amazon SQS Connector の後に ​**Logger**​ スコープを追加して、Mule コンソールの ​**Receive**​ 操作で渡されるデータを出力します。​**Logger**​ を次のように設定します。
パラメーター 値

Display Name (表示名)

Display Message​ または別の名前

Message (メッセージ)

Received Message: #[payload]

レベル

INFO
11. プロジェクトを保存します。 プロジェクトを Mule アプリケーションとして実行する手順は、次のとおりです。 1. Package Explorer でプロジェクトを右クリックし、​**\[Run As (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ を選択します。 2. Web ブラウザーを開き、URL ​`http://localhost:8081/`​ を入力して応答を確認します。 ロガーには、ブラウザーのパブリッシュされたメッセージ ID と、Mule コンソールの受信メッセージが表示されます。 ### [](#example-code)デモ Mule アプリケーションの XML コード このユースケース例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを XML エディターに貼り付けます。必要に応じて、環境に合わせて値を変更します。 ```xml ``` ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.7 Connector リファレンス リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4) ## [](#設定)設定 * * * ### [](#config)デフォルト設定 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Globally Defined Default Topic ARN (グローバルに定義されるデフォルトトピック ARN)。

String (文字列)

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。インスタンスが期限切れとみなされた瞬間にインスタンスが期限切れになるという意味ではありません。必要に応じて、インスタンスがパージされます。
#### [](#接続種別)接続種別 ##### [](#config_basic)Basic (基本) ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (トピックをテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
##### [](#config_role)Role (ロール) ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Role ARN (ロール ARN)

String (文字列)

ロール ARN は、クロスアカウントアクセスを取得することを前提とするロールを一意に特定します。

x

Custom STS Endpoint (カスタム SQS エンドポイント)

String (文字列)

カスタム STS エンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。

Test Topic ARN (トピック ARN をテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
## [](#操作)操作 - [Add Permission](#addPermission) - [Confirm Subscription](#confirmSubscription) - [Create Platform Application](#createPlatformApplication) - [Create Platform Endpoint](#createPlatformEndpoint) - [Create Topic](#createTopic) - [Delete Endpoint](#deleteEndpoint) - [Delete Platform Application](#deletePlatformApplication) - [Delete Topic](#deleteTopic) - [Get Endpoint Attributes](#getEndpointAttributes) - [Get Platform Application Attributes](#getPlatformApplicationAttributes) - [Get Subscription Attributes](#getSubscriptionAttributes) - [Get Topic Attributes](#getTopicAttributes) - [List Endpoints By Platform Application](#listEndpointsByPlatformApplication) - [List Platform Applications](#listPlatformApplications) - [List Subscriptions](#listSubscriptions) - [List Subscriptions By Topic](#listSubscriptionsByTopic) - [List Topics](#listTopics) - [Publish](#publish) - [Remove Permission](#removePermission) - [Set Endpoint Attributes](#setEndpointAttributes) - [Set Platform Application Attributes](#setPlatformApplicationAttributes) - [Set Subscription Attributes](#setSubscriptionAttributes) - [Set Topic Attributes](#setTopicAttributes) - [Subscribe](#subscribe) - [Unsubscribe](#unsubscribe) ### [](#addPermission)Add Permission ​`` ステートメントをトピックのアクセス制御ポリシーに追加し、指定されたアクションへのアクセス権を指定の AWS アカウントに付与します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)​を参照してください。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

新しいポリシーステートメントの一意の識別子。

x

Account Ids (アカウント ID)

Array of String (文字列の配列)

指定されたアクションへのアクセス権を付与するユーザー (プリンシパル) の AWS アカウント ID。ユーザーには AWS アカウントが必要ですが、このサービスにサインアップする必要はありません。

x

Action Names (アクション名)

Array of String (文字列の配列)

指定されたプリンシパルに許可するアクション。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力)出力

型

String (文字列)
### [](#次の設定の場合)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#confirmSubscription)Confirm Subscription ​`` confirmSubscription アクションは、以前の Subscribe アクションでエンドポイントに送信されたトークンを検証して、エンドポイントのオーナーにメッセージを受信する意思があるかどうかを確認します。トークンが有効な場合、このアクションは新しいサブスクリプションを作成し、その Amazon リソース名 (ARN) を返します。AuthenticateOnUnsubscribe フラグが ​`true`​ に設定されている場合にのみ、このコールで AWS 署名が必要になります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)​を参照してください。 #### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクリプションを確認するトピックの ARN。

x

Token (トークン)

String (文字列)

Subscribe​ アクション中にエンドポイントに送信される有効期間の短いトークン。

x

Authenticate On Unsubscribe (サブスクライブ解除時に認証)

String (文字列)

サブスクリプションの未認証のサブスクライブ解除を許可しません。このパラメーターの値が ​true​ で、要求に AWS 署名が含まれている場合、トピックのオーナーとサブスクリプションのオーナーのみがエンドポイントをサブスクライブ解除できます。unsubscribe アクションでは、AWS 認証が必要です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-2)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-2)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-2)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformApplication)Create Platform Application ​`` デバイスやモバイルアプリケーションを登録できるいずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを作成します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)​を参照してください。 #### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

アプリケーション名は、大文字と小文字の ASCII 文字、数値、アンダースコア、ハイフン、ピリオドで構成されている必要があり、1 ～ 256 文字にする必要があります。

x

プラットフォーム

String (文字列)

ADM (Amazon Device Messaging)、APNS (Apple Push Notification Service)、​APNS_SANDBOX​、GCM (Google Cloud Messaging) のプラットフォームがサポートされています。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-3)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-3)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-3)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformEndpoint)Create Platform Endpoint ​`` いずれかのサポート対象プッシュ通知サービスのデバイスやモバイルアプリケーションのエンドポイントを作成します。CreatePlatformEndpoint では、CreatePlatformApplication から返される PlatformApplicationArn が必要です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)​を参照してください。 #### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

CreatePlatformApplication から返される PlatformApplicationArn は、エンドポイントを作成するために使用されます。

x

Token (トークン)

String (文字列)

デバイスのアプリケーションの通知サービスによって作成される一意の識別子。トークンの特定の名前は、使用されている通知サービスによって異なります。たとえば、通知サービスとして APNS (Apple Push Notification Service) を使用する場合、デバイストークンが必要です。GCM (Google Cloud Messaging) または ADM (Amazon Device Messaging) を使用する場合、登録 ID がデバイストークンに相当します。

x

Custom User Data (カスタムユーザーデータ)

String (文字列)

エンドポイントに関連付ける任意のユーザーデータ。Amazon SNS はこのデータを使用しません。データは UTF-8 形式で 2KB 未満にする必要があります。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-4)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-4)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-4)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createTopic)Create Topic ​`` CreateTopic アクションは、通知をパブリッシュできるトピックを作成します。ユーザーは、最大 100 件のトピックを作成できます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)​を参照してください。 #### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Name (トピック名)

String (文字列)

トピックの名前。最大 256 文字。英数字、ハイフン、およびアンダースコアのみを含めることができます。FIFO トピック名は ​.fifo​ で終わる必要があります。

x

Content Based Deduplication (内容ベースの重複排除)

Boolean (ブール)

FIFO トピックの内容ベースの重複排除を有効にします。FIFO トピックを作成し、このパラメーターを ​false​ に設定する場合、​[Publish]​ 操作の ​[Message Deduplication Id (メッセージ重複排除 ID)]​ パラメーターの値を指定する必要があります。このパラメーターを ​true​ に設定すると、Amazon SNS は SHA-256 ハッシュを使用し、メッセージの本文 (メッセージの属性ではない) を使用してメッセージ重複排除 ID を生成します。

true

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-5)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-5)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-5)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteEndpoint)Delete Endpoint ​`` Amazon SNS からデバイスやモバイルアプリケーションのエンドポイントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)​を参照してください。 #### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

削除するエンドポイントの EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-6)出力

型

String (文字列)
### [](#次の設定の場合-6)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-6)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deletePlatformApplication)Delete Platform Application ​`` いずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)​を参照してください。 #### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

削除するプラットフォームアプリケーションオブジェクトの PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-7)出力

型

String (文字列)
### [](#次の設定の場合-7)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-7)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteTopic)Delete Topic ​`` DeleteTopic アクションは、トピックとそのすべてのサブスクリプションを削除します。トピックを削除すると、以前にトピックに送信された一部のメッセージがサブスクライバーに配信されなくなる可能性があります。このアクションは羃等であるため、存在しないトピックを削除しても、エラーにはなりません。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)​を参照してください。 #### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

削除するトピックの ARN。

x

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
### [](#次の設定の場合-8)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-8)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getEndpointAttributes)Get Endpoint Attributes ​`` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

GetEndpointAttributes 入力の EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-9)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-9)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getPlatformApplicationAttributes)Get Platform Application Attributes ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

GetPlatformApplicationAttributesInput の PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-9)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-10)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-10)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getSubscriptionAttributes)Get Subscription Attributes ​`` GetSubscriptionAttributes アクションは、サブスクリプションのすべてのプロパティを返します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

取得するプロパティのサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-10)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-11)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-11)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getTopicAttributes)Get Topic Attributes ​`` GetTopicAttributes アクションは、トピックのすべてのプロパティを返します。返されるトピックプロパティは、ユーザーの認証によって異なる可能性があります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-15)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

取得するプロパティのトピックの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-11)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-12)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-12)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#listEndpointsByPlatformApplication)List Endpoints By Platform Application ​`` サポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイントとエンドポイント属性をリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)​を参照してください。 #### [](#パラメーター-16)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

プラットフォームアプリケーションの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-12)出力

型

[​エンドポイント​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-13)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-13)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listPlatformApplications)List Platform Applications ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトをリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)​を参照してください。 #### [](#パラメーター-17)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-13)出力

型

[​Platform Application (プラットフォームアプリケーション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-14)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-14)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptions)List Subscriptions ​`` ListSubscriptions アクションは、リクエスターのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい ListSubscriptions コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)​を参照してください。 #### [](#パラメーター-18)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-14)出力

型

[​Subscription (サブスクリプション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-15)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-15)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptionsByTopic)List Subscriptions By Topic ​`` SubscriptionsByTopic アクションは、特定のトピックへのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい SubscriptionsByTopic コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)​を参照してください。 #### [](#パラメーター-19)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

トピックの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-15)出力

型

[​Subscription (サブスクリプション)​] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-16)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-16)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listTopics)List Topics ​`` ListTopics アクションは、リクエスターのトピックのリストを返します。各コールは、最大 100 件に制限されたトピックのリストを返します。それ以上のトピックがある場合、NextToken も返されます。新しい ListTopics コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)​を参照してください。 #### [](#パラメーター-20)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-16)出力

型

[String] ペイロードと [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-17)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-17)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#publish)Publish ​`` Publish アクションは、メッセージをすべてのトピックのサブスクライブされたエンドポイントに送信します。返された messageId はメッセージが保存されていることを示し、Amazon SNS はすぐにそのメッセージをトピックのサブスクライバーに配信しようとします。サブスクライブされた各エンドポイントへの送信メッセージの形式は、選択した通知プロトコルによって異なります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Publish.html)​を参照してください。 #### [](#パラメーター-21)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

FIFO パラメーター

FIFO パラメーター

FIFO トピックに関連するパラメーター。

Message (メッセージ)

String (文字列)

トピックに送信するメッセージ。

#[payload]

Subject (件名)

String (文字列)

メッセージがメールエンドポイントに配信されるときの「件名」行として使用されるパラメーター (省略可能)。この項目は、他のエンドポイントに配信される標準 JSON メッセージにも含まれます (存在する場合)。

Message Structure (メッセージ構造)

String (文字列)

プロトコルごとに異なるメッセージを送信する場合、MessageStructure を ​json​ に設定します。

Message Attributes (メッセージ属性)

Object (オブジェクト)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性。

Topic Arn (トピック ARN)

String (文字列)

パブリッシュするトピックの Amazon リソース名 (ARN)。この項目と [Target Arn (対象 ARN)] 項目は相互に排他的です。

Target Arn (対象 ARN)

String (文字列)

パブリッシュするプラットフォームエンドポイントの Amazon リソース名 (ARN)。この項目と [Topic Arn (トピック ARN)] 項目は相互に排他的です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-17)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-18)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-18)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#removePermission)Remove Permission ​`` RemovePermission アクションは、トピックのアクセス制御ポリシーからステートメントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)​を参照してください。 #### [](#パラメーター-22)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

削除するステートメントの一意の表示ラベル。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-18)出力

型

String (文字列)
### [](#次の設定の場合-19)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-19)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setEndpointAttributes)Set Endpoint Attributes ​`` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-23)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

エンドポイント

[Endpoint (エンドポイント)]

SetEndpointAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-19)出力

型

String (文字列)
### [](#次の設定の場合-20)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-20)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setPlatformApplicationAttributes)Set Platform Application Attributes ​`` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-24)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Attributes (プラットフォームアプリケーション属性)

Platform Application (プラットフォームアプリケーション)

SetPlatformApplicationAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-20)出力

型

String (文字列)
### [](#次の設定の場合-21)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-21)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setSubscriptionAttributes)Set Subscription Attributes ​`` SubscriptionAttributes アクションは、サブスクリプションのオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-25)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

サブスクリプションの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-21)出力

型

String (文字列)
### [](#次の設定の場合-22)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-22)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setTopicAttributes)Set Topic Attributes ​`` TopicAttributes アクションは、トピックオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-26)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

トピックの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-22)出力

型

String (文字列)
### [](#次の設定の場合-23)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-23)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#subscribe)Subscribe ​`` Subscribe アクションは、エンドポイントに確認メッセージを送信してエンドポイントをサブスクライブする準備をします。実際にサブスクリプションを作成するには、エンドポイントのオーナーは確認メッセージのトークンを使用して confirmSubscription アクションをコールする必要があります。確認トークンは 3 日間有効です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)​を参照してください。 #### [](#パラメーター-27)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクライブするトピックの ARN。

x

Protocol (プロトコル)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

  • EMAIL

  • EMAIL_JSON​

  • SMS

  • SQS

  • APPLICATION

  • LAMBDA

使用するプロトコル。これが FIFO トピックの場合、Amazon SQS FIFO キューのみをサブスクライバーとすることができます。

x

エンドポイント

String (文字列)

通知を受信するエンドポイント。エンドポイントはプロトコルによって異なります。

  • HTTP - エンドポイントは ​http://​ で始まる URL になります。

  • HTTPS - エンドポイントは ​https://​ で始まる URL になります。

  • EMAIL - エンドポイントはメールアドレスになります。

  • EMAIL_JSON​ - エンドポイントはメールアドレスになります。

  • SMS - エンドポイントは SMS 対応デバイスの電話番号になります。

  • SQS - エンドポイントは Amazon SQS キューの ARN になります。

  • APPLICATION - エンドポイントはモバイルアプリケーションやデバイスのエンドポイントになります。

  • LAMBDA - エンドポイントは AWS Lambda 関数の ARN になります。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-23)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-24)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-24)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#unsubscribe)Unsubscribe ​`` Unsubscribe アクションは、サブスクリプションを削除します。サブスクリプションで削除の認証が必要な場合、サブスクリプションのオーナーまたはトピックのオーナーのみがサブスクライブ解除でき、AWS 署名が必要になります。Unsubscribe コールで認証が必要なく、リクエスターがサブスクリプションのオーナーでない場合、最終キャンセルメッセージがエンドポイントに配信されるため、Unsubscribe 要求が意図したものでなかった場合にエンドポイントのオーナーは簡単にトピックに再サブスクライブできます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)​を参照してください。 #### [](#パラメーター-28)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

削除するサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-24)出力

型

String (文字列)
### [](#次の設定の場合-25)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-25)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ## [](#型)型 ### [](#Tls)TLS
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

トラストストア

サーバーの場合、トラストストアには信頼済みのクライアントの証明書が格納されています。クライアントの場合、トラストストアには信頼済みサーバーの証明書が格納されています。

Key Store (キーストア)

Key Store (キーストア)

サーバーの場合、キーストアにはサーバーの非公開キーと公開キーが格納されています。クライアントの場合、キーストアにはクライアントの非公開キーと公開キーが格納されています。

Revocation Check (取り消し確認)

証明書が失効したことを検証します。
### [](#TrustStore)トラストストア
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。
### [](#KeyStore)Key Store (キーストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、ファイルにある最初のキーがデフォルトで使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。
### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。
### [](#custom-ocsp-responder)Custom OCSP Responder (カスタム OCSP レスポンダー)
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。
### [](#crl-file)CRL File (CRL ファイル)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。
### [](#Reconnection)Reconnection (再接続)
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。
### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続を試みる回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

unsubscribe
### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位
### [](#RequestIDAttribute)Request ID Attribute (要求 ID 属性)
項目 型 説明 デフォルト値 必須

Request Id (要求 ID)

String (文字列)
### [](#Endpoint)エンドポイント
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Endpoint Arn (エンドポイント ARN)

String (文字列)
### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームを使用し、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。
### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大数。これ以上の量が必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位
### [](#PlatformApplication)Platform Application (プラットフォームアプリケーション)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)
### [](#Subscription)Subscription (サブスクリプション)
項目 型 説明 デフォルト値 必須

エンドポイント

String (文字列)

Owner (オーナー)

String (文字列)

Protocol (プロトコル)

String (文字列)

Subscription Arn (サブスクリプション ARN)

String (文字列)

Topic Arn (トピック ARN)

String (文字列)
### [](#FifoParameters)FIFO パラメーター
項目 型 説明 デフォルト値 必須

Message Group Id (メッセージグループ ID)

String (文字列)

メッセージが属している場所を指定するトークン。

x

Message Deduplication Id (メッセージ重複排除 ID)

String (文字列)

メッセージを重複排除するためのトークン。重複排除がトピックレベルで設定されていない場合、この ID は必須です。
## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.7 Studio 設定 Anypoint Studio で Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) をインストールおよび設定する手順は、次のとおりです。 1. コネクタをインストールします。 2. コネクタの入力元を設定します。 3. コネクタを設定します。 ## [](#install-connector)Exchange を使用した Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの Exchange ​**(X)**​ アイコンをクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で、​**「Amazon SNS Connector」**​を検索します。 5. **\[Amazon SNS Connector\]**​ を選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ## [](#studio-でのコネクタのインストール)Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 3. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目にコネクタの名前を入力します。 4. **\[Available modules (使用可能なモジュール)\]**​ で、そのコネクタ名をクリックします。 5. **\[Add (追加)\]**​ をクリックします。 6. **\[Finish (完了)\]**​ をクリックします。 ## [](#入力元の設定)入力元の設定 **HTTP リスナー**​や​**スケジューラー**​などのコネクタの入力元を設定します。 ## [](#コネクタの設定)コネクタの設定 Mule アプリケーションで Amazon SNS Connector を使用するには、アプリケーションのすべての Amazon SNS Connector で使用できるグローバル Amazon SNS 要素を設定します。 1. コネクタの操作を Studio キャンバスにドラッグします。 2. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 3. **\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウで、​**\[Connector Configuration (コネクタ設定)\]**​ を展開し、​**\[Amazon SNS Configuration (Amazon SNS 設定)\]**​ をクリックします。 ![グローバル要素設定ウィザード](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-config-global-wizard.png) 4. **\[OK\]**​ をクリックします。 5. グローバル要素のプロパティを指定します。 ![グローバル要素のプロパティ](/mulesoft/current/ja-jp/amazon-sns-connector/4.7/_images/amazon-sns-global-config.png) 6. パラメーターを次のように設定します。
パラメーター 説明

Name (名前)

設定が参照される名前。

Session Token (セッショントークン)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (テストトピック)

接続のテストに使用するトピック。

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

一時的なログイン情報を使用するかどうかを制御するチェックボックス。

Region Endpoint (リージョンエンドポイント)

トピックリージョンエンドポイント。

Globally Defined Default Topic Arn (グローバルに定義されるデフォルトトピック ARN)

接続性をテストするトピック ARN。
7. **\[Proxy (プロキシ)\]**​ タブ、​**\[Security (セキュリティ)\]**​ タブ、​**\[Advanced (詳細)\]**​ タブをデフォルトのエントリのままにします。 8. **\[Test Connection (接続をテスト)\]**​ をクリックして、グローバル設定のパラメーターが正しいことと、Mule から Amazon SNS のインスタンスに正常に接続できることを確認します。 9. **\[OK\]**​ をクリックします。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.7 の XML と Maven のサポート (Studio XML エディターまたはテキストエディターから) XML で Mule アプリケーションを手動でコーディングする場合、次のアクションを実行してコネクタへのアクセス権を取得する必要があります。 1. コネクタの名前空間を XML フローに追加する。 2. 連動関係情報を Apache Maven ​`pom.xml`​ ファイルに追加する。 Studio ビジュアルエディターでパレットからキャンバスにコネクタをドラッグすると、コネクタの名前空間とスキーマの場所が自動的に XML コードに入力されます。 ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 次のコードを設定 XML のヘッダーの ​``​ タグ内に貼り付けます。 ```xml http://www.mulesoft.org/schema/mule/sns http://www.mulesoft.org/schema/mule/sns/current/mule-sns.xsd ``` 次の例は、​``​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。 ```xml ``` ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします。 ```xml com.mulesoft.connectors mule-amazon-sns-connector x.x.x mule-plugin ``` `x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得するには、​ [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ でコネクタにアクセスし、​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ## [](#次のステップ)次のステップ 名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/amazon-sns-connector/4.7/amazon-sns-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS 4.7 の追加設定情報 ## [](#iam-ユーザー権限)IAM ユーザー権限 AWS Identity and Access Management (IAM) ユーザーに Amazon SNS Connector を使用するには、そのユーザーが次の条件を満たしている必要があります。 - Amazon Security Token Service ​`AssumeRole`​ アクションを実行する権限を持つ特定のロールの信頼済みエンティティである。 - すべての SNS Connector の読み取り操作を実行するには、少なくとも ​`AmazonSNSReadOnlyAccess`​ ポリシーを用意する。 - すべての SNS Connector 操作を実行するには、​`AmazonSNSFullAccess`​ ポリシーを用意する。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector - はじめに Amazon SNS Connector v4.4 Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) を使用すると、Amazon Simple Notification Service (Amazon SNS) API に接続できます。これにより、分散型 Web 対応アプリケーションをビルドできます。Mule アプリケーションは、Amazon SNS Connector を使用して、複数の配信プロトコルで簡単にリアルタイム通知メッセージを目的のサブスクライバーにプッシュできます。 リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​ Exchange: [Anypoint Exchange の Amazon SNS Connector](https://anypoint.mulesoft.com/exchange/com.mulesoft.connectors/mule-amazon-sns-connector) ## [](#コネクタについて)コネクタについて Anypoint Connector は、Salesforce、Amazon SNS、ServiceNow、Twitter などの外部システムの API やリソースに接続できる Mule Runtime Engine の拡張機能です。 ## [](#始める前に)始める前に アプリケーションを作成する前に、次の作業を行う必要があります。 - Amazon SNS の対象リソースおよび Anypoint Platform へのアクセス権を取得する。 - Anypoint Studio を使用した Mule アプリケーションの作成方法を理解する。 - AWS Identity and Access Management (IAM) のログイン情報を取得する。 ### [](#互換性)互換性 Amazon SNS Connector は、以下と互換性があります。
アプリケーション/サービス バージョン

Mule Runtime

4.1.x

AWS SDK for Java

1.11.515

Java

1.8.0_x

Anypoint Studio

7.0 以上
## [](#対象者)対象者 - 初心者ユーザー Mule アプリケーションを作成するには、​[「Studio 設定」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-studio)​を参照してください。AWS Identity and Access Management (IAM) ユーザーが Amazon SNS Connector を使用するために必要な権限を確認するには、​[「追加設定情報」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-config-topics)​を参照してください。 [「例」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-examples)​トピックには、このコネクタを使用するための 1 つ以上のユースケースがあります。 - パワーユーザー [「XML と Maven のサポート」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-xml-maven)​、​[「追加設定情報」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-config-topics)​、および​[「例」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-examples)​トピックを参照してください。 ## [](#次のステップ)次のステップ 前提条件を満たしたら、​[Anypoint Studio](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-studio)​ でアプリケーションを作成できます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector 4.5 - はじめに Amazon SNS Connector v4.5 Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) を使用すると、Amazon Simple Notification Service (Amazon SNS) API に接続できます。これにより、分散型 Web 対応アプリケーションをビルドできます。Mule アプリケーションは、Amazon SNS Connector を使用して、複数の配信プロトコルで簡単にリアルタイム通知メッセージを目的のサブスクライバーにプッシュできます。 リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​ Exchange: [Anypoint Exchange の Amazon SNS Connector](https://anypoint.mulesoft.com/exchange/com.mulesoft.connectors/mule-amazon-sns-connector)
このコネクタでは、FIFO キューは使用できません。標準キューへのパブリッシュのみが可能です。
## [](#コネクタについて)コネクタについて Anypoint Connector は、Salesforce、Amazon SNS、ServiceNow、Twitter などの外部システムの API やリソースに接続できる Mule Runtime Engine の拡張機能です。 ## [](#始める前に)始める前に アプリケーションを作成する前に、次の作業を行う必要があります。 - Amazon SNS の対象リソースおよび Anypoint Platform へのアクセス権を取得する。 - Anypoint Studio を使用した Mule アプリケーションの作成方法を理解する。 - AWS Identity and Access Management (IAM) のログイン情報を取得する。 ### [](#互換性)互換性 Amazon SNS Connector は、以下と互換性があります。
アプリケーション/サービス バージョン

Mule Runtime

4.1.x

AWS SDK for Java

1.11.969

Java

1.8.0_x

Anypoint Studio

7.0 以上
## [](#対象者)対象者 - 初心者ユーザー Mule アプリケーションを作成するには、​[「Studio 設定」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-studio)​を参照してください。AWS Identity and Access Management (IAM) ユーザーが Amazon SNS Connector を使用するために必要な権限を確認するには、​[「追加設定情報」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-config-topics)​を参照してください。 [「例」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-examples)​トピックには、このコネクタを使用するための 1 つ以上のユースケースがあります。 - パワーユーザー [「XML と Maven のサポート」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-xml-maven)​、​[「追加設定情報」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-config-topics)​、および​[「例」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-examples)​トピックを参照してください。 ## [](#次のステップ)次のステップ 前提条件を満たしたら、​[Anypoint Studio](https://docs.mulesoft.com/jp/amazon-sns-connector/4.5/amazon-sns-connector-studio)​ でアプリケーションを作成できます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector 4.6 - はじめに Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) を使用すると、Amazon Simple Notification Service (Amazon SNS) API に接続できます。これにより、分散型 Web 対応アプリケーションをビルドできます。Mule アプリケーションは、Amazon SNS Connector を使用して、複数の配信プロトコルで簡単にリアルタイム通知メッセージを目的のサブスクライバーにプッシュできます。 リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​ Exchange: [Anypoint Exchange の Amazon SNS Connector](https://anypoint.mulesoft.com/exchange/com.mulesoft.connectors/mule-amazon-sns-connector)
このコネクタでは、FIFO キューは使用できません。標準キューへのパブリッシュのみが可能です。
## [](#コネクタについて)コネクタについて Anypoint Connector は、Salesforce、Amazon SNS、ServiceNow、Twitter などの外部システムの API やリソースに接続できる Mule Runtime Engine の拡張機能です。 ## [](#始める前に)始める前に アプリケーションを作成する前に、次の作業を行う必要があります。 - Amazon SNS の対象リソースおよび Anypoint Platform へのアクセス権を取得する。 - Anypoint Studio を使用した Mule アプリケーションの作成方法を理解する。 - AWS Identity and Access Management (IAM) のログイン情報を取得する。 ### [](#互換性)互換性 Amazon SNS Connector は、以下と互換性があります。
アプリケーション/サービス バージョン

Mule Runtime

4.1.x

AWS SDK for Java

1.11.969

Java

1.8.0_x

Anypoint Studio

7.0 以上
## [](#対象者)対象者 - 初心者ユーザー Mule アプリケーションを作成するには、​[「Studio 設定」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-studio)​を参照してください。AWS Identity and Access Management (IAM) ユーザーが Amazon SNS Connector を使用するために必要な権限を確認するには、​[「追加設定情報」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-config-topics)​を参照してください。 [「例」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-examples)​トピックには、このコネクタを使用するための 1 つ以上のユースケースがあります。 - パワーユーザー [「XML と Maven のサポート」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-xml-maven)​、​[「追加設定情報」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-config-topics)​、および​[「例」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-examples)​トピックを参照してください。 ## [](#次のステップ)次のステップ 前提条件を満たしたら、​[Anypoint Studio](https://docs.mulesoft.com/jp/amazon-sns-connector/4.6/amazon-sns-connector-studio)​ でアプリケーションを作成できます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector 4.7 - はじめに Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) を使用すると、Amazon Simple Notification Service (Amazon SNS) API に接続できます。これにより、分散型 Web 対応アプリケーションをビルドできます。Mule アプリケーションは、Amazon SNS Connector を使用して、複数の配信プロトコルで簡単にリアルタイム通知メッセージを目的のサブスクライバーにプッシュできます。 リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​ Exchange: [Anypoint Exchange の Amazon SNS Connector](https://anypoint.mulesoft.com/exchange/com.mulesoft.connectors/mule-amazon-sns-connector) ## [](#コネクタについて)コネクタについて Anypoint Connector は、Salesforce、Amazon SNS、ServiceNow、Twitter などの外部システムの API やリソースに接続できる Mule Runtime Engine の拡張機能です。 ## [](#始める前に)始める前に アプリケーションを作成する前に、次の作業を行う必要があります。 - Amazon SNS の対象リソースおよび Anypoint Platform へのアクセス権を取得する。 - Anypoint Studio を使用した Mule アプリケーションの作成方法を理解する。 - AWS Identity and Access Management (IAM) のログイン情報を取得する。 ### [](#互換性)互換性 Amazon SNS Connector は、以下と互換性があります。
アプリケーション/サービス バージョン

Mule Runtime

4.1.x

AWS SDK for Java

1.11.969

Java

1.8.0_x

Anypoint Studio

7.0 以上
## [](#次のステップ)次のステップ 前提条件を満たしたら、​[Anypoint Studio](https://docs.mulesoft.com/jp/amazon-sns-connector/4.7/amazon-sns-connector-studio)​ でアプリケーションを作成できます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector のバージョン 4.5 へのアップグレードおよび移行 ## [](#サポートされているアップグレードパス)サポートされているアップグレードパス
開始バージョン 終了バージョン

4.3.1

4.5.x
## [](#このリリースでの変更)このリリースでの変更 - TLS、カスタム SNS、および STS エンドポイントの設定機能を追加。 - `aws-java-sdk`​ を 1.11.611 から 1.11.969 にアップグレード。 - `aws-connector-commons`​ を 2.0.0 から 2.3.0 にアップグレード。 ## [](#要件)要件 アップグレードを実行する前に、システムが次の要件を満たしていることを確認します。
アプリケーション/サービス バージョン

Mule

4.1.1 以降

Amazon Java SDK for RDS

v1.11.969

Java

1.8.0_x

Anypoint Studio

7.0 以降
パッチ更新の更新された互換性情報については、​[「Amazon SNS Connector リリースノート」](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​を参照してください。 ## [](#アップグレード前提条件)アップグレード前提条件 アップグレードを実行する前に、以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成します。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector のバージョン 4.6 へのアップグレードおよび移行 ## [](#サポートされているアップグレードパス)サポートされているアップグレードパス
開始バージョン 終了バージョン

4.5.x

4.6.x
## [](#変更)変更 ### [](#4-6)4.6 - 新しい通知オプションが追加されました。​**\[Phone number (電話番号)\]**​ パラメーターを使用して、指定した電話番号にテキストメッセージを送信します。このオプションは、既存の通知オプションである ​**\[Target Arn (対象 ARN)\]**​ と ​**\[Topic Arn (トピック ARN)\]**​ に加えて提供されます。 ### [](#4-5)4.5 - TLS、カスタム SNS、および STS エンドポイントの設定機能を追加。 - `aws-java-sdk`​ を 1.11.611 から 1.11.969 にアップグレード。 - `aws-connector-commons`​ を 2.0.0 から 2.3.0 にアップグレード。 ## [](#要件)要件 アップグレードを実行する前に、システムが次の要件を満たしていることを確認します。
アプリケーション/サービス バージョン

Mule

4.1.1 以降

Amazon Java SDK for RDS

v1.11.969

Java

1.8.0_x

Anypoint Studio

7.1 以降
パッチ更新の更新された互換性情報については、​[「Amazon SNS Connector リリースノート」](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​を参照してください。 ## [](#アップグレード前提条件)アップグレード前提条件 アップグレードを実行する前に、以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成します。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector のバージョン 4.7 へのアップグレードおよび移行 ## [](#サポートされているアップグレードパス)サポートされているアップグレードパス
開始バージョン 終了バージョン

4.6.x

4.7.x
## [](#変更)変更 ### [](#4-7)4.7 - FIFO トピックのサポートが追加されました。これにより、Amazon SQS FIFO キューを使用したメッセージの厳密な順序とメッセージの重複排除が提供されます。 ### [](#4-6)4.6 - 新しい通知オプションが追加されました。​**\[Phone number (電話番号)\]**​ パラメーターを使用して、指定した電話番号にテキストメッセージを送信します。このオプションは、既存の通知オプションである ​**\[Target Arn (対象 ARN)\]**​ と ​**\[Topic Arn (トピック ARN)\]**​ に加えて提供されます。 ### [](#4-5)4.5 - TLS、カスタム SNS、および STS エンドポイントの設定機能を追加。 - `aws-java-sdk`​ を 1.11.611 から 1.11.969 にアップグレード。 - `aws-connector-commons`​ を 2.0.0 から 2.3.0 にアップグレード。 ## [](#要件)要件 アップグレードを実行する前に、システムが次の要件を満たしていることを確認します。
アプリケーション/サービス バージョン

Mule

4.1.1 以降

Amazon Java SDK for RDS

v1.11.969

Java

1.8.0_x

Anypoint Studio

7.1 以降
パッチ更新の更新された互換性情報については、​[「Amazon SNS Connector リリースノート」](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4)​を参照してください。 ## [](#アップグレード前提条件)アップグレード前提条件 アップグレードを実行する前に、以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成します。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector の例 コネクタの一般的なユースケースを次に挙げます。 - SNS メッセージを Amazon SQS キューに送信する - Amazon SNS メッセージを HTTP/HTTPS エンドポイントに送信する ## [](#amazon-sns-メッセージの-amazon-sqs-キューへの送信)Amazon SNS メッセージの Amazon SQS キューへの送信 Amazon SNS は、Amazon Simple Queue Service (Amazon SQS) と緊密に連携します。Amazon SNS と Amazon SQS を併用すれば、次のメッセージをアプリケーションに配信できます。 - イベントの迅速な通知が必要なメッセージ。 - 他のアプリケーションが後で処理するために Amazon SQS キューで保持されるメッセージ。 Amazon SQS キューを Amazon SNS トピックにサブスクライブするときに、メッセージをトピックにパブリッシュできます。Amazon SNS は、サブスクライブされたキューに Amazon SQS メッセージを送信します。 AWS マネジメントコンソールを使用して、Amazon SQS キューを Amazon SNS トピックにサブスクライブするプロセスを簡略化します。 ## [](#send-http)Amazon SNS メッセージの HTTP/HTTPS エンドポイントへの送信 Amazon SNS を使用して、通知メッセージを 1 つ以上の HTTP または HTTPS エンドポイントに送信できます。Amazon SNS トピックにエンドポイントをサブスクライブすると、トピックへの通知をパブリッシュできます。これにより、Amazon SNS はサブスクライブしたエンドポイントに通知のコンテンツを配信する HTTP POST 要求を送信します。 ## [](#例-コネクタを使用して-sns-メッセージを-amazon-sqs-キューに送信)例: コネクタを使用して SNS メッセージを Amazon SQS キューに送信 次の図は、このユースケースのフロー例を示しています。 ![send-messages-to-SQS](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-use-case-flow.png) この例を試す前に、Anypoint Studio にアクセスし、\[Mule Palette (Mule パレット)\] に ​**Amazon SNS**​ と ​**Amazon SQS**​ のエントリが表示されていることを確認します。 表示されていない場合、​[「Exchange を使用した Studio でのコネクタのインストール」](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-studio#install-connector)​の指示に従って両方のコネクタをインストールします。 コネクタを使用して Amazon SNS メッセージを Amazon SQS キューに送信する Mule アプリケーションを設定する手順は、次のとおりです。 1. Anypoint Studio で新しい Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で​**「HTTP」**​を検索し、​**Listener**​ 操作を選択します。 ![select-listener](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-select-listener.png) 3. **Listener**​ 操作をキャンバスにドラッグします。 4. **Listener**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 5. デフォルトを受け入れます。 6. **Listener**​ 設定の ​**\[General (一般)\]**​ タブで、​**\[Display Name (表示名)\]**​ 項目を ​`HTTP`​、​**\[Path (パス)\]**​ 項目を \`/'' に設定します。 ![http-properties](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-http-properties.png) 7. \[Mule Palette (Mule パレット)\] で​**「SNS」**​を検索し、​**Publish**​ 操作を選択します。 ![publish-selection](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-publish-selection.png) 8. **Publish**​ 操作を ​**HTTP Listener**​ コンポーネントの右にドラッグします。 9. **Publish**​ 設定で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 10. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

Name (名前)

設定の参照に使用される名前。

Amazon_SNS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列。

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン
次の画像は、Publish 操作のサンプルグローバル要素を示しています。 ![sns-global-configuration](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-global-config.png) 11. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 12. **\[Global Elements (グローバル要素)\]**​ タブをクリックします。 13. **\[Amazon SNS Configuration (Configuration) (Amazon SNS 設定 (設定))\]**​ を選択して、​**\[Edit (編集)\]**​ をクリックします。 14. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SNS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - そうでない場合は、見直して、誤ったパラメーターを修正してからもう一度テストします。 15. フローに戻って ​**Publish**​ を選択します。 16. 残りのパラメーターを設定します。
パラメーター 値

Basic Settings (基本設定)

Display Name (表示名)

Publish​ または別の名前。

Connector configuration (コネクタ設定)

Amazon_SNS_configuration​ (作成したグローバル要素への参照名)

[General (一般)] セクション

Topic arn (トピック ARN)

Amazon リソース名 (ARN)。

Message (メッセージ)

`​Hello World!`

Subject (件名)

Testing publish to queue

Message structure (メッセージ構造)

JSON
次の画像は、Publish Message 操作のサンプル設定を示しています。 ![sns-publish-message-props](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-publish-message.png) 17. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` `default`​ JSON キーは、SQS にとって特別な意味を持ちます。使用されるプロトコルに関係なく、キーの値はすべてのサブスクライバーにメッセージとして送信されます。Publish Message 操作でこのキーを指定する必要があります。必要に応じて、HTTP や SQS などの特定のトランスポートプロトコルに送信するメッセージを定義する他の最上位キーを指定できます。詳細は、Amazon Simple Notification Service ドキュメントの [「Publish」](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html#API_Publish_RequestParameters)​を参照してください。 ### [](#publish-操作によって処理されたデータの表示)Publish 操作によって処理されたデータの表示 同じ例を使用して、Mule コンソールで Publish 操作によって処理されたデータを表示する Logger コンポーネントを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Logger」**​コンポーネントを検索し、Amazon SNS Connector (​**Publish**​) の右にドラッグします。 2. **Logger**​ コンポーネントを次のように設定します。
パラメーター 値

Display Name (表示名)

Logger​ または別の名前

Message (メッセージ)

Message: #[payload]

Level (レベル)

INFO
![sns-logger](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-logger.png) ### [](#receive-sns)SNS メッセージの受信 同じ例を使用して、Amazon SQS が Amazon SNS によってパブリッシュされたメッセージを受信できるようにする 2 番目のフローを追加します。 1. \[Mule Palette (Mule パレット)\] で、​**「Flow」**​を検索し、​**Flow**​ コンポーネントをキャンバスにドラッグします。 2. \[Mule Palette (Mule パレット)\] で、​**「SQS」**​を検索し、​**Receive messages**​ 操作を選択して ​**Flow**​ コンポーネントの左にドラッグします。 3. 新しいコンポーネントを選択します。 4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横のある ​**\[+\]**​ をクリックし、新しい Amazon SQS Connector グローバル要素を追加します。 5. 次のようにグローバル要素を設定します。
パラメーター 説明 Value (値)

Name (名前)

設定への参照に使用される名前。

Amazon_SQS_Configuration​ または別の名前

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

AWS アクセスキー

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

AWS シークレットキー

Region Endpoint (リージョンエンドポイント)

キューリージョン。

キューリージョン

Test Queue ARN (キュー ARN をテスト)

接続をテストするために次のステップで使用されるキュー ARN。

テストキュー ARN の形式は ​arn:aws:sqs:region:account-id:queue-name​ です。
次の画像は、Receive messages 操作のサンプルグローバル要素を示しています。 ![sns-sqs-config](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-sqs-global-config.png) 6. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が SQS インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 8. Amazon SQS Connector のプロパティエディターで、残りのパラメーターを設定します。
パラメーター 値

Basic Settings (基本設定)

Display Name (表示名)

Amazon SQS (Streaming)​ または別の名前

Connector configuration (コネクタ設定)*

Amazon_SQS_Configuration​ (作成したグローバル要素への参照名)

Queue url (キュー URL)

キュー URL の形式は ​https://sqs.region.amazonaws.com/account-id/queue-name​ です。

[General (一般)]​ グループの他の項目

デフォルト値
設定内の SQS キューが SNS トピックに​**サブスクライブ**​されていることを確認します。 次に例を示します。 ![sns-sqs-config](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-sqs-config.png) 9. **\[Configuration XML (設定 XML)\]**​ タブを選択して、対応する XML を表示します。 ```xml ``` 10. Amazon SQS Connector の後に ​**Logger**​ スコープを追加して、Mule コンソールの ​**Receive**​ 操作で渡されるデータを出力します。​**Logger**​ を次のように設定します。
パラメーター 値

Display Name (表示名)

Display Message​ または別の名前

Message (メッセージ)

Received Message: #[payload]

Level (レベル)

INFO
11. プロジェクトを保存します。 プロジェクトを Mule アプリケーションとして実行する手順は、次のとおりです。 1. Package Explorer でプロジェクトを右クリックし、​**\[Run As (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ を選択します。 2. Web ブラウザーを開き、URL ​`http://localhost:8081/`​ を入力して応答を確認します。 ロガーには、ブラウザーのパブリッシュされたメッセージ ID と、Mule コンソールの受信メッセージが表示されます。 ### [](#example-code)デモ Mule アプリケーションの XML コード このユースケース例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを XML エディターに貼り付けます。必要に応じて、環境に合わせて値を変更します。 ```xml ``` ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Connector リファレンス Amazon SNS Connector バージョン 4.4.0 リリースノート: [Amazon SNS Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-sns-connector-release-notes-mule-4) ## [](#設定)設定 * * * ### [](#config)デフォルト設定 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Globally Defined Default Topic ARN (グローバルに定義されるデフォルトトピック ARN)。

String (文字列)

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。インスタンスが期限切れとみなされた瞬間にインスタンスが期限切れになるという意味ではありません。必要に応じて、インスタンスがパージされます。
#### [](#接続種別)接続種別 ##### [](#config_basic)Basic (基本) ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (トピックをテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
##### [](#config_role)Role (ロール) ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Role ARN (ロール ARN)

String (文字列)

ロール ARN は、クロスアカウントアクセスを取得することを前提とするロールを一意に特定します。

x

Test Topic ARN (トピック ARN をテスト)

String (文字列)

接続のテストに使用するトピック。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を ​true​ に設定します。 「SDK への一時的な認証情報の提供」​を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。
## [](#操作)操作 - [Add Permission](#addPermission) - [Confirm Subscription](#confirmSubscription) - [Create Platform Application](#createPlatformApplication) - [Create Platform Endpoint](#createPlatformEndpoint) - [Create Topic](#createTopic) - [Delete Endpoint](#deleteEndpoint) - [Delete Platform Application](#deletePlatformApplication) - [Delete Topic](#deleteTopic) - [Get Endpoint Attributes](#getEndpointAttributes) - [Get Platform Application Attributes](#getPlatformApplicationAttributes) - [Get Subscription Attributes](#getSubscriptionAttributes) - [Get Topic Attributes](#getTopicAttributes) - [List Endpoints By Platform Application](#listEndpointsByPlatformApplication) - [List Platform Applications](#listPlatformApplications) - [List Subscriptions](#listSubscriptions) - [List Subscriptions By Topic](#listSubscriptionsByTopic) - [List Topics](#listTopics) - [Publish](#publish) - [Remove Permission](#removePermission) - [Set Endpoint Attributes](#setEndpointAttributes) - [Set Platform Application Attributes](#setPlatformApplicationAttributes) - [Set Subscription Attributes](#setSubscriptionAttributes) - [Set Topic Attributes](#setTopicAttributes) - [Subscribe](#subscribe) - [Unsubscribe](#unsubscribe) ### [](#addPermission)Add Permission `` ステートメントをトピックのアクセス制御ポリシーに追加し、指定されたアクションへのアクセス権を指定の AWS アカウントに付与します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)​を参照してください。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

新しいポリシーステートメントの一意の識別子。

x

Account Ids (アカウント ID)

Array of String (文字列の配列)

指定されたアクションへのアクセス権を付与するユーザー (プリンシパル) の AWS アカウント ID。ユーザーには AWS アカウントが必要ですが、このサービスにサインアップする必要はありません。

x

Action Names (アクション名)

Array of String (文字列の配列)

指定されたプリンシパルに許可するアクション。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力)出力

型

String (文字列)
### [](#次の設定の場合)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#confirmSubscription)Confirm Subscription `` confirmSubscription アクションは、以前の Subscribe アクションでエンドポイントに送信されたトークンを検証して、エンドポイントのオーナーにメッセージを受信する意思があるかどうかを確認します。トークンが有効な場合、このアクションは新しいサブスクリプションを作成し、その Amazon リソース名 (ARN) を返します。AuthenticateOnUnsubscribe フラグが ​`true`​ に設定されている場合にのみ、このコールで AWS 署名が必要になります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)​を参照してください。 #### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクリプションを確認するトピックの ARN。

x

Token (トークン)

String (文字列)

Subscribe​ アクション中にエンドポイントに送信される有効期間の短いトークン。

x

Authenticate On Unsubscribe (サブスクライブ解除時に認証)

String (文字列)

サブスクリプションの未認証のサブスクライブ解除を許可しません。このパラメーターの値が ​true​ で、要求に AWS 署名が含まれている場合、トピックのオーナーとサブスクリプションのオーナーのみがエンドポイントをサブスクライブ解除できます。unsubscribe アクションでは、AWS 認証が必要です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-2)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-2)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-2)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformApplication)Create Platform Application `` デバイスやモバイルアプリケーションを登録できるいずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを作成します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)​を参照してください。 #### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

アプリケーション名は、大文字と小文字の ASCII 文字、数値、アンダースコア、ハイフン、ピリオドで構成されている必要があり、1 ～ 256 文字にする必要があります。

x

プラットフォーム

String (文字列)

ADM (Amazon Device Messaging)、APNS (Apple Push Notification Service)、​APNS_SANDBOX​、GCM (Google Cloud Messaging) のプラットフォームがサポートされています。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-3)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-3)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-3)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createPlatformEndpoint)Create Platform Endpoint `` いずれかのサポート対象プッシュ通知サービスのデバイスやモバイルアプリケーションのエンドポイントを作成します。CreatePlatformEndpoint では、CreatePlatformApplication から返される PlatformApplicationArn が必要です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)​を参照してください。 #### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

CreatePlatformApplication から返される PlatformApplicationArn は、エンドポイントを作成するために使用されます。

x

Token (トークン)

String (文字列)

デバイスのアプリケーションの通知サービスによって作成される一意の識別子。トークンの特定の名前は、使用されている通知サービスによって異なります。たとえば、通知サービスとして APNS (Apple Push Notification Service) を使用する場合、デバイストークンが必要です。GCM (Google Cloud Messaging) または ADM (Amazon Device Messaging) を使用する場合、登録 ID がデバイストークンに相当します。

x

Custom User Data (カスタムユーザーデータ)

String (文字列)

エンドポイントに関連付ける任意のユーザーデータ。Amazon SNS はこのデータを使用しません。データは UTF-8 形式で 2KB 未満にする必要があります。

x

Attributes (属性)

Object (オブジェクト)

属性のリスト。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-4)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-4)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-4)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#createTopic)Create Topic `` CreateTopic アクションは、通知をパブリッシュできるトピックを作成します。ユーザーは、最大 100 件のトピックを作成できます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)​を参照してください。 #### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Name (トピック名)

String (文字列)

作成するトピックの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-5)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-5)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-5)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteEndpoint)Delete Endpoint `` Amazon SNS からデバイスやモバイルアプリケーションのエンドポイントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)​を参照してください。 #### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

削除するエンドポイントの EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-6)出力

型

String (文字列)
### [](#次の設定の場合-6)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-6)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deletePlatformApplication)Delete Platform Application `` いずれかのサポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)​を参照してください。 #### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

削除するプラットフォームアプリケーションオブジェクトの PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-7)出力

型

String (文字列)
### [](#次の設定の場合-7)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-7)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#deleteTopic)Delete Topic `` DeleteTopic アクションは、トピックとそのすべてのサブスクリプションを削除します。トピックを削除すると、以前にトピックに送信された一部のメッセージがサブスクライバーに配信されなくなる可能性があります。このアクションは羃等であるため、存在しないトピックを削除しても、エラーにはなりません。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)​を参照してください。 #### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

削除するトピックの ARN。

x

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
### [](#次の設定の場合-8)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-8)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getEndpointAttributes)Get Endpoint Attributes `` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Endpoint Arn (エンドポイント ARN)

String (文字列)

GetEndpointAttributes 入力の EndpointArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-9)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-9)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getPlatformApplicationAttributes)Get Platform Application Attributes `` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)

GetPlatformApplicationAttributesInput の PlatformApplicationArn。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-9)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-10)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-10)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getSubscriptionAttributes)Get Subscription Attributes `` GetSubscriptionAttributes アクションは、サブスクリプションのすべてのプロパティを返します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

取得するプロパティのサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-10)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-11)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-11)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#getTopicAttributes)Get Topic Attributes `` GetTopicAttributes アクションは、トピックのすべてのプロパティを返します。返されるトピックプロパティは、ユーザーの認証によって異なる可能性があります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-15)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

取得するプロパティのトピックの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-11)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-12)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-12)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#listEndpointsByPlatformApplication)List Endpoints By Platform Application `` サポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイントとエンドポイント属性をリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)​を参照してください。 #### [](#パラメーター-16)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

プラットフォームアプリケーションの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-12)出力

型

[​エンドポイント​] ペイロードおよび [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-13)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-13)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listPlatformApplications)List Platform Applications `` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトをリストします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)​を参照してください。 #### [](#パラメーター-17)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-13)出力

型

[​Platform Application (プラットフォームアプリケーション)​] ペイロードおよび [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-14)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-14)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptions)List Subscriptions `` ListSubscriptions アクションは、リクエスターのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい ListSubscriptions コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)​を参照してください。 #### [](#パラメーター-18)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-14)出力

型

[​Subscription (サブスクリプション)​] ペイロードおよび [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-15)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-15)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listSubscriptionsByTopic)List Subscriptions By Topic `` SubscriptionsByTopic アクションは、特定のトピックへのサブスクリプションのリストを返します。各コールは、最大 100 件に制限されたサブスクリプションのリストを返します。それ以上のサブスクリプションがある場合、NextToken も返されます。新しい SubscriptionsByTopic コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)​を参照してください。 #### [](#パラメーター-19)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Arn

String (文字列)

トピックの ARN。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-15)出力

型

[​Subscription (サブスクリプション)​] ペイロードおよび [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-16)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-16)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#listTopics)List Topics `` ListTopics アクションは、要求者のトピックのリストを返します。各コールは、最大 100 件に制限されたトピックのリストを返します。それ以上のトピックがある場合、NextToken も返されます。新しい ListTopics コールで NextToken パラメーターを使用して、さらに結果を取得します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)​を参照してください。 #### [](#パラメーター-20)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-16)出力

型

[String] ペイロードおよび [​Request ID Attribute (要求 ID 属性)​] 属性のメッセージの配列
### [](#次の設定の場合-17)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-17)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:UNDEFINED\_TOPIC - SNS:INTERNAL\_ERROR - SNS:NOT\_FOUND - SNS:THROTTLED - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:PLATFORM\_APPLICATION\_DISABLED - SNS:AUTHORIZATION\_ERROR ### [](#publish)Publish `` Publish アクションは、メッセージをすべてのトピックのサブスクライブされたエンドポイントに送信します。返された messageId はメッセージが保存されていることを示し、Amazon SNS はすぐにそのメッセージをトピックのサブスクライバーに配信しようとします。サブスクライブされた各エンドポイントへの送信メッセージの形式は、選択した通知プロトコルによって異なります。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Publish.html)​を参照してください。 #### [](#パラメーター-21)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

パブリッシュするトピック。

x

Message (メッセージ)

String (文字列)

トピックに送信するメッセージ。

#[payload]

Subject (件名)

String (文字列)

メッセージがメールエンドポイントに配信されるときの「件名」行として使用されるパラメーター (省略可能)。この項目は、他のエンドポイントに配信される標準 JSON メッセージにも含まれます (存在する場合)。

Message Structure (メッセージ構造)

String (文字列)

プロトコルごとに異なるメッセージを送信する場合、MessageStructure を ​json​ に設定します。

Target Arn (対象 ARN)

String (文字列)

TopicArn または EndpointArn のいずれか (両方ではない)。

Message Attributes (メッセージ属性)

Object (オブジェクト)

Amazon Simple Notification Service の開発者ガイド​で説明されている Amazon SNS メッセージ属性。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-17)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-18)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-18)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#removePermission)Remove Permission `` RemovePermission アクションは、トピックのアクセス制御ポリシーからステートメントを削除します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)​を参照してください。 #### [](#パラメーター-22)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

アクセス制御ポリシーを変更するトピックの ARN。

x

Label (表示ラベル)

String (文字列)

削除するステートメントの一意の表示ラベル。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-18)出力

型

String (文字列)
### [](#次の設定の場合-19)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-19)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setEndpointAttributes)Set Endpoint Attributes `` いずれかのサポート対象プッシュ通知サービス (GCM (Google Cloud Messaging) や APNS (Apple Push Notification Service) など) のデバイスのエンドポイント属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)​を参照してください。 #### [](#パラメーター-23)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

エンドポイント

エンドポイント

SetEndpointAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-19)出力

型

String (文字列)
### [](#次の設定の場合-20)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-20)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setPlatformApplicationAttributes)Set Platform Application Attributes `` サポート対象プッシュ通知サービス (APNS (Apple Push Notification Service) や GCM (Google Cloud Messaging) など) のプラットフォームアプリケーションオブジェクトの属性を設定します。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)​を参照してください。 #### [](#パラメーター-24)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Platform Application Attributes (プラットフォームアプリケーション属性)

Platform Application (プラットフォームアプリケーション)

SetPlatformApplicationAttributes 操作に対するパラメーターのコンテナ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-20)出力

型

String (文字列)
### [](#次の設定の場合-21)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-21)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setSubscriptionAttributes)Set Subscription Attributes `` SubscriptionAttributes アクションは、サブスクリプションのオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)​を参照してください。 #### [](#パラメーター-25)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

サブスクリプションの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-21)出力

型

String (文字列)
### [](#次の設定の場合-22)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-22)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#setTopicAttributes)Set Topic Attributes `` TopicAttributes アクションは、トピックオーナーがトピックの属性に新しい値を設定できるようにします。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)​を参照してください。 #### [](#パラメーター-26)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

トピックの ARN。

x

Attribute Name (属性名)

String (文字列)

属性の名前。

x

Attribute Value (属性値)

String (文字列)

属性の値。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-22)出力

型

String (文字列)
### [](#次の設定の場合-23)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-23)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#subscribe)Subscribe `` Subscribe アクションは、エンドポイントに確認メッセージを送信してエンドポイントをサブスクライブする準備をします。実際にサブスクリプションを作成するには、エンドポイントのオーナーは確認メッセージのトークンを使用して confirmSubscription アクションをコールする必要があります。確認トークンは 3 日間有効です。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)​を参照してください。 #### [](#パラメーター-27)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Topic Arn (トピック ARN)

String (文字列)

サブスクライブするトピックの ARN。

x

Protocol (プロトコル)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

  • EMAIL

  • EMAIL_JSON​

  • SMS

  • SQS

  • APPLICATION

  • LAMBDA

使用するプロトコル。

x

エンドポイント

String (文字列)

通知を受信するエンドポイント。エンドポイントはプロトコルによって異なります。

  • HTTP - エンドポイントは ​http://​ で始まる URL になります。

  • HTTPS - エンドポイントは ​https://​ で始まる URL になります。

  • EMAIL - エンドポイントはメールアドレスになります。

  • EMAIL_JSON​ - エンドポイントはメールアドレスになります。

  • SMS - エンドポイントは SMS 対応デバイスの電話番号になります。

  • SQS - エンドポイントは Amazon SQS キューの ARN になります。

  • APPLICATION - エンドポイントはモバイルアプリケーションやデバイスのエンドポイントになります。

  • LAMBDA - エンドポイントは AWS Lambda 関数の ARN になります。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-23)出力

型

String (文字列)

Attributes Type (属性型)

Request ID Attribute (要求 ID 属性)
### [](#次の設定の場合-24)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-24)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ### [](#unsubscribe)Unsubscribe `` Unsubscribe アクションは、サブスクリプションを削除します。サブスクリプションで削除の認証が必要な場合、サブスクリプションのオーナーまたはトピックのオーナーのみがサブスクライブ解除でき、AWS 署名が必要になります。Unsubscribe コールで認証が必要なく、リクエスターがサブスクリプションのオーナーでない場合、最終キャンセルメッセージがエンドポイントに配信されるため、Unsubscribe 要求が意図したものでなかった場合にエンドポイントのオーナーは簡単にトピックに再サブスクライブできます。 [Amazon SNS API リファレンス](http://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)​を参照してください。 #### [](#パラメーター-28)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Subscription Arn (サブスクリプション ARN)

String (文字列)

削除するサブスクリプションの ARN。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。
#### [](#出力-24)出力

型

String (文字列)
### [](#次の設定の場合-25)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-25)スロー - SNS:INVALID\_PARAMETER\_VALUE - SNS:INVALID\_PARAMETER - SNS:INTERNAL\_ERROR - SNS:CONNECTIVITY - SNS:THROTTLED - SNS:TOPIC\_LIMIT\_EXCEEDED - SNS:AUTHORIZATION\_ERROR - SNS:UNDEFINED\_TOPIC - SNS:NOT\_FOUND - SNS:SUBSCRIPTION\_LIMIT\_EXCEEDED - SNS:ENDPOINT\_DISABLED - SNS:UNKNOWN - SNS:RETRY\_EXHAUSTED - SNS:PLATFORM\_APPLICATION\_DISABLED ## [](#型)型 ### [](#Tls)TLS
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

トラストストア

サーバーの場合、トラストストアには信頼済みのクライアントの証明書が格納されています。クライアントの場合、トラストストアには信頼済みサーバーの証明書が格納されています。

Key Store (キーストア)

Key Store (キーストア)

サーバーの場合、キーストアにはサーバーの非公開キーと公開キーが格納されています。クライアントの場合、キーストアにはクライアントの非公開キーと公開キーが格納されています。

Revocation Check (取り消し確認)

証明書が失効したことを検証します。
### [](#TrustStore)トラストストア
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。
### [](#KeyStore)Key Store (キーストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所。このパスは、可能であれば、現在のクラスパスとファイルシステムに対して解決されます。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、ファイルにある最初のキーがデフォルトで使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。
### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。
### [](#custom-ocsp-responder)Custom OCSP Responder (カスタム OCSP レスポンダー)
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。
### [](#crl-file)CRL File (CRL ファイル)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。
### [](#Reconnection)Reconnection (再接続)
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。
### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続を試みる回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

unsubscribe
### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位
### [](#RequestIDAttribute)Request ID Attribute (要求 ID 属性)
項目 型 説明 デフォルト値 必須

Request Id (要求 ID)

String (文字列)
### [](#Endpoint)エンドポイント
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Endpoint Arn (エンドポイント ARN)

String (文字列)
### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。
### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大数。これ以上の量が必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位
### [](#PlatformApplication)Platform Application (プラットフォームアプリケーション)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Platform Application Arn (プラットフォームアプリケーション ARN)

String (文字列)
### [](#Subscription)Subscription (サブスクリプション)
項目 型 説明 デフォルト値 必須

エンドポイント

String (文字列)

Owner (オーナー)

String (文字列)

Protocol (プロトコル)

String (文字列)

Subscription Arn (サブスクリプション ARN)

String (文字列)

Topic Arn (トピック ARN)

String (文字列)
## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS Studio 設定 Anypoint Studio で Amazon SNS 用 Anypoint Connector (Amazon SNS Connector) をインストールおよび設定する手順は、次のとおりです。 1. コネクタをインストールします。 2. コネクタの入力元を設定します。 3. コネクタを設定します。 ## [](#install-connector)Exchange を使用した Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの Exchange ​**(X)**​ アイコンをクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で、​**「Amazon SNS Connector」**​を検索します。 5. **\[Amazon SNS Connector\]**​ を選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ## [](#studio-でのコネクタのインストール)Studio でのコネクタのインストール 1. Studio で Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] で、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 3. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目にコネクタの名前を入力します。 4. **\[Available modules (使用可能なモジュール)\]**​ で、そのコネクタ名をクリックします。 5. **\[Add (追加)\]**​ をクリックします。 6. **\[Finish (完了)\]**​ をクリックします。 ## [](#入力元の設定)入力元の設定 **HTTP リスナー**​や​**スケジューラー**​などのコネクタの入力元を設定します。 ## [](#コネクタの設定)コネクタの設定 Mule アプリケーションで Amazon SNS Connector を使用するには、アプリケーションのすべての Amazon SNS Connector で使用できるグローバル Amazon SNS 要素を設定します。 1. コネクタの操作を Studio キャンバスにドラッグします。 2. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 3. **\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウで、​**\[Connector Configuration (コネクタ設定)\]**​ を展開し、​**\[Amazon SNS Configuration (Amazon SNS 設定)\]**​ をクリックします。 ![「Global Element Configuration (グローバル要素設定)」 ウィザード](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-config-global-wizard.png) 4. **\[OK\]**​ をクリックします。 5. グローバル要素のプロパティを指定します。 ![「Global Element Properties (グローバル要素のプロパティ)」](/mulesoft/current/ja-jp/amazon-sns-connector/4.4/_images/amazon-sns-global-config.png) 6. パラメーターを次のように設定します。
パラメーター 説明

Name (名前)

設定が参照される名前。

Session Token (セッショントークン)

AWS Security Token Service (STS) が提供するセッショントークン。

Test Topic (テストトピック)

接続のテストに使用するトピック。

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

一時的なログイン情報を使用するかどうかを制御するチェックボックス。

Region Endpoint (リージョンエンドポイント)

トピックリージョンエンドポイント。

Globally Defined Default Topic Arn (グローバルに定義されるデフォルトトピック ARN)

接続性をテストするトピック ARN。
7. **\[Proxy (プロキシ)\]**​ タブ、​**\[Security (セキュリティ)\]**​ タブ、​**\[Advanced (詳細)\]**​ タブをデフォルトのエントリのままにします。 8. **\[Test Connection (接続をテスト)\]**​ をクリックして、グローバル設定のパラメーターが正しいことと、Mule から Amazon SNS のインスタンスに正常に接続できることを確認します。 9. **\[OK\]**​ をクリックします。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS の XML と Maven のサポート (Studio XML エディターまたはテキストエディターから) XML で Mule アプリケーションを手動でコーディングする場合、次のアクションを実行してコネクタへのアクセス権を取得する必要があります。 1. コネクタの名前空間を XML フローに追加する。 2. 連動関係情報を Apache Maven ​`pom.xml`​ ファイルに追加する。 Studio ビジュアルエディターでパレットからキャンバスにコネクタをドラッグすると、コネクタの名前空間とスキーマの場所が自動的に XML コードに入力されます。 ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 次のコードを設定 XML のヘッダーの ​``​ タグ内に貼り付けます。 ```xml http://www.mulesoft.org/schema/mule/sns http://www.mulesoft.org/schema/mule/sns/current/mule-sns.xsd ``` 次の例は、​``​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。 ```xml ``` ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします。 ```xml com.mulesoft.connectors mule-amazon-sns-connector x.x.x mule-plugin ``` `x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得するには、​ [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ でコネクタにアクセスし、​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ## [](#次のステップ)次のステップ 名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/amazon-sns-connector/4.4/amazon-sns-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon SNS の追加設定情報 ## [](#iam-ユーザー権限)IAM ユーザー権限 AWS Identity and Access Management (IAM) ユーザーに Amazon SNS Connector を使用するには、そのユーザーが次の条件を満たしている必要があります。 - Amazon Security Token Service ​`AssumeRole`​ アクションを実行する権限を持つ特定のロールの信頼済みエンティティである。 - すべての SNS Connector の読み取り操作を実行するには、少なくとも ​`AmazonSNSReadOnlyAccess`​ ポリシーを用意する。 - すべての SNS Connector 操作を実行するには、​`AmazonSNSFullAccess`​ ポリシーを用意する。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com)