¿Qué es la réplica?

La replicación copia los objetos recién creados y las actualizaciones de objetos de un bucket de origen a un bucket de destino.

• Sólo se copian en el bucket de destino los objetos nuevos o las versiones nuevas de los objetos existentes (creados después de añadir la regla de replicación al bucket). Los objetos existentes pueden replicarse copiándolos sobre sí mismos, creando una nueva versión replicada.
• Los metadatos del objeto de origen se aplican al objeto replicado.
• La replicación bidireccional entre dos buckets requiere que las reglas estén activas en ambos buckets.
• Se pueden utilizar filtros (compuestos por prefijos y/o etiquetas) para que la regla de replicación sólo se aplique a un subconjunto de objetos. Se pueden definir múltiples reglas en una misma política y estas reglas pueden especificar diferentes destinos. De este modo, distintos objetos de un mismo bucket pueden replicarse a distintos destinos.

¿Por qué utilizar la replicación?

• Mantenga una copia de los datos en un bucket en una ubicación geográfica diferente.
• Cumpla la normativa sobre soberanía de datos definiendo reglas de replicación que almacenen réplicas sólo en las ubicaciones permitidas.
• Mantenga sincronizados los datos de producción y de prueba, ya que la replicación conserva los metadatos de los objetos, como la hora de la última modificación, el ID de versión, etc.
• Gestione la clase de almacenamiento y las políticas de ciclo de vida de los objetos replicados independientemente del origen, definiendo una clase de almacenamiento y/o reglas de ciclo de vida diferentes para el bucket de destino. Del mismo modo, puede almacenar réplicas en un bucket en una instancia de servicio independiente o incluso en una cuenta de IBM Cloud, y también controlar de forma independiente el acceso a las réplicas.

Introducción a la replicación

Para empezar, hay que cumplir algunos requisitos previos:

• Establezca el rol de plataforma Writer o Manager en el bucket de origen, o un rol personalizado con las acciones de replicación apropiadas (como cloud-object-storage.bucket.put_replication) asignadas.
• No es necesario tener acceso al bucket de destino, pero sí tener suficientes roles de plataforma para crear nuevas políticas IAM que permitan al bucket de origen escribir en el bucket de destino.
• El bucket de destino no debe tener activado un cortafuegos de bucket heredado, pero puede utilizar restricciones basadas en el contexto.
• Los objetos cifrados mediante SSE-C no pueden replicarse, aunque el cifrado gestionado(SSE-KMS)como Key Protect es totalmente compatible con la replicación.
• Los objetos en estado archivado no pueden replicarse.
• Si los buckets de origen y destino se encuentran en diferentes cuentas de IBM, asegúrese de crear los buckets en cada cuenta.
• Active el control de versiones en los buckets de origen y destino.

Como el versionado es un requisito para la replicación, es imposible replicar objetos en buckets configurados con una política Inmutable Object Storage.

Utilización de una cuenta IBM

Para replicar objetos entre buckets de la misma cuenta IBM, haga lo siguiente:

1. Tras navegar hasta el bucket de origen elegido, haga clic en la pestaña Configuración.
2. Busque Replicación de cubos y haga clic en el botón Configurar replicación.
3. Selecciona « Fuente de replicación » y haz clic en « Siguiente ».
4. Seleccione la instancia y el cubo en los menús desplegables. Alternativamente, cambie el botón de opción a No y pegue el CRN del cubo de destino.
5. Haga clic en el botón Comprobar permisos.

Ahora, tendrá que conceder al bucket de origen Writer permisos sobre el bucket de destino. Hay varias formas de hacerlo, pero la más sencilla es utilizar IBM Cloud Shell y la CLI IBM Cloud.

1. Abrir IBM Cloud Shell en una nueva ventana o pestaña.
2. Copie el comando CLI IBM Cloud que aparece en la consola Object storage y péguelo en el nuevo shell.
3. Vuelva a la ventana o pestaña de configuración del cubo y haga clic de nuevo en el botón Comprobar permisos.

Ahora creará una regla de replicación.

