Obtenir des informations sur un bucket

Vous pouvez vérifier si un bucket existe et si vous y avez accès.

Obtenir des informations sur un bucket avec AWS CLI

Vérifier l’existence et l’accès au bucket

Avant de commencer : Installez et configurez AWS CLI et définissez votre profil. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour vérifier si un bucket existe et si vous y avez accès, utilisez la commande head-bucket en suivant cette syntaxe :

Exemple de requête
$ aws s3api head-bucket \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --endpoint https://oos.eu-west-2.outscale.com

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

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • bucket : Le nom du bucket dont vous voulez vérifier l’accès.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

Si le bucket existe et que vous y avez accès, la commande head-object ne renvoie aucun élément.

Néanmoins, si vous n’avez pas accès au bucket, le message d’erreur 403 suivant est renvoyé :

Exemple de résultat
An error occurred (403) when calling the HeadBucket operation: Forbidden

Obtenir des informations sur la localisation d’un bucket

Pour obtenir des informations sur la localisation d’un bucket, utilisez la commande get-bucket-location en suivant cette syntaxe.

Pour utiliser cette commande, vous devez avoir les permissions adéquates sur le bucket. Pour en savoir plus, voir Référence des Access Control List (ACL).

Exemple de requête
$ aws s3api get-bucket-location \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --endpoint https://oos.eu-west-2.outscale.com

La commande get-bucket-location renvoie le résultat suivant :

  • LocationConstraint : Indique la localisation du bucket.

Exemple de résultat
{
    "LocationConstraint": "site1"
}

Pages connexes

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.