Gerenciando Instâncias do Exadata

Importante

O painel de controle Meus Serviços e as APIs estão obsoletos.

Os procedimentos a seguir o orientam na criação, modificação e exclusão de instâncias do Exadata usadas com a API Meus Serviços do Oracle Cloud.

Importante

Esses procedimentos são para uso SOMENTE no Oracle Database Exadata Database Service on Cloud@Customer. Para obter mais informações, consulte Administrando o Oracle Database Exadata Cloud at Customer. Esses procedimentos NÃO se aplicam ao Exadata Cloud Service disponível no Oracle Cloud Infrastructure.

Pré-requisitos

Para que possa gerenciar instâncias do Exadata, você precisa:

  • Assinar um serviço do Oracle Cloud
  • Obter credenciais da conta com as atribuições necessárias designadas
  • Determinar seu ponto final da API
Para assinar um serviço do Oracle Cloud

Para acessar a API Meus Serviços do Oracle Cloud, você deve solicitar uma assinatura de avaliação ou paga de um serviço do Oracle Cloud.

Para obter as credenciais da conta e as designações da atribuição

Peça ao administrador da sua conta os seguintes itens para acessar a API Meus Serviços do Oracle Cloud:

  • Credenciais da conta:

    • Nome do usuário e senha

    • ID do domínio de identidades

      Um ID de domínio de identidades pode ser o GUID do IDCS que identifica o domínio de identidades para os usuários do Identity Cloud Service (IDCS) ou o nome do Domínio de Identidades para uma Conta do Cloud tradicional.

  • Atribuições necessárias designadas ao nome de usuário acima

Para determinar seu ponto final de API

Insira o ID do domínio de identidades fornecido pelo administrador da conta (<domain>) entre /itas/ e /myservices/.

Exemplo:

https://itra.oraclecloud.com/itas/<domain>/myservices/api/v1/serviceEntitlements

Criando Instâncias do Exadata

Esta seção abrange como criar uma instância básica do Exadata, uma instância com configuração de rede IP personalizada e uma instância com suporte a várias VMs.

Para criar uma instância básica do Exadata

Publique uma solicitação com o payload necessário para criar uma nova instância para um determinado direito ao serviço (Exadata, no nosso caso).

No exemplo a seguir, <domain> é o ID do domínio de identidades.

POST /itas/<domain>/myservices/api/v1/operations
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "requestPayload.name", 
          "value": "newinstanceName" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.adminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminFirstName", 
          "value": "John" 
        }, 
        { 
          "name": "requestPayload.adminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.invokerAdminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminFirstName", 
          "value": "John"
        }, 
        { 
          "name": "requestPayload.invokerAdminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.customAttributes.ExaUnitName", 
          "value": "systemname" 
        }, 
        { 
          "name": "requestPayload.customAttributes.CreateSparse", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupToDisk", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.isBYOL", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.PickRackSize", 
          "value": "Quarter Rack"  
        }, 
        { 
          "name": "requestPayload.customAttributes.SELECTED_DC_ID", 
          "value": "US001"                     
        }
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-CREATE" 
      } 
    } 
  ] 
}

Atributos

Nome Descrição
requestPayload.name

Obrigatório: Sim

Tipo: String

Nome da instância do Exadata. Esse nome:

  • Não pode exceder 25 caracteres.
  • Deve começar com uma letra.
  • Deve conter apenas letras minúsculas e números.
  • Não deve conter espaços ou nenhum outro caractere especial.
  • Deve ser exclusivo no domínio de identidades.

requestPayload.

serviceEntitlementId

Obrigatório: Sim

Tipo: String

Direito ao Serviço para a instância do Exadata. Consulte "Descoberta de Direito ao Serviço Exadata". Observe que qualquer prefixo "cesi-" ou "sub-" não deve ser incluído.

requestPayload.

customAttributes.

ExaUnitName

Obrigatório: Sim

Tipo: String

Um nome para seu ambiente do Exadata Database Machine. Esse nome também é usado como o nome do cluster para a instalação do Oracle Grid Infrastructure.

requestPayload.

customAttributes.

CreateSparse

Obrigatório: Sim

Tipo: String

"S" para criar um grupo de discos baseado em discos de grade esparsos; caso contrário, "N".

Você deve selecionar esta opção para ativar snapshots do Exadata Cloud Service. Os snapshots do Exadata ativam clones que conservam espaço de bancos de dados Oracle que podem ser criados e destruídos de forma muito rápida e fácil.

requestPayload.

customAttributes.

BackupToDisk

Obrigatório: Sim

Tipo: String

"S" para usar "Backups de banco de dados no Exadata Storage", ou então "N".

Esta opção configura o armazenamento do Exadata para ativar backups do banco de dados local no armazenamento do Exadata.

requestPayload.

customAttributes.

