Oracle Cloud Infrastructureドキュメント

通知の概要

Oracle Cloud Infrastructure Notificationsサービスは、Oracle Cloud Infrastructure上でホストされているアプリケーションおよび外部にあるアプリケーションに対して、パブリッシュ・サブスクライブ・パターンを介して分散コンポーネントにメッセージをブロードキャストします。 アラームが違反されたときに通知を受け取るには、「通知」を使用します。 アラームの詳細は、「アラーム機能の概要」を参照してください。

ノート

「通知」は、Oracle Cloud Infrastructure Government Cloudでは使用できません。

通知のしくみ

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

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

配信再試行の詳細

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

通知の概念

通知を使って作業するには、次の概念が不可欠です。

メッセージ
「トピック」に公開されるコンテンツ。 各メッセージは、「サブスクリプション」ごとに少なくとも1回配信されます。 電子メールとして送信されたすべてのメッセージには、関連トピックから「配信停止」へのリンクが含まれています。
サブスクリプション
「トピック」のエンドポイント。 パブリッシュ済「メッセージ」は、「トピック」の各サブスクリプションに送信されます。 サポートされているサブスクリプション・プロトコルは次のとおりです:
  • 電子メール - メッセージは、指定された電子メール・アドレスに送信されます。
  • HTTPS (PagerDuty) - メッセージはPagerDutyに送信されます。 詳細は、PagerDuty documentationを参照してください。
トピック
トピックの「サブスクリプション」「メッセージ」を送信する通信チャネル。 各トピック名はテナンシ全体で一意です。

ノート

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

可用性

「通知」は、現在以下のリージョンで利用可能です:

リージョン名 リージョンのロケーション リージョン・キー
ap-seoul-1 アジア太平洋: ソウル、韓国 ICN
ap-tokyo-1 アジア太平洋: 東京、日本 NRT
ca-toronto-1 カナダ: トロント YYZ
eu-frankfurt-1 ヨーロッパ: フランクフルト、ドイツ FRA
uk-london-1 イギリス: ロンドン LHR
us-ashburn-1 アメリカ合衆国: アッシュバーン、VA IAD
us-phoenix-1 アメリカ合衆国: フェニックス、AZ PHX

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

通知サービスを使用するか、電子メール配信サービスを使用して電子メール・メッセージを送信するかを決定する際には、次のサービス機能を考慮してください。 電子メール配信の詳細は、「電子メール配信サービスの概要」を参照してください。

サービス機能 通知サービス 電子メール配信サービス
電子メールを送信する前に、確認が必要です。 はい いいえ
シグネチャなどの電子メール装飾を許可します。 はい いいえ
Raw電子メール・メッセージを許可します。 いいえ はい
MIMEアタッチメントをサポートします。 いいえ

はい

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

はい

小さなメッセージ用に価格設定されます(64-KBの制限あり)。 はい いいえ
大きなメッセージ用に価格設定されています(2-MBの制限あり)。 いいえ はい

リソース識別子

ほとんどのタイプの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を設定してください。 管理者は、使用する必要があるコンパートメントを確認できます。

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

通知の制限

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