az cdn origin-group

  • リファレンス

エンドポイントの配信元グループを管理します。

コマンド

名前 説明 型 Status
az cdn origin-group create

指定したエンドポイント内に新しい配信元グループを作成します。

 コア GA
az cdn origin-group delete

エンドポイント内の既存の配信元グループを削除します。

 コア GA
az cdn origin-group list

エンドポイント内のすべての既存の配信元グループを一覧表示します。

 コア GA
az cdn origin-group show

エンドポイント内の既存の配信元グループを取得します。

 コア GA
az cdn origin-group update

指定したエンドポイント内の新しい配信元グループを更新します。

 コア GA
az cdn origin-group wait

条件が満たされるまで CLI を待機状態にします。

 コア GA

az cdn origin-group create

編集

指定したエンドポイント内に新しい配信元グループを作成します。

az cdn origin-group create --endpoint-name
                           --name
                           --profile-name
                           --resource-group
                           [--formatted-origins]
                           [--health-probe-settings]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--origins]
                           [--probe-interval]
                           [--probe-method]
                           [--probe-path]
                           [--probe-protocol]
                           [--response-based-origin-error-detection-settings]
                           [--response-error-detection-error-types]
                           [--response-error-detection-failover-threshold]
                           [--response-error-detection-status-code-ranges]
                           [--traffic-restoration-time-to-healed-or-new-endpoints-in-minutes]

例

配信元グループを作成する

az cdn origin-group create -g group --profile-name profile --endpoint-name endpoint -n origin-group --origins origin-0,origin-1

カスタム正常性プローブを使用して配信元グループを作成する

az cdn origin-group create -g group --profile-name profile --endpoint-name endpoint -n origin-group --origins origin-0,origin-1 --probe-path /healthz --probe-interval 90 --probe-protocol HTTPS --probe-method GET

必須のパラメーター

--endpoint-name

グローバルに一意であるプロファイルの下のエンドポイントの名前。

--name --origin-group-name -n

エンドポイント内で一意である配信元グループの名前。

--profile-name

リソース グループ内で一意である CDN プロファイルの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--formatted-origins

指定された配信元グループ内で CDN 経由で配信されるコンテンツのソース。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--health-probe-settings

配信元の正常性を判断するために使用される、配信元に対する正常性プローブの設定。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--origins

配信元の名前または配信元リソース ID のコンマ区切りのリストとして、この配信元グループによって負荷分散された配信元。

--probe-interval

正常性プローブを実行する頻度 (秒単位)。

--probe-method

正常性プローブに使用する要求メソッド。

--probe-path

配信元の正常性を判断するために使われる、配信元を基準とするパス。

--probe-protocol

正常性プローブに使用するプロトコル。

--response-based-origin-error-detection-settings

実際の要求/応答を使用して配信元の正常性を判断するプロパティを含む JSON オブジェクト。 このプロパティは現在サポートされていません。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--response-error-detection-error-types

配信元のサーバー エラーと見なされ、異常としてマークされている Http 状態コード範囲の一覧。

--response-error-detection-failover-threshold

フェールオーバーがトリガーされるサンプル内の失敗した要求の割合。

--response-error-detection-status-code-ranges

配信元が異常と見なされる実際のユーザー要求の応答エラーの種類。

--traffic-restoration-time-to-healed-or-new-endpoints-in-minutes

異常なエンドポイントが正常であるか、新しいエンドポイントが追加されたときに、トラフィックをエンドポイントに徐々にシフトする時間 (分)。 既定値は 10 分です。 このプロパティは現在サポートされていません。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az cdn origin-group delete

編集

エンドポイント内の既存の配信元グループを削除します。

az cdn origin-group delete [--endpoint-name]
                           [--ids]
                           [--name]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--profile-name]
                           [--resource-group]
                           [--subscription]
                           [--yes]

省略可能のパラメーター

--endpoint-name

グローバルに一意であるプロファイルの下のエンドポイントの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name --origin-group-name -n

エンドポイント内で一意である配信元グループの名前。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

リソース グループ内で一意である CDN プロファイルの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--yes -y

確認のダイアログを表示しません。

既定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az cdn origin-group list

編集

エンドポイント内のすべての既存の配信元グループを一覧表示します。

az cdn origin-group list --endpoint-name
                         --profile-name
                         --resource-group
                         [--max-items]
                         [--next-token]

必須のパラメーター

--endpoint-name

グローバルに一意であるプロファイルの下のエンドポイントの名前。

--profile-name

リソース グループ内で一意である CDN プロファイルの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数に --next-token トークン値を指定します。

