Oracle Cloud Infrastructureドキュメント

通知の概要

Oracle Cloud Infrastructure Notificationsサービスは、Oracle Cloud Infrastructureおよび外部でホストされているアプリケーションに対して、安全、高信頼性、低レイテンシおよび永続的なメッセージを配信するパブリッシュ/サブスクライブ・パターンを介して、分散コンポーネントにメッセージ をブロードキャストします。イベント・ルールがトリガーされた場合、アラームに違反した場合、またはメッセージを直接公開する場合、通知を使用して通知を受け取ります。

ノート

通知は、Oracle Cloud Infrastructure Government Cloudレルムでは使用できません。

通知の動作

通知サービスを使用すると、トピック およびサブスクリプション を使用してメッセージを公開するための通信チャネルを設定できます。メッセージがトピックに公開されると、通知サービスはトピックのすべてのサブスクリプションにメッセージを送信します。

サブスクライバのエンドポイントがメッセージの受信を確認しないと、通知サービスは配信を再試行します。この状況は、エンドポイントがオフラインの場合に発生することがあります。たとえば、電子メール・アドレスの電子メール・サーバーが停止している可能性があります。

配信再試行の詳細

サブスクリプションの再試行期間は変更できます。コンソールの使用手順は、「サブスクリプションの再試行期間を更新するには」を参照してください。APIの場合、UpdateSubscription操作を使用します。

通知の概念

通知の作業には、次の概念が必要です。

メッセージ
トピックに公開されるコンテンツ。各メッセージは、サブスクリプション当たり少なくとも1回配信されます。電子メールとして送信されるすべてのメッセージには、関連トピックからサブスクライブ解除するためのリンクが含まれています。
サブスクリプション
トピックのエンドポイント。公開されたメッセージは、トピックの各サブスクリプションに送信されます。サポートされるサブスクリプション・プロトコルについては、「サブスクリプションを作成するには」を参照してください。
トピック
トピックのサブスクリプションメッセージを送信するための通信チャネル。各トピック名はテナンシ間で一意です。

ノート

Oracle Cloud Infrastructure Notificationsサービスによって電子メールとして送信されるメッセージは、処理され、U.S.ベースのリージョンのOracleリソースを介して配信されます。

メッセージ公開のフロー

イベント・ルールがトリガーされる場合、アラームに違反した場合、または誰かがメッセージを直接公開する場合、通知はメッセージを公開します。

イベント・ルール:通知ルールがトリガーされるときにメッセージ を送信します。ルールに指定されているトピック にメッセージが送信されます。たとえば、新しいデータベース用にメッセージを構成できます。イベントのルールの管理を参照してください。

この図は、イベント・ルールのコンテキストにおける通知を示しています。

アラーム:アラーム に違反した場合、通知アラーム・メッセージを送信します。アラーム・メッセージは、アラームで指定されているトピック に送信されます。たとえば、高いCPU使用率にアラーム・メッセージを構成できます。アラームの管理を参照してください。

この図は、アラームのコンテキストでの通知を示しています。

直接公開:通知は、自分(またはサービスまたはアプリケーション)がメッセージを直接公開するときにメッセージ を送信します。メッセージは指定したトピック に送信されます。メッセージの公開を参照してください。

この図は、メッセージを直接公開するために使用される通知を示しています。

可用性

通知サービスは、すべてのOracle Cloud Infrastructure商業リージョンで使用できます。使用可能なリージョンのリストの詳細は、「リージョンおよび可用性ドメインについて」および関連する場所、リージョン識別子、リージョン・キーおよび可用性ドメインを参照してください。

電子メール・メッセージ送信のサービス比較

通知サービスまたは電子メール配信サービスを使用して電子メール・メッセージを送信するかどうかを決定する際には、次のサービス機能を使用することを検討してください。電子メール配信の詳細は、電子メール配信サービスの概要を参照してください。

