Package Exports

netstorageapi

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (netstorageapi) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

NetstorageAPI: Akamai Netstorage API for Node.js

NetstorageAPI is Akamai Netstorage (File/Object Store) API for Node.js 4.0+ with native http module.

Installation

To install Netstorage API for Node.js:

$ npm install --save netstorageapi

Example

> const Netstorage = require('netstorageapi')
>
> const config = { hostname: 'astinobj-nsu.akamaihd.net', keyName: 'astinobj', key: 'xxxxxxxxxx', cpCode: '407617', ssl: false }
> // Don't expose KEY on your public repository.
> // Default SSL value is FALSE
> var ns = new Netstorage(config);
> local_source = 'hello.txt'
> netstorage_destination = `/${config.cpCode}/hello.txt` // or `/${config.cpCode}/` is same.
>
> 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) { // http response codes: 2xx, 3xx, 4xx, 5xx
...     // do something
...     // body returns json type {}
...  }
... });
>

Methods

> function callback(error, response, body) { /* do something */ }
>
> ns.delete(NETSTORAGE_PATH, callback);
> ns.dir(NETSTORAGE_PATH, callback);
> ns.list(NETSTORAGE_PATH, ACTIONS_OBJ, callback);
> ns.download(NETSTORAGE_SOURCE, LOCAL_DESTINATION, callback);
> ns.du(NETSTORAGE_PATH, callback);
> ns.mkdir(`#{NETSTORAGE_PATH}/#{DIRECTORY_NAME}`, callback);
> ns.mtime(NETSTORAGE_PATH, new Date.now(), callback);
> ns.quick_delete(NETSTORAGE_DIR, callback); // needs to be enabled on the CP Code
> ns.rename(NETSTORAGE_TARGET, NETSTORAGE_DESTINATION, callback);
> ns.rmdir(NETSTORAGE_DIR, callback); // remove empty direcoty
> ns.stat(NETSTORAGE_PATH, callback);
> ns.symlink(NETSTORAGE_TARGET, NETSTORAGE_DESTINATION, callback);
> ns.upload(LOCAL_SOURCE, NETSTORAGE_DESTINATION, callback);
>  
> // INFO: can "upload" Only a single file, not directory.
> // WARN: can raise FILE related error in "download" and "upload",
> //       see error object in callback.

Test

You can test all above methods with Unit Test Script (NOTE: You should input NS_HOSTNAME, NS_KEYNAME, NS_KEY and NS_CPCODE in the script). It uses Mocha for the test:

$ npm install --global mocha
...
$ mocha --no-timeouts test_netstorage.js

### Netstorage test ###
  ns.dir("/407617", callback);
    ✓ should return 200 OK
  ns.list("/407617", { "max_entries": 5 }, callback);
    ✓ should return 200 OK
  ns.mkdir("/407617/nst_1485516660306", callback);
    ✓ should return 200 OK
  ns.upload("/Users/achoi/Projects/NetStorageKit-Node/test/nst_1485516660306.txt", "/407617/nst_1485516660306/nst_1485516660306.txt", callback);
    ✓ should return 200 OK
  ns.du("/407617/nst_1485516660306", callback);
    ✓ should return 200 OK
  ns.mtime("/407617/nst_1485516660306/nst_1485516660306.txt", 1485516660, callback);
    ✓ should return 200 OK
  ns.stat("/407617/nst_1485516660306/nst_1485516660306.txt", callback);
    ✓ should return 200 OK
  ns.symlink("/407617/nst_1485516660306/nst_1485516660306.txt", "/407617/nst_1485516660306/nst_1485516660306.txt_lnk", callback);
    ✓ should return 200 OK
  ns.rename("/407617/nst_1485516660306/nst_1485516660306.txt", "/407617/nst_1485516660306/nst_1485516660306.txt_rename", callback);
    ✓ should return 200 OK
  ns.download("/407617/nst_1485516660306/nst_1485516660306.txt_rename", callback);
    ✓ should return 200 OK
  ns.delete("/407617/nst_1485516660306/nst_1485516660306.txt_rename", callback);
    ✓ should return 200 OK
  ns.delete("/407617/nst_1485516660306/nst_1485516660306.txt_lnk", callback);
    ✓ should return 200 OK
  ns.rmdir("/407617/nst_1485516660306", callback);
    ✓ should return 200 OK

### Error test ###
  ns.dir('invalid ns path', callback);
    ✓ should get Error object
  ns.list('invalid ns path', { "max_entries": 5 }, callback);
    ✓ should get Error object
  ns.list("/407617", { badObj: true }, callback);
    ✓ should get Error object
  ns.upload("invalid local path", "/407617/nst_1485516660306/nst_1485516660306.txt" callback);
    ✓ should get Error object
  ns.download("/123456/directory/", "/Users/achoi/Projects/NetStorageKit-Node/test/nst_1485516660306.txt" callback);
    ✓ should get Error object


18 passing (..s)

Author

Astin Choi (achoi@akamai.com)

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.