Create an AuraDB instance in the terminal

This tutorial describes using the terminal to create an instance in the Aura Console.

Preparation

Generate API credentials

  • Log in to the Aura Console.

  • Click your email address in the top right corner and select Account details.

  • In the API credentials section, select Create. Enter a descriptive name and save the generated Client ID and Client Secret.

cURL

  • Install cURL via your terminal

  • For macOS with Homebrew: use brew install curl.

  • Install cURL. See curl download wizard for more information.

  • Check cURL is available: Type curl -V in the terminal

Obtain a bearer token

Bearer tokens are valid for one hour.

In the terminal paste the snippet, replacing YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with the values generated by the Aura Console. Keep the : between the values.

curl --location 'https://api.neo4j.io/oauth/token' --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode 'grant_type=client_credentials' -u 'YOUR_CLIENT_ID:YOUR_CLIENT_SECRET' -v

Response body example

Save the access_token from the end of the returned code. This is your bearer token. It looks similar to this example:

"access_token":"eyJ1c3IiOiJkNzI2MzE1My03MWZmLTUxMjQtOWVjYy1lOGFlM2FjNjNjZWUiLCJpc3MiOiJodHRwczovL2F1cmEtYXBpLmV1LmF1dGgwLmNvbS8iLCJzdWIiOiJFSDdsRTgwbEhWQVVkbDVHUUpEY0M1VDdxZ3BNTnpqVkBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9jb25zb2xlLm5lbzRqLmlvIiwiaWF0IjoxNzAyOTgzODQzLCJleHAiOjE3MDI5ODc0NDMsImF6cCI6IkVIN2xFODBsSFZBVWRsNUdRSkRjQzVUN3FncE1OempWIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImFKbWhtUTlYeExsQmFLdHNuZnJIcCJ9..jkpatG4SCRnxwTPzfEcSJk3Yyd0u_NMH8epNqmSBMUlp_JvvqbKpNdkPIE6vx5hLRgVCVKovxl4KY9yzEkr7R5s4YU3s2K25eNB1q1y3yQ_-9N0e6eOhmjIrsWHMd_rl2NuGIHo6pHihumuJlEg-U2ELkWyu8Iz3zQxjycVnPHzlbu7sbtwVJdU7UzgO12jgDLA1T4mUqvxdAAdnoXO57SwczYoYKY2YL61CMTn-xdQ6MFS8A3vwpGQbRirwVVxvEmoIPCLlQwHeEC4_modJ4cifmjt6ChJb1sxsRpFvdNHm0vNcLjy-96e88D50AMgjvS4VQCmVKA7kUgt7t5IpKg","expires_in":3600,"token_type":"Bearer"

Obtain the tenant ID

Use cURL to obtain the tenant ID with your token. Replace YOUR_BEARER_TOKEN with your token.

curl --location 'https://api.neo4j.io/v1/tenants' --header 'Accept: application/json' --header 'Authorization: Bearer YOUR_BEARER_TOKEN'

This returns something similar to:

{"data":[{"id":"6e6bbbe2-5678-5f8a-1234-b1f62f08b98f","name":"team1"},{"id":"ad69ee24-1234-5678-af02-ff8d3cc23611","name":"team2"}]}

In the example response above, two tenants are returned. If you’re a member of multiple tenants, select the one you wish to use.

Configure an AuraDB instance

Configure the instance values

Use the bearer token and Tenant ID to create the Aura instance. Replace YOUR_BEARER_TOKEN with your token. Replace YOUR_TENANT_ID with your tenant ID.

The following values are customizable version, region, memory, name, type, tenantid, and cloud provider.

curl --location 'https://api.neo4j.io/v1/instances' --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer YOUR_BEARER_TOKEN' --data ' { "version": "5", "region": "europe-west1", "memory": "8GB", "name": "instance01", "type": "enterprise-db", "tenant_id": "YOUR_TENANT_ID", "cloud_provider": "gcp" }'

See Aura API documentation for more details.

At this point, an Aura instance is provisioned in the Aura Console. Optionally, use this code in the terminal to check the status:

curl --location 'https://api.neo4j.io/v1/instances/YOUR_INSTANCE_ID' --header 'Accept: application/json' --header 'Authorization: Bearer YOUR_BEARER_TOKEN'

Response

curl --location 'https://api.neo4j.io/v1/instances/YOUR_INSTANCE_ID' --header 'Accept: application/json' --header 'Authorization: Bearer YOUR_BEARER_TOKEN'

If the value of status shows running, you can start using the new Aura instance.