CubePathDOCS

Object Storage

Create replication

post/object-storage/replications

Replicate a bucket to another CubePath bucket (in this organization, or in another one that gave you a replication grant) or to an external S3 compatible bucket over HTTPS. Versioning must be enabled. New objects are copied as they are written and, by default, the existing ones too. Both CubePath buckets are in the same storage cluster, so it is not a disaster recovery copy; replication to an external destination is billed as egress.

Autorización

Authorization
Authorization*string

Bearer YOUR_API_TOKEN con un token de API. También vale la cabecera X-API-Key: YOUR_API_TOKEN.

Cuerpo de la petición

Replicate a bucket to one destination.

application/jsonObligatorio
source_bucket_uuid*string
Rangolength ≤ 36
destination*ObjectStorageReplicationDestinationIn

Where to replicate: a CubePath bucket (bucket_uuid, plus grant_token when it belongs to another organization) or an external S3 compatible bucket (endpoint, region, bucket and keys).

Propiedades (10)
type*string
Valores"cubepath""external"
bucket_uuid?string | null

cubepath: the destination bucket

Rangolength ≤ 36
grant_token?string | null

cubepath: the grant of the destination owner (another organization)

Rangolength ≤ 64
provider?string | null

external: informative

Valores"aws""wasabi""other"
endpoint?string | null

external: public HTTPS host of the provider, optionally with :443

Rango3 ≤ length ≤ 253
region?string | null
Rango1 ≤ length ≤ 64
bucket?string | null
Rango3 ≤ length ≤ 63
path_style?string | null

external: default auto

Valores"auto""on""off"
access_key_id?string | null
Rango1 ≤ length ≤ 128
secret_access_key?string | null

Never returned

Rango1 ≤ length ≤ 256
prefix?string | null
Rango1 ≤ length ≤ 1024
tags?array<ObjectStorageReplicationTag> | null
Rangoitems ≥ 1Rangoitems ≤ 10
Propiedades (2)
key*string
Rango1 ≤ length ≤ 128
value*string
Rangolength ≤ 256
delete_marker_replication?boolean

Replicate delete markers

Por defectofalse
delete_replication?boolean

Replicate deletes of a specific version

Por defectofalse
existing_objects?boolean

Copy the objects the bucket already holds

Por defectotrue

Respuestas

Successful Response

application/json

detail*string
uuid*string
status*string