CAPI-Klassen in MID-Server Skripteinbindungen

Cloud Provisioning and Governance Stellt mehrere JavaScript-Klassen bereit, die REST-Aufrufe an Cloud-Anbieter durchführen. Diese Klassen werden von aufgerufen MID-Server Skripteinbindungen (standardmäßig für Azure) oder aus Java-Aufrufen im System (standardmäßig für AWS). Wenn Sie anwenderdefinierte Anbieter, Schnittstellen oder CAPI-APIs (für jeden Cloud-Anbieter) erstellen, können Sie verwenden MID-Server Skripteinbindungen zum Aufrufen der Klassen.

Hinweis:

In CAPI-APIs sind keine vorhanden MID-Server Skript enthält (in Methodenzuordnungen), die Sie anpassen können, um die AWS-Klassen aufzurufen. Standardmäßig führen die CAPI-APIs für AWS Java-Aufrufe durch, um dann die AWS-Klassen aufzurufen. Wenn Sie jedoch CAPI-APIs erstellen, können Sie auch anwenderdefinierte Skripteinbindungen erstellen, um die Klassen aufzurufen.

Zeigen Sie CAPI-Klassen an, indem Sie zu navigieren MID-Server > Skripteinbindungen In Basissystem Instanzschnittstelle (nicht die Portal für Cloud-Admin.). Sie suchen nach dem Namen einer Klasse in Wechseln Sie zu Suchfeld mit Name Spalte:

Basisklassen

Diese Basisklassen sind standardmäßig verfügbar. Sie bilden eine Grundlage für die Azure- und AWS-Klassen, die die tatsächlichen REST-Aufrufe durchführen.

CloudAPIBase

CloudAPIBase ist eine anbieterunabhängige API, die mit allen Arten von Cloud-APIs kommuniziert. Es bietet Funktionen für einfaches Debugging und Protokollierung und zum Sammeln von Proxy-Informationen auf MID-Server. Außerdem werden Header, Parameter, Endpunkte und definiert This.Parameter .

AWSCloudAPIBase

Diese Klasse wird von CloudAPIBase erweitert und bietet Funktionen, die den Aufrufer aufrufen, um GET-, PUT-, POST- und LÖSCHANFORDERUNGEN zu stellen. Die Klasse bietet die Option von Ausführungsaktion Methode, bei der es sich um eine AWS-Implementierung von GET handelt, oder die Aufrufmethode, die REST-API-Aufrufe bereitstellt.

AzureCloudAPIBase

Diese Klasse wird von CloudAPIBase erweitert und bietet Funktionen, die diese Aktionen ausführen:

• Ressourcen-IDs abrufen.
• Endpunkteigenschaften abrufen.
• Listen Sie Ressourcen auf.
• Rufen Sie den Aufrufer auf, um GET-, PUT-, POST- und LÖSCHANFORDERUNGEN zu stellen.

AzureCloudAPIBase verwendet _InvokeRequest Methode zum Durchführen von REST-API-Aufrufen für Azure mithilfe der Standard-REST-API-Aufrufe.

Abbildung : 1. Basis-APIs

Aufruferklassen

Aufruferklassen führen die tatsächlichen REST-Aufrufe an den Cloud-Provider durch. Wenn Sie eine anwenderdefinierte CAPI-Schnittstelle und API erstellen, sollten Sie erweitern CloudRestAPIInvokerUm Ihre REST-Aufrufe zu erstellen.

CloudRestAPIAufrufer

Diese Klasse ist eine abstrakte Klasse für REST-API-Aufrufe. Wenn Header und/oder Parameter vorhanden sind, die mit einer Anforderung gesendet werden sollen, müssen Klassen, die den Aufrufer implementieren, dieses Objekt erweitern. Sie müssen auch Überschreibungen für angeben getEndpointUrlUm den Zielendpunkt und für zurückzugeben getHeadersUnd getParameters. Bei Azure-REST-APIs erfordert die Authentifizierung beispielsweise die Übergabe eines Tokens als Header. Die Erweiterung, die sie implementiert, muss eine Antwort von bereitstellen getHeadersDas die Tokenerstellung oder den Tokenabruf durchführt und festlegt. Dieses Basisobjekt wird aufgerufen getHeadersUnd sendet alles, was mit der Anforderung zurückkommt. Diese Klasse stellt auch bereit getResponseMethode zum Verarbeiten der Antwort des Cloud-Providers.

