View a markdown version of this page

Uso de GetBucketReplication con un SDK de AWS o la CLI - Amazon Simple Storage Service

Uso de GetBucketReplication con un SDK de AWS o la CLI

Los siguientes ejemplos de código muestran cómo utilizar GetBucketReplication.

CLI
AWS CLI

El siguiente comando recupera la configuración de replicación de un bucket denominado amzn-s3-demo-bucket:

aws s3api get-bucket-replication --bucket amzn-s3-demo-bucket

Salida:

{
    "ReplicationConfiguration": {
        "Rules": [
            {
                "Status": "Enabled",
                "Prefix": "",
                "Destination": {
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket-backup",
                    "StorageClass": "STANDARD"
                },
                "ID": "ZmUwNzE4ZmQ4tMjVhOS00MTlkLOGI4NDkzZTIWJjNTUtYTA1"
            }
        ],
        "Role": "arn:aws:iam::123456789012:role/s3-replication-role"
    }
}

  • Para obtener información sobre la API, consulte GetBucketReplication en la Referencia de comandos de la AWS CLI.

Java
SDK para Java 2.x
nota

Hay más en GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS. 

    /**
     * Retrieves the replication details for the specified S3 bucket.
     *
     * @param s3Client           the S3 client used to interact with the S3 service
     * @param sourceBucketName   the name of the S3 bucket to retrieve the replication details for
     *
     * @throws S3Exception if there is an error retrieving the replication details
     */
    public static void getReplicationDetails(S3Client s3Client, String sourceBucketName) {
        GetBucketReplicationRequest getRequest = GetBucketReplicationRequest.builder()
            .bucket(sourceBucketName)
            .build();

        try {
            ReplicationConfiguration replicationConfig = s3Client.getBucketReplication(getRequest).replicationConfiguration();
            ReplicationRule rule = replicationConfig.rules().get(0);
            System.out.println("Retrieved destination bucket: " + rule.destination().bucket());
            System.out.println("Retrieved priority: " + rule.priority());
            System.out.println("Retrieved source-bucket replication rule status: " + rule.status());

        } catch (S3Exception e) {
            System.err.println("Failed to retrieve replication details: " + e.awsErrorDetails().errorMessage());
        }
    }

  • Para obtener información sobre la API, consulte GetBucketReplication en la Referencia de la API de AWS SDK for Java 2.x.

PowerShell
Herramientas para PowerShell V4

Ejemplo 1: Devuelve la información de configuración de replicación establecida en el bucket denominado “amzn-s3-demo-bucket'.

Get-S3BucketReplication -BucketName amzn-s3-demo-bucket

  • Para obtener información sobre la API, consulte GetBucketReplication en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: Devuelve la información de configuración de replicación establecida en el bucket denominado “amzn-s3-demo-bucket'.

Get-S3BucketReplication -BucketName amzn-s3-demo-bucket

  • Para obtener información sobre la API, consulte GetBucketReplication en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte Desarrollo con Amazon S3 mediante los SDK de AWS. En este tema también se incluye información sobre cómo empezar a utilizar el SDK y detalles sobre sus versiones anteriores.