Gestión de instancias de Exadata
El panel de control Mis servicios y las API están en desuso.
Los siguientes procedimientos le guiarán por la creación, modificación y supresión de las instancias de Exadata que se utilizan con la API de Mis servicios de Oracle Cloud.
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.
Requisitos previos
Para poder gestionar las instancias de Exadata, debe hacer lo siguiente:
- Suscribirse a un servicio de Oracle Cloud
- Obtener credenciales de cuenta con los roles necesarios asignados
- Determinar el punto final de su API
Para acceder a la API de Mis servicios de Oracle Cloud, debe solicitar una suscripción de prueba o de pago a un servicio de Oracle Cloud.
Pida al administrador de su cuenta los siguientes elementos para acceder a la API de Mis servicios de Oracle Cloud:
-
Credenciales de la cuenta:
-
Nombre de usuario y contraseña
-
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.
-
-
Roles necesarios asignados al nombre de usuario anterior
Inserte el ID de dominio de identidad proporcionado por el administrador de la cuenta (<dominio>) entre /itas/
y /myservices/
.
Ejemplo:
https://itra.oraclecloud.com/itas/<domain>/myservices/api/v1/serviceEntitlements
Creación de instancias de Exadata
En esta sección se describe cómo crear una instancia básica de Exadata, una instancia con configuración de red IP personalizada y una instancia que admita varias VM.
Envíe una solicitud con la carga útil necesaria para crear una nueva instancia para un derecho de servicio determinado (Exadata, en nuestro caso).
En el siguiente ejemplo, <dominio> es el ID de dominio de identidad.
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
Nombre | Descripción |
---|---|
requestPayload.name |
Necesario: sí Tipo: cadena Nombre de la instancia de Exadata. Este nombre:
|
requestPayload. serviceEntitlementId |
Necesario: sí Tipo: cadena Derecho de servicio de la instancia de Exadata. Consulte " detección de derecho de servicio de Exadata". Tenga en cuenta que no se debe incluir ningún prefijo "cesi-" o "sub-". |
requestPayload. customAttributes. ExaUnitName |
Necesario: sí Tipo: cadena Nombre para el entorno de Exadata Database Machine. Este nombre se utiliza también como nombre de cluster para la instalación de Oracle Grid Infrastructure. |
requestPayload. customAttributes. CreateSparse |
Necesario: sí Tipo: cadena "Y", para crear un grupo de discos basado en discos de cuadrícula dispersos; de lo contrario, "N" . Debe seleccionar esta opción para activar las instantáneas de Exadata Cloud Service. Las instantáneas de Exadata permiten la creación y destrucción de forma muy rápida y sencilla de clones de bases de datos de Oracle eficientes en cuanto a espacio. |
requestPayload. customAttributes. BackupToDisk |
Necesario: sí Tipo: cadena "Y", para utilizar "Copias de seguridad de bases de datos en el almacenamiento de Exadata"; de lo contrario, "N". Esta opción configura el almacenamiento de Exadata para activar las copias de seguridad de la base de datos local en el almacenamiento de Exadata. |
requestPayload. customAttributes. isBYOL |
Necesario: sí Tipo: cadena "Y", para indicar a la instancia de Exadata Cloud Service que utilice las licencias de Oracle Database que le proporcione, en lugar de las licencias que se incluyen como parte de la suscripción al servicio; de lo contrario, "N". Esta opción solo afecta a la facturación que está asociada a la instancia de servicio. No afecta a la configuración técnica de la instancia de Exadata Cloud Service. |
requestPayload. customAttributes. PickRackSize |
Necesario: sí Tipo: cadena Especifique la configuración de rack para la instancia de servicio. Los valores exactos permitidos dependen de su compra. Los valores típicos son "Rack completo", "Medio rack", "Cuarto de rack" u" Octavo de rack". |
requestPayload. customAttributes. SELECTED_DC_ID |
Necesario: sí Tipo: cadena Centro de datos que alojará su instancia de Exadata Cloud Service. Consulte "Detección de derecho de servicio de Exadata" para obtener los ID de centro de datos aplicables. |
Envíe una solicitud con los atributos ClientNetwork y BackupNetwork como parte de la carga útil. En el siguiente ejemplo se incluyen estos atributos opcionales, así como los atributos necesarios.
En el siguiente ejemplo, <dominio> es el ID de dominio de identidad.
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
Nombre | Descripción |
---|---|
requestPayload. customAttributes. ClientNetwork |
Necesario: sí Tipo: Url Definiciones de red IP para la red que se utilizan principalmente para el acceso de cliente a los servidores de base de datos. Normalmente, las aplicaciones acceden a las bases de datos de Exadata Cloud Service mediante esta red utilizando Oracle Net Services junto con las interfaces de nombre único de acceso de cliente (SCAN) e IP virtual (VIP) de Oracle RAC. |
requestPayload. customAttributes. BackupNetwork |
Necesario: sí Tipo: Url Definiciones de red IP para la red que se utiliza normalmente para acceder a los servidores de base de datos con distintos fines, incluidas las copias de seguridad y las transferencias masivas de datos. |
Si el entorno del sistema de Exadata está activado para admitir varios clusters de máquina virtual (VM), puede definir hasta ocho clusters y especificar el modo de asignarles los recursos globales del sistema de Exadata.
En una configuración con varios clusters de VM, a cada cluster de VM se le asigna una parte dedicada de los recursos globales del sistema de Exadata, sin exceder el aprovisionamiento ni realizar un uso compartido de los recursos. En los nodos informáticos, se define una VM independiente para cada cluster de VM, y a cada VM se le asigna una parte dedicada de los recursos disponibles de CPU, memoria y disco local del nodo informático. A cada cluster de VM también se le asigna una parte dedicada del almacenamiento global de Exadata.
Envíe una solicitud con los atributos EXAUNIT_ALLOCATIONS y MULTIVM_ENABLED como parte de la carga útil. En el siguiente ejemplo se incluyen estos atributos opcionales, así como los atributos necesarios.
En el siguiente ejemplo, <domain> es el ID de dominio de identidad y <base64_encoded_string> es una codificación en base64 de la carga útil siguiendo el ejemplo.
Ejemplo de carga útil para la solicitud:
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"
}
}
]
}
Carga útil para <cadena_codificada_base64>:
{
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
Nombre | Descripción |
---|---|
requestId |
Necesario: opcional Tipo: cadena UUID único |
TotalNumOfCores ForCluster |
Necesario: sí Tipo: cadena Número de núcleos de CPU asignados al cluster de VM. Número total de núcleos de CPU asignados de manera uniforme en todos los nodos informáticos del cluster de VM. Debe ser un múltiplo de numComputes que devuelve una llamada a ecra/endpoint/clustershapes. |
TotalMemoryInGb |
Necesario: sí Tipo: cadena Cantidad de memoria (en GB) asignada al cluster de VM. Cantidad total de memoria asignada de manera uniforme a todos los nodos informáticos del cluster de VM. Debe ser un múltiplo de numComputes que devuelve una llamada a ecra/endpoint/clustershapes. |
StorageInTb |
Necesario: sí Tipo: cadena Cantidad total de almacenamiento de Exadata (en TB) asignada al cluster de VM. Este almacenamiento se asigna de manera uniforme desde todos los servidores Exadata Storage Server. |
OracleHomeDiskSize InGb |
Necesario: sí Tipo: cadena Cantidad de almacenamiento en disco local (en GB) que se asigna a cada servidor de base de datos en el primer cluster de VM. |
Modificación de instancias de Exadata
En esta sección se describe cómo agregar un cluster a una instancia existente, cómo remodelar un cluster y cómo suprimirlo.
Envíe una solicitud con la operationItemDefinition de CIM-Exadata-CUSTOM-PRODUCTION-UPDATE y una codificación en base64 de una carga útil que incluya el valor de operación de AddCluster.
En el siguiente ejemplo, <domain> es el ID de dominio de identidad, <instanceId> y <serviceEntitlementId> se devuelven de iTAS serviceInstances, y <base64_encoded_string> es una codificación en base64 de la carga útil siguiendo el ejemplo.
Ejemplo de carga útil para la solicitud:
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"
}
}
]
}
Carga útil para <cadena_codificada_base64>:
{
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}
]
}
Envíe una solicitud con la operationItemDefinition de CIM-Exadata-CUSTOM-PRODUCTION-UPDATE y una codificación en base64 de una carga útil que incluya el valor de operación de ReshapeCluster.
En el siguiente ejemplo, <domain> es el ID de dominio de identidad y <base64_encoded_string> es una codificación en base64 de la carga útil siguiendo el ejemplo.
Ejemplo de carga útil para la solicitud:
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"
}
}
]
}
Carga útil para <cadena_codificada_base64>:
{
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
]
}
-
Solo se puede modificar un atributo por solicitud de remodelación. La carga útil solo debe contener el atributo modificado. Ejemplo:
{ExaunitProperties : [{name:Operation,value : ReshapeCluster}, { name:ExaunitID,value:5 },{ name:TotalNumOfCoresForCluster , value:6}] }
- Al realizar una remodelación con el atributo
OracleHomeDiskSizeInGb
, utilice el nombreOhomePartitionInGB
. - El valor de
TotalNumOfCoresForCluster
debe ser un múltiplo denumComputes
que devuelve una llamada aecra/endpoint/clustershapes
. - El valor de
TotalMemoryInGb
debe ser un múltiplo denumComputes
que devuelve una llamada aecra/endpoint/clustershapes
.
Envíe una solicitud con la operationItemDefinition de CIM-Exadata-CUSTOM-PRODUCTION-UPDATE y una codificación en base64 de una carga útil que incluya el valor de operación de DeleteCluster.
En el siguiente ejemplo, <domain> es el ID de dominio de identidad y <base64_encoded_string> es una codificación en base64 de la carga útil siguiendo el ejemplo.
Ejemplo de carga útil para la solicitud:
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"
}
}
]
}
Carga útil para <cadena_codificada_base64>:
{
ExaunitProperties: [
{name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d202}, // Optional
{name:ExaunitID, value:2},
{name:Operation, value:DeleteCluster}
]
}
Supresión de instancias de Exadata
En esta sección se describe cómo suprimir instancias de Exadata.
Suprima todos los clusters de varias VM existentes antes de suprimir la instancia de Exadata. Al seguir esta instrucción se evita que la instancia acabe en un estado no válido.
Envíe una solicitud con la operationItemDefinition de CIM-Exadata-CUSTOM-PRODUCTION-DELETE.
En el siguiente ejemplo, <dominio> es el ID de dominio de identidad.
Ejemplo de carga útil para la solicitud:
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"
}
}
]
}
Detección de derechos e instancias
En esta sección se describe cómo detectar derechos de servicio e instancias de servicio.
Envíe la siguiente solicitud:
GET /itas/<domain>/myservices/api/v1/serviceEntitlements?serviceDefinitionNames=Exadata
Ejemplo de carga útil devuelta para esta solicitud:
{
"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
}
Centros de datos aplicables:
Utilice:
/itas/<domain>/myservices/api/v1/serviceEntitlements/{ServiceEntitlementId}?expands=serviceInstancesEligibleDataCenters
donde {ServiceEntitlementId}
es un ID de derecho de servicio como, por ejemplo, cesi-500074601
. Esto proporcionará información adicional como:
"serviceInstancesEligibleDataCenters": [
{
"id": "US001"
}
],
Envíe la siguiente solicitud:
GET /<domain>/myservices/api/v1/serviceInstances?serviceDefinitionNames=Exadata
Ejemplo de carga útil devuelta para esta solicitud:
{
"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
}