サービス機能 通知サービス 電子メール配信サービス
電子メールを送信する前に確認が必要。 はい いいえ
署名などの電子メール装飾を許可。 はい いいえ
RAW電子メール・メッセージを許可。 いいえ はい
MIMEアタッチメントをサポート。 いいえ

はい

失敗した電子メール配信の特別な処理をサポート。 いいえ

はい

小さいメッセージ(32KB未満、64KBの制限付き)の場合に課金。 はい いいえ
大きいメッセージ(32KBを超える、2MBの制限付き)の場合に課金。 いいえ はい

リソース識別子

ほとんどのタイプのOracle Cloud Infrastructureリソースには、Oracle Cloud ID (OCID)と呼ばれるOracleによって割り当てられた一意の識別子があります。OCIDのフォーマットおよびリソースを識別するその他の方法の詳細は、リソース識別子を参照してください。

別のコンパートメントへのトピックおよびサブスクリプションの移動

あるコンパートメントから別のコンパートメントにトピックおよびサブスクリプションを移動できます。トピックを新規コンパートメントに移動しても、関連付けられているサブスクリプションは既存のコンパートメントに残ります。サブスクリプションを移動する場合も、関連付けられているトピックが既存のコンパートメントに残ります。

トピックまたはサブスクリプションを新規コンパートメントに移動すると、固有のポリシーがただちに適用され、コンソールを介して移動したトピックまたはサブスクリプションへのアクセスが影響を受けます。詳細は、別のコンパートメントへのリソースの移動に関する項を参照してください。

重要

リソースをコンパートメント間で移動するには、リソースの移動先のコンパートメントと現在のコンパートメントに対する十分なアクセス権限がリソース・ユーザーに必要です。通知リソースの権限の詳細は、通知サービスの詳細に関する項を参照してください。

通知へのアクセス方法

コンソール(ブラウザベースのインタフェース)またはREST APIを使用して通知サービスにアクセスできます。コンソールおよびAPIのための手順は、このガイド全体を通してトピックに含まれています。使用可能なSDKのリストは、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

コンソール:コンソールを使用して通知にアクセスするには、サポートされているブラウザを使用する必要があります。このページの上部にある「コンソール」リンクを使用して、サインイン・ページに移動できます。クラウド・テナント、ユーザー名およびパスワードの入力を求められます。ナビゲーション・メニューを開きます。「ソリューションおよびプラットフォーム」で、「アプリケーション統合」に移動して、「通知」をクリックします。

API:APIを介して通知にアクセスするには、通知APIを使用します。

認証と認可

Oracle Cloud Infrastructureの各サービスは、すべてのインタフェース(コンソール、SDKまたはCLI、およびREST API)の認証および認可のためにIAMと統合されています。

組織の管理者は、どのユーザーがどのサービスとリソースにアクセスできるか、およびアクセスのタイプを制御する、グループコンパートメントおよびポリシーを設定する必要があります。たとえば、ポリシーは、新しいユーザーの作成、クラウド・ネットワークの作成と管理、インスタンスの起動、バケットの作成、オブジェクトのダウンロードなどを実行できるユーザーを制御します。詳細は、ポリシーの開始を参照してください。異なる各サービスに対するポリシーの記述の詳細は、ポリシー・リファレンスを参照してください。

会社が所有するOracle Cloud Infrastructureリソースを使用する必要がある通常のユーザー(管理者ではない)の場合は、ユーザーIDを設定するよう管理者に連絡してください。管理者は、使用する必要があるコンパートメントを確認できます。

管理者: 通知へのグループ・アクセス権を付与する共通ポリシーについては、グループによるトピックの管理の許可に関する項グループによるトピック・サブスクリプションの管理の許可に関する項およびグループによるトピックへのメッセージの公開の許可に関する項を参照してください。

通知における制限

適用可能な制限の一覧と制限の引上げをリクエストする手順は、「サービス制限」を参照してください。リソースまたはリソース・ファミリにコンパートメント固有の制限を設定するために、管理者は、コンパートメント割当てを使用できます。