isBYOL

Obrigatório: Sim

Tipo: String

"S" para indicar que a instância do Exadata Cloud Service usa licenças do Oracle Database fornecidas por você, em vez de licenças fornecidas como parte da assinatura do serviço; caso contrário, "N".

Esta opção só afeta a cobrança associada à instância do serviço. Ela não tem efeito sobre a configuração técnica da instância do Exadata Cloud Service.

requestPayload.

customAttributes.

PickRackSize

Obrigatório: Sim

Tipo: String

Especifique a configuração do rack para sua instância de serviço. Os valores permitidos exatos dependem da sua compra. Os valores típicos são como "Full Rack", "Half Rack", "Quarter Rack" ou "Eighth Rack".

requestPayload.

customAttributes.

SELECTED_DC_ID

Obrigatório: Sim

Tipo: String

Data center que hospedará sua instância do Exadata Cloud Service. Consulte "Descoberta de Direito do Serviço Exadata" para obter os IDs do Data Center Elegíveis.

Para criar uma instância do Exadata com configuração de rede IP personalizada

Publique uma solicitação com os atributos ClientNetwork e BackupNetwork como parte do payload. O exemplo a seguir inclui esses atributos opcionais e também os atributos obrigatórios.

No exemplo a seguir, <domain> é o ID do domínio de identidades.

POST /itas/<domain>/myservices/api/v1/operations
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "requestPayload.name", 
          "value": "newinstanceName" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.adminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminFirstName", 
          "value": "John" 
        }, 
        { 
          "name": "requestPayload.adminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.invokerAdminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminFirstName", 
          "value": "John"
        }, 
        { 
          "name": "requestPayload.invokerAdminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.customAttributes.ExaUnitName", 
          "value": "systemname" 
        }, 
        { 
          "name": "requestPayload.customAttributes.CreateSparse", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupToDisk", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.isBYOL", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.PickRackSize", 
          "value": "Quarter Rack"  
        }, 
        { 
          "name": "requestPayload.customAttributes.SELECTED_DC_ID", 
          "value": "US001"                     
        }
        { 
          "name": "requestPayload.customAttributes.ClientNetwork", 
          "value": "/root/root/1/ipnetwork1" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupNetwork", 
          "value": "/root/root/1/ipnetwork2" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-CREATE" 
      } 
    } 
  ] 
}

Atributos

Nome Descrição

requestPayload.

customAttributes.

ClientNetwork

Obrigatório: Sim

Tipo: Url

Definições de rede IP para a rede que é usada principalmente para acesso do cliente aos servidores de banco de dados. Os aplicativos geralmente acessam bancos de dados no Exadata Cloud Service por meio desta rede usando o Oracle Net Services em conjunto com as interfaces SCAN (Single Client Access Name) e Oracle RAC Virtual IP (VIP).

requestPayload.

customAttributes.

BackupNetwork

Obrigatório: Sim

Tipo: Url

Definições de rede IP para a rede que geralmente é usada para acessar os servidores de banco de dados para várias finalidades, incluindo backups e transferências de dados em massa.

Para criar uma instância do Exadata com suporte a várias VMs

Se o seu ambiente do sistema Exadata estiver ativado para suportar vários clusters de máquina virtual (VM), você poderá definir até oito clusters e especificar como os recursos gerais do sistema Exadata serão alocados a eles.

Em uma configuração com vários clusters de VM, cada cluster de VM recebe uma parte dedicada de recursos gerais do sistema Exadata, sem inclusão de capacidade extra ou compartilhamento de recursos. Nos nós de computação, uma VM separada é definida para cada cluster de VM, e cada VM recebe uma parte dedicada dos recursos disponíveis de CPU, memória e disco local do nó de computação. Cada cluster de VM também recebe uma parte dedicada do armazenamento geral do Exadata.

Publique uma solicitação com os atributos EXAUNIT_ALLOCATIONS e MULTIVM_ENABLED como parte do payload. O exemplo a seguir inclui esses atributos opcionais e também os atributos obrigatórios.

No exemplo a seguir, <domain> é o ID do domínio de identidades e <base64_encoded_string> é uma codificação base64 do payload de acordo com o exemplo.

Exemplo de payload da solicitação:

POST /itas/<domain>/myservices/api/v1/operations
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "requestPayload.name", 
          "value": "newinstanceName" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.adminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminFirstName", 
          "value": "John" 
        }, 
        { 
          "name": "requestPayload.adminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.invokerAdminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminFirstName", 
          "value": "John"
        }, 
        { 
          "name": "requestPayload.invokerAdminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.customAttributes.ExaUnitName", 
          "value": "systemname" 
        }, 
        { 
          "name": "requestPayload.customAttributes.CreateSparse", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupToDisk", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.isBYOL", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.PickRackSize", 
          "value": "Quarter Rack"  
        }, 
        { 
          "name": "requestPayload.customAttributes.SELECTED_DC_ID", 
          "value": "US001"                     
        }
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes.MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-CREATE" 
      } 
    } 
  ] 
}

