Copy page

Commands

Documentation for `scw object`

Object-storage utils

• Manage S3 buckets
  • Create an S3 bucket
  • Delete an S3 bucket
  • Get information about an S3 bucket
  • List S3 buckets
  • Update an S3 bucket
• Manage configuration files for popular S3 tools
  • Generate a S3 tool configuration file
  • Install a S3 tool configuration file to its default location

Manage S3 buckets

Manage S3 buckets creation, deletion and updates to properties like tags, ACL and versioning.

Create an S3 bucket

Create an Object Storage Bucket with the S3 protocol. The namespace is shared between all S3 users, so its name must be unique.

Usage:

Code
scw object bucket create <name ...> [arg=value ...]

Args:

Name		Description
name	Required	The unique name of the bucket
tags.{index}		List of tags to set on the bucket
enable-versioning	Default: false	Whether or not objects in the bucket should have multiple versions
acl	Default: private	The permissions given to users (grantees) to read or write objects
region	Default: fr-par	Region to target. If none is passed will use default region from the config

Delete an S3 bucket

Delete an S3 bucket with all its content.

Usage:

Code
scw object bucket delete <name ...> [arg=value ...]

Args:

Name		Description
name	Required	The unique name of the bucket
region	Default: fr-par	Region to target. If none is passed will use default region from the config

Get information about an S3 bucket

Get the properties of an S3 bucket like tags, endpoint, access control, versioning, size, etc.

Usage:

Code
scw object bucket get <name ...> [arg=value ...]

Args:

Name		Description
name	Required	The unique name of the bucket
with-size	Default: false	Whether to return the total size of the bucket and the number of objects. This operation can take long for large buckets.
region	Default: fr-par	Region to target. If none is passed will use default region from the config

List S3 buckets

List all existing S3 buckets in the specified region

Usage:

Code
scw object bucket list [arg=value ...]

Args:

Name		Description
region	Default: fr-par	Region to target. If none is passed will use default region from the config

Update an S3 bucket

Update an S3 bucket's properties like tags, access control and versioning.

Usage:

Code
scw object bucket update <name ...> [arg=value ...]

Args:

Name		Description
name	Required	The unique name of the bucket
tags.{index}		List of new tags to set on the bucket
enable-versioning	Default: false	Whether or not objects in the bucket should have multiple versions
acl	Default: private	The permissions given to users (grantees) to read or write objects
region	Default: fr-par	Region to target. If none is passed will use default region from the config

Manage configuration files for popular S3 tools

Configuration generation for S3 tools.

Generate a S3 tool configuration file

Generate a S3 tool configuration file.

Usage:

Code
scw object config get [arg=value ...]

Args:

Name		Description
type	RequiredOne of: rclone, s3cmd, mc	Type of S3 tool you want to generate a config for
name	Default: scaleway	Name of the s3 remote you want to generate
project-id		Scaleway project ID to use with IAM Access Key syntax
region	Default: fr-parOne of: fr-par, nl-ams	Region to target. If none is passed will use default region from the config

Examples:

Generate a s3cmd config file for Paris region

Code
scw object config get region=fr-par type=s3cmd

Generate a rclone config file for default region

Code
scw object config get type=rclone

Generate a mc (minio) config file for default region

Code
scw object config get type=mc

Install a S3 tool configuration file to its default location

Install a S3 tool configuration file to its default location.

Usage:

Code
scw object config install [arg=value ...]

Args:

Name		Description
type	RequiredOne of: rclone, s3cmd, mc	Type of S3 tool you want to generate a config for
name	Default: scaleway	Name of the s3 remote you want to generate
project-id		Scaleway project ID to use with IAM Access Key syntax
region	Default: fr-parOne of: fr-par, nl-ams	Region to target. If none is passed will use default region from the config

Examples:

Install a s3cmd config file for Paris region

Code
scw object config install region=fr-par type=s3cmd

Install a rclone config file for default region

Code
scw object config install type=rclone

Install a mc (minio) config file for default region

Code
scw object config install type=mc