Documentação do Oracle Cloud Infrastructure

Criar uma Instância Usando a API

Você pode provisionar uma instância do Oracle Integration usando a API Administrativa do Oracle Integration.

As operações do ciclo de vida do Oracle Integration, incluindo a criação da instância, fazem parte da API Administrativa do Oracle Integration. Especificamente, a API CreateIntegrationInstance suporta a criação de novas instâncias do Oracle Integration.

Idiomas com Suporte

Além de suportar uma API REST, também há associações de vários idiomas.

São suportados os seguintes idiomas:

  • REST

    Pode ser usado com o Postman ou o Oracle Integration, por exemplo.

  • Java
  • Python
  • Go
  • TypeScript
  • .NET
  • Ruby

A documentação Software Development Kits e Command Line Interface explica como instalar e usar as várias associações de idiomas para as APIs do OCI (Oracle Cloud Infrastructure), incluindo a API Administrativa do Oracle Integration.

Chamando CreateIntegrationInstance de um Fluxo do Oracle Integration

A API CreateIntegrationInstance pode ser chamada usando o Adaptador REST de dentro de um fluxo do Oracle Integration. Esta seção explica as etapas necessárias para chamar a API de uma ação de chamada.

Configurar Conexão REST

Para chamar a API CreateIntegrationInstance, você precisa ter uma conexão com as APIs. Podemos criar uma conexão do Adaptador REST para estabelecer conexão com a API e usar a política de segurança ServiceInvocation do OCI, o que significa que o acesso é permitido com base nas políticas do OCI. Isso requer que a instância do Oracle Integration seja membro de um grupo dinâmico. Consulte Uso da Política de Segurança de Chamada de Serviço do RPST e do OCI.

Chamar CreateIntegrationInstance

Você pode chamar CreateIntegrationInstance como uma operação POST, conforme mostrado abaixo.

Chamada REST com CreateIntegrationInstance como ponto final e POST como a ação. O URI do ponto final também é mostrado, mas não é pertinente ao exemplo.

Ao chamar CreateIntegrationInstance, use o seguinte payload de amostra: 

{
  "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"
}
Nome do parâmetro Descrição Parâmetro
Compartimento Informe o compartimento no qual você deseja criar a instância. compartmentId
Modelo de consumo Esse parâmetro só será necessário se você tiver direitos de Assinatura e UCM. consumptionModel
Tags de namespace Informe chaves predefinidas com escopo para namespaces. definedTags
Nome Informe um nome para esta instância. O nome se torna parte do URL para acessar a instância. displayName
Domínio de identidades Este parâmetro não está listado como obrigatório, mas você deve incluí-lo. Digite o OCID do domínio de identidades ao qual você deseja associar a instância.

Você não pode usar um domínio de identidades fora da sua tenancy.

 domainId
Tags de Formato Livre Opcionalmente, adicione tags para ajudar a organizar seus recursos em sua tenancy.

Consulte Tags de Recursos.

freeformTags
Tipo de licença Defina esta opção como TRUE se quiser usar uma licença existente do Oracle Fusion Middleware.

Consulte Tipos de Licença.

isByol

Os valores permitidos são TRUE e FALSE.

Recuperação de desastre Defina essa opção como TRUE se quiser configurar a recuperação de desastre. Isso instala uma instância principal em uma região e uma instância secundária em outra região. Você deve ter selecionado ENTERPRISEX ou HEALTHCARE como edição e PRODUCTION como forma, e deve estar em uma região que suporte pareamento de recuperação de desastre.

Consulte Introduction to Oracle-Managed Disaster Recovery em Configuring an Oracle-Managed Disaster Recovery Solution for Oracle Integration 3.

isDisasterRecoveryEnabled

Os valores permitidos são TRUE e FALSE.

Acesso de rede Configure uma lista de permissões para sua instância. Consulte Configurar uma Lista de Permissões para sua Instância. networkEndpointDetails
Pacotes de mensagens Insira o número de pacotes de mensagens que deseja inscrever.

Consulte Editar o Número de Pacotes de Mensagens Usando a Interface do Usuário.

–message-packs
Forma Este parâmetro não é obrigatório, mas é recomendado; o padrão é Produção. Informe a forma que você deseja usar para esta instância.

Consulte Formas.

shape
Edição Informe a edição que você deseja que esta instância seja.

Consulte Edições do Oracle Integration.

integrationInstanceType

Você pode gerar uma carga JSON de amostra para qualquer comando do OCI usando a opção –generate-full-command-json-input no comando da CLI.