Ressourcen und Endpunkte
Änderungen vorschlagen
PDFs
Sie können die Ressourcen, die über die Astra Control REST-API bereitgestellt werden, nutzen, um eine Astra Implementierung zu automatisieren. Jede Ressource ist über einen oder mehrere Endpunkte zugänglich. Die folgenden Informationen bieten eine Einführung in DIE REST-Ressourcen, die Sie im Rahmen einer Automatisierungsimplementierung nutzen können.
|
Das Format des Pfads und der vollständigen URL für den Zugriff auf die Astra Control-Ressourcen basiert auf mehreren Werten. Siehe "URL-Format" Finden Sie weitere Informationen. Siehe auch "API-Referenz" Weitere Informationen zur Verwendung der Astra-Ressourcen und -Endpunkte. |
Zusammenfassung der Astra Control REST-Ressourcen
Die primären Ressourcenendpunkte in der Astra Control REST API sind in drei Kategorien unterteilt. Auf jede Ressource kann mit allen CRUD-Vorgängen (Erstellen, Lesen, Aktualisieren, Löschen) zugegriffen werden, sofern nicht anders angegeben.
Die Spalte Release zeigt den Astra-Release an, als die Ressource zum ersten Mal eingeführt wurde. Dieses Feld ist für Ressourcen verfügbar, die mit der aktuellen Version neu hinzugefügt wurden.
Kernressourcen
Die Kernressourcenendpunkte bieten die grundlegenden Services, die zum Aufbau und zur Wartung der Astra-Laufzeitumgebung erforderlich sind.
| Ressource | Freigabe | Beschreibung |
|---|---|---|
Konto |
21.12 |
Mithilfe der Account-Ressourcen können Sie die isolierten Mandanten innerhalb der mandantenfähigen Astra Control Implementierungsumgebung managen. |
ASUP |
21.08 |
Die ASUP Ressourcen stellen die AutoSupport Bundles dar, die an den NetApp Support weitergeleitet werden. |
Anmeldedaten |
21.04 |
Die Ressourcen für Zugangsdaten enthalten sicherheitsbezogene Informationen, die mit Astra-Benutzern, Clustern, Buckets und Storage-Back-Ends verwendet werden können. |
Berechtigung |
21.08 |
Die Berechtigungsressourcen stellen die Funktionen und Kapazitäten dar, die für ein Konto auf Basis der aktiven Lizenzen und Abonnements verfügbar sind. |
Ereignis |
21.04 |
Die Event-Ressourcen repräsentieren alle Ereignisse, die im System auftreten, einschließlich der Untergruppe, die als Benachrichtigungen klassifiziert ist. |
Execution Hook |
21.12 |
Die Hook-Ressourcen für die Ausführung stellen benutzerdefinierte Skripts dar, die Sie entweder vor oder nach einem Snapshot einer verwalteten App ausführen können. |
Merkmal |
21.08 |
Die Funktionsressourcen stellen ausgewählte Astra-Funktionen dar, die Sie abfragen können, um festzustellen, ob diese im System aktiviert oder deaktiviert sind. Der Zugriff ist auf schreibgeschützt beschränkt. |
Hook-Quelle |
21.12 |
Die Hakenquellenressourcen stellen den aktuellen Quellcode dar, der mit einem Testsuite verwendet wird. Die Trennung des Quellcodes von der Ausführungskontrolle hat mehrere Vorteile, wie z. B. die Freigabe der Skripte. |
Lizenz |
21.08 |
Die Lizenzressourcen stellen die für ein Astra-Konto verfügbaren Lizenzen dar. |
Benachrichtigung |
21.04 |
Die Benachrichtigungsressourcen sind Astra-Ereignisse mit einem Benachrichtigungsziel. Der Zugriff erfolgt auf Benutzerbasis. |
Paket |
22.04 |
Die Paketressourcen ermöglichen die Registrierung und den Zugriff auf Paketdefinitionen. Softwarepakete bestehen aus verschiedenen Komponenten, einschließlich Dateien, Bildern und anderen Artefakten. |
Rollenbindung |
21.04 |
Die Role Binding Ressourcen stellen die Beziehungen zwischen bestimmten Paaren von Benutzern und Konten dar. Zusätzlich zur Verknüpfung zwischen den beiden wird für jede über eine bestimmte Rolle ein Satz von Berechtigungen festgelegt. |
Einstellung |
21.08 |
Die Einstellungsressourcen stellen eine Sammlung von Schlüsselwert-Paaren dar, die ein Feature für ein bestimmtes Astra-Konto beschreiben. |
Abonnement |
21.08 |
Die Abonnementressourcen stellen die aktiven Abonnements für ein Astra-Konto dar. |
Token |
21.04 |
Die Token-Ressourcen stellen die Token dar, die für den programmatischen Zugriff auf die Astra Control REST API verfügbar sind. |
Ungelesene Benachrichtigung |
21.04 |
Die nicht gelesenen Benachrichtigungsressourcen stellen Benachrichtigungen dar, die einem bestimmten Benutzer zugewiesen, aber noch nicht gelesen wurden. |
Upgrade |
22.04 |
Die Upgrade-Ressourcen bieten Zugriff auf Softwarekomponenten und können Upgrades initiieren. |
Benutzer |
21.04 |
Die Benutzerressourcen sind Astra-Benutzer, die auf das System basierend auf ihrer definierten Rolle zugreifen können. |
Gemanagte Applikationsressourcen
Die Endpunkte der gemanagten Applikationsressourcen bieten Zugriff auf die gemanagten Kubernetes-Applikationen.
| Ressource | Freigabe | Beschreibung |
|---|---|---|
Anwendungsressource |
21.04 |
Die Anwendungsressourcen stellen interne Sammlungen von staatlichen Informationen dar, die für das Management der Astra-Anwendungen erforderlich sind. |
Applikations-Backup |
21.04 |
Die Backup-Ressourcen der Applikation stellen Backups der gemanagten Applikationen dar. |
Anwendungs-Snapshot |
21.04 |
Die Snapshot-Ressourcen der Anwendung stellen Snapshots der verwalteten Anwendungen dar. |
Überschreiben des Testablaufanhängehaken |
21.12 |
Über die Ressourcen zum Überschreiben der Execution Hooks können Sie die vorab geladenen NetApp Standard-Testausführungshaken für bestimmte Applikationen nach Bedarf deaktivieren. |
Gemanagte Applikation |
21.04 |
Die gemanagten App-Ressourcen stellen Kubernetes-Applikationen dar, die von Astra gemanagt werden. |
Zeitplan |
21.04 |
Die Zeitplanressourcen sind Datensicherungsvorgänge, die im Rahmen einer Datenschutzrichtlinie für die gemanagten Applikationen geplant sind. |
Topologieressourcen
Die Endpunkte der Topologieressourcen bieten Zugriff auf nicht verwaltete Applikationen und Storage-Ressourcen.
| Ressource | Freigabe | Beschreibung |
|---|---|---|
App. |
21.04 |
Die App-Ressourcen umfassen alle Kubernetes-Applikationen, auch die, die nicht von Astra gemanagt werden. |
Eimer |
21.08 |
Die Bucket-Ressourcen sind die S3-Cloud-Buckets, die für die Speicherung von Backups der vom Astra gemanagten Applikationen verwendet werden. |
Cloud |
21.08 |
Die Cloud-Ressourcen stellen Clouds dar, mit denen Astra-Clients verbunden werden können, um Cluster und Applikationen zu managen. |
Cluster |
21.08 |
Die Cluster-Ressourcen stellen die Kubernetes-Cluster dar, die nicht von Kubernetes gemanagt werden. |
Cluster-Node |
21.12 |
Die Cluster-Node-Ressourcen bieten eine zusätzliche Auflösung, durch die Sie auf die einzelnen Nodes innerhalb eines Kubernetes-Clusters zugreifen können. |
Verwalteter Cluster |
21.08 |
Die gemanagten Cluster-Ressourcen stellen die Kubernetes-Cluster dar, die derzeit von Kubernetes gemanagt werden. |
Gemanagtes Storage-Back-End |
21.12 |
Die gemanagten Storage-Backend-Ressourcen ermöglichen Ihnen den Zugriff auf abstrahierte Darstellungen der Back-End-Storage-Anbieter. Diese Storage-Back-Ends können von den gemanagten Clustern und Applikationen verwendet werden. |
Namespace |
21.12 |
Die Namespace-Ressourcen bieten Zugriff auf die innerhalb eines Kubernetes-Clusters verwendeten Namespaces. |
Storage-Back-End |
21.08 |
Die Storage-Back-End-Ressourcen stellen Anbieter von Storage-Services dar, die von den von Astra gemanagten Clustern und Applikationen verwendet werden können. |
Storage-Klasse |
21.08 |
Ressourcen der Storage-Klasse stellen unterschiedliche Storage-Klassen oder -Typen dar, die für ein bestimmtes gemanagtes Cluster erkannt und verfügbar sind. |
Datenmenge |
21.04 |
Die Volume-Ressourcen stellen die Kubernetes Storage Volumes dar, die mit den gemanagten Applikationen verknüpft sind. |
Neue Endpunkte mit der aktuellen Version
Die folgenden REST-Endpunkte wurden mit der aktuellen Version 22.04 Astra Control hinzugefügt. Außerdem wurden die Versionen verschiedener vorhandener Ressourcen aktualisiert.
-
/Accounts/{Account_id}/Core/v1/Packages
-
/Accounts/{Account_id}/Core/v1/Packages/{package_id}
-
/Accounts/{Account_id}/Core/v1/Upgrades
-
/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/Clouds/{Cloud_id}/Cluster/{Cluster_id}/clusterNodes
-
/Accounts/{Account_id}/Topology/v1/Clouds/{Cloud_id}/Cluster/{Cluster_id}/clusterNodes/{clusterNode_id}
-
/Accounts/{Account_id}/Topology/v1/manageCluster/{managedCluster_id}/Apps/{App_id}/appAssets
-
/Accounts/{Account_id}/Topology/v1/manageCluster/{managedCluster_id}/Apps/{App_id}/appAssets/{appAsset_id}
-
/Accounts/{Account_id}/Topology/v1/manageCluster/{managedCluster_id}/clusterNodes
-
/Accounts/{Account_id}/Topology/v1/manageCluster/{managedCluster_id}/clusterNodes/{clusterNode_id}
Zusätzliche Ressourcen und Endpunkte
Zur Unterstützung einer Astra-Implementierung stehen mehrere zusätzliche Ressourcen und Endpunkte zur Verfügung.
|
|
Diese Ressourcen und Endpunkte sind derzeit nicht in der Astra Control REST API-Referenzdokumentation enthalten. |
- OpenAPI
-
Die OpenAPI-Endpunkte bieten Zugriff auf das aktuelle OpenAPI JSON-Dokument und andere zugehörige Ressourcen.
- OpenMetrics
-
Die OpenMetrics-Endpunkte bieten über die OpenMetrics-Ressource Zugriff auf die Kontokennzahlen. Support ist mit dem Astra Control Center Implementierungsmodell verfügbar.