Object storage

Aliases: object-storage, os

Subcommands

list — List object storage endpoints
get — Get object storage endpoint details
create — Create a new object storage endpoint
delete — Delete an object storage endpoint
list-policies — List identity policies for an endpoint
get-policy-document — Show the JSON policy document for an identity policy
create-policy — Create a new identity policy on an endpoint
update-policy — Update an existing identity policy
delete-policy — Delete an identity policy from an endpoint
list-access-keys — List access keys for an endpoint
create-access-key — Create a new access key for an endpoint
delete-access-key — Delete an access key from an endpoint

list

List object storage endpoints, optionally filtered by organization, project, or region.

nscale object-storage list [flags]

Flags

Flag	Description
`—org string`	Organization ID
`—project string`	Project ID
`—region string`	Region ID
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

Example

nscale object-storage list --org <org-id> --region <region-id>

get

Get details for a specific object storage endpoint.

nscale object-storage get --id <endpoint-id> --org <org-id>

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—org string`	Organization ID
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

create

Create a new object storage endpoint. Accepts input from a JSON file or stdin.

nscale object-storage create [flags]

Flags

Flag	Description
`-f, —file string`	Path to a JSON file
`—stdin`	Read JSON from standard input
`—dry-run`	Preview the request payload without persisting
`-y, —yes`	Automatically confirm creation
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

Examples

nscale object-storage create --file endpoint.json
nscale object-storage create --stdin < endpoint.json
cat endpoint.json | nscale object-storage create --stdin

delete

Delete an existing object storage endpoint.

nscale object-storage delete --id <endpoint-id> --org <org-id> [flags]

Flags

Flag	Description
`--id string`	Object storage endpoint ID
`--org string`	Organization ID
`--dry-run`	Preview the request payload without persisting
`-y, --yes`	Automatically confirm deletion

Example

nscale object-storage delete --id <endpoint-id> --org <org-id> --yes

list-policies

List identity policies for an object storage endpoint.

nscale object-storage list-policies --id <endpoint-id> --org <org-id>

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—org string`	Organization ID
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

get-policy-document

Show the JSON policy document for an identity policy on an object storage endpoint.

nscale object-storage get-policy-document --id <endpoint-id> --name <policy-name> --org <org-id>

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—name string`	Identity policy name
`—org string`	Organization ID
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

create-policy

Create a new identity policy on an object storage endpoint. The policy document is read from a JSON file or stdin.

nscale object-storage create-policy --id <endpoint-id> --name <policy-name> [flags]

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—name string`	Identity policy name
`—org string`	Organization ID
`-f, —file string`	Path to a JSON policy document file
`—stdin`	Read JSON from standard input
`—dry-run`	Preview the request payload without persisting
`-y, —yes`	Automatically confirm creation
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

Examples

nscale object-storage create-policy --id <endpoint-id> --name read-only --file policy.json
cat policy.json | nscale object-storage create-policy --id <endpoint-id> --name read-only --stdin

update-policy

Update an existing identity policy on an object storage endpoint. The policy document is read from a JSON file or stdin.

nscale object-storage update-policy --id <endpoint-id> --name <policy-name> [flags]

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—name string`	Identity policy name
`—org string`	Organization ID
`-f, —file string`	Path to a JSON policy document file
`—stdin`	Read JSON from standard input
`—dry-run`	Preview the request payload without persisting
`-y, —yes`	Automatically confirm update
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

Examples

nscale object-storage update-policy --id <endpoint-id> --name read-only --file policy.json
cat policy.json | nscale object-storage update-policy --id <endpoint-id> --name read-only --stdin

delete-policy

Delete an identity policy from an object storage endpoint.

nscale object-storage delete-policy --id <endpoint-id> --name <policy-name> --org <org-id> [flags]

Flags

Flag	Description
`--id string`	Object storage endpoint ID
`--name string`	Identity policy name
`--org string`	Organization ID
`--dry-run`	Preview the request payload without persisting
`-y, --yes`	Automatically confirm deletion

Example

nscale object-storage delete-policy --id <endpoint-id> --name read-only --org <org-id> --yes

list-access-keys

List access keys for an object storage endpoint.

nscale object-storage list-access-keys --id <endpoint-id> --org <org-id>

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—org string`	Organization ID
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

create-access-key

Create a new access key for an object storage endpoint, optionally associated with an identity policy.

nscale object-storage create-access-key --id <endpoint-id> --name <key-name> [flags]

Flags

Flag	Description
`—id string`	Object storage endpoint ID
`—name string`	Access key name
`—policy string`	Identity policy name to associate with the access key
`—org string`	Organization ID
`—dry-run`	Preview the request payload without persisting
`-y, —yes`	Automatically confirm creation
`—json`	Emit the full JSON payload (mutually exclusive with `-q`)
`-q, —query stringArray`	jq filter for value extraction (see Query output with `-q`)

Example

nscale object-storage create-access-key --id <endpoint-id> --name my-key --policy read-only

delete-access-key

Delete an access key from an object storage endpoint.

nscale object-storage delete-access-key --id <endpoint-id> --access-key-id <access-key-id> --org <org-id> [flags]

Flags

Flag	Description
`--id string`	Object storage endpoint ID
`--access-key-id string`	Access key ID
`--org string`	Organization ID
`--dry-run`	Preview the request payload without persisting
`-y, --yes`	Automatically confirm deletion

Example

nscale object-storage delete-access-key --id <endpoint-id> --access-key-id <access-key-id> --org <org-id> --yes

Object Storage (Console)

Create and manage object storage via the Console UI.

​Subcommands

​list

​Flags

​Example

​get

​Flags

​create

​Flags

​Examples

​delete

​Flags

​Example

​list-policies

​Flags

​get-policy-document

​Flags

​create-policy

​Flags

​Examples

​update-policy

​Flags

​Examples

​delete-policy

​Flags

​Example

​list-access-keys

​Flags

​create-access-key

​Flags

​Example

​delete-access-key

​Flags

​Example

​Related

Object Storage (Console)

Subcommands

list

Flags

Example

get

Flags

create

Flags

Examples

delete

Flags

Example

list-policies

Flags

get-policy-document

Flags

create-policy

Flags

Examples

update-policy

Flags

Examples

delete-policy

Flags

Example

list-access-keys

Flags

create-access-key

Flags

Example

delete-access-key

Flags

Example

Related