Copiar, mover o renombrar un archivo

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

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Object Copy duplica un archivo con un nuevo nombre, prefijo o visibilidad, completamente en el servidor: ningún byte pasa por tu aplicación. Con move: true el origen se elimina después, y así es como renombras o mueves un archivo. Requiere el scope blob:write y un plan activo, además de blob:read sobre el archivo de origen.

La copia conserva la extensión, el tipo de contenido, la caché, la disposition y los metadatos del origen.
Una copia cuenta para tu cuota de almacenamiento; un movimiento no.

Parámetros

string

requerido

El id del archivo a copiar.

object

requerido

Dónde va la copia.

Mostrar propiedades

string

requerido

El nuevo nombre, sin extensión. Mismo patrón que en Object Post.

string

El nuevo prefijo. Omítelo para guardar la copia en la raíz.

boolean

La visibilidad de la copia. Por defecto, la del origen.

string | null

Una nueva expiración contada desde ahora (30d, 6h). null la elimina. Omítela para conservar la fecha de expiración del origen.

boolean

predeterminado:"false"

Añade un sufijo aleatorio al nuevo nombre. Las copias privadas siempre lo reciben.

boolean

predeterminado:"false"

true elimina el origen cuando la copia tiene éxito.

boolean

predeterminado:"false"

true reemplaza un archivo existente en el destino. Si no, la solicitud responde 409 OBJECT_ALREADY_EXISTS.

Límites de tasa

10 solicitudes cada 10 segundos (RATE_LIMITED, 429).

Respuesta

string

“success” si tuvo éxito, “error” si no.

object

Mostrar propiedades

string

El id del nuevo archivo.

boolean

Si el nuevo archivo es privado.

string | null

La URL pública del nuevo archivo, o null cuando es privado.

ISO 8601

Cuándo se eliminará el nuevo archivo. Solo aparece cuando expira.

number

El tamaño del archivo, en bytes.

string

El id del origen.

boolean

Si se eliminó el origen.

boolean

Si se reemplazó un archivo existente en el destino.

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
  }
}

Errores

Código	HTTP	Cuándo
`INVALID_OBJECT`	400	`source` falta, está mal formado o no es tuyo.
`INVALID_OBJECT_NAME` / `INVALID_OBJECT_PREFIX`	400	El nombre o el prefijo de destino no cumplen el patrón.
`INVALID_DESTINATION`	400	`private` o `security_hash` no es un booleano.
`INVALID_OBJECT_EXPIRE`	400	`expire` no es una duración de 1 hora a 1825 días.
`INVALID_OBJECT_SECURITY_HASH`	400	`security_hash: false` en una copia privada.
`SAME_OBJECT`	400	El destino es el origen.
`PERMISSION_DENIED`	401	La cuenta no tiene un plan activo.
`UPGRADE_REQUIRED`	403	La expiración requiere un plan superior.
`STORAGE_QUOTA_EXCEEDED`	403	La copia superaría el almacenamiento incluido.
`OBJECT_NOT_FOUND`	404	El origen no existe.
`OBJECT_ALREADY_EXISTS`	409	Existe un archivo en el destino y `overwrite` no es `true`.
`RATE_LIMITED`	429	Más de 10 solicitudes en 10 segundos.
`COPY_FAILED`	500	La copia falló. Reintenta.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	El almacenamiento no está disponible temporalmente. Reintenta.

Relacionado

SDK de 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
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Copiar, mover o renombrar un archivo

Parámetros

Límites de tasa

Respuesta

Errores

Relacionado

​Parámetros

​Límites de tasa

​Respuesta

​Errores

​Relacionado

Parámetros

Límites de tasa

Respuesta

Errores

Relacionado