# CLI – Overzicht

De Status200-CLI, `status200`, beheert je Status200-project vanuit een terminal of een script. Hij toont, leest, maakt, wijzigt, verwijdert en telt monitoren, incidenten, waarschuwingen, statuspagina's en de andere records die de Status200-API aanbiedt, met een API-sleutel van je project.

:::cards
- [Hoe de CLI werkt](#hoe-de-cli-werkt): Eén opdracht, één API-verzoek, één antwoord.
- [De CLI installeren](#de-cli-installeren): Eén npm-opdracht, en welke versie je kiest.
- [Je eerste opdrachten uitvoeren](#je-eerste-opdrachten-uitvoeren): Sla je API-sleutel op en toon dan je incidenten.
- [De opdrachten in één oogopslag](#de-opdrachten-in-één-oogopslag): Elke opdracht, en de pagina die hem uitlegt.
:::

## Hoe de CLI werkt

Elke opdracht stuurt één verzoek naar de REST API van Status200 en drukt het antwoord af. De CLI haalt de API-sleutel en het adres van je Status200 uit vlaggen, omgevingsvariabelen of een context die `status200 login` heeft opgeslagen. De sleutel bepaalt wat een opdracht mag lezen en wijzigen, precies zoals bij de API.

```mermaid title="Eén opdracht, één verzoek"
flowchart TB
    T["Je terminal<br/>of een CI-job"] -->|"status200 incident list"| C["status200-CLI"]
    K["De API-sleutel en URL:<br/>vlaggen, omgeving<br/>of een opgeslagen context"] --> C
    C -->|"POST /api/incident/get-list"| A["REST API van Status200"]
    A -->|"de records die de<br/>sleutel mag lezen,<br/>als JSON"| C
    C -->|"een tabel in een terminal,<br/>JSON in een pipe"| T
```

De opdrachten voor records komen met de CLI mee: elk soort record dat de Status200-API voor tools openstelt, heeft er een, dezelfde records waarvoor de [MCP-server](/docs/ai/mcp-server) tools heeft. Voer `status200 resources` uit om ze te tonen.

## Voordat je begint

- **Node.js en npm**, een actuele LTS-release, om de CLI te installeren.
- **Een API-sleutel van je project.** Maak er een aan in **Projectinstellingen → Geavanceerd → API-sleutels** met **API-sleutel aanmaken**: zie [Een API-sleutel aanmaken](/docs/api-reference/api-reference#een-api-sleutel-aanmaken).
- **Op Status200 Cloud het Growth-abonnement of hoger.** De API-sleutels van een project werken alleen daarop: zie [API-sleutels en SCIM onder hun abonnement](/docs/api-reference/api-reference#api-sleutels-en-scim-onder-hun-abonnement).

## De CLI installeren

Installeer het pakket `@status200/cli` vanuit npm. Het voegt de opdracht `status200` toe, en `--version` drukt de geïnstalleerde versie af:

```bash
npm install -g @status200/cli
status200 --version
```

De CLI verschijnt samen met Status200 en heeft hetzelfde versienummer. Op een zelf gehoste Status200 installeer je de CLI van de versie van je Status200, zodat de opdrachten passen bij de records die je server heeft:

```bash
npm install -g @status200/cli@<your-oneuptime-version>
```

## Je eerste opdrachten uitvoeren

:::steps
### Je API-sleutel opslaan

Log in met de sleutel en het adres van je Status200. De CLI slaat ze op als een context met de naam `default` en gebruikt die vanaf nu:

```bash
status200 login <your-api-key> https://status200.ru
```

Hij antwoordt `Logged in successfully. Context "default" is now active.` Gebruik op een zelf gehoste Status200 het adres daarvan in plaats van `https://status200.ru`.

### Je incidenten tonen

```bash
status200 incident list
```

De tien nieuwste incidenten verschijnen als tabel. `login` slaat de sleutel op zonder hem te controleren, dus dit is de eerste opdracht die laat zien dat de sleutel werkt: wordt hij geweigerd, zie dan [Problemen oplossen](/docs/cli/authentication#problemen-oplossen).

### Zien wat je nog meer kunt beheren

```bash
status200 resources
```

De lijst toont elk soort record waarmee je kunt werken, en de opdracht ervan, zoals `monitor`, `status-page` of `on-call-policy`.
:::

## De opdrachten in één oogopslag

| Opdracht | Wat hij doet | Meer lezen |
| --- | --- | --- |
| `status200 login <api-key> <instance-url>` | Slaat een API-sleutel en een adres op als context | [Authenticatie](/docs/cli/authentication#inloggen) |
| `status200 context list`, `use`, `current`, `delete` | Toont, wisselt, laat zien en verwijdert opgeslagen contexten | [Authenticatie](/docs/cli/authentication#contexten) |
| `status200 whoami` | Toont de URL en API-sleutel die de volgende opdracht gebruikt | [Authenticatie](/docs/cli/authentication#controleren-wat-de-cli-gaat-gebruiken) |
| `status200 deploy` | Legt een deploy, of een andere wijziging, vast voor grafieken en Status200 AI | [Deploys en wijzigingen](/docs/telemetry/change-events) |
| `status200 <resource> list`, `get`, `create`, `update`, `delete`, `count` | Werkt met één soort record | [Bewerkingen op bronnen](/docs/cli/resource-operations) |
| `status200 resources` | Toont de soorten records, met hun opdrachten | [Opdrachtreferentie](/docs/cli/command-reference#status200-resources) |
| `status200 version` | Drukt de versie van de CLI af | [Opdrachtreferentie](/docs/cli/command-reference#status200-version) |
| `status200 help [command]` | Toont de hulp van een opdracht | [Hulp krijgen](#hulp-krijgen) |

## Globale opties

Deze opties werken met elke opdracht, ervoor of erna:

| Optie | Wat hij doet |
| --- | --- |
| `--api-key <key>` | De API-sleutel voor deze opdracht, in plaats van de opgeslagen |
| `--url <url>` | Het adres van je Status200 voor deze opdracht |
| `--context <name>` | Een opgeslagen context voor deze opdracht, in plaats van de huidige |
| `-o, --output <format>` | `table`, `json` of `wide`: zie [Uitvoerformaten](/docs/cli/output-formats) |
| `--no-color` | Drukt af zonder kleuren |
| `-V, --version` | Drukt de versie van de CLI af |
| `-h, --help` | Toont de hulp van de opdracht |

## Hulp krijgen

Elke opdracht heeft zijn eigen hulp, met zijn argumenten, opties en standaardwaarden:

```bash
status200 --help
status200 help incident
status200 incident list --help
```

## Volgende stappen

:::cards
- [Authenticatie](/docs/cli/authentication): Contexten voor elke omgeving, en welke sleutel een opdracht gebruikt.
- [Bewerkingen op bronnen](/docs/cli/resource-operations): Records tonen, lezen, maken, wijzigen, verwijderen en tellen.
- [Uitvoerformaten](/docs/cli/output-formats): Tabellen voor mensen, JSON voor scripts.
- [Scripting en CI/CD](/docs/cli/scripting): Exitcodes, jq en pipelines.
- [Opdrachtreferentie](/docs/cli/command-reference): Elke opdracht, optie en standaardwaarde.
:::