az interconnect-block
Note
此參考資料是 Azure CLI(版本 2.75.0 或更高版本)互連擴充的一部分。 這個擴充功能會在你第一次執行 az interconnect-block 指令時自動安裝。 深入了解擴充功能。
管理互連區塊。
命令
| 名稱 | Description | 類型 | 狀態 |
|---|---|---|---|
| az interconnect-block create |
建立一個互連區塊。 更新互連區塊時,僅可修改標籤與 SKU 容量。 |
Extension | GA |
| az interconnect-block delete |
刪除一個互連區塊。 只有當互連區塊沒有虛擬機或 VMSS 虛擬機實例時,才允許此操作。 |
Extension | GA |
| az interconnect-block list |
請在訂閱中列出所有互連區塊。 在回應中使用 nextLink 屬性,就能取得下一頁的 Interconnect Blocks。 |
Extension | GA |
| az interconnect-block show |
獲取有關互連區塊的資訊。 |
Extension | GA |
| az interconnect-block update |
更新一個互連區塊。 更新互連區塊時,僅可修改標籤與 SKU 容量。 |
Extension | GA |
| az interconnect-block wait |
將 CLI 置於等候狀態,直到符合條件為止。 |
Extension | 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(互聯區塊)的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
此屬性補充 'zonePlacementPolicy' 屬性。 如果 'zonePlacementPolicy' 設定為 'Any'/'Auto',則系統選取的可用性區域不得出現在使用 'excludeZones' 傳遞的可用性區域清單中。 如果未提供 『excludeZones』,則會考慮區域中的所有可用性區域以供選取。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Placement Arguments |
以 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 格式的 ARM 資源標識符
| 屬性 | 值 |
|---|---|
| 參數群組: | InterconnectGroup Arguments |
此屬性補充 'zonePlacementPolicy' 屬性。 如果 'zonePlacementPolicy' 設定為 'Any'/'Auto',則系統選取的可用性區域必須存在於以 'includeZones' 傳遞的可用性區域清單中。 如果未提供 『includeZones』,則會考慮區域中的所有可用性區域以供選取。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Placement Arguments |
未指定資源所在的地理位置,將會使用資源群組的位置。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Arguments |
請勿等候長時間執行的作業完成。
| 屬性 | 值 |
|---|---|
| 接受的值: | 0, 1, f, false, n, no, t, true, y, yes |
指定資源在可用區域中放置的原則。 可能的值為: 任何 (用於虛擬機器)、 自動 (用於虛擬機器擴展集) - 系統會在資源建立過程中自動挑選可用性區域。
| 屬性 | 值 |
|---|---|
| 參數群組: | Placement Arguments |
| 接受的值: | Any, Auto |
指定擴展集中的虛擬機數目。
| 屬性 | 值 |
|---|---|
| 參數群組: | Sku Arguments |
SKU 名稱。
| 屬性 | 值 |
|---|---|
| 參數群組: | Sku Arguments |
指定擴展集中虛擬機的層級。
可能的值如下:
Standard
基本。
| 屬性 | 值 |
|---|---|
| 參數群組: | Sku Arguments |
資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Arguments |
可用性區域。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Arguments |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --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
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
Interconnect Block(互聯區塊)的名稱。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
請勿等候長時間執行的作業完成。
| 屬性 | 值 |
|---|---|
| 接受的值: | 0, 1, f, false, n, no, t, true, y, yes |
資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
不提示確認。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --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]"
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值,則會在命令的輸出中提供令牌。 若要繼續分頁,請在後續命令的 --next-token 自變數中提供令牌值。
| 屬性 | 值 |
|---|---|
| 參數群組: | Pagination Arguments |
標記,指定要開始分頁的位置。 這是先前截斷回應中的令牌值。
| 屬性 | 值 |
|---|---|
| 參數群組: | Pagination Arguments |
資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --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
Get with instance view(包含執行時細節)
az interconnect-block show --name training-icb-001 --resource-group ai-training-rg --expand instanceView
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
要套用至作業的展開表達式。 'instanceView' 會擷取由平台管理的 Interconnect Block 執行時屬性快照,且可在控制平面操作外變動。
| 屬性 | 值 |
|---|---|
| 接受的值: | instanceView |
一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
Interconnect Block(互聯區塊)的名稱。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --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
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>。
| 屬性 | 值 |
|---|---|
| 參數群組: | Generic Update Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
此屬性補充 'zonePlacementPolicy' 屬性。 如果 'zonePlacementPolicy' 設定為 'Any'/'Auto',則系統選取的可用性區域不得出現在使用 'excludeZones' 傳遞的可用性區域清單中。 如果未提供 『excludeZones』,則會考慮區域中的所有可用性區域以供選取。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Placement Arguments |
使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。
| 屬性 | 值 |
|---|---|
| 參數群組: | Generic Update Arguments |
| 接受的值: | 0, 1, f, false, n, no, t, true, y, yes |
一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
此屬性補充 'zonePlacementPolicy' 屬性。 如果 'zonePlacementPolicy' 設定為 'Any'/'Auto',則系統選取的可用性區域必須存在於以 'includeZones' 傳遞的可用性區域清單中。 如果未提供 『includeZones』,則會考慮區域中的所有可用性區域以供選取。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Placement Arguments |
Interconnect Block(互聯區塊)的名稱。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
請勿等候長時間執行的作業完成。
| 屬性 | 值 |
|---|---|
| 接受的值: | 0, 1, f, false, n, no, t, true, y, yes |
指定資源在可用區域中放置的原則。 可能的值為: 任何 (用於虛擬機器)、 自動 (用於虛擬機器擴展集) - 系統會在資源建立過程中自動挑選可用性區域。
| 屬性 | 值 |
|---|---|
| 參數群組: | Placement Arguments |
| 接受的值: | Any, Auto |
從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove> 或 --remove propertyToRemove。
| 屬性 | 值 |
|---|---|
| 參數群組: | Generic Update Arguments |
資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>。
| 屬性 | 值 |
|---|---|
| 參數群組: | Generic Update Arguments |
指定擴展集中的虛擬機數目。
| 屬性 | 值 |
|---|---|
| 參數群組: | Sku Arguments |
SKU 名稱。
| 屬性 | 值 |
|---|---|
| 參數群組: | Sku Arguments |
指定擴展集中虛擬機的層級。
可能的值如下:
Standard
基本。
| 屬性 | 值 |
|---|---|
| 參數群組: | Sku Arguments |
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Arguments |
可用性區域。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Arguments |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --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]
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
請等候在 'Succeeded' 使用 'provisioningState' 建立。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
| 預設值: | False |
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
等到刪除為止。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
| 預設值: | False |
等候資源存在。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
| 預設值: | False |
要套用至作業的展開表達式。 'instanceView' 會擷取由平台管理的 Interconnect Block 執行時屬性快照,且可在控制平面操作外變動。
| 屬性 | 值 |
|---|---|
| 接受的值: | instanceView |
一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
Interconnect Block(互聯區塊)的名稱。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
輪詢間隔以秒為單位。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
| 預設值: | 30 |
資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
| 屬性 | 值 |
|---|---|
| 參數群組: | Resource Id Arguments |
以秒為單位的等候上限。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
| 預設值: | 3600 |
等到 provisioningState 更新為 'Succeeded'。
| 屬性 | 值 |
|---|---|
| 參數群組: | Wait Condition Arguments |
| 預設值: | False |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |