Casos de uso de Exadata

Importante

El panel de control Mis servicios y las API están en desuso.

Los siguientes ejemplos de casos de uso le permiten empezar a trabajar con las operaciones de Exadata disponibles en la API de Mis servicios de Oracle Cloud.

Importante

Estos procedimientos SÓLO se utilizan con Oracle Database Exadata Database Service on Cloud@Customer. Para obtener más información, consulte Administración de Oracle Database Exadata Cloud at Customer. Estos procedimientos NO se aplican a la instancia de Exadata Cloud Service disponible en Oracle Cloud Infrastructure.

Lista de permitidos de firewall de Exadata

Para permitir el acceso a la instancia de Exadata Cloud Service, puede configurar reglas de seguridad y asociarlas a la instancia. Las reglas de seguridad definen una lista de permitidos de puntos de acceso de red permitidos.

El firewall proporciona un sistema de reglas y grupos. Por defecto, el firewall deniega el acceso de red a la instancia de Exadata Cloud Service. Al activar una regla de seguridad, se activa el acceso a la instancia de Exadata Cloud Service. Para activar el acceso, debe:

Crear un grupo de seguridad y reglas de seguridad que definan permisos de acceso de red específicos.
Asignar el grupo de seguridad a su instancia de Exadata Cloud Service.

Puede definir varios grupos de seguridad, y cada uno de ellos puede contener varias reglas de seguridad. Puede asociar varios grupos de seguridad a cada instancia de Exadata Cloud Service, y cada uno de ellos se puede asociar a varias instancias de Exadata Cloud Service. Puede activar y desactivar reglas de seguridad de manera dinámica modificando los grupos de seguridad asociados a cada instancia de Exadata Cloud Service.

Para activar el acceso a una instancia de Exadata Cloud Service:

Nota

En los siguientes ejemplos, <dominio> es el ID de dominio de identidad. El ID de dominio de identidad puede ser el GUID de IDCS que identifica el dominio de identidad de los usuarios en Identity Cloud Service (IDCS) o el nombre del dominio de identidad de una cuenta en la nube tradicional.

Obtenga los ID de instancia de servicio.

Operación: GET ServiceInstances

Ejemplo

Ejemplo de solicitud:

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

Ejemplo de carga útil devuelta para esta solicitud:

{
  "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
}

Con este ejemplo de carga útil se devuelve el ID de instancia de servicio csi-585928949, que forma parte del ID de derecho de servicio cesi-585927251.

Obtenga los ID de configuración de servicio.

Operación: GET SIServiceConfigurations

Ejemplo

Ejemplo de solicitud utilizando el ID de instancia de servicio csi-585928949:

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

Ejemplo de carga útil devuelta para esta solicitud:

{
 "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"
   }
 ]
}

En este ejemplo de carga útil se muestra que se utiliza /itas/<dominio>/myservices/api/v1/serviceInstances/csi-585928949/serviceConfigurations/Exadata/securityGroupAssignments para el firewall de Exadata.

Obtenga los grupos de seguridad actuales para el derecho de servicio.

Operación: GET SEExadataSecurityGroups

Ejemplo

Ejemplo de solicitud utilizando el ID de derecho de servicio cesi-585927251:

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

Ejemplo de carga útil devuelta para esta solicitud:

{
  "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"
}

En este ejemplo de carga útil se muestran dos grupos de seguridad definidos para el ID de derecho de servicio especificado.

Obtenga las asignaciones del grupo de seguridad actuales para la instancia de servicio.

Operación: GET SIExadataSecurityGroupAssignments

Ejemplo

Ejemplo de solicitud utilizando el ID de instancia de servicio csi-585928949:

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

Ejemplo de carga útil devuelta para esta solicitud:

{
  "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"
}

En este ejemplo de carga útil se muestra un grupo de seguridad asignado a la instancia de servicio csi-585928949.

Cree un grupo de seguridad con reglas de seguridad.

Operación: POST SEExadataSecurityGroups

Ejemplo

Ejemplo de solicitud utilizando el ID de derecho de servicio 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:


Nombre	Descripción
customerId	Necesario: sí Cadena Debe ser igual que `<serviceEntitlementId>`
direction	Necesario: sí Cadena Valores permitidos: [ingress \| egress] para entrada y salida.
proto	Necesario: sí Cadena Valores permitidos: [tcp \| udp].
startPort	Necesario: sí Entero startPort define el inicio de un rango de puertos para abrir/incluir en la lista blanca [0 - 65535].
endPort	Necesario: sí Entero endPort define el final de un rango de puertos para abrir/incluir en la lista blanca [0 - 65535].
ipSubnet	Necesario: sí Cadena Dirección IP única o rango especificado en notación CIDR.
ruleInterface	Necesario: sí Cadena Valores permitidos: [admin \| client \| backup], donde: admin: especifica que la regla se aplica a las comunicaciones de red a través de la interfaz de red de administración. La red de administración se utiliza normalmente para admitir tareas de administración mediante sesiones de terminal, agentes de supervisión, etc. client: especifica que la regla se aplica a las comunicaciones de red a través de la interfaz de red de acceso de cliente, que suelen utilizar las conexiones de Oracle Net Services. backup: especifica que la regla se aplica a las comunicaciones de red mediante la interfaz de red de copia de seguridad, que normalmente se utiliza para transportar información de copia de seguridad hacia y desde el almacenamiento basado en red que está separado de Exadata Cloud Service.

