mirror of
https://github.com/supabase/supabase.git
synced 2026-10-16 22:59:11 +03:00
8864e5633c
* docs: storage s3 protocol * fix: edits * docs(storage): added ownership,management,custom-roles docs * chore: fix prettier * docs: fix formatting & rephrase some bits * fix: edits * add error codes documentation * update docs * Adds blog post * Adds embeds * chore: update images * parquet video * Update thumb.png * some doc updates * Adds compat list * guide: cyberduck * doc updates * ga page data * blog updates * update image * Update 2024-04-18-s3-compatible-storage.mdx * Update supabase-contributions.png * blog update * moves cyberduck to integrations * updated multipart section blog * Update 2024-04-18-s3-compatible-storage.mdx * update blog * fix link * blog updates * update blog * docs update * update announcement banners * update * update build stage * update --------- Co-authored-by: Charis <26616127+charislam@users.noreply.github.com> Co-authored-by: Kang Ming <kang.ming1996@gmail.com> Co-authored-by: Inian <inian1234@gmail.com> Co-authored-by: Copple <10214025+kiwicopple@users.noreply.github.com> Co-authored-by: Jonathan Summers-Muir <MildTomato@users.noreply.github.com> Co-authored-by: Francesco Sansalvadore <f.sansalvadore@gmail.com> Co-authored-by: Francesco Sansalvadore <francescosansalvadore@mac.wind3.hub>
80 lines
2.3 KiB
Plaintext
80 lines
2.3 KiB
Plaintext
---
|
|
id: 'storage-management'
|
|
title: 'Copy Objects'
|
|
description: 'Learn how to copy and move objects'
|
|
subtitle: 'Learn how to copy and move objects'
|
|
sidebar_label: 'Copy / Move Objects'
|
|
---
|
|
|
|
## Copy objects
|
|
|
|
You can copy objects between buckets or within the same bucket. Currently only objects up to 5 GB can be copied using the API.
|
|
|
|
When making a copy of an object, the owner of the new object will be the user who initiated the copy operation.
|
|
|
|
### Copying objects within the same bucket
|
|
|
|
To copy an object within the same bucket, use the `copy` method.
|
|
|
|
```javascript
|
|
await supabase.storage.from('avatars').copy('public/avatar1.png', 'private/avatar2.png')
|
|
```
|
|
|
|
### Copying objects across buckets
|
|
|
|
To copy an object across buckets, use the `copy` method and specify the destination bucket.
|
|
|
|
```javascript
|
|
await supabase.storage.from('avatars').copy('public/avatar1.png', 'private/avatar2.png', {
|
|
destinationBucket: 'avatars2',
|
|
})
|
|
```
|
|
|
|
## Move objects
|
|
|
|
You can move objects between buckets or within the same bucket. Currently only objects up to 5GB can be moved using the API.
|
|
|
|
When moving an object, the owner of the new object will be the user who initiated the move operation. Once the object is moved, the original object will no longer exist.
|
|
|
|
### Moving objects within the same bucket
|
|
|
|
To move an object within the same bucket, you can use the `move` method.
|
|
|
|
```javascript
|
|
const { data, error } = await supabase.storage
|
|
.from('avatars')
|
|
.move('public/avatar1.png', 'private/avatar2.png')
|
|
```
|
|
|
|
### Moving objects across buckets
|
|
|
|
To move an object across buckets, use the `move` method and specify the destination bucket.
|
|
|
|
```javascript
|
|
await supabase.storage.from('avatars').move('public/avatar1.png', 'private/avatar2.png', {
|
|
destinationBucket: 'avatars2',
|
|
})
|
|
```
|
|
|
|
## Permissions
|
|
|
|
For a user to move and copy objects, they need `select` permission on the source object and `insert` permission on the destination object. For example:
|
|
|
|
```sql
|
|
create policy "User can select their own objects (in any buckets)"
|
|
on storage.objects
|
|
for select
|
|
to authenticated
|
|
using (
|
|
owner_id = (select auth.uid())
|
|
);
|
|
|
|
create policy "User can upload in their own folders (in any buckets)"
|
|
on storage.objects
|
|
for insert
|
|
to authenticated
|
|
with check (
|
|
(storage.folder(name))[1] = (select auth.uid())
|
|
);
|
|
```
|