Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

CreateCloudExadataInfrastructure

Creates an Exadata infrastructure.

Request Syntax


{
   "availabilityZone": "string",
   "availabilityZoneId": "string",
   "clientToken": "string",
   "computeCount": number,
   "customerContactsToSendToOCI": [ 
      { 
         "email": "string"
      }
   ],
   "databaseServerType": "string",
   "displayName": "string",
   "maintenanceWindow": { 
      "customActionTimeoutInMins": number,
      "daysOfWeek": [ 
         { 
            "name": "string"
         }
      ],
      "hoursOfDay": [ number ],
      "isCustomActionTimeoutEnabled": boolean,
      "leadTimeInWeeks": number,
      "months": [ 
         { 
            "name": "string"
         }
      ],
      "patchingMode": "string",
      "preference": "string",
      "skipRu": boolean,
      "weeksOfMonth": [ number ]
   },
   "shape": "string",
   "storageCount": number,
   "storageServerType": "string",
   "tags": { 
      "string" : "string" 
   }
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

availabilityZone

The name of the Availability Zone (AZ) where the Exadata infrastructure is located.

This operation requires that you specify a value for either availabilityZone or availabilityZoneId.

Example: us-east-1a

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: No

availabilityZoneId

The AZ ID of the AZ where the Exadata infrastructure is located.

This operation requires that you specify a value for either availabilityZone or availabilityZoneId.

Example: use1-az1

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: No

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The client token is valid for up to 24 hours after it's first used.

Type: String

Length Constraints: Minimum length of 8. Maximum length of 64.

Pattern: [a-zA-Z0-9_\/.=-]+

Required: No

computeCount

The number of database servers for the Exadata infrastructure. Valid values for this parameter depend on the shape. To get information about the minimum and maximum values, use the ListDbSystemShapes operation.

Type: Integer

Required: Yes

customerContactsToSendToOCI

The email addresses of contacts to receive notification from Oracle about maintenance updates for the Exadata infrastructure.

Type: Array of CustomerContact objects

Required: No

databaseServerType

The database server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9_\/.=-]+

Required: No

displayName

A user-friendly name for the Exadata infrastructure.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z_](?!.*--)[a-zA-Z0-9_-]*

Required: Yes

maintenanceWindow

The maintenance window configuration for the Exadata Cloud infrastructure.

This allows you to define when maintenance operations such as patching and updates can be performed on the infrastructure.

Type: MaintenanceWindow object

Required: No

shape

The model name of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9_\/.=-]+

Required: Yes

storageCount

The number of storage servers to activate for this Exadata infrastructure. Valid values for this parameter depend on the shape. To get information about the minimum and maximum values, use the ListDbSystemShapes operation.

Type: Integer

Required: Yes

storageServerType

The storage server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9_\/.=-]+

Required: No

tags

The list of resource tags to apply to the Exadata infrastructure.

Type: String to string map

Map Entries: Maximum number of 200 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No

Response Syntax


{
   "cloudExadataInfrastructureId": "string",
   "displayName": "string",
   "status": "string",
   "statusReason": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

cloudExadataInfrastructureId

The unique identifier of the Exadata infrastructure.

Type: String

displayName

The user-friendly name for the Exadata infrastructure.

Type: String

status

The current status of the Exadata infrastructure.

Type: String

statusReason

Additional information about the status of the Exadata infrastructure.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

HTTP Status Code: 400

ConflictException

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

HTTP Status Code: 400

InternalServerException

Occurs when there is an internal failure in the Oracle Database@AWS service. Wait and try again.

HTTP Status Code: 500

ServiceQuotaExceededException

You have exceeded the service quota.

HTTP Status Code: 400

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 400

ValidationException

The request has failed validation because it is missing required fields or has invalid inputs.

HTTP Status Code: 400