Contact UsGet started
© 2024 Iron Hive LLC Belgrade

yc storage s3api copy-object

Written by
Updated at October 3, 2024

Creates a copy of an object that is already stored in Object Storage

Command Usage

Syntax:

yc storage s3api copy-object [Flags...] [Global Flags...]

Flags

Flag Description
--acl string
Sets a predefined ACL for an object.
--bucket string
[REQUIRED] The name of the destination bucket.
--cache-control string
Directives for caching data according to RFC 2616.
--content-disposition string
Name Object Storage will suggest for the object to save it as a file when downloaded. Compliant with RFC 2616.
--content-encoding string
Defines the content encoding according to RFC 2616.
--content-type string
Data type in a request.
--copy-source string
Specifies the source object for the copy operation.
--copy-source-if-match string
Copies the object if its entity tag (ETag) matches the specified tag.
--copy-source-if-none-match string
Copies the object if its entity tag (ETag) is different than the specified ETag.
--copy-source-if-modified-since timestamp
Copies the object if it has been modified since the specified time.
--copy-source-if-unmodified-since timestamp
Copies the object if it hasnt been modified since the specified time.
--expires timestamp
Response expiration date.
--grant-full-control string
Grants the access grantee the following permissions: READ, WRITE, READ_ACP, and WRITE_ACP for an object.
--grant-read string
Grants the access grantee object read permission.
--grant-read-acp string
Grants the access grantee object ACL read permission.
--grant-write-acp string
Grants the access grantee object ACL write permission.
--key string
[REQUIRED] The key of the destination object.
--metadata key=value[,key=value...]
User-defined metadata.
--metadata-directive string
Specifies whether the metadata is copied from the source object or replaced with metadata thats provided in the request.
--storage-class string
Object storage class.
--server-side-encryption string
The encryption algorithm of an uploaded object. Possible values: aws:kms.
--ssekms-key-id string
The ID of the KMS key for encrypting an uploaded object.
--object-lock-mode string
Type of retention put on the object (if the bucket is versioned and object lock is enabled in it). Possible values: GOVERNANCE and COMPLIANCE
--object-lock-retain-until-date timestamp
Date and time until which the object is retained.
--object-lock-legal-hold-status string
Type of legal hold put on the object.

Global Flags

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.
Previous
head-object
Next
delete-object