Payload para <base64_encoded_string>:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d2a0}, 
    {name:Operation, value:AddCluster},
    {name:TotalNumOfCoresForCluster, value:4},
    {name:TotalMemoryInGb, value:30},
    {name:StorageInTb, value:3},
    {name:OracleHomeDiskSizeInGb, value:60},
    {name:ClientNetwork, value:/root/root/1/ipnetwork1},  // Only if Higgs is also required
    {name:BackupNetwork, value:/root/root/1/ipnetwork2},  // Only if Higgs is also required
    {name:ExaUnitName, value:systemname},
    {name:CreateSparse, value:N},
    {name:BackupToDisk, value:N}
  ] 
}

Atributos

Nome Descrição

requestId

Necessário: Opcional

Tipo: String

UUID Exclusivo

TotalNumOfCores

ForCluster

Obrigatório: Sim

Tipo: String

O número de núcleos de CPU alocados para o cluster de VMs. Este é o número total de núcleos de CPU alocados uniformemente entre todos os nós de computação do cluster de VMs. Deve ser um múltiplo de numComputes, conforme retornado por uma chamada para ecra/endpoint/clustershapes.

TotalMemoryInGb

Obrigatório: Sim

Tipo: String

A quantidade de memória (em GB) alocada para o cluster de VMs. Esta é a quantidade total de memória alocada uniformemente entre todos os nós de computação do cluster de VMs. Deve ser um múltiplo de numComputes, conforme retornado por uma chamada para ecra/endpoint/clustershapes.

StorageInTb

Obrigatório: Sim

Tipo: String

O valor total de armazenamento do Exadata (em TB) alocado para o cluster de VMs. Este armazenamento é alocado uniformemente de todos os Exadata Storage Servers.

OracleHomeDiskSize

InGb

Obrigatório: Sim

Tipo: String

O volume de armazenamento em disco local (em GB) que é alocado para cada servidor de banco de dados no primeiro cluster de VMs.

Modificando Instâncias do Exadata

Esta seção aborda como adicionar um cluster a uma instância existente, reconfigurar um cluster e excluir um cluster.

Para adicionar um cluster a uma instância existente

Publique uma solicitação com o operationItemDefinition do CIM-Exadata-CUSTOM-PRODUCTION-UPDATE e uma codificação base64 de um payload que inclui o valor da Operação de AddCluster.

No exemplo a seguir, <domain> é o ID do domínio de identidades, <instanceId> e <serviceEntitlementId> são retornados de iTAS serviceInstances e <base64_encoded_string> é uma codificação base64 do payload de acordo com o exemplo.

Exemplo de payload da solicitação:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "<instanceId>" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "<serviceEntitlementId>" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes. MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-UPDATE" 
      } 
    } 
  ] 
}

Payload para <base64_encoded_string>:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d2a0}, 
    {name:Operation, value:AddCluster},
    {name:TotalNumOfCoresForCluster, value:4},
    {name:TotalMemoryInGb, value:30},
    {name:StorageInTb, value:3},
    {name:OracleHomeDiskSizeInGb, value:60},
    {name:ClientNetwork, value:/root/root/1/ipnetwork1},  // Only if Higgs is also required
    {name:BackupNetwork, value:/root/root/1/ipnetwork2},  // Only if Higgs is also required
    {name:ExaUnitName, value:Cluster2},
    {name:CreateSparse, value:N},
    {name:BackupToDisk, value:N}
  ] 
}
Para reconfigurar um cluster

Publique uma solicitação com o operationItemDefinition do CIM-Exadata-CUSTOM-PRODUCTION-UPDATE e uma codificação base64 de um payload que inclui o valor da Operação de ReshapeCluster.

No exemplo a seguir, <domain> é o ID do domínio de identidades e <base64_encoded_string> é uma codificação base64 do payload de acordo com o exemplo.

Exemplo de payload da solicitação:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "500076173" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes. MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-UPDATE" 
      } 
    } 
  ] 
}