1. Asegúrese de que el botón de opción de estado de la regla está activado.
2. Asigne a la regla un nombre y una prioridad, así como los filtros de prefijo o etiqueta que limitarán los objetos sujetos a la regla de replicación.
3. Pulse Listo.

Utilización de diferentes cuentas IBM

Para replicar objetos entre buckets de diferentes cuentas de IBM, haga lo siguiente:

1. Configure una política IAM en la cuenta IBM de destino. Para obtener información sobre la creación de una política IAM, consulte Qué son las políticas IAM y quién puede asignarlas.
2. Busque el ID de cuenta y el ID de instancia de servicio en formato CRN en la página Configuración de cubos.
3. A través de la interfaz de usuario IBM Cloud de la cuenta de destino, haga clic en Manage>Access**(IAM)**.
4. Haga clic en Autenticación en el panel izquierdo.
5. Haz clic en «Crear» para crear una nueva política de IAM.
6. Conceder una configuración de página de autorización de servicio. Esta es la página a la que llegará después de crear una nueva política IAM.
7. Seleccione Otra cuenta e indique el ID de cuenta de la cuenta de origen.
8. Proporcionar acceso al servicio como Cloud Object Storage.
9. En Alcance del acceso, seleccione Recursos específicos.
10. Seleccione Instancia de servicio de origen e introduzca el ID de instancia de servicio para el bucket de origen.
11. En Destino, seleccione Cloud Object Storage para el acceso al cubo de origen.
12. En Ámbito de destino, seleccione Recursos específicos>**Instancia de servicio.
13. Seleccione el ID de instancia de servicio de la cuenta de destino en el menú desplegable.
14. Seleccione el rol Escritor de objetos o Escritor según sea necesario.

El rol Object writer es suficiente para habilitar la replicación.

Terminología

Cubo de origen: El bucket para el que se configura una política de replicación. Es la fuente de objetos replicados.

Bucket de destino: El bucket que se define como destino en la política de replicación del bucket de origen. Es el destino de los objetos replicados. También se denomina cubo "de destino".

Réplica: El nuevo objeto creado en un bucket de destino debido a una solicitud realizada a un bucket de origen.

¿Qué se replica?

Los nuevos objetos creados a través de CopyObject, PutObject, o CompleteMultipartUpload se replicarán desde el bucket de origen al bucket de destino. Los objetos replicados heredarán los siguientes campos de metadatos del objeto de origen: Etag, Last Modified Time, Version ID, user-attributes, y Tags.

Los marcadores de borrado se replicarán si así lo configura la política de replicación.

Las actualizaciones de las etiquetas de una versión se replicarán desde el bucket de origen al bucket de destino.

Los siguientes no se replican:

• Acciones iniciadas por eventos del ciclo de vida
• Objetos escritos directamente en el archivo
• Objetos restaurados desde un nivel de archivo
• Objetos encriptados mediante SSE-C
• ACL de objetos

El uso de la replicación para la continuidad del negocio y la recuperación ante desastres

La replicación puede utilizarse para garantizar la continuidad del servicio en caso de interrupción:

• Asegúrese de que los buckets de origen y destino se encuentran en ubicaciones diferentes.
• Compruebe que las últimas versiones de los objetos están sincronizadas entre ambos buckets. Una herramienta como Rclone (el comando rclone check ) puede ser útil para comprobar la sincronicidad desde la línea de comando.
• En caso de interrupción, el tráfico de una aplicación puede redirigirse al bucket de destino.

Coherencia e integridad de los datos

Mientras que IBM Cloud Object Storage proporciona una fuerte consistencia para todas las operaciones de IO de datos, la configuración de los cubos es finalmente consistente. Tras activar las reglas de replicación por primera vez en un bucket, la configuración puede tardar unos instantes en propagarse por el sistema y los nuevos objetos pueden empezar a replicarse.

Gestión de errores

Los fallos de replicación pueden deberse a numerosas causas, entre las que se incluyen (sin limitarse a ellas) configuraciones incorrectas de los buckets, interrupciones del servicio, interacciones de los usuarios con el bucket de destino, etc.

