Téléchargement d’un objet à partir d’un compartiment de répertoires

Les exemples de code suivants montrent comment lire (télécharger) les données d’un objet dans un compartiment de répertoires Amazon S3 à l’aide de l’opération d’API GetObject.

En utilisant le AWS SDKs

SDK for Java 2.x

Les exemples de code suivants montrent comment lire les données à partir d’un objet dans un compartiment de répertoires à l’aide du kit AWS SDK for Java 2.x.

public static void getObject(S3Client s3Client, String bucketName, String objectKey) {
     try {
         GetObjectRequest objectRequest = GetObjectRequest
            .builder()
            .key(objectKey)
            .bucket(bucketName)
            .build();
            
         ResponseBytes GetObjectResponse objectBytes = s3Client.getObjectAsBytes(objectRequest);
         byte[] data = objectBytes.asByteArray();
         
         //Print object contents to console
         String s = new String(data, StandardCharsets.UTF_8);
         System.out.println(s);
    }
    
    catch (S3Exception e) {
        System.err.println(e.awsErrorDetails().errorMessage());
        System.exit(1);
    }
}

SDK for Python

Les exemples de code suivants montrent comment lire les données à partir d’un objet dans un compartiment de répertoires à l’aide du kit AWS SDK pour Python (Boto3).

import boto3
from botocore.exceptions import ClientError
from botocore.response import StreamingBody

def get_object(s3_client: boto3.client, bucket_name: str, key_name: str) -> StreamingBody:
    """
    Gets the object.
    :param s3_client:
    :param bucket_name: The bucket that contains the object. 
    :param key_name: The key of the object to be downloaded.
    :return: The object data in bytes.
    """
    try:
        response = s3_client.get_object(Bucket=bucket_name, Key=key_name)
        body = response['Body'].read()
        print(f"Got object '{key_name}' from bucket '{bucket_name}'.")
    except ClientError:
        print(f"Couldn't get object '{key_name}' from bucket '{bucket_name}'.")
        raise
    else:
        return body
        
def main():
    s3_client = boto3.client('s3')
    resp = get_object(s3_client, 'doc-example-bucket--use1-az4--x-s3', 'sample.txt')
    print(resp)
    
if __name__ == "__main__":
     main()

En utilisant le AWS SDKs

SDK for Java 2.x

Les exemples de code suivants montrent comment lire les données à partir d’un objet dans un compartiment de répertoires à l’aide du kit AWS SDK for Java 2.x.

public static void getObject(S3Client s3Client, String bucketName, String objectKey) {
     try {
         GetObjectRequest objectRequest = GetObjectRequest
            .builder()
            .key(objectKey)
            .bucket(bucketName)
            .build();
            
         ResponseBytes GetObjectResponse objectBytes = s3Client.getObjectAsBytes(objectRequest);
         byte[] data = objectBytes.asByteArray();
         
         //Print object contents to console
         String s = new String(data, StandardCharsets.UTF_8);
         System.out.println(s);
    }
    
    catch (S3Exception e) {
        System.err.println(e.awsErrorDetails().errorMessage());
        System.exit(1);
    }
}

SDK for Python

Les exemples de code suivants montrent comment lire les données à partir d’un objet dans un compartiment de répertoires à l’aide du kit AWS SDK pour Python (Boto3).

import boto3
from botocore.exceptions import ClientError
from botocore.response import StreamingBody

def get_object(s3_client: boto3.client, bucket_name: str, key_name: str) -> StreamingBody:
    """
    Gets the object.
    :param s3_client:
    :param bucket_name: The bucket that contains the object. 
    :param key_name: The key of the object to be downloaded.
    :return: The object data in bytes.
    """
    try:
        response = s3_client.get_object(Bucket=bucket_name, Key=key_name)
        body = response['Body'].read()
        print(f"Got object '{key_name}' from bucket '{bucket_name}'.")
    except ClientError:
        print(f"Couldn't get object '{key_name}' from bucket '{bucket_name}'.")
        raise
    else:
        return body
        
def main():
    s3_client = boto3.client('s3')
    resp = get_object(s3_client, 'doc-example-bucket--use1-az4--x-s3', 'sample.txt')
    print(resp)
    
if __name__ == "__main__":
     main()

À l'aide du AWS CLI

L’exemple de commande get-object suivant montre comment utiliser l’interface AWS CLI pour télécharger un objet depuis Amazon S3. Cette commande récupère l’objet KEY_NAME à partir du compartiment de répertoires bucket-base-name--zone-id--x-s3. L’objet sera téléchargé dans un fichier nommé LOCAL_FILE_NAME. Pour exécuter cette commande, remplacez user input placeholders par vos propres informations.

aws s3api get-object --bucket bucket-base-name--zone-id--x-s3 --key KEY_NAME LOCAL_FILE_NAME

Pour plus d’informations, consultez .get-objectdans la référence de AWS CLI commande.

À l'aide du AWS CLI

L’exemple de commande get-object suivant montre comment utiliser l’interface AWS CLI pour télécharger un objet depuis Amazon S3. Cette commande récupère l’objet KEY_NAME à partir du compartiment de répertoires bucket-base-name--zone-id--x-s3. L’objet sera téléchargé dans un fichier nommé LOCAL_FILE_NAME. Pour exécuter cette commande, remplacez user input placeholders par vos propres informations.

aws s3api get-object --bucket bucket-base-name--zone-id--x-s3 --key KEY_NAME LOCAL_FILE_NAME

Pour plus d’informations, consultez .get-objectdans la référence de AWS CLI commande.