az interconnect-block

Note

このリファレンスは、Azure CLI (バージョン 2.75.0 以降) の相互接続拡張機能の一部です。 拡張機能は、 az interconnect-block コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

相互接続ブロックを管理します。

コマンド

名前	説明	型	状態
az interconnect-block create	相互接続ブロックを作成します。 相互接続ブロックを更新する場合、タグと SKU 容量のみを変更できます。	拡張機能	GA
az interconnect-block delete	相互接続ブロックを削除します。 この操作は、インターコネクトブロックに関連付けられた仮想マシンやVMSSインスタンスがない場合のみ許可されます。	拡張機能	GA
az interconnect-block list	サブスクリプション内のすべての相互接続ブロックを一覧表示します。 レスポンス内のnextLinkプロパティを使って、Interconnect Blocksの次のページを取得してください。	拡張機能	GA
az interconnect-block show	相互接続ブロックに関する情報を取得します。	拡張機能	GA
az interconnect-block update	相互接続ブロックを更新します。 相互接続ブロックを更新する場合、タグと SKU 容量のみを変更できます。	拡張機能	GA
az interconnect-block wait	条件が満たされるまで CLI を待機状態にします。	拡張機能	GA

az interconnect-block create

相互接続ブロックを作成します。 相互接続ブロックを更新する場合、タグと SKU 容量のみを変更できます。

az interconnect-block create --interconnect-block-name --name
                             --resource-group
                             [--acquire-policy-token]
                             [--change-reference]
                             [--exclude-zones --placement-exclude-zones]
                             [--group-id --interconnect-group-id]
                             [--include-zones --placement-include-zones]
                             [--location]
                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                             [--placement-policy --zone-placement-policy {Any, Auto}]
                             [--sku-capacity]
                             [--sku-name]
                             [--sku-tier]
                             [--tags]
                             [--zones]

例

新しい InterconnectBlock リソースを作成します。

az interconnect-block create --name training-icb-001 --resource-group ai-training-rg --location eastus --zones 1 --sku-name Standard_ND128isr_GB300_v6 --sku-capacity 36 --interconnect-group-id "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/network-rg/providers/Microsoft.Network/interconnectGroups/training-ig" --tags Environment=Production Workload=AI-Training CostCenter=ML-Engineering

必須のパラメーター

--interconnect-block-name --name -n

インターコネクトブロックの名前です。

--resource-group -g

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--exclude-zones --placement-exclude-zones

このプロパティは、'zonePlacementPolicy' プロパティを補完します。 'zonePlacementPolicy' が 'Any'/'Auto' に設定されている場合、システムによって選択された可用性ゾーンは、'excludeZones' で渡された可用性ゾーンの一覧に存在してはなりません。 'excludeZones' が指定されていない場合、リージョン内のすべての可用性ゾーンが選択対象と見なされます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Placement Arguments

--group-id --interconnect-group-id

/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/..の形式の ARM リソース ID。

プロパティ	値
パラメーター グループ:	InterconnectGroup Arguments

--include-zones --placement-include-zones

このプロパティは、'zonePlacementPolicy' プロパティを補完します。 'zonePlacementPolicy' が 'Any'/'Auto' に設定されている場合、システムによって選択された可用性ゾーンは、'includeZones' で渡される可用性ゾーンの一覧に存在する必要があります。 'includeZones' が指定されていない場合、リージョン内のすべての可用性ゾーンが選択対象と見なされます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Placement Arguments

--location -l

リソースが存在する地理的な場所 を指定しない場合は、リソース グループの場所が使用されます。

プロパティ	値
パラメーター グループ:	Resource Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--placement-policy --zone-placement-policy

可用性ゾーンでのリソースの配置に関するポリシーを指定します。 指定できる値は、 Any (Virtual Machines に使用)、 Auto (Virtual Machine Scale Sets に使用) - 可用性ゾーンは、リソースの作成の一環としてシステムによって自動的に選択されます。

プロパティ	値
パラメーター グループ:	Placement Arguments
指定可能な値:	Any, Auto

--sku-capacity

スケール セット内の仮想マシンの数を指定します。

プロパティ	値
パラメーター グループ:	Sku Arguments

--sku-name

SKU 名。

プロパティ	値
パラメーター グループ:	Sku Arguments

--sku-tier

スケール セット内の仮想マシンの層を指定します。

有効値は次のとおりです。

標準

Basic。

プロパティ	値
パラメーター グループ:	Sku Arguments

--tags

リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Resource Arguments

--zones

可用性ゾーン。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Resource Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az interconnect-block delete

相互接続ブロックを削除します。 この操作は、インターコネクトブロックに関連付けられた仮想マシンやVMSSインスタンスがない場合のみ許可されます。

az interconnect-block delete [--acquire-policy-token]
                             [--change-reference]
                             [--ids]
                             [--interconnect-block-name --name]
                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                             [--resource-group]
                             [--subscription]
                             [--yes]

例

確認を含む削除

az interconnect-block delete --name training-icb-001 --resource-group ai-training-rg

確認なしで削除する

az interconnect-block delete --name training-icb-001 --resource-group ai-training-rg --yes

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--interconnect-block-name --name -n

インターコネクトブロックの名前です。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--yes -y

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

プロパティ	値
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az interconnect-block list

サブスクリプション内のすべての相互接続ブロックを一覧表示します。 レスポンス内のnextLinkプロパティを使って、Interconnect Blocksの次のページを取得してください。

az interconnect-block list [--max-items]
                           [--next-token]
                           [--resource-group]

例

サブスクリプション内のすべてを一覧表示する

