Order Object Storage with the API, gyro CLI and Terraform

1. See the plans and prices

gyro storage plans

Prices are fixed in euro, exclude VAT and are charged in your account currency at today's rate. Each plan lists its monthly, quarterly, semiannually and annually price and the list price before the discount (list_amount). A plan with available: false cannot be ordered right now because of capacity.

Add-ons:

• Extra traffic (extra_traffic: 1tb or 5tb): one-time, valid until the end of the calendar month of purchase.
• Object lock (object_lock_buckets: 1-50): Protected plans only; the right to create locked (WORM) buckets, billed every cycle.

2. Place the order

Get a quote first (nothing is created, nothing is charged):

gyro storage create --plan standard-1tb --cycle monthly --name gyro-proje-yedek --dry-run

Then order. The CLI asks for confirmation (--yes skips it). The price is taken from your balance; a stored card is never used:

gyro storage create --plan standard-1tb --cycle monthly --name gyro-proje-yedek

The same with the API:

curl -X POST https://www.gyrohosting.com/api/v1/client/cloud/storage \
  -H "Authorization: Bearer $GYRO_TOKEN" -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"plan":"standard-1tb","cycle":"monthly","name":"gyro-proje-yedek","confirm":true}'

• A real order needs "confirm": true and an Idempotency-Key header. Sending the same key again never opens a second order; you get the first answer back.
• quantity opens several services in one order (max 25). {n} in the name becomes the number: "name": "gyro-yedek-{n}".
• Protected plan with object lock and extra traffic: {"plan":"protected-250gb","object_lock_buckets":2,"extra_traffic":"1tb","confirm":true}.
• project_id puts the service in a project. With a reseller key, end_customer_id assigns it to an end customer.

The service is ready in about one minute (inprocess → active). The first bucket and the first access key are created automatically:

gyro storage get 12345           # plan, endpoint, region
gyro storage bucket list 12345   # first bucket
gyro storage connect 12345       # S3 connection details

The secret of the first key is shown once in the panel. To get a new key over the API use gyro storage key create 12345 and save the secret at once.

3. With Terraform

resource "gyro_storage" "yedek" {
  plan  = "standard-1tb"
  cycle = "monthly"
  name  = "gyro-proje-yedek"

  lifecycle {
    prevent_destroy = true   # destroy deletes every bucket and object
  }
}

resource "gyro_storage_bucket" "dosyalar" {
  service_id = gyro_storage.yedek.service_id
  name       = "gyro-proje-dosyalar"
}

• name changes in place.
• plan, cycle and object_lock_buckets cannot be changed in Terraform; terraform plan reports an error. Terraform never re-creates the service, because that would delete the data.
• terraform destroy cancels at once and deletes the data. With delete_immediately = false only a cancellation request is filed.

4. Cancel

gyro storage delete 12345 --yes

DELETE /cloud/storage/12345?confirm=true&immediate=true cancels at once. Access keys, the website and custom domains stop within about a minute. Buckets and objects are deleted permanently within minutes and cannot be restored. On Protected Storage, versions under a COMPLIANCE lock or legal hold stay until the lock ends and are billed. Without immediate only a cancellation request is filed.

5. Error codes

6. Frequently asked questions