Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Risorse ed endpoint

Collaboratori

È 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.

Nota 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.

Nota 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.