Storage

Whitelist a client IP on a rental's VAST tenant

Register a client IP (e.g. a VM's inband /32) so it is whitelisted on a VAST tenant. Target the tenant by rental_id (via the rental's attached storage) or by storage_id directly (for pools with no attached rental). Idempotent: re-registering the same IP returns 200 instead of 201. The IP becomes part of the authoritative client_ip_ranges set, so the periodic audit keeps it.

post/storage/client-ips

Request

Base URL
https://cloud-api.voltagepark.com/api/v1
Auth
- HTTP bearer
- or API key in header UI-Authorization
TypeScript
https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/docs/storage/client-ips/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

ip_addressstring required

Client IP to whitelist on the VAST tenant (e.g. a VM's inband /32).

rental_idstring uuid nullable

Bare-metal rental ID the IP belongs to; the tenant is resolved via the rental's attached storage. Provide exactly one of rental_id or storage_id.

storage_idstring uuid nullable

Storage volume ID to whitelist the IP against directly (for pools with no attached rental). Provide exactly one of rental_id or storage_id.

Example request

{
  "ip_address": "10.15.136.226"
}

Response

Changes

No recorded changes to this operation across all 3 revisions of this API.