COS cuenta con una capacidad de recuperación integrada para gestionar los fallos de replicación. Cuando se produce un fallo, COS puede volver a intentarlo durante un máximo de 30 días. La frecuencia de los reintentos puede variar en función de la naturaleza del fallo. Por ejemplo, los fallos provocados por errores de E/S poco frecuentes pueden reintentarse en el plazo de unas horas, mientras que los fallos debidos a configuraciones erróneas de los buckets por parte de los usuarios pueden reintentarse una vez al día. Si un error no se resuelve en un plazo de 30 días, el sistema deja de reintentarlo automáticamente. Todos los fallos a largo plazo se pueden consultar a través de ListBucketReplicationFailures.

Si deseas volver a intentar los errores «caducados» que llevan más de 30 días sin resolverse, puedes activar un nuevo intento utilizando la PutBucketReplicationFailureReattempt.

Acciones de IAM

Hay nuevas acciones IAM asociadas a la replicación.

Sucesos de Activity Tracker

La réplica genera sucesos adicionales.

Para sucesos de cloud-object-storage.bucket-replication.create, los campos siguientes proporcionan información adicional:

Cuando la réplica está activa, las operaciones en objetos pueden generar la siguiente información adicional:

Puede rastrear un objeto desde el momento en que se graba en el origen hasta que se graba en el destino. Busque el ID de solicitud asociado con la grabación del objeto y aparecerán tres sucesos:

• El PUT original.
• La solicitud de sincronización del origen.
• La solicitud PUT en el destino.

Cualquiera de estos tres que faltan indica una anomalía.

Uso y contabilidad

Todas las réplicas son objetos y contribuyen al uso igual que cualquier otro dato. La réplica correcta da como resultado solicitudes PUT, GET y HEAD facturables, aunque no se facturará el ancho de banda consumido en el proceso de réplica.

La replicación genera métricas adicionales para su uso con IBM Cloud Monitoring:

• ibm_cos_bucket_replication_sync_requests_issued
• ibm_cos_bucket_replication_sync_requests_received

Interacciones

Replicación de objetos existentes

Una regla de réplica sólo puede actuar sobre objetos que se escriben después de que la regla se haya configurado y aplicado a un grupo. Si hay objetos existentes en un grupo que se deben replicar, es necesario que los procesos de réplica sean conscientes de la existencia de los objetos. Esto se puede llevar a cabo fácilmente utilizando la operación PUT copy para copiar objetos en sí mismos.

Este proceso restablecerá algunos metadatos de objeto, incluidas las indicaciones de fecha y hora de creación. Esto afectará a las políticas de ciclo de vida y a cualquier otro servicio que utilice indicaciones de fecha y hora de creación o modificación (como las redes de entrega de contenido). Asegúrese de que las interrupciones que puedan surgir al restablecer los metadatos de objeto se tratan adecuadamente.

El proceso implica:

1. Creación de una lista de todos los objetos de un grupo que deben estar sujetos a reglas de réplica,
2. Iterando sobre esa lista, realizando una operación PUT copy en cada objeto con el origen siendo idéntico al destino de la solicitud.

Este ejemplo sólo replicará la nueva versión del objeto creado por la solicitud PUT copy. Para poder replicar todas las versiones del objeto, sería necesario copiar también cada versión individual.

El ejemplo siguiente está escrito en Python, pero el algoritmo se puede aplicar en cualquier lenguaje de programación o contexto.

import os
import sys
import ibm_boto3
from ibm_botocore.config import Config

# Create client connection
cos = ibm_boto3.client("s3",
                       ibm_api_key_id=os.environ.get('IBMCLOUD_API_KEY'),
                       ibm_service_instance_id=os.environ['SERVICE_INSTANCE_ID'],
                       config=Config(signature_version="oauth"),
                       endpoint_url=os.environ['US_GEO']
                       )

# Define the bucket with existing objects for replication
bucket = os.environ['BUCKET']

