Appelez-le à l'APIaide d'un REST API client

Pour fournir un end-to-end tutoriel, nous montrons maintenant comment appeler le postier API utilisant, qui prend en charge l' AWS IAMautorisation.

Pour appeler notre proxy Amazon S3 à API l'aide de Postman

1. 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.

2. Lancez Postman.

3. 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. Entrez execute-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.

4. Pour ajouter un compartiment nommé amzn-s3-demo-bucket à votre compte Amazon S3 dans la région {region} :

   1. 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

   2. Définissez la valeur de l'en-tête Content-Type sur application/xml. Vous devrez peut-être supprimer des en-têtes existants avant de définir le type de contenu.

   3. Choisissez l'élément de menu Body et saisissez le XML fragment suivant comme corps de requête :

      <CreateBucketConfiguration> 
        <LocationConstraint>{region}</LocationConstraint> 
      </CreateBucketConfiguration>

   4. Choisissez Send pour envoyer la demande. Si l'opération aboutit, vous devez recevoir une réponse 200 OK avec une charge utile vide.

5. 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 fichier Readme.txt pour {item} dans le URL et Hello, 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 devient

   PUT /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.

6. Pour obtenir le contenu du Readme.txt fichier que nous venons d'ajouter au amzn-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-5bd96928098a

   Si la demande aboutit, vous devez recevoir une réponse 200 OK avec la chaîne de texte Hello, World! comme charge utile.

7. 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-4c49ad8d1392
   

   En 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.