Skip to Content
Referenceoo CLI

oo namespace

Your Namespace account: connections and advanced operations.

Connect this Sunport to your own Namespace account, and use its advanced operations: images, templates, registry, caches, vault metadata and the other areas below.

A connection keeps a Namespace revokable token (nsc token create), encrypted in the Sunport and never shown again. oo reads it from a file or stdin, never from its arguments. Connecting and disconnecting need environments.manage, and a connection disconnects only once its environments are all cleaned up.

An area command runs one operation on a BYO connection: a read needs namespace.read on the area, a write namespace.manage. Give its request as key=value inputs or --json @FILE; oo api route GET /api/v1/namespace/AREA/OPERATION shows the request's fields. Answers never carry Vault values or the Sunport's credentials.

oo namespace connection

List, add or remove connections to Namespace accounts

oo namespace connection [COMMAND]

It also takes the connection options.

oo namespace connection list

List this Sunport's Namespace connections

oo namespace connection list

It also takes the connection options.

oo namespace connection show

Show one connection: its account, status and limits

oo namespace connection show CONNECTION_ID
ArgumentRequiredDefaultChoicesDescription
CONNECTION_IDyesconnection ID from oo namespace connection list

It also takes the connection options.

oo namespace connection connect

Connect a Namespace account with its token

oo namespace connection connect FILE
ArgumentRequiredDefaultChoicesDescription
FILEyesa file holding the Namespace token, or - for stdin

It also takes the connection options.

oo namespace connection replace-token

Give a connection a new token for the same Namespace account, e.g. after expiry

oo namespace connection replace-token CONNECTION_ID FILE
ArgumentRequiredDefaultChoicesDescription
CONNECTION_IDyesconnection ID from oo namespace connection list
FILEyesa file holding the new Namespace token, or - for stdin

It also takes the connection options.

oo namespace connection disconnect

Disconnect one and delete its token

oo namespace connection disconnect [options] CONNECTION_ID
ArgumentRequiredDefaultChoicesDescription
CONNECTION_IDyesconnection ID from oo namespace connection list
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

oo namespace console

Print the link to the Namespace console of a BYO connection's workspace. A managed connection has none: OpenOrange runs that account.

oo namespace console [CONNECTION_ID]
ArgumentRequiredDefaultChoicesDescription
CONNECTION_IDnoconnection ID from oo namespace connection list (default the only active BYO connection)

It also takes the connection options.

oo namespace images

Advanced Namespace operations on devbox images. Reads need namespace.read on namespace/images, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace images [COMMAND]

It also takes the connection options.

oo namespace images list-images

List images