def copy_in_place(BUCKET_NAME):
    print("Priming existing objects in " + bucket + " for replication...")

    paginator = cos.get_paginator('list_objects_v2')
    pages = paginator.paginate(Bucket=bucket)

    for page in pages:
        for obj in page['Contents']:
            key = obj['Key']
            print("  * Copying " + key + " in place...")
            try:
                headers = cos.head_object(
                    Bucket=bucket,
                    Key=key
                    )
                md = headers["Metadata"]
                cos.copy_object(
                    CopySource={
                        'Bucket': bucket,
                        'Key': key
                        },
                    Bucket=bucket,
                    Key=key,
                    TaggingDirective='COPY',
                    MetadataDirective='REPLACE',
                    Metadata=md
                    )
                print("    Success!")
            except Exception as e:
                print("    Unable to copy object: {0}".format(e))
    print("Existing objects in " + bucket + " are now subject to replication rules.")

copy_in_place(bucket)

Ejemplos de API REST

Los ejemplos siguientes se muestran utilizando cURL para facilitar su uso. Las variables de entorno se utilizan para representar elementos específicos del usuario como, por ejemplo, $BUCKET, $TOKEN y $REGION. Tenga en cuenta que $REGION también incluiría cualquier especificación de tipo de red, por lo que el envío de una solicitud a un grupo en us-south utilizando la red privada requeriría establecer la variable en private.us-south.

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: exuBoz2kFBykNwqu64JZuA==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Rule>
              <ID>SimpleReplication</ID>
              <Priority>1</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Disabled</Status>
              </DeleteMarkerReplication>
              <Filter/>
              <Destination>
                <Bucket>$DESTINATION_CRN</Bucket>
              </Destination>
          	</Rule>
          </ReplicationConfiguration>'

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: exuBoz2kFBykNwqu64JZuA==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Rule>
              <ID>ProjectA</ID>
              <Priority>10</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Prefix>project_a/</prefix>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_A</Bucket>
              </Destination>
          	</Rule>
            <Rule>
              <ID>ProjectB</ID>
              <Priority>5</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Prefix>project_b/</prefix>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_B</Bucket>
              </Destination>
          	</Rule>
            <Rule>
              <ID>AcmeCorp</ID>
              <Priority>20</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Tag>
                  <Key>Client</Key>
                  <Value>ACME</Value>
                </Tag>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_C</Bucket>
              </Destination>
          	</Rule>
          </ReplicationConfiguration>'

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN'

<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Rule>
    <ID>SimpleReplication</ID>
    <Status>ENABLED</Status>
    <DeleteMarkerReplication>
      <Status>DISABLED</Status>
    </DeleteMarkerReplication>
    <Destination>
      <Bucket>crn:v1:bluemix:public:cloud-object-storage:global:a/9978e07eXXXXXXXX66c89c428028654:ef1c725e-XXXX-4967-bcc1-734c03a2b846:bucket:replication-destination</Bucket>
    </Destination>
    <Priority>1</Priority>
    <Filter/>
  </Rule>
</ReplicationConfiguration>

curl -X "DELETE" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN'

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?ibm-replication-failures" \
     -H 'Authorization: bearer $TOKEN'

<ListReplicationFailureResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Name>example</Name>
    <FirstSyncAttemptedBefore>2025-12-15T00:00:00.000Z</FirstSyncAttemptedBefore>
    <MaxKeys>10</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <EncodingType>false</EncodingType>
    <KeyCount>2</KeyCount>
    <Contents>
        <Key>test-obj+*1765434016787</Key>
        <VersionId>00000000-0000-0000-0000-019b0c114413</VersionId>
        <SyncType>Content</SyncType>
        <FirstSyncAttempted>2025-12-11T06:20:16.787Z</FirstSyncAttempted>
        <LastSyncAttempted>2025-12-11T06:20:16.787Z</LastSyncAttempted>
        <SyncFailureCause>Versioning disabled on destination bucket</SyncFailureCause>
    </Contents>
    <Contents>
        <Key>test-obj+*1765434016786</Key>
        <VersionId>00000000-0000-0000-0000-019b0c114412</VersionId>
        <SyncType>Content</SyncType>
        <FirstSyncAttempted>2025-12-11T06:20:16.786Z</FirstSyncAttempted>
        <LastSyncAttempted>2025-12-11T06:20:16.786Z</LastSyncAttempted>
        <SyncFailureCause>Replication operation not authorized on target bucket</SyncFailureCause>
    </Contents>
