Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Appelez-le à l'APIaide d'un REST API client
Pour fournir un end-to-end tutoriel, nous montrons maintenant comment appeler le postier API
Pour appeler notre proxy Amazon S3 à API l'aide de Postman
-
Déployez ou redéployez le. API Notez la base URL du API qui s'affiche à côté d'Invoke URL en haut de l'éditeur de scène.
-
Lancez Postman.
-
Choisissez Autorisation, puis choisissez
AWS Signature
. Entrez IAM l'ID de clé d'accès et la clé d'accès secrète de votre utilisateur dans les champs de SecretKeysaisie AccessKeyet, respectivement. Entrez le Région AWS lieu vers lequel vous API êtes déployé dans la AWS zone de texte Région. Entrezexecute-api
dans le champ de saisie Nom du service.Vous pouvez créer une paire de clés depuis l'onglet Informations d'identification de sécurité de votre compte IAM utilisateur dans la console IAM de gestion.
-
Pour ajouter un compartiment nommé
amzn-s3-demo-bucket
à votre compte Amazon S3 dans la région
:{region}
-
PUTChoisissez dans la liste déroulante des méthodes et saisissez la méthode URL (
https://
api-id
.execute-api.aws-region
.amazonaws.com/stage
/folder-name
-
Définissez la valeur de l'en-tête
Content-Type
surapplication/xml
. Vous devrez peut-être supprimer des en-têtes existants avant de définir le type de contenu. -
Choisissez l'élément de menu Body et saisissez le XML fragment suivant comme corps de requête :
<CreateBucketConfiguration> <LocationConstraint>
{region}
</LocationConstraint> </CreateBucketConfiguration> -
Choisissez Send pour envoyer la demande. Si l'opération aboutit, vous devez recevoir une réponse
200 OK
avec une charge utile vide.
-
-
Pour ajouter un fichier texte à un compartiment, suivez les instructions ci-dessus. Si vous spécifiez un nom de compartiment
amzn-s3-demo-bucket
pour{folder}
et un nom de fichierReadme.txt
pour{item}
dans le URL etHello, World!
que vous fournissez une chaîne de texte indiquant le contenu du fichier (ce qui en fait la charge utile de la demande), la demande devientPUT /S3/amzn-s3-demo-bucket/Readme.txt HTTP/1.1 Host: 9gn28ca086.execute-api.
{region}
.amazonaws.com Content-Type: application/xml X-Amz-Date: 20161015T062647Z Authorization: AWS4-HMAC-SHA256 Credential=access-key-id
/20161015/{region}
/execute-api/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=ccadb877bdb0d395ca38cc47e18a0d76bb5eaf17007d11e40bf6fb63d28c705b Cache-Control: no-cache Postman-Token: 6135d315-9cc4-8af8-1757-90871d00847e Hello, World!Si tout se passe bien, vous devez recevoir une réponse
200 OK
avec une charge utile vide. -
Pour obtenir le contenu du
Readme.txt
fichier que nous venons d'ajouter auamzn-s3-demo-bucket
bucket, effectuez une GET requête comme celle-ci :GET /S3/amzn-s3-demo-bucket/Readme.txt HTTP/1.1 Host: 9gn28ca086.execute-api.
{region}
.amazonaws.com Content-Type: application/xml X-Amz-Date: 20161015T063759Z Authorization: AWS4-HMAC-SHA256 Credential=access-key-id
/20161015/{region}
/execute-api/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=ba09b72b585acf0e578e6ad02555c00e24b420b59025bc7bb8d3f7aed1471339 Cache-Control: no-cache Postman-Token: d60fcb59-d335-52f7-0025-5bd96928098aSi la demande aboutit, vous devez recevoir une réponse
200 OK
avec la chaîne de texteHello, World!
comme charge utile. -
Pour répertorier les éléments du compartiment
amzn-s3-demo-bucket
, envoyez la demande suivante :GET /S3/amzn-s3-demo-bucket HTTP/1.1 Host: 9gn28ca086.execute-api.
{region}
.amazonaws.com Content-Type: application/xml X-Amz-Date: 20161015T064324Z Authorization: AWS4-HMAC-SHA256 Credential=access-key-id
/20161015/{region}
/execute-api/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=4ac9bd4574a14e01568134fd16814534d9951649d3a22b3b0db9f1f5cd4dd0ac Cache-Control: no-cache Postman-Token: 9c43020a-966f-61e1-81af-4c49ad8d1392En cas de succès, vous devriez recevoir une
200 OK
réponse avec une XML charge utile indiquant un seul élément dans le compartiment spécifié, sauf si vous avez ajouté d'autres fichiers au compartiment avant de soumettre cette demande.<?xml version="1.0" encoding="UTF-8"?> <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Name>apig-demo-5</Name> <Prefix></Prefix> <Marker></Marker> <MaxKeys>1000</MaxKeys> <IsTruncated>false</IsTruncated> <Contents> <Key>Readme.txt</Key> <LastModified>2016-10-15T06:26:48.000Z</LastModified> <ETag>"65a8e27d8879283831b664bd8b7f0ad4"</ETag> <Size>13</Size> <Owner> <ID>06e4b09e9d...603addd12ee</ID> <DisplayName>
user-name
</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> </Contents> </ListBucketResult>
Note
Pour charger ou télécharger une image, vous devez définir la gestion du contenu sur CONVERT _TO_BINARY.