Estensione Google Cloud Storage

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Versione: 2.0.2

Elenca, scarica e genera URL firmati per i file in un bucket Cloud Storage.

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare questa estensione da un proxy API, devi:

  1. Crea un bucket Cloud Storage.

  2. Carica oggetti nel bucket.

  3. Concedi l'autorizzazione per accedere al bucket al service account Google Cloud che rappresenta l'estensione Google Cloud Storage. Per saperne di più sul ruolo da utilizzare, consulta Ruoli Cloud Storage. Per saperne di più sulle autorizzazioni in Cloud Storage, consulta Utilizzo delle autorizzazioni Identity and Access Management (IAM).

  4. Utilizza la console Google Cloud per generare una chiave per il service account.

  5. Utilizza i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento alla configurazione.

Informazioni su Cloud Storage

Cloud Storage è un servizio per l'archiviazione di file sicura, durevole e scalabile. Se hai appena iniziato a utilizzare Cloud Storage, la guida di avvio rapido nella documentazione di Cloud Storage è un buon punto di partenza.

Esempi

Gli esempi seguenti illustrano come configurare il supporto per le azioni di estensione di Cloud Storage utilizzando il criterio ExtensionCallout.

Elenco file

Nel seguente esempio, l'azione listFiles dell'estensione recupera un elenco dei file e li restituisce in un array. L'azione listFiles non accetta parametri di input.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="false" enabled="true" name="Get-Storage-File-List">
    <DisplayName>Get Storage File List</DisplayName>
    <Connector>cloud-storage-extension-example</Connector>
    <Action>listFiles</Action>
    <Input><![CDATA[{}]]></Input>
    <Output parsed="false">storage.filelist.retrieved</Output>
</ConnectorCallout>

Il valore della risposta è simile al seguente:

["example-text.txt","example-image.png"]

La seguente policy Assign Message recupera il valore di risposta dalla policy ExtensionCallout e lo copia nel payload della risposta.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Storage-File-List">
    <DisplayName>Assign Storage File List</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{storage.filelist.retrieved}</Payload>
    </Set>
</AssignMessage>

Scaricare un file

La seguente policy ExtensionCallout utilizza l'estensione Google Cloud Storage per scaricare un file di testo il cui contenuto è Some example text.,

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="false" enabled="true" name="Download-File">
    <DisplayName>Download File</DisplayName>
    <Connector>cloud-storage-extension-example</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[{"fileName": "example-text.txt"}]]></Input>
    <Output>storage.file.retrieved</Output>
</ConnectorCallout>

Il valore della risposta è simile al seguente:

{"content":"Some example text."}

Il seguente criterio Assegna messaggio recupera il valore restituito dall'estensione e lo copia nel payload della risposta.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Storage-File-List">
    <DisplayName>Assign Storage File List</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{storage.file.retrieved}</Payload>
    </Set>
</AssignMessage>

Generare un URL firmato

Il seguente criterio ExtensionCallout utilizza questa estensione per generare un URL per il download del file specificato dal bucket Cloud Storage. Trasmette il nome del file, insieme alla data dopo la quale l'URL deve scadere e non funzionare più.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="false" enabled="true" name="Get-Signed-URL">
    <DisplayName>Get Signed URL</DisplayName>
    <Connector>cloud-storage-extension-example</Connector>
    <Action>generateSignedURL</Action>
    <Input><![CDATA[{
        "fileName" : "example-text.txt",
        "expiresOn" : "2018-08-05"
    }]]></Input>
    <Output>storage.url.retrieved</Output>
</ConnectorCallout>

Il valore restituito dell'estensione è simile al seguente.

{"url":"https://storage.googleapis.com/storage-extension-example/example-text.txt?GoogleAccessId=extension-test%40my-test-33333.iam.gserviceaccount.com&Expires=1533427200&Signature=Y1cE1DCHesWeIZILRhdIuDR%2FhzZXZ%2BPeY3J1PUkRiosFYj41itHBWh2%2BTQgH9kI6E8s2mWrVDFU43YR7s8Tm9W5VgWRwh0nXSactQ0xKbkKbGZmCcWxgIscOezc1zc%2Bp7lnXSx1qd4wIlIKVH4KCd9WLx4qB1dLxGNxMKB32tA3dio5IiMXaHEA%2FR2fYc0Pjh45t8L5rilk5pekv7jfd3sfsgdfgfdglkj%2F7E%2FlJ%2B60RnetqV2IDqrc0sVEgSLTpgTbDGU%2Ft3EcitRUFOSdOb5czt7CiIwKAYSmDEFMSNHHiNTWjvLzq4IU%2BCa4Z5aKyvww%3D%3D"}

