Skip to content
This repository was archived by the owner on Jun 6, 2023. It is now read-only.

Commit d294c75

Browse files
committed
feat(resourceDelegation): update docs with endpoint descriptions
1 parent cd2ffe7 commit d294c75

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

58 files changed

+839
-122
lines changed

docs/index.html

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
<label for="nav-trigger" class="overlay"></label>
2323

2424
<nav>
25-
<h2><a href="index.html">Home</a></h2><h3>Namespaces</h3><ul><li><a href="jobs.html">jobs</a><ul class='methods'><li data-type='method'><a href="jobs.html#.artifactsDestroy">artifactsDestroy</a></li><li data-type='method'><a href="jobs.html#.artifactsGet">artifactsGet</a></li><li data-type='method'><a href="jobs.html#.artifactsList">artifactsList</a></li><li data-type='method'><a href="jobs.html#.clone">clone</a></li><li data-type='method'><a href="jobs.html#.create">create</a></li><li data-type='method'><a href="jobs.html#.destroy">destroy</a></li><li data-type='method'><a href="jobs.html#.list">list</a></li><li data-type='method'><a href="jobs.html#.logs">logs</a></li><li data-type='method'><a href="jobs.html#.machineTypes">machineTypes</a></li><li data-type='method'><a href="jobs.html#.show">show</a></li><li data-type='method'><a href="jobs.html#.stop">stop</a></li><li data-type='method'><a href="jobs.html#.waitfor">waitfor</a></li></ul></li><li><a href="login.html">login</a><ul class='methods'><li data-type='method'><a href="login.html#.user">user</a></li></ul></li><li><a href="logout.html">logout</a><ul class='methods'><li data-type='method'><a href="logout.html#.user">user</a></li></ul></li><li><a href="machines.html">machines</a><ul class='methods'><li data-type='method'><a href="machines.html#.availability">availability</a></li><li data-type='method'><a href="machines.html#.create">create</a></li><li data-type='method'><a href="machines.html#.destroy">destroy</a></li><li data-type='method'><a href="machines.html#.list">list</a></li><li data-type='method'><a href="machines.html#.restart">restart</a></li><li data-type='method'><a href="machines.html#.show">show</a></li><li data-type='method'><a href="machines.html#.start">start</a></li><li data-type='method'><a href="machines.html#.stop">stop</a></li><li data-type='method'><a href="machines.html#.update">update</a></li><li data-type='method'><a href="machines.html#.utilization">utilization</a></li><li data-type='method'><a href="machines.html#.waitfor">waitfor</a></li></ul></li><li><a href="networks.html">networks</a><ul class='methods'><li data-type='method'><a href="networks.html#.list">list</a></li></ul></li><li><a href="project.html">project</a><ul class='methods'><li data-type='method'><a href="project.html#.clear">clear</a></li><li data-type='method'><a href="project.html#.init">init</a></li><li data-type='method'><a href="project.html#.show">show</a></li></ul></li><li><a href="scripts.html">scripts</a><ul class='methods'><li data-type='method'><a href="scripts.html#.create">create</a></li><li data-type='method'><a href="scripts.html#.destroy">destroy</a></li><li data-type='method'><a href="scripts.html#.list">list</a></li><li data-type='method'><a href="scripts.html#.show">show</a></li><li data-type='method'><a href="scripts.html#.text">text</a></li></ul></li><li><a href="templates.html">templates</a><ul class='methods'><li data-type='method'><a href="templates.html#.list">list</a></li></ul></li><li><a href="users.html">users</a><ul class='methods'><li data-type='method'><a href="users.html#.list">list</a></li></ul></li></ul>
25+
<h2><a href="index.html">Home</a></h2><h3>Namespaces</h3><ul><li><a href="jobs.html">jobs</a><ul class='methods'><li data-type='method'><a href="jobs.html#.artifactsDestroy">artifactsDestroy</a></li><li data-type='method'><a href="jobs.html#.artifactsGet">artifactsGet</a></li><li data-type='method'><a href="jobs.html#.artifactsList">artifactsList</a></li><li data-type='method'><a href="jobs.html#.clone">clone</a></li><li data-type='method'><a href="jobs.html#.create">create</a></li><li data-type='method'><a href="jobs.html#.destroy">destroy</a></li><li data-type='method'><a href="jobs.html#.list">list</a></li><li data-type='method'><a href="jobs.html#.logs">logs</a></li><li data-type='method'><a href="jobs.html#.machineTypes">machineTypes</a></li><li data-type='method'><a href="jobs.html#.show">show</a></li><li data-type='method'><a href="jobs.html#.stop">stop</a></li><li data-type='method'><a href="jobs.html#.waitfor">waitfor</a></li></ul></li><li><a href="login.html">login</a><ul class='methods'><li data-type='method'><a href="login.html#.user">user</a></li></ul></li><li><a href="logout.html">logout</a><ul class='methods'><li data-type='method'><a href="logout.html#.user">user</a></li></ul></li><li><a href="machines.html">machines</a><ul class='methods'><li data-type='method'><a href="machines.html#.availability">availability</a></li><li data-type='method'><a href="machines.html#.create">create</a></li><li data-type='method'><a href="machines.html#.destroy">destroy</a></li><li data-type='method'><a href="machines.html#.list">list</a></li><li data-type='method'><a href="machines.html#.restart">restart</a></li><li data-type='method'><a href="machines.html#.show">show</a></li><li data-type='method'><a href="machines.html#.start">start</a></li><li data-type='method'><a href="machines.html#.stop">stop</a></li><li data-type='method'><a href="machines.html#.update">update</a></li><li data-type='method'><a href="machines.html#.utilization">utilization</a></li><li data-type='method'><a href="machines.html#.waitfor">waitfor</a></li></ul></li><li><a href="networks.html">networks</a><ul class='methods'><li data-type='method'><a href="networks.html#.list">list</a></li></ul></li><li><a href="project.html">project</a><ul class='methods'><li data-type='method'><a href="project.html#.clear">clear</a></li><li data-type='method'><a href="project.html#.init">init</a></li><li data-type='method'><a href="project.html#.show">show</a></li></ul></li><li><a href="resourceDelegations.html">resourceDelegations</a><ul class='methods'><li data-type='method'><a href="resourceDelegations.html#.create">create</a></li></ul></li><li><a href="scripts.html">scripts</a><ul class='methods'><li data-type='method'><a href="scripts.html#.create">create</a></li><li data-type='method'><a href="scripts.html#.destroy">destroy</a></li><li data-type='method'><a href="scripts.html#.list">list</a></li><li data-type='method'><a href="scripts.html#.show">show</a></li><li data-type='method'><a href="scripts.html#.text">text</a></li></ul></li><li><a href="templates.html">templates</a><ul class='methods'><li data-type='method'><a href="templates.html#.list">list</a></li></ul></li><li><a href="users.html">users</a><ul class='methods'><li data-type='method'><a href="users.html#.list">list</a></li></ul></li></ul>
2626
</nav>
2727

