Copia, sposta o rinomina un file

POST

objects

copy

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/copy' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "source": "pub/3155597145698959364/uploads/IMG_2041.png",
    "destination": { "name": "cover", "prefix": "posts/launch" },
    "move": true
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/copy', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    source: 'pub/3155597145698959364/uploads/IMG_2041.png',
    destination: { name: 'cover', prefix: 'posts/launch' },
    move: true,
  }),
});

{
  "status": "success",
  "response": {
    "id": "pub/3155597145698959364/posts/launch/cover.png",
    "private": false,
    "url": "https://blob.squarecloud.dev/pub/3155597145698959364/posts/launch/cover.png",
    "size": 416230,
    "source": "pub/3155597145698959364/uploads/IMG_2041.png",
    "moved": true,
    "replaced": false
  }
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Object Copy duplica un file con un nuovo nome, prefisso o visibilità, interamente sul server: nessun byte passa per la tua applicazione. Con move: true l’origine viene rimossa in seguito, ed è così che rinomini o sposti un file. Richiede lo scope blob:write e un piano attivo, più blob:read sul file di origine.

La copia mantiene estensione, content type, cache, disposition e metadati dell’origine.
Una copia conta nella tua quota di storage; uno spostamento no.

Parametri

string

obbligatorio

L’id del file da copiare.

object

obbligatorio

Dove va la copia.

Mostra proprietà

string

obbligatorio

Il nuovo nome, senza estensione. Stesso pattern di Object Post.

string

Il nuovo prefisso. Omettilo per archiviare la copia nella radice.

boolean

La visibilità della copia. Per impostazione predefinita è quella dell’origine.

string | null

Una nuova scadenza calcolata da adesso (30d, 6h). null la rimuove. Omettilo per mantenere la data di scadenza dell’origine.

boolean

predefinito:"false"

Aggiunge un suffisso casuale al nuovo nome. Le copie private lo ricevono sempre.

boolean

predefinito:"false"

true rimuove l’origine dopo che la copia è riuscita.

boolean

predefinito:"false"

true sostituisce un file esistente nella destinazione. Altrimenti la richiesta risponde 409 OBJECT_ALREADY_EXISTS.

Limiti di frequenza

10 richieste ogni 10 secondi (RATE_LIMITED, 429).

Risposta

string

“success” in caso di successo, “error” in caso contrario.

object

Mostra proprietà

string

L’id del nuovo file.

boolean

Se il nuovo file è privato.

string | null

L’URL pubblico del nuovo file, oppure null se è privato.

ISO 8601

Quando il nuovo file verrà eliminato. Presente solo se il file scade.

number

La dimensione del file, in byte.

string

L’id dell’origine.

boolean

Se l’origine è stata rimossa.

boolean

Se un file esistente nella destinazione è stato sostituito.

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/copy' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "source": "pub/3155597145698959364/uploads/IMG_2041.png",
    "destination": { "name": "cover", "prefix": "posts/launch" },
    "move": true
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/copy', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    source: 'pub/3155597145698959364/uploads/IMG_2041.png',
    destination: { name: 'cover', prefix: 'posts/launch' },
    move: true,
  }),
});

{
  "status": "success",
  "response": {
    "id": "pub/3155597145698959364/posts/launch/cover.png",
    "private": false,
    "url": "https://blob.squarecloud.dev/pub/3155597145698959364/posts/launch/cover.png",
    "size": 416230,
    "source": "pub/3155597145698959364/uploads/IMG_2041.png",
    "moved": true,
    "replaced": false
  }
}

Errori

Codice	HTTP	Quando
`INVALID_OBJECT`	400	`source` manca, è malformato o non ti appartiene.
`INVALID_OBJECT_NAME` / `INVALID_OBJECT_PREFIX`	400	Il nome o il prefisso di destinazione non rispetta il pattern.
`INVALID_DESTINATION`	400	`private` o `security_hash` non è un booleano.
`INVALID_OBJECT_EXPIRE`	400	`expire` non è una durata da 1 ora a 1825 giorni.
`INVALID_OBJECT_SECURITY_HASH`	400	`security_hash: false` su una copia privata.
`SAME_OBJECT`	400	La destinazione coincide con l’origine.
`PERMISSION_DENIED`	401	L’account non ha un piano attivo.
`UPGRADE_REQUIRED`	403	La scadenza richiede un piano superiore.
`STORAGE_QUOTA_EXCEEDED`	403	La copia supererebbe lo storage incluso.
`OBJECT_NOT_FOUND`	404	L’origine non esiste.
`OBJECT_ALREADY_EXISTS`	409	Esiste già un file nella destinazione e `overwrite` non è `true`.
`RATE_LIMITED`	429	Più di 10 richieste in 10 secondi.
`COPY_FAILED`	500	La copia non è riuscita. Riprova.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Lo storage è temporaneamente non disponibile. Riprova.

Vedi anche

SDK Blob: blob.copy(), blob.move()

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/copy' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "source": "pub/3155597145698959364/uploads/IMG_2041.png",
    "destination": { "name": "cover", "prefix": "posts/launch" },
    "move": true
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/copy', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    source: 'pub/3155597145698959364/uploads/IMG_2041.png',
    destination: { name: 'cover', prefix: 'posts/launch' },
    move: true,
  }),
});

{
  "status": "success",
  "response": {
    "id": "pub/3155597145698959364/posts/launch/cover.png",
    "private": false,
    "url": "https://blob.squarecloud.dev/pub/3155597145698959364/posts/launch/cover.png",
    "size": 416230,
    "source": "pub/3155597145698959364/uploads/IMG_2041.png",
    "moved": true,
    "replaced": false
  }
}

Primi passi

Oggetti

Upload a blocchi

Account

Link di condivisione

S3

Copia, sposta o rinomina un file

Parametri

Limiti di frequenza

Risposta

Errori

Vedi anche

​Parametri

​Limiti di frequenza

​Risposta

​Errori

​Vedi anche

Parametri

Limiti di frequenza

Risposta

Errori

Vedi anche