Skip to content

Commit 8c0e31f

Browse files
Daniel Kobrangitbook-bot
authored andcommitted
GitBook: [master] 27 pages and 3 assets modified
1 parent 942f7dc commit 8c0e31f

30 files changed

+1921
-0
lines changed

.gitbook/assets/image.png

69.4 KB
Loading
63.3 KB
Loading
82.9 KB
Loading

README.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# Introduction
2+
3+
![](.gitbook/assets/paperspace-core-api2.jpg)
4+
5+
Welcome to the **Paperspace CORE API** documentation. CORE provides a RESTful API for programmatically managing your compute resources. It is currently available through the use of standard HTTP requests as well as a JavaScript client for Node.js. We plan to offer other languages and integrations in the future.
6+
7+
## Usage <a id="usage"></a>
8+
9+
You can interact with CORE API in two ways: by using an HTTP client of your choice and the Paperspace API HTTP endpoints or programmatically from within a Javascript Node.js application.
10+
11+
## Other clients <a id="other-clients"></a>
12+
13+
If you've created an API client in a language other than JavaScript, please let us know at [support@paperspace.com](mailto:support@paperspace.com) and we will link to it here.
14+
15+
## Sample Apps <a id="sample-apps"></a>
16+
17+
See the directory [samples](https://github.com/Paperspace/paperspace-node/tree/master/samples) for a few simple samples of using the node API, and the CLI in a bash script. Note: the [jq](https://stedolan.github.io/jq/) tool is used in the bash sample for parsing JSON data.
18+
19+
## Contributing <a id="contributing"></a>
20+
21+
We welcome contributions to this project. Please adhere to the established coding conventions within the project and submit changes using pull requests.
22+
23+
Additional information for developers is here: [developers.md](https://paperspace.github.io/paperspace-node/developers.md)
24+
25+
## Bugs / Support / Troubleshooting <a id="bugs-%2F-support-%2F-troubleshooting"></a>
26+
27+
For bugs with the API client or the HTTP API, please file tickets using GitHub Issues on [this](https://github.com/paperspace/paperspace-node) 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.
28+
29+
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 [support@paperspace.com](mailto:support@paperspace.com).
30+
31+
## Security <a id="security"></a>
32+
33+
Think you've discovered a security flaw or exploit? Please contact us directly at [support@paperspace.com](mailto:support@paperspace.com) and we will respond as quickly as we can.
34+
35+
## Disclaimer <a id="disclaimer"></a>
36+
37+
**Use the CORE API with care.** This tool is provided as-is \(please see our [LICENSE](./#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 CORE API to store, retrieve, query, serve, and execute content that is owned, licensed or lawfully obtained by you.
38+
39+
## License <a id="license"></a>
40+
41+
This project is open-source, under the ISC license.
42+
43+
> Copyright \(c\) 2017, Paperspace support@paperspace.com&gt;
44+
>
45+
> Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
46+
>
47+
> THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
48+
49+
## Copyright <a id="copyright"></a>
50+
51+
Copyright 2021 Paperspace Co. - All Rights Reserved
52+

SUMMARY.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Table of contents
2+
3+
* [Introduction](README.md)
4+
5+
## Get Started
6+
7+
* [Obtaining an API Key](get-started/obtaining-an-api-key.md)
8+
* [Quickstart](get-started/quickstart.md)
9+
* [Node.js client](get-started/node.js-client-installation.md)
10+
11+
## API documentation
12+
13+
* [Machines](api-documentation/machines-1/README.md)
14+
* [Create](api-documentation/machines-1/create.md)
15+
* [Start](api-documentation/machines-1/start.md)
16+
* [Stop](api-documentation/machines-1/stop.md)
17+
* [Restart](api-documentation/machines-1/restart.md)
18+
* [Destroy](api-documentation/machines-1/destroy.md)
19+
* [Update](api-documentation/machines-1/update.md)
20+
* [List](api-documentation/machines-1/list.md)
21+
* [Show](api-documentation/machines-1/show.md)
22+
* [Set access for user](api-documentation/machines-1/set-access-for-user.md)
23+
* [Utilization](api-documentation/machines-1/utilization.md)
24+
* [Wait for](api-documentation/machines-1/wait-for.md)
25+
* [Availability](api-documentation/machines-1/machines.md)
26+
* [Templates](api-documentation/templates/README.md)
27+
* [List](api-documentation/templates/list.md)
28+
* [Networks](api-documentation/networks/README.md)
29+
* [List](api-documentation/networks/list.md)
30+
* [Users](api-documentation/users-2/README.md)
31+
* [List](api-documentation/users-2/list.md)
32+
* [logout](api-documentation/users-2/logout.md)
33+
34+
---
35+
36+
* [Resource Delegations](resourcedelegations.md)
37+
* [Scripts](scripts.md)
38+
39+
## Users <a id="users-1"></a>
40+
Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# Machines
2+
3+
CORE machines are Linux and Windows-based virtual machines \(VMs\) that run on top of virtualized hardware. Each machine you create is a new server or desktop instance you can use, either standalone or as part of a larger, cloud-based infrastructure.
4+
5+
## Regional availability
6+
7+
**US East \(NY2\)**
8+
East Coast US, near New York City
9+
10+
**US West \(CA1\)**
11+
West Coast US, near San Francisco
12+
13+
**EU \(AMS1\)**
14+
Central Europe, near Amsterdam
15+
16+
You can test latency to Paperspace datacenters by following [this](https://support.paperspace.com/hc/en-us/articles/360006088293) guide.
17+
You can view the status of our datacenters [here](http://status.paperspace.com/).
18+
19+
Future expansion: We are in the process of expanding our global coverage. [Y](https://blog.paperspace.com/)ou can follow [changelog](https://updates.paperspace.com) for updates.
20+
21+
_Please note that if you are more than 2,000 miles from a data center, you may experience some latency._
22+
23+
## Operating systems
24+
25+
### **Windows**
26+
27+
![mceclip0.png](https://support.paperspace.com/hc/article_attachments/360074205033/mceclip0.png)
28+
29+
**Windows 10** \(Server 2019\) - Licensed
30+
A fully licensed Windows 10 Experience, provided by Windows Server 2019.
31+
Available Machine Types: _Air, Standard, Advanced Pro, GPU+/P4000, P5000, P6000_
32+
33+
**Windows 10** \(Pro\) - BYOL \(Bring Your Own License\)
34+
Windows 10 Pro is available as BYOL or Bring Your Own License.
35+
Available Machine Types: _Air, Standard, Advanced Pro, GPU+/P4000, P5000, P6000_
36+
37+
### **Linux**
38+
39+
![mceclip1.png](https://support.paperspace.com/hc/article_attachments/360073002774/mceclip1.png)
40+
41+
**Ubuntu 18.04** \(Server\)
42+
A Linux VPS in the cloud.
43+
Available Machine Types: _GPU+, P4000, P5000, P6000, V100, C1-C10_
44+
45+
### **Public Templates**
46+
47+
![mceclip2.png](https://support.paperspace.com/hc/article_attachments/360074207633/mceclip2.png)
48+
49+
**Parsec**
50+
A Windows \(Server\) desktop template perfect for gaming
51+
Available Machine Types: _GPU+, P4000, P5000, P6000_
52+
53+
**ML-in-a-Box** \(Desktop\)
54+
A Linux desktop with a [suite of Machine Learning software](https://support.paperspace.com/hc/en-us/articles/236406527) packages included, running 18.04.
55+
Available Machine Types: _GPU+, P4000, P5000, P6000_
56+
57+
{% hint style="info" %}
58+
**Note:** All Operating Systems offered by Paperspace are 64-bit
59+
{% endhint %}
60+
61+
### Networking
62+
63+
* [Dedicated Private Networks](https://support.paperspace.com/hc/en-us/articles/216115938-Dedicated-Private-Networks)
64+
* [VPN Gateway](https://support.paperspace.com/hc/en-us/articles/216949797-VPN-Gateway)
65+
* [Public IP Addresses](https://support.paperspace.com/hc/en-us/articles/360051421153-Public-IP-Addresses)
66+
67+
### Add-ons and integrations
68+
69+
* [Team Integrations and Add-Ons Pricing](https://support.paperspace.com/hc/en-us/articles/235665847-Team-Integrations-and-Add-Ons-Pricing)
70+
* [Active Directory](https://support.paperspace.com/hc/en-us/articles/216604077-Active-Directory)
71+
* [Shared Drives](https://support.paperspace.com/hc/en-us/articles/216688737-Shared-Drives)
72+
* [Content Filtering Appliance](https://support.paperspace.com/hc/en-us/articles/115005869888-Content-Filtering-Appliance)
73+
74+
### Bandwidth
75+
76+
There are no bandwidth charges for either ingress or egress.
77+
78+
### Limits
79+
80+
Paperspace accounts have two types of limits:
81+
82+
#### Service Limits
83+
84+
When you sign up for Paperspace, there are limits to the number of items you can have in your account.
85+
86+
If you need to increase a Service Limit, please [submit a support ticket](https://support.paperspace.com/hc/en-us/requests/new) and select Service Limits Increase from the drop-down. Please tell us a little about how you're using Paperspace and how many machines you require so we can process your request effectively.
87+
88+
![](https://support.paperspace.com/hc/article_attachments/360001973194/mceclip0.png)
89+
90+
Service Limits are visible under the Account tab.
91+
92+
![](https://support.paperspace.com/hc/article_attachments/360013244014/mceclip0.png)
93+
94+
#### Machine Type Limits
95+
96+
Certain machine types require approval. If you visit the console, you may see machines that are not selectable which means you need additional approval to access them. You can either place a request in the console or reach out to your account manager.
97+
98+
99+

0 commit comments

Comments
 (0)