Compartilhar via

az stream-analytics cluster

  • Referência

Observação

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

Gerenciar cluster com análise de fluxo.

Comandos

Nome Description Tipo Status
az stream-analytics cluster create

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

 Extensão GA
az stream-analytics cluster delete

Exclua o cluster especificado.

 Extensão GA
az stream-analytics cluster list

Liste todos os clusters no grupo de recursos especificado. E lista todos os clusters na assinatura fornecida.

 Extensão GA
az stream-analytics cluster list-streaming-job

Liste todos os trabalhos de streaming no cluster especificado.

 Extensão GA
az stream-analytics cluster show

Obtenha informações sobre o cluster especificado.

 Extensão GA
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 do cluster.

 Extensão GA
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 GA

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 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 Exigidos

--cluster-name --name -n

O nome do cluster.

--resource-group -g

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

Parâmetros Opcionais

--if-match

A ETag do recurso. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor de ETag visto pela última vez para impedir 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 de 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 aguarde a conclusão da operação de execução prolongada.

Valor padrão: 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

nome: 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 dar suporte. Os valores válidos para essa propriedade são múltiplos de 36 com um valor mínimo de 36 e valor máximo de 216. Obrigatório em solicitações PUT (CreateOrUpdate).

--tags

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. 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

Excluir um cluster

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

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valor padrão: False
--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

az stream-analytics cluster list

Liste todos os clusters no grupo de recursos especificado. 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

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

az stream-analytics cluster list-streaming-job

Liste todos os trabalhos de streaming no cluster especificado.

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 Exigidos

--cluster-name --name -n

O nome do cluster.

--resource-group -g

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. 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

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. 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 do 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

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--if-match

A ETag do recurso. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor de ETag visto pela última vez para impedir 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 aguarde a conclusão da operação de execução prolongada.

Valor padrão: False
--resource-group -g

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

nome: 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 dar suporte. Os valores válidos para essa propriedade são múltiplos de 36 com um valor mínimo de 36 e valor máximo de 216. Obrigatório em solicitações PUT (CreateOrUpdate).

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--tags

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. 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 de 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 de script da 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 de 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 padrão: False
--custom

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

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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