Wenn Sie eine anwenderdefinierte CAPI-API erstellen, sollten Sie erweitern CloudRestAPIInvokerZum Durchführen VON REST-Aufrufen an den Cloud-Anbieter.

AmazonWebServicesAPIAufrufer

Diese Klasse wird von erweitert CloudRestAPIInvokerUnd stellt Methoden für REST-API-Aufrufe an den Cloud-Anbieter bereit.

AzureAPIAufrufer

Diese Klasse wird von erweitert CloudRestAPIInvokerUnd bietet Funktionen, die diese REST-API-Aufrufe an den Azure-Ressourcenmanager durchführen:

• Legt den Service-Prinzipal, die Header und die Parameter für REST-Aufrufe fest.
• Ruft die Endpunkt-URL, das Token (Client-ID, Mandanten-ID und geheimer Schlüssel) und Header/Parameter ab.
• Ruft den JSON-Antworttext vom Cloud-Anbieter ab und decodiert ihn.

AzureEAAPIAufrufer

Diese Klasse gibt das Token für den Zugriff auf die REST-API der Azure Enterprise Agreement (EA) zurück.

AzureStorageAPIAufrufer

Diese Klasse führt REST-Aufrufe für Azure-Speicher durch. Die Funktionen in dieser Klasse können Token, Antwort, Header und Parameter abrufen.

Diese Grafik veranschaulicht, wie diese Basisklassen verwendet werden, um AWS-spezifische und Azure-spezifische Klassen zu erweitern:

Abbildung : 2. REST-Aufrufe werden aufgerufen

Ausnahmen

RESTAPIAusnahme

Diese Basisklasse verarbeitet Ausnahmen, die während des REST-Aufrufs auftreten können. Gibt den Antwortcode vom Cloud-Anbieter zurück.

AWSAPIAusnahme

Diese Klasse verarbeitet Ausnahmen, die während des REST-Aufrufs auftreten können.

AzureAPIAusnahme

Diese Klasse löst bei Bedarf während des Azure-API-Aufrufs eine Laufzeitausnahme aus.

Abbildung : 3. Ausnahmen werden verarbeitet

Klassen für Anmeldeinformationen

CloudRESTRequestSigningUtil

Diese Klasse verwendet Überschreibungen, die in CAPI-API-Konfigurationsüberschreibungen angegeben sind. Die AmazonWebServicesRequestSignerKlasse erweitert diese Klasse. Für Azure sind viele Unterzeichner in integriert MID-Server Skripteinbindungen für Methodenzuordnungen in Azure CAPI-APIs.

AmazonWebServicesAnforderungsunterzeichner

Diese Klasse richtet eine sichere Sitzung für den REST-API-Aufruf ein, indem Informationen zu einer Anforderung erfasst und erstellt werden Signatur v4 -Signierte Zeichenfolge für die Anforderung. Diese Klasse wird von CloudRESTRequestSigningUtil erweitert.

Andere Azure-Klassen

Tabelle : 1. Klassen, die AzureCloudAPIBase erweitern

Klasse	Beschreibung
AzureAlertRule	Klasse zum Erstellen und Löschen von Azure-Warnungsregeln.
AzureAutorisierungRichtlinie	Klasse zum Zuweisen von Tag-Richtlinien.
AzureComputeVerfügbarkeitssatz	Klasse zum Abrufen von Azure-Verfügbarkeitssätzen. Siehe: https://docs.microsoft.com/en-us/rest/api/compute/availabilitysets
AzureComputeHardware	Klasse zum Abrufen von Azure-Größen. Siehe: https://docs.microsoft.com/en-us/rest/api/compute/virtualmachinesizes
AzureComputeImage	Klasse zur Verarbeitung von Azure-API-Aufrufen für das Bild. Siehe: https://docs.microsoft.com/en-us/rest/api/manageddisks/images/images-rest-api
AzureComputeVirtualMachine	Klasse zur Verarbeitung von Azure-API-Aufrufen für virtuelle Maschinen. Siehe: https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines VM-Größe und -Kapazitäten: https://docs.microsoft.com/en-us/azure/virtual-machines/virtual-machines-windows-sizes https://docs.microsoft.com/en-us/azure/virtual-machines/virtual-machines-linux-sizes Cloud-Init unterstützte Versionen: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/using-cloud-init
AzureBereitstellung	Klasse zur Verarbeitung der Bereitstellung von Azure ARM-Vorlagen.
AzureBereitstellungsvorgang	Klasse zur Verarbeitung des Bereitstellungsvorgangs der Azure-ARM-Vorlage.
AzureImages	Klasse zur Verarbeitung von Azure-Bildern.
AzureLoadBalancer	Klasse zur Verarbeitung von Azure-API-Aufrufen für Lastenausgleichsmodule. Siehe: https://msdn.microsoft.com/en-us/library/azure/mt163651.aspx
AzureLocalNetworkGateways	Klasse zum Erstellen und Abrufen lokaler Netzwerk-Gateways.
AzureNetworkNIC	Klasse zur Verarbeitung von Azure-API-Aufrufen für Netzwerkschnittstellenkarten. Siehe: https://msdn.microsoft.com/en-us/library/azure/mt163579.aspx
AzureNetworkPublicIP	Klasse zur Verarbeitung von Azure-API-Aufrufen für öffentliche IP-Adressen. Siehe: https://msdn.microsoft.com/en-us/library/azure/mt163638.aspx
AzureNetworkRouter	Klasse zur Verarbeitung von Azure-API-Aufrufen für die Weiterleitungstabelle. Siehe: https://docs.microsoft.com/en-us/rest/api/network/route-tables
AzureNetworkSecurityGroup	Klasse zur Verarbeitung von Azure-API-Aufrufen für Netzwerkschnittstellenkarten. Siehe: https://msdn.microsoft.com/en-us/library/azure/mt163579.aspx
AzureNetworkVirtualNetwork	Klasse zur Verarbeitung von Azure-API-Aufrufen für virtuelle Netzwerke.
AzureAnbieter	Klasse zum Abrufen von Azure-Anbieterdetails, z. B. Anbieter-URL und -Version.
AzureRegion	Klasse zum Abrufen von Azure-Regionen.
AzureRessource	Behandelt das Objekt, auf das von ObjectID in den Parametern verwiesen wird. Ruft auch die API-Version ab. Diese Klasse dient hauptsächlich dazu, nicht unterstützte Typen abzurufen oder Ressourcen zu löschen.
AzureResourceGroupManager	Klasse zur Verarbeitung von Azure ARM-Ressourcengruppen.
AzureResponseUtil	Klasse zum Übersetzen der Azure-API-Antwort in das DTO-Objekt.
AzureStorageAccount	Klasse zur Verarbeitung von Azure-API-Aufrufen für Speicheraccount. Siehe: //https://msdn.microsoft.com/en-us/library/azure/mt163638.aspx
AzureStorageBlob	Klasse zum Erstellen und Bearbeiten von Speichercontainern und Blobs.
AzureStorageManagedDisk	Klasse zur Verarbeitung von Azure-API-Aufrufen für verwalteten Datenträger. Siehe: https://docs.microsoft.com/en-us/rest/api/manageddisks/disks/disks-create-or-update
AzureAbonnement	Klasse zum Abrufen von Azure-Abonnements.
AzureVirtualNetworkGateways	Klasse zum Erstellen und Bearbeiten virtueller Netzwerk-Gateways.
AzureCloudEAAPIBase	Basisobjekt für Azure EA API-Handler. Azure EA-APIs haben die Basis-URL https://consumption.azure.com und erfordern die Registrierungsnummer im Pfad. Diese Klasse verarbeitet das Marshalling der Parameter „Registrierungsnummer“ und „RegistrierungsToken“.

Andere AWS-Klassen

Klasse	Beschreibung
AmazonImages	Klasse zur Verarbeitung von Amazon-Computer-Images. http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html
AmazonResponseProcessorUtil	Klasse zur Verarbeitung der AWS-REST-API-Antwort.
AWSAutomatische Skalierungsgruppen	Klasse zur Verarbeitung von AWS-API-Aufrufen zum Erstellen und Bearbeiten Gruppen Automatisch Skalieren .
AWSCloudFormation	Handler für AWS CloudFormation API-Aufrufe.
AWSEC2	Handler für AWS EC2-API-Aufrufe.
AWSSchlüsselwertpaar	Klasse zum Importieren und Bearbeiten von Schlüsselpaaren.
AWSStartkonfigurationen	Hilfsklasse.
AWSS3	Handler für AWS S3-API-Aufrufe.
AWSTopics	Klasse mit AWS-Themen .