Panggil API menggunakan REST API klien

Untuk memberikan end-to-end tutorial, kami sekarang menunjukkan cara memanggil API menggunakan Postman, yang mendukung AWS IAM otorisasi.

Untuk menghubungi proxy API Amazon S3 kami menggunakan Postman

1. Menyebarkan atau menyebarkan ulang file. API Buat catatan dasar URL API yang ditampilkan di sebelah Invoke URL di bagian atas Stage Editor.

2. Luncurkan Postman.

3. Pilih Otorisasi dan kemudian pilihAWS Signature. Masukkan ID Kunci Akses dan Kunci Akses Rahasia IAM pengguna Anda ke dalam kolom AccessKeydan SecretKeyinput, masing-masing. Masukkan Wilayah AWS tempat Anda API digunakan di kotak teks AWS Wilayah. Masukkan execute-api di kolom input Nama Layanan.

   Anda dapat membuat sepasang kunci dari tab Security Credentials dari akun IAM pengguna di IAM Management Console.

4. Untuk menambahkan bucket yang diberi nama amzn-s3-demo-bucket ke akun Amazon S3 Anda di wilayah ini{region}:

   1. Pilih PUTdari daftar metode drop-down dan ketik metode URL (https://api-id.execute-api.aws-region.amazonaws.com/stage/folder-name

   2. Tetapkan nilai Content-Type header sebagaiapplication/xml. Anda mungkin perlu menghapus header yang ada sebelum menyetel jenis konten.

   3. Pilih item menu Body dan ketik XML fragmen berikut sebagai badan permintaan:

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

   4. Pilih Kirim untuk mengirimkan permintaan. Jika berhasil, Anda harus menerima 200 OK respons dengan muatan kosong.

5. Untuk menambahkan file teks ke ember, ikuti petunjuk di atas. Jika Anda menentukan nama bucket amzn-s3-demo-bucket for {folder} dan nama file Readme.txt for {item} di dalam URL dan memberikan string teks Hello, World! sebagai isi file (sehingga menjadikannya payload permintaan), permintaan menjadi

   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!

   Jika semuanya berjalan dengan baik, Anda harus menerima 200 OK respons dengan muatan kosong.

6. Untuk mendapatkan konten Readme.txt file yang baru saja kita tambahkan ke amzn-s3-demo-bucket bucket, lakukan GET permintaan seperti berikut:

   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

   Jika berhasil, Anda harus menerima 200 OK respons dengan string Hello, World! teks sebagai payload.

7. Untuk mencantumkan item di amzn-s3-demo-bucket bucket, kirimkan permintaan berikut:

   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
   

   Jika berhasil, Anda harus menerima 200 OK respons dengan XML muatan yang menampilkan satu item di bucket yang ditentukan, kecuali jika Anda menambahkan lebih banyak file ke bucket sebelum mengirimkan permintaan ini.

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

catatan

Untuk mengunggah atau mengunduh gambar, Anda perlu mengatur penanganan konten ke CONVERT _TO_BINARY.