Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
8 changes: 7 additions & 1 deletion ci/yaml_rules.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,17 @@
"type": "dict",
"description": "First and last names of the original guide author."
},
"classic_manager_link": {
"elements": false,
"required": false,
"type": "text",
"description": "In a guide which features copy or screenshots of the new Cloud Manager, this provides a link to the older guide written for the Linode Classic Manager, if an older/classic version of the guide was previously written. The link will be included within the Linode Classic Manager banner message at the bottom of the guide. The link must be a string using the alias format (platform/example-guide-classic-manager). Both the classic_manager_link and cloud_manager_link should be used between corresponding guides to create a bi-directional link. Must use alias-style relative links (e.g. platform/manager/dns-manager-classic-manager/)."
},
"cloud_manager_link": {
"elements": false,
"required": false,
"type": "text",
"description": "In a guide written for the current Linode Manager, if a new version of the guide exists written for the new Linode Manager, use this in the original guide to embed a link to the new guide. Must use alias-style relative links (e.g. platform/manager/dns-manager-cloud-manager/)."
"description": "In a guide which features copy or screenshots of the Linode Classic Manager, this provides a link to a guide written for the new Cloud Manager, if a new version of the guide has been written. The link will be included within the Cloud Manager banner message at the top of the guide. The link must be a string using the alias format (platform/example-guide). Both the classic_manager_link and cloud_manager_link should be used between corresponding guides to create a bi-directional link. Must use alias-style relative links (e.g. platform/manager/dns-manager/)."
},
"concentrations": {
"elements": false,
Expand Down
5 changes: 1 addition & 4 deletions docs/getting-started/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ type: "guide"
weight: 10
icon: "book"
show_on_rss_feed: false
classic_manager_link: getting-started-classic-manager/
---

![Getting Started with Linode](getting-started.jpg "Getting Started with Linode")
Expand All @@ -28,10 +29,6 @@ Thank you for choosing Linode as your cloud hosting provider! This guide will he

From there you'll set up a Linux distribution, boot your Linode, and perform some basic system administration tasks. If you've already created an account and booted your Linode, skip ahead to [connecting to your Linode](#connect-to-your-linode-via-ssh) using SSH.

{{< note >}}
View the Linode Classic Manager version of the [Getting Started](/docs/getting-started-classic-manager/) guide.
{{</ note >}}

<!-- removing the video for now to test if gifs are more helpful
<div class="wistia_responsive_padding" style="padding:56.25% 0 0 0;position:relative;"><div class="wistia_responsive_wrapper" style="height:100%;left:0;position:absolute;top:0;width:100%;"><iframe src="//fast.wistia.net/embed/iframe/35724r19mr?videoFoam=true" allowtransparency="true" frameborder="0" scrolling="no" class="wistia_embed" name="wistia_embed" allowfullscreen mozallowfullscreen webkitallowfullscreen oallowfullscreen msallowfullscreen width="100%" height="100%"></iframe></div></div><script src="//fast.wistia.net/assets/external/E-v1.js" async></script>
-->
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ modified_by:
name: Linode
published: 2015-07-09
title: Configure Your Linode for Reverse DNS (rDNS)
cloud_manager_link: networking/dns/configure-your-linode-for-reverse-dns
headless: true
cloud_manager_link: networking/dns/configure-your-linode-for-reverse-dns/
hiddenguide: true
---

![Configure Your Linode for Reverse DNS (rDNS)](configure-your-linode-reverse-dns.jpg)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,16 @@ author:
description: 'Reverse DNS (rDNS) resolves an IP address to the designated domain name. This guide will teach you how to set it up.'
keywords: ["reverse", "dns", "PTR"]
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
aliases: ['dns-manager/','dns-guides/configuring-dns-with-the-linode-manager/','networking/dns/setting-reverse-dns/','networking/Setting-Up-Reverse-DNS-Lookup/','networking/configure-your-linode-for-reverse-dns/']
aliases: ['networking/Setting-Up-Reverse-DNS-Lookup/','dns-guides/configuring-dns-with-the-linode-manager/','networking/configure-your-linode-for-reverse-dns/','networking/dns/setting-reverse-dns/','dns-manager/']
modified_by:
name: Linode
published: 2015-07-09
title: Configure Your Linode for Reverse DNS (rDNS)
classic_manager_link: networking/dns/configure-your-linode-for-reverse-dns-classic-manager/
---

![Configure Your Linode for Reverse DNS (rDNS)](configure-your-linode-reverse-dns.jpg)

{{< note >}}
You can also view the Linode Classic Manager version of the [Configure Your Linode for Reverse DNS](/docs/networking/dns/configure-your-linode-for-reverse-dns-classic-manager/) guide.
{{</ note >}}

Computers use DNS to determine the IP address associated with a domain name. *Reverse* DNS lookup does the opposite by resolving an IP address to a designated domain name. You should always set the reverse DNS, even if your Linode hosts more than one domain.

Reverse DNS uses a *pointer record* (*PTR*) to match an IP address with a domain or subdomain. PTR records are generally set with a hosting provider, so reverse DNS is set in the Linode Cloud Manager.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: 'This guide introduces the Linode API and demonstrates several basi
og_description: 'This guide introduces the Linode API and demonstrates several basic queries. It also covers authentication and the process of creating a new Linode through the API.'
keywords: ["linode api", "api v4", "access token"]
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
modified: 2018-08-20
modified: 2018-06-29
modified_by:
name: Linode
published: 2018-04-03
Expand All @@ -15,48 +15,39 @@ external_resources:
- '[API Documentation](https://developers.linode.com/v4/introduction)'
- '[Linode CLI](https://github.com/linode/linode-cli)'
- '[Linode API Python Library](https://github.com/linode/python-linode-api)'
cloud_manager_link: platform/api/getting-started-with-the-linode-api/
hiddenguide: true
---

## Create a Linode Using the Linode API

The Linode API allows you to automate any task that can be performed by the Cloud Manager, such as creating Linodes, managing IP addresses and DNS, and opening support tickets.
The Linode API allows you to automate any task that can be performed by the Linode Manager, such as creating Linodes, managing IP addresses and DNS, and opening support tickets.

For example, this command creates a new 2GB Linode, deploys a Debian 9 image, and boots the system:

curl -X POST https://api.linode.com/v4/linode/instances \
-H "Authorization: Bearer $TOKEN" -H "Content-type: application/json" \
-d '{"type": "g5-standard-2", "region": "us-east", "image": "linode/debian9", "root_pass": "root_password", "label": "prod-1"}'

This guide will help you get set up to run this example. Note that if you run this command, you will create and be [charged for a 2GB Linode](/pricing).
This guide will help you get set up to run this example. Note that if you run this command, you will be create and be [charged for a 2GB Linode](/pricing).

## Get an Access Token

Only authorized users can add Linodes and make changes to your account, and each request must be authenticated with an access token.

The easiest way to get a token is through the [Cloud Manager](https://cloud.linode.com).
The easiest way to get a token is through the [beta Linode Manager](https://cloud.linode.com).

{{< note >}}
If you are building an application which will need to authenticate multiple users (for example, a custom interface to Linode's infrastructure for your organization), you can set up an [OAuth authentication flow](https://developers.linode.com/v4/access) to generate tokens for each user.
{{< /note >}}

### Create an API Token

1. Log in to the Cloud Manager.
1. Log in to the Manager and select the **API Tokens** tab from the **My Profile** menu:

1. Click on your username at the top of the screen and select **My Profile**.
2. Click on **Add a Personal Access Token** and choose the access rights you want users authenticated with the new token to have. Privileges are cascading, so a token with *Create* access will also have *Modify* and *View* access.

![Select My Profile.](get-started-with-linode-api-select-my-profile.png "Select My Profile.")

1. Select the **API Tokens** tab:

![Select API Tokens tab in My Profile Settings.](get-started-with-linode-api-my-profile-small.png "Select the API Tokens tab in My Profile Settings.")

1. Click on **Add a Personal Access Token** and choose the access rights you want users authenticated with the new token to have.

![Add a Personal Access Token](get-started-with-linode-api-new-token.png "Add a Personal Access Token")

When you have finished, click **Submit** to generate an API token string. Copy the token and save it in a secure location. **You will not be able to view the token through the Cloud Manager after closing the popup.**
When you have finished, click **Submit** to generate an API token string. Copy the token and save it in a secure location. **You will not be able to view the token through the Manager after closing the popup.**

### Authenticate Requests

Expand Down
27 changes: 19 additions & 8 deletions docs/platform/api/getting-started-with-the-linode-api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: 'This guide introduces the Linode API and demonstrates several basi
og_description: 'This guide introduces the Linode API and demonstrates several basic queries. It also covers authentication and the process of creating a new Linode through the API.'
keywords: ["linode api", "api v4", "access token"]
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
modified: 2018-06-29
modified: 2018-08-20
modified_by:
name: Linode
published: 2018-04-03
Expand All @@ -15,38 +15,49 @@ external_resources:
- '[API Documentation](https://developers.linode.com/v4/introduction)'
- '[Linode CLI](https://github.com/linode/linode-cli)'
- '[Linode API Python Library](https://github.com/linode/python-linode-api)'
cloud_manager_link: platform/api/getting-started-with-the-linode-api-new-manager/
aliases: ['platform/api/getting-started-with-the-linode-api-new-manager/']
classic_manager_link: platform/api/getting-started-with-the-linode-api-classic-manager/
---

## Create a Linode Using the Linode API

The Linode API allows you to automate any task that can be performed by the Linode Manager, such as creating Linodes, managing IP addresses and DNS, and opening support tickets.
The Linode API allows you to automate any task that can be performed by the Cloud Manager, such as creating Linodes, managing IP addresses and DNS, and opening support tickets.

For example, this command creates a new 2GB Linode, deploys a Debian 9 image, and boots the system:

curl -X POST https://api.linode.com/v4/linode/instances \
-H "Authorization: Bearer $TOKEN" -H "Content-type: application/json" \
-d '{"type": "g5-standard-2", "region": "us-east", "image": "linode/debian9", "root_pass": "root_password", "label": "prod-1"}'

This guide will help you get set up to run this example. Note that if you run this command, you will be create and be [charged for a 2GB Linode](/pricing).
This guide will help you get set up to run this example. Note that if you run this command, you will create and be [charged for a 2GB Linode](/pricing).

## Get an Access Token

Only authorized users can add Linodes and make changes to your account, and each request must be authenticated with an access token.

The easiest way to get a token is through the [beta Linode Manager](https://cloud.linode.com).
The easiest way to get a token is through the [Cloud Manager](https://cloud.linode.com).

{{< note >}}
If you are building an application which will need to authenticate multiple users (for example, a custom interface to Linode's infrastructure for your organization), you can set up an [OAuth authentication flow](https://developers.linode.com/v4/access) to generate tokens for each user.
{{< /note >}}

### Create an API Token

1. Log in to the Manager and select the **API Tokens** tab from the **My Profile** menu:
1. Log in to the Cloud Manager.

2. Click on **Add a Personal Access Token** and choose the access rights you want users authenticated with the new token to have. Privileges are cascading, so a token with *Create* access will also have *Modify* and *View* access.
1. Click on your username at the top of the screen and select **My Profile**.

When you have finished, click **Submit** to generate an API token string. Copy the token and save it in a secure location. **You will not be able to view the token through the Manager after closing the popup.**
![Select My Profile.](get-started-with-linode-api-select-my-profile.png "Select My Profile.")

1. Select the **API Tokens** tab:

![Select API Tokens tab in My Profile Settings.](get-started-with-linode-api-my-profile-small.png "Select the API Tokens tab in My Profile Settings.")

1. Click on **Add a Personal Access Token** and choose the access rights you want users authenticated with the new token to have.

![Add a Personal Access Token](get-started-with-linode-api-new-token.png "Add a Personal Access Token")

When you have finished, click **Submit** to generate an API token string. Copy the token and save it in a secure location. **You will not be able to view the token through the Cloud Manager after closing the popup.**

### Authenticate Requests

Expand Down
Loading