Endpoint API Swift supportati
Suggerisci modifiche
PDF
StorageGRID supporta i seguenti endpoint API Swift: URL info, URL auth e URL storage.
URL info
È possibile determinare le funzionalità e i limiti dell'implementazione di Swift di StorageGRID inviando una richiesta GET all'URL di base di Swift con il percorso /info.
https://FQDN | Node IP:Swift Port/info/
Nella richiesta:
-
FQDNè il nome di dominio completo. -
Node IPÈ l'indirizzo IP del nodo di storage o del nodo gateway sulla rete StorageGRID. -
Swift PortÈ il numero di porta utilizzato per le connessioni API Swift sul nodo di storage o sul nodo gateway.
Ad esempio, il seguente URL info richiede informazioni a un nodo di storage con l'indirizzo IP 10.99.106.103 e utilizzando la porta 18083.
https://10.99.106.103:18083/info/
La risposta include le funzionalità dell'implementazione di Swift come dizionario JSON. Uno strumento client può analizzare la risposta JSON per determinare le funzionalità dell'implementazione e utilizzarle come vincoli per le successive operazioni di storage.
L'implementazione StorageGRID di Swift consente l'accesso non autenticato all'URL delle informazioni.
URL di autenticazione
Un client può utilizzare l'URL auth di Swift per l'autenticazione come utente di un account tenant.
https://FQDN | Node IP:Swift Port/auth/v1.0/
Specificare l'ID account tenant, il nome utente e la password come parametri in X-Auth-User e. X-Auth-Key intestazioni delle richieste, come segue:
X-Auth-User: Tenant_Account_ID:Username
X-Auth-Key: Password
Nelle intestazioni della richiesta:
-
Tenant_Account_IDÈ l'ID account assegnato da StorageGRID al momento della creazione del tenant Swift. Si tratta dello stesso ID account tenant utilizzato nella pagina di accesso di Tenant Manager. -
UsernameÈ il nome di un utente tenant creato in Tenant Manager. Questo utente deve appartenere a un gruppo che dispone dell'autorizzazione di amministratore Swift. L'utente root del tenant non può essere configurato per utilizzare l'API REST Swift.Se Identity Federation è abilitato per l'account tenant, fornire il nome utente e la password dell'utente federated dal server LDAP. In alternativa, fornire il nome di dominio dell'utente LDAP. Ad esempio:
X-Auth-User: Tenant_Account_ID:Username@Domain_Name -
Passwordè la password per l'utente tenant. Le password utente vengono create e gestite in Tenant Manager.
La risposta a una richiesta di autenticazione riuscita restituisce un URL di storage e un token di autenticazione, come segue:
X-Storage-Url: https://FQDN | Node_IP:Swift_Port/v1/Tenant_Account_ID
X-Auth-Token: token
X-Storage-Token: token
Per impostazione predefinita, il token è valido per 24 ore dal momento della generazione.
I token vengono generati per un account tenant specifico. Un token valido per un account non autorizza un utente ad accedere a un altro account.
URL dello storage
Un'applicazione client può eseguire chiamate API SWIFT REST per eseguire operazioni di account, container e oggetti supportate su un nodo gateway o un nodo di storage. Le richieste di storage vengono indirizzate all'URL dello storage restituito nella risposta di autenticazione. La richiesta deve includere anche l'intestazione X-Auth-Token e il valore restituito dalla richiesta auth.
https://FQDN | IP:Swift_Port/v1/Tenant_Account_ID
[/container][/object]
X-Auth-Token: token
Alcune intestazioni di risposta dello storage che contengono statistiche di utilizzo potrebbero non riflettere numeri precisi per gli oggetti modificati di recente. Potrebbero essere necessari alcuni minuti per visualizzare numeri precisi in queste intestazioni.
Le seguenti intestazioni di risposta per le operazioni di account e container sono esempi di quelle che contengono statistiche di utilizzo:
-
X-Account-Bytes-Used -
X-Account-Object-Count -
X-Container-Bytes-Used -
X-Container-Object-Count