Si se realiza correctamente, la solicitud POST devolverá el ID único del grupo de seguridad recién creado. Para el siguiente paso, asumiremos que el ID del grupo de seguridad recién creado es 3.

Nota

Un grupo de seguridad también se puede modificar o suprimir. Consulte API de Mis servicios de Oracle Cloud.

Asigne el grupo de seguridad a una instancia de servicio.

Operación: POST SIExadataSecurityGroupAssignments
Ejemplo

Ejemplo de solicitud, utilizando la instancia de servicio csi-585928949 y el ID de grupo de seguridad 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:

Nombre Descripción

customerId
Necesario: sí

Cadena

Debe ser igual que serviceEntitlementId.

Si se realiza correctamente, la solicitud POST devolverá el identificador único de la asignación de grupo de seguridad recién creada.

Nota

Una asignación de grupo de seguridad también se puede suprimir. Consulte API de Mis servicios de Oracle Cloud.

Ahora puede verificar todos sus grupos de seguridad y asignaciones. Consulte:
- Obtenga los grupos de seguridad actuales para el derecho de servicio.
- Obtenga las asignaciones del grupo de seguridad actuales para la instancia de servicio.

Nombre	Descripción
customerId	Necesario: sí Cadena Debe ser igual que serviceEntitlementId.

Para obtener el GUID de IDCS

Vaya a la página Usuarios del panel de control Mis servicios y haga clic en Consola de Identity. La URL en el campo de dirección del explorador muestra el GUID de IDCS para el dominio de identidad. Por ejemplo:

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

En la URL anterior, idcs-105bbbdfe5644611bf7ce04496073adf es el GUID de IDCS del dominio de identidad.

Escala de Exadata con repartición

Puede modificar temporalmente la capacidad de su entorno de Exadata configurando la repartición. La repartición es un método que puede utilizar para escalar las instancias no medidas de Exadata Cloud Service en un sistema de Exadata.

Para escalar verticalmente las instancias no medidas, aumente el número de nodos informáticos modificando el atributo burstOcpu del host. Cuando ya no necesite los nodos adicionales, actualice el atributo burstOcpu a su configuración original.

Nota

Obtenga los ID de instancia de servicio.

Operación: GET ServiceInstances

Ejemplo

Ejemplo de solicitud:

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

Ejemplo de carga útil devuelta para esta solicitud:

{
  "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
}

En esta carga útil de ejemplo se devuelve el ID de instancia de servicio csi-585928949.

Obtenga los ID de configuración de servicio.

Operación: GET SIServiceConfigurations

Ejemplo

Ejemplo de solicitud utilizando el ID de instancia de servicio csi-585928949:

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

Ejemplo de carga útil devuelta para esta solicitud:

{
 "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"
   }
 ]
}

Obtenga la configuración del nodo informático actual.

Operación: GET SIExadataBursting

Ejemplo

Ejemplo de solicitud utilizando el ID de instancia de servicio csi-585928949:

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

Ejemplo de carga útil devuelta para esta solicitud:

{ 
   "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 los valores de burstOcpu.

Operación: PUT SIExadataBursting

Puede modificar burstOcpu a un valor que sea como máximo el valor de maxBurstOcpu. En este ejemplo, se agregan dos nodos informáticos a cada host.

Ejemplo

Ejemplo de solicitud utilizando la instancia de servicio 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:


Nombre	Descripción
burstOcpu	Necesario: sí Tipo: Entero, Valor mínimo: 0, Valor máximo: maxBurstOcpu Número de núcleos adicionales

Nota

Esta acción puede tardar unos minutos en realizarse.

Verifique la nueva configuración del nodo informático.

Operación: GET SIExadataBursting

Ejemplo

Ejemplo de solicitud utilizando el ID de instancia de servicio csi-585928949:

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

Ejemplo de carga útil devuelta para esta solicitud:

{ 
   "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 obtener el GUID de IDCS

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

En la URL anterior, idcs-105bbbdfe5644611bf7ce04496073adf es el GUID de IDCS del dominio de identidad.

Documentación de Oracle Cloud Infrastructure

Casos de uso de Exadata

Lista de permitidos de firewall de Exadata

Escala de Exadata con repartición