--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az cdn origin-group show

編集

エンドポイント内の既存の配信元グループを取得します。

az cdn origin-group show [--endpoint-name]
                         [--ids]
                         [--name]
                         [--profile-name]
                         [--resource-group]
                         [--subscription]

省略可能のパラメーター

--endpoint-name

グローバルに一意であるプロファイルの下のエンドポイントの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name --origin-group-name -n

エンドポイント内で一意である配信元グループの名前。

--profile-name

リソース グループ内で一意である CDN プロファイルの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az cdn origin-group update

編集

指定したエンドポイント内の新しい配信元グループを更新します。

az cdn origin-group update [--add]
                           [--endpoint-name]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--formatted-origins]
                           [--health-probe-settings]
                           [--ids]
                           [--name]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--origins]
                           [--probe-interval]
                           [--probe-method]
                           [--probe-path]
                           [--probe-protocol]
                           [--profile-name]
                           [--remove]
                           [--resource-group]
                           [--response-based-origin-error-detection-settings]
                           [--response-error-detection-error-types]
                           [--response-error-detection-failover-threshold]
                           [--response-error-detection-status-code-ranges]
                           [--set]
                           [--subscription]
                           [--traffic-restoration-time-to-healed-or-new-endpoints-in-minutes]

例

配信元グループに含まれる配信元を更新します。

az cdn origin-group update -g group --profile-name profile --endpoint-name endpoint -n origin-group --origins origin-0,origin-2

カスタム正常性プローブを使用して配信元グループを更新する

az cdn origin-group update -g group --profile-name profile --endpoint-name endpoint -n origin-group --origins origin-0,origin-1 --probe-path /healthz --probe-interval 90 --probe-protocol HTTPS --probe-method GET

省略可能のパラメーター

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value、string、または JSON 文字列>。

--endpoint-name

グローバルに一意であるプロファイルの下のエンドポイントの名前。

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--formatted-origins

指定された配信元グループ内で CDN 経由で配信されるコンテンツのソース。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--health-probe-settings

配信元の正常性を判断するために使用される、配信元に対する正常性プローブの設定。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name --origin-group-name -n

エンドポイント内で一意である配信元グループの名前。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--origins

配信元の名前または配信元リソース ID のコンマ区切りのリストとして、この配信元グループによって負荷分散された配信元。

--probe-interval

正常性プローブを実行する頻度 (秒単位)。

--probe-method

正常性プローブに使用する要求メソッド。

--probe-path

配信元の正常性を判断するために使われる、配信元を基準とするパス。

--probe-protocol

正常性プローブに使用するプロトコル。

--profile-name

リソース グループ内で一意である CDN プロファイルの名前。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list OR --remove propertyToRemove。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--response-based-origin-error-detection-settings

実際の要求/応答を使用して配信元の正常性を判断するプロパティを含む JSON オブジェクト。 このプロパティは現在サポートされていません。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--response-error-detection-error-types

配信元のサーバー エラーと見なされ、異常としてマークされている Http 状態コード範囲の一覧。

--response-error-detection-failover-threshold

フェールオーバーがトリガーされるサンプル内の失敗した要求の割合。

--response-error-detection-status-code-ranges

配信元が異常と見なされる実際のユーザー要求の応答エラーの種類。

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--traffic-restoration-time-to-healed-or-new-endpoints-in-minutes

異常なエンドポイントが正常であるか、新しいエンドポイントが追加されたときに、トラフィックをエンドポイントに徐々にシフトする時間 (分)。 既定値は 10 分です。 このプロパティは現在サポートされていません。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az cdn origin-group wait

編集

条件が満たされるまで CLI を待機状態にします。

az cdn origin-group wait [--created]
                         [--custom]
                         [--deleted]
                         [--endpoint-name]
                         [--exists]
                         [--ids]
                         [--interval]
                         [--name]
                         [--profile-name]
                         [--resource-group]
                         [--subscription]
                         [--timeout]
                         [--updated]

省略可能のパラメーター

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

既定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

--deleted

削除されるまで待ちます。

既定値: False
--endpoint-name

グローバルに一意であるプロファイルの下のエンドポイントの名前。

--exists

リソースが存在するまで待ちます。

既定値: False
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--interval

ポーリング間隔 (秒単位)。

既定値: 30
--name --origin-group-name -n

エンドポイント内で一意である配信元グループの名前。

--profile-name

リソース グループ内で一意である CDN プロファイルの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--timeout

最大待機時間 (秒単位)。

既定値: 3600
--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

既定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。