Partager via

az stream-analytics cluster

  • Référence

Remarque

Cette référence fait partie de l’extension Stream-Analytics pour Azure CLI (version 2.15.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de cluster az stream-analytics. En savoir plus sur les extensions.

Gérer un cluster avec Stream Analytics.

Commandes

Nom Description Type Statut
az stream-analytics cluster create

Créez un cluster Stream Analytics ou remplace un cluster déjà existant.

 Extension GA
az stream-analytics cluster delete

Supprimez le cluster spécifié.

 Extension GA
az stream-analytics cluster list

Répertoriez tous les clusters dans le groupe de ressources donné. Et répertorie tous les clusters dans l’abonnement donné.

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

Répertoriez tous les travaux de diffusion en continu dans le cluster donné.

 Extension GA
az stream-analytics cluster show

Obtenez des informations sur le cluster spécifié.

 Extension GA
az stream-analytics cluster update

Mettez à jour un cluster existant. Cela peut être utilisé pour mettre à jour partiellement (par exemple, mettre à jour une ou deux propriétés) un cluster sans affecter le reste de la définition du cluster.

 Extension GA
az stream-analytics cluster wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition du cluster Stream-Analytics soit remplie.

 Extension GA

az stream-analytics cluster create

Créez un cluster Stream Analytics ou remplace un cluster déjà existant.

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

Exemples

Créer un cluster

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

Paramètres obligatoires

--cluster-name --name -n

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--if-match

ETag de la ressource. Omettez cette valeur pour toujours remplacer le jeu d’enregistrements actif. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

--if-none-match

Définissez la valeur « * » pour autoriser la création d’une nouvelle ressource, mais pour empêcher la mise à jour d’un jeu d’enregistrements existant. D’autres valeurs entraînent une réponse 412 en cas d’échec de la condition.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--sku

Référence SKU du cluster. Cela détermine la taille/la capacité du cluster. Obligatoire sur les requêtes PUT (CreateOrUpdate).

Utilisation : --sku name=XX capacity=XX

nom : spécifie le nom de la référence SKU du cluster. Obligatoire sur les requêtes PUT (CreateOrUpdate). capacité : indique le nombre d’unités de diffusion en continu que le cluster peut prendre en charge. Les valeurs valides pour cette propriété sont des multiples de 36 avec une valeur minimale de 36 et une valeur maximale de 216. Obligatoire sur les requêtes PUT (CreateOrUpdate).

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az stream-analytics cluster delete

Supprimez le cluster spécifié.

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

Exemples

Suppression d'un cluster

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

Paramètres facultatifs

--cluster-name --name -n

Nom du cluster.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az stream-analytics cluster list

Répertoriez tous les clusters dans le groupe de ressources donné. Et répertorie tous les clusters dans l’abonnement donné.

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

Exemples

Répertorier les clusters dans un groupe de ressources

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

Répertorier les clusters dans un abonnement

az stream-analytics cluster list

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az stream-analytics cluster list-streaming-job

Répertoriez tous les travaux de diffusion en continu dans le cluster donné.

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

Exemples

Répertorier tous les travaux de streaming dans le cluster

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

Paramètres obligatoires

--cluster-name --name -n

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az stream-analytics cluster show

Obtenez des informations sur le cluster spécifié.

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

Exemples

Obtenir un cluster

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

Paramètres facultatifs

--cluster-name --name -n

Nom du cluster.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az stream-analytics cluster update

Mettez à jour un cluster existant. Cela peut être utilisé pour mettre à jour partiellement (par exemple, mettre à jour une ou deux propriétés) un cluster sans affecter le reste de la définition du cluster.

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

Exemples

Mettre à jour un cluster

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

Paramètres facultatifs

--cluster-name --name -n

Nom du cluster.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--if-match

ETag de la ressource. Omettez cette valeur pour toujours remplacer le jeu d’enregistrements actif. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--sku

Référence SKU du cluster. Cela détermine la taille/la capacité du cluster. Obligatoire sur les requêtes PUT (CreateOrUpdate).

Utilisation : --sku name=XX capacity=XX

nom : spécifie le nom de la référence SKU du cluster. Obligatoire sur les requêtes PUT (CreateOrUpdate). capacité : indique le nombre d’unités de diffusion en continu que le cluster peut prendre en charge. Les valeurs valides pour cette propriété sont des multiples de 36 avec une valeur minimale de 36 et une valeur maximale de 216. Obligatoire sur les requêtes PUT (CreateOrUpdate).

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az stream-analytics cluster wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition du cluster Stream-Analytics soit remplie.

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

Exemples

Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que le cluster Stream-Analytics soit correctement créé.

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

Suspendez l’exécution de la ligne de script CLI suivante jusqu’à ce que le cluster Stream-Analytics soit correctement mis à jour.

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

Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que le cluster Stream-Analytics soit correctement supprimé.

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

Paramètres facultatifs

--cluster-name --name -n

Nom du cluster.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.