Le but de ce tutoriel est de présenter les principales opérations possibles avec Outscale Object Storage (OOS) par le biais de AWS CLI.

Ces opérations ne sont pas présentées sous leurs formes exhaustives. Pour en savoir plus, vous pouvez vous référer aux procédures complètes liées.

Pour en savoir plus sur les commandes d'AWS CLI, voir les documentations s3api et s3 d'AWS.

Avant de commencer

  • Installez et configurez AWS CLI et définissez votre profil. Pour en savoir plus, voir Utiliser et configurer AWS CLI.
  • Les requêtes présentées dans ce guide requièrent les attributs suivants :

    • profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d'AWS CLI.
    • endpoint : Le endpoint correspondant au service (dans ce cas oos) et à la Région auxquels vous voulez envoyer la requête.



Créer un bucket

  • Pour créer un bucket, utilisez la commande create-bucket suivant cette syntaxe :

    Exemple de requête
    $ aws s3api create-bucket \
        --profile YOUR_PROFILE \
        --bucket BUCKET \
        --endpoint https://oos.<REGION>.outscale.com

Cette commande contient l'attribut suivant que vous devez spécifier :

  • bucket : Le nom que vous voulez donner à votre bucket, selon les règles de nommage correspondantes.

    Pour rappel, le nom d'un bucket doit :

    • Être unique pour toute la Région
    • Contenir entre 3 et 63 caractères
    • Contenir uniquement des minuscules, chiffres et tirets (-)
    • Commencer par un caractère alphanumérique

Le bucket est créé.

Pour en savoir plus, voir la procédure complète Créer un bucket, ou la documentation create-bucket d'AWS.

Uploader un objet dans un bucket

  • Pour uploader un objet local dans un bucket, utilisez la commande put-object suivant cette syntaxe :

    Exemple de requête
    $ aws s3api put-object \
        --profile YOUR_PROFILE \
        --bucket BUCKET \
        --key OBJECT \
        --body usr/bin/OBJECT \
        --endpoint https://oos.<REGION>.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • bucket : Le nom que vous voulez donner à votre bucket, selon les règles de nommage correspondantes.
  • key : Le nom que vous voulez donner à l'objet dans le bucket.

  • body : Le chemin d'accès vers l'objet sur votre machine.

L'objet est uploadé sur le bucket.

Pour en savoir plus sur la procédure complète, voir Uploader un objet dans un bucket, ou la documentation put-object d'AWS.

Configurer l'ACL d'un bucket

  • Pour configurer l'ACL d'un bucket, utilisez la commande put-bucket-acl suivant cette syntaxe :

    Exemple de requête
    $ aws s3api put-bucket-acl \
        --profile YOUR_PROFILE \
        --bucket BUCKET \
        --grant-read emailaddress=email@domain.com \
        --endpoint https://oos.<REGION>.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • bucket : Le nom que vous voulez donner à votre bucket, selon les règles de nommage correspondantes.

  • grant-read emailaddress= : L'adresse email du compte Cloud auquel vous accordez la permission read.

L'ACL est configurée pour le bucket.

Pour en savoir plus, voir la procédure complète Configurer l'ACL d'un bucket, ou la documentation put-bucket-acl d'AWS.

Configurer l'ACL d'un objet

  • Pour configurer l'ACL d'un objet, utilisez la commande put-object-acl suivant cette syntaxe :

    Exemple de requête
    $ aws s3api put-object-acl \
        --profile YOUR_PROFILE \
        --bucket BUCKET \
        --key OBJECT \
        --grant-read emailaddress=email@domain.com \
        --endpoint https://oos.<REGION>.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • bucket : Le nom que vous voulez donner à votre bucket, selon les règles de nommage correspondantes.

  • key Le nom de l'objet dans le bucket.
  • grant-read emailaddress= : L'adresse email du compte Cloud auquel vous accordez la permission read.

L'ACL est configurée pour l'objet.

Pour en savoir plus, voir la procédure complète Configurer l'ACL d'un objet, ou la documentation put-object-acl d'AWS.

Configurer une URL pré-signée

  • Pour configurer une URL pré-signée, utilisez la commande presign suivant cette syntaxe :

    Exemple de requête
    $ aws s3 presign s3://BUCKET/OBJECT \
        --profile YOUR_PROFILE \
        --expires-in 3600 \
        --endpoint ENDPOINT 

Cette commande contient les attributs suivants que vous devez spécifier :

  • s3://BUCKET/OBJECT : Le chemin d'accès vers l'objet que vous voulez partager dans le bucket.

  • expires-in : Le temps restant avant que l'URL n'expire, en secondes.

Pour en savoir plus, voir la procédure complète Configurer une URL pré-signée, ou la documentation presign d'AWS.

Créer un site web

  1. Copiez un objet index.html sur votre bucket et configurez une ACL public-read :

    Exemple de requête
    $ aws s3 cp index.html s3://BUCKET/ \
       --profile YOUR_PROFILE \ 
       --acl public-read \
       --endpoint https://oos.<REGION>.outscale.com
  2. Copiez un objet error.html sur votre bucket et configurez une ACL public-read :

    Exemple de requête
    $ aws s3 cp error.html s3://BUCKET/ \
       --profile YOUR_PROFILE \
       --acl public-read \
       --endpoint https://oos.<REGION>.outscale.com 
  3. Créez un fichier website.json avec le contenu suivant :

    {
        "IndexDocument": {
            "Suffix": "index.html"
        },
        "ErrorDocument": {
            "Key": "error.html"
        }
    }
  4. Copiez le fichier website.json sur votre bucket et configurez une ACL public-read :

    Exemple de requête
    $ aws s3 cp website.json s3://BUCKET/ \
        --profile YOUR_PROFILE \
        --acl public-read \
        --endpoint https://oos.<REGION>.outscale.com
  5. Créez votre site web par le biais de la commande website suivant cette syntaxe :

    Exemple de requête
    $ aws s3 website s3://BUCKET/ \ 
        --profile YOUR_PROFILE \
        --index-document index.html \
        --error-document error.html \
        --endpoint https://oos.<REGION>.outscale.com

Votre site web est créé et accessible au format d'adresse suivant : https://<BUCKET>.oos-website.<REGION>.outscale.com

Pour en savoir plus sur les commandes s3 correspondantes, voir les documentations cp et website d'AWS.



AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.