# CLI – Oversigt

Status200-CLI'en, `status200`, administrerer dit Status200-projekt fra en terminal eller et script. Den viser, læser, opretter, ændrer, sletter og tæller monitorer, hændelser, advarsler, statussider og de andre poster, som Status200-API'et tilbyder, med en API-nøgle til dit projekt.

:::cards
- [Sådan virker CLI'en](#sådan-virker-clien): Én kommando, én API-anmodning, ét svar.
- [Installér CLI'en](#installér-clien): Én npm-kommando, og hvilken version du skal vælge.
- [Kør dine første kommandoer](#kør-dine-første-kommandoer): Gem din API-nøgle, og vis så dine hændelser.
- [Kommandoerne på et øjeblik](#kommandoerne-på-et-øjeblik): Hver kommando, og siden der forklarer den.
:::

## Sådan virker CLI'en

Hver kommando sender én anmodning til Status200s REST API og udskriver svaret. CLI'en tager API-nøglen og adressen på din Status200 fra flag, miljøvariabler eller en kontekst, som `status200 login` har gemt. Nøglen afgør, hvad en kommando må læse og ændre, præcis som for API'et.

```mermaid title="Én kommando, én anmodning"
flowchart TB
    T["Din terminal<br/>eller et CI-job"] -->|"status200 incident list"| C["status200-CLI"]
    K["API-nøglen og URL'en:<br/>flag, miljø<br/>eller en gemt kontekst"] --> C
    C -->|"POST /api/incident/get-list"| A["Status200s REST API"]
    A -->|"de poster, nøglen<br/>må læse, som JSON"| C
    C -->|"en tabel i en terminal,<br/>JSON i en pipe"| T
```

Kommandoerne til poster følger med CLI'en: hver slags post, som Status200-API'et åbner for værktøjer, har én, de samme poster, som [MCP-serveren](/docs/ai/mcp-server) har værktøjer til. Kør `status200 resources` for at vise dem.

## Før du begynder

- **Node.js og npm**, i en aktuel LTS-version, til at installere CLI'en.
- **En API-nøgle til dit projekt.** Opret en under **Projektindstillinger → Avanceret → API-nøgler** med **Opret API-nøgle**: se [Opret en API-nøgle](/docs/api-reference/api-reference#opret-en-api-nøgle).
- **På Status200 Cloud abonnementet Growth eller højere.** Et projekts API-nøgler virker kun på det: se [API-nøgler og SCIM under deres abonnement](/docs/api-reference/api-reference#api-nøgler-og-scim-under-deres-abonnement).

## Installér CLI'en

Installér pakken `@status200/cli` fra npm. Den tilføjer kommandoen `status200`, og `--version` udskriver den version, du har installeret:

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

CLI'en udgives sammen med Status200 og har det samme versionsnummer. På en selvhostet Status200 skal du installere CLI'en i din Status200s version, så dens kommandoer passer til de poster, din server har:

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

## Kør dine første kommandoer

:::steps
### Gem din API-nøgle

Log ind med nøglen og adressen på din Status200. CLI'en gemmer dem som en kontekst ved navn `default` og bruger den fremover:

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

Den svarer `Logged in successfully. Context "default" is now active.` På en selvhostet Status200 bruger du dens adresse i stedet for `https://status200.ru`.

### Vis dine hændelser

```bash
status200 incident list
```

De ti nyeste hændelser vises som en tabel. `login` gemmer nøglen uden at tjekke den, så dette er den første kommando, der viser, at nøglen virker: bliver den afvist, så se [Fejlfinding](/docs/cli/authentication#fejlfinding).

### Se, hvad du ellers kan administrere

```bash
status200 resources
```

Listen viser hver slags post, du kan arbejde med, og dens kommando, for eksempel `monitor`, `status-page` eller `on-call-policy`.
:::

## Kommandoerne på et øjeblik

| Kommando | Hvad den gør | Læs mere |
| --- | --- | --- |
| `status200 login <api-key> <instance-url>` | Gemmer en API-nøgle og en adresse som en kontekst | [Godkendelse](/docs/cli/authentication#log-ind) |
| `status200 context list`, `use`, `current`, `delete` | Viser, skifter, oplyser og sletter gemte kontekster | [Godkendelse](/docs/cli/authentication#kontekster) |
| `status200 whoami` | Viser den URL og API-nøgle, som den næste kommando vil bruge | [Godkendelse](/docs/cli/authentication#tjek-hvad-clien-vil-bruge) |
| `status200 deploy` | Registrerer en udrulning eller en anden ændring til grafer og Status200 AI | [Udrulninger og ændringer](/docs/telemetry/change-events) |
| `status200 <resource> list`, `get`, `create`, `update`, `delete`, `count` | Arbejder med én slags post | [Ressourceoperationer](/docs/cli/resource-operations) |
| `status200 resources` | Viser slagsene af poster med deres kommandoer | [Kommandoreference](/docs/cli/command-reference#status200-resources) |
| `status200 version` | Udskriver CLI'ens version | [Kommandoreference](/docs/cli/command-reference#status200-version) |
| `status200 help [command]` | Viser hjælpen til en kommando | [Få hjælp](#få-hjælp) |

## Globale indstillinger

Disse indstillinger virker med alle kommandoer, før eller efter dem:

| Indstilling | Hvad den gør |
| --- | --- |
| `--api-key <key>` | API-nøglen til denne kommando, i stedet for den gemte |
| `--url <url>` | Adressen på din Status200 til denne kommando |
| `--context <name>` | En gemt kontekst til denne kommando, i stedet for den aktuelle |
| `-o, --output <format>` | `table`, `json` eller `wide`: se [Outputformater](/docs/cli/output-formats) |
| `--no-color` | Udskriver uden farver |
| `-V, --version` | Udskriver CLI'ens version |
| `-h, --help` | Viser hjælpen til kommandoen |

## Få hjælp

Hver kommando har sin egen hjælp med sine argumenter, indstillinger og standardværdier:

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

## Næste skridt

:::cards
- [Godkendelse](/docs/cli/authentication): Kontekster for hvert miljø, og hvilken nøgle en kommando bruger.
- [Ressourceoperationer](/docs/cli/resource-operations): Vis, læs, opret, ændr, slet og tæl poster.
- [Outputformater](/docs/cli/output-formats): Tabeller til mennesker, JSON til scripts.
- [Scripting og CI/CD](/docs/cli/scripting): Exitkoder, jq og pipelines.
- [Kommandoreference](/docs/cli/command-reference): Hver kommando, indstilling og standardværdi.
:::