Oracle Cloud Infrastructureドキュメント

サブスクリプションの作成(任意のタイプ)

Notificationsで任意の有効なタイプのサブスクリプションを作成して、通知を受信します。

  • これらのステップは、サブスクリプションを追加するトピックの詳細ページから「サブスクリプションの作成」パネルを開く方法を示しています。このパネルは、「サブスクリプション」リスト・ページから開き、パネルでトピックを指定することもできます: 「サブスクリプションの作成」を選択し、「サブスクリプション・トピック」を選択します。
    1. 「トピック」リスト・ページで、操作するトピックを選択します。リスト・ページまたはトピックの検索に関するヘルプが必要な場合は、トピックのリストを参照してください。
    2. トピックの詳細ページで、「サブスクリプション」を選択します。
    3. 「サブスクリプションの作成」を選択します。
    4. 「サブスクリプションの作成」パネルで、作成するサブスクリプションのタイプを選択し、関連するフィールドに値を入力します。
      • 電子メール: 電子メール・アドレスを入力します。

      • ファンクション: 必要なファンクションを含むコンパートメントおよびアプリケーションを選択し、ファンクションを選択します。

      • HTTPS (カスタムURL): エンドポイントとして使用するURLを入力します。エンドポイント・フォーマット:

        https://<anyvalidURL>

        前提条件については、始める前にを参照してください。問合せパラメータはURLでは許可されません。

      • PagerDuty: 統合キー部分(PagerDutyエンドポイント)を入力します。URLの他の部分はハードコードされています。フル・エンドポイント形式:

        https://events.pagerduty.com/integration/<integrationkey>/enqueue

        問合せパラメータはURLでは許可されません。

      • Slack: Webフック・トークンを含むSlackエンドポイントを入力します。エンドポイント・フォーマット:

        https://hooks.slack.com/services/<webhook-token>

        URLの<webhook-token>部分には、2つのスラッシュ(/)が含まれています。問合せパラメータはURLでは許可されません。

      • SMS: 電話番号の国を選択し、E.164形式を使用して電話番号を入力します。例: +14255550100

      各サブスクリプション・タイプの詳細は、通知の概念のサブスクリプションを参照してください。

    5. (オプション)タグ: サブスクリプションに1つ以上のタグを追加します。
      リソースの作成権限がある場合は、フリーフォーム・タグをそのリソースに適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。 タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。タグは後で適用できます。
    6. 「作成」を選択します。
    Notificationsでは、サブスクリプションが作成されます。サブスクリプション・タイプに確認が必要な場合、Notificationsでは、エンドポイントに確認URLを送信し、確認が受信されるまでサブスクリプションは保留中です。確認URLは3日間有効です。

  • oci ons subscription createコマンドおよび必須パラメータを使用して、サブスクリプションを作成します:

    oci ons subscription create --compartment-id <compartment_OCID> --protocol <subscription_type> --subscription-endpoint <endpoint> --topic-id <topic_OCID>

    CLIコマンドのパラメータおよび値の完全なリストは、通知のコマンドライン・リファレンスを参照してください。

  • CreateSubscription操作を実行して、サブスクリプションを作成します。

次の処理

電子メールなどの一部のプロトコルでは、確認が必要です。この場合、確認を受信するまで、新しいサブスクリプションは「保留」(PENDING)ステータスのままになります。Notificationsは、電子メール・サブスクリプションの電子メール・アドレスなど、サブスクリプション・エンドポイントに確認URLを送信します。確認URLは3日間有効です。新しいサブスクリプションを確認したり、確認が必要なサブスクリプション・プロトコルを確認したりするには、サブスクリプションの確認を参照してください。

新しいサブスクリプションは、その親トピックと同じコンパートメントにある必要がありますが、作成後に別のコンパートメントに移動できます。別のコンパートメントへのサブスクリプションの移動を参照してください。