Compartilhar via


az stream-analytics cluster

Note

Essa referência faz parte da extensão de análise de fluxo para a CLI do Azure (versão 2.75.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.

Extension GA
az stream-analytics cluster delete

Exclua o cluster especificado.

Extension GA
az stream-analytics cluster list

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

Extension GA
az stream-analytics cluster list-streaming-job

Liste todos os trabalhos de streaming no cluster especificado.

Extension GA
az stream-analytics cluster show

Obtenha informações sobre o cluster especificado.

Extension 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.

Extension 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.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Location. 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.

Propriedade Valor
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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az stream-analytics cluster delete

Exclua o cluster especificado.

az stream-analytics cluster delete [--cluster-name --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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cluster-name --name -n

O nome do cluster.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az stream-analytics cluster show

Obtenha informações sobre o cluster especificado.

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

Exemplos

Obter um cluster

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cluster-name --name -n

O nome do cluster.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cluster-name --name -n

O nome do cluster.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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

Location. 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.

Propriedade Valor
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cluster-name --name -n

O nome do cluster.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--created

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
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'].

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False