Comprendere l'API di gestione degli inquilini
È possibile eseguire attività di gestione del sistema utilizzando l'API REST di Tenant Management anziché l'interfaccia utente di Tenant Manager. Ad esempio, potresti voler utilizzare l'API per automatizzare le operazioni o per creare più entità, come gli utenti, più rapidamente.
API di gestione degli inquilini:
-
Utilizza la piattaforma API open source Swagger. Swagger fornisce un'interfaccia utente intuitiva che consente agli sviluppatori e ai non sviluppatori di interagire con l'API. L'interfaccia utente di Swagger fornisce dettagli e documentazione completi per ogni operazione API.
-
Usi"controllo delle versioni per supportare aggiornamenti non distruttivi" .
Per accedere alla documentazione Swagger per l'API di gestione tenant:
-
Sign in a Tenant Manager.
-
Nella parte superiore di Tenant Manager, seleziona l'icona della guida e seleziona Documentazione API.
operazioni API
L'API di gestione degli inquilini organizza le operazioni API disponibili nelle seguenti sezioni:
-
account: Operazioni sull'account del tenant corrente, incluso l'ottenimento di informazioni sull'utilizzo dello spazio di archiviazione.
-
auth: Operazioni per eseguire l'autenticazione della sessione utente.
L'API di gestione tenant supporta lo schema di autenticazione Bearer Token. Per l'accesso del tenant, è necessario fornire un nome utente, una password e un accountId 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 successive richieste API ("Authorization: Bearer token").Per informazioni su come migliorare la sicurezza dell'autenticazione, vedere"Protezione contro la falsificazione delle richieste tra siti" .
Se per il sistema StorageGRID è abilitato l'accesso Single Sign-On (SSO), è necessario eseguire passaggi diversi per l'autenticazione. Vedi il"istruzioni per l'utilizzo dell'API di gestione della griglia" . -
config: Operazioni relative alla versione del prodotto e alle versioni dell'API di gestione tenant. È possibile elencare la versione del prodotto e le principali versioni dell'API supportate da tale versione.
-
contenitori: operazioni su bucket S3 o contenitori Swift.
-
deactivated-features: Operazioni per visualizzare le funzionalità 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 StorageGRID CloudMirror.
-
grid-federation-connections: Operazioni sulle connessioni della federazione di griglia e sulla replicazione tra griglie.
-
gruppi: operazioni per gestire gruppi di tenant locali e per recuperare gruppi di tenant federati da una fonte di identità esterna.
-
identity-source: Operazioni per configurare una fonte di identità esterna e per sincronizzare manualmente le informazioni sui gruppi federati e sugli utenti.
-
ilm: Operazioni sulle impostazioni di gestione del ciclo di vita delle informazioni (ILM).
-
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 tenant.
-
s3-object-lock: Operazioni sulle impostazioni globali di S3 Object Lock, utilizzate per supportare la conformità normativa.
-
utenti: operazioni per visualizzare e gestire gli utenti tenant.
Dettagli dell'operazione
Espandendo ogni operazione API, è possibile visualizzare la relativa azione HTTP, l'URL dell'endpoint, un elenco di eventuali parametri obbligatori o facoltativi, un esempio del corpo della richiesta (quando richiesto) e le possibili risposte.

Inviare richieste API
|
Tutte le operazioni API eseguite tramite la pagina web Documentazione API sono operazioni live. Fare attenzione a non creare, aggiornare o eliminare per errore dati di configurazione o altri dati. |
-
Selezionare l'azione HTTP per visualizzare i dettagli della richiesta.
-
Determina se la richiesta richiede parametri aggiuntivi, come un gruppo o un ID utente. Quindi, ottieni questi valori. Potrebbe essere necessario inviare prima una richiesta API diversa per ottenere le informazioni necessarie.
-
Determina se è necessario modificare il corpo della richiesta di esempio. In tal caso, puoi selezionare Modello per conoscere i requisiti per ciascun campo.
-
Seleziona Provalo.
-
Fornire tutti i parametri richiesti o modificare il corpo della richiesta come richiesto.
-
Selezionare Esegui.
-
Esaminare il codice di risposta per determinare se la richiesta è andata a buon fine.