Extensión de Google Cloud Storage

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Versión: 1.4.1

Enumera, descarga y genera URL firmadas para archivos en un bucket de Cloud Storage.

En este contenido, se proporciona referencia para configurar y usar esta extensión. Antes de usar esta extensión desde un proxy de API, debes hacer lo siguiente:

  1. Crea buckets de Cloud Storage.

  2. Sube objetos a tu bucket.

  3. Otorga permiso para acceder al bucket a la cuenta de servicio de GCP que representa tu extensión de Google Cloud Storage. Para obtener más información sobre el rol que debes usar, consulta Roles de Cloud Storage. Para obtener más información sobre los permisos en Cloud Storage, consulta Usa permisos de Identity and Access Management (IAM).

  4. Usar GCP Console a fin de generar una clave para la cuenta de servicio

  5. Usa el contenido del archivo JSON de claves resultante cuando agregues y configures la extensión con la referencia de configuración.

Acerca de Cloud Storage

Cloud Storage es un servicio de almacenamiento de archivos seguro, duradero y escalable. Si recién comienzas a usar Cloud Storage, la guía de inicio rápido de la documentación de Cloud Storage es un buen punto de partida.

Ejemplos

En los siguientes ejemplos, se muestra cómo configurar la compatibilidad con las acciones de extensión de Cloud Storage con la política ExtensionReference.

Enumerar archivos

En el siguiente ejemplo, la acción listFiles de la extensión recupera una lista de los archivos y los muestra en un array. La acción listFiles no toma parámetros de entrada.

<?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>

El valor de respuesta debería ser similar al siguiente:

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

La siguiente política de asignación de mensajes recupera el valor de respuesta de la política ExtensionAviso anterior y lo copia en la carga útil de la respuesta.

<?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>

Cómo descargar un archivo

La siguiente política ExtensionLlamadas usa la extensión de Google Cloud Storage para descargar un archivo de texto simple cuyo contenido es simplemente 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>

El valor de respuesta se ve de la siguiente manera:

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

La siguiente política de asignación de mensajes recupera el valor que muestra la extensión y lo copia en la carga útil de la respuesta.

<?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>

Genera una URL firmada

La siguiente política ExtensionReference usa esta extensión para generar una URL para descargar el archivo especificado desde el bucket de Cloud Storage. Pasa el nombre del archivo, junto con la fecha después de la cual la URL debería caducar y dejar de funcionar.

<?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>

El valor que se muestra de la extensión es similar al siguiente:

{"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"}

La siguiente política de asignación de mensajes recupera el valor que muestra la extensión y lo copia en el cuerpo de la respuesta.

<?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>

Acciones

descargarArchivo

Descarga el archivo especificado.

parámetros de solicitud

Parámetro Descripción Tipo Predeterminada Obligatorio
fileName El archivo que se descargará. String Ninguno Sí.

Sintaxis

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

Ejemplo

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

Respuesta

JSON que representa un objeto con el contenido del archivo descargado. Por ejemplo:

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

listFiles

Muestra una lista de los archivos disponibles para descargar.

parámetros de solicitud

Ninguno

Respuesta

Un array de nombres de archivos. Por ejemplo:

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

generateSignedURL

Crea una URL firmada para un archivo especificado en el bucket. Esta URL se puede usar para descargar el archivo.

parámetros de solicitud

Parámetro Descripción Tipo Predeterminada Obligatorio
fileName Nombre del objeto de Cloud Storage para el que se genera una URL firmada. String Ninguno Sí.
expiresOn Fecha en la que debería vencer la URL firmada. String Ninguno No.

Sintaxis

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

Ejemplo

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

Respuesta

JSON que representa un objeto con la URL firmada. Por ejemplo:

{"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"}

Referencia de configuración

Usa la siguiente información cuando configures e implementes esta extensión para usarla en proxies de API. Si quieres conocer los pasos para configurar una extensión con la consola de Apigee, consulta Agrega y configura una extensión.

Propiedades de extensión comunes

Las siguientes propiedades están presentes para cada extensión.

Propiedad Descripción Predeterminado Obligatorio
name Nombre que asignas a esta configuración de la extensión. Ninguna Sí
packageName Nombre del paquete de extensiones proporcionado por Apigee Edge. Ninguna Sí
version El número de versión del paquete de extensiones desde el que quieres configurar la extensión. Ninguna Sí
configuration Es un valor de configuración específico para la extensión que agregas. Consulta Propiedades para este paquete de extensiones Ninguna Sí

Propiedades de este paquete de extensión

Propiedad Descripción Predeterminado Obligatorio
bucketName El bucket de GCS con el que debe interactuar esta extensión. Ninguno Sí.