A TypeScript API and CLI for the Akamai NetStorage REST interface
npm install netstorageA TypeScript API and CLI for the Akamai NetStorage REST interface.
- Upload and download individual files or entire directories
- Bi-directional sync between local and remote
- Recursive remote directory tree traversal
- Fully typed API responses and inputs
- Built-in retries, rate limiting, and dry-run mode
- Tools for size aggregation and file validation
- Rich CLI with full feature parity
- Interactive REPL with tab-completion and remote navigation
``bash`
npm i netstorage -g
Alternatively, you can run any command with npx netstorage without a global install.
Before using any commands or launching the REPL, you must configure your NetStorage credentials:
`bash`
npx netstorage config set --key-name my-key --key abc123 --host example-nsu.akamaihd.net --cp-code 123
Then try any of the following:
`bashSync a local directory
npx netstorage sync ./media
$3
`bash
npx netstorage
`Use the REPL to:
- Navigate remote directories (
cd, ls, ll, pwd)
- Run any CLI command interactively (upload, download, stat, etc.)
- Autocomplete local and remote paths
- Maintain remote working directory contextExample commands:
`bash
nst:/media> ls
nst:/media> stat file.jpg
nst:/media> put ./photo.jpg
nst:/media> get remote-folder -v
`$3
`ts
import { createConfig, uploadDirectory } from 'netstorage';const config = createConfig({
key: process.env.NETSTORAGE_API_KEY!,
keyName: process.env.NETSTORAGE_API_KEYNAME!,
host: process.env.NETSTORAGE_HOST!,
cpCode: process.env.NETSTORAGE_CP_CODE!,
});
await uploadDirectory(config, {
localPath: './media',
remotePath: '/batch-media',
});
``- CLI Reference
- API Reference
This project is an unofficial implementation of the Akamai NetStorage REST API. It is not affiliated with or endorsed by Akamai. Use at your own risk. The software is provided as-is under an unlicensed status, with no warranties or guarantees.