Storage Connect per Frame.io: registrazione delle risorse

Storage Connect consente alla clientela Enterprise di Frame.io di utilizzare il proprio endpoint di archiviazione cloud come archiviazione di supporto di Frame.io.Attualmente, quando un utente carica una risorsa su Frame.io, tale risorsa passa attraverso lo stack dell’applicazione e viene archiviata nel bucket Amazon S3 di Frame.io. Analogamente, la riproduzione e la distribuzione di una risorsa vengono supportate da un bucket Amazon S3 gestito da Frame.io.

Utilizza il tuo AWS S3 come fonte autorevole di contenuti, mantenendo Frame.io come unica superficie per esplorare, cercare, condividere e rivedere.Ora puoi connettere:

Un bucket S3 principale (lettura/scrittura), dove arrivano i nuovi caricamenti da Frame.io.
Qualsiasi numero di bucket S3 aggiuntivi (sola‑lettura), che rendono visibili e riproducibili in Frame.io i contenuti multimediali esistenti in S3 senza copiare o duplicare gli originali.

Frame.io genera proxy leggeri (miniature, anteprime, riproduzione) mentre gli originali rimangono nel tuo S3. Per registrare i file già presenti nei bucket connessi, utilizza l’endpoint API pubblica V4: importa file.

Nota: questa offerta è disponibile sia per la nuova clientela che per quella esistente di Frame.io che utilizza Storage Connect.Per chi è già cliente di Frame.io, è possibile eseguire una migrazione una tantum dei propri dati, archiviati storicamente nel bucket Amazon S3 gestito da Frame.io, verso il bucket Amazon S3 gestito dal cliente, disponibile per l’uso generale.

Le informazioni riportate di seguito forniscono a chi già usa Frame.io e a chi inizia ora una guida dettagliata per configurare il bucket S3 in modo che sia compatibile con Storage Connect.

Prerequisiti

Account Frame.ioEnterprise conStorage Connect abilitato per la tua organizzazione.
Accesso per creare/aggiornare ruoli/criteri AWS IAM e autorizzazioni perbucket S3.
Accesso all’API pubblica Frame.io V4 (per l’endpoint Importa file utilizzato per registrare oggetti esistenti da bucket di sola‑lettura).

Nota: per la configurazione esatta di IAM trust e la mappatura dell’account, il tuo contatto Frame.io (CSM/specialista di implementazione) fornirà la configurazione OIDC/ruolo corrente e convaliderà le autorizzazioni durante l’onboarding.

Concetti chiave

Bucket principale (lettura/scrittura): il bucket S3 che riceve gli originali quando gli utenti caricano su Frame. Il frame richiede autorizzazioni di lettura + scrittura qui.
Bucket di sola‑lettura: uno o più bucket S3 che Frame può leggere, ma non scrivere.Le risorse vengono rese visibili in Frame chiamando l’API Importa file (nessuna copia degli originali).
Proxy: Frame genera derivati (miniature, anteprime e proxy di streaming) in modo che le risorse siano riproducibili in Frame anche se gli originali rimangono nel tuo S3.

Parte A: configurare il bucket S3 di lettura/scrittura principale

Scegli o crea il bucket S3 che utilizzerai come archiviazione principale.

Crea un ruolo IAM per Frame.io (considerato attendibile dal provider di identità Frame.io) e allega un criterio IAM che conceda lettura/scrittura al bucket/prefisso.

Esempio di schema di criteri (sostituisci gli ARN e limita ai prefissi richiesti, ove possibile):

{ 
  "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/*" 
    } 
  ] 
}

Fornisci dettagli a Frame.io: l’ARN del ruolo IAM, il nome del bucket e tutti i prefissi degli oggetti preferiti. Frame.io completerà la mappatura in modo che i caricamenti dei tuoi utenti in Frame siano destinati a questo bucket.
Convalida eseguendo un caricamento di prova in Frame per confermare che gli originali siano arrivati nel tuo S3 e che i proxy vengano visualizzati in Frame.

Parte B: aggiungere uno o più bucket S3 di sola‑lettura

Puoi associare bucket S3 aggiuntivi come sorgenti di sola lettura‑. Il frame leggerà gli oggetti per la generazione e la riproduzione del proxy, ma non scriverà nuovi oggetti in questi bucket.

Scegli i tuoi bucket S3 aggiuntivi (e i prefissi delle cartelle facoltative) da esporre in Frame.
Crea (o aggiorna) un ruolo IAM utilizzato da Frame per concedere l’accesso in sola‑lettura a ciascun bucket/prefisso.

Esempio di schema de criteri per bucket (modifica ARN/prefissi e aggiungi per ciascun bucket):

