ovh

通过 API 管理 OVHcloud 服务。当用户询问 OVH 域、DNS 记录、VPS、云实例、专用服务器、电子邮件、SSL 证书或任何 OVH 服务管理时使用。支持列出、创建、更新和删除资源。

## 概述（中文）

通过 API 管理 OVHcloud 服务。当用户询问 OVH 域、DNS 记录、VPS、云实例、专用服务器、电子邮件、SSL 证书或任何 OVH 服务管理时使用。支持列出、创建、更新和删除资源。

## 原文

# OVH

Manage OVHcloud services via the bundled `ovh-cli.py` script.

## Setup

Store credentials in environment:

```bash
export OVH_ENDPOINT="ovh-ca"  # or ovh-eu, ovh-us, etc.
export OVH_APP_KEY="your-app-key"
export OVH_APP_SECRET="your-app-secret"
export OVH_CONSUMER_KEY="your-consumer-key"
```

**Get credentials:**
1. Go to https://ca.api.ovh.com/createToken/ (or eu/us variant)
2. Create application with desired permissions
3. Validate the consumer key via the provided URL

**Endpoints:** `ovh-eu`, `ovh-ca`, `ovh-us`, `soyoustart-eu`, `soyoustart-ca`, `kimsufi-eu`, `kimsufi-ca`

## Usage

The script is at `scripts/ovh-cli.py`. Commands:

```bash
# Account info
ovh-cli.py me

# Domains
ovh-cli.py domains                      # List all domains
ovh-cli.py domain <domain>              # Get domain info
ovh-cli.py domain <domain> renew        # Check renewal info

# DNS (OVH-managed zones, not Cloudflare)
ovh-cli.py dns <domain>                 # List DNS records
ovh-cli.py dns <domain> get <id>        # Get specific record
ovh-cli.py dns <domain> create --type A --subdomain www --target 1.2.3.4 [--ttl 300]
ovh-cli.py dns <domain> update <id> --target 5.6.7.8
ovh-cli.py dns <domain> delete <id>
ovh-cli.py dns <domain> refresh         # Refresh zone (apply changes)

# VPS
ovh-cli.py vps                          # List all VPS
ovh-cli.py vps <name>                   # VPS details
ovh-cli.py vps <name> status            # Current state
ovh-cli.py vps <name> reboot            # Reboot VPS
ovh-cli.py vps <name> start             # Start VPS
ovh-cli.py vps <name> stop              # Stop VPS
ovh-cli.py vps <name> ips               # List IPs

# Cloud Projects
ovh-cli.py cloud                        # List projects
ovh-cli.py cloud <project> instances    # List instances
ovh-cli.py cloud <project> instance <id> # Instance details

# Dedicated Servers
ovh-cli.py dedicated                    # List servers
ovh-cli.py dedicated <name>             # Server details
ovh-cli.py dedicated <name> reboot      # Reboot server

# SSL Certificates
ovh-cli.py ssl                          # List certificates
ovh-cli.py ssl <id>                     # Certificate details

# Bills & Orders
ovh-cli.py bills [--limit N]            # Recent bills
ovh-cli.py orders [--limit N]           # Recent orders
```

## Common Patterns

**Check domain expiry:**
```bash
ovh-cli.py domain pushp.ovh renew
```

**Add DNS record:**
```bash
ovh-cli.py dns pushp.ovh create --type A --subdomain api --target 203.0.113.50
ovh-cli.py dns pushp.ovh refresh
```

**Manage VPS:**
```bash
ovh-cli.py vps myvps status
ovh-cli.py vps myvps reboot
```

## Notes

- DNS changes require `refresh` to apply
- Use `--json` flag for machine-readable output
- Some operations are async; check status with subsequent calls