2828
<div id="main">
@@ -58,16 +58,11 @@ <h2><a href="index.html">Home</a></h2><h3>Namespaces</h3><ul><li><a href="jobs.h
5858
<li><a href="https://paperspace.github.io/paperspace-node">API documentation</a></li>
5959
<li><a href="scripts.md">Script Guide</a> for creating and using startup scripts</li>
6060
</ul>
61-
<h2 id="-release-notes-releasenotes-md-"><a href="releasenotes.md">Release Notes</a></h2>
61+
<h2 id="release-notes"><a href="releasenotes.md">Release Notes</a></h2>
6262
<h2 id="getting-started">Getting started</h2>
6363
<h3 id="installation">Installation</h3>
6464
<h4 id="option-1-download-the-pre-built-paperspace-binary-for-your-plaftorm">Option 1: Download the pre-built 'paperspace' binary for your plaftorm</h4>
65-
<p>Pre-built 'paperspace' binaries are available for:</p>
66-
<ul>
67-
<li><a href="https://s3.amazonaws.com/paperspace-node/v0.1.10/win/paperspace.exe">Windows</a></li>
68-
<li><a href="https://s3.amazonaws.com/paperspace-node/v0.1.10/mac/paperspace">Mac</a></li>
69-
<li><a href="https://s3.amazonaws.com/paperspace-node/v0.1.10/linux/paperspace">Linux</a></li>
70-
</ul>
65+
<p>Head over to the <a href="https://github.com/Paperspace/paperspace-node/releases">releases</a> section to download the latest version of the paperspace CLI for Linux, Mac, and Windows.</p>
7166
<p>After downloading, make sure the 'paperspace' binary is permitted to run on your system by marking its permissions appropriately.
7267
Also, add the directory containing the 'paperspace' binary to your path using a method appropriate for your platform.</p>
7368
<h4 id="option-2-install-the-paperspace-node-package-from-npm">Option 2: Install the paperspace-node package from npm</h4>
@@ -87,16 +82,19 @@ <h4 id="option-1-obtain-an-api-key-via-paperspace-cli">Option 1: Obtain an API k
8782
<p>If you already have one or more API keys in your account, the API key associated with the first API token listed in your account is downloaded. If you want to use a particular API key you can specify the associated API token name using the '--apiToken' option.</p>
8883
<p>Note: your API key is cached in a file in your home directory: <code>~/.papersapce/config.json</code>. For security, please make sure access to the file is protected so only you can access it.</p>
8984
<p>You can clear your locally cached API key at any time by executing:</p>
90-
<pre class="prettyprint source"><code>$ paperspace logout</code></pre><h4 id="option-2-obtain-an-api-key-via-your-paperspace-console">Option 2: Obtain an API key via your Paperspace Console</h4>
91-
<p>Alternatively you can create an API key from withn your Paperspace console under the <a href="https://www.paperspace.com/console/account/api">API</a> section. Login to your <a href="https://www.paperspace.com/console">Paperspace console</a>, scroll to the API section in the left navigation bar, and click <a href="https://www.paperspace.com/console/account/api">CREATE AN API KEY</a>. Follow the instructions there.</p>
85+
<pre class="prettyprint source"><code>$ paperspace logout</code></pre><blockquote>
86+
<p>Note: Currently only email login is supported in the CLI - if you're using AD, SAML or GitHub to login to Paperspace, you will need t obtain an API key to log in with the CLI. </p>
87+
</blockquote>
88+
<h4 id="option-2-obtain-an-api-key-via-your-paperspace-console">Option 2: Obtain an API key via your Paperspace Console</h4>
89+
<p>Alternatively you can create an API key from within your Paperspace console under the <a href="https://www.paperspace.com/console/account/api">API</a> section. Login to your <a href="https://www.paperspace.com/console">Paperspace console</a>, scroll to the API section in the left navigation bar, and click <a href="https://www.paperspace.com/console/account/api">CREATE AN API KEY</a>. Follow the instructions there.</p>
9290
<p>You will need to pick and API token name for your API key, and also provide a description. You can copy actual the API key value associated with the API token name only at the time of initial creation. If you need to access your API key in the future, you can instead access it by API token name using the 'paperspace login' command.</p>
9391
<p><img src="https://user-images.githubusercontent.com/11018661/37693302-1f5d9100-2c95-11e8-9fa8-d000f1d40421.png" alt="image"></p>
9492
<p>You'll use the API keys generate here to authenticate your requests.</p>
9593
<h2 id="usage">Usage</h2>
9694
<p>You can interact with Paperspace's API in three ways: from the command line using the Paperspace CLI, programatically (from within a Javascript Nodejs application), or by using an HTTP client of your choice and the Paperspace API HTTP enpoints documented here.</p>
9795
<h3 id="authentication">Authentication</h3>
9896
<p>For authenticated requests, the Paperspace CLI and Paperspace-Node module will look in three places for an api key:</p>
99-
<p>1) Locally in the file <code>~/.papersapce/config.json</code>, which can be created via the Paperspace CLI by executing:</p>
97+
<p>1) Locally in the file <code>~/.paperspace/config.json</code>, which can be created via the Paperspace CLI by executing:</p>
10098
<pre class="prettyprint source"><code>$ paperspace login</code></pre><p>See the previous section on <a href="#obtaining-an-api-key">Obtaining an API key</a> for more information.</p>
10199
<p>2) An environment variable: <code>PAPERSPACE_API_KEY</code>. Example:</p>
102100
<pre class="prettyprint source"><code>$ export PAPERSPACE_API_KEY=1ba4f98e7c0...
@@ -144,7 +142,7 @@ <h2 id="bugs-support-troubleshooting">Bugs / Support / Troubleshooting</h2>
144142
<p>For bugs with the API client, command-line utility, or the HTTP API, please file tickets using GitHub Issues on this repo. We'll do our best to respond as quickly as we can. Keep in mind that Paperspace is a small team and you may need to allow up to a week for a response.</p>
145143
<p>Other issues, such as those related to your Paperspace account, your team or team members, billing, or technical issues with your Paperspace machines should be directed to <a href="mailto:support@paperspace.com">support@paperspace.com</a>.</p>
146144
<h2 id="security">Security</h2>
147-
<p>Think you've discovered a security flaw or exploit? We offer bug bounties for responsible vulnerability disclosures that match our criteria. Please contact us directly at <a href="mailto:support@paperspace.com">support@paperspace.com</a> and we will respond as quickly as we can.</p>
145+
<p>Think you've discovered a security flaw or exploit? Please contact us directly at <a href="mailto:support@paperspace.com">support@paperspace.com</a> and we will respond as quickly as we can.</p>
148146
<h2 id="disclaimer">Disclaimer</h2>
149147
<p><strong>Use the Paperspace API with care.</strong> This tool is provided as-is (please see our LICENSE). Know that many actions provided via our public API can result in billing charges for Paperspace services. Please be aware of Paperspace's billing policies before performing any of these actions; you'll see charges reflected in your invoice at the end of the month. Some actions, such as deactivating machines, are irreversible, resulting in permanent loss of data. Paperspace cannot recover lost data such as mistakenly deleted account information, and may only be able to give limited assistance if an action is performed mistakenly. API access will be disabled for accounts not in good standing. Keeping your account credentials secret is your responsibility. You may only use Paperspace's API to store, retrieve, query, serve, and execute content that is owned, licensed or lawfully obtained by you.</p>
150148
<h2 id="license">License</h2>
@@ -163,7 +161,7 @@ <h2 id="copyright">Copyright</h2>
163161
<br class="clear">
164162

165163
<footer>
166-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 11 2019 13:09:54 GMT-0500 (EST) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
164+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Wed Apr 03 2019 16:29:22 GMT+0200 (CEST) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
167165
</footer>
168166

169167
<script>prettyPrint();</script>

0 commit comments

Comments
 (0)