Risorse ed endpoint
È possibile utilizzare le risorse fornite tramite l'API REST di Astra Control per automatizzare una distribuzione Astra. Ogni risorsa è accessibile attraverso uno o più endpoint. Questa sezione fornisce un'introduzione alle risorse REST che è possibile utilizzare come parte della pianificazione di un'implementazione di automazione.
Il formato del percorso e dell'URL completo utilizzati per accedere alle risorse di Astra Control si basa su diversi valori. Vedere "Formato URL" per ulteriori informazioni. Vedere anche "Riferimento API" Per informazioni dettagliate sull'utilizzo delle risorse e degli endpoint Astra. |
Astra Control: Risorse REST ed endpoint
Gli endpoint delle risorse principali forniti nell'API REST di Astra Control sono organizzati in tre categorie. È possibile accedere a ciascuna risorsa con il set completo di operazioni CRUD (creazione, lettura, aggiornamento, eliminazione), salvo dove indicato.
La colonna Release indica la release Astra quando la risorsa è stata introdotta per la prima volta. Questo campo è in grassetto per le risorse aggiunte di recente con la release corrente.
Risorse di base
Gli endpoint principali delle risorse forniscono i servizi di base necessari per stabilire e mantenere l'ambiente di runtime Astra.
Risorsa | Rilasciare | Descrizione |
---|---|---|
ASUP |
21.08 |
Le risorse ASUP rappresentano i bundle AutoSupport inoltrati al supporto NetApp. |
Credenziale |
21.04 |
Le risorse delle credenziali contengono informazioni relative alla sicurezza che possono essere utilizzate con utenti Astra, cluster, bucket e backend di storage. |
Diritto |
21.08 |
Le risorse relative ai diritti rappresentano le funzionalità e le capacità disponibili per un account in base alle licenze e alle sottoscrizioni attive. |
Evento |
21.04 |
Le risorse degli eventi rappresentano tutti gli eventi che si verificano nel sistema, incluso il sottoinsieme classificato come notifiche. |
Funzione |
21.08 |
Le risorse delle funzioni rappresentano le funzioni Astra selezionate che è possibile interrogare per determinare se sono attivate o disattivate nel sistema. L'accesso è limitato alla sola lettura. |
Licenza |
21.08 |
Le risorse di licenza rappresentano le licenze disponibili per un account Astra. |
Notifica |
21.04 |
Le risorse di notifica rappresentano gli eventi Astra che hanno una destinazione di notifica. L'accesso viene fornito in base all'utente. |
Binding dei ruoli |
21.04 |
Le risorse di associazione dei ruoli rappresentano le relazioni tra coppie specifiche di utenti e account. Oltre al collegamento tra i due, viene specificato un set di autorizzazioni per ciascuno attraverso un ruolo specifico. |
Impostazione |
21.08 |
Le risorse di impostazione rappresentano un insieme di coppie chiave-valore che descrivono una funzionalità per un account Astra specifico. |
Iscrizione |
21.08 |
Le risorse di abbonamento rappresentano gli abbonamenti attivi per un account Astra. |
Token |
21.04 |
Le risorse token rappresentano i token disponibili per accedere a livello di programmazione all'API REST di Astra Control. |
Notifica non letta |
21.04 |
Le risorse di notifica non lette rappresentano le notifiche assegnate a un utente specifico ma non ancora lette. |
Utente |
21.04 |
Le risorse utente rappresentano gli utenti Astra in grado di accedere al sistema in base al proprio ruolo definito. |
Risorse applicative gestite
Gli endpoint delle risorse applicative gestite forniscono l'accesso alle applicazioni Kubernetes gestite.
Risorsa | Rilasciare | Descrizione |
---|---|---|
Risorsa applicativa |
21.04 |
Le risorse applicative rappresentano raccolte interne di informazioni di stato necessarie per gestire le applicazioni Astra. |
Backup dell'applicazione |
21.04 |
Le risorse di backup delle applicazioni rappresentano i backup delle applicazioni gestite. |
Snapshot dell'applicazione |
21.04 |
Le risorse di snapshot delle applicazioni rappresentano snapshot delle applicazioni gestite. |
Applicazione gestita |
21.04 |
Le risorse di applicazioni gestite rappresentano le applicazioni Kubernetes gestite da Astra. |
Pianificazione |
21.04 |
Le risorse di pianificazione rappresentano le operazioni di protezione dei dati pianificate per le applicazioni gestite come parte di una policy di protezione dei dati. |
Risorse per la topologia
Gli endpoint delle risorse di topologia forniscono l'accesso alle applicazioni non gestite e alle risorse di storage.
Risorsa | Rilasciare | Descrizione |
---|---|---|
App |
21.04 |
Le risorse applicative rappresentano tutte le applicazioni Kubernetes, incluse quelle non gestite da Astra. |
Bucket |
21.08 |
Le risorse del bucket rappresentano i bucket cloud S3 utilizzati per memorizzare i backup delle applicazioni gestite da Astra. |
Cloud |
21.08 |
Le risorse cloud rappresentano i cloud a cui i client Astra possono connettersi per gestire cluster e applicazioni. |
Cluster |
21.08 |
Le risorse del cluster rappresentano i cluster Kubernetes non gestiti da Kubernetes. |
Cluster gestito |
21.08 |
Le risorse del cluster gestito rappresentano i cluster Kubernetes attualmente gestiti da Kubernetes. |
Back-end dello storage |
21.08 |
Le risorse di back-end dello storage rappresentano i provider di servizi di storage che possono essere utilizzati dai cluster e dalle applicazioni gestiti da Astra. |
Classe di storage |
21.08 |
Le risorse della classe di storage rappresentano classi o tipi diversi di storage rilevati e disponibili per uno specifico cluster gestito. |
Volume |
21.04 |
Le risorse dei volumi rappresentano i volumi di storage Kubernetes associati alle applicazioni gestite. |
Risorse ed endpoint aggiuntivi
Esistono diverse risorse aggiuntive e endpoint che è possibile utilizzare per supportare un'implementazione Astra.
Queste risorse e questi endpoint non sono attualmente inclusi nella documentazione di riferimento dell'API REST di Astra Control. |
- OpenAPI
-
Gli endpoint OpenAPI forniscono l'accesso al documento JSON OpenAPI corrente e ad altre risorse correlate.
- OpenMetrics
-
Gli endpoint OpenMetrics forniscono l'accesso alle metriche dell'account attraverso la risorsa OpenMetrics. Il supporto è disponibile con il modello di implementazione di Astra Control Center.