Storage Connect permite que los clientes de empresa de Frame.io utilicen su propio punto final de almacenamiento en la nube como almacenamiento auxiliar de Frame.io. Hoy en día, cuando un usuario carga un recurso a Frame.io, el recurso fluye a través de la pila de la aplicación y se almacena en el bucket de Amazon S3 de Frame.io. Del mismo modo, la reproducción y entrega de un recurso se realiza desde un bloque de Amazon S3 administrado por Frame.io.
Utilice su propio AWS S3 como fuente de información fiable mientras mantiene Frame.io como superficie única para navegar, buscar, compartir y revisar. Ahora ya puede conectar:
Un bloque S3 principal (lectura/escritura), donde se almacenan las nuevas cargas de Frame.io
Cualquier número de bloques S3 adicionales (solo lectura)‑: haga que los medios existentes en S3 sean visibles y reproducibles en Frame.io sin copiar ni duplicar originales.
Frame.io genera proxies ligeros (miniaturas, vistas previas, reproducción) mientras que los originales permanecen en su S3. Para registrar archivos que ya se encuentran en los bloques conectados, utilice el punto final V4 Public API: Import File.
Nota: Esta oferta está disponible tanto para los nuevos clientes como para los clientes existentes de Frame.io que utilicen Storage Connect. Para habilitar los clientes actuales, Frame.io ofrece una migración única de los datos de clientes existentes almacenados históricamente en el bloque de Amazon S3 administrado por Frame.io al bloque de Amazon S3 administrado por el cliente para su disponibilidad general.
La siguiente información está diseñada para informar tanto a clientes nuevos como actuales de Frame.io con una guía paso a paso para configurar su bloque S3 de modo que sea compatible con Storage Connect.
Requisitos previos
La cuenta de Frame.io Enterprise con Storage Connect habilitado para su org.
Acceso para crear/actualizar AWS IAM roles/policies y permisos para S3 bucket.
Acceso a Frame.io V4 Public API (para el punto final Import File utilizado para registrar objetos existentes de bloques de solo lectura).‑
Nota: Para conocer la configuración exacta de IAM trust y la asignación de cuentas, su contacto en Frame.io (CSM/especialista en implementación) le proporcionará la configuración de OIDC/función actual y validará los permisos durante la incorporación.
Conceptos clave
Bloque principal (lectura/escritura): el bloque de S3 que recibe los originales cuando los usuarios los suben a Frame. Frame requiere permisos de lectura + escritura.
Bloques de solo lectura‑: uno o más bloques de S3 que Frame puede leer, pero no escribir. Los recursos se hacen visibles en Frame llamando a la API Import File (no copiando los originales).
Proxies: Frame genera derivados (miniaturas, vistas previas y proxies de streaming) para que los recursos se puedan reproducir en Frame aunque los originales permanezcan en su S3.
Parte A: Configurar el bloque S3 principal de lectura/escritura
Elija o cree el bloque S3 que utilizará como almacenamiento principal.
Cree una función de IAM para Frame.io (de confianza para el proveedor de identidad de Frame.io) y adjunte una política de IAM que conceda permisos de lectura/escritura al bloque/prefijo.
Ejemplo de estructura de política (sustituya los ARN y restrinja a los prefijos necesarios siempre que sea posible):
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ListPrimaryBucket",
"Effect": "Allow",
"Action": ["s3:ListBucket"],
"Resource": "arn:aws:s3:::YOUR_PRIMARY_BUCKET"
},
{
"Sid": "RWPrimaryObjects",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject",
"s3:DeleteObject",
"s3:AbortMultipartUpload",
"s3:ListMultipartUploadParts"
],
"Resource": "arn:aws:s3:::YOUR_PRIMARY_BUCKET/*"
}
]
} Proporcione detalles a Frame.io: el ARN de la función IAM, el nombre del bloque y cualquier prefijo de objeto preferido. Frame.io completará la asignación para que las cargas de sus usuarios en Frame se dirijan a este bloque.
Valide realizando una carga de prueba en Frame para confirmar que los originales llegan a su S3 y los proxies aparecen en Frame.
Parte B: Añadir uno o más bloques S3 de solo lectura‑
Puede asociar bloques S3 adicionales como fuentes de solo lectura‑. Frame leerá objetos para la generación y reproducción de proxy, pero no escribirá nuevos objetos en estos bloques.
Elija sus bloques S3 adicionales (y prefijos de carpetas opcionales) para exponer en Frame.
Cree (o actualice) una función IAM utilizada por Frame para conceder acceso de solo lectura‑ a cada bloque/prefijo.
Ejemplo de estructura de política por bloque (ajustar los ARN/prefijos y añadirlos para cada bloque):
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ListReadOnlyBucket",
"Effect": "Allow",
"Action": ["s3:ListBucket"],
"Resource": "arn:aws:s3:::YOUR_RO_BUCKET"
},
{
"Sid": "ReadObjects",
"Effect": "Allow",
"Action": ["s3:GetObject", "s3:GetObjectVersion"],
"Resource": "arn:aws:s3:::YOUR_RO_BUCKET/*"
}
]
} Proporcione detalles a Frame.io: el mismo ARN de función (o ARN distintos por bloque), cada nombre de bloque y prefijo opcional que debe exponerse como de solo lectura.‑
Proceda a registrar los archivos existentes desde estos bloques de solo lectura utilizando la API ‑Import file (más abajo).
Parte C: Registrar objetos S3 existentes en Frame (API de importación)
Cuando se añade un bloque de solo lectura, los medios ya residen en S3. ‑Utilice el punto final Import File para registrar esos objetos S3 en sus proyectos/carpetas de Frame sin copiar los originales.
Qué hace la importación
Crea un recurso de archivo en Frame que apunta a su objeto S3.
Activa Frame para generar proxies para la navegación/reproducción.
Deja el archivo original en su lugar en su S3.
Antes de llamar a la API
Asegúrese de que las asignaciones de Storage Connect estén completas (Frame.io tiene su ARN de función, bloques y prefijos).
Disponga de un token OAuth con los ámbitos de archivo necesarios.
Identifique el contenedor de destino en Frame (raíz del proyecto o ID de recurso de carpeta) donde debe aparecer el archivo importado.
Identifique el bloque S3 y la clave de objeto que desea importar.
Ejemplo (pseudocódigo cURL)
Utilice la referencia oficial de la API para conocer la ruta y los campos exactos. La siguiente estructura ilustra la intención.
# PSEUDOCODE: consulte la documentación del punto final “Import File” para conocer la URL y el esquema exactos
curl -X POST "https://api.frame.io/v4/files.import_file" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"container_id": "<FRAME_FOLDER_OR_PROJECT_ASSET_ID>",
"external": {
"provider": "s3",
"bucket": "my-readonly-bucket",
"key": "Marketing/2025/hero.mov"
},
"display_name": "hero.mov"
}'
Verificación en Frame
Abra su Proyecto/carpeta de destino: los archivos importados aparecen como cualquier otro recurso.
La reproducción debería estar disponible inmediatamente una vez que los proxies terminen de generarse.
Compruebe los detalles del recurso para confirmar que la ubicación de almacenamiento es su S3.
Comportamiento y notas
Las cargas en cualquiera de los clientes de Frame (web para iOS, aplicación de transferencia, etc), van al bloque principal de lectura/escritura.
Los recursos importados de los bloques de solo lectura permanecen en su sitio; ‑eliminar un recurso en Frame no elimina el original en un bloque de solo lectura. ‑(Respete las políticas de eliminación de su organización en cuanto al bloque de lectura/escritura.)
Ciclo de vida/archivado: si los objetos se trasladan a Glacier o no están disponibles temporalmente, los proxies generados previamente pueden seguir permitiendo la navegación; la recuperación original dependerá del nivel de S3 y de la disponibilidad.
Solución de problemas
403/Acceso denegado durante la importación/reproducción → compruebe que la política de IAM incluye s3:GetObject para el ARN del objeto.
Objetos no descubiertos → confirme que la asignación de bloque/prefijo coincide con las claves de objeto que está importando.
Los proxies no se generan → confirme que el tipo de archivo es compatible y que IAM permite las lecturas; compruebe si hay errores transitorios de S3.
Limitación de velocidad durante la importación masiva → añada reintentos con retroceso exponencial; limite la concurrencia.
Preguntas frecuentes
P: ¿Cuántos bloques de solo lectura puedo añadir?
R: Cualquier cantidad. Asigne a cada bloque (y prefijos opcionales) permisos de solo lectura.
P: ¿Tengo que trasladar o copiar mi biblioteca actual a Frame?
R: No. Utilice la API Import File para registrarse in situ.
P: ¿Puedo quitar un bloque más tarde?
R: Sí. Al eliminar un bloque de solo lectura se elimina la publicación de esos recursos de Frame (sus originales permanecen en S3).
P: ¿Escribe Frame alguna vez en mis bloques de solo lectura?
R: No. Frame lee objetos para generar proxies y transmitir originales cuando es necesario; las escrituras solo se producen en el bloque principal de lectura/escritura.
Vínculos relacionados
Información general sobre Storage Connect (Centro de ayuda)
Anuncio de Storage Connect (blog de Frame.io Insider)
Esta guía refleja la funcionalidad más reciente de Storage Connect: un bloque principal de lectura/escritura más varios bloques de solo lectura, con registro a través de la API de Import File para poder trabajar en Frame sin duplicar originales.
Limitación importante: los bloques/objetos cifrados con SSE‑KMS no son compatibles con Storage Connect en este momento.