Object-storage utils
Manage S3 buckets creation, deletion and updates to properties like tags, ACL and versioning.
Create an Object Storage Bucket with the S3 protocol. The namespace is shared between all S3 users, so its name must be unique.
Usage:
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 with all its content.
Usage:
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 the properties of an S3 bucket like tags, endpoint, access control, versioning, size, etc.
Usage:
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 all existing S3 buckets in the specified region
Usage:
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's properties like tags, access control and versioning.
Usage:
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 |
Configuration generation for S3 tools.
Generate a S3 tool configuration file.
Usage:
scw object config get [arg=value ...]
Args:
| Name | Description | |
|---|---|---|
| type | Required One 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 |
| 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
scw object config get region=fr-par type=s3cmd
Generate a rclone config file for default region
scw object config get type=rclone
Generate a mc (minio) config file for default region
scw object config get type=mc
Install a S3 tool configuration file to its default location.
Usage:
scw object config install [arg=value ...]
Args:
| Name | Description | |
|---|---|---|
| type | Required One 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 |
| 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
scw object config install region=fr-par type=s3cmd
Install a rclone config file for default region
scw object config install type=rclone
Install a mc (minio) config file for default region
scw object config install type=mc