Amazon S3 Uzantısı

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
info

Sürüm: 2.0.0

Amazon S3 paketindeki dosyaları yönetme Bu uzantı sayesinde dosyaları listeleyebilir, indirebilir ve silebilirsiniz. Dosya indirmek için imzalı bir URL de oluşturabilirsiniz.

Bu uzantının yapılandırılmış her örneği belirli bir paketle çalışır. Birden fazla paket için her pakette bu uzantının yapılandırılmış bir örneğini kullanın.

Ön koşullar

ExtensionCallout politikasını kullanarak uzantıyı bir API proxy'sinden kullanmadan önce şunları yapmanız gerekir:

Bu uzantıyı configure için AWS paketi adının ve AWS bölgesinin yanı sıra bu bilgilere de ihtiyacınız vardır.

Amazon S3 hakkında

Amazon Simple Storage Service (Amazon S3), bir nesne depolama hizmetidir.

İşlemler

deleteFile

Belirtilen dosyayı S3 paketinden siler.

Söz dizimi

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

Örnek

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

İstek parametreleri

Parametre Açıklama Tür Varsayılan Zorunlu
fileName Silinecek dosyanın adı. Dize Yok. Evet.

Yanıt

Yok.

Yanıt özellikleri

Yok.

downloadFile

Belirtilen dosyayı bir S3 paketinden indirir.

Söz dizimi

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

Örnek

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

İstek parametreleri

Parametre Açıklama Tür Varsayılan Zorunlu
fileName İndirilecek dosyanın adı. Dize Yok. Evet.

Yanıt

Dosyanın içeriğini içeren bir content mülküne sahip JSON.

{
  "content":"Hello World!"
}

Yanıt özellikleri

Mülk Açıklama Tür Varsayılan
içerik İstenen dosyanın içeriğini içeren bir dize. Dize. Yok.

generateSignedURL

Belirtilen dosyayı bir S3 paketinden indirmek için imzalı bir URL oluşturur.

Söz dizimi

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

Örnek

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

İstek parametreleri

Parametre Açıklama Tür Varsayılan Zorunlu
fileName İndirilecek dosyanın adı. Dize Yok. Evet.
expiresIn URL'nin geçerlilik süresinin sona ermesine kalan süre (saniye cinsinden). Tamsayı 86400 Sıra

Yanıt

Oluşturulan URL'yi içeren bir url dize özelliğine sahip JSON.

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

Yanıt özellikleri

Mülk Açıklama Tür Varsayılan
url İstenen dosyanın URL'si. Dize Yok.

listFiles

Bir AWS Lambda işlevinin yürütülmesini başlatır.

Söz dizimi

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

Değişkenin ham JSON içermesini istiyorsanız <Output> öğesinde parsed="false" belirtmeniz gerekir. Aksi takdirde değişken kullanılamaz.

Örnek

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

İstek parametreleri

Yok.

Yanıt

S3 dosya adları dizisi.

["hello_world.txt"]

Yanıt özellikleri

Yok.

Yapılandırma Referansı

Bu uzantıyı API proxy'lerinde kullanılmak üzere yapılandırırken ve dağıtırken aşağıdakileri kullanın. Apigee konsolunu kullanarak bir uzantıyı yapılandırma adımları için Uzantı ekleme ve yapılandırma başlıklı makaleyi inceleyin.

Ortak uzantı özellikleri

Aşağıdaki özellikler her uzantı için mevcuttur.

Mülk Açıklama Varsayılan Zorunlu
name Uzantının bu yapılandırmasını verdiğiniz ad. Yok Evet
packageName Apigee Edge'in sağladığı uzantı paketinin adı. Yok Evet
version Uzantıyı yapılandırdığınız uzantı paketinin sürüm numarası. Yok Evet
configuration Eklediğiniz uzantıya özgü yapılandırma değeri. Bu uzantı paketinin özellikleri başlıklı makaleyi inceleyin Yok Evet

Bu uzantı paketine ait özellikler

Bu uzantıya özgü aşağıdaki yapılandırma özellikleri için değerler belirtin.

Mülk Açıklama Varsayılan Zorunlu
yapılandırma Kullanılacak Amazon S3 paketinin adını (ör. sample-bucket) girin. Yok. Evet.
yapılandırma Kullanılacak AWS bölgesinin adını (ör. us-east-2) girin. Yok. Evet.
giriş bilgileri Apigee Edge konsoluna girildiğinde, Amazon erişim anahtar kimliğinizi ve erişim anahtarınızı aşağıdaki biçimde içeren bir JSON dosyasıdır:

{
"accessKeyId" : access-key-ID,
"secretAccessKey" : secret-access-key
}

Yönetim API'si kullanılarak gönderildiğinde, bu anahtar JSON dosyasından oluşturulan base64 kodlu bir değerdir.
Yok. Evet.