How to Provision a Vultr Object Storage Subscription

Navigate to Products and click Cloud Storage.

Select Object Storage from the list of options.

Click Add Object Storage

Select a Vultr Object Storage tier from the following options:

• Accelerated: High-performance NVMe storage optimized for write-intensive workloads. Supports up to 10,000 IOPS and 5 Gbps throughput.
• Performance: Low-latency NVMe storage designed for datacenter workloads. Supports up to 4,000 IOPS and 1 Gbps throughput.
• Premium: Reliable and durable storage for general-purpose applications. Stored on HDD, indexed on SSD, with up to 1,000 IOPS and 800 Mbps throughput.
• Standard: Cost-effective, high-availability bulk storage. Stored on HDD, indexed on SSD, with up to 800 IOPS and 600 Mbps throughput.

Select your desired Vultr location.

Enter a descriptive label in the Label field.

Click Add Object Storage to provision the Vultr Object Storage subscription.

Send a GET request to the Get All Clusters endpoint and note your target cluster ID depending on the Vultr region.

$ curl "https://api.vultr.com/v2/object-storage/clusters" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

Send a GET request to the Get All Tiers endpoint to view all available Vultr Object Storage tiers and note your target tier ID.

$ curl "https://api.vultr.com/v2/object-storage/tiers" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

Send a POST request to the Create Object Storage endpoint to provision a Vultr Object Storage subscription with your target tier and region.

$ curl "https://api.vultr.com/v2/object-storage" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    --data '{
        "label" : "<label>"  
        "cluster_id" : <cluster-id>,   
        "tier_id" : <tier-id>
    }'

Visit the Create Object Storage endpoint to view additional attributes to apply to your Vultr Object Storage subscription request.

Send a GET request to the List Object Storages endpoint to view all available Vultr Object Storage subscriptions in your account.

$ curl "https://api.vultr.com/v2/object-storage" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json"

List all available Vultr Object Storage clusters and note your target cluster ID depending on the Vultr region.

$ vultr-cli object-storage list-clusters

Provision a Vultr Object Storage subscription.

$ vultr-cli object-storage create --cluster-id <cluster-id> --label <label>

List all Vultr Object Storage subscriptions in your account.

$ vultr-cli object-storage list

Run vultr-cli object-storage create --help to view all available options to apply to your Vultr Object Storage subscription request.

Ensure the Vultr Terraform provider is configured in your Terraform project.

Define the Object Storage subscription resource.

terraform {
    required_providers {
        vultr = {
            source  = "vultr/vultr"
            version = "~> 2.23"
        }
    }
}

provider "vultr" {}

resource "vultr_object_storage" "object_storage" {
    cluster_id = 4  # Object Storage cluster (region).
    tier_id    = 1  # Performance tier ID.
    label      = "Object-Storage"
}

Apply the configuration and observe the following output:

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.