Il seguente criterio Assegna messaggio recupera il valore restituito dall'estensione e lo copia nel corpo della risposta.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Storage-File-URL">
    <DisplayName>Assign Storage File URL</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{storage.url.retrieved}</Payload>
    </Set>
</AssignMessage>

Azioni

downloadFile

Scarica il file specificato.

Parametri di richiesta

Parametro Descrizione Tipo Predefinito Obbligatorio
fileName Il file da scaricare. Stringa Nessuno. Sì.

Sintassi

<Input><![CDATA[{"fileName" : "the-file-to-download"}]]></Input>

Esempio

<Input><![CDATA[{"fileName" : "example-text.txt"}]]></Input>

Risposta

JSON che rappresenta un oggetto con i contenuti del file scaricato. Ad esempio:

{"content":"Some example text."}

listFiles

Elenca i file disponibili per il download.

Parametri di richiesta

Nessuno.

Risposta

Un array di nomi file. Ad esempio:

["example-text.txt","example-image.png"]

generateSignedURL

Crea un URL firmato per il file specificato nel bucket. Questo URL può essere utilizzato per scaricare il file.

Parametri di richiesta

Parametro Descrizione Tipo Predefinito Obbligatorio
fileName Nome dell'oggetto Cloud Storage per cui generare un URL firmato. Stringa Nessuno. Sì.
expiresOn Data di scadenza dell'URL firmato. Stringa Nessuno. No.

Sintassi

<Input><![CDATA[{
  "fileName" : "file-for-which-to-generate-url",
  "expiresOn" : "date-to-expire-url"
}]]></Input>

Esempio

<Input><![CDATA[{
  "fileName" : "example-text.txt",
  "expiresOn" : "2018-08-05"
}]]></Input>

Risposta

JSON che rappresenta un oggetto con l'URL firmato. Ad esempio:

{"url":"https://storage.googleapis.com/storage-extension-example/example-text.txt?GoogleAccessId=extension-test%40my-test-33333.iam.gserviceaccount.com&Expires=1533427200&Signature=Y1cE1DCHesWeIZILRhdIuDR%2FhzZXZ%2BPeY3J1PUkRiosFYj41itHBWh2%2BTQgH9kI6E8s2mWrVDFU43YR7s8Tm9W5VgWRwh0nXSactQ0xKbkKbGZmCcWxgIscOezc1zc%2Bp7lnXSx1qd4wIlIKVH4KCd9WLx4qB1dLxGNxMKB32tA3dio5IiMXaHEA%2FR2fYc0Pjh45t8L5rilk5pekv7jfd3sfsgdfgfdglkj%2F7E%2FlJ%2B60RnetqV2IDqrc0sVEgSLTpgTbDGU%2Ft3EcitRUFOSdOb5czt7CiIwKAYSmDEFMSNHHiNTWjvLzq4IU%2BCa4Z5aKyvww%3D%3D"}

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per l'utilizzo nei proxy API. Per i passaggi per configurare un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà Descrizione Predefinito Obbligatorio
name Il nome che assegni a questa configurazione dell'estensione. Nessuno Sì
packageName Nome del pacchetto dell'estensione fornito da Apigee Edge. Nessuno Sì
version Numero di versione del pacchetto dell'estensione da cui stai configurando un'estensione. Nessuno Sì
configuration Valore di configurazione specifico per l'estensione che stai aggiungendo. Vedi Proprietà per questo pacchetto di estensioni Nessuno Sì

Proprietà di questo pacchetto di estensioni

Proprietà Descrizione Predefinito Obbligatorio
bucketName Il bucket GCS con cui deve interagire questa estensione. Nessuno. Sì.