az stream-analytics cluster

注意

此參考是 Azure CLI 串流分析 延伸模組的一部分 （2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az stream-analytics cluster 命令時自動安裝。 深入了解擴充功能。

使用串流分析管理叢集。

命令

名稱	Description	類型	狀態
az stream-analytics cluster create	建立串流分析叢集，或取代已經存在的叢集。	副檔名	GA
az stream-analytics cluster delete	刪除指定的叢集。	副檔名	GA
az stream-analytics cluster list	列出指定資源群組中的所有叢集。 並列出指定訂用帳戶中的所有叢集。	副檔名	GA
az stream-analytics cluster list-streaming-job	列出指定叢集中的所有串流作業。	副檔名	GA
az stream-analytics cluster show	取得指定叢集的相關信息。	副檔名	GA
az stream-analytics cluster update	更新現有的叢集。 這可以用來部分更新叢集（即更新一或兩個屬性）叢集，而不會影響叢集定義的其餘部分。	副檔名	GA
az stream-analytics cluster wait	將 CLI 置於等候狀態，直到符合串流分析叢集的條件為止。	副檔名	GA

az stream-analytics cluster create

建立串流分析叢集，或取代已經存在的叢集。

az stream-analytics cluster create --cluster-name
                                   --resource-group
                                   [--if-match]
                                   [--if-none-match]
                                   [--location]
                                   [--no-wait]
                                   [--sku]
                                   [--tags]

範例

建立新叢集

az stream-analytics cluster create --location "North US" --sku name="Default" capacity=36 --tags key="value" --name "An Example Cluster" --resource-group "sjrg"

必要參數

--cluster-name --name -n

叢集的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

選擇性參數

--if-match

資源的 ETag。 請省略此值，以一律覆寫目前的記錄集。 指定最後看到的 ETag 值，以防止意外覆寫並行變更。

--if-none-match

設定為 『*』 以允許建立新的資源，但為了避免更新現有的記錄集。 其他值會導致 412 前置條件失敗的回應。

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--sku

叢集的 SKU。 這會決定叢集的大小/容量。 PUT （CreateOrUpdate） 要求的必要專案。

使用量：--sku name=XX capacity=XX

name：指定叢集的 SKU 名稱。 PUT （CreateOrUpdate） 要求的必要專案。 capacity：表示叢集可支援的串流單位數目。 此屬性的有效值為 36，最小值為 36，最大值為 216。 PUT （CreateOrUpdate） 要求的必要專案。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics cluster delete

刪除指定的叢集。

az stream-analytics cluster delete [--cluster-name]
                                   [--ids]
                                   [--no-wait]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

範例

刪除叢集

az stream-analytics cluster delete --name "testcluster" --resource-group "sjrg"

選擇性參數

--cluster-name --name -n

叢集的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics cluster list

列出指定資源群組中的所有叢集。 並列出指定訂用帳戶中的所有叢集。

az stream-analytics cluster list [--resource-group]

範例

列出資源群組中的叢集

az stream-analytics cluster list --resource-group "sjrg"

列出訂用帳戶中的叢集

az stream-analytics cluster list

選擇性參數

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics cluster list-streaming-job

列出指定叢集中的所有串流作業。

az stream-analytics cluster list-streaming-job --cluster-name
                                               --resource-group

範例

列出叢集中的所有串流作業

az stream-analytics cluster list-streaming-job --name "testcluster" --resource-group "sjrg"

必要參數

--cluster-name --name -n

叢集的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics cluster show

取得指定叢集的相關信息。

az stream-analytics cluster show [--cluster-name]
                                 [--ids]
                                 [--resource-group]
                                 [--subscription]

範例

取得叢集

az stream-analytics cluster show --name "testcluster" --resource-group "sjrg"

選擇性參數

--cluster-name --name -n

叢集的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics cluster update

更新現有的叢集。 這可以用來部分更新叢集（即更新一或兩個屬性）叢集，而不會影響叢集定義的其餘部分。

az stream-analytics cluster update [--cluster-name]
                                   [--ids]
                                   [--if-match]
                                   [--location]
                                   [--no-wait]
                                   [--resource-group]
                                   [--sku]
                                   [--subscription]
                                   [--tags]

範例

更新叢集

az stream-analytics cluster update --location "Central US" --sku capacity=72 --name "testcluster" --resource-group "sjrg"

選擇性參數

--cluster-name --name -n

叢集的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--if-match

資源的 ETag。 請省略此值，以一律覆寫目前的記錄集。 指定最後看到的 ETag 值，以防止意外覆寫並行變更。

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--sku

叢集的 SKU。 這會決定叢集的大小/容量。 PUT （CreateOrUpdate） 要求的必要專案。

使用量：--sku name=XX capacity=XX

name：指定叢集的 SKU 名稱。 PUT （CreateOrUpdate） 要求的必要專案。 capacity：表示叢集可支援的串流單位數目。 此屬性的有效值為 36，最小值為 36，最大值為 216。 PUT （CreateOrUpdate） 要求的必要專案。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics cluster wait

將 CLI 置於等候狀態，直到符合串流分析叢集的條件為止。

az stream-analytics cluster wait [--cluster-name]
                                 [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--ids]
                                 [--interval]
                                 [--resource-group]
                                 [--subscription]
                                 [--timeout]
                                 [--updated]

範例

暫停執行下一行 CLI 腳本，直到成功建立串流分析叢集為止。

az stream-analytics cluster wait --name "testcluster" --resource-group "sjrg" --created

暫停執行下一行 CLI 腳本，直到串流分析叢集成功更新為止。

az stream-analytics cluster wait --name "testcluster" --resource-group "sjrg" --updated

暫停執行下一行 CLI 腳本，直到成功刪除串流分析叢集為止。

az stream-analytics cluster wait --name "testcluster" --resource-group "sjrg" --deleted

選擇性參數

--cluster-name --name -n

叢集的名稱。

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。