Riferimento dei comandi

Visualizza come Markdown

Ogni comando della CLI status200, con i suoi argomenti, le sue opzioni e i suoi valori predefiniti. Aggiungi --help a qualsiasi comando per vedere la stessa cosa nel tuo terminale.

Opzioni globaliLe opzioni che ogni comando accetta.Accesso e contestilogin e i comandi context.Comandi delle risorselist, get, create, update, delete e count.Altri comandideploy, whoami, resources, version e help.

I comandi

flowchart LR O["status200"] --> L["login"] O --> C["context"] C --> C1["list use current delete"] O --> R["incident, monitor e ogni risorsa"] R --> R1["list get create update delete count"] O --> U["deploy whoami resources version help"]

I comandi della CLI status200

Opzioni globali

Opzione	Che cosa fa	Predefinito
`--api-key <key>`	La chiave API per questo comando	`STATUS200_API_KEY`, poi la chiave del contesto
`--url <url>`	L'indirizzo del tuo Status200 per questo comando	`STATUS200_URL`, poi l'URL del contesto
`--context <name>`	Il contesto salvato da usare per questo comando	Il contesto attuale
`-o, --output <format>`	`json`, `table` o `wide`	`table` in un terminale, `json` in una pipe
`--no-color`	Stampa senza colori	Colori, a meno che `NO_COLOR` non sia impostata
`-V, --version`	Stampa la versione della CLI
`-h, --help`	Mostra la guida di un comando

Le opzioni vanno prima o dopo il comando: status200 --context staging incident list e status200 incident list --context staging fanno la stessa cosa.

Accesso e contesti

Salva una chiave API e un indirizzo come contesto, e lo rende quello attuale. Vedi Accedere.

Bash

status200 login <api-key> <instance-url> [--context-name <name>]

Argomento o opzione	Obbligatorio	Che cos'è	Predefinito
`<api-key>`	Sì	Una chiave API del tuo progetto
`<instance-url>`	Sì	L'indirizzo del tuo Status200, come `https://status200.ru`
`--context-name <name>`	No	Il nome con cui salvare il contesto	`default`

`status200 context list`

Elenca i contesti salvati; * segna quello attuale. Le chiavi API non vengono mai elencate.

Bash

status200 context list [-o <format>]

Opzione	Obbligatorio	Che cos'è
`-o, --output <format>`	No	`json`, `table` o `wide`. Il JSON dà il `name`, l'`apiUrl` e l'`isCurrent` di ogni contesto

`status200 context use`

Rende attuale un contesto salvato.

Bash

status200 context use <name>

Argomento	Obbligatorio	Che cos'è
`<name>`	Sì	Il nome di un contesto salvato

`status200 context current`

Mostra il nome e l'URL del contesto attuale, e la sua chiave API nascosta tranne i primi quattro e gli ultimi quattro caratteri.

Bash

status200 context current

`status200 context delete`

Elimina un contesto salvato. Se era quello attuale, diventa attuale il primo contesto rimasto.

Bash

status200 context delete <name>

Argomento	Obbligatorio	Che cos'è
`<name>`	Sì	Il nome di un contesto salvato

Comandi delle risorse

<resource> è il comando di un tipo di record, preso dalle tabelle Risorse, come incident o monitor. Vedi Operazioni sulle risorse per degli esempi.

`status200 <resource> list`

Elenca i record, i più recenti prima. Le etichette sono invece elencate per nome, prima quelle numerate (2. Team prima di 10. Owner).

Bash

status200 <resource> list [--query <json>] [--limit <n>] [--skip <n>] [--sort <json>] [-o <format>]

Opzione	Che cosa fa	Predefinito
`--query <json>`	Un filtro, in JSON	Ogni record che la chiave può leggere
`--limit <n>`	Il numero massimo di record da restituire, fino a 10.000	`10`
`--skip <n>`	Quanti record saltare prima	`0`
`--sort <json>`	L'ordine, in JSON: `{"<field>":"ASC"}` o `{"<field>":"DESC"}`	I più recenti prima
`-o, --output <format>`	`json`, `table` o `wide`	`table` in un terminale, `json` in una pipe

`status200 <resource> get`

Legge un record. Solo record: la telemetria non ha get.

Bash

status200 <resource> get <id> [-o <format>]

Argomento o opzione	Obbligatorio	Che cos'è
`<id>`	Sì	L'ID del record, un UUID
`-o, --output <format>`	No	`json`, `table` o `wide`

