Phần mở rộng Amazon S3

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Phiên bản: 1.1.0

Quản lý tệp trong bộ chứa Amazon S3. Với tiện ích này, bạn có thể liệt kê, tải xuống và xoá các tệp. Bạn cũng có thể tạo một URL đã ký để tải tệp xuống.

Mỗi thực thể được định cấu hình của tiện ích này hoạt động với một bộ chứa cụ thể. Đối với nhiều bộ chứa, hãy sử dụng một phiên bản đã định cấu hình của tiện ích này cho mỗi bộ chứa.

Điều kiện tiên quyết

Trước khi sử dụng tiện ích từ một proxy API bằng chính sách ExtensionCallout, bạn phải:

• Lấy mã khoá truy cập và khoá truy cập bí mật cho bộ chứa Amazon S3 mà bạn sẽ sử dụng.

  Bạn cần có những thông tin này, cùng với tên bộ chứa AWS và vùng AWS để định cấu hình tiện ích này.

Giới thiệu về Amazon S3

Dịch vụ lưu trữ đơn giản của Amazon (Amazon S3) là dịch vụ lưu trữ đối tượng.

Thao tác

deleteFile

Xoá tệp cụ thể khỏi bộ chứa S3.

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "name-of-file-to-delete"
}
]]>
</Input>

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "names.tmp"
}
]]>
</Input>

Yêu cầu thông số

Phản hồi

Không có.

Thuộc tính phản hồi

Không có.

downloadFile

Tải tệp được chỉ định xuống từ bộ chứa S3.

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "filename"
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "product-sheet.pdf"
}
]]>
</Input>
<Output>downloaded.file</Output>

Yêu cầu thông số

Phản hồi

JSON có thuộc tính content chứa nội dung của tệp.

{
  "content":"Hello World!"
}

Thuộc tính phản hồi

generateSignedURL

Tạo một URL đã ký để tải tệp đã chỉ định xuống từ một bộ chứa S3.

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "filename",
  "expiresIn": duration-in-seconds
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "product-info.pdf",
  "expiresIn": 3600
}
]]>
</Input>
<Output>download.url</Output>

Yêu cầu thông số

Phản hồi

JSON với thuộc tính chuỗi url chứa URL đã tạo.

{
  "url":"https://fake.s3.amazonaws.com/hello_world.txt?AWSAccessKeyId=123&Expires=1542753572&Signature=ABC"
}

Thuộc tính phản hồi

listFiles

Gọi lệnh thực thi một hàm AWS Lambda.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>

Bạn phải chỉ định parsed="false" trong phần tử <Output> nếu muốn biến chứa JSON thô. Nếu không, bạn sẽ không thể sử dụng biến này.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">listFilesOutput</Output>

Tham số yêu cầu

Không có.

Phản hồi

Một mảng tên tệp S3.

["hello_world.txt"]

Thuộc tính phản hồi

Không có.

Tham chiếu cấu hình

Sử dụng mã sau khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong proxy API. Để biết các bước định cấu hình tiện ích bằng bảng điều khiển Apigee, hãy xem bài viết Thêm và định cấu hình tiện ích.

Các thuộc tính tiện ích phổ biến

Các thuộc tính sau có sẵn cho mỗi tiện ích.

Các thuộc tính của gói tiện ích này

Chỉ định giá trị cho các thuộc tính cấu hình sau đây dành riêng cho tiện ích này.