</ListReplicationFailureResult>

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?ibm-replication-reattempt" \
     -H 'Authorization: bearer $TOKEN'

HTTP/1.1 204 No Content
Connection: close
...
x-ibm-replication-reattempt-scheduled-time: Fri, 12 Dec 2025 00:00:00 GMT

Ejemplos de SDK

Los ejemplos siguientes utilizan los SDK de IBM COS para Python y Node.js, aunque la implementación del mantenimiento de versiones de objetos debe ser totalmente compatible con cualquier biblioteca o herramienta S3-compatible que permita el establecimiento de puntos finales personalizados. El uso de herramientas de terceros requiere credenciales HMAC para calcular firmas de AWS V4. Para obtener más información sobre las credenciales HMAC, consulte la documentación.

#!/usr/bin/env python3

import ibm_boto3
from ibm_botocore.config import Config
from ibm_botocore.exceptions import ClientError

# Define constants
API_KEY = os.environ.get('IBMCLOUD_API_KEY')
SERVICE_INSTANCE = os.environ.get('SERVICE_INSTANCE_ID')
ENDPOINT = os.environ.get('ENDPOINT')

BUCKET = "my-replication-bucket" # The bucket that will enable replication.

# Create resource client with configuration info pulled from environment variables.
cosClient = ibm_boto3.client("s3",
                         ibm_api_key_id=API_KEY,
                         ibm_service_instance_id=SERVICE_INSTANCE,
                         config=Config(signature_version="oauth"),
                         endpoint_url=ENDPOINT
                         )

response = cosClient.put_bucket_versioning(
    Bucket=BUCKET,
    ReplicationConfiguration={
        'Rules': [
            {
                'ID': 'string',
                'Priority': 123,
                'Filter': {
                    'Prefix': 'string',
                    'Tag': {
                        'Key': 'string',
                        'Value': 'string'
                    },
                    'And': {
                        'Prefix': 'string',
                        'Tags': [
                            {
                                'Key': 'string',
                                'Value': 'string'
                            },
                        ]
                    }
                },
                'Status': 'Enabled'|'Disabled',
                'Destination': {
                    'Bucket': 'string',
                },
                'DeleteMarkerReplication': {
                    'Status': 'Enabled'|'Disabled'
                }
            },
        ]
    }
)

resp = cosClient.list_object_versions(Prefix='some-prefix', Bucket=BUCKET)

const IBM = require('ibm-cos-sdk');

var config = {
    endpoint: '<endpoint>',
    apiKeyId: '<api-key>',
    serviceInstanceId: '<resource-instance-id>',
};

var cos = new IBM.S3(config);

var params = {
  Bucket: 'STRING_VALUE', /* required */
  ReplicationConfiguration: { /* required */
    Role: 'STRING_VALUE', /* required */
    Rules: [ /* required */
      {
        Destination: { /* required */
          Bucket: 'STRING_VALUE', /* required */
        },
        Status: Enabled | Disabled, /* required */
        Filter: {
          And: {
            Prefix: 'STRING_VALUE',
            Tags: [
              {
                Key: 'STRING_VALUE', /* required */
                Value: 'STRING_VALUE' /* required */
              },
              /* more items */
            ]
          },
          Prefix: 'STRING_VALUE',
          Tag: {
            Key: 'STRING_VALUE', /* required */
            Value: 'STRING_VALUE' /* required */
          }
        },
        ID: 'STRING_VALUE',
        Prefix: 'STRING_VALUE',
        Priority: 'NUMBER_VALUE',
        }
      }
    ]
  },
  ContentMD5: 'STRING_VALUE',
};
cos.putBucketReplication(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});