# CLI – Übersicht

Die Status200-CLI, `status200`, verwaltet Ihr Status200-Projekt aus einem Terminal oder einem Skript. Sie listet, liest, erstellt, ändert, löscht und zählt Monitore, Vorfälle, Warnungen, Statusseiten und die anderen Datensätze, die die Status200-API anbietet, mit einem API-Schlüssel Ihres Projekts.

:::cards
- [Wie die CLI arbeitet](#wie-die-cli-arbeitet): Ein Befehl, eine API-Anfrage, eine Antwort.
- [Die CLI installieren](#die-cli-installieren): Ein npm-Befehl, und welche Version Sie wählen.
- [Die ersten Befehle ausführen](#die-ersten-befehle-ausführen): Speichern Sie Ihren API-Schlüssel und listen Sie dann Ihre Vorfälle auf.
- [Die Befehle auf einen Blick](#die-befehle-auf-einen-blick): Jeder Befehl und die Seite, die ihn erklärt.
:::

## Wie die CLI arbeitet

Jeder Befehl sendet eine Anfrage an die REST API von Status200 und gibt die Antwort aus. Den API-Schlüssel und die Adresse Ihrer Status200-Instanz nimmt die CLI aus Flags, Umgebungsvariablen oder einem Kontext, den `status200 login` gespeichert hat. Der Schlüssel entscheidet, was ein Befehl lesen und ändern darf, genau wie bei der API.

```mermaid title="Ein Befehl, eine Anfrage"
flowchart TB
    T["Ihr Terminal<br/>oder ein CI-Job"] -->|"status200 incident list"| C["status200-CLI"]
    K["API-Schlüssel und URL:<br/>Flags, Umgebung<br/>oder ein gespeicherter<br/>Kontext"] --> C
    C -->|"POST /api/incident/get-list"| A["REST API von Status200"]
    A -->|"die Datensätze, die der<br/>Schlüssel lesen darf,<br/>als JSON"| C
    C -->|"eine Tabelle im Terminal,<br/>JSON in einer Pipe"| T
```

Die Befehle für Datensätze bringt die CLI mit: Jede Art von Datensatz, die die Status200-API für Werkzeuge öffnet, hat einen, dieselben Datensätze, für die der [MCP-Server](/docs/ai/mcp-server) Werkzeuge hat. `status200 resources` listet sie auf.

## Bevor Sie beginnen

- **Node.js und npm**, ein aktuelles LTS-Release, um die CLI zu installieren.
- **Ein API-Schlüssel Ihres Projekts.** Legen Sie einen unter **Projekteinstellungen → Erweitert → API-Schlüssel** mit **API-Schlüssel erstellen** an: siehe [Einen API-Schlüssel anlegen](/docs/api-reference/api-reference#einen-api-schlüssel-anlegen).
- **In Status200 Cloud der Tarif Growth oder höher.** Die API-Schlüssel eines Projekts funktionieren nur dort: siehe [API-Schlüssel und SCIM unterhalb ihres Tarifs](/docs/api-reference/api-reference#api-schlüssel-und-scim-unterhalb-ihres-tarifs).

## Die CLI installieren

Installieren Sie das Paket `@status200/cli` aus npm. Es fügt den Befehl `status200` hinzu, und `--version` gibt die installierte Version aus:

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

Die CLI erscheint mit Status200 und hat dieselbe Versionsnummer. Bei einer selbst gehosteten Status200-Instanz installieren Sie die CLI in der Version Ihrer Instanz, damit ihre Befehle zu den Datensätzen Ihres Servers passen:

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

## Die ersten Befehle ausführen

:::steps
### Ihren API-Schlüssel speichern

Melden Sie sich mit dem Schlüssel und der Adresse Ihrer Status200-Instanz an. Die CLI speichert beides als Kontext namens `default` und verwendet ihn ab jetzt:

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

Sie antwortet `Logged in successfully. Context "default" is now active.` Bei einer selbst gehosteten Instanz verwenden Sie deren Adresse anstelle von `https://status200.ru`.

### Ihre Vorfälle auflisten

```bash
status200 incident list
```

Die zehn neuesten Vorfälle erscheinen als Tabelle. `login` speichert den Schlüssel, ohne ihn zu prüfen, daher zeigt erst dieser Befehl, dass der Schlüssel funktioniert: Wird er abgelehnt, siehe [Fehlerbehebung](/docs/cli/authentication#fehlerbehebung).

### Sehen, was Sie sonst noch verwalten können

```bash
status200 resources
```

Die Liste zeigt jede Art von Datensatz, mit der Sie arbeiten können, und ihren Befehl, etwa `monitor`, `status-page` oder `on-call-policy`.
:::

## Die Befehle auf einen Blick

| Befehl | Was er tut | Mehr dazu |
| --- | --- | --- |
| `status200 login <api-key> <instance-url>` | Speichert einen API-Schlüssel und eine Adresse als Kontext | [Authentifizierung](/docs/cli/authentication#anmelden) |
| `status200 context list`, `use`, `current`, `delete` | Listet, wechselt, zeigt und löscht gespeicherte Kontexte | [Authentifizierung](/docs/cli/authentication#kontexte) |
| `status200 whoami` | Zeigt die URL und den API-Schlüssel, die der nächste Befehl verwendet | [Authentifizierung](/docs/cli/authentication#prüfen-was-die-cli-verwenden-wird) |
| `status200 deploy` | Zeichnet einen Deploy oder eine andere Änderung für die Diagramme und Status200 AI auf | [Deploys und Änderungen](/docs/telemetry/change-events) |
| `status200 <resource> list`, `get`, `create`, `update`, `delete`, `count` | Arbeitet mit einer Art von Datensatz | [Ressourcenoperationen](/docs/cli/resource-operations) |
| `status200 resources` | Listet die Arten von Datensätzen mit ihren Befehlen auf | [Befehlsreferenz](/docs/cli/command-reference#status200-resources) |
| `status200 version` | Gibt die Version der CLI aus | [Befehlsreferenz](/docs/cli/command-reference#status200-version) |
| `status200 help [command]` | Zeigt die Hilfe eines Befehls | [Hilfe erhalten](#hilfe-erhalten) |

## Globale Optionen

Diese Optionen funktionieren mit jedem Befehl, davor oder dahinter:

| Option | Was sie tut |
| --- | --- |
| `--api-key <key>` | Der API-Schlüssel für diesen Befehl, anstelle des gespeicherten |
| `--url <url>` | Die Adresse Ihrer Status200-Instanz für diesen Befehl |
| `--context <name>` | Ein gespeicherter Kontext für diesen Befehl, anstelle des aktuellen |
| `-o, --output <format>` | `table`, `json` oder `wide`: siehe [Ausgabeformate](/docs/cli/output-formats) |
| `--no-color` | Gibt ohne Farben aus |
| `-V, --version` | Gibt die Version der CLI aus |
| `-h, --help` | Zeigt die Hilfe des Befehls |

## Hilfe erhalten

Jeder Befehl hat seine eigene Hilfe, mit seinen Argumenten, Optionen und Standardwerten:

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

## Nächste Schritte

:::cards
- [Authentifizierung](/docs/cli/authentication): Kontexte für jede Umgebung, und welchen Schlüssel ein Befehl verwendet.
- [Ressourcenoperationen](/docs/cli/resource-operations): Datensätze auflisten, lesen, erstellen, ändern, löschen und zählen.
- [Ausgabeformate](/docs/cli/output-formats): Tabellen für Menschen, JSON für Skripte.
- [Skripting & CI/CD](/docs/cli/scripting): Exit-Codes, jq und Pipelines.
- [Befehlsreferenz](/docs/cli/command-reference): Jeder Befehl, jede Option und jeder Standardwert.
:::