feat: Add machines.utilization to get amount of time a machine has been used in the current month.

Author: colin-welch

lib/machines/index.js

@@ -12,5 +12,6 @@ module.exports = {
 	show: require('./show'),
 	start: require('./start'),
 	stop: require('./stop'),
+	utilization: require('./utilization'),
 	waitfor: require('./waitfor'),
 };

lib/machines/utilization.js

@@ -0,0 +1,52 @@
+'use strict';
+
+var method = require('./../method');
+var assign = require('lodash.assign');
+
+/**
+ * @memberof machines
+ * @method utilization
+ * @description Show machine utilization data for the machine with the given id.
+ * @param {string} params.machineId - Id of the machine to show
+ * @param {function} cb - Node-style error-first callback function
+ * @returns {object} machine - The utilization JSON object
+ * @example
+ * paperspace.machines.utilization({
+ *   machineId: 'ps123abc',
+ * }, function(err, resp) {
+ *   // handle error or http response
+ * });
+ * @example
+ * $ paperspace machines utilization \
+ *     --machineId "ps123abc"
+ * @example
+ * # HTTP request:
+ * https://api.paperspace.io
+ * GET /machines/getUtilization?machineId=ps123abc
+ * x-api-key: 1ba4f98e7c0...
+ * # Returns 200 on success
+ * @example
+ * //Example return value:
+ * {
+ *   "machineId": "ps123abc",
+ *   "secondsUsed": 1000,
+ * }
+ */
+
+function utilization(params, cb) {
+	return method(utilization, params, cb);
+}
+
+assign(utilization, {
+	auth: true,
+	group: 'machines',
+	name: 'utilization',
+	method: 'get',
+	route: '/machines/getUtilization',
+	requires: {
+		machineId: 'string',
+	},
+	returns: {},
+});
+
+module.exports = utilization;