Comprendere l'API di gestione dei tenant
-
PDF del sito di questa documentazione
-
Installazione e manutenzione dell'hardware dell'appliance
-
Appliance di servizi SG100 e SG1000
-
Appliance di storage SG6000
-
Appliance di storage SG5700
-
-
Installare e aggiornare il software
-
Eseguire l'amministrazione del sistema
-
Amministrare StorageGRID
-
-
USA StorageGRID
-
Monitorare e gestire StorageGRID
-
Ripristino e manutenzione
-
Procedure di ripristino del nodo Grid
-
-
-
![](/it-it/storagegrid-116/images/pdf-zip.png)
Raccolta di documenti PDF separati
Creating your file...
È possibile eseguire attività di gestione del sistema utilizzando l'API REST di Tenant Management invece dell'interfaccia utente di Tenant Manager. Ad esempio, è possibile utilizzare l'API per automatizzare le operazioni o creare più entità, ad esempio gli utenti, più rapidamente.
L'API di gestione dei tenant:
-
Utilizza la piattaforma API open source Swagger. Swagger offre un'interfaccia utente intuitiva che consente a sviluppatori e non sviluppatori di interagire con l'API. L'interfaccia utente di Swagger fornisce dettagli completi e documentazione per ogni operazione API.
-
Utilizzi versione per supportare aggiornamenti senza interruzioni.
Per accedere alla documentazione Swagger per l'API di gestione tenant:
-
Accedi al tenant manager.
-
Nella parte superiore di Tenant Manager, selezionare l'icona della guida e selezionare documentazione API.
Operazioni API
L'API di gestione tenant organizza le operazioni API disponibili nelle seguenti sezioni:
-
Account — operazioni sull'account tenant corrente, incluso il recupero delle informazioni sull'utilizzo dello storage.
-
Auth — operazioni per eseguire l'autenticazione della sessione utente.
L'API di gestione tenant supporta lo schema di autenticazione del token del bearer. Per l'accesso del tenant, immettere un nome utente, una password e un ID account nel corpo JSON della richiesta di autenticazione (ovvero
POST /api/v3/authorize
). Se l'utente viene autenticato correttamente, viene restituito un token di sicurezza. Questo token deve essere fornito nell'intestazione delle richieste API successive ("autorizzazione: Token portante").Per informazioni su come migliorare la protezione dell'autenticazione, vedere Protezione contro la falsificazione di richieste cross-site.
Se per il sistema StorageGRID è attivato il Single Sign-on (SSO), è necessario eseguire diversi passaggi per l'autenticazione. Vedere Istruzioni per l'utilizzo dell'API Grid Management. -
Config — operazioni relative alla release del prodotto e alle versioni dell'API di gestione tenant. È possibile elencare la versione di release del prodotto e le principali versioni dell'API supportate da tale release.
-
Containers — operazioni su bucket S3 o container Swift, come segue:
S3
-
Create bucket (con e senza S3 Object Lock abilitato)
-
Modifica la conservazione predefinita del bucket (per bucket con blocco oggetti S3 attivato)
-
Impostare il controllo di coerenza per le operazioni eseguite sugli oggetti
-
Creare, aggiornare ed eliminare la configurazione CORS di un bucket
-
Attiva e disattiva gli ultimi aggiornamenti dell'orario di accesso per gli oggetti
-
Gestire le impostazioni di configurazione per i servizi della piattaforma, tra cui replica CloudMirror, notifiche e integrazione della ricerca (notifica dei metadati)
-
Eliminare i bucket vuoti
Swift: Consente di impostare il livello di coerenza utilizzato per i container
-
-
Disattivato-funzioni — operazioni per visualizzare le funzioni che potrebbero essere state disattivate.
-
Endpoint — operazioni per gestire un endpoint. Gli endpoint consentono a un bucket S3 di utilizzare un servizio esterno per la replica, le notifiche o l'integrazione della ricerca di StorageGRID CloudMirror.
-
Groups — operazioni per gestire gruppi di tenant locali e recuperare gruppi di tenant federati da un'origine di identità esterna.
-
Identity-source — operazioni per configurare un'origine di identità esterna e sincronizzare manualmente le informazioni di utenti e gruppi federati.
-
Regioni — operazioni per determinare quali regioni sono state configurate per il sistema StorageGRID.
-
s3 — operazioni per gestire le chiavi di accesso S3 per gli utenti del tenant.
-
s3-Object-lock — operazioni sulle impostazioni globali S3 Object Lock, utilizzate per supportare la conformità alle normative.
-
Utenti — operazioni per visualizzare e gestire gli utenti del tenant.
Dettagli dell'operazione
Quando si espandono le operazioni API, è possibile visualizzare l'azione HTTP, l'URL dell'endpoint, un elenco di eventuali parametri obbligatori o facoltativi, un esempio del corpo della richiesta (se necessario) e le possibili risposte.
![Esempio che mostra l'operazione GET groups nell'API Swagger](../media/tenant_api_swagger_example.gif)
Emettere richieste API
|
Tutte le operazioni API eseguite utilizzando la pagina web API Docs sono operazioni live. Fare attenzione a non creare, aggiornare o eliminare per errore i dati di configurazione o altri dati. |
-
Selezionare l'azione HTTP per visualizzare i dettagli della richiesta.
-
Determinare se la richiesta richiede parametri aggiuntivi, ad esempio un ID utente o un gruppo. Quindi, ottenere questi valori. Potrebbe essere necessario emettere prima una richiesta API diversa per ottenere le informazioni necessarie.
-
Determinare se è necessario modificare il corpo della richiesta di esempio. In tal caso, è possibile selezionare modello per conoscere i requisiti di ciascun campo.
-
Selezionare Provalo.
-
Fornire i parametri richiesti o modificare il corpo della richiesta secondo necessità.
-
Selezionare Esegui.
-
Esaminare il codice di risposta per determinare se la richiesta ha avuto esito positivo.