You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## Installing a configuration file for Amazon S3-compatible tools (s3cmd, rclone, and mc)
102
102
103
-
The `scw object config install` allows you to create a configuration file for the selected third party tool based on your [AWS configuration](/storage/object/api-cli/object-storage-aws-cli/).
103
+
The `scw object config install` allows you to create a configuration file for the selected third party tool based on your [Scaleway CLI configuration](/developer-tools/scaleway-cli/quickstart/).
104
104
105
105
<Messagetype="important">
106
106
Creating a new configuration file using `scw object config install` will overwrite the existing one for the specified third party tool. To update an existing configuration, [generate a preview](#previewing-an-object-storage-configuration-file-for-the-scaleway-cli) and manually edit the configuration file.
@@ -133,7 +133,7 @@ Run the following command in a terminal to install a configuration file for `s3c
133
133
```
134
134
</TabsTab>
135
135
<TabsTablabel="MinIO Client (mc)">
136
-
3.Run the following command in a terminal to install a configuration file for MinIO Client (mc):
136
+
Run the following command in a terminal to install a configuration file for MinIO Client (mc):
137
137
138
138
```
139
139
scw object config install type=mc
@@ -146,115 +146,228 @@ Run the following command in a terminal to install a configuration file for `s3c
146
146
```
147
147
</TabsTab>
148
148
</Tabs>
149
+
149
150
## Creating an Object Storage bucket
150
151
151
152
<Tabs>
152
153
<TabsTablabel="Rclone">
153
-
Run the following command in a terminal to create a bucket:
154
+
1.Run the following command in a terminal to create a bucket:
154
155
155
156
```
157
+
rclone mkdir scaleway:my-bucket
158
+
```
159
+
160
+
2. Run the following command to list your newly created bucket:
156
161
157
162
```
163
+
rclone lsd scaleway:
164
+
```
158
165
159
166
An output similar to the following displays:
167
+
```
168
+
rclone lsd scaleway:
169
+
-1 2022-06-04 14:38:03 -1 my-bucket
170
+
-1 2023-12-23 12:10:57 -1 my-new-bucket
171
+
```
172
+
</TabsTab>
173
+
<TabsTablabel="S3cmd">
174
+
Run the following command in a terminal to create a bucket:
160
175
161
176
```
177
+
s3cmd mb s3://my-bucket
178
+
```
162
179
180
+
An output similar to the following displays:
181
+
```
182
+
Bucket 's3://my-bucket/' created
163
183
```
164
184
</TabsTab>
165
-
</Tabs>
166
-
## Adding an object
167
-
168
-
<Tabs>
169
-
<TabsTablabel="Rclone">
185
+
<TabsTablabel="MinIO Client (mc)">
170
186
Run the following command in a terminal to add an object to your bucket:
171
-
172
187
```
173
-
188
+
mc mb scaleway/my-bucket
174
189
```
175
190
176
191
An output similar to the following displays:
177
192
178
193
```
194
+
Bucket created successfully `scaleway/my-bucket`.
195
+
```
196
+
</TabsTab>
197
+
</Tabs>
179
198
199
+
## Uploading an object to a bucket
200
+
201
+
<Tabs>
202
+
<TabsTablabel="Rclone">
203
+
1. In a terminal, access the folder containing the file you want to upload, then run the following command:
2. Run the command below to list the object you just downloaded:
254
+
```
255
+
ls /path/to/destination
216
256
```
217
-
218
257
An output similar to the following displays:
219
-
220
258
```
221
-
delete: 's3://your-bucket/your-object'
259
+
my-object
260
+
```
261
+
</TabsTab>
262
+
<TabsTablabel="S3cmd">
263
+
1. In a terminal, run the following command to download an object from a bucket:
264
+
```
265
+
s3cmd get s3://my-bucket/my-object /path/to/destination
266
+
```
267
+
2. Run the command below to list the object you just downloaded:
268
+
```
269
+
ls /path/to/destination
270
+
```
271
+
An output similar to the following displays:
272
+
```
273
+
my-object
274
+
```
275
+
</TabsTab>
276
+
<TabsTablabel="MinIO Client (mc)">
277
+
1. In a terminal, run the following command to download an object from a bucket:
278
+
```
279
+
mc cp scaleway/my-bucket/my-object /path/to/destination
222
280
```
281
+
2. Run the command below to list the object you just downloaded:
282
+
```
283
+
ls /path/to/destination
284
+
```
285
+
An output similar to the following displays:
286
+
```
287
+
my-object
288
+
```
289
+
</TabsTab>
290
+
</Tabs>
223
291
224
-
<Messagetype="note">
225
-
For more information about removing objects, run the following command in your terminal:
226
-
```
227
-
s3cmd --help
228
-
```
229
-
</Message>
292
+
## Removing an object from a bucket
293
+
294
+
<Tabs>
295
+
<TabsTablabel="Rclone">
296
+
1. In a terminal, run the following command to remove an object from a bucket:
297
+
```
298
+
rclone delete scaleway:my-bucket/my-object
299
+
```
300
+
2. Run the command below to make sure the object has been removed:
301
+
```
302
+
rclone ls scaleway:my-bucket
303
+
```
304
+
The object no longer appears in the output.
305
+
</TabsTab>
306
+
<TabsTablabel="S3cmd">
307
+
1. In a terminal, run the following command to remove an object from a bucket:
308
+
```
309
+
s3cmd del s3://my-bucket/my-object
310
+
```
311
+
2. Run the command below to make sure the object has been removed:
312
+
```
313
+
s3cmd ls s3://my-bucket
314
+
```
315
+
The object no longer appears in the output.
316
+
</TabsTab>
317
+
<TabsTablabel="MinIO Client (mc)">
318
+
1. In a terminal, run the following command to remove an object from a bucket:
319
+
```
320
+
mc rm scaleway/my-bucket/my-object
321
+
```
322
+
2. Run the command below to make sure the object has been removed:
323
+
```
324
+
mc ls scaleway/my-bucket
325
+
```
326
+
The object no longer appears in the output.
327
+
</TabsTab>
328
+
</Tabs>
230
329
231
330
## Deleting an Object Storage bucket
232
331
233
332
<Messagetype="important">
234
-
This action will delete every object stored inside your bucket. Your bucket name will no longer be yours, and other users will be able to use it.
333
+
This action will delete every object stored inside your bucket. The bucket name will no longer be yours, and other users will be able to use it.
235
334
</Message>
236
335
237
-
1. Run the following command in a terminal to display your buckets:
238
-
336
+
<Tabsid="delete_bucket">
337
+
<TabsTablabel="Rclone">
338
+
1. In a terminal, run the following command to delete a bucket:
339
+
```
340
+
rclone purge scaleway:my-bucket
341
+
```
342
+
2. Run the command below to make sure the bucket has been deleted:
343
+
```
344
+
rclone lsd scaleway:
345
+
```
346
+
The bucket no longer appears in the output.
347
+
</TabsTab>
348
+
<TabsTablabel="S3cmd">
349
+
1. In a terminal, run the following command to delete a bucket:
350
+
```
351
+
s3cmd rb s3://my-bucket
352
+
```
353
+
2. Run the command below to make sure the bucket has been deleted:
239
354
```
240
355
s3cmd ls
241
356
```
242
-
243
-
An output similar to the following displays:
244
-
357
+
The bucket no longer appears in the output.
358
+
</TabsTab>
359
+
<TabsTablabel="MinIO Client (mc)">
360
+
1. In a terminal, run the following command to delete a bucket:
245
361
```
246
-
2021-09-01 15:56 s3://your-bucket
362
+
mc rb scaleway/my-bucket
247
363
```
248
-
249
-
2. Run the following command in a terminal to delete a bucket:
250
-
251
-
`s3cmd rb s3://your-bucket`
252
-
253
-
An output similar to the following displays:
254
-
364
+
2. Run the command below to make sure the bucket has been deleted:
255
365
```
256
-
Bucket 's3://your-bucket/' removed
366
+
mc ls scaleway
257
367
```
368
+
The bucket no longer appears in the output.
369
+
</TabsTab>
370
+
</Tabs>
258
371
259
372
<Messagetype="tip">
260
373
For more information about the Amazon S3-compatible tools used in this documentation, refer to the official [rclone](https://rclone.org/docs/), [s3cmd](https://s3tools.org/s3cmd-howto), and [mc](https://github.com/minio/mc) documentation.
0 commit comments