1.0.33 • Published 4 years ago

spotinst-sdk-nodejs v1.0.33

Weekly downloads
70
License
Apache-2.0
Repository
github
Last release
4 years ago

Spotinst SDK Node.js

A Node.js client library for accessing the Spotinst API.

You can view Spotinst API docs here.

Installation

npm install spotinst-sdk-nodejs --save

Usage

import { Client, config } from 'spotinst-sdk-nodejs';

Create a new Spotinst client, then use the exposed services to access different parts of the Spotinst API.

Authentication

import { Client, config } from 'spotinst-sdk-nodejs';

// Instantiate new client.
const clientOpts = [
  config.setToken('foo'),
  config.setAccount('act-XXXXXX')
];
const client = new Client(...clientOpts);

Callback or Promise?

All methods in the SDK provide both callback based as well as promise based interactions. If you want to use callback just pass it as a last parameter. For example:

client.AwsGroupService.read({id: 'sig-bar'}, (err, groups) => {
  if (err) {
    console.error(err);
    // Do something with err.
    return;
  }

  console.log(groups);
  // Do something with groups.
});

If you prefer to use promises then the code goes like this:

client.AwsGroupService.read({id: 'sig-bar'})
  .then((groups) => {
    console.log(groups);
    // Do something with groups.
  })
  .catch((err) => {
    console.error(err);
    // Do something with err.
  });

ES5

If you prefer to use ES5 syntax instead of ES6 then the code goes like this:

var spotinst = require('spotinst-sdk-nodejs');

// Instantiate new client.
var client = new spotinst.Client(
  spotinst.config.setToken('foo'),
);

client.AwsGroupService.read({id: 'sig-bar'}, (err, groups) => {
  if (err) {
    console.error(err);
    // Do something with err.
    return;
  }

  console.log(groups);
  // Do something with groups.
});

Available Servies

Services and actions are formatted as client.SERVICE.ACTION()

Example:

client.AwsGroupService.list()
  .then((groups) => {
    console.log(groups);
    // do something with groups
  })
  .catch((err) => {
    console.error(err);
    // do something with err
  });

AwsGroupService

Manage Spotinst Elastigroups

Actions:

  • create
  • read
  • list
  • update
  • delete
  • status

AwsGroupRollService

Manage Elastigroups with AWS EMR integration

Actions:

  • start
  • stop
  • list
  • read

AwsInstanceService

Manage a single instance within an Elastigroup

Actions:

  • read
  • detach
  • signal

AwsSpotService

Describes a specific Spot Instance Request

Actions:

  • read

SubscriptionService

Manage Spotinst Subscriptions

Actions:

  • create
  • read
  • list
  • update
  • delete

SpectrumService.Event

Manage Spectrum Events

Actions:

  • create
  • read
  • list
  • update
  • delete

MrScalerAwsService

Manage Elastigroups with AWS EMR integration

Actions:

  • create
  • read
  • list
  • update
  • delete

Documentation

For a comprehensive list of examples, check out the API documentation.

Contributing

We love pull requests! Please see the contribution guidelines.

1.0.33

4 years ago

1.0.32

5 years ago

1.0.31

6 years ago

1.0.30

6 years ago

1.0.29

6 years ago

1.0.27

7 years ago

1.0.25

7 years ago

1.0.24

7 years ago

1.0.23

7 years ago

1.0.22

7 years ago

1.0.21

7 years ago

1.0.20

7 years ago

1.0.19

7 years ago

1.0.18

7 years ago

1.0.17

7 years ago

1.0.16

7 years ago

1.0.15

7 years ago

1.0.14

7 years ago

1.0.13

7 years ago

1.0.12

7 years ago

1.0.11

7 years ago

1.0.10

7 years ago

1.0.9

7 years ago

1.0.8

7 years ago

1.0.6

7 years ago

1.0.5

7 years ago

1.0.4

7 years ago

1.0.3

7 years ago

1.0.2

7 years ago

1.0.1

7 years ago

1.0.0

7 years ago

0.0.1

7 years ago