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: 2.0.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á tệp. Bạn cũng có thể tạo 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 thực thể đã đị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 sẽ cần những thông tin này, cùng với tên bộ chứa AWS và khu vực AWS, để configure 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à một dịch vụ lưu trữ đối tượng.

Thao tác

deleteFile

Xoá tệp được chỉ định 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>

Tham số yêu cầu

Phản hồi

Không có.

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

Không có.

downloadFile

Tải tệp đã chỉ định xuống từ mộ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>

Tham số yêu cầu

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>

Tham số yêu cầu

Phản hồi

JSON có 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 quá trì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" trên 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ó.

Tài liệu tham khảo về cấu hình

Hãy sử dụng nội dung sau đây 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 phần Thêm và định cấu hình tiện ích.

Các thuộc tính mở rộng phổ biến

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

Thuộc tính cho 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.