`status200 <resource> create`

Crea un record e lo stampa.

Bash

status200 <resource> create (--data <json> | --file <path>) [-o <format>]

Opzione	Obbligatorio	Che cos'è
`--data <json>`	Una delle due	Il record, in JSON
`--file <path>`	Una delle due	Un file JSON che contiene il record. Indicato insieme a `--data`, viene usato il file
`-o, --output <format>`	No	`json`, `table` o `wide`

`status200 <resource> update`

Modifica i campi che indichi. Solo record: la telemetria non ha update.

Bash

status200 <resource> update <id> --data <json> [-o <format>]

Argomento o opzione	Obbligatorio	Che cos'è
`<id>`	Sì	L'ID del record
`--data <json>`	Sì	I campi da modificare, in JSON
`-o, --output <format>`	No	`json`, `table` o `wide`

`status200 <resource> delete`

Elimina un record subito, senza chiedere. Solo record: la telemetria non ha delete.

Bash

status200 <resource> delete <id> [--force]

Argomento o opzione	Obbligatorio	Che cos'è
`<id>`	Sì	L'ID del record
`--force`	No	Accettato e non cambia nulla: `delete` non chiede mai conferma

`status200 <resource> count`

Conta i record e stampa il numero.

Bash

status200 <resource> count [--query <json>] [-o <format>]

Opzione	Obbligatorio	Che cos'è
`--query <json>`	No	Un filtro, in JSON. Senza filtro, ogni record che la chiave può leggere
`-o, --output <format>`	No	`json`, `table` o `wide`

Risorse

I record accettano list, get, create, update, delete e count:

Area	Comandi
Monitoraggio	`monitor`, `monitor-status`, `monitor-status-event`
Incidenti	`incident`, `incident-state`, `incident-severity`, `incident-state-timeline`, `incident-public-note`, `incident-internal-note`, `incident-alert`, `postmortem-status`
Avvisi	`alert`, `alert-state`, `alert-severity`, `alert-state-timeline`, `alert-internal-note`
Pagine di stato	`status-page`, `status-page-announcement`
Manutenzione programmata	`scheduled-maintenance-event`, `scheduled-maintenance-state`, `scheduled-maintenance-state-timeline`
Team e reperibilità	`team`, `on-call-policy`
Sicurezza	`security-case`, `security-case-note`, `security-detection`, `security-playbook`
Etichette	`label`

La telemetria accetta list, create e count:

Area	Comandi
Osservabilità	`log`, `metric`, `span`, `exception-instance`, `monitor-log`
Sicurezza	`security-event`, `threat-intel-indicator`
Modifiche e costi	`change-event`, `kubernetes-cost-allocation`

La CLI esce insieme a Status200, quindi status200 resources elenca i comandi della versione che hai installato.

Richieste all'API

Ogni operazione è una richiesta all'API, con la chiave nell'intestazione APIKey. <path> è il percorso API della risorsa, dato da status200 resources: /incident per incident, /on-call-duty-policy per on-call-policy.

Operazione	Richiesta	Corpo
`list`	`POST /api/<path>/get-list`	`query`, `select`, `skip`, `limit` e `sort`
`get`	`POST /api/<path>/<id>/get-item`	`select`
`create`	`POST /api/<path>`	`{"data": ...}`
`update`	`PUT /api/<path>/<id>/`	`{"data": ...}`
`delete`	`DELETE /api/<path>/<id>/`	Nessuno
`count`	`POST /api/<path>/count`	`query`

Altri comandi

`status200 deploy`

Registra da una pipeline un deploy o un'altra modifica, che compare sui grafici del servizio e che Status200 AI legge quando indaga su un incidente. Scrive con una chiave di acquisizione della telemetria, non con una chiave API. Vedi Deploy e modifiche.

Bash

status200 deploy [--service <name>] [--service-version <version>] [--previous-version <version>] [--commit <sha>] [--repository <url>] [--branch <name>] [--pull-request <number>] [--environment <name>] [--title <title>] [--description <text>] [--type <type>] [--time <time>] [--attribute <key=value...>] [--ingestion-key <key>]

