@mapbox/pagerduty
A Node.js SDK for the PagerDuty v2 API
Last updated 2 months ago by mapbox-npm-06 .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @mapbox/pagerduty 
SYNC missed versions from official npm registry.

Build Status

pagerduty

A Node.js SDK for the PagerDuty v2 API

API

First, create a new PagerDuty SDK object. A PagerDuty API token that will be used by default for all methods can be included by specifying the pagerDutyToken option.

Parameters

  • options.pagerDutyToken string PagerDuty access token
  • options.timeout string? number of milliseconds used for read and connection timouets - defaults to 10 seconds if not specified

Example

const PagerDuty = require('@mapbox/pagerduty');
const pd = new PagerDuty({
  pagerDutyToken: process.env.API_TOKEN
});

pd.get({
  path: 'services'
  ...

get

Make a GET request to the PagerDuty API. You can choose to receive a specific response body property by specifying an options.key; otherwise, the entire response body will be returned. The PagerDuty access token can be provided explicitly.

Parameters

  • options.path string URL path and query
  • options.key string? Response body property to return
  • options.token string? PagerDuty access token
  • options.timeout string? number of milliseconds used for read and connection timouets

Example

const PagerDuty = require('@mapbox/pagerduty');
const pd = new PagerDuty();
const id = 'PPPPPPA';
pd.get({
  path: `users/${id}`,
  key: 'user'
}, (err, res) => {
  if (err) throw err;
  console.log(`Successfully fetched ${res[0].name} with ID ${id}.`);
});

post

Make a POST request to the PagerDuty API. The PagerDuty access token can be provided explicitly.

Parameters

  • options.path string URL path and query
  • options.body object POST request body
  • options.headers object? Additional headers, excluding Accept and Authorization
  • options.token string? PagerDuty access token
  • options.timeout string? number of milliseconds used for read and connection timouets

Example

const PagerDuty = require('@mapbox/pagerduty');
const pd = new PagerDuty();
pd.post({
  path: 'users',
  body: {
    user: {
      type: 'user',
      name: 'Dev Null',
      email: 'devnull@company.com',
      time_zone: 'America/New_York',
      color: 'blue-violet',
      role: 'user'
    }
  },
  headers: {
    From: 'anotherdevnull@company.com'
  }
}, (err, res) => {
  if (err) throw err;
  console.log(`Created ${res.body.user.summary} with ID ${res.body.user.id}.`);
});

put

Make a PUT request to the PagerDuty API. The PagerDuty access token can be provided explicitly.

Parameters

  • options.path string URL path and query
  • options.body object PUT request body
  • options.headers object? Additional headers, excluding Accept and Authorization
  • options.token string? PagerDuty access token
  • options.timeout string? number of milliseconds used for read and connection timouets

Example

const PagerDuty = require('@mapbox/pagerduty');
const pd = new PagerDuty();
const id = 'PPPPPPA';
pd.put({
  path: `users/${id}`,
  body: {
    user: {
      job_title: 'Software Engineer'
    }
  }
}, (err, res) => {
  if (err) throw err;
  console.log(`Successfully updated ${res.body.user.name}'s user description to ${res.body.user.description}`);
});

delete

Make a DELETE request to the PagerDuty API. The PagerDuty access token can be provided explicitly.

Parameters

  • options.path string URL path and query
  • options.token string? PagerDuty access token
  • options.timeout string? number of milliseconds used for read and connection timouets

Example

const PagerDuty = require('@mapbox/pagerduty');
const pd = new PagerDuty();
const id = 'PPPPPPA';
pd.delete({
  path: `users/${id}`
}, (err, res) => {
  if (err) throw err;
  console.log(`Successfully deleted user ID ${id}.`);
});

Current Tags

  • 4.0.0                                ...           latest (2 months ago)

7 Versions

  • 4.0.0                                ...           2 months ago
  • 4.0.0-0                                ...           2 months ago
  • 3.0.0                                ...           a year ago
  • 3.0.0-1                                ...           2 years ago
  • 3.0.0-0                                ...           2 years ago
  • 2.0.0                                ...           2 years ago
  • 1.0.0                                ...           3 years ago
Downloads
Today 0
This Week 1
This Month 3
Last Day 0
Last Week 0
Last Month 30
Dependencies (1)
Dev Dependencies (4)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |