Oracle Cloud Infrastructure-Dokumentation

Mit der API eine Instanz erstellen

Sie können eine Oracle Integration-Instanz mit der administrativen API von Oracle Integration bereitstellen.

Oracle Integration-Lebenszyklusvorgänge, einschließlich der Instanzerstellung, sind Teil der administrativen Oracle Integration-API. Insbesondere unterstützt die CreateIntegrationInstance-API das Erstellen neuer Oracle Integration-Instanzen.

Unterstützte Sprachen

Neben der Unterstützung einer REST-API gibt es auch mehrere Sprach-Bindings.

Folgende Sprachen werden unterstützt:

  • REST

    Kann beispielsweise mit Postman oder Oracle Integration verwendet werden.

  • Java
  • Python
  • Gehe zu
  • TypeScript
  • .NET
  • Ruby

In der Dokumentation zu Software Development Kits und Befehlszeilenschnittstelle wird erläutert, wie Sie die verschiedenen Sprach-Bindings für die Oracle Cloud Infrastructure-(OCI-)APIs installieren und verwenden, einschließlich der administrativen Oracle Integration-API.

CreateIntegrationInstance aus einem Oracle Integration-Ablauf aufrufen

Die CreateIntegrationInstance-API kann mit dem REST-Adapter innerhalb eines Oracle Integration-Ablaufs aufgerufen werden. In diesem Abschnitt werden die Schritte erläutert, die erforderlich sind, um die API über eine Aufrufaktion aufzurufen.

REST-Verbindung einrichten

Um die CreateIntegrationInstance-API aufrufen zu können, benötigen Sie eine Verbindung zu den APIs. Wir können eine REST-Adapterverbindung erstellen, um eine Verbindung zur API herzustellen und die OCI-Sicherheits-Policy ServiceInvocation zu verwenden. Das bedeutet, dass der Zugriff basierend auf OCI-Policys zulässig ist. Dazu muss die Oracle Integration-Instanz Mitglied einer dynamischen Gruppe sein. Siehe Verwendung der RPST- und OCI-Serviceaufrufsicherheits-Policy.

CreateIntegrationInstance aufrufen

Sie können CreateIntegrationInstance als POST-Vorgang aufrufen, wie unten gezeigt.

REST-Aufruf mit CreateIntegrationInstance als Endpunkt und POST als Aktion. Die URI des Endpunkts wird ebenfalls angezeigt, ist aber für das Beispiel nicht relevant.

Verwenden Sie beim Aufrufen von CreateIntegrationInstance die folgende Beispiel-Payload: 

{
  "compartmentId": "string",
  "consumptionModel": "UCM|GOV|OIC4SAAS",
  "definedTags": {
    "tagNamespace1": {
      "tagKey1": "tagValue1",
      "tagKey2": "tagValue2"
    },
    "tagNamespace2": {
      "tagKey1": "tagValue1",
      "tagKey2": "tagValue2"
    }
  },
  "displayName": "string",
  "domainId": "string",
  "freeformTags": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "isByol": true,
  "isDisasterRecoveryEnabled": true,
  "messagePacks": 1,
  "networkEndpointDetails": {
    "allowlistedHttpIps": [
      "string",
      "string"
    ],
    "allowlistedHttpVcns": [
      {
        "allowlistedIps": [
          "string",
          "string"
        ],
        "id": "string"
      },
      {
        "allowlistedIps": [
          "string",
          "string"
        ],
        "id": "string"
      }
    ],
    "isIntegrationVcnAllowlisted": true,
    "networkEndpointType": "PUBLIC"
  },
  "shape": "DEVELOPMENT|PRODUCTION",
  "integrationInstanceType": "STANDARDX|ENTERPRISEX|HEALTHCARE"
}
Parametername Beschreibung Parameter
Compartment Geben Sie das Compartment ein, in dem Sie die Instanz erstellen möchten. compartmentId
Nutzungsmodell Dieser Parameter ist nur erforderlich, wenn Sie sowohl Abonnement- als auch UCM-Berechtigungen haben. consumptionModel
Namespace-Tags Geben Sie vordefinierte Schlüssel für Namespaces ein. definedTags
Name Geben Sie einen Namen für diese Instanz an. Der Name wird zu einem Teil der URL für der Zugriff auf die Instanz verwendet. displayName
Identitätsdomain Dieser Parameter wird nicht als erforderlich aufgeführt, Sie müssen ihn jedoch einschließen. Geben Sie die OCID der Identitätsdomain ein, mit der Sie die Instanz verknüpfen möchten.

Sie können keine Identitätsdomain außerhalb Ihres Mandanten verwenden.

 domainId
Freiformtags Fügen Sie optional Tags hinzu, damit Sie Ihre Ressourcen in Ihrem Mandanten organisieren können.

Siehe Ressourcentags.

freeformTags
Lizenztyp Setzen Sie diese Option auf TRUE, wenn Sie eine vorhandene Oracle Fusion Middleware-Lizenz verwenden möchten.

Siehe Lizenztypen.

isByol

Zulässige Werte sind TRUE und FALSE.

Disaster Recovery Setzen Sie diese Option auf TRUE, wenn Sie Disaster Recovery konfigurieren möchten. Dadurch wird eine primäre Instanz in einer Region und eine sekundäre Instanz in einer anderen Region installiert. Sie müssen ENTERPRISEX oder HEALTHCARE als Edition und PRODUCTION als Ausprägung ausgewählt haben, und Sie müssen sich in einer Region befinden, die Disaster-Recovery-Paarung unterstützt.

Siehe Einführung in Oracle-Managed Disaster Recovery in Oracle-Managed Disaster Recovery-Lösung für Oracle Integration 3 konfigurieren.

isDisasterRecoveryEnabled

Zulässige Werte sind TRUE und FALSE.

Netzwerkzugriff Konfigurieren Sie eine Ausnahmeliste für die Instanz. Siehe Ausnahmeliste für Ihre Instanz konfigurieren. networkEndpointDetails
Nachrichtenpakete Geben Sie die Anzahl der Nachrichtenpakete ein, die Sie abonnieren möchten.

Siehe Anzahl der Nachrichtenpakete mit der Benutzeroberfläche bearbeiten.

–message-packs
Ausprägung Dieser Parameter ist nicht erforderlich, wird jedoch empfohlen. Er wird standardmäßig auf "Produktion" gesetzt. Geben Sie die Ausprägung ein, die Sie für diese Instanz verwenden möchten.

Siehe Ausprägungen.

shape
Edition Geben Sie die Edition ein, die diese Instanz sein soll.

Siehe Oracle Integration-Editionen.

integrationInstanceType

Sie können einen Beispiel-JSON-Load für jeden OCI-Befehl generieren, indem Sie die Option –generate-full-command-json-input im CLI-Befehl verwenden.