Offers

Download schema

Lists the IDs of the commercial offers available to deploy.

List offers

GET

https://api.scaleway.com

/baremetal/v1/zones/{zone}/offers

List all available Elastic Metal server configurations.

List offers › path Parameters

zone

string · enum · required

The zone you want to target

Enum values:

fr-par-1

fr-par-2

nl-ams-1

nl-ams-2

pl-waw-2

pl-waw-3

List offers › query Parameters

page

integer · int32

Page number.

page_size

integer · uint32

Number of offers per page.

subscription_period

scaleway.baremetal.v1.Offer.SubscriptionPeriod · enum

Subscription period type to filter offers by.

Enum values:

unknown_subscription_period

hourly

monthly

Default: unknown_subscription_period

name

string

Offer name to filter offers by.

List offers › Responses

200

scaleway.baremetal.v1.ListOffersResponse

total_count

integer · uint32

Total count of matching offers.

scaleway.baremetal.v1.Offer[]

Offers that match filters.

GET/baremetal/v1/zones/{zone}/offers

curl -X GET \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/baremetal/v1/zones/{zone}/offers"

Example Responses

{
  "total_count": 0,
  "offers": [
    {
      "id": "id",
      "name": "name",
      "stock": "empty",
      "bandwidth": 0,
      "max_bandwidth": 0,
      "commercial_range": "commercial_range",
      "price_per_hour": {
        "currency_code": "currency_code",
        "units": 0,
        "nanos": 0
      },
      "price_per_month": {
        "currency_code": "currency_code",
        "units": 0,
        "nanos": 0
      },
      "disks": [
        {
          "capacity": 0,
          "type": "type"
        }
      ],
      "enable": true,
      "cpus": [
        {
          "name": "name",
          "core_count": 0,
          "thread_count": 0,
          "frequency": 0,
          "benchmark": "benchmark"
        }
      ],
      "memories": [
        {
          "capacity": 0,
          "type": "type",
          "frequency": 0,
          "is_ecc": true,
          "ecc_type": "unknown_ecc_type"
        }
      ],
      "quota_name": "quota_name",
      "persistent_memories": [
        {
          "capacity": 0,
          "type": "type",
          "frequency": 0
        }
      ],
      "raid_controllers": [
        {
          "model": "model",
          "raid_level": [
            "string"
          ]
        }
      ],
      "incompatible_os_ids": [
        "string"
      ],
      "subscription_period": "unknown_subscription_period",
      "operation_path": "operation_path",
      "fee": {
        "currency_code": "currency_code",
        "units": 0,
        "nanos": 0
      },
      "options": [
        {
          "id": "id",
          "name": "name",
          "enabled": true,
          "subscription_period": "unknown_subscription_period",
          "price": {
            "currency_code": "currency_code",
            "units": 0,
            "nanos": 0
          },
          "manageable": true,
          "os_id": "os_id",
          "license": {
            "os_id": "os_id"
          },
          "public_bandwidth": {
            "bandwidth_in_bps": 0
          },
          "private_network": {
            "bandwidth_in_bps": 0
          },
          "remote_access": {},
          "certification": {}
        }
      ],
      "private_bandwidth": 0,
      "shared_bandwidth": true,
      "tags": [
        "string"
      ],
      "gpus": [
        {
          "name": "name",
          "vram": 0
        }
      ],
      "monthly_offer_id": "monthly_offer_id",
      "zone": "zone",
      "dual_attach": true
    }
  ]
}

json

application/json

Get offer

GET

https://api.scaleway.com

/baremetal/v1/zones/{zone}/offers/{offer_id}

Get details of an offer identified by its offer ID.

Get offer › path Parameters

zone

string · enum · required

The zone you want to target

Enum values:

fr-par-1

fr-par-2

nl-ams-1

nl-ams-2

pl-waw-2

pl-waw-3

offer_id

string · required

ID of the researched Offer.

Get offer › Responses

200

scaleway.baremetal.v1.Offer

id

string

ID of the offer.

name

string

Name of the offer.

stock

scaleway.baremetal.v1.Offer.Stock · enum

Stock level.

Enum values:

empty

low

available

Default: empty

bandwidth

integer · uint64

Public bandwidth available (in bits/s) with the offer.

max_bandwidth

integer · uint64

