Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Versi: 1.1.1
Kelola file di bucket Amazon S3. Dengan ekstensi ini, Anda dapat membuat daftar, mendownload, dan menghapus file. Anda juga dapat membuat URL bertanda tangan untuk mendownload file.
Setiap instance yang dikonfigurasi dari ekstensi ini berfungsi dengan bucket tertentu. Untuk beberapa bucket, gunakan instance terkonfigurasi dari ekstensi ini untuk setiap bucket.
Prasyarat
Sebelum menggunakan ekstensi dari proxy API menggunakan kebijakan ExtensionCallout, Anda harus:
Dapatkan ID kunci akses dan kunci akses rahasia untuk bucket Amazon S3 yang akan Anda gunakan.
Anda akan memerlukannya, beserta nama bucket AWS dan region AWS, untuk configure ekstensi ini.
Tentang Amazon S3
Amazon Simple Storage Service (Amazon S3) adalah layanan penyimpanan objek.
Tindakan
deleteFile
Menghapus file yang ditentukan dari bucket S3.
Sintaksis
<Action>deleteFile</Action>
<Input><![CDATA[
{
"fileName" : "name-of-file-to-delete"
}
]]>
</Input>
Contoh
<Action>deleteFile</Action>
<Input><![CDATA[
{
"fileName" : "names.tmp"
}
]]>
</Input>
Parameter permintaan
Parameter | Deskripsi | Jenis | Default | Wajib |
---|---|---|---|---|
fileName | Nama file yang akan dihapus. | String | Tidak ada. | Ya. |
Respons
Tidak ada.
Properti respons
Tidak ada.
downloadFile
Mendownload file yang ditentukan dari bucket S3.
Sintaksis
<Action>downloadFile</Action>
<Input><![CDATA[
{
"fileName" : "filename"
}
]]>
</Input>
<Output>flow-variable</Output>
Contoh
<Action>downloadFile</Action>
<Input><![CDATA[
{
"fileName" : "product-sheet.pdf"
}
]]>
</Input>
<Output>downloaded.file</Output>
Parameter permintaan
Parameter | Deskripsi | Jenis | Default | Wajib |
---|---|---|---|---|
fileName | Nama file yang akan didownload. | String | Tidak ada. | Ya. |
Respons
JSON dengan properti content
yang berisi konten file.
{
"content":"Hello World!"
}
Properti respons
Properti | Deskripsi | Jenis | Default |
---|---|---|---|
content | String yang berisi konten file yang diminta. | String. | Tidak ada. |
generateSignedURL
Menghasilkan URL bertanda tangan untuk mendownload file yang ditentukan dari bucket S3.
Sintaksis
<Action>generateSignedURL</Action>
<Input><![CDATA[
{
"fileName": "filename",
"expiresIn": duration-in-seconds
}
]]>
</Input>
<Output>flow-variable</Output>
Contoh
<Action>generateSignedURL</Action>
<Input><![CDATA[
{
"fileName": "product-info.pdf",
"expiresIn": 3600
}
]]>
</Input>
<Output>download.url</Output>
Parameter permintaan
Parameter | Deskripsi | Jenis | Default | Wajib |
---|---|---|---|---|
fileName | Nama file yang akan didownload. | String | Tidak ada. | Ya. |
expiresIn | Durasi dalam detik hingga URL berakhir. | Bilangan Bulat | 86400 | Tidak. |
Respons
JSON dengan properti string url
yang berisi URL yang dihasilkan.
{
"url":"https://fake.s3.amazonaws.com/hello_world.txt?AWSAccessKeyId=123&Expires=1542753572&Signature=ABC"
}
Properti respons
Properti | Deskripsi | Jenis | Default |
---|---|---|---|
url | URL ke file yang diminta. | String | Tidak ada. |
listFiles
Memanggil eksekusi fungsi AWS Lambda.
Sintaksis
<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>
Anda harus menentukan parsed="false"
pada elemen <Output>
jika ingin variabel berisi JSON mentah. Jika tidak, variabel tidak dapat digunakan.
Contoh
<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">listFilesOutput</Output>
Parameter permintaan
Tidak ada.
Respons
Array nama file S3.
["hello_world.txt"]
Properti respons
Tidak ada.
Referensi Konfigurasi
Gunakan hal berikut saat Anda mengonfigurasi dan men-deploy ekstensi ini untuk digunakan di proxy API. Untuk langkah-langkah mengonfigurasi ekstensi menggunakan konsol Apigee, lihat Menambahkan dan mengonfigurasi ekstensi.
Properti ekstensi umum
Properti berikut ada untuk setiap ekstensi.
Properti | Deskripsi | Default | Wajib |
---|---|---|---|
name |
Nama yang Anda berikan pada konfigurasi ekstensi ini. | Tidak ada | Ya |
packageName |
Nama paket ekstensi seperti yang diberikan oleh Apigee Edge. | Tidak ada | Ya |
version |
Nomor versi untuk paket ekstensi tempat Anda mengonfigurasi ekstensi. | Tidak ada | Ya |
configuration |
Nilai konfigurasi khusus untuk ekstensi yang Anda tambahkan. Lihat Properti untuk paket ekstensi ini | Tidak ada | Ya |
Properti untuk paket ekstensi ini
Tentukan nilai untuk properti konfigurasi berikut yang khusus untuk ekstensi ini.
Properti | Deskripsi | Default | Wajib |
---|---|---|---|
konfigurasi | Masukkan nama bucket Amazon S3 yang akan digunakan, seperti sample-bucket . |
Tidak ada. | Ya. |
konfigurasi | Masukkan nama region AWS yang akan digunakan, seperti us-east-2 . |
Tidak ada. | Ya. |
kredensial | Saat dimasukkan di konsol Apigee Edge, file ini adalah file JSON yang berisi ID kunci akses dan kunci akses Amazon Anda dalam bentuk berikut:{ "accessKeyId" : access-key-ID, "secretAccessKey" : secret-access-key } Saat dikirim melalui API pengelolaan, nilai tersebut adalah nilai berenkode base64 yang dihasilkan dari file JSON kunci tersebut. |
Tidak ada. | Ya. |