Instance API

Scaleway Instances are virtual machines in the cloud. Different Instance typesOpen in new context offer different technical specifications in terms of vCPU, RAM, bandwidth, and storage. Once you have created your Instance and installed your image of choice (e.g. an operating system), you can connect to your Instance via SSHOpen in new context to use it as you wish. When you are done using the Instance, you can delete it from your account.

Concepts

Refer to our dedicated concepts pageOpen in new context to find definitions of all concepts and terminology related to Instances.

Quickstart

1. Configure your environment variables:

   Note

   This is an optional step that seeks to simplify your usage of the Instances API. See Availability Zones below for help choosing an Availability Zone. You can find your Project ID in the Scaleway consoleOpen in new context.

   Code
   export SCW_SECRET_KEY="<API secret key>"
   export SCW_DEFAULT_ZONE="<Scaleway Availability Zone>"
   export SCW_PROJECT_ID="<Scaleway Project ID>"

2. Create an Instance: Run the following command to create an Instance. You can customize the details in the payload (name, description, type, tags etc) to your needs: use the information below to adjust the payload as necessary.

   Code
   curl -X POST \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     -H "Content-Type: application/json" \
     "https://api.scaleway.com/instance/v2alpha1/zones/$SCW_DEFAULT_ZONE/servers" \
       -d '{
         "name": "my-new-instance",
         "project_id": "'"$SCW_PROJECT_ID"'",
         "server_type": "GP1-S",
         "public_network_interface": {
           "ips": [
             {
               "new_ip": {
                 "type": "zonal_ipv4"
               }
             },
             {
               "ipam_ip_id": "<IP-ID>"
             }
           ]
         },
         "volumes": [
           {
             "volume_type": "l_ssd",
             "new_volume": {
               "name": "my-new-volume",
               "image_label": "ubuntu_noble"
             }
           },
           {
             "volume_type": "sbs",
             "volume_id": "<Volume-ID>"
           }
         ]
       }'

3. List your Instances: Run the following command to get a list of all the Instances in your account, with their details:

   Code
   curl -X GET \
     -H "Content-Type: application/json" \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     "https://api.scaleway.com/instance/v2alpha1/zones/$SCW_DEFAULT_ZONE/servers/"

4. Delete an Instance: Run the following command to delete an Instance, specified by its Instance ID:

   Code
   curl -X DELETE \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     -H "Content-Type: application/json" \
     "https://api.scaleway.com/instance/v2alpha1/zones/$SCW_DEFAULT_ZONE/servers/<Instance-ID>"

   The expected successful response is empty.

Technical information

Availability Zones

You can deploy Instances in the following Availability Zones:

Pagination

The listing requests receive a paginated response. They accept two query arguments:

• page_token, a string representing the wanted page. If it's not provided the first page will be returned.
• page_size, a positive integer lower or equal to 100 to select the number of items to return per page. The default value is 100.

Paginated endpoints usually also accept filters to search and sort results. These filters are documented along each endpoint documentation.

The listing response contain the next_page_token, the token to retrieve the next page.

Going further

For more help using Scaleway Instances, check out the following resources:

• Our main documentationOpen in new context
• The #instance channel on our Slack CommunityOpen in new context
• Our support ticketing systemOpen in new context.