Risorse ed endpoint
Suggerisci modifiche
PDF
È 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. Le informazioni presentate di seguito forniscono un'introduzione alle risorse RIMANENTI che è possibile utilizzare come parte 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 ulteriori informazioni sull'utilizzo delle risorse e degli endpoint Astra. |
Riepilogo delle risorse REST di Astra Control
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 |
|---|---|---|
Account |
21.12 |
Le risorse dell'account consentono di gestire i tenant isolati all'interno dell'ambiente di implementazione di Astra Control multi-tenant. |
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. |
Gancio di esecuzione |
21.12 |
Le risorse di esecuzione hook rappresentano script personalizzati che è possibile eseguire prima o dopo l'esecuzione di uno snapshot di un'applicazione gestita. |
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. |
Origine gancio |
21.12 |
Le risorse di origine hook rappresentano il codice di origine effettivo utilizzato con un gancio di esecuzione. La separazione del codice sorgente dal controllo di esecuzione offre diversi vantaggi, ad esempio la possibilità di condividere gli script. |
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. |
Pacchetto |
22.04 |
Le risorse del pacchetto forniscono la registrazione e l'accesso alle definizioni dei pacchetti. I pacchetti software sono composti da vari componenti, tra cui file, immagini e altri elementi. |
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. |
Eseguire l'upgrade |
22.04 |
Le risorse di aggiornamento forniscono l'accesso ai componenti software e la possibilità di avviare gli aggiornamenti. |
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. |
Override del gancio di esecuzione |
21.12 |
Le risorse di override degli uncini di esecuzione consentono di disattivare gli uncini di esecuzione predefiniti NetApp precaricati per applicazioni specifiche in base alle necessità. |
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. |
Nodo del cluster |
21.12 |
Le risorse dei nodi del cluster forniscono una risoluzione aggiuntiva consentendo di accedere ai singoli nodi all'interno di un cluster Kubernetes. |
Cluster gestito |
21.08 |
Le risorse del cluster gestito rappresentano i cluster Kubernetes attualmente gestiti da Kubernetes. |
Back-end di storage gestito |
21.12 |
Le risorse di back-end dello storage gestito consentono di accedere alle rappresentazioni astratte dei provider di storage back-end. Questi backend di storage possono essere utilizzati dai cluster e dalle applicazioni gestiti. |
Namespace |
21.12 |
Le risorse dello spazio dei nomi forniscono l'accesso agli spazi dei nomi utilizzati all'interno di un cluster 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. |
Nuovi endpoint con la release corrente
I seguenti endpoint REST sono stati aggiunti con l'attuale release 22.04 di Astra Control. Inoltre, le versioni di diverse risorse esistenti sono state aggiornate.
-
/accounts/{account_id}/core/v1/packages
-
/accounts/{account_id}/core/v1/packages/{package_id}
-
/accounts/{account_id}/core/v1/upgrade
-
/accounts/{account_id}/core/v1/upgrades//{upgrade_id}
-
/Accounts/{account_id}/topology/v1/appBackups
-
/Accounts/{account_id}/topology/v1/appBackups/{appBackup_id}
-
/Accounts/{account_id}/topology/v1/cloud/{cloud_id}/clusterNodes/{cluster_id}/clusterNodes
-
/Accounts/{account_id}/topology/v1/cloud/{cloud_id}/clusterNode/{clusterNode_id}{}
-
/Accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/apps/{app_id}/appAssets
-
/Accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/apps/{app_id}/appAssets/{appAsset_id}
-
/Accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/clusterNodes
-
/Accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/clusterNodes/{clusterNode_id}
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.