Payload para <base64_encoded_string>:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d2a0}, 
	{name:ExaunitID, value:1},		// From ecra/endpoint/exaservice/{serviceInstance}/resourceinfo
    {name:Operation, value:ReshapeCluster},
    {name:TotalNumOfCoresForCluster, value:10},
    {name:TotalMemoryInGb, value:10},
    {name:StorageInTb, value:4},
    {name:OhomePartitionInGB, value:100},
    {name:ClientNetwork, value:/root/root/1/ipnetwork1},  // Only if Higgs is also required
    {name:BackupNetwork, value:/root/root/1/ipnetwork2}   // Only if Higgs is also required
  ] 
}
Importante

  • Apenas um atributo pode ser modificado por solicitação de Reconfiguração. O payload deve conter somente o atributo modificado. Exemplo:

    
    
    {ExaunitProperties
    
    :
    
    [{name:Operation,value
    
    :
    
    ReshapeCluster},
    
    {
    
    name:ExaunitID,value:5
    
    },{
    
    name:TotalNumOfCoresForCluster
    
    ,
    
    value:6}]
    
    }
  • Ao fazer uma Reconfiguração com o atributo OracleHomeDiskSizeInGb, use o nome OhomePartitionInGB.
  • O valor de TotalNumOfCoresForCluster deve ser um múltiplo de numComputes, conforme retornado por uma chamada a ecra/endpoint/clustershapes.
  • O valor de TotalMemoryInGb deve ser um múltiplo de numComputes, conforme retornado por uma chamada a ecra/endpoint/clustershapes.
Para excluir um cluster

Publique uma solicitação com o operationItemDefinition do CIM-Exadata-CUSTOM-PRODUCTION-UPDATE e uma codificação base64 de um payload que inclui o valor da Operação do DeleteCluster.

No exemplo a seguir, <domain> é o ID do domínio de identidades e <base64_encoded_string> é uma codificação base64 do payload de acordo com o exemplo.

Exemplo de payload da solicitação:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1 
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "500076173" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes. MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-UPDATE" 
      } 
    } 
  ] 
}

Payload para <base64_encoded_string>:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d202},  // Optional
	{name:ExaunitID, value:2},
    {name:Operation, value:DeleteCluster}
  ] 
}

Excluindo Instâncias do Exadata

Esta seção abrange como excluir instâncias do Exadata.

Importante

Exclua todos os clusters de várias VMs existentes antes de excluir a instância do Exadata. Seguir essa orientação impede que a instância acabe em um estado inválido.
Para excluir uma instância

Publique uma solicitação com o operationItemDefinition do CIM-Exadata-CUSTOM-PRODUCTION-DELETE.

No exemplo a seguir, <domain> é o ID do domínio de identidades.

Exemplo de payload da solicitação:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1 
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "500076173" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        },  
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-DELETE" 
      } 
    } 
  ] 
}

Descobrindo Direitos e Instâncias

Esta seção descreve como descobrir direitos ao serviço e instâncias de serviço.

Para descobrir direitos ao serviço

Envie a seguinte solicitação:

GET /itas/<domain>/myservices/api/v1/serviceEntitlements?serviceDefinitionNames=Exadata

Exemplo de payload retornado para esta solicitação:

{
    "items": [
      {
        "id": "cesi-585927251",               // Unique ServiceEntitlementId
        "serviceDefinition": {
          "canonicalLink": "/itas/a517289/myservices/api/v1/serviceDefinitions/502579309",
          "id": "502579309",
          "name": "Exadata"                 // The customer is entitled to use the Exadata Service
        },
        "status": "ACTIVE",
        ...
        "canonicalLink": "/itas/a517289/myservices/api/v1/serviceInstances/csi-585928949"
      }
    ...                                              // More Service Entitlements could be displayed
    ],
  "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements",
  "hasMore": false,
  "limit": 25, 
  "offset": 0
}

Data Centers Elegíveis:

Use:


                        /itas/
                        <domain>/myservices/api/v1/serviceEntitlements/{ServiceEntitlementId}?expands=serviceInstancesEligibleDataCenters
                    

em que {ServiceEntitlementId} é um ID de direito ao serviço, como cesi-500074601. Ele fornecerá informações adicionais como:

  "serviceInstancesEligibleDataCenters": [
    {
      "id": "US001"
    }
  ],
Para descobrir instâncias de serviço

Envie a seguinte solicitação:

GET /<domain>/myservices/api/v1/serviceInstances?serviceDefinitionNames=Exadata

Exemplo de payload retornado para esta solicitação:

{
    "items": [
      {
        "id": "csi-585928949",               // Unique ServiceInstanceId
        "serviceEntitlement": {
          "id": "cesi-585927251",          // Related ServiceEntitlementId     
          "canonicalLink": "/itas/a517289/myservices/api/v1/serviceEntitlements/cesi-585927251"
        },
        "serviceDefinition": {
          "canonicalLink": "/itas/a517289/myservices/api/v1/serviceDefinitions/502579309",
          "id": "502579309",
          "name": "Exadata"                 // The customer is entitled to use the Exadata Service
        },
        ...
        "canonicalLink": "/itas/a517289/myservices/api/v1/serviceInstances/csi-585928949"
      }
    ...                                              // More Service Entitlements could be displayed
    ],
  "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements",
  "hasMore": false,
  "limit": 25, 
  "offset": 0
}