Maximum public bandwidth available (in bits/s) depending on available options.

commercial_range

string

Commercial range of the offer.

google.type.Money

Price of the offer for the next 60 minutes (a server order at 11h32 will be paid until 12h32).

google.type.Money

Monthly price of the offer, if subscribing on a monthly basis.

scaleway.baremetal.v1.Disk[]

Disks specifications of the offer.

enable

boolean

Defines whether the offer is currently available.

scaleway.baremetal.v1.CPU[]

CPU specifications of the offer.

scaleway.baremetal.v1.Memory[]

Memory specifications of the offer.

quota_name

string

Name of the quota associated to the offer.

scaleway.baremetal.v1.PersistentMemory[]

Persistent memory specifications of the offer.

scaleway.baremetal.v1.RaidController[]

Raid controller specifications of the offer.

incompatible_os_ids

string[]

Array of OS images IDs incompatible with the server.

subscription_period

scaleway.baremetal.v1.Offer.SubscriptionPeriod · enum

Period of subscription for the offer.

Enum values:

unknown_subscription_period

hourly

monthly

Default: unknown_subscription_period

operation_path

string

Operation path of the service.

google.type.Money

One time fee invoiced by Scaleway for the setup and activation of the server.

scaleway.baremetal.v1.Offer.OptionOffer[]

Available options for customization of the server.

private_bandwidth

integer · uint64

Private bandwidth available in bits/s with the offer.

shared_bandwidth

boolean

Defines whether the offer's bandwidth is shared or not.

tags

string[]

Array of tags attached to the offer.

scaleway.baremetal.v1.GPU[]

GPU specifications of the offer.

monthly_offer_id

string | null

Exist only for hourly offers, to migrate to the monthly offer.

zone

string

Zone in which is the offer is available.

dual_attach

boolean | null

Describe the network topology of the offer.

GET/baremetal/v1/zones/{zone}/offers/{offer_id}

curl -X GET \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/baremetal/v1/zones/{zone}/offers/{offer_id}"

Example Responses

{
  "id": "id",
  "name": "name",
  "stock": "empty",
  "bandwidth": 0,
  "max_bandwidth": 0,
  "commercial_range": "commercial_range",
  "price_per_hour": {
    "currency_code": "currency_code",
    "units": 0,
    "nanos": 0
  },
  "price_per_month": {
    "currency_code": "currency_code",
    "units": 0,
    "nanos": 0
  },
  "disks": [
    {
      "capacity": 0,
      "type": "type"
    }
  ],
  "enable": true,
  "cpus": [
    {
      "name": "name",
      "core_count": 0,
      "thread_count": 0,
      "frequency": 0,
      "benchmark": "benchmark"
    }
  ],
  "memories": [
    {
      "capacity": 0,
      "type": "type",
      "frequency": 0,
      "is_ecc": true,
      "ecc_type": "unknown_ecc_type"
    }
  ],
  "quota_name": "quota_name",
  "persistent_memories": [
    {
      "capacity": 0,
      "type": "type",
      "frequency": 0
    }
  ],
  "raid_controllers": [
    {
      "model": "model",
      "raid_level": [
        "string"
      ]
    }
  ],
  "incompatible_os_ids": [
    "string"
  ],
  "subscription_period": "unknown_subscription_period",
  "operation_path": "operation_path",
  "fee": {
    "currency_code": "currency_code",
    "units": 0,
    "nanos": 0
  },
  "options": [
    {
      "id": "id",
      "name": "name",
      "enabled": true,
      "subscription_period": "unknown_subscription_period",
      "price": {
        "currency_code": "currency_code",
        "units": 0,
        "nanos": 0
      },
      "manageable": true,
      "os_id": "os_id",
      "license": {
        "os_id": "os_id"
      },
      "public_bandwidth": {
        "bandwidth_in_bps": 0
      },
      "private_network": {
        "bandwidth_in_bps": 0
      },
      "remote_access": {},
      "certification": {}
    }
  ],
  "private_bandwidth": 0,
  "shared_bandwidth": true,
  "tags": [
    "string"
  ],
  "gpus": [
    {
      "name": "name",
      "vram": 0
    }
  ],
  "monthly_offer_id": "monthly_offer_id",
  "zone": "zone",
  "dual_attach": true
}

json

application/json

BMC Access Options