CLI
CDN Commands
Create deployments, manage domains, and purge cache from your terminal.
Deployments
List Deployments
$ edge cdn list ID NAME DOMAINS STATUS CREATED cdn-abc123 production 3 active 2025-01-15 cdn-def456 staging 1 active 2025-02-01 cdn-ghi789 legacy 2 active 2024-12-10
Create a Deployment
$ edge cdn create --name my-cdn Creating CDN deployment... done ID: cdn-jkl012 Name: my-cdn Status: active Add a domain to start using your CDN: edge cdn domains add cdn-jkl012 --domain cdn.example.com --origin https://origin.example.com
Get Deployment Details
$ edge cdn get cdn-abc123 ID: cdn-abc123 Name: production Status: active Created: 2025-01-15 10:30:00 UTC Domains: cdn.example.com → https://origin.example.com SSL: active assets.example.com → storage://my-bucket SSL: active static.example.com → https://s3.amazonaws.com/... SSL: active Statistics (24h): Requests: 1,245,678 Bandwidth: 45.2 GB Cache Hit: 94.5%
Delete a Deployment
# Delete with confirmation edge cdn delete cdn-abc123 # Delete without confirmation edge cdn delete cdn-abc123 --yes
Domains
List Domains
$ edge cdn domains list cdn-abc123 DOMAIN ORIGIN SSL CACHE TTL cdn.example.com https://origin.example.com active 86400s assets.example.com storage://my-assets active 604800s static.example.com https://s3.amazonaws.com/... active 2592000s
Add a Domain
# Add domain with external origin
edge cdn domains add cdn-abc123 \
--domain cdn.example.com \
--origin https://origin.example.com \
--cache-ttl 86400
# Add domain with Storage bucket as origin
edge cdn domains add cdn-abc123 \
--domain assets.example.com \
--origin-type storage \
--storage-bucket my-assets
# Enable JIT image optimization
edge cdn domains add cdn-abc123 \
--domain images.example.com \
--origin https://origin.example.com \
--jit-image Update a Domain
# Update origin
edge cdn domains update cdn-abc123 dom-xyz789 \
--origin https://new-origin.example.com
# Update cache TTL
edge cdn domains update cdn-abc123 dom-xyz789 \
--cache-ttl 3600 Remove a Domain
edge cdn domains remove cdn-abc123 dom-xyz789
Cache Purging
Purge All
$ edge cdn purge cdn-abc123 Purging all cached content... done Cache cleared for all domains in cdn-abc123
Selective Purge
# Purge specific path edge cdn purge cdn-abc123 --path /images/* # Purge specific URL edge cdn purge cdn-abc123 --url https://cdn.example.com/asset.js # Purge multiple paths edge cdn purge cdn-abc123 --path /css/* --path /js/*
Metrics
$ edge cdn metrics cdn-abc123 Period: Last 24 hours Total Requests: 1,245,678 Bandwidth: 45.2 GB Cache Hit Rate: 94.5% Cache Misses: 68,412 By Domain: cdn.example.com 892,345 requests 32.1 GB assets.example.com 312,456 requests 10.8 GB static.example.com 40,877 requests 2.3 GB # Specify time period edge cdn metrics cdn-abc123 --period 7d # Filter by domain edge cdn metrics cdn-abc123 --domain cdn.example.com # Export as CSV edge cdn metrics cdn-abc123 --export csv > cdn-metrics.csv
Common Flags
| Flag | Description |
|---|---|
| --name, -n | Deployment name |
| --domain | Domain hostname |
| --origin | Origin URL |
| --origin-type | Origin type: url or storage |
| --storage-bucket | Storage bucket name (when origin-type is storage) |
| --cache-ttl | Cache TTL in seconds |
| --jit-image | Enable JIT image optimization |
| --path | Path pattern to purge |
| --url | Specific URL to purge |
| --yes, -y | Skip confirmation prompts |