oo namespace images list-images [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace images inspect-image

Inspect image

oo namespace images inspect-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace images describe-image

Describe image

oo namespace images describe-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace images wire-image

Wire image (write)

oo namespace images wire-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace images optimize-image

Optimize image (write)

oo namespace images optimize-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace images expire-image

Expire image (write)

oo namespace images expire-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace templates

Advanced Namespace operations on devbox templates. Reads need namespace.read on namespace/templates, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace templates [COMMAND]

It also takes the connection options.

oo namespace templates list-templates

List templates

oo namespace templates list-templates [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace templates fetch-template

Fetch template

oo namespace templates fetch-template [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace templates create-template

Create template (write)

oo namespace templates create-template [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace templates update-template

Update template (write)

oo namespace templates update-template [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace templates expire-template

Expire template (write)

oo namespace templates expire-template [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace features

Advanced Namespace operations on composable devbox features. Reads need namespace.read on namespace/features, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace features [COMMAND]

It also takes the connection options.

oo namespace features list-composable-features

List composable features

oo namespace features list-composable-features [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace features register-composable-feature

Register composable feature (write)

oo namespace features register-composable-feature [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace features remove-composable-feature

Remove composable feature (write)

oo namespace features remove-composable-feature [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace defaults

Advanced Namespace operations on the Sunport's devbox defaults. Reads need namespace.read on namespace/defaults, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace defaults [COMMAND]

It also takes the connection options.

oo namespace defaults fetch-defaults

Fetch defaults

oo namespace defaults fetch-defaults [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace defaults update-defaults

Update defaults (write)

oo namespace defaults update-defaults [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace integrations

Advanced Namespace operations on Git repositories for devboxes. Reads need namespace.read on namespace/integrations, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace integrations [COMMAND]

It also takes the connection options.

oo namespace integrations create-repository

Create repository (write)

oo namespace integrations create-repository [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace egress

Advanced Namespace operations on egress policies. Reads need namespace.read on namespace/egress, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace egress [COMMAND]

It also takes the connection options.

oo namespace egress get-egress-policy

Get egress policy

oo namespace egress get-egress-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace egress list-egress-policies

List egress policies

oo namespace egress list-egress-policies [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace egress create-egress-policy

Create egress policy (write)

oo namespace egress create-egress-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace egress update-egress-policy

Update egress policy (write)

oo namespace egress update-egress-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace registry

Advanced Namespace operations on the container registry: images, tags, sharing and expiry. Reads need namespace.read on namespace/registry, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace registry [COMMAND]

It also takes the connection options.

oo namespace registry list-repositories

List repositories

oo namespace registry list-repositories [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry list-images

List images

oo namespace registry list-images [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry list-tags

List tags

oo namespace registry list-tags [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry list-tag-versions

List tag versions

oo namespace registry list-tag-versions [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry get-image

Get image

oo namespace registry get-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry list-shared-images

List shared images

oo namespace registry list-shared-images [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry get-default-policy

Get default policy

oo namespace registry get-default-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry get-repository-policy

Get repository policy

oo namespace registry get-repository-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace registry share-image

Share image (write)

oo namespace registry share-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace registry unshare-image

Unshare image (write)

oo namespace registry unshare-image [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace registry update-image-lifetime

Update image lifetime (write)

oo namespace registry update-image-lifetime [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace registry update-default-policy

Update default policy (write)

oo namespace registry update-default-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace registry update-repository-policy

Update repository policy (write)

oo namespace registry update-repository-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace storage

Advanced Namespace operations on cache and persistent volumes and their snapshots. Reads need namespace.read on namespace/storage, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace storage [COMMAND]

It also takes the connection options.

oo namespace storage get-cache-volume

Get cache volume

oo namespace storage get-cache-volume [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage list-cache-volumes

List cache volumes

oo namespace storage list-cache-volumes [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage get-volume-tag-summary

Get volume tag summary

oo namespace storage get-volume-tag-summary [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage list-volume-tag-summaries

List volume tag summaries

oo namespace storage list-volume-tag-summaries [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage list-persistent-volumes

List persistent volumes

oo namespace storage list-persistent-volumes [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage describe-persistent-volume

Describe persistent volume

oo namespace storage describe-persistent-volume [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage list-persistent-volume-snapshots

List persistent volume snapshots

oo namespace storage list-persistent-volume-snapshots [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace storage destroy-cache-volume

Destroy cache volume (write)

oo namespace storage destroy-cache-volume [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace storage destroy-persistent-volumes

Destroy persistent volumes (write)

oo namespace storage destroy-persistent-volumes [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace storage destroy-persistent-volume-snapshot

Destroy persistent volume snapshot (write)

oo namespace storage destroy-persistent-volume-snapshot [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace caches

Advanced Namespace operations on Bazel, Gradle and HTTP build caches. Reads need namespace.read on namespace/caches, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace caches [COMMAND]

It also takes the connection options.

oo namespace caches get-bazel-cache

Get bazel cache

oo namespace caches get-bazel-cache [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace caches gradle-get-access-policy

Gradle get access policy

oo namespace caches gradle-get-access-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace caches http-get-access-policy

Http get access policy

oo namespace caches http-get-access-policy [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace caches ensure-bazel-cache

Ensure bazel cache (write)

oo namespace caches ensure-bazel-cache [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace caches gradle-ensure-gradle-cache

Gradle ensure gradle cache (write)

oo namespace caches gradle-ensure-gradle-cache [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace caches http-ensure-http-cache

Http ensure http cache (write)

oo namespace caches http-ensure-http-cache [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace builders

Advanced Namespace operations on remote builders and their builds. Reads need namespace.read on namespace/builders, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace builders [COMMAND]

It also takes the connection options.

oo namespace builders list-builds

List builds

oo namespace builders list-builds [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace builders get-build-record

Get build record

oo namespace builders get-build-record [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace builders get-builder-usage

Get builder usage

oo namespace builders get-builder-usage [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace builders get-builder-configuration

Get builder configuration

oo namespace builders get-builder-configuration [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace builders ensure-build-instance

Ensure build instance (write)

oo namespace builders ensure-build-instance [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace artifacts

Advanced Namespace operations on stored artifacts. Reads need namespace.read on namespace/artifacts, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace artifacts [COMMAND]

It also takes the connection options.

oo namespace artifacts list-artifacts

List artifacts

oo namespace artifacts list-artifacts [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace artifacts list-namespaces

List namespaces

oo namespace artifacts list-namespaces [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace artifacts resolve-artifact

Resolve artifact

oo namespace artifacts resolve-artifact [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace artifacts expire-artifact

Expire artifact (write)

oo namespace artifacts expire-artifact [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace artifacts extend-artifact

Extend artifact (write)

oo namespace artifacts extend-artifact [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace audit

Advanced Namespace operations on the Sunport's audit log. Reads need namespace.read on namespace/audit, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace audit [COMMAND]

It also takes the connection options.

oo namespace audit list-entries

List entries

oo namespace audit list-entries [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace usage

Advanced Namespace operations on usage and concurrency. Reads need namespace.read on namespace/usage, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace usage [COMMAND]

It also takes the connection options.

oo namespace usage get-usage

Get usage

oo namespace usage get-usage [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace usage get-volume-usage

Get volume usage

oo namespace usage get-volume-usage [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace usage get-artifact-usage

Get artifact usage

oo namespace usage get-artifact-usage [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace usage get-usage-time-series

Get usage time series

oo namespace usage get-usage-time-series [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace usage get-concurrency

Get concurrency

oo namespace usage get-concurrency [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace tests

Advanced Namespace operations on test runs, their results and logs. Reads need namespace.read on namespace/tests, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace tests [COMMAND]

It also takes the connection options.

oo namespace tests get-test-run

Get test run

oo namespace tests get-test-run [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace tests list-test-runs

List test runs

oo namespace tests list-test-runs [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace tests list-test-results

List test results

oo namespace tests list-test-results [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace tests stream-test-logs

Stream test logs

oo namespace tests stream-test-logs [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace vault

Advanced Namespace operations on vault secrets, metadata only. Reads need namespace.read on namespace/vault, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace vault [COMMAND]

It also takes the connection options.

oo namespace vault list-objects

List objects

oo namespace vault list-objects [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace vault describe-object

Describe object

oo namespace vault describe-object [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace vault create-object

Create object (write)

oo namespace vault create-object [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace vault update-object

Update object (write)

oo namespace vault update-object [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace vault delete-object

Delete object (write)

oo namespace vault delete-object [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object
--operation-id UUIDnorepeat a write whose outcome is unknown under its operationId

It also takes the connection options.

oo namespace observability

Advanced Namespace operations on Sunport logs, egress and metrics. Reads need namespace.read on namespace/observability, writes namespace.manage. oo api route shows each operation's request fields.

oo namespace observability [COMMAND]

It also takes the connection options.

oo namespace observability fetch-instance-logs

Fetch instance logs

oo namespace observability fetch-instance-logs [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace observability stream-instance-logs

Stream instance logs

oo namespace observability stream-instance-logs [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace observability fetch-instance-egress

Fetch instance egress

oo namespace observability fetch-instance-egress [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

oo namespace observability get-instance-metrics

Get instance metrics

oo namespace observability get-instance-metrics [options] [key=value ...]
ArgumentRequiredDefaultChoicesDescription
--connection CONNECTION_IDyesconnection ID from oo namespace connection list
key=valuenoa request field; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe request as a JSON object

It also takes the connection options.

On this page

oo namespace connectionoo namespace connection listoo namespace connection showoo namespace connection connectoo namespace connection replace-tokenoo namespace connection disconnectoo namespace consoleoo namespace imagesoo namespace images list-imagesoo namespace images inspect-imageoo namespace images describe-imageoo namespace images wire-imageoo namespace images optimize-imageoo namespace images expire-imageoo namespace templatesoo namespace templates list-templatesoo namespace templates fetch-templateoo namespace templates create-templateoo namespace templates update-templateoo namespace templates expire-templateoo namespace featuresoo namespace features list-composable-featuresoo namespace features register-composable-featureoo namespace features remove-composable-featureoo namespace defaultsoo namespace defaults fetch-defaultsoo namespace defaults update-defaultsoo namespace integrationsoo namespace integrations create-repositoryoo namespace egressoo namespace egress get-egress-policyoo namespace egress list-egress-policiesoo namespace egress create-egress-policyoo namespace egress update-egress-policyoo namespace registryoo namespace registry list-repositoriesoo namespace registry list-imagesoo namespace registry list-tagsoo namespace registry list-tag-versionsoo namespace registry get-imageoo namespace registry list-shared-imagesoo namespace registry get-default-policyoo namespace registry get-repository-policyoo namespace registry share-imageoo namespace registry unshare-imageoo namespace registry update-image-lifetimeoo namespace registry update-default-policyoo namespace registry update-repository-policyoo namespace storageoo namespace storage get-cache-volumeoo namespace storage list-cache-volumesoo namespace storage get-volume-tag-summaryoo namespace storage list-volume-tag-summariesoo namespace storage list-persistent-volumesoo namespace storage describe-persistent-volumeoo namespace storage list-persistent-volume-snapshotsoo namespace storage destroy-cache-volumeoo namespace storage destroy-persistent-volumesoo namespace storage destroy-persistent-volume-snapshotoo namespace cachesoo namespace caches get-bazel-cacheoo namespace caches gradle-get-access-policyoo namespace caches http-get-access-policyoo namespace caches ensure-bazel-cacheoo namespace caches gradle-ensure-gradle-cacheoo namespace caches http-ensure-http-cacheoo namespace buildersoo namespace builders list-buildsoo namespace builders get-build-recordoo namespace builders get-builder-usageoo namespace builders get-builder-configurationoo namespace builders ensure-build-instanceoo namespace artifactsoo namespace artifacts list-artifactsoo namespace artifacts list-namespacesoo namespace artifacts resolve-artifactoo namespace artifacts expire-artifactoo namespace artifacts extend-artifactoo namespace auditoo namespace audit list-entriesoo namespace usageoo namespace usage get-usageoo namespace usage get-volume-usageoo namespace usage get-artifact-usageoo namespace usage get-usage-time-seriesoo namespace usage get-concurrencyoo namespace testsoo namespace tests get-test-runoo namespace tests list-test-runsoo namespace tests list-test-resultsoo namespace tests stream-test-logsoo namespace vaultoo namespace vault list-objectsoo namespace vault describe-objectoo namespace vault create-objectoo namespace vault update-objectoo namespace vault delete-objectoo namespace observabilityoo namespace observability fetch-instance-logsoo namespace observability stream-instance-logsoo namespace observability fetch-instance-egressoo namespace observability get-instance-metrics