az interconnect-block list

リソース グループ別の一覧表示

az interconnect-block list --resource-group ai-training-rg

容量による一覧表示とフィルター処理

az interconnect-block list --resource-group ai-training-rg --query "[?sku.capacity>=36]"

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--max-items

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

プロパティ	値
パラメーター グループ:	Pagination Arguments

--next-token

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

プロパティ	値
パラメーター グループ:	Pagination Arguments

--resource-group -g

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

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az interconnect-block show

相互接続ブロックに関する情報を取得します。

az interconnect-block show [--expand {instanceView}]
                           [--ids]
                           [--interconnect-block-name --name]
                           [--resource-group]
                           [--subscription]

例

基本情報を取得する

az interconnect-block show --name training-icb-001 --resource-group ai-training-rg

インスタンス ビューを使用して取得する (ランタイムの詳細を含む)

az interconnect-block show --name training-icb-001 --resource-group ai-training-rg --expand instanceView

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--expand

操作に適用する展開式。 「instanceView」は、プラットフォームが管理するインターコネクトブロックのランタイムプロパティのスナップショットを取得し、制御面外の操作でも変更可能です。

プロパティ	値
指定可能な値:	instanceView

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--interconnect-block-name --name -n

インターコネクトブロックの名前です。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az interconnect-block update

相互接続ブロックを更新します。 相互接続ブロックを更新する場合、タグと SKU 容量のみを変更できます。

az interconnect-block update [--acquire-policy-token]
                             [--add]
                             [--change-reference]
                             [--exclude-zones --placement-exclude-zones]
                             [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                             [--ids]
                             [--include-zones --placement-include-zones]
                             [--interconnect-block-name --name]
                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                             [--placement-policy --zone-placement-policy {Any, Auto}]
                             [--remove]
                             [--resource-group]
                             [--set]
                             [--sku-capacity]
                             [--sku-name]
                             [--sku-tier]
                             [--subscription]
                             [--tags]
                             [--zones]

例

スケール容量を更新する

az interconnect-block update --name training-icb-001 --resource-group ai-training-rg --sku-capacity 54

タグの更新

az interconnect-block update --name training-icb-001 --resource-group ai-training-rg --tags Environment=Production Capacity=54-nodes LastScaled=$(date +%Y-%m-%d)

待機なしでスケールを更新する

az interconnect-block update --name training-icb-001 --resource-group ai-training-rg --sku-capacity 72 --no-wait

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--add

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

プロパティ	値
パラメーター グループ:	Generic Update Arguments

--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--exclude-zones --placement-exclude-zones

このプロパティは、'zonePlacementPolicy' プロパティを補完します。 'zonePlacementPolicy' が 'Any'/'Auto' に設定されている場合、システムによって選択された可用性ゾーンは、'excludeZones' で渡された可用性ゾーンの一覧に存在してはなりません。 'excludeZones' が指定されていない場合、リージョン内のすべての可用性ゾーンが選択対象と見なされます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Placement Arguments

--force-string

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

プロパティ	値
パラメーター グループ:	Generic Update Arguments
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--include-zones --placement-include-zones

このプロパティは、'zonePlacementPolicy' プロパティを補完します。 'zonePlacementPolicy' が 'Any'/'Auto' に設定されている場合、システムによって選択された可用性ゾーンは、'includeZones' で渡される可用性ゾーンの一覧に存在する必要があります。 'includeZones' が指定されていない場合、リージョン内のすべての可用性ゾーンが選択対象と見なされます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Placement Arguments

--interconnect-block-name --name -n

インターコネクトブロックの名前です。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--placement-policy --zone-placement-policy

可用性ゾーンでのリソースの配置に関するポリシーを指定します。 指定できる値は、 Any (Virtual Machines に使用)、 Auto (Virtual Machine Scale Sets に使用) - 可用性ゾーンは、リソースの作成の一環としてシステムによって自動的に選択されます。

プロパティ	値
パラメーター グループ:	Placement Arguments
指定可能な値:	Any, Auto

--remove

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

プロパティ	値
パラメーター グループ:	Generic Update Arguments

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--set

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

プロパティ	値
パラメーター グループ:	Generic Update Arguments

--sku-capacity

スケール セット内の仮想マシンの数を指定します。

プロパティ	値
パラメーター グループ:	Sku Arguments

--sku-name

SKU 名。

プロパティ	値
パラメーター グループ:	Sku Arguments

--sku-tier

スケール セット内の仮想マシンの層を指定します。

有効値は次のとおりです。

標準

Basic。

プロパティ	値
パラメーター グループ:	Sku Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--tags

リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Resource Arguments

--zones

可用性ゾーン。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
パラメーター グループ:	Resource Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az interconnect-block wait

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

az interconnect-block wait [--acquire-policy-token]
                           [--change-reference]
                           [--created]
                           [--custom]
                           [--deleted]
                           [--exists]
                           [--expand {instanceView}]
                           [--ids]
                           [--interconnect-block-name --name]
                           [--interval]
                           [--resource-group]
                           [--subscription]
                           [--timeout]
                           [--updated]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ	値
パラメーター グループ:	Global Policy Arguments

--created

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--custom

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments

--deleted

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--exists

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--expand

操作に適用する展開式。 「instanceView」は、プラットフォームが管理するインターコネクトブロックのランタイムプロパティのスナップショットを取得し、制御面外の操作でも変更可能です。

プロパティ	値
指定可能な値:	instanceView

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--interconnect-block-name --name -n

インターコネクトブロックの名前です。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--interval

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	30

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--timeout

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	3600

--updated

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

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False