{  
  "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/*"  
    }  
  ]  
}

Fornire dettagli a Frame.io: lo stesso ARN del ruolo (o ARN distinti per bucket), ogni nome del bucket e prefisso facoltativo che deve essere esposto come sola‑lettura.
Procedi alla registrazione dei file esistenti da questi bucket di sola‑lettura utilizzando l’API Importa file (di seguito).

Parte C: registrare oggetti S3 esistenti in Frame (API di importazione)

Quando aggiungi un bucket di sola‑lettura, i tuoi contenuti multimediali sono già presenti in S3. Utilizza l’endpoint Importa file per registrare gli oggetti S3 in progetti/cartelle Frame senza copiare gli originali.

Cosa fa l’importazione

Crea una risorsa File in Frame chepunta al tuo oggetto S3.
Attiva Frame per generare proxy per la navigazione/riproduzione.
Lascia il file originale al suo posto nel tuo S3.

Prima di chiamare l’API è necessario:

Assicurarsi che le mappature di Storage Connect siano complete (Frame.io dispone del tuo ruolo ARN, dei bucket e dei prefissi).
Disporre di un token OAuth con gli ambiti file richiesti.
Identificare il contenitore della destinazione in Frame (radice del progetto o ID risorsa cartella) in cui deve apparire il file importato.
Identificare il bucket S3 e la chiave oggetto da importare.

Esempio (pseudocodice cURL)

Per il percorso e i campi esatti, utilizza il riferimento API ufficiale.La struttura sottostante illustra l’intento.

# PSEUDOCODE: vedi la documentazione dell’endpoint “Importa file” per l’URL e lo schema esatti

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

Verificare in Frame

Apri la destinazione Progetto/cartella: i file importati compaiono come qualsiasi altra risorsa.
La riproduzione dovrebbe essere immediatamente disponibile una volta che iproxy hanno terminato la generazione.
Controlla i dettagli della risorsa per confermare che la posizione di archiviazione è il tuo S3.

Comportamento e note

Icaricamenti in un qualsiasi client Frame (web iOS, app di trasferimento, ecc.) vanno al bucket di lettura/scrittura principale.
Le risorse importate dai bucket di sola‑lettura rimangono al loro posto; l’eliminazione di una risorsa in Frame non elimina l’originale in un bucket di sola‑lettura. (Rispettare i criteri di eliminazione della propria organizzazione per il bucket di lettura/scrittura.)
Ciclo di vita/archiviazione: se gli oggetti vengono spostati su Glacier o sono temporaneamente non disponibili, i proxy generati in precedenza potrebbero continuare a consentire la navigazione; il recupero originale dipenderà dal livello S3 e dalla disponibilità.

Risoluzione dei problemi

403/AccessDenied durante l’importazione/riproduzione → verifica che il criterio IAM includa s3:GetObject per l’ARN dell’oggetto.
Oggetti non rilevati → conferma che la mappatura del bucket/prefisso corrisponda alle chiavi dell’oggetto che si stanno importando.
Proxy non generati → conferma che il tipo di file sia supportato e che IAM consenta le letture; verifica la presenza di errori S3 temporanei.
Limitazione della frequenza sull’importazione in blocco → aggiungi tentativo con backoff esponenziale; limita la concorrenza.

Domande frequenti

D: Quanti bucket di sola‑lettura posso aggiungere?

R:Qualsiasi numero. Mappa ogni bucket (e i prefissi facoltativi) con autorizzazioni di sola‑lettura.

D: Devo spostare o copiare la mia libreria esistente in Frame?

R: No. Utilizza l’API Importa file per registrarti sul posto.

D: Posso rimuovere un bucket in un secondo momento?

R: Sì. La rimozione di un bucket di sola‑lettura annulla la pubblicazione di tali risorse da Frame (gli originali rimangono in S3).

D: Frame scrive mai nei miei bucket di sola‑lettura?

R: No. Il frame legge gli oggetti per generare proxy e trasmettere in streaming gli originali quando necessario; le scritture avvengono solo sul bucket di lettura/scrittura principale.

Collegamenti correlati

Panoramica di Storage Connect (centro assistenza)
Annuncio di Storage Connect(blog Frame.io Insider)
Riferimento API Frame.io V4: endpoint Importa file
Documentazione AWS S3 e IAM per i criteri dei bucket

Questa guida riflette le più recenti funzionalità di Storage Connect: un bucket di lettura/scrittura principale con più bucket di sola‑lettura, con registrazione tramite l’API Importa file, in modo da poter lavorare in Frame senza duplicare gli originali.

Limitazione importante: al momento i bucket/oggetti crittografati con SSE‑KMS non sono supportati da Storage Connect.