Share via

az stream-analytics cluster

  • Referência

Nota

Essa referência faz parte da extensão de análise de fluxo para a CLI do Azure (versão 2.15.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az stream-analytics cluster . Saiba mais sobre extensões.

Gerencie o cluster com análise de fluxo.

Comandos

Name Description Tipo Estado
az stream-analytics cluster create

Crie um cluster do Stream Analytics ou substitua um cluster já existente.

 Extensão Disponibilidade Geral
az stream-analytics cluster delete

Exclua o cluster especificado.

 Extensão Disponibilidade Geral
az stream-analytics cluster list

Liste todos os clusters em um determinado grupo de recursos. E lista todos os clusters na assinatura fornecida.

 Extensão Disponibilidade Geral
az stream-analytics cluster list-streaming-job

Liste todos os trabalhos de streaming no cluster determinado.

 Extensão Disponibilidade Geral
az stream-analytics cluster show

Obtenha informações sobre o cluster especificado.

 Extensão Disponibilidade Geral
az stream-analytics cluster update

Atualize um cluster existente. Isso pode ser usado para atualizar parcialmente (ou seja, atualizar uma ou duas propriedades) de um cluster sem afetar o restante da definição de cluster.

 Extensão Disponibilidade Geral
az stream-analytics cluster wait

Coloque a CLI em um estado de espera até que uma condição do cluster de análise de fluxo seja atendida.

 Extensão Disponibilidade Geral

az stream-analytics cluster create

Crie um cluster do Stream Analytics ou substitua um cluster já existente.

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

Exemplos

Criar um novo cluster

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

Parâmetros Obrigatórios

--cluster-name --name -n

O nome do cluster.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--if-match

O ETag do recurso. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.

--if-none-match

Defina como '*' para permitir que um novo recurso seja criado, mas para impedir a atualização de um conjunto de registros existente. Outros valores resultarão em uma resposta com falha na pré-condição 412.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--sku

A SKU do cluster. Isso determina o tamanho/capacidade do cluster. Obrigatório em solicitações PUT (CreateOrUpdate).

Uso: --sku name=XX capacity=XX

name: Especifica o nome da SKU do cluster. Obrigatório em solicitações PUT (CreateOrUpdate). capacidade: indica o número de unidades de streaming que o cluster pode suportar. Os valores válidos para esta propriedade são múltiplos de 36 com um valor mínimo de 36 e um valor máximo de 216. Obrigatório em solicitações PUT (CreateOrUpdate).

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az stream-analytics cluster delete

Exclua o cluster especificado.

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

Exemplos

Eliminar um cluster

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

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az stream-analytics cluster list

Liste todos os clusters em um determinado grupo de recursos. E lista todos os clusters na assinatura fornecida.

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

Exemplos

Listar clusters no grupo de recursos

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

Listar os clusters em uma assinatura

az stream-analytics cluster list

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az stream-analytics cluster list-streaming-job

Liste todos os trabalhos de streaming no cluster determinado.

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

Exemplos

Listar todos os trabalhos de streaming no cluster

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

Parâmetros Obrigatórios

--cluster-name --name -n

O nome do cluster.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az stream-analytics cluster show

Obtenha informações sobre o cluster especificado.

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

Exemplos

Obter um cluster

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

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az stream-analytics cluster update

Atualize um cluster existente. Isso pode ser usado para atualizar parcialmente (ou seja, atualizar uma ou duas propriedades) de um cluster sem afetar o restante da definição de cluster.

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

Exemplos

Atualizar um cluster

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

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--if-match

O ETag do recurso. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sku

A SKU do cluster. Isso determina o tamanho/capacidade do cluster. Obrigatório em solicitações PUT (CreateOrUpdate).

Uso: --sku name=XX capacity=XX

name: Especifica o nome da SKU do cluster. Obrigatório em solicitações PUT (CreateOrUpdate). capacidade: indica o número de unidades de streaming que o cluster pode suportar. Os valores válidos para esta propriedade são múltiplos de 36 com um valor mínimo de 36 e um valor máximo de 216. Obrigatório em solicitações PUT (CreateOrUpdate).

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az stream-analytics cluster wait

Coloque a CLI em um estado de espera até que uma condição do cluster de análise de fluxo seja atendida.

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

Exemplos

Pause a execução da próxima linha do script da CLI até que o cluster de análise de fluxo seja criado com êxito.

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

Pause a execução da próxima linha do script CLI até que o cluster de análise de fluxo seja atualizado com êxito.

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

Pause a execução da próxima linha do script da CLI até que o cluster de análise de fluxo seja excluído com êxito.

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

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.