Condividi tramite

az tsi environment gen1

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione timeseriesinsights per l'interfaccia della riga di comando di Azure (versione 2.50.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az tsi environment gen1 . Altre informazioni sulle estensioni.

Gestire un ambiente gen1 nella sottoscrizione e nel gruppo di risorse specificati.

Comandi

Nome Descrizione Tipo Status
az tsi environment gen1 create

Creare un ambiente gen1 nella sottoscrizione e nel gruppo di risorse specificati.

 Estensione Disponibilità generale
az tsi environment gen1 update

Aggiornare un ambiente gen1 nella sottoscrizione e nel gruppo di risorse specificati.

 Estensione Disponibilità generale

az tsi environment gen1 create

Creare un ambiente gen1 nella sottoscrizione e nel gruppo di risorse specificati.

az tsi environment gen1 create --data-retention-time
                               --environment-name
                               --location
                               --resource-group
                               --sku
                               [--exceeded-behavior {PauseIngress, PurgeOldData}]
                               [--key-properties]
                               [--no-wait]
                               [--tags]

Esempio

EnvironmentsGen1Create

az tsi environment gen1 create --name "env1" --location westus --data-retention-time "P31D" --partition-key-properties name="DeviceId1" type="String" --sku name="S1" capacity=1 --resource-group "rg1"

Parametri necessari

--data-retention-time

ISO8601 intervallo di tempo che specifica il numero minimo di giorni in cui gli eventi dell'ambiente saranno disponibili per la query.

--environment-name --name -n

Nome dell'ambiente.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sku

Lo SKU determina il tipo di ambiente, S1 o S2. Per gli ambienti Gen1, lo SKU determina la capacità dell'ambiente, la tariffa in ingresso e la tariffa di fatturazione.

Utilizzo: --sku name=XX capacity=XX

name: obbligatorio. Nome di questo SKU. capacity: obbligatorio. Capacità dello SKU. Questo valore può essere modificato per supportare la scalabilità orizzontale degli ambienti dopo la creazione.

Parametri facoltativi

--exceeded-behavior --storage-limit-exceeded-behavior

Il comportamento che il servizio Time Series Insights deve assumere quando è stata superata la capacità dell'ambiente. Se si specifica "PauseIngress", i nuovi eventi non verranno letti dall'origine evento. Se si specifica "PurgeOldData", i nuovi eventi continueranno a essere letti e gli eventi precedenti verranno eliminati dall'ambiente. Il comportamento predefinito è PurgeOldData.

Valori accettati: PauseIngress, PurgeOldData
--key-properties --partition-key-properties

Elenco di proprietà evento che verranno usate per partizionare i dati nell'ambiente. Attualmente è supportata solo una singola proprietà della chiave di partizione.

Utilizzo: --partition-key-properties name=XX type=XX

name: nome della proprietà. type: tipo della proprietà.

È possibile specificare più azioni usando più di un argomento --partition-key-properties.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az tsi environment gen1 update

Aggiornare un ambiente gen1 nella sottoscrizione e nel gruppo di risorse specificati.

az tsi environment gen1 update [--data-retention-time]
                               [--environment-name]
                               [--exceeded-behavior {PauseIngress, PurgeOldData}]
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sku]
                               [--subscription]
                               [--tags]

Esempio

EnvironmentsGen1Update

az tsi environment gen1 update --name "env1" --sku name="S1" capacity=2                --resource-group "rg1" --data-retention-time "P30D" --storage-limit-exceeded-behavior PurgeOldData

Parametri facoltativi

--data-retention-time

ISO8601 intervallo di tempo che specifica il numero minimo di giorni in cui gli eventi dell'ambiente saranno disponibili per la query.

--environment-name --name -n

Nome dell'ambiente.

--exceeded-behavior --storage-limit-exceeded-behavior

Il comportamento che il servizio Time Series Insights deve assumere quando è stata superata la capacità dell'ambiente. Se si specifica "PauseIngress", i nuovi eventi non verranno letti dall'origine evento. Se si specifica "PurgeOldData", i nuovi eventi continueranno a essere letti e gli eventi precedenti verranno eliminati dall'ambiente. Il comportamento predefinito è PurgeOldData.

Valori accettati: PauseIngress, PurgeOldData
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sku

Lo SKU determina il tipo di ambiente, S1 o S2. Per gli ambienti Gen1, lo SKU determina la capacità dell'ambiente, la tariffa in ingresso e la tariffa di fatturazione.

Utilizzo: --sku name=XX capacity=XX

name: obbligatorio. Nome di questo SKU. capacity: obbligatorio. Capacità dello SKU. Questo valore può essere modificato per supportare la scalabilità orizzontale degli ambienti dopo la creazione.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.