akamai-netstorageapi v1.0.3
akamai-netstorageapi-typescript
Akamai Netstorage Typescript (UNOFFICIAL)
This is a complete typescript rewirte of a official NodeJS package for Akamai Netstorage
Table of Contents
Installation
To install Netstorage API with npm global:
$ npm install --global netstorageapi
or as a development dependency for your project:
$ npm install --save netstorageapi
Example
const Netstorage = require('netstorageapi')
// Defaults: SSL: false
// By default no proxy is set
const config = {
hostname: '*******.akamaihd.net',
keyName: 'DDDDDDDDDDDDDDDDDDDDDDDDDDDD',
key: 'xxxxxxxxxx',
cpCode: '407617',
ssl: false,
// proxy: 'https://yourproxyurl.com:port' // Optional
}
// Don't expose KEY on your public repository.
const ns = new Netstorage(config)
const local_source = 'hello.txt'
// or `/${config.cpCode}/` will asume the destination filename is the same as the source
const netstorage_destination = `/${config.cpCode}/hello.txt`
ns.upload(local_source, netstorage_destination, (error, response, body) => {
if (error) { // errors other than http response codes
console.log(`Got error: ${error.message}`)
}
if (response.statusCode == 200) {
console.log(body)
}
});
// Async Way
let response: Promise<UploadResponse> = await ns.uploadAsync(local_source, netstorage_destination)
// { message: 'Request Processed.' }
Methods
- delete
- deleteAsync
- dir
- dirAsync
- listAsync
- listAsync
- download
- downloadAsync
- downloadBuffer
- downloadBufferAsync
- du
- duAsync
- mkdir
- mkdirAsync
- mtime
- mtimeAsync
- quickDelete
- quickDeleteAsync
- rename
- renameAsync
- rmdir
- rmdirAsync
- stat
- statAsync
- symlink
- symlinkAsync
- upload
- uploadAsync
- uploadBuffer
- uploadBufferAsync
delete
- Syntax:
ns.delete(NETSTORAGE_PATH, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_PATH
string full path for the file, not the directory
deleteAsync
- Syntax:
ns.deleteAsync(NETSTORAGE_PATH)
Parameters:
Name Type Description NETSTORAGE_PATH
string full path for the file, not the directory Response: Promise
dir
- Syntax:
ns.dir(NETSTORAGE_PATH|OPTIONS, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_PATH
string full path for the directory OPTIONS
object JSON object containing options for the dir method Valid Options:
{ path: '/your/path',
actions: {
max_entries: integer,
start: '/start/path',
end: '/end/path/',
prefix: 'object-prefix',
slash: 'both'
}
}
dirAsync
- Syntax:
ns.dirAsync(NETSTORAGE_PATH|OPTIONS)
Parameters:
Name Type Description NETSTORAGE_PATH
string full path for the directory OPTIONS
DirListOpts JSON object containing options for the dir method Valid Options:
{ path: '/your/path',
actions: {
max_entries: integer,
start: '/start/path',
end: '/end/path/',
prefix: 'object-prefix',
slash: 'both'
}
}
- Response: Promise
list
- Syntax:
ns.list(NETSTORAGE_PATH|OPTIONS, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory OPTIONS
object JSON object containing options for the list method Valid Options:
{ path: '/your/path',
actions: {
max_entries: integer,
end: '/end/path/'
}
}
listAsync
- Syntax:
ns.listAsync(NETSTORAGE_PATH|OPTIONS)
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory OPTIONS
DirListOpts JSON object containing options for the list method Valid Options:
{ path: '/your/path',
actions: {
max_entries: integer,
end: '/end/path/'
}
}
- Response: Promise
download
- Syntax:
ns.download(NETSTORAGE_SOURCE, LOCAL_DESTINATION, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_SOURCE
string Path to the file in NetStorage LOCAL_DESTINATION
string Location on the local host to write the downloaded file to (Optional value)
downloadAsync
- Syntax:
ns.downloadAsync(NETSTORAGE_SOURCE, LOCAL_DESTINATION)
Parameters:
Name Type Description NETSTORAGE_SOURCE
string Path to the file in NetStorage LOCAL_DESTINATION
string Location on the local host to write the downloaded file to (Optional value) Response: Promise
downloadBuffer
- Syntax:
ns.downloadBuffer(NETSTORAGE_SOURCE, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_SOURCE
string Path to the file in NetStorage
downloadBufferAsync
- Syntax:
ns.downloadBufferAsync(NETSTORAGE_SOURCE)
Parameters:
Name Type Description NETSTORAGE_SOURCE
string Path to the file in NetStorage Response: Promise
du
- Syntax:
ns.du(NETSTORAGE_PATH, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory
duAsync
- Syntax:
ns.duAsync(NETSTORAGE_PATH)
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory Response: Promise
mkdir
- Syntax:
ns.mkdir(DIRECTORY_NAME, callback(err, response, body))
Parameters:
Name Type Description DIRECTORY_NAME
string Full path to the directory you wish to create
mkdirAsync
- Syntax:
ns.mkdirAsync(DIRECTORY_NAME)
Parameters:
Name Type Description DIRECTORY_NAME
string Full path to the directory you wish to create Response: Promise
mtime
- Syntax:
ns.mtime(NETSTORAGE_PATH, UNIX_TIME, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory UNIX_TIME
integer Unix time to set the mtime of the file to. Note that millisecond accuracy is not supported
mtimeAsync
- Syntax:
ns.mtimeAsync(NETSTORAGE_PATH, UNIX_TIME)
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory UNIX_TIME
integer Unix time to set the mtime of the file to. Note that millisecond accuracy is not supported Response: Promise
quickDelete
- Syntax:
ns.quickDelete(NETSTORAGE_DIR, callback(err, response, body)) // needs to be enabled on the CP Code
Parameters:
Name Type Description NETSTORAGE_DIR
string full path to the directory you wish to delete
quickDeleteAsync
- Syntax:
ns.quickDeleteAsync(NETSTORAGE_DIR) // needs to be enabled on the CP Code
Parameters:
Name Type Description NETSTORAGE_DIR
string full path to the directory you wish to delete Response: Promise
rename
- Syntax:
ns.rename(NETSTORAGE_TARGET, NETSTORAGE_DESTINATION, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_TARGET
string full path to the original file/directory NETSTORAGE_DESTINATION
string full path to the renamed file/directory
renameAsync
- Syntax:
ns.renameAsync(NETSTORAGE_TARGET, NETSTORAGE_DESTINATION)
Parameters:
Name Type Description NETSTORAGE_TARGET
string full path to the original file/directory NETSTORAGE_DESTINATION
string full path to the renamed file/directory Response: Promise
rmdir
- Syntax:
ns.rmdir(NETSTORAGE_DIR, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_DIR
string full path to the empty object you wish to delete
rmdirAsync
- Syntax:
ns.rmdirAsync(NETSTORAGE_DIR)
Parameters:
Name Type Description NETSTORAGE_DIR
string full path to the empty object you wish to delete Response: Promise
stat
- Syntax:
ns.stat(NETSTORAGE_PATH, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory you wish to stat
statAsync
- Syntax:
ns.statAsync(NETSTORAGE_PATH)
Parameters:
Name Type Description NETSTORAGE_PATH
string full path to the file/directory you wish to stat Response: Promise
symlink
- Syntax:
ns.symlink(NETSTORAGE_SOURCE, NETSTORAGE_TARGET, callback(err, response, body))
Parameters:
Name Type Description NETSTORAGE_SOURCE
string full path to the original file NETSTORAGE_TARGET
string full path of the new symlinked file to create
symlinkAsync
- Syntax:
ns.symlinkAsync(NETSTORAGE_SOURCE, NETSTORAGE_TARGET)
Parameters:
Name Type Description NETSTORAGE_SOURCE
string full path to the original file NETSTORAGE_TARGET
string full path of the new symlinked file to create Response: Promise
upload
- Syntax:
ns.upload(LOCAL_SOURCE, NETSTORAGE_DESTINATION, callback(err, response, body))
Parameters:
Name Type Description LOCAL_SOURCE
string Path to the local file you wish to upload NETSTORAGE_DESTINATION
string Path to the location you wish to upload the file. Note that if you omit the actual filename, the source filename is used. You may only upload files using the API, not directories.
uploadAsync
- Syntax:
ns.uploadAsync(LOCAL_SOURCE, NETSTORAGE_DESTINATION)
Parameters:
Name Type Description LOCAL_SOURCE
string Path to the local file you wish to upload NETSTORAGE_DESTINATION
string Path to the location you wish to upload the file. Note that if you omit the actual filename, the source filename is used. You may only upload files using the API, not directories. Response: Promise
uploadBuffer
- Syntax:
ns.uploadBuffer(LocalBuffer, Basename, NETSTORAGE_DESTINATION, callback(err, response, body))
Parameters:
Name Type Description LocalBuffer
Buffer Buffer of the file you wish to upload Basename
string Filename you wish to keep for the uploaded file along with the extension. NETSTORAGE_DESTINATION
string Path to the location you wish to upload the file. You may only upload files using the API, not directories.
uploadBufferAsync
- Syntax:
ns.uploadBufferAsync(LOCAL_SOURCE, NETSTORAGE_DESTINATION)
Parameters:
Name Type Description LocalBuffer
Buffer Buffer of the file you wish to upload Basename
string Filename you wish to keep for the uploaded file along with the extension. NETSTORAGE_DESTINATION
string Path to the location you wish to upload the file. You may only upload files using the API, not directories. Response: Promise
Author
Boffin Coders (info@boffincoders.com)
Thanks to Astin Choi (achoi@akamai.com) as well for writing the origianl lib.