Casos de Uso do Exadata

Importante

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

Os exemplos de casos de uso a seguir podem ajudá-lo a começar a trabalhar com as operações do Exadata disponíveis na 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.

Lista de Permissões do Firewall do Exadata

Para permitir o acesso à sua instância do Exadata Cloud Service, é possível configurar regras de segurança e associá-las à instância. As regras de segurança definem uma lista de permissões de pontos de acesso à rede permitidos.

O firewall fornece um sistema de regras e grupos. Por padrão, o firewall nega o acesso da rede à instância do Exadata Cloud Service. Quando ativa uma regra de segurança, você permite o acesso à instância do Exadata Cloud Service. Para ativar o acesso, você deve:

Criar um grupo de segurança e criar regras de segurança que definam concessões de acesso à rede específicas.
Atribuir o grupo de segurança à sua instância do Exadata Cloud Service.

É possível definir vários grupos de segurança, e cada grupo de segurança pode conter várias regras de segurança. Você pode associar vários grupos de segurança a cada instância do Exadata Cloud Service, e cada grupo de segurança pode ser associado a várias instâncias do Exadata Cloud Service. É possível ativar e desativar dinamicamente as regras de segurança modificando os grupos de segurança associados a cada instância do Exadata Cloud Service.

Para permitir o acesso a uma instância do Exadata Cloud Service:

Observação

Nos exemplos a seguir, <domain> é o 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.

Obtenha os IDs da instância de serviço.

Operação: GET ServiceInstances

Exemplo

Exemplo de solicitação:

GET /itas/<domain>/myservices/api/v1/serviceInstances?serviceDefinitionNames=Exadata&statuses=ACTIVE

Exemplo de payload retornado para esta solicitação:

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

Este exemplo de payload retorna o ID da instância de serviço csi-585928949, que faz parte do ID de direito ao serviço cesi-585927251.

Obtenha os IDs de configuração de serviço.

Operação: GET SIServiceConfigurations

Exemplo

Exemplo de solicitação, usando o ID da instância de serviço csi-585928949:

GET /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations

Exemplo de payload retornado para esta solicitação:

{
 "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations", 
 "items": [
   {
     "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata", 
      "exadata": {
      "bursting": {
        "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/bursting"
      }, 
     "id": "Exadata", 
     "securityGroupAssignments": {
     "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments"
     }
   }, 
   "id": "Exadata"
   }
 ]
}

Esse exemplo de payload mostra que /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments é usado para o Firewall do Exadata.

Obtenha os grupos de segurança atuais para o direito ao serviço.

Operação: GET SEExadataSecurityGroups

Exemplo

Exemplo de solicitação, usando o ID do direito ao serviço cesi-585927251:

GET /itas/<domain>/myservices/api/v1/serviceEntitlements/cesi-585927251/serviceConfigurations/Exadata/securityGroups

Exemplo de payload retornado para esta solicitação:

{
  "items": [
    {
      "id": "1",
      "customerId": "585927251",
      "name": "SecGroup 1",
      "description": "My first Security group",
      "version": 10,
      "rules": [
        {
          "direction": "ingress",
          "proto": "tcp",
          "startPort": 1159,
          "endPort": 1159,
          "ipSubnet": "0.0.0.0/0",
          "ruleInterface": "data"
        }
      ],
      "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements/585927251/serviceConfigurations/Exadata/securityGroups/1"
    },
    {
      "id": "2",
      "customerId": "585927251",
      "name": " SecGroup 2",
      "description": "My second Security group",
      "version": 3,
      "rules": [
        {
          "direction": "egress",
          "proto": "tcp",
          "startPort": 8123,
          "endPort": 8123,
          "ipSubnet": "192.168.1.0/28",
          "ruleInterface": "data"
        }
      ],
      "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements/585927251/serviceConfigurations/Exadata/securityGroups/2"
    }
  ],
  "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements/585927251/serviceConfigurations/Exadata/securityGroups"
}

Este exemplo de payload mostra dois grupos de segurança definidos para o ID de direito ao serviço especificado.

Obter as designações atuais do grupo de segurança para a instância de serviço

Operação: GET SIExadataSecurityGroupAssignments

Exemplo

Exemplo de solicitação, usando o ID da instância de serviço csi-585928949:

GET /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments

Exemplo de payload retornado para esta solicitação:

{
  "items": [
    {
      "id": "11",
      "securityGroup": 
      {
        "id": "1",
        "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements/585927251/serviceConfigurations/Exadata/securityGroups/1"
      },
      "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments/11"
    }
  ],
  "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments"
}

Este exemplo de payload mostra um grupo de segurança atribuído à instância de serviço csi-585928949.

Crie um grupo de segurança com regras de segurança.

Operação: POST SEExadataSecurityGroups

Exemplo

Exemplo de solicitação, usando o ID do direito ao serviço cesi-585927251:

POST /itas/<domain>/myservices/api/v1/serviceEntitlements/cesi-585927251/serviceConfigurations/Exadata/securityGroups
{
   "customerId": "585927251",         
   "name": "SecGroup 1",              
   "description": "My third Security group",
   "version": 1,
   "rules": [
     {
       "direction": "ingress",        
       "proto": "tcp",                
       "startPort": 30,               
       "endPort": 31,                 
       "ipSubnet": "100.100.100.255", 
       "ruleInterface": "admin"      
     },
     {
       "direction": "egress",
       "proto": "tcp",
       "startPort": 32,
       "endPort": 32,
       "ipSubnet": "100.100.255.0/16",
       "ruleInterface": "admin"
     }
   ]
}

Atributos:


Nome	Descrição
customerId	Obrigatório: Sim String Deve ser o mesmo que `<serviceEntitlementId>`
direção	Obrigatório: Sim String Valores permitidos: [entrada \| saída] para entrada ou saída.
proto	Obrigatório: Sim String Valores permitidos: [tcp \| udp].
startPort	Obrigatório: Sim Número Inteiro startPort define o início de um intervalo de portas para abrir/colocar na lista branca [0 - 65535].
endPort	Obrigatório: Sim Número Inteiro endPort define o fim de um intervalo de portas para abrir/colocar na lista branca [0 - 65535].
ipSubnet	Obrigatório: Sim String Endereço IP único ou intervalo especificado em notação CIDR.
ruleInterface	Obrigatório: Sim String Valores permitidos: [admin \| cliente \| backup], em que: admin — especifica que a regra se aplica a comunicações de rede por meio da interface de rede de administração. A rede de administração geralmente é usada para suportar tarefas de administração usando sessões de terminal, agentes de monitoramento e assim por diante. cliente — especifica que a regra se aplica às comunicações de rede pela interface de rede de acesso do cliente, que geralmente é usada pelas conexões do Oracle Net Services. backup — especifica que a regra se aplica às comunicações de rede pela interface de rede de backup, que geralmente é usada para transportar informações de backup de/para armazenamento baseado em rede que é separado do Exadata Cloud Service.

Se for bem-sucedida, a solicitação POST retornará o ID exclusivo do grupo de segurança recém-criado. Para a próxima etapa, presumimos que o ID do grupo de segurança recém-criado é 3.

Observação

Um grupo de segurança também pode ser modificado ou excluído. Consulte API Meus Serviços do Oracle Cloud.

Atribua o grupo de segurança a uma instância de serviço.

Operação: POST SIExadataSecurityGroupAssignments
Exemplo

Exemplo de solicitação, usando a instância de serviço csi-585928949 e o ID do grupo de segurança 3:
```
POST /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments 

{
   "securityGroup": {
      "id": "3", 
      "customerId": "585927251",
      "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements/585927251/serviceConfigurations/Exadata/securityGroups/3"
   }
}
```
Atributos:

Nome Descrição

customerId
Obrigatório: Sim

String

Deve ser o mesmo que serviceEntitlementId.

Se for bem-sucedida, a solicitação POST retornará o Id exclusivo da atribuição de grupo de segurança recém-criada.

Observação

Uma atribuição do grupo de segurança também pode ser excluída. Consulte API Meus Serviços do Oracle Cloud.

Agora você pode verificar todos os seus grupos e atribuições de segurança. Consulte:
- Obtenha os grupos de segurança atuais para o direito ao serviço.
- Obter as designações atuais do grupo de segurança para a instância de serviço.

Nome	Descrição
customerId	Obrigatório: Sim String Deve ser o mesmo que serviceEntitlementId.

Para obter o GUID do IDCS

Vá para a página Usuários no painel de controle Meus Serviços e clique em Console de Identidades. O URL no campo de endereço do browser exibe o GUID do IDCS para seu domínio de identidades. Por exemplo:

https://idcs-105bbbdfe5644611bf7ce04496073adf.identity.oraclecloud.com/ui/v1/adminconsole/?root=users

No URL acima, idcs-105bbbdfe5644611bf7ce04496073adf é o GUID do IDCS para seu domínio de identidades.

Dimensionamento do Exadata com Intermitência

Você pode modificar temporariamente a capacidade do seu ambiente Exadata configurando a intermitência. Intermitência é um método que você pode usar para escalar instâncias sem medição de consumo do Exadata Cloud Service em um sistema Exadata.

Para ampliar suas instâncias sem medição de consumo, aumente o número de nós de computação modificando o atributo burstOcpu do host. Quando você não precisar mais dos nós adicionais, atualize o atributo burstOcpu de volta para sua configuração original.

Observação

Obtenha os IDs da instância de serviço.

Operação: GET ServiceInstances

Exemplo

Exemplo de solicitação:

GET /itas/<domain>/myservices/api/v1/serviceInstances?serviceDefinitionNames=Exadata&statuses=ACTIVE

Exemplo de payload retornado para esta solicitação:

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

Este exemplo de payload retorna o ID da instância de serviço csi-585928949.

Obtenha os IDs de configuração de serviço.

Operação: GET SIServiceConfigurations

Exemplo

Exemplo de solicitação, usando o ID da instância de serviço csi-585928949:

GET /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations

Exemplo de payload retornado para esta solicitação:

{
 "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations", 
 "items": [
   {
     "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata", 
      "exadata": {
      "bursting": {
        "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/bursting"
      }, 
     "id": "Exadata", 
     "securityGroupAssignments": {
     "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments"
     }
   }, 
   "id": "Exadata"
   }
 ]
}

Este exemplo de payload mostra que /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments é usado para Intermitência.

Obtenha a configuração atual do nó de computação.

Operação: GET SIExadataBursting

Exemplo

Exemplo de solicitação, usando o ID da instância de serviço csi-585928949:

GET /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/bursting

Exemplo de payload retornado para esta solicitação:

{ 
   "ocpuOpInProgress": false,
   "exaunitId": 50,
   "ocpuAllocations": [
       {
          "hostName": "host1.oraclecloud.com",
          "subscriptionOcpu": 11,
          "meteredOcpu": 0,
          "burstOcpu": 0,                                // Current Burst value
          "minOcpu": 11,
          "maxOcpu": 42,
          "maxBurstOcpu": 11,
          "maxSubOcpu": 38,
          "maxMetOcpu": 0
       },
       {
          "hostName": "host2.oraclecloud.com",
          "subscriptionOcpu": 11,
          "meteredOcpu": 0,
          "burstOcpu": 0,                                // Current Burst value
          "minOcpu": 11,
          "maxOcpu": 42,
          "maxBurstOcpu": 11,
          "maxSubOcpu": 38,
          "maxMetOcpu": 0
       }
       ],
   "status": 200,
   "op": "exaunit_coreinfo",
   "additionalNumOfCores": "0", 
   "additionalNumOfCoresHourly": "0",
   "coreBursting": "Y"
}

Modifique os valores para burstOcpu.

Operação: PUT SIExadataBursting

Você pode modificar burstOcpu para um valor que seja até o valor de maxBurstOcpu. Este exemplo adiciona dois nós de computação a cada host.

Exemplo

Exemplo de solicitação, usando a instância de serviço csi-585928949:

PUT /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/bursting/
{
   "ocpuOpInProgress": false,
   "exaunitId": 50,
   "ocpuAllocations": [
       {
          "hostName": "host1.oraclecloud.com",
          "subscriptionOcpu": 11,
          "meteredOcpu": 0,
          "burstOcpu": 2,
          "minOcpu": 11,
          "maxOcpu": 42,
          "maxBurstOcpu": 11,
          "maxSubOcpu": 38,
          "maxMetOcpu": 0       
       },
       {
          "hostName": "host2.oraclecloud.com",
          "subscriptionOcpu": 11,
          "meteredOcpu": 0,
          "burstOcpu": 2,
          "minOcpu": 11,
          "maxOcpu": 42,
          "maxBurstOcpu": 11,
          "maxSubOcpu": 38,
          "maxMetOcpu": 0       
       }    
       ]
}

Atributos:


Nome	Descrição
burstOcpu	Obrigatório: Sim Tipo: Número Inteiro, Valor Mínimo: 0, Valor Máximo: maxBurstOcpu Número de núcleos adicionais

Observação

Esta ação pode levar alguns minutos para ser concluída.

Verifique a nova configuração do nó de computação.

Operação: GET SIExadataBursting

Exemplo

Exemplo de solicitação, usando o ID da instância de serviço csi-585928949:

GET /itas/<domain>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/bursting

Exemplo de payload retornado para esta solicitação:

{ 
   "ocpuOpInProgress": false,
   "exaunitId": 50,
   "ocpuAllocations": [
       {
          "hostName": "host1.oraclecloud.com",
          "subscriptionOcpu": 11,
          "meteredOcpu": 0,
          "burstOcpu": 2,                     // New Burst value
          "minOcpu": 11,
          "maxOcpu": 42,
          "maxBurstOcpu": 11,
          "maxSubOcpu": 38,
          "maxMetOcpu": 0       
       },
       {
          "hostName": "host2.oraclecloud.com",
          "subscriptionOcpu": 11,
          "meteredOcpu": 0,
          "burstOcpu": 2,                     // New Burst value
          "minOcpu": 11,
          "maxOcpu": 42,
          "maxBurstOcpu": 11,
          "maxSubOcpu": 38,
          "maxMetOcpu": 0       
       }
       ],
   "status": 200,
   "op": "exaunit_coreinfo",
   "additionalNumOfCores": "0", 
   "additionalNumOfCoresHourly": "0",
   "coreBursting": "Y"
}

Para obter o GUID do IDCS

https://idcs-105bbbdfe5644611bf7ce04496073adf.identity.oraclecloud.com/ui/v1/adminconsole/?root=users

No URL acima, idcs-105bbbdfe5644611bf7ce04496073adf é o GUID do IDCS para seu domínio de identidades.

Documentação do Oracle Cloud Infrastructure

Casos de Uso do Exadata

Lista de Permissões do Firewall do Exadata

Dimensionamento do Exadata com Intermitência