Rufen Sie das API über einen Client auf REST API

Um ein end-to-end Tutorial zur Verfügung zu stellen, zeigen wir nun, wie man den API Postman aufruft, der die AWS IAM Autorisierung unterstützt.

Um unseren Amazon S3 S3-Proxy API mit Postman aufzurufen

1. Stellen Sie das bereit oder stellen Sie es erneut bereit. API Notieren Sie sich die Basis URL vonAPI, die oben URL im Stage Editor neben Invoke angezeigt wird.

2. Starten Sie Postman.

3. Wählen Sie Autorisierung und anschließend AWS Signature. Geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel Ihres IAM Benutzers in die AccessKeyjeweiligen SecretKeyEingabefelder ein. Geben Sie im AWS-Region Textfeld Region die AWS Region API ein, für die Ihr Gerät bereitgestellt wird. Geben Sie es execute-api in das Eingabefeld Dienstname ein.

   Sie können in Ihrem IAM Benutzerkonto in der IAM Management Console auf der Registerkarte Sicherheitsanmeldedaten ein Schlüsselpaar erstellen.

4. So fügen Sie einen Bucket mit dem Namen amzn-s3-demo-bucket zu Ihrem Amazon S3-Konto in der Region {region} hinzu:

   1. Wählen Sie PUTaus der Dropdownliste die Methode aus und geben Sie die Methode ein URL (https://api-id.execute-api.aws-region.amazonaws.com/stage/folder-name

   2. Geben Sie bei Content-Type den Header-Wert application/xml ein. Sie müssen möglicherweise vorhandene Header löschen, bevor Sie den Content-Type angeben können.

   3. Wählen Sie den Menüpunkt Text und geben Sie das folgende XML Fragment als Hauptteil der Anfrage ein:

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

   4. Wählen Sie Senden aus, um die Anforderung zu senden. Bei Erfolg erhalten Sie die Antwort 200 OK mit einer leeren Nutzlast.

5. Um zu einem Bucket eine Textdatei hinzuzufügen, befolgen Sie die obigen Anweisungen. Wenn Sie {item} in der den Bucket-Namen amzn-s3-demo-bucket for {folder} und den Dateinamen Readme.txt for angeben URL und eine Textzeichenfolge Hello, World! als Dateiinhalt angeben (wodurch sie zur Nutzlast der Anfrage wird), wird die Anfrage

   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!

   Wenn alles einwandfrei verläuft, erhalten Sie die Antwort 200 OK mit einer leeren Nutzlast.

6. Um den Inhalt der Readme.txt Datei abzurufen, die wir gerade zum amzn-s3-demo-bucket Bucket hinzugefügt haben, führen Sie eine GET Anfrage wie die folgende aus:

   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

   Bei Erfolg erhalten Sie die Antwort 200 OK mit der Textzeichenfolge Hello, World! als Nutzlast.

7. Um Elemente im amzn-s3-demo-bucket-Bucket aufzulisten, senden Sie die folgende Anforderung:

   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
   

   Im Erfolgsfall sollten Sie eine 200 OK Antwort mit einer XML Payload erhalten, die ein einzelnes Element im angegebenen Bucket anzeigt, es sei denn, Sie haben dem Bucket weitere Dateien hinzugefügt, bevor Sie diese Anfrage abgeschickt haben.

   <?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>

Anmerkung

Um ein Bild hoch- oder herunterzuladen, müssen Sie die Inhaltsverwaltung auf CONVERT BINARY _TO_ setzen.