Opzione	Obbligatorio	Che cos'è	Predefinito
`--service <name>`	No	Il servizio rilasciato	Una modifica che riguarda tutto il progetto
`--service-version <version>`	No	La versione rilasciata
`--previous-version <version>`	No	La versione che ha sostituito
`--commit <sha>`	No	Il commit rilasciato
`--repository <url>`	No	Il repository in cui si trova il commit
`--branch <name>`	No	Il branch rilasciato
`--pull-request <number>`	No	La pull request rilasciata
`--environment <name>`	No	L'ambiente in cui è stato rilasciato
`--title <title>`	No	Il titolo della modifica; un tipo diverso da un deploy ne richiede uno	`Deploy <version>`
`--description <text>`	No	I dettagli della modifica
`--type <type>`	No	Il tipo di modifica, come `config-change` o `rollback`	`deployment`
`--time <time>`	No	Quando è avvenuta, come `2026-10-19T10:00:00Z`	Adesso
`--attribute <key=value...>`	No	Altri attributi, come `key=value`, uno o più
`--ingestion-key <key>`	No	Una chiave di acquisizione della telemetria del progetto	`STATUS200_TELEMETRY_INGESTION_KEY`

`status200 whoami`

Mostra l'URL e la chiave API che userà il prossimo comando, con la chiave mascherata, e il contesto da cui provengono. Non chiama Status200. Vedi Verificare che cosa userà la CLI.

Bash

status200 whoami

`status200 resources`

Elenca ogni tipo di record per cui la CLI ha un comando: il suo comando, i nomi al singolare e al plurale, il tipo e il percorso API, e il totale.

Bash

status200 resources [--type <type>] [-o <format>]

Opzione	Obbligatorio	Che cos'è	Predefinito
`--type <type>`	No	`database` per i record, `analytics` per la telemetria	Entrambi
`-o, --output <format>`	No	`json`, `table` o `wide`. Il JSON dà il `name`, il `singularName`, il `pluralName`, il `modelType` e l'`apiPath` di ciascuno	`table` in un terminale, `json` in una pipe

`status200 version`

Stampa la versione della CLI, come fa status200 --version.

Bash

status200 version

`status200 help`

Mostra la guida della CLI, o quella di un comando.

Bash

status200 help [command]

Variabili d'ambiente

Variabile	Che cosa fa
`STATUS200_API_KEY`	La chiave API, quando nessun flag `--api-key` ne dà una
`STATUS200_URL`	L'indirizzo del tuo Status200, quando nessun flag `--url` ne dà uno
`STATUS200_TELEMETRY_INGESTION_KEY`	La chiave di acquisizione della telemetria con cui scrive `status200 deploy`, quando nessun flag `--ingestion-key` ne dà una
`NO_COLOR`	Impostata a un valore qualsiasi, disattiva i colori

File

File	Che cosa contiene
`~/.oneuptime/config.json`	I contesti salvati, le loro chiavi API e il contesto attuale

Codici di uscita

Codice	Significato
`0`	Ha funzionato
`1`	Non è riuscito: Status200 ha rifiutato la richiesta, oppure il comando era sbagliato
`2`	Nessuna chiave API utilizzabile: nessuna trovata, non valida o sotto il suo piano
`3`	Non trovato: Status200 ha risposto `404`

Vedi Codici di uscita per degli esempi.

Passi successivi

Panoramica della CLIInstallare la CLI ed eseguire i primi comandi.Operazioni sulle risorseEsempi di ogni operazione.Scripting e CI/CDLa CLI in script e pipeline.

I comandi#

Opzioni globali#

Accesso e contesti#

status200 login#

status200 context list#

status200 context use#

status200 context current#

status200 context delete#

Comandi delle risorse#

status200 <resource> list#

status200 <resource> get#

status200 <resource> create#

status200 <resource> update#

status200 <resource> delete#

status200 <resource> count#

Risorse#

Richieste all'API#

Altri comandi#

status200 deploy#

status200 whoami#

status200 resources#

status200 version#

status200 help#

Variabili d'ambiente#

File#

Codici di uscita#

Passi successivi#

I comandi

Opzioni globali

Accesso e contesti

`status200 login`

`status200 context list`

`status200 context use`

`status200 context current`

`status200 context delete`

Comandi delle risorse

`status200 <resource> list`

`status200 <resource> get`

`status200 <resource> create`

`status200 <resource> update`

`status200 <resource> delete`

`status200 <resource> count`

Risorse

Richieste all'API

Altri comandi

`status200 deploy`

`status200 whoami`

`status200 resources`

`status200 version`

`status200 help`

Variabili d'ambiente

File

Codici di uscita

Passi successivi