yc storage s3api

Written by

Updated at November 2, 2024

[PREVIEW] An aws s3api-like interface for accessing Object Storage

Syntax:

yc storage s3api <command>

yc storage s3api get-object — Returns an object from Object Storage
yc storage s3api put-object — Puts an object and its metadata to Object Storage
yc storage s3api delete-object — Deletes an object from Object Storage
yc storage s3api copy-object — Creates a copy of an object that is already stored in Object Storage
yc storage s3api head-object — Returns object metadata from Object Storage
yc storage s3api delete-objects — Deletes objects based on a list of keys passed in a request
yc storage s3api put-object-retention — Puts retention on the object version or enables/disables a previously set lock
yc storage s3api get-object-retention — Returns settings of the retention put on an object version
yc storage s3api put-object-legal-hold — Puts or removes legal hold for an object version
yc storage s3api get-object-legal-hold — Returns the settings of the legal hold placed on the object version

Flag	Description
`--profile`	`string` Set the custom configuration file.
`--debug`	Debug logging.
`--debug-grpc`	Debug gRPC logging. Very verbose, used for debugging connection problems.
`--no-user-output`	Disable printing user intended output to stderr.
`--retry`	`int` Enable gRPC retries. By default, retries are enabled with maximum 5 attempts. Pass 0 to disable retries. Pass any negative value for infinite retries. Even infinite retries are capped with 2 minutes timeout.
`--cloud-id`	`string` Set the ID of the cloud to use.
`--folder-id`	`string` Set the ID of the folder to use.
`--folder-name`	`string` Set the name of the folder to use (will be resolved to id).
`--endpoint`	`string` Set the Cloud API endpoint (host:port).
`--token`	`string` Set the OAuth token to use.
`--impersonate-service-account-id`	`string` Set the ID of the service account to impersonate.
`--no-browser`	Disable opening browser for authentication.
`--format`	`string` Set the output format: text (default), yaml, json, json-rest.
`--jq`	`string` Query to select values from the response using jq syntax
`-h`,`--help`	Display help for the command.