az eventgrid domain event-subscription
doメイン のイベント サブスクリプションを管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az eventgrid domain event-subscription create |
doメイン の新しいイベント サブスクリプションを作成します。 |
コア | GA |
az eventgrid domain event-subscription delete |
doメイン のイベント サブスクリプションを削除します。 |
コア | GA |
az eventgrid domain event-subscription list |
特定の doメイン のイベント サブスクリプションを一覧表示します。 |
コア | GA |
az eventgrid domain event-subscription show |
doメイン のイベント サブスクリプションの詳細を取得します。 |
コア | GA |
az eventgrid domain event-subscription update |
doメイン のイベント サブスクリプションを更新します。 |
コア | GA |
az eventgrid domain event-subscription create
doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create --domain-name
--name
--resource-group
[--aad-app-id]
[--aad-tenant-id]
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
[--event-ttl]
[--expiration-date]
[--included-event-types]
[--labels]
[--max-delivery-attempts]
[--max-events-per-batch]
[--pref-batch-size-kb]
[--qttl]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]
例
既定のフィルターを使用して、Event Grid doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
件名プレフィックスを指定するフィルターを使用して、Event Grid doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create --name es4 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
既定のフィルターと CloudEvent V 1.0 を配信スキーマとして使用して、Event Grid doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create -n es2 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
配信不能な宛先とカスタム再試行ポリシーが最大 10 回、イベント TTL が 2 時間 (どちらか早い方) と有効期限が設定された、Event Grid doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create --name es2 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
--max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"
Azure Active Directory 対応 Webhook を宛先として使用して、Event Grid doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri
Azure 関数を宛先として使用して、Event Grid doメイン の新しいイベント サブスクリプションを作成します。
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Event Grid do の新しいイベント サブスクリプションを作成メイン 5 分の ttl で宛先としてストレージ キューを使用する
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300
Event Grid の新しいイベント サブスクリプションを作成しメイン配列で高度なフィルター処理を有効にする
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
必須のパラメーター
doメイン の名前。
イベント サブスクリプションの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
配信要求にベアラー トークンとして含まれるアクセス トークンを取得する Azure Active Directory アプリケーション ID または URI。 宛先として Webhook にのみ適用されます。
配信要求にベアラー トークンとして含まれるアクセス トークンを取得する Azure Active Directory テナント ID。 宛先として Webhook にのみ適用されます。
高度なフィルターを使用すると、特定のイベント プロパティに基づいてイベントをフィルター処理できます。
使用法: --advanced-filter KEY[.INNERKEY] FILTEROPERATOR 値 [値 ...]StringIn: --advanced-filter データ。Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter データ。Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filterdata.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotNotInInInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull 複数の高度なフィルターは、複数の --advanced-filter
引数を使用して指定できます。
EventGrid がこのイベント サブスクリプションの配信不能イベントを配信不能にする必要がある Azure Storage BLOB コンテナーの宛先の Azure リソース ID。
例: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName。
配信属性マッピングを追加して、イベントを配信するときに HTTP ヘッダー経由で追加情報を送信します。 この属性は、StorageQueue を除くすべての宛先の種類に対して有効です。 複数の引数を使用して、複数の属性を --delivery-attribute-mapping
指定できます。
使用法: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] 静的属性マッピング: --delivery-attribute-mapping somename static somevalue static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Static と Dynamic: --delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
特異な値を期待するのではなく、値の配列に対して高度なフィルターを評価できるようにします。
EventGrid がこのイベント サブスクリプションに一致するイベントを配信するエンドポイント。 webhook エンドポイントの種類の場合、これは対応する webhook URL である必要があります。 その他の種類のエンドポイントの場合、これはエンドポイントの Azure リソース識別子である必要があります。 Event Grid コマンドを実行する前に、宛先エンドポイントが既に作成され、使用できる必要があります。
宛先エンドポイントの種類。
このイベント サブスクリプションに対してイベントを配信するスキーマ。 既定では、イベントは(対応するトピックの入力スキーマに基づいて) 発行されるのと同じスキーマで配信されます。
イベントの有効期間 (分単位)。 1 ~ 1440 の数値を指定する必要があります。
イベント サブスクリプションの有効期限が切れる日付または日時 (UTC、例: '2018-11-30T11:59:59+00:00' または '2018-11-30')。 既定では、イベント サブスクリプションの有効期限はありません。
イベントの種類 (Microsoft.Storage.BlobCreated や Microsoft.Storage.BlobDeleted など) のスペース区切りのリスト。 すべての既定のイベントの種類をサブスクライブするには、この引数に値を指定しないでください。 イベント グリッド トピックの場合、イベントの種類は顧客定義です。 Azure イベント (ストレージ アカウント、IoT Hub など) の場合は、この CLI コマンド 'az eventgrid topic-type list-event-types' を使用して、イベントの種類に対してクエリを実行できます。
このイベント サブスクリプションに関連付けるラベルのスペース区切りの一覧。
配信試行の最大数。 1 ~ 30 の数値を指定する必要があります。
バッチ内のイベントの最大数。 1 から 5000 までの数値を指定する必要があります。
推奨されるバッチ サイズ (KB 単位)。 1 から 1024 までの数値を指定する必要があります。
ストレージ キュー メッセージの有効期間 (秒単位)。
プレフィックスに基づいてイベント サブスクリプションのイベントをフィルター処理する省略可能な文字列。 ワイルドカード文字はサポートされていません。
件名フィールドを大文字と小文字を区別して比較するかどうかを指定します。 True の場合フラグが存在します。
サフィックスに基づいてイベント サブスクリプションのイベントをフィルター処理する省略可能な文字列。 ワイルドカード文字はサポートされていません。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az eventgrid domain event-subscription delete
doメイン のイベント サブスクリプションを削除します。
az eventgrid domain event-subscription delete --domain-name
--name
--resource-group
[--yes]
例
Event Grid doメイン のイベント サブスクリプションを削除します。
az eventgrid domain event-subscription delete --name es1 \
-g rg1 --domain-name domain1 \
必須のパラメーター
doメイン の名前。
イベント サブスクリプションの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
確認のダイアログを表示しません。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az eventgrid domain event-subscription list
特定の doメイン のイベント サブスクリプションを一覧表示します。
az eventgrid domain event-subscription list --domain-name
--resource-group
[--odata-query]
例
Event Grid doメイン 用に作成されたすべてのイベント サブスクリプションを一覧表示します。
az eventgrid domain event-subscription list -g rg1 --domain-name domain1
必須のパラメーター
doメイン の名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
リストの結果をフィルター処理するために使用される OData クエリ。 現在、フィルター処理は Name プロパティでのみ許可されています。 サポートされる操作には、CONTAINS、eq (等しい)、ne (等しくない場合)、AND、OR、NOT が含まれます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az eventgrid domain event-subscription show
doメイン のイベント サブスクリプションの詳細を取得します。
az eventgrid domain event-subscription show --domain-name
--name
--resource-group
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
例
Event Grid doメイン のイベント サブスクリプションの詳細を表示します。
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1
Event Grid do のイベント サブスクリプションの詳細を表示メイン静的配信属性シークレットを含めます。
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1 --include-attrib-secret
必須のパラメーター
doメイン の名前。
イベント サブスクリプションの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
完全なエンドポイント URL を返す必要があるかどうかを指定します。 True の場合フラグが存在します。
静的配信属性シークレットを返す必要があるかどうかを示します。 True の場合フラグが存在します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az eventgrid domain event-subscription update
doメイン のイベント サブスクリプションを更新します。
az eventgrid domain event-subscription update --domain-name
--name
--resource-group
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--included-event-types]
[--labels]
[--qttl]
[--subject-begins-with]
[--subject-ends-with]
[--update-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
例
Event Grid doメイン のイベント サブスクリプションを更新して、新しいエンドポイントを指定します。
az eventgrid domain event-subscription update --name es1 \
-g rg1 --domain-name domain1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Event Grid doメイン のイベント サブスクリプションを更新して、新しい subject-ends-with フィルターを指定します。
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--subject-ends-with .jpg
Event Grid doメイン のイベント サブスクリプションを更新して、新しいエンドポイントと新しい件名を指定し、含まれるイベントの種類の新しいリストをフィルター処理します。
az eventgrid domain event-subscription update --name es3 \
-g rg1 --domain-name domain1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
配信不能な宛先を含むように、Azure Event Grid doメイン のイベント サブスクリプションを更新します。
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
高度なフィルターを使用して、Azure Event Grid doメイン のイベント サブスクリプションを更新します。
az eventgrid domain event-subscription update --name es3 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--advanced-filter data.blobType StringIn BlockBlob
--advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net
Event Grid doメイン のイベント サブスクリプションを、5 分の ttl で宛先としてストレージ キューに更新します
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--storage-queue-msg-ttl 300
配列の高度なフィルター処理が有効になっている Event Grid doメイン のイベント サブスクリプションを更新する
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--enable-advanced-filtering-on-arrays true
必須のパラメーター
doメイン の名前。
イベント サブスクリプションの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
高度なフィルターを使用すると、特定のイベント プロパティに基づいてイベントをフィルター処理できます。
使用法: --advanced-filter KEY[.INNERKEY] FILTEROPERATOR 値 [値 ...]StringIn: --advanced-filter データ。Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter データ。Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filterdata.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotNotInInInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull 複数の高度なフィルターは、複数の --advanced-filter
引数を使用して指定できます。
EventGrid がこのイベント サブスクリプションの配信不能イベントを配信不能にする必要がある Azure Storage BLOB コンテナーの宛先の Azure リソース ID。
配信属性マッピングを追加して、イベントを配信するときに HTTP ヘッダー経由で追加情報を送信します。 この属性は、StorageQueue を除くすべての宛先の種類に対して有効です。 複数の引数を使用して、複数の属性を --delivery-attribute-mapping
指定できます。
使用法: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] 静的属性マッピング: --delivery-attribute-mapping somename static somevalue static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Static と Dynamic: --delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
特異な値を期待するのではなく、値の配列に対して高度なフィルターを評価できるようにします。
EventGrid がこのイベント サブスクリプションに一致するイベントを配信するエンドポイント。 webhook エンドポイントの種類の場合、これは対応する webhook URL である必要があります。 その他の種類のエンドポイントの場合、これはエンドポイントの Azure リソース識別子である必要があります。 Event Grid コマンドを実行する前に、宛先エンドポイントが既に作成され、使用できる必要があります。
イベントの種類 (Microsoft.Storage.BlobCreated や Microsoft.Storage.BlobDeleted など) のスペース区切りのリスト。 すべての既定のイベントの種類をサブスクライブするには、この引数に値を指定しないでください。 イベント グリッド トピックの場合、イベントの種類は顧客定義です。 Azure イベント (ストレージ アカウント、IoT Hub など) の場合は、この CLI コマンド 'az eventgrid topic-type list-event-types' を使用して、イベントの種類に対してクエリを実行できます。
このイベント サブスクリプションに関連付けるラベルのスペース区切りの一覧。
ストレージ キュー メッセージの有効期間 (秒単位)。
プレフィックスに基づいてイベント サブスクリプションのイベントをフィルター処理する省略可能な文字列。 ワイルドカード文字はサポートされていません。
サフィックスに基づいてイベント サブスクリプションのイベントをフィルター処理する省略可能な文字列。 ワイルドカード文字はサポートされていません。
宛先エンドポイントの種類。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI