The request body defines the details of the create request.
Root Schema : create-postrequestm
Type: object
Show Source
-
adminConsoleAccessCIDRRange(optional):
string
Flag that specifies the Classless Inter-Domain Routing (CIDR) range to access the WebLogic Server Administration Console. The default value is 0.0.0.0/0. To specify a value, enableAdminConsole
must be set to true.
-
adminUserID(optional):
string
This attribute is only applicable if a value is specified in
identityStripe
.
The administrator of the specified identity domain or a valid user in the specified identity domain.
-
assignPublicIP(optional):
boolean
This attribute is applicable only when provisioning an Oracle Java Cloud Service instance in a region on Oracle Cloud Infrastructure Classic, and a custom IP network is specified in
ipNetwork
.
Flag that specifies whether to assign (true
) or not assign (false
) public IP addresses to the nodes in your service instance. The default is true
, which means any node added during service instance provisioning, or later added as part of a scaling operation, will have a public IP address assigned to it. You will be able to directly access the nodes from the public Internet.
When set to false
, this means any node added during instance provisioning, or later added as part of a scaling operation, will not have a public IP address assigned to it. You will not be able to directly access the nodes from the public Internet.
-
availabilityDomain(optional):
string
This required attribute is applicable only when creating Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
Name of a data center location in the Oracle Cloud Infrastructure region that is specified in region
. A region is a localized geographic area, composed of one or more availability domains (data centers).
The availability domain value format is an account-specific prefix followed by <region>-<ad>
. For example, FQCn:US-ASHBURN-AD1
where FQCn
is the account-specific prefix.
See Regions and Availability Domains in the Oracle Cloud Infrastructure documentation.
-
backupDestination(optional):
string
This attribute is applicable only when
serviceLevel
is set to
PAAS
. Specifies whether to enable backups for this Oracle Java Cloud Service instance.
Valid values include:
BOTH
- Enable backups. This is the default. This means automated scheduled backups of the service instance are enabled, and on-demand backups can be initiated. All backups are stored on disk (in a volume attached to the nodes) and in the object storage container or bucket that is specified in cloudStorageContainer
. See also disabledScheduledCoordinatedBackups
.NONE
- Do not enable backups. This means automated scheduled backups of the service instance are not enabled, and on-demand backups cannot be initiated. When set to NONE
, cloudStorageContainer
is not required.
-
cloudStorageContainer(optional):
string
URI of the object storage bucket or container for storing Oracle Java Cloud Service instance backups.
Do not use a bucket or container that you use to back up Oracle Java Cloud Service instances for any other purpose. For example, do not also use the same bucket or container to back up the associated infrastucture schema database. Using one bucket or container for multiple purposes can result in billing errors.
This attribute is not required if:
backupDestination
is set to NONE
serviceLevel
is set to BASIC
On Oracle Cloud Infrastructure, the object storage bucket must be created before provisioning your Oracle Java Cloud Service instance. Do not use the same bucket for more than one instance. For the instructions to create a bucket, see Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure in the Oracle Cloud Infrastructure documentation. Enter the bucket URL in the following format:
https://swiftobjectstorage.<region>.oraclecloud.com/v1/<namespace>/<bucket>
.
To find out your namespace, sign in to the Oracle Cloud Infrastructure web console, click the tenancy name, and look for the Object Storage Namespace field.
Example:
https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/acme/mybucket
On Oracle Cloud Infrastructure Classic and Oracle Cloud at Customer, the object storage container does not have to be created ahead of provisioning your Oracle Java Cloud Service instance.
To specify the container (existing or new), use one of the following formats:
Storage-<identitydomainid>/<containerName>
<storageservicename>-<identitydomainid>/<containerName>
<restEndPointURL>/<containerName>
To identify the REST endpoint URL of your object storage service, see Finding the REST Endpoint URL for Your Cloud Account in Using Oracle Cloud Infrastructure Object Storage Classic.
If your Oracle Cloud account is created with OAuth protected object storage and you do not want to use the default OAuth protected object storage for instance backups, see useOAuthForStorage
.
-
cloudStorageContainerAutoGenerate(optional):
boolean
This attribute is not applicable when provisioning an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure.
Flag that specifies whether to create (true
) or not create (false
) the object storage container if the name specified in cloudStorageContainer
does not exist. The default is false
.
-
cloudStoragePassword(optional):
string
Password for the object storage user. The password must be specified if
cloudStorageContainer
is set, but note the following:
On Oracle Cloud Infrastructure, this is the Auth token generated on Oracle Cloud Infrastructure for the user specified in cloudStorageUser
.
On Oracle Cloud Infrastructure Classic and Oracle Cloud at Customer, this is the password for the Oracle Cloud Infrastructure Object Storage Classic user who has read and write access to the container that is specified in cloudStorageContainer
. This attribute is not required for the BASIC service level.
If a service instance on Oracle Cloud Infrastructure Classic is using Oracle Identity Cloud Service, this attribute is not required if the current cloud user is entitled to use Oracle Cloud Infrastructure Object Storage Classic.
-
cloudStorageUser(optional):
string
User name for the object storage user. The user name must be specified if
cloudStorageContainer
is set, but note the following:
On Oracle Cloud Infrastructure, this is the user name for the Oracle Cloud Infrastructure Object Storage user.
On Oracle Cloud Infrastructure Classic and Oracle Cloud at Customer, this is the user name for the Oracle Cloud Infrastructure Object Storage Classic user who has read and write access to the container that is specified in cloudStorageContainer
. This attribute is not required for the BASIC
service level.
If a service instance on Oracle Cloud Infrastructure Classic is using Oracle Identity Cloud Service, this attribute is not required if the current cloud user is entitled to use Oracle Cloud Infrastructure Object Storage Classic.
-
components(optional):
object components
Groups properties for the Oracle WebLogic Server component (WLS
) and the optional Oracle Traffice Director (OTD
) component.
-
configureLoadBalancer(optional):
boolean
This attribute is applicable only when creating an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure.
Flag that specifies whether to enable the Oracle-managed load balancer for this service instance. Default value is false
. Note the following:
- If you need the ability to update the Oracle Cloud Infrastructure Load Balancing configuration for an Oracle Java Cloud Service instance, do not set the value to
true
because you cannot update the Oracle Cloud Infrastructure Load Balancing configuration if the load balancer is provisioned automatically during the creation of the service instance. To be able to update the configuration of the Oracle-managed load balancer instance provisioned for your service instance, you must create and configure the load balancer manually (after you have created your service instance). See Set Up an Oracle Cloud Infrastructure Load Balancer in Administering Oracle Java Cloud Service. - The value must be set to
true
if useIdentityService
is set to true
(to enable Oracle Identity Cloud Service for authenticating Oracle WebLogic Server administrators and application users). - The value can be
true
without setting useIdentityService
to true
.
Provisioning a load balancer is recommended if you are configuring more than one Managed Server. Only configureLoadBalancer
or provisionOTD
(Oracle Traffic Director as the user-managed load balancer) can be true
(in other words, if one is true
, the other must be false
).
When configureLoadBalancer
is set to true
, the Oracle-managed, dual-node load balancer (that can be accessed using a single IP address) is provisioned and configured for the Oracle Java Cloud Service instance. The Oracle-managed load balancer, which is maintained and patched by Oracle, runs on Oracle Cloud Infrastructure Load Balancing. See loadbalancer
for the load balancer options you can set (during creation of the Oracle Java Cloud Service instance). The Oracle-managed load balancer that is provisioned automatically cannot be removed after the service instance is created.
Note also the following when considering whether to use the Oracle-managed load balancer or Oracle Traffic Director (OTD) as a user-managed load balancer: All the nodes in a service instance (WebLogic Server WLS and OTD nodes) are attached to the subnet that you can specify for the instance. If you want the WLS nodes in a private subnet and the load balancer in a public subnet, then use subnet
to attach the instance to a private subnet, enable the use of the Oracle-managed load balancer, and specify public subnets
for the loadbalancer
nodes.
-
disabledScheduledCoordinatedBackups(optional):
boolean
Flag that specifies whether a scheduled Oracle Java Cloud Service instance backup will include a backup of the associated database deployment.
A value of false
means a backup of the associated database deployment is coordinated and enabled. A value of true
means a coordinated database deployment backup is not performed (disabled) during a scheduled backup of this service instance.
Default is true
.
If the Oracle Java Cloud Service instance has backupDestination
set to NONE
, the attribute is ignored.
Note: This attribute is not applicable to an Oracle Java Cloud Service instance that uses Oracle Database Exadata Cloud Service for the required infrastructure schema; the attribute is ignored if it is specified. This attribute is also not applicable to service instances that use an Oracle Autonomous Transaction Processing database or Oracle Cloud Infrastructure Database (DB system) to host the infrastructure schema. Coordinated backups are not available for such service instances.
-
edition(optional):
string
Software edition for Oracle WebLogic Server. Valid values include:
SE
- Standard edition. See Oracle WebLogic Server Standard Edition. Do not use the Standard edition if you are enabling domain partitions using WebLogic Server 12.2.1, or using upperStackProductName
to provision a service instance for an Oracle Fusion Middleware product. Scaling a cluster is also not supported on service instances that are based on the Standard edition.EE
- Enterprise Edition. This is the default for both PAAS and BASIC service levels. See Oracle WebLogic Server Enterprise Edition.SUITE
- Suite edition (Enterprise Edition with Coherence). See Oracle WebLogic Suite.
Set the edition
value to SUITE
if either is applicable:
- You are creating an instance with a caching (data grid) cluster
- You want a high performance edition
On Oracle Cloud Infrastructure: Additional restrictions may apply. For example, SUITE
is required if you are using an Oracle Cloud Infrastructure RAC database for the associated infrastructure schema. See the following:
-
enableAdminConsole(optional):
boolean
Flag that specifies whether to enable (
true
) or disable (
false
) the access rules that control external communication to the WebLogic Server Administration Console, Fusion Middleware Control, and Load Balancer Console.
On Oracle Cloud Infrastructure: The default value is true
. The security rule that controls access to the WebLogic Server Administration Console and other consoles is enabled by default. You cannot disable it during provisioning.
On Oracle Cloud Infrastructure Classic: The default value is false
. If you do not set it to true
, after the service instance is created, you have to explicitly enable the rules for the administration consoles before you can gain access to the consoles. See Disable, Enable or Delete an Access Rule.
-
enableNotification(optional):
boolean
Flag that specifies whether to enable (
true
) or disable (
false
) notifications by email. If this property is set to
true
, you must specify a value in
notificationEmail
.
Currently, notifications are sent only when service instance provisioning is successful or not successful.
-
identityStripe(optional):
string
This optional attribute is applicable only to Cloud accounts where multiple identity domains are supported in Oracle Identity Cloud Service.
Name of a secondary identity domain where the Oracle Java Cloud Service instance will be provisioned.
If not specified, the service instance is provisioned in the primary identity domain (default). The primary identity domain is the initial domain that was created when the Cloud account was set up.
Note the following when specifying a secondary identity domain:
- Your associated infrastructure schema database must be deployed on Oracle Autonomous Transaction Processing or Oracle Cloud Infrastructure Database (DB System).
useIdentityService
must be set to true
(that is, Oracle Identity Cloud Service must be enabled).configureLoadBalancer
must also be set to true
.
-
ipNetwork(optional):
string
This attribute is not applicable when provisioning Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
This attribute is applicable only to accounts where regions are supported.
The three-part name of a custom IP network to attach this service instance to. For example:
/Compute-identity_domain/user/object
A region
name must be specified in order to use ipNetwork
. Only those IP networks already created in the specified Oracle Cloud Infrastructure Compute Classic region can be used.
See Creating an IP Network in Using Oracle Cloud Infrastructure Compute Classic.
If you are provisioning a Java Cloud Service instance with useIdentityService
set to true
, the ipNetwork
you want to use must meet one of the following conditions:
- A public-facing (Internet-facing) or private load balancer must already be attached to the
ipNetwork
you specify. - The
ipNetwork
you specify is connected to an IP Network Exchange that has another IP network to which a public-facing or private load balancer is already attached.
During provisioning, if a load balancer is not found, an error message is returned and the instance creation operation will stop. You must first attach a public or private load balancer to the ipNetwork
you want to use before you try to create the Java Cloud Service instance again. See Creating a Load Balancer in Using Oracle Cloud Infrastructure Load Balancing Classic.
If you specify an IP network, the dbServiceName
for this service instance must also be attached to an ipNetwork
. If this service instance and the associated database deployment are attached to different IP networks, the two IP networks must be connected to the same IP network exchange.
A consequence of using an IP network is that the auto-assigned IP address could change each time the service instance is started. To assign fixed public IP addresses to a service instance that is attached to an IP network, you can first create reserved IP addresses, then provision the service instance to use those persistent IP addresses in ipReservations
. Note that to use ipReservations
, assignPublicIP
must be true
.
See IP Reservations REST Endpoints for information about how to find unused IP reservations and, if needed, create new IP reservations.
-
isBYOL(optional):
boolean
Flag that specifies whether to apply an existing on-premises license for Oracle WebLogic Server (
true
) to the new Oracle Java Cloud Service instance you are provisioning. A Universal Credits subscription or a Government subscription is required in order to use existing licenses. BYOL instances are billed at a lower rate than license-included instances.
On Oracle Cloud at Customer: Default value is false
.
On Oracle Cloud Infrastructure and Oracle Cloud Infrastructure Classic:
- If the Oracle Cloud account does not have BYOL entitlements, the default value is
false
. You cannot change it to true
. A validation error will occur if you try to provision a service instance without any BYOL entitlements. - If the Oracle Cloud account only has BYOL entitlements, the default value is
true
. You cannot change it to false
. - If the Oracle Cloud account has a mix of BYOL entitlements and non-BYOL resources, the default value is
true
. You can, however, change it to false
to provision a service instance without using a BYOL entitlement.
Note that you are responsible for ensuring that you have the required licenses for all BYOL instances in Oracle Java Cloud Service. For example, before you scale up or scale out a BYOL instance, you must have enough WebLogic Server licenses for the additional OCPUs that will be allocated to the instance after it is scaled.
See Frequently Asked Questions: Oracle BYOL to PaaS. For the processor conversion ratios and license requirements, refer to the document titled Oracle PaaS and IaaS Universal Credits Service Descriptions.
-
loadbalancer(optional):
object loadbalancer
Groups properties for the Oracle-managed load balancer, which is maintained and patched by Oracle.
The Oracle-managed load balancer is an instance of Oracle Cloud Infrastructure Load Balancing (on Oracle Cloud Infrastructure) or Oracle Cloud Infrastructure Load Balancing Classic (on Oracle Cloud Infrastructure Classic).
This attribute is applicable when provisioning a service instance with useIdentityService
set to true
. See loadBalancingPolicy
for the load balancer policy options you can set.
In addition, on Oracle Cloud Infrastructure:
- This attribute is also applicable when provisioning a service instance without enabling Oracle Identity Cloud Service, but with
configureLoadBalancer
set to true
. - Regardless of whether
useIdentityService
is set to true
, if a specific subnet
is specified for the service instance, you must also specify subnets for the Oracle-managed load balancer nodes (node 1 and node 2). See subnets
. - If you need the ability to update the Oracle-managed load balancer configuration for an Oracle Java Cloud Service instance, do not provision the load balancer during the creation of the service instance. This is because you cannot update the Oracle-managed load balancer configuration if the load balancer is provisioned automatically during the creation of the service instance. To be able to update the configuration of the Oracle-managed load balancer instance provisioned for your service instance, you must create and configure the load balancer manually (after you have created your service instance). See Set Up an Oracle Cloud Infrastructure Load Balancer in Administering Oracle Java Cloud Service.
-
loadBalancerType(optional):
string
This attribute is applicable only when creating an Oracle Java Cloud Service instance with an Oracle-managed load balancer.
Type of Oracle-managed load balancer. Valid values are:
PUBLIC
- The Oracle-managed load balancer is accessible over the Internet. This is the default.PRIVATE
- The Oracle-managed load balancer is not accessible over the Internet. Note that this type is not available on Oracle Cloud Infrastructure.
On Oracle Cloud Infrastructure Classic, this attribute is applicable only when provisioning a service instance on a specific IP network (ipNetwork
) and Oracle Identity Cloud Service is enabled (where useIdentityService
is set to true
).
-
meteringFrequency(optional):
string
Metering frequency. This attribute is only applicable if you have a traditional metered subscription; it is not applicable if you have a Universal Credits subscription.
Valid values include:
HOURLY
- Pay only for the number of hours used during your billing period. This is the default.MONTHLY
- Pay one price for the full month irrespective of the number of hours used.
-
notificationEmail(optional):
string
The email to which notifications will be sent.
To receive notifications, enableNotification
must be set to true
.
-
protectedRootContexts(optional):
string
This attribute is applicable only when provisioning an Oracle Java Cloud Service instance that uses Oracle Identity Cloud Service (where
useIdentityService
is set to
true
), to enable Oracle Identity Cloud Service for authenticating Oracle WebLogic Server administrators and application users.
Supply this attribute when you want to include additional URL patterns to use to protect JavaEE applications.
A comma separated list of context roots that you want protected by Oracle Identity Cloud Service.
Each context root must begin with the /
character. For example:
/store/departments/.*,/store/cart/.*,/marketplace/.*,/application1/.*
-
provisionOTD(optional):
boolean
Flag that specifies whether to enable Oracle Traffic Director (OTD) as a user-managed load balancer for the Oracle Java Cloud Service instance. Default value is
false
.
Provisioning a load balancer is recommended if you are configuring more than one Managed Server for the service instance. When set to true
, all the WebLogic Server WLS nodes and OTD nodes in the service instance are assigned to the same IP network or subnet.
This attribute cannot be true
if useIdentityService
is set to true
. This is because when useIdentityService
is true
, the Oracle-managed load balancer is configured.
In addition, on Oracle Cloud Infrastructure, this attribute cannot be true
if configureLoadBalancer
is true
(without enabling Oracle Identity Cloud Service).
-
region:
string
This attribute is applicable only to accounts where regions are supported.
Name of the region where the Oracle Java Cloud Service instance is to be provisioned.
On Oracle Cloud Infrastructure: An Oracle Cloud Infrastructure region must be specified to provision your service instance on Oracle Cloud Infrastructure resources. Be sure to specify a region that is within the default data region of your account on Oracle Cloud Infrastructure. If the default data region is North America, specify the region such as us-phoenix-1
, us-ashburn-1
or ca-toronto-1
. If the default data region is EMEA, specify the region as eu-frankfurt-1
or uk-london-1
. For other regions, see Data Regions for Platform and Infrastructure Services.
You must use the same region as the one where your Oracle Autonomous Transaction Processing database, Oracle Cloud Infrastructure Database (DB system), or Oracle Database Cloud Service (Classic) database deployment resides.
Note also the following when provisioning on Oracle Cloud Infrastructure:
- An availability domain must also be specified using
availabilityDomain
. See the description for availabilityDomain
. - A subnet can be specified using
subnet
. See the description for subnet
. - Database instances in Oracle Cloud Infrastructure Database and Oracle Database Cloud Service must be in the same region and virtual cloud network (VCN) as the Oracle Java Cloud Service instance. The database and service instance do not need to be in the same subnet or availability domain, but you may have to create the necessary security rules in the VCN to enable communication between the subnets. The database and service instance can be on different VCNs only if you configure VCN peering.
See Regions and Availability Domains and VCNs and Subnets in the Oracle Cloud Infrastructure documentation.
On Oracle Cloud Infrastructure Classic: A region name is optional. It must be specified if you intend to use ipReservations
or ipNetwork
. For Classic regions, see Data Regions for Platform and Infrastructure Services.
If you do not specify a region, the service instance is created in the same site as the associated infrastructure schema database deployment. However, you will not be able to use an IP network or reserved IP addresses for the service instance.
If a region name is specified, the database deployment that you intend to associate with your service instance must be in the same region.
If creating a clone using a snapshot, the region of the clone must be the same as the source Oracle Java Cloud Service instance.
-
serviceDescription(optional):
string
Free-form text that provides additional information about the service instance.
-
serviceLevel(optional):
string
Service level. Valid values include:
PAAS
- Production-level service. This is the default. Supports Oracle Java Cloud Service instance creation and monitoring, backup and restoration, patching, and scaling. To enable domain partitions using WebLogic Server 12.2.1, you must specify the PAAS
service level.BASIC
- Development-level service. Supports Oracle Java Cloud Service instance creation and monitoring but does not support backup and restoration, patching, or scaling.
Note: The BASIC
service level is:
- Not supported for Oracle Cloud Infrastructure regions
- Not supported if you have a Universal Credits subscription
-
serviceName:
string
Name of Oracle Java Cloud Service instance. The service name:
- Must not exceed 30 characters.
- Must start with a letter.
- Must contain only letters and numbers.
- Must not contain any special characters (including hyphens).
- Must be unique within the identity domain.
By default, the names of the domain and cluster in the service instance will be generated from the first eight characters of the service instance name (serviceName
), using the following formats, respectively:
first8charsOfServiceInstanceName_domain
first8charsOfServiceInstanceName_cluster
-
serviceVersion(optional):
string
Oracle WebLogic Server software version.
12cRelease214
- For Oracle WebLogic Server 12c, 12.2.1.4.This is the default value for provisioning Oracle Java Cloud Service instances.
The JDK version for WebLogic Server 12.2.1 is JDK 8.
On Oracle Cloud Infrastructure: Additional restrictions may apply. For example, 12cRelease214
is valid if you are using an Oracle Autonomous Transaction Processing database for the associated infrastructure schema database. See the following:
-
snapshotName(optional):
string
This attribute and
sourceServiceName
are required when you provision a clone of an existing Oracle Java Cloud Service instance (the source service instance).
Name of the snapshot to clone from. See Snapshots REST Endpoints.
Note: You cannot create a clone of a service instance that is enabled with Oracle Identity Cloud Service, or that uses an Oracle Autonomous Transaction Processing database or Oracle Cloud Infrastructure Database for the infrastructure schema.
-
sourceServiceName(optional):
string
This attribute and
snapshotName
are required when you provision a clone of an existing Oracle Java Cloud Service instance.
Name of the existing Oracle Java Cloud Service instance that has the snapshot from which you are creating a clone.
The cloning feature is not supported for the following:
- Service instances that use an Oracle Autonomous Transaction Processing database or Oracle Cloud Infrastructure Database for the infrastructure schema.
- Service instances that were provisioned with Oracle Identity Cloud Service enabled.
Note the following when creating a service instance clone:
- Use
snapshotName
to specify the name of the snapshot to clone from. See Snapshots REST Endpoints. - The clone is created in the same region as the source instance; you cannot change the
region
value for the clone. - The following service level attributes of the source service instance also cannot be changed in the clone:
edition
, provisionOTD
, serviceLevel
, and serviceVersion
. Of those attributes, the clone operation will always use the same values as found in the snapshot of the source service instance. - Specify a clone of the associated infrastructure schema database; do not use the original database as the associated database to host the required infrastructure schema for your Oracle Java Cloud Service instance clone. Similarly, for database deployments that host application schemas (if any), use one or more database deployment clones in the array
appDBs
. - If a caching (data grid) cluster is provisioned in the source service instance, the clone will include a caching cluster that has the exact same configuration for
clusterName
, shape
, serverCount
, and serversPerNode
. Those attributes cannot be changed in the clone. - The following
WLS
component level attributes of the source service instance cannot be changed in the clone: adminPort
, clusterName
of application cluster, contentPort
, deploymentChannelPort
, domainName
, domainPartitionCount
, managedServerCount
, nodeManagerPort
, sampleAppDeploymentRequested
, securedAdminPort
, securedContentPort
-
subnet(optional):
string
This attribute is applicable only when creating Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
The Oracle Cloud Identifier (OCID) of a subnet from a virtual cloud network (VCN) created on Oracle Cloud Infrastructure.
See Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure and VCNs and Subnets in the Oracle Cloud Infrastructure documentation.
See also Known Issues for Oracle Java Cloud Service.
You can specify a subnet that you have created yourself, or you can let Oracle Java Cloud Service automatically assign a subnet for you.
To specify a subnet you have created: Use subnet
to specify the OCID of the subnet from a VCN that you have created on Oracle Cloud Infrastructure. The OCID is a unique autogenerated ID. To find out the OCID of the subnet, go to the Oracle Cloud Infrastructure web console, select Networking and click the VCN that your subnet is in, then look for the OCID field under the subnet that you want to use.
To let Oracle Java Cloud Service assign a subnet for you: Do not include subnet
in your provisioning request payload. When excluded, Oracle Java Cloud Service automatically assigns a subnet from the VCN named svc-vcn
in the ManagedCompartmentForPaaS
compartment.
Note:
- You must specify a subnet if you intend to specify subnets for the Oracle-managed load balancer nodes.
- You must specify a subnet if the associated infrastructure schema database is deployed on an Oracle Cloud Infrastructure Database system.
- Database instances in Oracle Database Cloud Service and Oracle Cloud Infrastructure Database must be in the same region and virtual cloud network (VCN) as the Oracle Java Cloud Service instance. The database and service instance do not need to be in the same subnet or availability domain, but you may have to create the necessary security rules in the VCN to enable communication between the subnets.
- To use a private subnet, note that several networking, storage, identity, and compute resources must be created in Oracle Cloud Infrastructure. See Create an Oracle Java Cloud Service Instance Attached to a Private Subnet on Oracle Cloud Infrastructure in Administering Oracle Java Cloud Service.
-
tags(optional):
array tags
Groups tags for assigning to the service instance after the instance is created. If a tag does not yet assist, it will be created and then assigned to the service instance.
-
useIdentityService(optional):
boolean
This attribute is applicable only to accounts that include Oracle Identity Cloud Service.
Flag that specifies whether to use Oracle Identity Cloud Service (true
) or the local WebLogic identity store (false
) for user authentication and to maintain administrators, application users, groups and roles. The default value is false
.
See Use Oracle Identity Cloud Service with Oracle Java Cloud Service in Administering Oracle Java Cloud Service.
Note: Oracle Identity Cloud Service must be enabled (that is, set to true
) if you specify a secondary identity domain in identityStripe
.
Consider the following restrictions when enabling Oracle Identity Cloud Service:
serviceLevel
must be PAAS
provisionOTD
must be false
serviceVersion
must use one of the 12c versions)- On Oracle Cloud Infrastructure,
configureLoadBalancer
cannot be false
.
If you enable Oracle Identity Cloud Service, you do not have the option to configure and manage Oracle Traffic Director (OTD) as a user-managed load balancer that runs within your service instance. Instead, an instance of Oracle Cloud Infrastructure Load Balancing (on Oracle Cloud Infrastructure) or Oracle Cloud Infrastructure Load Balancing Classic (on Oracle Cloud Infrastructure Classic) is created and configured. This Oracle-managed load balancer instance is maintained and patched for you by Oracle. See loadbalancer
for the load balancer options you can set (during creation of the Oracle Java Cloud Service instance).
Note for Oracle Cloud Infrastructure: You cannot update the Oracle-managed load balancer configuration if the load balancer is provisioned automatically during the creation of the Oracle Java Cloud Service instance. If you need the ability to update the Oracle-managed load balancer configuration for a service instance, you must create and configure the load balancer manually (after you have created your service instance without enabling Oracle Identity Cloud Service). See Set Up an Oracle Cloud Infrastructure Load Balancer in Administering Oracle Java Cloud Service.
-
useOAuthForStorage(optional):
boolean
This attribute is applicable only when provisioning an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure Classic.
This attribute is only applicable to Oracle Cloud accounts that are created with OAuth protected object storage. If you do not want to use the default OAuth protected object storage for instance backups, you must set the attribute to false
and specify the following in the payload: cloudStorageContainer
, cloudStorageUser
, and cloudStoragePassword
. cloudStorageContainerAutoGenerate
is optional.
-
vmPublicKeyText:
string
The public key for the secure shell (SSH). This key will be used for authentication when connecting to the Oracle Java Cloud Service instance using an SSH client. You generate an SSH public-private key pair using a standard SSH key generation tool. See
Accessing a Node with a Secure Shell (SSH) in
Administering Oracle Java Cloud Service.
{
"properties":{
"assignPublicIP":{
"type":"boolean",
"description":"This attribute is applicable only when provisioning an Oracle Java Cloud Service instance in a region on Oracle Cloud Infrastructure Classic, and a custom IP network is specified in <code>ipNetwork</code>.<p>Flag that specifies whether to assign (<code>true</code>) or not assign (<code>false</code>) public IP addresses to the nodes in your service instance. The default is <code>true</code>, which means any node added during service instance provisioning, or later added as part of a scaling operation, will have a public IP address assigned to it. You will be able to directly access the nodes from the public Internet.<p>When set to <code>false</code>, this means any node added during instance provisioning, or later added as part of a scaling operation, will not have a public IP address assigned to it. You will not be able to directly access the nodes from the public Internet."
},
"availabilityDomain":{
"type":"string",
"description":"This required attribute is applicable only when creating Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Name of a data center location in the Oracle Cloud Infrastructure region that is specified in <code>region</code>. A region is a localized geographic area, composed of one or more availability domains (data centers).<p>The availability domain value format is an account-specific prefix followed by <code><region>-<ad></code>. For example, <code>FQCn:US-ASHBURN-AD1</code> where <code>FQCn</code> is the account-specific prefix.<p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=oci_general_regions' target='_blank'>Regions and Availability Domains</a> in the Oracle Cloud Infrastructure documentation."
},
"backupDestination":{
"type":"string",
"description":"This attribute is applicable only when <code>serviceLevel</code> is set to <code>PAAS</code>. Specifies whether to enable backups for this Oracle Java Cloud Service instance.<p>Valid values include:<ul><li><code>BOTH</code> - Enable backups. This is the default. This means automated scheduled backups of the service instance are enabled, and on-demand backups can be initiated. All backups are stored on disk (in a volume attached to the nodes) and in the object storage container or bucket that is specified in <code>cloudStorageContainer</code>. See also <code>disabledScheduledCoordinatedBackups</code>.</li><li><code>NONE</code> - Do not enable backups. This means automated scheduled backups of the service instance are not enabled, and on-demand backups cannot be initiated. When set to <code>NONE</code>, <code>cloudStorageContainer</code> is not required.</li></ul>"
},
"disabledScheduledCoordinatedBackups":{
"type":"boolean",
"description":"Flag that specifies whether a scheduled Oracle Java Cloud Service instance backup will include a backup of the associated database deployment.<p>A value of <code>false</code> means a backup of the associated database deployment is coordinated and enabled. A value of <code>true</code> means a coordinated database deployment backup is not performed (disabled) during a scheduled backup of this service instance.<p>Default is <code>true</code>.<p>If the Oracle Java Cloud Service instance has <code>backupDestination</code> set to <code>NONE</code>, the attribute is ignored.<p>Note: This attribute is not applicable to an Oracle Java Cloud Service instance that uses Oracle Database Exadata Cloud Service for the required infrastructure schema; the attribute is ignored if it is specified. This attribute is also not applicable to service instances that use an Oracle Autonomous Transaction Processing database or Oracle Cloud Infrastructure Database (DB system) to host the infrastructure schema. Coordinated backups are not available for such service instances."
},
"cloudStorageContainer":{
"type":"string",
"description":"URI of the object storage bucket or container for storing Oracle Java Cloud Service instance backups.<p>Do not use a bucket or container that you use to back up Oracle Java Cloud Service instances for any other purpose. For example, do not also use the same bucket or container to back up the associated infrastucture schema database. Using one bucket or container for multiple purposes can result in billing errors.<p>This attribute is not required if:<ul><li><code>backupDestination</code> is set to <code>NONE</code></li><li><code>serviceLevel</code> is set to <code>BASIC</code></li></ul><p>On <b>Oracle Cloud Infrastructure</b>, the object storage bucket must be created before provisioning your Oracle Java Cloud Service instance. Do not use the same bucket for more than one instance. For the instructions to create a bucket, see <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=oci_general_paasprereqs' target='_blank'>Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure</a> in the Oracle Cloud Infrastructure documentation. Enter the bucket URL in the following format: <p><code>https://swiftobjectstorage.<<i>region</i>>.oraclecloud.com/v1/<<i>namespace</i>>/<<i>bucket</i>></code>.<p>To find out your namespace, sign in to the Oracle Cloud Infrastructure web console, click the tenancy name, and look for the <b>Object Storage Namespace</b> field.</p><p>Example:<p><code>https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/acme/mybucket</code><p>On <b>Oracle Cloud Infrastructure Classic</b> and <b>Oracle Cloud at Customer</b>, the object storage container does not have to be created ahead of provisioning your Oracle Java Cloud Service instance. <p>To specify the container (existing or new), use one of the following formats:<ul><li><code>Storage-<<i>identitydomainid</i>>/<<i>containerName</i>></code></li><li><code><<i>storageservicename</i>>-<<i>identitydomainid</i>>/<<i>containerName</i>></code></li><li><code><<i>restEndPointURL</i>>/<<i>containerName</i>></code></li></ul><p>To identify the REST endpoint URL of your object storage service, see <a href='https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud/jscug&id=storage-rest-endpoint' target='_blank'>Finding the REST Endpoint URL for Your Cloud Account</a> in <i>Using Oracle Cloud Infrastructure Object Storage Classic</i>.<p>If your Oracle Cloud account is created with OAuth protected object storage and you do not want to use the default OAuth protected object storage for instance backups, see <code>useOAuthForStorage</code>."
},
"cloudStorageContainerAutoGenerate":{
"type":"boolean",
"description":"This attribute is not applicable when provisioning an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure.<p>Flag that specifies whether to create (<code>true</code>) or not create (<code>false</code>) the object storage container if the name specified in <code>cloudStorageContainer</code> does not exist. The default is <code>false</code>."
},
"cloudStoragePassword":{
"type":"string",
"description":"Password for the object storage user. The password must be specified if <code>cloudStorageContainer</code> is set, but note the following:<p>On <b>Oracle Cloud Infrastructure</b>, this is the Auth token generated on Oracle Cloud Infrastructure for the user specified in <code>cloudStorageUser</code>.<p>On <b>Oracle Cloud Infrastructure Classic</b> and <b>Oracle Cloud at Customer</b>, this is the password for the Oracle Cloud Infrastructure Object Storage Classic user who has read and write access to the container that is specified in <code>cloudStorageContainer</code>. This attribute is not required for the BASIC service level.<p>If a service instance on <b>Oracle Cloud Infrastructure Classic</b> is using Oracle Identity Cloud Service, this attribute is not required if the current cloud user is entitled to use Oracle Cloud Infrastructure Object Storage Classic."
},
"cloudStorageUser":{
"type":"string",
"description":"User name for the object storage user. The user name must be specified if <code>cloudStorageContainer</code> is set, but note the following:<p>On <b>Oracle Cloud Infrastructure</b>, this is the user name for the Oracle Cloud Infrastructure Object Storage user.<p>On <b>Oracle Cloud Infrastructure Classic</b> and <b>Oracle Cloud at Customer</b>, this is the user name for the Oracle Cloud Infrastructure Object Storage Classic user who has read and write access to the container that is specified in <code>cloudStorageContainer</code>. This attribute is not required for the <code>BASIC</code> service level.<p>If a service instance on <b>Oracle Cloud Infrastructure Classic</b> is using Oracle Identity Cloud Service, this attribute is not required if the current cloud user is entitled to use Oracle Cloud Infrastructure Object Storage Classic."
},
"useOAuthForStorage":{
"type":"boolean",
"description":"This attribute is applicable only when provisioning an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure Classic.<p>This attribute is only applicable to Oracle Cloud accounts that are created with OAuth protected object storage. If you do not want to use the default OAuth protected object storage for instance backups, you must set the attribute to <code>false</code> and specify the following in the payload: <code>cloudStorageContainer</code>, <code>cloudStorageUser</code>, and <code>cloudStoragePassword</code>. <code>cloudStorageContainerAutoGenerate</code> is optional."
},
"edition":{
"type":"string",
"description":"Software edition for Oracle WebLogic Server. Valid values include:<ul><li><code>SE</code> - Standard edition. See <a href='http://www.oracle.com/middleware/weblogic/standard-edition.html' target='_blank'>Oracle WebLogic Server Standard Edition</a>. Do not use the Standard edition if you are enabling domain partitions using WebLogic Server 12.2.1, or using <code>upperStackProductName</code> to provision a service instance for an Oracle Fusion Middleware product. Scaling a cluster is also not supported on service instances that are based on the Standard edition.</li><li><code>EE</code> - Enterprise Edition. This is the default for both PAAS and BASIC service levels. See <a href='http://www.oracle.com/middleware/weblogic/enterprise-edition.html' target='_blank'>Oracle WebLogic Server Enterprise Edition</a>.</li><li><code>SUITE</code> - Suite edition (Enterprise Edition with Coherence). See <a href='http://www.oracle.com/middleware/weblogic/suite.html' target='_blank'>Oracle WebLogic Suite</a>.</li></ul><p>Set the <code>edition</code> value to <code>SUITE</code> if either is applicable:<ul><li>You are creating an instance with a caching (data grid) cluster</li><li>You want a high performance edition</li></ul><p>On <b>Oracle Cloud Infrastructure</b>: Additional restrictions may apply. For example, <code>SUITE</code> is required if you are using an Oracle Cloud Infrastructure RAC database for the associated infrastructure schema. See the following:<ul><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"adminConsoleAccessCIDRRange":{
"type":"string",
"description":"Flag that specifies the Classless Inter-Domain Routing (CIDR) range to access the WebLogic Server Administration Console. The default value is 0.0.0.0/0. To specify a value, <code>enableAdminConsole</code> must be set to true."
},
"enableAdminConsole":{
"type":"boolean",
"description":"Flag that specifies whether to enable (<code>true</code>) or disable (<code>false</code>) the access rules that control external communication to the WebLogic Server Administration Console, Fusion Middleware Control, and Load Balancer Console.<p>On <b>Oracle Cloud Infrastructure</b>: The default value is <code>true</code>. The security rule that controls access to the WebLogic Server Administration Console and other consoles is enabled by default. You cannot disable it during provisioning.<p>On <b>Oracle Cloud Infrastructure Classic</b>: The default value is <code>false</code>. If you do not set it to <code>true</code>, after the service instance is created, you have to explicitly enable the rules for the administration consoles before you can gain access to the consoles. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_updaterule'>Disable, Enable or Delete an Access Rule</a>."
},
"enableNotification":{
"type":"boolean",
"description":"Flag that specifies whether to enable (<code>true</code>) or disable (<code>false</code>) notifications by email. If this property is set to <code>true</code>, you must specify a value in <code>notificationEmail</code>. <p>Currently, notifications are sent only when service instance provisioning is successful or not successful."
},
"identityStripe":{
"type":"string",
"description":"This optional attribute is applicable only to Cloud accounts where multiple identity domains are supported in Oracle Identity Cloud Service.<p>Name of a secondary identity domain where the Oracle Java Cloud Service instance will be provisioned.<p>If not specified, the service instance is provisioned in the primary identity domain (default). The primary identity domain is the initial domain that was created when the Cloud account was set up.<p>Note the following when specifying a secondary identity domain:<ul><li>Your associated infrastructure schema database must be deployed on Oracle Autonomous Transaction Processing or Oracle Cloud Infrastructure Database (DB System).</li><li><code>useIdentityService</code> must be set to <code>true</code> (that is, Oracle Identity Cloud Service must be enabled).</li><li><code>configureLoadBalancer</code> must also be set to <code>true</code>.</li></ul>"
},
"adminUserID":{
"type":"string",
"description":"This attribute is only applicable if a value is specified in <code>identityStripe</code>.<p>The administrator of the specified identity domain or a valid user in the specified identity domain."
},
"ipNetwork":{
"type":"string",
"description":"This attribute is not applicable when provisioning Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>This attribute is applicable only to accounts where regions are supported.<p><p>The three-part name of a custom IP network to attach this service instance to. For example:<p> <code>/Compute-<i>identity_domain/user/object</i></code><p>A <code>region</code> name must be specified in order to use <code>ipNetwork</code>. Only those IP networks already created in the specified Oracle Cloud Infrastructure Compute Classic region can be used.<p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=STCSG-GUID-9A826000-2728-4837-905A-7835FA775F9B'>Creating an IP Network</a> in <i>Using Oracle Cloud Infrastructure Compute Classic</i>.<p>If you are provisioning a Java Cloud Service instance with <code>useIdentityService</code> set to <code>true</code>, the <code>ipNetwork</code> you want to use must meet one of the following conditions:<ul><li>A public-facing (Internet-facing) or private load balancer must already be attached to the <code>ipNetwork</code> you specify.</li><li>The <code>ipNetwork</code> you specify is connected to an IP Network Exchange that has another IP network to which a public-facing or private load balancer is already attached.</li></ul><p>During provisioning, if a load balancer is not found, an error message is returned and the instance creation operation will stop. You must first attach a public or private load balancer to the <code>ipNetwork</code> you want to use before you try to create the Java Cloud Service instance again. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/iaas/load-balancer-cloud&id=LBRUG-GUID-0D9A9382-BC9C-48EC-B76A-2A13EBC13544' target='_blank'>Creating a Load Balancer</a> in <i>Using Oracle Cloud Infrastructure Load Balancing Classic</i>.<p>If you specify an IP network, the <code>dbServiceName</code> for this service instance must also be attached to an <code>ipNetwork</code>. If this service instance and the associated database deployment are attached to different IP networks, the two IP networks must be connected to the same IP network exchange.<p>A consequence of using an IP network is that the auto-assigned IP address could change each time the service instance is started. To assign fixed public IP addresses to a service instance that is attached to an IP network, you can first create reserved IP addresses, then provision the service instance to use those persistent IP addresses in <code>ipReservations</code>. Note that to use <code>ipReservations</code>, <code>assignPublicIP</code> must be <code>true</code>.<p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations."
},
"isBYOL":{
"type":"boolean",
"description":"Flag that specifies whether to apply an existing on-premises license for Oracle WebLogic Server (<code>true</code>) to the new Oracle Java Cloud Service instance you are provisioning. A Universal Credits subscription or a Government subscription is required in order to use existing licenses. BYOL instances are billed at a lower rate than license-included instances.<p>On Oracle Cloud at Customer: Default value is <code>false</code>.<p>On Oracle Cloud Infrastructure and Oracle Cloud Infrastructure Classic:<ul><li>If the Oracle Cloud account does not have BYOL entitlements, the default value is <code>false</code>. You cannot change it to <code>true</code>. A validation error will occur if you try to provision a service instance without any BYOL entitlements.</li><li>If the Oracle Cloud account only has BYOL entitlements, the default value is <code>true</code>. You cannot change it to <code>false</code>.</li><li>If the Oracle Cloud account has a mix of BYOL entitlements and non-BYOL resources, the default value is <code>true</code>. You can, however, change it to <code>false</code> to provision a service instance without using a BYOL entitlement.</li></ul><p>Note that you are responsible for ensuring that you have the required licenses for all BYOL instances in Oracle Java Cloud Service. For example, before you scale up or scale out a BYOL instance, you must have enough WebLogic Server licenses for the additional OCPUs that will be allocated to the instance after it is scaled.<p>See <a href='https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=cloud-byol-faq'>Frequently Asked Questions: Oracle BYOL to PaaS</a>. For the processor conversion ratios and license requirements, refer to the document titled <i>Oracle PaaS and IaaS Universal Credits Service Descriptions</i>."
},
"configureLoadBalancer":{
"type":"boolean",
"description":"This attribute is applicable only when creating an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure.<p>Flag that specifies whether to enable the Oracle-managed load balancer for this service instance. Default value is <code>false</code>. Note the following:<ul><li>If you need the ability to update the Oracle Cloud Infrastructure Load Balancing configuration for an Oracle Java Cloud Service instance, do not set the value to <code>true</code> because you cannot update the Oracle Cloud Infrastructure Load Balancing configuration if the load balancer is provisioned automatically during the creation of the service instance. To be able to update the configuration of the Oracle-managed load balancer instance provisioned for your service instance, you must create and configure the load balancer manually (after you have created your service instance). See <a href='https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-92A54DB7-5500-4492-86A5-E5310D380FFD' target='_blank'>Set Up an Oracle Cloud Infrastructure Load Balancer</a> in <i>Administering Oracle Java Cloud Service</i>.</li><li>The value must be set to <code>true</code> if <code>useIdentityService</code> is set to <code>true</code> (to enable Oracle Identity Cloud Service for authenticating Oracle WebLogic Server administrators and application users).</li><li>The value can be <code>true</code> without setting <code>useIdentityService</code> to <code>true</code>.</li></ul><p>Provisioning a load balancer is recommended if you are configuring more than one Managed Server. Only <code>configureLoadBalancer</code> or <code>provisionOTD</code> (Oracle Traffic Director as the user-managed load balancer) can be <code>true</code> (in other words, if one is <code>true</code>, the other must be <code>false</code>).<p>When <code>configureLoadBalancer</code> is set to <code>true</code>, the Oracle-managed, dual-node load balancer (that can be accessed using a single IP address) is provisioned and configured for the Oracle Java Cloud Service instance. The Oracle-managed load balancer, which is maintained and patched by Oracle, runs on Oracle Cloud Infrastructure Load Balancing. See <code>loadbalancer</code> for the load balancer options you can set (during creation of the Oracle Java Cloud Service instance). The Oracle-managed load balancer that is provisioned automatically cannot be removed after the service instance is created.<p>Note also the following when considering whether to use the Oracle-managed load balancer or Oracle Traffic Director (OTD) as a user-managed load balancer: All the nodes in a service instance (WebLogic Server WLS and OTD nodes) are attached to the subnet that you can specify for the instance. If you want the WLS nodes in a private subnet and the load balancer in a public subnet, then use <code>subnet</code> to attach the instance to a private subnet, enable the use of the Oracle-managed load balancer, and specify public <code>subnets</code> for the <code>loadbalancer</code> nodes."
},
"loadbalancer":{
"type":"object",
"description":"Groups properties for the Oracle-managed load balancer, which is maintained and patched by Oracle.<p>The Oracle-managed load balancer is an instance of Oracle Cloud Infrastructure Load Balancing (on Oracle Cloud Infrastructure) or Oracle Cloud Infrastructure Load Balancing Classic (on Oracle Cloud Infrastructure Classic).<p>This attribute is applicable when provisioning a service instance with <code>useIdentityService</code> set to <code>true</code>. See <code>loadBalancingPolicy</code> for the load balancer policy options you can set.<p>In addition, on <b>Oracle Cloud Infrastructure</b>:<ul><li>This attribute is also applicable when provisioning a service instance without enabling Oracle Identity Cloud Service, but with <code>configureLoadBalancer</code> set to <code>true</code>.</li><li>Regardless of whether <code>useIdentityService</code> is set to <code>true</code>, if a specific <code>subnet</code> is specified for the service instance, you must also specify subnets for the Oracle-managed load balancer nodes (node 1 and node 2). See <code>subnets</code>.</li><li>If you need the ability to update the Oracle-managed load balancer configuration for an Oracle Java Cloud Service instance, do not provision the load balancer during the creation of the service instance. This is because you cannot update the Oracle-managed load balancer configuration if the load balancer is provisioned automatically during the creation of the service instance. To be able to update the configuration of the Oracle-managed load balancer instance provisioned for your service instance, you must create and configure the load balancer manually (after you have created your service instance). See <a href='https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-92A54DB7-5500-4492-86A5-E5310D380FFD' target='_blank'>Set Up an Oracle Cloud Infrastructure Load Balancer</a> in <i>Administering Oracle Java Cloud Service</i>.</li></ul>",
"properties":{
"loadBalancingPolicy":{
"type":"string",
"description":"Policy to use for routing requests to the origin servers of the Oracle-managed load balancer.<p>Valid policy values include: <ul><li><code>LEAST_CONN</code> - Passes each new request to the server with the least number of active connections.</li><li><code>IP_HASH</code> - Uses the incoming request source IP address as a hashing key to determine the server to route each request. Unlike <code>ROUND_ROBIN</code> and <code>LEAST_CONN</code> load balancing where each subsequent client request can be routed to a different server, <code>IP_HASH</code> ensures that requests from the same client are always routed to the same server (as long as the server is available).</li><li><code>ROUND_ROBIN</code> - Passes each new request to the next server in line, evenly distributing requests across all servers. This is the default value.</li></ul>"
},
"subnets":{
"type":"array",
"description":"This attribute is available only on Oracle Cloud Infrastructure.<p>This attribute is required if you are provisioning an Oracle Java Cloud Service instance on a specific subnet using <code>subnet</code>.<p>Subnets for the Oracle-managed load balancer nodes (node 1 and node 2).<p>Use the OCID of a public subnet. The OCID is a unique autogenerated ID. To find out the OCID of a subnet, go to the Oracle Cloud Infrastructure web console, select <b>Networking</b> and click the VCN that your subnet is in, then look for the <b>OCID</b> field under the subnet that you want to use.<p>Oracle recommends that you use a regional subnet for the load balancer to support failover to another availability domain if needed.<p>Note the following:<ul><li>In a <code>region</code> that has a single availability domain, only one subnet value can be provided.</li><li>If a regional subnet is specified, then only one subnet value can be provided.</li><li>If a subnet that is scoped for an availability domain is specified, then two subnet values must be provided. For each Oracle-managed load balancer node, use a subnet from a different availability domain. For one of the nodes, Oracle recommends using a subnet from the same <code>availabilityDomain</code> as specified for the service instance. This ensures that, as long as the service instance is running, the applications deployed on it remain accessible through the Oracle-managed load balancer.</li></ul>",
"items":{
"type":"string"
}
}
}
},
"loadBalancerType":{
"type":"string",
"description":"This attribute is applicable only when creating an Oracle Java Cloud Service instance with an Oracle-managed load balancer.<p>Type of Oracle-managed load balancer. Valid values are:<ul><li><code>PUBLIC</code> - The Oracle-managed load balancer is accessible over the Internet. This is the default.</li><li><code>PRIVATE</code> - The Oracle-managed load balancer is not accessible over the Internet. Note that this type is <i>not</i> available on Oracle Cloud Infrastructure.</li></ul><p>On Oracle Cloud Infrastructure Classic, this attribute is applicable only when provisioning a service instance on a specific IP network (<code>ipNetwork</code>) and Oracle Identity Cloud Service is enabled (where <code>useIdentityService</code> is set to <code>true</code>)."
},
"meteringFrequency":{
"type":"string",
"description":"Metering frequency. This attribute is only applicable if you have a traditional metered subscription; it is not applicable if you have a Universal Credits subscription.<p>Valid values include:<ul><li><code>HOURLY</code> - Pay only for the number of hours used during your billing period. This is the default.</li><li><code>MONTHLY</code> - Pay one price for the full month irrespective of the number of hours used.</li></ul>"
},
"notificationEmail":{
"type":"string",
"description":"The email to which notifications will be sent.<p>To receive notifications, <code>enableNotification</code> must be set to <code>true</code>."
},
"protectedRootContexts":{
"type":"string",
"description":"This attribute is applicable only when provisioning an Oracle Java Cloud Service instance that uses Oracle Identity Cloud Service (where <code>useIdentityService</code> is set to <code>true</code>), to enable Oracle Identity Cloud Service for authenticating Oracle WebLogic Server administrators and application users.<p>Supply this attribute when you want to include additional URL patterns to use to protect JavaEE applications.<p>A comma separated list of context roots that you want protected by Oracle Identity Cloud Service.<p>Each context root must begin with the <code>/</code> character. For example:<p><code>/store/departments/.*,/store/cart/.*,/marketplace/.*,/application1/.*</code> "
},
"provisionOTD":{
"type":"boolean",
"description":"Flag that specifies whether to enable Oracle Traffic Director (OTD) as a user-managed load balancer for the Oracle Java Cloud Service instance. Default value is <code>false</code>.<p>Provisioning a load balancer is recommended if you are configuring more than one Managed Server for the service instance. When set to <code>true</code>, all the WebLogic Server WLS nodes and OTD nodes in the service instance are assigned to the same IP network or subnet.<p>This attribute cannot be <code>true</code> if <code>useIdentityService</code> is set to <code>true</code>. This is because when <code>useIdentityService</code> is <code>true</code>, the Oracle-managed load balancer is configured.<p>In addition, on <b>Oracle Cloud Infrastructure</b>, this attribute cannot be <code>true</code> if <code>configureLoadBalancer</code> is <code>true</code> (without enabling Oracle Identity Cloud Service)."
},
"region":{
"type":"string",
"description":"This attribute is applicable only to accounts where regions are supported.<p>Name of the region where the Oracle Java Cloud Service instance is to be provisioned.<p>On <b>Oracle Cloud Infrastructure</b>: An Oracle Cloud Infrastructure region must be specified to provision your service instance on Oracle Cloud Infrastructure resources. Be sure to specify a region that is within the default data region of your account on Oracle Cloud Infrastructure. If the default data region is North America, specify the region such as <code>us-phoenix-1</code>, <code>us-ashburn-1</code> or <code>ca-toronto-1</code>. If the default data region is EMEA, specify the region as <code>eu-frankfurt-1</code> or <code>uk-london-1</code>. For other regions, see <a href='https://cloud.oracle.com/data-regions' target='_blank'>Data Regions for Platform and Infrastructure Services</a>.<p>You must use the same region as the one where your Oracle Autonomous Transaction Processing database, Oracle Cloud Infrastructure Database (DB system), or Oracle Database Cloud Service (Classic) database deployment resides.<p>Note also the following when provisioning on Oracle Cloud Infrastructure:<ul><li>An availability domain must also be specified using <code>availabilityDomain</code>. See the description for <code>availabilityDomain</code>.</li><li>A subnet can be specified using <code>subnet</code>. See the description for <code>subnet</code>.</li><li>Database instances in Oracle Cloud Infrastructure Database and Oracle Database Cloud Service must be in the same region and virtual cloud network (VCN) as the Oracle Java Cloud Service instance. The database and service instance do not need to be in the same subnet or availability domain, but you may have to create the necessary security rules in the VCN to enable communication between the subnets. The database and service instance can be on different VCNs only if you configure VCN peering.</li></ul><p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=oci_general_regions' target='_blank'>Regions and Availability Domains</a> and <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=oci_network_vcns' target='_blank'>VCNs and Subnets</a> in the Oracle Cloud Infrastructure documentation.<p>On <b>Oracle Cloud Infrastructure Classic</b>: A region name is optional. It must be specified if you intend to use <code>ipReservations</code> or <code>ipNetwork</code>. For Classic regions, see <a href='https://cloud.oracle.com/data-regions' target='_blank'>Data Regions for Platform and Infrastructure Services</a>.<p>If you do not specify a region, the service instance is created in the same site as the associated infrastructure schema database deployment. However, you will not be able to use an IP network or reserved IP addresses for the service instance.<p>If a region name is specified, the database deployment that you intend to associate with your service instance must be in the same region.<p>If creating a clone using a snapshot, the region of the clone must be the same as the source Oracle Java Cloud Service instance."
},
"serviceDescription":{
"type":"string",
"description":"Free-form text that provides additional information about the service instance."
},
"serviceLevel":{
"type":"string",
"description":"Service level. Valid values include:<ul><li><code>PAAS</code> - Production-level service. This is the default. Supports Oracle Java Cloud Service instance creation and monitoring, backup and restoration, patching, and scaling. To enable domain partitions using WebLogic Server 12.2.1, you must specify the <code>PAAS</code> service level.</li><li><code>BASIC</code> - Development-level service. Supports Oracle Java Cloud Service instance creation and monitoring but does not support backup and restoration, patching, or scaling.</li></ul><p><b>Note:</b> The <code>BASIC</code> service level is:<ul><li>Not supported for Oracle Cloud Infrastructure regions</li><li>Not supported if you have a Universal Credits subscription</li></ul>"
},
"serviceName":{
"type":"string",
"description":"Name of Oracle Java Cloud Service instance. The service name:<ul><li>Must not exceed 30 characters.</li><li>Must start with a letter.</li><li>Must contain only letters and numbers.</li><li>Must not contain any special characters (including hyphens).</li><li>Must be unique within the identity domain.</li></ul><p>By default, the names of the domain and cluster in the service instance will be generated from the first eight characters of the service instance name (<code>serviceName</code>), using the following formats, respectively: <ul><li><code><i>first8charsOfServiceInstanceName</i>_domain</code></li><li><code><i>first8charsOfServiceInstanceName</i>_cluster</code></li></ul>"
},
"serviceVersion":{
"type":"string",
"description":"Oracle WebLogic Server software version. <ul><li><code>12cRelease214</code> - For Oracle WebLogic Server 12c, 12.2.1.4.<p>This is the default value for provisioning Oracle Java Cloud Service instances.<p>The JDK version for WebLogic Server 12.2.1 is JDK 8.<p>On <b>Oracle Cloud Infrastructure</b>: Additional restrictions may apply. For example, <code>12cRelease214</code> is valid if you are using an Oracle Autonomous Transaction Processing database for the associated infrastructure schema database. See the following:<ul><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"snapshotName":{
"type":"string",
"description":"This attribute and <code>sourceServiceName</code> are required when you provision a clone of an existing Oracle Java Cloud Service instance (the source service instance).<p>Name of the snapshot to clone from. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=jcs_rest_snapshots'>Snapshots REST Endpoints</a>.<p>Note: You cannot create a clone of a service instance that is enabled with Oracle Identity Cloud Service, or that uses an Oracle Autonomous Transaction Processing database or Oracle Cloud Infrastructure Database for the infrastructure schema."
},
"sourceServiceName":{
"type":"string",
"description":"This attribute and <code>snapshotName</code> are required when you provision a clone of an existing Oracle Java Cloud Service instance. <p>Name of the existing Oracle Java Cloud Service instance that has the snapshot from which you are creating a clone.<p>The cloning feature is not supported for the following:<ul><li>Service instances that use an Oracle Autonomous Transaction Processing database or Oracle Cloud Infrastructure Database for the infrastructure schema.</li><li>Service instances that were provisioned with Oracle Identity Cloud Service enabled.</li></ul><p>Note the following when creating a service instance clone:<ul><li>Use <code>snapshotName</code> to specify the name of the snapshot to clone from. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=jcs_rest_snapshots'>Snapshots REST Endpoints</a>.</li><li>The clone is created in the same region as the source instance; you cannot change the <code>region</code> value for the clone.</li><li>The following service level attributes of the source service instance also cannot be changed in the clone: <code>edition</code>, <code>provisionOTD</code>, <code>serviceLevel</code>, and <code>serviceVersion</code>. Of those attributes, the clone operation will always use the same values as found in the snapshot of the source service instance.</li><li>Specify a clone of the associated infrastructure schema database; do not use the original database as the associated database to host the required infrastructure schema for your Oracle Java Cloud Service instance clone. Similarly, for database deployments that host application schemas (if any), use one or more database deployment clones in the array <code>appDBs</code>.</li><li>If a caching (data grid) cluster is provisioned in the source service instance, the clone will include a caching cluster that has the exact same configuration for <code>clusterName</code>, <code>shape</code>, <code>serverCount</code>, and <code>serversPerNode</code>. Those attributes cannot be changed in the clone.</li><li>The following <code>WLS</code> component level attributes of the source service instance cannot be changed in the clone: <code>adminPort</code>, <code>clusterName</code> of application cluster, <code>contentPort</code>, <code>deploymentChannelPort</code>, <code>domainName</code>, <code>domainPartitionCount</code>, <code>managedServerCount</code>, <code>nodeManagerPort</code>, <code>sampleAppDeploymentRequested</code>, <code>securedAdminPort</code>, <code>securedContentPort</code></li></ul>"
},
"subnet":{
"type":"string",
"description":"This attribute is applicable only when creating Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>The Oracle Cloud Identifier (OCID) of a subnet from a virtual cloud network (VCN) created on Oracle Cloud Infrastructure.<p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=oci_general_paasprereqs' target='_blank'>Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure</a> and <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=oci_network_vcns' target='_blank'>VCNs and Subnets</a> in the Oracle Cloud Infrastructure documentation.<p>See also <a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a>.<p>You can specify a subnet that you have created yourself, or you can let Oracle Java Cloud Service automatically assign a subnet for you.<p>To specify a subnet you have created: Use <code>subnet</code> to specify the OCID of the subnet from a VCN that you have created on Oracle Cloud Infrastructure. The OCID is a unique autogenerated ID. To find out the OCID of the subnet, go to the Oracle Cloud Infrastructure web console, select <b>Networking</b> and click the VCN that your subnet is in, then look for the <b>OCID</b> field under the subnet that you want to use.<p>To let Oracle Java Cloud Service assign a subnet for you: Do not include <code>subnet</code> in your provisioning request payload. When excluded, Oracle Java Cloud Service automatically assigns a subnet from the VCN named <code>svc-vcn</code> in the <code>ManagedCompartmentForPaaS</code> compartment.<p><b>Note</b>:<ul><li>You must specify a subnet if you intend to specify subnets for the Oracle-managed load balancer nodes.</li><li>You must specify a subnet if the associated infrastructure schema database is deployed on an Oracle Cloud Infrastructure Database system.</li><li>Database instances in Oracle Database Cloud Service and Oracle Cloud Infrastructure Database must be in the same region and virtual cloud network (VCN) as the Oracle Java Cloud Service instance. The database and service instance do not need to be in the same subnet or availability domain, but you may have to create the necessary security rules in the VCN to enable communication between the subnets.</li><li>To use a private subnet, note that several networking, storage, identity, and compute resources must be created in Oracle Cloud Infrastructure. See <a href='http://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-5CD20E75-5AFA-4726-9775-83F600CD9C83' target='_blank'>Create an Oracle Java Cloud Service Instance Attached to a Private Subnet on Oracle Cloud Infrastructure</a> in <i>Administering Oracle Java Cloud Service</i>.</li></ul>"
},
"tags":{
"type":"array",
"description":"Groups tags for assigning to the service instance after the instance is created. If a tag does not yet assist, it will be created and then assigned to the service instance.",
"items":{
"$ref":"#/definitions/tagsassign-provision"
}
},
"vmPublicKeyText":{
"type":"string",
"description":"The public key for the secure shell (SSH). This key will be used for authentication when connecting to the Oracle Java Cloud Service instance using an SSH client. You generate an SSH public-private key pair using a standard SSH key generation tool. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG3154' target='_blank'>Accessing a Node with a Secure Shell (SSH)</a> in <i>Administering Oracle Java Cloud Service</i>."
},
"useIdentityService":{
"type":"boolean",
"description":"This attribute is applicable only to accounts that include Oracle Identity Cloud Service.<p>Flag that specifies whether to use Oracle Identity Cloud Service (<code>true</code>) or the local WebLogic identity store (<code>false</code>) for user authentication and to maintain administrators, application users, groups and roles. The default value is <code>false</code>.<p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-2B31911D-5276-4198-B124-AC7155464DBE' target='_blank'>Use Oracle Identity Cloud Service with Oracle Java Cloud Service</a> in <i>Administering Oracle Java Cloud Service</i>.<p><b>Note</b>: Oracle Identity Cloud Service must be enabled (that is, set to <code>true</code>) if you specify a secondary identity domain in <code>identityStripe</code>.<p>Consider the following restrictions when enabling Oracle Identity Cloud Service:<ul><li><code>serviceLevel</code> must be <code>PAAS</code></li><li><code>provisionOTD</code> must be <code>false</code></li><li><code>serviceVersion</code> must use one of the 12<i>c</i> versions)</li><li>On Oracle Cloud Infrastructure, <code>configureLoadBalancer</code> cannot be <code>false</code>.</li></ul><p>If you enable Oracle Identity Cloud Service, you do not have the option to configure and manage Oracle Traffic Director (OTD) as a user-managed load balancer that runs within your service instance. Instead, an instance of Oracle Cloud Infrastructure Load Balancing (on Oracle Cloud Infrastructure) or Oracle Cloud Infrastructure Load Balancing Classic (on Oracle Cloud Infrastructure Classic) is created and configured. This Oracle-managed load balancer instance is maintained and patched for you by Oracle. See <code>loadbalancer</code> for the load balancer options you can set (during creation of the Oracle Java Cloud Service instance).<p>Note for <b>Oracle Cloud Infrastructure</b>: You cannot update the Oracle-managed load balancer configuration if the load balancer is provisioned automatically during the creation of the Oracle Java Cloud Service instance. If you need the ability to update the Oracle-managed load balancer configuration for a service instance, you must create and configure the load balancer manually (after you have created your service instance without enabling Oracle Identity Cloud Service). See <a href='https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-92A54DB7-5500-4492-86A5-E5310D380FFD' target='_blank'>Set Up an Oracle Cloud Infrastructure Load Balancer</a> in <i>Administering Oracle Java Cloud Service</i>."
},
"components":{
"type":"object",
"description":"Groups properties for the Oracle WebLogic Server component (<code>WLS</code>) and the optional Oracle Traffice Director (<code>OTD</code>) component.",
"properties":{
"WLS":{
"type":"object",
"description":"Properties for the Oracle WebLogic Server (WLS) component.",
"properties":{
"adminPort":{
"type":"integer",
"description":"Port for accessing WebLogic Server using HTTP. The default value is <code>7001</code>.<p>Note that the <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"adminPassword":{
"type":"string",
"description":"Password for the WebLogic Server administrator. The password must meet the following requirements:<ul><li>Starts with a letter</li><li>Is between 8 and 30 characters long</li><li>Has at least one number</li><li>Has one or more of the following special characters: underscore (_), pound sign (#), dollar sign ($).</li></ul><p>If you are using an Oracle Database Exadata Cloud Service database deployment in <code>dbServiceName</code>, note that the password cannot contain the dollar sign ($) but it can contain the hyphen (-). In addition, there must be 1 uppercase character and 1 lowercase character."
},
"adminUserName":{
"type":"string",
"description":"User name for the WebLogic Server administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:<ul><li>Tab</li><li>Brackets</li><li>Parentheses</li><li>The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).</li></ul>"
},
"appDBs":{
"type":"array",
"description":"Groups details of database deployments that host application schemas, if any are used.<p>Applicable only if you provision a service instance with the associated infrastructure schema database on Oracle Database Cloud Service (Classic).",
"items":{
"$ref":"#/definitions/appDBsm"
}
},
"atpDBName":{
"type":"string",
"description":"This attribute is required only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.<p>Name of the infrastructure schema database deployment.<p>See also <code>atpDBLevel</code>.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"atpDBLevel":{
"type":"string",
"description":"This optional attribute is applicable only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.<p>Level of performance and concurrency for Autonomous Transaction Processing.<p>Possible values are:<ul><li><code>high</code> - (Do not use if the CPU Core count is greater than 1) Provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.</li><li><code>medium</code> - (Do not use if the CPU Core count is greater than 1) Provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.</li><li><code>low</code> - (Default) Provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.</li><li><code>tp</code> - Provides a typical application connection service for transaction processing operations. This connection service does not run with parallelism.</li><li><code>tpurgent</code> - Provides the highest priority application connection service for time critical transaction processing operations. This connection service supports manual parallelism.</li></ul>"
},
"backupVolumeSize":{
"type":"string",
"description":"Size of the backup volume for the service. The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. This value defaults to the system configured volume size."
},
"clusterName":{
"type":"string",
"description":"This attribute is ignored if <code>clusters</code> array is used.<p>Name of the WebLogic Server application cluster that contains the Managed Servers for running the service applications.<p>The cluster name: <ul><li>Must not exceed 50 characters.</li><li>Must start with a letter.</li><li>Must contain only alphabetical characters, underscores (_), or dashes (-).</li><li>Must not contain any other special characters.</li><li>Must be unique within the identity domain.</li></ul>If no value is specified, the name of the cluster will be generated from the first eight characters of the Oracle Java Cloud Service instance name (specified in <code>serviceName</code>), using the following format: <code><i>first8charsOfServiceInstanceName</i>_cluster</code><p><b>Note</b>: If you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system) using Oracle Real Application Clusters (RAC) technology, specify a cluster name. Doing so ensures the DB cluster service is started for the RAC DB."
},
"clusters":{
"type":"array",
"description":"Groups properties for one or more clusters. <p>This attribute is optional for the WebLogic Server application cluster. You must, however, use the <code>clusters</code> array if you want to define a caching (data grid) cluster for the service instance.",
"items":{
"$ref":"#/definitions/clusters-array"
}
},
"connectString":{
"type":"string",
"description":"Connection string for the infrastructure schema database.<p>On <b>Oracle Cloud Infrastructure</b>: This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system).<p>The connection string is a concatenation of the Hostname Prefix and Host Domain Name.<p>For a virtual machine (VM) or Exadata DB system, note that <code>-scan</code> must be appended to the Hostname Prefix.<p>For a bare metal DB system, you do not have to append <code>-scan</code>.<p>To construct the connection string, find the values of <b>Hostname Prefix</b> and <b>Host Domain Name</b> on the Oracle Cloud Infrastructure console. Select <b>Bare Metal, VM, and Exadata</b> (under <b>Database</b>), select the compartment, and click the DB system name you want to use.<p>The connection string must be entered in one of these formats (depending on the DB system type):<ul><li><code>//<i>hostname</i>-scan.<i>networkdomain</i>:1521/<i>pdbname</i>.<i>networkdomain</i></code></li><li><code>//<i>hostname</i>.<i>networkdomain</i>:1521/<i>pdbname</i>.<i>networkdomain</i></code></li></ul><p>Where:<ul><li><i>hostname</i> is the Hostname Prefix. For example: <code>mydb1</code></li><li><i>networkdomain</i> is the Host Domain Name. For example: <code>sub1220.myvcn.oraclevcn.com</code></li><li><i>pdbname</i> is the PDB name you provided when you created the 12c or later DB system. For example: <code>PDB1</code><p>If a PDB name was not specified when you launched the 12c or later DB system, then <i>pdbname</i> is the DB name appended with <code>_PDB1</code>. For example: <code>mydbname_PDB1</code></li></ul><p>VM or Exadata DB system 12c or later examples: (<code>-scan</code> appended to the Hostname Prefix)<p><code>//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com</code><p><code>//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com</code><p>Bare metal DB system 12c or later examples: (<code>-scan</code> is not appended to the Hostname Prefix)<p><code>//mydb1.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com</code><p><code>//mydb1.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com</code><p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>On <b>Oracle Cloud Infrastructure Classic</b>: This attribute is required if you specify a BASIC service level of Database Cloud Service in <code>dbServiceName</code>. It is used to connect to the database deployment on Database Cloud Service - Virtual Image.<p>The connection string must be entered using one of the following formats:<ul><li><code><i>host:port:SID</i></code></li><li><code><i>host:port/serviceName</i></code></li></ul><p>For example:<p><code>example.com:1521:orcl</code> or <code>example.com:1521/mydbservice</code>"
},
"contentPort":{
"type":"integer",
"description":"Port for accessing the deployed applications using HTTP. The default value is 8001.<p>This value is overridden by <code>privilegedContentPort</code> unless its value is set to 0.<p>If a load balancer is configured and enabled, this value has no effect.<p>Note that the <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique. "
},
"dbaName":{
"type":"string",
"description":"User name for the database administrator.<p>This value must <i>not</i> be <code>SYSTEM</code>. Specify a database user that has been granted the <code>SYSDBA</code> privilege. For service instances based on Oracle WebLogic Server 12c (any version), you can use the database user <code>SYS</code>.<p>On <b>Oracle Cloud Infrastructure:</b> This value is always <code>ADMIN</code> if using an infrastructure schema database that is deployed on Oracle Autonomous Transaction Processing."
},
"dbaPassword":{
"type":"string",
"description":"Password for the database administrator that was specified when the infrastructure schema database was created."
},
"dbServiceName":{
"type":"string",
"description":"Name of the infrastructure schema database deployment on Oracle Database Cloud Service (Classic) or Oracle Database Exadata Cloud Service.<p>On <b>Oracle Cloud Infrastructure</b>: This attribute is required only if you are using Oracle Database Cloud Service (Classic) for the infrastructure schema database. See <code>atpDBName</code> and <code>connectString</code> if you are not using Oracle Database Cloud Service (Classic).<p>On <b>Oracle Cloud Infrastructure Classic</b>: This attribute is required.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"deploymentChannelPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using WLST. The default value is <code>9001</code>."
},
"domainMode":{
"type":"string",
"description":"Mode of the domain. Valid values include: <code>DEVELOPMENT</code> and <code>PRODUCTION</code>. The default value is <code>PRODUCTION</code>."
},
"domainName":{
"type":"string",
"description":"Name of the WebLogic domain. By default, the domain name will be generated from the first eight characters of the Oracle Java Cloud Service instance name (<code>serviceName</code>), using the following format: <code><i>first8charsOfServiceInstanceName</i>_domain</code><p>By default, the Managed Server names will be generated from the first eight characters of the domain name name (<code>domainName</code>), using the following format: <code><i>first8charsOfDomainName</i>_server_<i>n</i></code>, where <i>n</i> starts with 1 and is incremented by 1 for each additional Managed Server to ensure each name is unique."
},
"domainPartitionCount":{
"type":"integer",
"description":"Number of partitions to enable in the domain for WebLogic Server 12.2.1. Valid values include: <code>0</code> (no partitions), <code>1</code>, <code>2</code>, and <code>4</code>.<p>Must be <code>0</code> if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product (<code>WCP</code> or <code>ODI</code>)."
},
"domainVolumeSize":{
"type":"string",
"description":"Size of the domain volume for the service. The value must be a multiple of GBs.<p>You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. <p>This value defaults to the system configured volume size."
},
"ipReservations":{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to Managed Server nodes in a WebLogic Server application cluster.<p>A single IP reservation name or a list of multiple IP reservation names separated by commas.<p>If using reserved IPs, all nodes in the cluster must be provisioned with pre-allocated IP addresses. In other words, the number of names in <code>ipReservations</code> must match the number of servers you are provisioning (using <code>managedServerCount</code> or <code>serverCount</code> in <code>clusters</code> array).<p>Note the difference between accounts where regions are supported and not supported.<ul><li><p>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. If <code>ipNetwork</code> is also specified, then <code>assignPublicIP</code> must be <code>true</code> to use <code>ipReservations</code>.<p>Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: When using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
},
"isOciRacDb":{
"type":"boolean",
"description":"This attribute is applicable only to provisioning on Oracle Cloud Infrastructure.<p>This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on an Oracle Cloud Infrastructure Database system that uses Oracle Real Application Clusters (RAC) technology.<p>Default is <code>false</code>. Set to <code>true</code> if the database system is a RAC database. See also <code>ociRacDBName</code>.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"ociRacDBName":{
"type":"string",
"description":"This attribute is applicable only to provisioning Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>This attribute is required if <code>isOciRacDb</code> is set to <code>true</code> during provisioning.<p>The DB name of the associated infrastructure schema database that uses Oracle Real Application Clusters (RAC) technology.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"managedServerCount":{
"type":"integer",
"description":"Number of Managed Servers in the WebLogic Server application cluster. This attribute is ignored if <code>clusters</code> array is used. <p>Valid values include: <code>1</code>, <code>2</code>, <code>4</code>, and <code>8</code>. The default value is <code>1</code>."
},
"msInitialHeapMB":{
"type":"integer",
"description":"Initial Java heap size (<code>-Xms</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>If you specify this initial value, a value greater than 0 (zero) must also be specified for <code>msMaxHeapMB</code>, <code>msMaxPermMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msJvmArgs":{
"type":"string",
"description":"One or more Managed Server JVM arguments separated by a space.<p>You cannot specify any arguments that are related to JVM heap sizes and PermGen spaces (for example, <code>-Xms</code>, <code>-Xmx</code>, <code>-XX:PermSize</code>, and <code>-XX:MaxPermSize</code>).<p>A typical use case would be to set Java system properties using <code>-D<em>name</em>=<em>value</em></code> (for example, <code>-Dmyproject.debugDir=/var/myproject/log</code>).<p>You can overwrite or append the default JVM arguments, which are used to start Managed Server processes. See <code>overwriteMsJvmArgs</code> for information on how to overwrite or append the server start arguments."
},
"msMaxHeapMB":{
"type":"integer",
"description":"Maximum Java heap size (<code>-Xmx</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>If you specify this maximum value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxPermMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msMaxPermMB":{
"type":"integer",
"description":"Maximum Permanent Generation (PermGen) space in Java heap memory (<code>-XX:MaxPermSize</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>Not applicable for a WebLogic Server 12.2.1 instance, which uses JDK 8.<p>If you specify this maximum value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxHeapMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msPermMB":{
"type":"integer",
"description":"Initial Permanent Generation (PermGen) space in Java heap memory (<code>-XX:PermSize</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>Not applicable for a WebLogic Server 12.2.1 instance which uses JDK 8.<p>If you specify this initial value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxHeapMB</code>, and <code>msMaxPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"mwVolumeSize":{
"type":"string",
"description":"Size of the <code>MW_HOME</code> disk volume for the service (<code>/u01/app/oracle/middleware</code>). The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. This value defaults to the system configured volume size."
},
"nodeManagerPort":{
"type":"integer",
"description":"Port for the Node Manager. The default value is <code>5556</code>.<p>Node Manager is a WebLogic Server utility that enables you to start, shut down, and restart Administration Server and Managed Server instances from a remote location.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"nodeManagerPassword":{
"type":"string",
"description":"Password for the Node Manager. This value defaults to the WebLogic Server administrator password (<code>adminPassword</code>) if no value is supplied."
},
"nodeManagerUserName":{
"type":"string",
"description":"User name for the Node Manager. This value defaults to the WebLogic Server administrator user name (<code>adminUserName</code>) if no value is supplied."
},
"overwriteMsJvmArgs":{
"type":"boolean",
"description":"Flag that determines whether the user defined Managed Server JVM arguments specified in <code>msJvmArgs</code> should replace the server start arguments (<code>true</code>), or append the server start arguments (<code>false</code>). Default is <code>false</code>.<p>The server start arguments are calculated automatically by Oracle Java Cloud Service from site default values.<p>If you append (that is, <code>overwriteMsJvmArgs</code> is <code>false</code> or is not set), the user defined arguments specified in <code>msJvmArgs</code> are added to the end of the server start arguments. If you overwrite (that is, set <code>overwriteMsJvmArgs</code> to <code>true</code>), the calculated server start arguments are replaced."
},
"pdbServiceName":{
"type":"string",
"description":"Name of the pluggable database for Oracle Database 12<i>c</i>. If not specified, the pluggable database name that was configured when the database was created will be used.<p><b>Note:</b> This value does not apply to Oracle Database 11<i>g</i>."
},
"privilegedContentPort":{
"type":"integer",
"description":"Privileged content port for accessing the deployed applications using HTTP. The default value is <code>80</code>.<p>If a load balancer is configured and enabled, this value has no effect.<p>To disable the privileged content port, set the value to 0. In this case, if a load balancer is not provisioned, the content port defaults to <code>contentPort</code>, if specified, or <code>8001</code>."
},
"privilegedSecuredContentPort":{
"type":"integer",
"description":"Privileged content port for accessing the deployed applications using HTTPS. The default value is <code>443</code>.<p>If a load balancer is configured and enabled, this value has no effect.<p>To disable the privileged listener port, set the value to 0. In this case, if a load balancer is not provisioned, this value defaults to <code>securedContentPort</code>, if specified, or <code>8002</code>."
},
"sampleAppDeploymentRequested":{
"type":"boolean",
"description":"Flag that specifies whether to automatically deploy and start the sample application, <code>sample-app.war</code>, to the default Managed Server in your service instance. The default value is <code>false</code>.See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-35722F36-98FE-4685-98EC-606A4C5F7DCA' target='_blank'>About the Sample Application Deployed to an Oracle Java Cloud Service Instance</a> in <i>Administering Oracle Java Cloud Service</i>."
},
"securedAdminPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using HTTPS. The default value is <code>7002</code>.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"securedContentPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using HTTPS. The default value is <code>8002</code>.<p>This value is overridden by <code>privilegedSecuredContentPort</code> unless its value is set to <code>0</code>. <p>If a load balancer is configured and enabled, this value has no effect.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the nodes in the cluster. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory)</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
},
"upperStackProductName":{
"type":"string",
"description":"This attribute is not applicable if using an Oracle Autonomous Transaction Processing database to host the associated infrastructure schema.<p>This attribute is required only if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product.<p>The Oracle Fusion Middleware product installer to add to this Oracle Java Cloud Service instance. Valid values are: <ul><li><code>ODI</code> - Oracle Data Integrator</li><li><code>WCP</code> - Oracle WebCenter Portal</li></ul><p>To use <code>upperStackProductName</code>, you must specify:<ul><li><code>12cRelease214</code> as the WebLogic Server software <code>serviceVersion</code> when provisioning on Oracle Cloud Infrastructure and Oracle Cloud Infrastructure Classic</li><li><code>EE</code> or <code>SUITE</code> as the <code>edition</code></li><li><code>PAAS</code> as the <code>serviceLevel</code></li><li><code>0</code> as the <code>domainPartitionCount</code></li></ul><p>After the service instance is provisioned, the specified Fusion Middleware product installer is available in <code>/u01/zips/upperstack</code> on the Administration Server virtual machine. To install the product over the provisioned domain, follow the instructions provided by the Oracle product's installation and configuration documentation.<p>Note: Patching is not supported for Oracle Java Cloud Service instances if you have installed any product that modifies <code>MW_HOME</code> (such as Oracle WebCenter Portal and Oracle Data Integrator). Patching is also not supported if you are reusing a license via the Bring Your Own License (BYOL) entitlement (for any product that modifies <code>MW_HOME</code>). Because patching replaces the contents of <code>MW_HOME</code>, patching prechecks flag this condition and patching fails."
}
},
"required":[
"adminPassword",
"adminUserName",
"atpDBName",
"atpDBLevel",
"connectString",
"dbaName",
"dbaPassword",
"dbServiceName",
"shape"
]
},
"OTD":{
"type":"object",
"description":"Properties for the Oracle Traffic Director (OTD) component.",
"properties":{
"adminPort":{
"type":"integer",
"description":"Port for accessing Oracle Traffic Director using HTTP. The default value is <code>8989</code>."
},
"adminPassword":{
"type":"string",
"description":"Password for the Oracle Traffic Director administrator. The password must meet the following requirements:<ul><li>Starts with a letter</li><li>Is between 8 and 30 characters long</li><li>Has one or more upper case letters</li><li>Has one or more lower case letters</li><li>Has one or more numbers</li><li>Has one or more of the following special characters: hyphen (-), underscore (_), pound sign (#), dollar sign ($). If Exadata is the database for the service instance, the password cannot contain the dollar sign ($).</li></ul><p>If an administrator password is not explicitly set, the OTD administrator password defaults to the WebLogic Server (WLS) administrator password."
},
"adminUserName":{
"type":"string",
"description":"User name for the Oracle Traffic Director administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:<ul><li>Tab</li><li>Brackets</li><li>Parentheses</li><li>The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).</li></ul><p>If a username is not explicitly set, the OTD user name defaults to the WebLogic Server (WLS) administrator user name."
},
"haEnabled":{
"type":"boolean",
"description":"Flag that specifies whether HA is enabled on the user-managed load balancer. This value defaults to <code>false</code> (that is, HA is not enabled)."
},
"ipReservations":{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to user-managed load balancer nodes.<p>A single IP reservation name or two names separated by a comma.<p>The number of names in <code>ipReservations</code> must match the number of load balancer nodes you are provisioning.<p>Note the difference between accounts where regions are supported and not supported.<ul><li>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: If you are using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
},
"listenerPort":{
"type":"integer",
"description":"Listener port for the user-managed load balancer for accessing deployed applications using HTTP. The default value is <code>8080</code>.<p>This value is overridden by <code>privilegedListenerPort</code> unless its value is set to 0. This value has no effect if the load balancer is disabled."
},
"listenerPortEnabled":{
"type":"boolean",
"description":"Flag that specifies whether the non-secure listener port is enabled on the user-managed load balancer. The default value is <code>true</code>."
},
"loadBalancingPolicy":{
"type":"string",
"description":"Policy to use for routing requests to the user-managed balancer. Valid policies include: <ul><li><code>LEAST_CONNECTION_COUNT</code> - Passes each new request to the Managed Server with the least number of connections. This policy is useful for smoothing distribution when Managed Servers get bogged down. Managed Servers with greater processing power to handle requests will receive more connections over time. This is the default.</li><li><code>LEAST_RESPONSE_TIME</code> - Passes each new request to the Managed Server with the fastest response time. This policy is useful when Managed Servers are distributed across networks.</li><li><code>ROUND_ROBIN</code> - Passes each new request to the next Managed Server in line, evenly distributing requests across all Managed Servers regardless of the number of connections or response time.</li></ul>"
},
"privilegedListenerPort":{
"type":"integer",
"description":"Privileged listener port for accessing the deployed applications using HTTP. The default value is <code>80</code>.<p>This value has no effect if the user-managed load balancer is disabled.<p>To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to <code>listenerPort</code>, if specified, or <code>8080</code>."
},
"privilegedSecuredListenerPort":{
"type":"integer",
"description":"Privileged listener port for accessing the deployed applications using HTTPS. The default value is <code>443</code>.<p>This value has no effect if the user-managed load balancer is disabled.<p>To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to <code>securedListenerPort</code>, if specified, or <code>8081</code>."
},
"securedListenerPort":{
"type":"integer",
"description":"Secured listener port for accessing the deployed applications using HTTPS. The default value is <code>8081</code>.<p>This value is overridden by <code>privilegedSecuredContentPort</code> unless its value is set to 0. This value has no effect if the user-managed load balancer is disabled."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the local balancer nodes. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
}
}
}
},
"required":[
"WLS"
]
}
},
"required":[
"serviceName",
"region",
"vmPublicKeyText"
]
}
Nested Schema : components
Type: object
Groups properties for the Oracle WebLogic Server component (WLS
) and the optional Oracle Traffice Director (OTD
) component.
Show Source
{
"type":"object",
"description":"Groups properties for the Oracle WebLogic Server component (<code>WLS</code>) and the optional Oracle Traffice Director (<code>OTD</code>) component.",
"properties":{
"WLS":{
"type":"object",
"description":"Properties for the Oracle WebLogic Server (WLS) component.",
"properties":{
"adminPort":{
"type":"integer",
"description":"Port for accessing WebLogic Server using HTTP. The default value is <code>7001</code>.<p>Note that the <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"adminPassword":{
"type":"string",
"description":"Password for the WebLogic Server administrator. The password must meet the following requirements:<ul><li>Starts with a letter</li><li>Is between 8 and 30 characters long</li><li>Has at least one number</li><li>Has one or more of the following special characters: underscore (_), pound sign (#), dollar sign ($).</li></ul><p>If you are using an Oracle Database Exadata Cloud Service database deployment in <code>dbServiceName</code>, note that the password cannot contain the dollar sign ($) but it can contain the hyphen (-). In addition, there must be 1 uppercase character and 1 lowercase character."
},
"adminUserName":{
"type":"string",
"description":"User name for the WebLogic Server administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:<ul><li>Tab</li><li>Brackets</li><li>Parentheses</li><li>The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).</li></ul>"
},
"appDBs":{
"type":"array",
"description":"Groups details of database deployments that host application schemas, if any are used.<p>Applicable only if you provision a service instance with the associated infrastructure schema database on Oracle Database Cloud Service (Classic).",
"items":{
"$ref":"#/definitions/appDBsm"
}
},
"atpDBName":{
"type":"string",
"description":"This attribute is required only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.<p>Name of the infrastructure schema database deployment.<p>See also <code>atpDBLevel</code>.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"atpDBLevel":{
"type":"string",
"description":"This optional attribute is applicable only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.<p>Level of performance and concurrency for Autonomous Transaction Processing.<p>Possible values are:<ul><li><code>high</code> - (Do not use if the CPU Core count is greater than 1) Provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.</li><li><code>medium</code> - (Do not use if the CPU Core count is greater than 1) Provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.</li><li><code>low</code> - (Default) Provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.</li><li><code>tp</code> - Provides a typical application connection service for transaction processing operations. This connection service does not run with parallelism.</li><li><code>tpurgent</code> - Provides the highest priority application connection service for time critical transaction processing operations. This connection service supports manual parallelism.</li></ul>"
},
"backupVolumeSize":{
"type":"string",
"description":"Size of the backup volume for the service. The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. This value defaults to the system configured volume size."
},
"clusterName":{
"type":"string",
"description":"This attribute is ignored if <code>clusters</code> array is used.<p>Name of the WebLogic Server application cluster that contains the Managed Servers for running the service applications.<p>The cluster name: <ul><li>Must not exceed 50 characters.</li><li>Must start with a letter.</li><li>Must contain only alphabetical characters, underscores (_), or dashes (-).</li><li>Must not contain any other special characters.</li><li>Must be unique within the identity domain.</li></ul>If no value is specified, the name of the cluster will be generated from the first eight characters of the Oracle Java Cloud Service instance name (specified in <code>serviceName</code>), using the following format: <code><i>first8charsOfServiceInstanceName</i>_cluster</code><p><b>Note</b>: If you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system) using Oracle Real Application Clusters (RAC) technology, specify a cluster name. Doing so ensures the DB cluster service is started for the RAC DB."
},
"clusters":{
"type":"array",
"description":"Groups properties for one or more clusters. <p>This attribute is optional for the WebLogic Server application cluster. You must, however, use the <code>clusters</code> array if you want to define a caching (data grid) cluster for the service instance.",
"items":{
"$ref":"#/definitions/clusters-array"
}
},
"connectString":{
"type":"string",
"description":"Connection string for the infrastructure schema database.<p>On <b>Oracle Cloud Infrastructure</b>: This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system).<p>The connection string is a concatenation of the Hostname Prefix and Host Domain Name.<p>For a virtual machine (VM) or Exadata DB system, note that <code>-scan</code> must be appended to the Hostname Prefix.<p>For a bare metal DB system, you do not have to append <code>-scan</code>.<p>To construct the connection string, find the values of <b>Hostname Prefix</b> and <b>Host Domain Name</b> on the Oracle Cloud Infrastructure console. Select <b>Bare Metal, VM, and Exadata</b> (under <b>Database</b>), select the compartment, and click the DB system name you want to use.<p>The connection string must be entered in one of these formats (depending on the DB system type):<ul><li><code>//<i>hostname</i>-scan.<i>networkdomain</i>:1521/<i>pdbname</i>.<i>networkdomain</i></code></li><li><code>//<i>hostname</i>.<i>networkdomain</i>:1521/<i>pdbname</i>.<i>networkdomain</i></code></li></ul><p>Where:<ul><li><i>hostname</i> is the Hostname Prefix. For example: <code>mydb1</code></li><li><i>networkdomain</i> is the Host Domain Name. For example: <code>sub1220.myvcn.oraclevcn.com</code></li><li><i>pdbname</i> is the PDB name you provided when you created the 12c or later DB system. For example: <code>PDB1</code><p>If a PDB name was not specified when you launched the 12c or later DB system, then <i>pdbname</i> is the DB name appended with <code>_PDB1</code>. For example: <code>mydbname_PDB1</code></li></ul><p>VM or Exadata DB system 12c or later examples: (<code>-scan</code> appended to the Hostname Prefix)<p><code>//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com</code><p><code>//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com</code><p>Bare metal DB system 12c or later examples: (<code>-scan</code> is not appended to the Hostname Prefix)<p><code>//mydb1.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com</code><p><code>//mydb1.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com</code><p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>On <b>Oracle Cloud Infrastructure Classic</b>: This attribute is required if you specify a BASIC service level of Database Cloud Service in <code>dbServiceName</code>. It is used to connect to the database deployment on Database Cloud Service - Virtual Image.<p>The connection string must be entered using one of the following formats:<ul><li><code><i>host:port:SID</i></code></li><li><code><i>host:port/serviceName</i></code></li></ul><p>For example:<p><code>example.com:1521:orcl</code> or <code>example.com:1521/mydbservice</code>"
},
"contentPort":{
"type":"integer",
"description":"Port for accessing the deployed applications using HTTP. The default value is 8001.<p>This value is overridden by <code>privilegedContentPort</code> unless its value is set to 0.<p>If a load balancer is configured and enabled, this value has no effect.<p>Note that the <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique. "
},
"dbaName":{
"type":"string",
"description":"User name for the database administrator.<p>This value must <i>not</i> be <code>SYSTEM</code>. Specify a database user that has been granted the <code>SYSDBA</code> privilege. For service instances based on Oracle WebLogic Server 12c (any version), you can use the database user <code>SYS</code>.<p>On <b>Oracle Cloud Infrastructure:</b> This value is always <code>ADMIN</code> if using an infrastructure schema database that is deployed on Oracle Autonomous Transaction Processing."
},
"dbaPassword":{
"type":"string",
"description":"Password for the database administrator that was specified when the infrastructure schema database was created."
},
"dbServiceName":{
"type":"string",
"description":"Name of the infrastructure schema database deployment on Oracle Database Cloud Service (Classic) or Oracle Database Exadata Cloud Service.<p>On <b>Oracle Cloud Infrastructure</b>: This attribute is required only if you are using Oracle Database Cloud Service (Classic) for the infrastructure schema database. See <code>atpDBName</code> and <code>connectString</code> if you are not using Oracle Database Cloud Service (Classic).<p>On <b>Oracle Cloud Infrastructure Classic</b>: This attribute is required.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"deploymentChannelPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using WLST. The default value is <code>9001</code>."
},
"domainMode":{
"type":"string",
"description":"Mode of the domain. Valid values include: <code>DEVELOPMENT</code> and <code>PRODUCTION</code>. The default value is <code>PRODUCTION</code>."
},
"domainName":{
"type":"string",
"description":"Name of the WebLogic domain. By default, the domain name will be generated from the first eight characters of the Oracle Java Cloud Service instance name (<code>serviceName</code>), using the following format: <code><i>first8charsOfServiceInstanceName</i>_domain</code><p>By default, the Managed Server names will be generated from the first eight characters of the domain name name (<code>domainName</code>), using the following format: <code><i>first8charsOfDomainName</i>_server_<i>n</i></code>, where <i>n</i> starts with 1 and is incremented by 1 for each additional Managed Server to ensure each name is unique."
},
"domainPartitionCount":{
"type":"integer",
"description":"Number of partitions to enable in the domain for WebLogic Server 12.2.1. Valid values include: <code>0</code> (no partitions), <code>1</code>, <code>2</code>, and <code>4</code>.<p>Must be <code>0</code> if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product (<code>WCP</code> or <code>ODI</code>)."
},
"domainVolumeSize":{
"type":"string",
"description":"Size of the domain volume for the service. The value must be a multiple of GBs.<p>You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. <p>This value defaults to the system configured volume size."
},
"ipReservations":{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to Managed Server nodes in a WebLogic Server application cluster.<p>A single IP reservation name or a list of multiple IP reservation names separated by commas.<p>If using reserved IPs, all nodes in the cluster must be provisioned with pre-allocated IP addresses. In other words, the number of names in <code>ipReservations</code> must match the number of servers you are provisioning (using <code>managedServerCount</code> or <code>serverCount</code> in <code>clusters</code> array).<p>Note the difference between accounts where regions are supported and not supported.<ul><li><p>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. If <code>ipNetwork</code> is also specified, then <code>assignPublicIP</code> must be <code>true</code> to use <code>ipReservations</code>.<p>Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: When using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
},
"isOciRacDb":{
"type":"boolean",
"description":"This attribute is applicable only to provisioning on Oracle Cloud Infrastructure.<p>This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on an Oracle Cloud Infrastructure Database system that uses Oracle Real Application Clusters (RAC) technology.<p>Default is <code>false</code>. Set to <code>true</code> if the database system is a RAC database. See also <code>ociRacDBName</code>.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"ociRacDBName":{
"type":"string",
"description":"This attribute is applicable only to provisioning Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>This attribute is required if <code>isOciRacDb</code> is set to <code>true</code> during provisioning.<p>The DB name of the associated infrastructure schema database that uses Oracle Real Application Clusters (RAC) technology.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"managedServerCount":{
"type":"integer",
"description":"Number of Managed Servers in the WebLogic Server application cluster. This attribute is ignored if <code>clusters</code> array is used. <p>Valid values include: <code>1</code>, <code>2</code>, <code>4</code>, and <code>8</code>. The default value is <code>1</code>."
},
"msInitialHeapMB":{
"type":"integer",
"description":"Initial Java heap size (<code>-Xms</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>If you specify this initial value, a value greater than 0 (zero) must also be specified for <code>msMaxHeapMB</code>, <code>msMaxPermMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msJvmArgs":{
"type":"string",
"description":"One or more Managed Server JVM arguments separated by a space.<p>You cannot specify any arguments that are related to JVM heap sizes and PermGen spaces (for example, <code>-Xms</code>, <code>-Xmx</code>, <code>-XX:PermSize</code>, and <code>-XX:MaxPermSize</code>).<p>A typical use case would be to set Java system properties using <code>-D<em>name</em>=<em>value</em></code> (for example, <code>-Dmyproject.debugDir=/var/myproject/log</code>).<p>You can overwrite or append the default JVM arguments, which are used to start Managed Server processes. See <code>overwriteMsJvmArgs</code> for information on how to overwrite or append the server start arguments."
},
"msMaxHeapMB":{
"type":"integer",
"description":"Maximum Java heap size (<code>-Xmx</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>If you specify this maximum value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxPermMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msMaxPermMB":{
"type":"integer",
"description":"Maximum Permanent Generation (PermGen) space in Java heap memory (<code>-XX:MaxPermSize</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>Not applicable for a WebLogic Server 12.2.1 instance, which uses JDK 8.<p>If you specify this maximum value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxHeapMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msPermMB":{
"type":"integer",
"description":"Initial Permanent Generation (PermGen) space in Java heap memory (<code>-XX:PermSize</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>Not applicable for a WebLogic Server 12.2.1 instance which uses JDK 8.<p>If you specify this initial value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxHeapMB</code>, and <code>msMaxPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"mwVolumeSize":{
"type":"string",
"description":"Size of the <code>MW_HOME</code> disk volume for the service (<code>/u01/app/oracle/middleware</code>). The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. This value defaults to the system configured volume size."
},
"nodeManagerPort":{
"type":"integer",
"description":"Port for the Node Manager. The default value is <code>5556</code>.<p>Node Manager is a WebLogic Server utility that enables you to start, shut down, and restart Administration Server and Managed Server instances from a remote location.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"nodeManagerPassword":{
"type":"string",
"description":"Password for the Node Manager. This value defaults to the WebLogic Server administrator password (<code>adminPassword</code>) if no value is supplied."
},
"nodeManagerUserName":{
"type":"string",
"description":"User name for the Node Manager. This value defaults to the WebLogic Server administrator user name (<code>adminUserName</code>) if no value is supplied."
},
"overwriteMsJvmArgs":{
"type":"boolean",
"description":"Flag that determines whether the user defined Managed Server JVM arguments specified in <code>msJvmArgs</code> should replace the server start arguments (<code>true</code>), or append the server start arguments (<code>false</code>). Default is <code>false</code>.<p>The server start arguments are calculated automatically by Oracle Java Cloud Service from site default values.<p>If you append (that is, <code>overwriteMsJvmArgs</code> is <code>false</code> or is not set), the user defined arguments specified in <code>msJvmArgs</code> are added to the end of the server start arguments. If you overwrite (that is, set <code>overwriteMsJvmArgs</code> to <code>true</code>), the calculated server start arguments are replaced."
},
"pdbServiceName":{
"type":"string",
"description":"Name of the pluggable database for Oracle Database 12<i>c</i>. If not specified, the pluggable database name that was configured when the database was created will be used.<p><b>Note:</b> This value does not apply to Oracle Database 11<i>g</i>."
},
"privilegedContentPort":{
"type":"integer",
"description":"Privileged content port for accessing the deployed applications using HTTP. The default value is <code>80</code>.<p>If a load balancer is configured and enabled, this value has no effect.<p>To disable the privileged content port, set the value to 0. In this case, if a load balancer is not provisioned, the content port defaults to <code>contentPort</code>, if specified, or <code>8001</code>."
},
"privilegedSecuredContentPort":{
"type":"integer",
"description":"Privileged content port for accessing the deployed applications using HTTPS. The default value is <code>443</code>.<p>If a load balancer is configured and enabled, this value has no effect.<p>To disable the privileged listener port, set the value to 0. In this case, if a load balancer is not provisioned, this value defaults to <code>securedContentPort</code>, if specified, or <code>8002</code>."
},
"sampleAppDeploymentRequested":{
"type":"boolean",
"description":"Flag that specifies whether to automatically deploy and start the sample application, <code>sample-app.war</code>, to the default Managed Server in your service instance. The default value is <code>false</code>.See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-35722F36-98FE-4685-98EC-606A4C5F7DCA' target='_blank'>About the Sample Application Deployed to an Oracle Java Cloud Service Instance</a> in <i>Administering Oracle Java Cloud Service</i>."
},
"securedAdminPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using HTTPS. The default value is <code>7002</code>.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"securedContentPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using HTTPS. The default value is <code>8002</code>.<p>This value is overridden by <code>privilegedSecuredContentPort</code> unless its value is set to <code>0</code>. <p>If a load balancer is configured and enabled, this value has no effect.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the nodes in the cluster. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory)</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
},
"upperStackProductName":{
"type":"string",
"description":"This attribute is not applicable if using an Oracle Autonomous Transaction Processing database to host the associated infrastructure schema.<p>This attribute is required only if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product.<p>The Oracle Fusion Middleware product installer to add to this Oracle Java Cloud Service instance. Valid values are: <ul><li><code>ODI</code> - Oracle Data Integrator</li><li><code>WCP</code> - Oracle WebCenter Portal</li></ul><p>To use <code>upperStackProductName</code>, you must specify:<ul><li><code>12cRelease214</code> as the WebLogic Server software <code>serviceVersion</code> when provisioning on Oracle Cloud Infrastructure and Oracle Cloud Infrastructure Classic</li><li><code>EE</code> or <code>SUITE</code> as the <code>edition</code></li><li><code>PAAS</code> as the <code>serviceLevel</code></li><li><code>0</code> as the <code>domainPartitionCount</code></li></ul><p>After the service instance is provisioned, the specified Fusion Middleware product installer is available in <code>/u01/zips/upperstack</code> on the Administration Server virtual machine. To install the product over the provisioned domain, follow the instructions provided by the Oracle product's installation and configuration documentation.<p>Note: Patching is not supported for Oracle Java Cloud Service instances if you have installed any product that modifies <code>MW_HOME</code> (such as Oracle WebCenter Portal and Oracle Data Integrator). Patching is also not supported if you are reusing a license via the Bring Your Own License (BYOL) entitlement (for any product that modifies <code>MW_HOME</code>). Because patching replaces the contents of <code>MW_HOME</code>, patching prechecks flag this condition and patching fails."
}
},
"required":[
"adminPassword",
"adminUserName",
"atpDBName",
"atpDBLevel",
"connectString",
"dbaName",
"dbaPassword",
"dbServiceName",
"shape"
]
},
"OTD":{
"type":"object",
"description":"Properties for the Oracle Traffic Director (OTD) component.",
"properties":{
"adminPort":{
"type":"integer",
"description":"Port for accessing Oracle Traffic Director using HTTP. The default value is <code>8989</code>."
},
"adminPassword":{
"type":"string",
"description":"Password for the Oracle Traffic Director administrator. The password must meet the following requirements:<ul><li>Starts with a letter</li><li>Is between 8 and 30 characters long</li><li>Has one or more upper case letters</li><li>Has one or more lower case letters</li><li>Has one or more numbers</li><li>Has one or more of the following special characters: hyphen (-), underscore (_), pound sign (#), dollar sign ($). If Exadata is the database for the service instance, the password cannot contain the dollar sign ($).</li></ul><p>If an administrator password is not explicitly set, the OTD administrator password defaults to the WebLogic Server (WLS) administrator password."
},
"adminUserName":{
"type":"string",
"description":"User name for the Oracle Traffic Director administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:<ul><li>Tab</li><li>Brackets</li><li>Parentheses</li><li>The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).</li></ul><p>If a username is not explicitly set, the OTD user name defaults to the WebLogic Server (WLS) administrator user name."
},
"haEnabled":{
"type":"boolean",
"description":"Flag that specifies whether HA is enabled on the user-managed load balancer. This value defaults to <code>false</code> (that is, HA is not enabled)."
},
"ipReservations":{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to user-managed load balancer nodes.<p>A single IP reservation name or two names separated by a comma.<p>The number of names in <code>ipReservations</code> must match the number of load balancer nodes you are provisioning.<p>Note the difference between accounts where regions are supported and not supported.<ul><li>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: If you are using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
},
"listenerPort":{
"type":"integer",
"description":"Listener port for the user-managed load balancer for accessing deployed applications using HTTP. The default value is <code>8080</code>.<p>This value is overridden by <code>privilegedListenerPort</code> unless its value is set to 0. This value has no effect if the load balancer is disabled."
},
"listenerPortEnabled":{
"type":"boolean",
"description":"Flag that specifies whether the non-secure listener port is enabled on the user-managed load balancer. The default value is <code>true</code>."
},
"loadBalancingPolicy":{
"type":"string",
"description":"Policy to use for routing requests to the user-managed balancer. Valid policies include: <ul><li><code>LEAST_CONNECTION_COUNT</code> - Passes each new request to the Managed Server with the least number of connections. This policy is useful for smoothing distribution when Managed Servers get bogged down. Managed Servers with greater processing power to handle requests will receive more connections over time. This is the default.</li><li><code>LEAST_RESPONSE_TIME</code> - Passes each new request to the Managed Server with the fastest response time. This policy is useful when Managed Servers are distributed across networks.</li><li><code>ROUND_ROBIN</code> - Passes each new request to the next Managed Server in line, evenly distributing requests across all Managed Servers regardless of the number of connections or response time.</li></ul>"
},
"privilegedListenerPort":{
"type":"integer",
"description":"Privileged listener port for accessing the deployed applications using HTTP. The default value is <code>80</code>.<p>This value has no effect if the user-managed load balancer is disabled.<p>To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to <code>listenerPort</code>, if specified, or <code>8080</code>."
},
"privilegedSecuredListenerPort":{
"type":"integer",
"description":"Privileged listener port for accessing the deployed applications using HTTPS. The default value is <code>443</code>.<p>This value has no effect if the user-managed load balancer is disabled.<p>To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to <code>securedListenerPort</code>, if specified, or <code>8081</code>."
},
"securedListenerPort":{
"type":"integer",
"description":"Secured listener port for accessing the deployed applications using HTTPS. The default value is <code>8081</code>.<p>This value is overridden by <code>privilegedSecuredContentPort</code> unless its value is set to 0. This value has no effect if the user-managed load balancer is disabled."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the local balancer nodes. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
}
}
}
},
"required":[
"WLS"
]
}
Nested Schema : loadbalancer
Type: object
Groups properties for the Oracle-managed load balancer, which is maintained and patched by Oracle.
The Oracle-managed load balancer is an instance of Oracle Cloud Infrastructure Load Balancing (on Oracle Cloud Infrastructure) or Oracle Cloud Infrastructure Load Balancing Classic (on Oracle Cloud Infrastructure Classic).
This attribute is applicable when provisioning a service instance with useIdentityService
set to true
. See loadBalancingPolicy
for the load balancer policy options you can set.
In addition, on Oracle Cloud Infrastructure:
- This attribute is also applicable when provisioning a service instance without enabling Oracle Identity Cloud Service, but with
configureLoadBalancer
set to true
. - Regardless of whether
useIdentityService
is set to true
, if a specific subnet
is specified for the service instance, you must also specify subnets for the Oracle-managed load balancer nodes (node 1 and node 2). See subnets
. - If you need the ability to update the Oracle-managed load balancer configuration for an Oracle Java Cloud Service instance, do not provision the load balancer during the creation of the service instance. This is because you cannot update the Oracle-managed load balancer configuration if the load balancer is provisioned automatically during the creation of the service instance. To be able to update the configuration of the Oracle-managed load balancer instance provisioned for your service instance, you must create and configure the load balancer manually (after you have created your service instance). See Set Up an Oracle Cloud Infrastructure Load Balancer in Administering Oracle Java Cloud Service.
Show Source
-
loadBalancingPolicy(optional):
string
Policy to use for routing requests to the origin servers of the Oracle-managed load balancer.
Valid policy values include:
LEAST_CONN
- Passes each new request to the server with the least number of active connections.IP_HASH
- Uses the incoming request source IP address as a hashing key to determine the server to route each request. Unlike ROUND_ROBIN
and LEAST_CONN
load balancing where each subsequent client request can be routed to a different server, IP_HASH
ensures that requests from the same client are always routed to the same server (as long as the server is available).ROUND_ROBIN
- Passes each new request to the next server in line, evenly distributing requests across all servers. This is the default value.
-
subnets(optional):
array subnets
This attribute is available only on Oracle Cloud Infrastructure.
This attribute is required if you are provisioning an Oracle Java Cloud Service instance on a specific subnet using subnet
.
Subnets for the Oracle-managed load balancer nodes (node 1 and node 2).
Use the OCID of a public subnet. The OCID is a unique autogenerated ID. To find out the OCID of a subnet, go to the Oracle Cloud Infrastructure web console, select Networking and click the VCN that your subnet is in, then look for the OCID field under the subnet that you want to use.
Oracle recommends that you use a regional subnet for the load balancer to support failover to another availability domain if needed.
Note the following:
- In a
region
that has a single availability domain, only one subnet value can be provided. - If a regional subnet is specified, then only one subnet value can be provided.
- If a subnet that is scoped for an availability domain is specified, then two subnet values must be provided. For each Oracle-managed load balancer node, use a subnet from a different availability domain. For one of the nodes, Oracle recommends using a subnet from the same
availabilityDomain
as specified for the service instance. This ensures that, as long as the service instance is running, the applications deployed on it remain accessible through the Oracle-managed load balancer.
{
"type":"object",
"description":"Groups properties for the Oracle-managed load balancer, which is maintained and patched by Oracle.<p>The Oracle-managed load balancer is an instance of Oracle Cloud Infrastructure Load Balancing (on Oracle Cloud Infrastructure) or Oracle Cloud Infrastructure Load Balancing Classic (on Oracle Cloud Infrastructure Classic).<p>This attribute is applicable when provisioning a service instance with <code>useIdentityService</code> set to <code>true</code>. See <code>loadBalancingPolicy</code> for the load balancer policy options you can set.<p>In addition, on <b>Oracle Cloud Infrastructure</b>:<ul><li>This attribute is also applicable when provisioning a service instance without enabling Oracle Identity Cloud Service, but with <code>configureLoadBalancer</code> set to <code>true</code>.</li><li>Regardless of whether <code>useIdentityService</code> is set to <code>true</code>, if a specific <code>subnet</code> is specified for the service instance, you must also specify subnets for the Oracle-managed load balancer nodes (node 1 and node 2). See <code>subnets</code>.</li><li>If you need the ability to update the Oracle-managed load balancer configuration for an Oracle Java Cloud Service instance, do not provision the load balancer during the creation of the service instance. This is because you cannot update the Oracle-managed load balancer configuration if the load balancer is provisioned automatically during the creation of the service instance. To be able to update the configuration of the Oracle-managed load balancer instance provisioned for your service instance, you must create and configure the load balancer manually (after you have created your service instance). See <a href='https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-92A54DB7-5500-4492-86A5-E5310D380FFD' target='_blank'>Set Up an Oracle Cloud Infrastructure Load Balancer</a> in <i>Administering Oracle Java Cloud Service</i>.</li></ul>",
"properties":{
"loadBalancingPolicy":{
"type":"string",
"description":"Policy to use for routing requests to the origin servers of the Oracle-managed load balancer.<p>Valid policy values include: <ul><li><code>LEAST_CONN</code> - Passes each new request to the server with the least number of active connections.</li><li><code>IP_HASH</code> - Uses the incoming request source IP address as a hashing key to determine the server to route each request. Unlike <code>ROUND_ROBIN</code> and <code>LEAST_CONN</code> load balancing where each subsequent client request can be routed to a different server, <code>IP_HASH</code> ensures that requests from the same client are always routed to the same server (as long as the server is available).</li><li><code>ROUND_ROBIN</code> - Passes each new request to the next server in line, evenly distributing requests across all servers. This is the default value.</li></ul>"
},
"subnets":{
"type":"array",
"description":"This attribute is available only on Oracle Cloud Infrastructure.<p>This attribute is required if you are provisioning an Oracle Java Cloud Service instance on a specific subnet using <code>subnet</code>.<p>Subnets for the Oracle-managed load balancer nodes (node 1 and node 2).<p>Use the OCID of a public subnet. The OCID is a unique autogenerated ID. To find out the OCID of a subnet, go to the Oracle Cloud Infrastructure web console, select <b>Networking</b> and click the VCN that your subnet is in, then look for the <b>OCID</b> field under the subnet that you want to use.<p>Oracle recommends that you use a regional subnet for the load balancer to support failover to another availability domain if needed.<p>Note the following:<ul><li>In a <code>region</code> that has a single availability domain, only one subnet value can be provided.</li><li>If a regional subnet is specified, then only one subnet value can be provided.</li><li>If a subnet that is scoped for an availability domain is specified, then two subnet values must be provided. For each Oracle-managed load balancer node, use a subnet from a different availability domain. For one of the nodes, Oracle recommends using a subnet from the same <code>availabilityDomain</code> as specified for the service instance. This ensures that, as long as the service instance is running, the applications deployed on it remain accessible through the Oracle-managed load balancer.</li></ul>",
"items":{
"type":"string"
}
}
}
}
Nested Schema : tags
Type: array
Groups tags for assigning to the service instance after the instance is created. If a tag does not yet assist, it will be created and then assigned to the service instance.
Show Source
{
"type":"array",
"description":"Groups tags for assigning to the service instance after the instance is created. If a tag does not yet assist, it will be created and then assigned to the service instance.",
"items":{
"$ref":"#/definitions/tagsassign-provision"
}
}
Nested Schema : OTD
Type: object
Properties for the Oracle Traffic Director (OTD) component.
Show Source
-
adminPassword(optional):
string
Password for the Oracle Traffic Director administrator. The password must meet the following requirements:
- Starts with a letter
- Is between 8 and 30 characters long
- Has one or more upper case letters
- Has one or more lower case letters
- Has one or more numbers
- Has one or more of the following special characters: hyphen (-), underscore (_), pound sign (#), dollar sign ($). If Exadata is the database for the service instance, the password cannot contain the dollar sign ($).
If an administrator password is not explicitly set, the OTD administrator password defaults to the WebLogic Server (WLS) administrator password.
-
adminPort(optional):
integer
Port for accessing Oracle Traffic Director using HTTP. The default value is 8989
.
-
adminUserName(optional):
string
User name for the Oracle Traffic Director administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:
- Tab
- Brackets
- Parentheses
- The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).
If a username is not explicitly set, the OTD user name defaults to the WebLogic Server (WLS) administrator user name.
-
haEnabled(optional):
boolean
Flag that specifies whether HA is enabled on the user-managed load balancer. This value defaults to false
(that is, HA is not enabled).
-
ipReservations(optional):
array ipReservations
This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
Reserved or pre-allocated IP addresses can be assigned to user-managed load balancer nodes.
A single IP reservation name or two names separated by a comma.
The number of names in ipReservations
must match the number of load balancer nodes you are provisioning.
Note the difference between accounts where regions are supported and not supported.
-
listenerPort(optional):
integer
Listener port for the user-managed load balancer for accessing deployed applications using HTTP. The default value is
8080
.
This value is overridden by privilegedListenerPort
unless its value is set to 0. This value has no effect if the load balancer is disabled.
-
listenerPortEnabled(optional):
boolean
Flag that specifies whether the non-secure listener port is enabled on the user-managed load balancer. The default value is true
.
-
loadBalancingPolicy(optional):
string
Policy to use for routing requests to the user-managed balancer. Valid policies include:
LEAST_CONNECTION_COUNT
- Passes each new request to the Managed Server with the least number of connections. This policy is useful for smoothing distribution when Managed Servers get bogged down. Managed Servers with greater processing power to handle requests will receive more connections over time. This is the default.LEAST_RESPONSE_TIME
- Passes each new request to the Managed Server with the fastest response time. This policy is useful when Managed Servers are distributed across networks.ROUND_ROBIN
- Passes each new request to the next Managed Server in line, evenly distributing requests across all Managed Servers regardless of the number of connections or response time.
-
privilegedListenerPort(optional):
integer
Privileged listener port for accessing the deployed applications using HTTP. The default value is
80
.
This value has no effect if the user-managed load balancer is disabled.
To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to listenerPort
, if specified, or 8080
.
-
privilegedSecuredListenerPort(optional):
integer
Privileged listener port for accessing the deployed applications using HTTPS. The default value is
443
.
This value has no effect if the user-managed load balancer is disabled.
To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to securedListenerPort
, if specified, or 8081
.
-
securedListenerPort(optional):
integer
Secured listener port for accessing the deployed applications using HTTPS. The default value is
8081
.
This value is overridden by privilegedSecuredContentPort
unless its value is set to 0. This value has no effect if the user-managed load balancer is disabled.
-
shape(optional):
string
Desired compute shape for the local balancer nodes. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).
On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported.
You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs.
Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.
See Compute Shapes in the Oracle Cloud Infrastructure documentation.
On Oracle Cloud Infrastructure Classic, valid shapes include:
- oc3: 1 OCPU, 7.5 GB memory
- oc4: 2 OCPUs, 15 GB memory
- oc5: 4 OCPUs, 30 GB memory
- oc6: 8 OCPUs, 60 GB memory
- oc7: 16 OCPUs, 120 GB memory
- oc8: 24 OCPUs, 180 GB memory
- oc9: 32 OCPUs, 240 GB memory
- oc1m: 1 OCPU, 15 GB memory
- oc2m: 2 OCPUs, 30 GB memory
- oc3m: 4 OCPUs, 60 GB memory
- oc4m: 8 OCPUs, 120 GB memory
- oc5m: 16 OCPUs, 240 GB memory
- oc8m: 24 OCPUs, 360 GB memory
- oc9m: 32 OCPUs, 480 GB memory
Note: Some shapes might not be available in a region.
{
"type":"object",
"description":"Properties for the Oracle Traffic Director (OTD) component.",
"properties":{
"adminPort":{
"type":"integer",
"description":"Port for accessing Oracle Traffic Director using HTTP. The default value is <code>8989</code>."
},
"adminPassword":{
"type":"string",
"description":"Password for the Oracle Traffic Director administrator. The password must meet the following requirements:<ul><li>Starts with a letter</li><li>Is between 8 and 30 characters long</li><li>Has one or more upper case letters</li><li>Has one or more lower case letters</li><li>Has one or more numbers</li><li>Has one or more of the following special characters: hyphen (-), underscore (_), pound sign (#), dollar sign ($). If Exadata is the database for the service instance, the password cannot contain the dollar sign ($).</li></ul><p>If an administrator password is not explicitly set, the OTD administrator password defaults to the WebLogic Server (WLS) administrator password."
},
"adminUserName":{
"type":"string",
"description":"User name for the Oracle Traffic Director administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:<ul><li>Tab</li><li>Brackets</li><li>Parentheses</li><li>The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).</li></ul><p>If a username is not explicitly set, the OTD user name defaults to the WebLogic Server (WLS) administrator user name."
},
"haEnabled":{
"type":"boolean",
"description":"Flag that specifies whether HA is enabled on the user-managed load balancer. This value defaults to <code>false</code> (that is, HA is not enabled)."
},
"ipReservations":{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to user-managed load balancer nodes.<p>A single IP reservation name or two names separated by a comma.<p>The number of names in <code>ipReservations</code> must match the number of load balancer nodes you are provisioning.<p>Note the difference between accounts where regions are supported and not supported.<ul><li>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: If you are using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
},
"listenerPort":{
"type":"integer",
"description":"Listener port for the user-managed load balancer for accessing deployed applications using HTTP. The default value is <code>8080</code>.<p>This value is overridden by <code>privilegedListenerPort</code> unless its value is set to 0. This value has no effect if the load balancer is disabled."
},
"listenerPortEnabled":{
"type":"boolean",
"description":"Flag that specifies whether the non-secure listener port is enabled on the user-managed load balancer. The default value is <code>true</code>."
},
"loadBalancingPolicy":{
"type":"string",
"description":"Policy to use for routing requests to the user-managed balancer. Valid policies include: <ul><li><code>LEAST_CONNECTION_COUNT</code> - Passes each new request to the Managed Server with the least number of connections. This policy is useful for smoothing distribution when Managed Servers get bogged down. Managed Servers with greater processing power to handle requests will receive more connections over time. This is the default.</li><li><code>LEAST_RESPONSE_TIME</code> - Passes each new request to the Managed Server with the fastest response time. This policy is useful when Managed Servers are distributed across networks.</li><li><code>ROUND_ROBIN</code> - Passes each new request to the next Managed Server in line, evenly distributing requests across all Managed Servers regardless of the number of connections or response time.</li></ul>"
},
"privilegedListenerPort":{
"type":"integer",
"description":"Privileged listener port for accessing the deployed applications using HTTP. The default value is <code>80</code>.<p>This value has no effect if the user-managed load balancer is disabled.<p>To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to <code>listenerPort</code>, if specified, or <code>8080</code>."
},
"privilegedSecuredListenerPort":{
"type":"integer",
"description":"Privileged listener port for accessing the deployed applications using HTTPS. The default value is <code>443</code>.<p>This value has no effect if the user-managed load balancer is disabled.<p>To disable the privileged listener port, set the value to 0. In this case, if the user-managed load balancer is provisioned, the listener port defaults to <code>securedListenerPort</code>, if specified, or <code>8081</code>."
},
"securedListenerPort":{
"type":"integer",
"description":"Secured listener port for accessing the deployed applications using HTTPS. The default value is <code>8081</code>.<p>This value is overridden by <code>privilegedSecuredContentPort</code> unless its value is set to 0. This value has no effect if the user-managed load balancer is disabled."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the local balancer nodes. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
}
}
}
Nested Schema : WLS
Type: object
Properties for the Oracle WebLogic Server (WLS) component.
Show Source
-
adminPassword:
string
Password for the WebLogic Server administrator. The password must meet the following requirements:
- Starts with a letter
- Is between 8 and 30 characters long
- Has at least one number
- Has one or more of the following special characters: underscore (_), pound sign (#), dollar sign ($).
If you are using an Oracle Database Exadata Cloud Service database deployment in dbServiceName
, note that the password cannot contain the dollar sign ($) but it can contain the hyphen (-). In addition, there must be 1 uppercase character and 1 lowercase character.
-
adminPort(optional):
integer
Port for accessing WebLogic Server using HTTP. The default value is
7001
.
Note that the adminPort
, contentPort
, securedAdminPort
, securedContentPort
, and nodeManagerPort
values must be unique.
-
adminUserName:
string
User name for the WebLogic Server administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:
- Tab
- Brackets
- Parentheses
- The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).
-
appDBs(optional):
array appDBs
Groups details of database deployments that host application schemas, if any are used.
Applicable only if you provision a service instance with the associated infrastructure schema database on Oracle Database Cloud Service (Classic).
-
atpDBLevel:
string
This optional attribute is applicable only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.
Level of performance and concurrency for Autonomous Transaction Processing.
Possible values are:
high
- (Do not use if the CPU Core count is greater than 1) Provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.medium
- (Do not use if the CPU Core count is greater than 1) Provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.low
- (Default) Provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.tp
- Provides a typical application connection service for transaction processing operations. This connection service does not run with parallelism.tpurgent
- Provides the highest priority application connection service for time critical transaction processing operations. This connection service supports manual parallelism.
-
atpDBName:
string
This attribute is required only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.
Name of the infrastructure schema database deployment.
See also atpDBLevel
.
Other database restrictions may apply. See the following:
-
backupVolumeSize(optional):
string
Size of the backup volume for the service. The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: nG, where n specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: 100000000000
or 10G
. This value defaults to the system configured volume size.
-
clusterName(optional):
string
This attribute is ignored if
clusters
array is used.
Name of the WebLogic Server application cluster that contains the Managed Servers for running the service applications.
The cluster name:
- Must not exceed 50 characters.
- Must start with a letter.
- Must contain only alphabetical characters, underscores (_), or dashes (-).
- Must not contain any other special characters.
- Must be unique within the identity domain.
If no value is specified, the name of the cluster will be generated from the first eight characters of the Oracle Java Cloud Service instance name (specified in
serviceName
), using the following format:
first8charsOfServiceInstanceName_cluster
Note: If you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system) using Oracle Real Application Clusters (RAC) technology, specify a cluster name. Doing so ensures the DB cluster service is started for the RAC DB.
-
clusters(optional):
array clusters
Groups properties for one or more clusters.
This attribute is optional for the WebLogic Server application cluster. You must, however, use the clusters
array if you want to define a caching (data grid) cluster for the service instance.
-
connectString:
string
Connection string for the infrastructure schema database.
On Oracle Cloud Infrastructure: This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system).
The connection string is a concatenation of the Hostname Prefix and Host Domain Name.
For a virtual machine (VM) or Exadata DB system, note that -scan
must be appended to the Hostname Prefix.
For a bare metal DB system, you do not have to append -scan
.
To construct the connection string, find the values of Hostname Prefix and Host Domain Name on the Oracle Cloud Infrastructure console. Select Bare Metal, VM, and Exadata (under Database), select the compartment, and click the DB system name you want to use.
The connection string must be entered in one of these formats (depending on the DB system type):
//hostname-scan.networkdomain:1521/pdbname.networkdomain
//hostname.networkdomain:1521/pdbname.networkdomain
Where:
VM or Exadata DB system 12c or later examples: (-scan
appended to the Hostname Prefix)
//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com
//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com
Bare metal DB system 12c or later examples: (-scan
is not appended to the Hostname Prefix)
//mydb1.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com
//mydb1.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com
Other database restrictions may apply. See the following:
On Oracle Cloud Infrastructure Classic: This attribute is required if you specify a BASIC service level of Database Cloud Service in dbServiceName
. It is used to connect to the database deployment on Database Cloud Service - Virtual Image.
The connection string must be entered using one of the following formats:
host:port:SID
host:port/serviceName
For example:
example.com:1521:orcl
or example.com:1521/mydbservice
-
contentPort(optional):
integer
Port for accessing the deployed applications using HTTP. The default value is 8001.
This value is overridden by privilegedContentPort
unless its value is set to 0.
If a load balancer is configured and enabled, this value has no effect.
Note that the adminPort
, contentPort
, securedAdminPort
, securedContentPort
, and nodeManagerPort
values must be unique.
-
dbaName:
string
User name for the database administrator.
This value must not be SYSTEM
. Specify a database user that has been granted the SYSDBA
privilege. For service instances based on Oracle WebLogic Server 12c (any version), you can use the database user SYS
.
On Oracle Cloud Infrastructure: This value is always ADMIN
if using an infrastructure schema database that is deployed on Oracle Autonomous Transaction Processing.
-
dbaPassword:
string
Password for the database administrator that was specified when the infrastructure schema database was created.
-
dbServiceName:
string
Name of the infrastructure schema database deployment on Oracle Database Cloud Service (Classic) or Oracle Database Exadata Cloud Service.
On Oracle Cloud Infrastructure: This attribute is required only if you are using Oracle Database Cloud Service (Classic) for the infrastructure schema database. See atpDBName
and connectString
if you are not using Oracle Database Cloud Service (Classic).
On Oracle Cloud Infrastructure Classic: This attribute is required.
Other database restrictions may apply. See the following:
-
deploymentChannelPort(optional):
integer
Port for accessing the WebLogic Administration Server using WLST. The default value is 9001
.
-
domainMode(optional):
string
Mode of the domain. Valid values include: DEVELOPMENT
and PRODUCTION
. The default value is PRODUCTION
.
-
domainName(optional):
string
Name of the WebLogic domain. By default, the domain name will be generated from the first eight characters of the Oracle Java Cloud Service instance name (
serviceName
), using the following format:
first8charsOfServiceInstanceName_domain
By default, the Managed Server names will be generated from the first eight characters of the domain name name (domainName
), using the following format: first8charsOfDomainName_server_n
, where n starts with 1 and is incremented by 1 for each additional Managed Server to ensure each name is unique.
-
domainPartitionCount(optional):
integer
Number of partitions to enable in the domain for WebLogic Server 12.2.1. Valid values include:
0
(no partitions),
1
,
2
, and
4
.
Must be 0
if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product (WCP
or ODI
).
-
domainVolumeSize(optional):
string
Size of the domain volume for the service. The value must be a multiple of GBs.
You can specify this value in bytes or GBs. If specified in GBs, use the following format: nG, where n specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: 100000000000
or 10G
.
This value defaults to the system configured volume size.
-
ipReservations(optional):
array ipReservations
This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
Reserved or pre-allocated IP addresses can be assigned to Managed Server nodes in a WebLogic Server application cluster.
A single IP reservation name or a list of multiple IP reservation names separated by commas.
If using reserved IPs, all nodes in the cluster must be provisioned with pre-allocated IP addresses. In other words, the number of names in ipReservations
must match the number of servers you are provisioning (using managedServerCount
or serverCount
in clusters
array).
Note the difference between accounts where regions are supported and not supported.
Where regions are supported: A region
name must be specified in order to use ipReservations
. If ipNetwork
is also specified, then assignPublicIP
must be true
to use ipReservations
.
Only those reserved IPs created in the specified region can be used.
See IP Reservations REST Endpoints for information about how to find unused IP reservations and, if needed, create new IP reservations.
- Where regions are not supported: When using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a
region
name is not required in order to use ipReservations
. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service (MOS Note 2163568.1).
-
isOciRacDb(optional):
boolean
This attribute is applicable only to provisioning on Oracle Cloud Infrastructure.
This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on an Oracle Cloud Infrastructure Database system that uses Oracle Real Application Clusters (RAC) technology.
Default is false
. Set to true
if the database system is a RAC database. See also ociRacDBName
.
Other database restrictions may apply. See the following:
-
managedServerCount(optional):
integer
Number of Managed Servers in the WebLogic Server application cluster. This attribute is ignored if
clusters
array is used.
Valid values include: 1
, 2
, 4
, and 8
. The default value is 1
.
-
msInitialHeapMB(optional):
integer
Initial Java heap size (
-Xms
) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.
If you specify this initial value, a value greater than 0 (zero) must also be specified for msMaxHeapMB
, msMaxPermMB
, and msPermMB
. In addition, msInitialHeapMB
must be less than msMaxHeapMB
, and msPermMB
must be less than msMaxPermMB
.
-
msJvmArgs(optional):
string
One or more Managed Server JVM arguments separated by a space.
You cannot specify any arguments that are related to JVM heap sizes and PermGen spaces (for example, -Xms
, -Xmx
, -XX:PermSize
, and -XX:MaxPermSize
).
A typical use case would be to set Java system properties using -Dname=value
(for example, -Dmyproject.debugDir=/var/myproject/log
).
You can overwrite or append the default JVM arguments, which are used to start Managed Server processes. See overwriteMsJvmArgs
for information on how to overwrite or append the server start arguments.
-
msMaxHeapMB(optional):
integer
Maximum Java heap size (
-Xmx
) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.
If you specify this maximum value, a value greater than 0 (zero) must also be specified for msInitialHeapMB
, msMaxPermMB
, and msPermMB
. In addition, msInitialHeapMB
must be less than msMaxHeapMB
, and msPermMB
must be less than msMaxPermMB
.
-
msMaxPermMB(optional):
integer
Maximum Permanent Generation (PermGen) space in Java heap memory (
-XX:MaxPermSize
) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.
Not applicable for a WebLogic Server 12.2.1 instance, which uses JDK 8.
If you specify this maximum value, a value greater than 0 (zero) must also be specified for msInitialHeapMB
, msMaxHeapMB
, and msPermMB
. In addition, msInitialHeapMB
must be less than msMaxHeapMB
, and msPermMB
must be less than msMaxPermMB
.
-
msPermMB(optional):
integer
Initial Permanent Generation (PermGen) space in Java heap memory (
-XX:PermSize
) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.
Not applicable for a WebLogic Server 12.2.1 instance which uses JDK 8.
If you specify this initial value, a value greater than 0 (zero) must also be specified for msInitialHeapMB
, msMaxHeapMB
, and msMaxPermMB
. In addition, msInitialHeapMB
must be less than msMaxHeapMB
, and msPermMB
must be less than msMaxPermMB
.
-
mwVolumeSize(optional):
string
Size of the MW_HOME
disk volume for the service (/u01/app/oracle/middleware
). The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: nG, where n specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: 100000000000
or 10G
. This value defaults to the system configured volume size.
-
nodeManagerPassword(optional):
string
Password for the Node Manager. This value defaults to the WebLogic Server administrator password (adminPassword
) if no value is supplied.
-
nodeManagerPort(optional):
integer
Port for the Node Manager. The default value is
5556
.
Node Manager is a WebLogic Server utility that enables you to start, shut down, and restart Administration Server and Managed Server instances from a remote location.
The adminPort
, contentPort
, securedAdminPort
, securedContentPort
, and nodeManagerPort
values must be unique.
-
nodeManagerUserName(optional):
string
User name for the Node Manager. This value defaults to the WebLogic Server administrator user name (adminUserName
) if no value is supplied.
-
ociRacDBName(optional):
string
This attribute is applicable only to provisioning Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
This attribute is required if isOciRacDb
is set to true
during provisioning.
The DB name of the associated infrastructure schema database that uses Oracle Real Application Clusters (RAC) technology.
Other database restrictions may apply. See the following:
-
overwriteMsJvmArgs(optional):
boolean
Flag that determines whether the user defined Managed Server JVM arguments specified in
msJvmArgs
should replace the server start arguments (
true
), or append the server start arguments (
false
). Default is
false
.
The server start arguments are calculated automatically by Oracle Java Cloud Service from site default values.
If you append (that is, overwriteMsJvmArgs
is false
or is not set), the user defined arguments specified in msJvmArgs
are added to the end of the server start arguments. If you overwrite (that is, set overwriteMsJvmArgs
to true
), the calculated server start arguments are replaced.
-
pdbServiceName(optional):
string
Name of the pluggable database for Oracle Database 12
c. If not specified, the pluggable database name that was configured when the database was created will be used.
Note: This value does not apply to Oracle Database 11g.
-
privilegedContentPort(optional):
integer
Privileged content port for accessing the deployed applications using HTTP. The default value is
80
.
If a load balancer is configured and enabled, this value has no effect.
To disable the privileged content port, set the value to 0. In this case, if a load balancer is not provisioned, the content port defaults to contentPort
, if specified, or 8001
.
-
privilegedSecuredContentPort(optional):
integer
Privileged content port for accessing the deployed applications using HTTPS. The default value is
443
.
If a load balancer is configured and enabled, this value has no effect.
To disable the privileged listener port, set the value to 0. In this case, if a load balancer is not provisioned, this value defaults to securedContentPort
, if specified, or 8002
.
-
sampleAppDeploymentRequested(optional):
boolean
-
securedAdminPort(optional):
integer
Port for accessing the WebLogic Administration Server using HTTPS. The default value is
7002
.
The adminPort
, contentPort
, securedAdminPort
, securedContentPort
, and nodeManagerPort
values must be unique.
-
securedContentPort(optional):
integer
Port for accessing the WebLogic Administration Server using HTTPS. The default value is
8002
.
This value is overridden by privilegedSecuredContentPort
unless its value is set to 0
.
If a load balancer is configured and enabled, this value has no effect.
The adminPort
, contentPort
, securedAdminPort
, securedContentPort
, and nodeManagerPort
values must be unique.
-
shape:
string
Desired compute shape for the nodes in the cluster. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).
On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported.
You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs.
Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.
See Compute Shapes in the Oracle Cloud Infrastructure documentation.
On Oracle Cloud Infrastructure Classic, valid shapes include:
- oc3: 1 OCPU, 7.5 GB memory
- oc4: 2 OCPUs, 15 GB memory
- oc5: 4 OCPUs, 30 GB memory
- oc6: 8 OCPUs, 60 GB memory
- oc7: 16 OCPUs, 120 GB memory
- oc8: 24 OCPUs, 180 GB memory
- oc9: 32 OCPUs, 240 GB memory
- oc1m: 1 OCPU, 15 GB memory
- oc2m: 2 OCPUs, 30 GB memory
- oc3m: 4 OCPUs, 60 GB memory
- oc4m: 8 OCPUs, 120 GB memory
- oc5m: 16 OCPUs, 240 GB memory
- oc8m: 24 OCPUs, 360 GB memory)
- oc9m: 32 OCPUs, 480 GB memory
Note: Some shapes might not be available in a region.
-
upperStackProductName(optional):
string
This attribute is not applicable if using an Oracle Autonomous Transaction Processing database to host the associated infrastructure schema.
This attribute is required only if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product.
The Oracle Fusion Middleware product installer to add to this Oracle Java Cloud Service instance. Valid values are:
ODI
- Oracle Data IntegratorWCP
- Oracle WebCenter Portal
To use upperStackProductName
, you must specify:
12cRelease214
as the WebLogic Server software serviceVersion
when provisioning on Oracle Cloud Infrastructure and Oracle Cloud Infrastructure ClassicEE
or SUITE
as the edition
PAAS
as the serviceLevel
0
as the domainPartitionCount
After the service instance is provisioned, the specified Fusion Middleware product installer is available in /u01/zips/upperstack
on the Administration Server virtual machine. To install the product over the provisioned domain, follow the instructions provided by the Oracle product's installation and configuration documentation.
Note: Patching is not supported for Oracle Java Cloud Service instances if you have installed any product that modifies MW_HOME
(such as Oracle WebCenter Portal and Oracle Data Integrator). Patching is also not supported if you are reusing a license via the Bring Your Own License (BYOL) entitlement (for any product that modifies MW_HOME
). Because patching replaces the contents of MW_HOME
, patching prechecks flag this condition and patching fails.
{
"type":"object",
"description":"Properties for the Oracle WebLogic Server (WLS) component.",
"properties":{
"adminPort":{
"type":"integer",
"description":"Port for accessing WebLogic Server using HTTP. The default value is <code>7001</code>.<p>Note that the <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"adminPassword":{
"type":"string",
"description":"Password for the WebLogic Server administrator. The password must meet the following requirements:<ul><li>Starts with a letter</li><li>Is between 8 and 30 characters long</li><li>Has at least one number</li><li>Has one or more of the following special characters: underscore (_), pound sign (#), dollar sign ($).</li></ul><p>If you are using an Oracle Database Exadata Cloud Service database deployment in <code>dbServiceName</code>, note that the password cannot contain the dollar sign ($) but it can contain the hyphen (-). In addition, there must be 1 uppercase character and 1 lowercase character."
},
"adminUserName":{
"type":"string",
"description":"User name for the WebLogic Server administrator. The name must be between 8 and 128 characters long and cannot contain any of the following characters:<ul><li>Tab</li><li>Brackets</li><li>Parentheses</li><li>The following special characters: left angle bracket (<), right angle bracket (>), ampersand (&), pound sign (#), pipe symbol (|), and question mark (?).</li></ul>"
},
"appDBs":{
"type":"array",
"description":"Groups details of database deployments that host application schemas, if any are used.<p>Applicable only if you provision a service instance with the associated infrastructure schema database on Oracle Database Cloud Service (Classic).",
"items":{
"$ref":"#/definitions/appDBsm"
}
},
"atpDBName":{
"type":"string",
"description":"This attribute is required only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.<p>Name of the infrastructure schema database deployment.<p>See also <code>atpDBLevel</code>.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"atpDBLevel":{
"type":"string",
"description":"This optional attribute is applicable only if you provision an Oracle Java Cloud Service instance on Oracle Cloud Infrastructure with the associated infrastructure schema database deployed on Oracle Autonomous Transaction Processing.<p>Level of performance and concurrency for Autonomous Transaction Processing.<p>Possible values are:<ul><li><code>high</code> - (Do not use if the CPU Core count is greater than 1) Provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.</li><li><code>medium</code> - (Do not use if the CPU Core count is greater than 1) Provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.</li><li><code>low</code> - (Default) Provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.</li><li><code>tp</code> - Provides a typical application connection service for transaction processing operations. This connection service does not run with parallelism.</li><li><code>tpurgent</code> - Provides the highest priority application connection service for time critical transaction processing operations. This connection service supports manual parallelism.</li></ul>"
},
"backupVolumeSize":{
"type":"string",
"description":"Size of the backup volume for the service. The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. This value defaults to the system configured volume size."
},
"clusterName":{
"type":"string",
"description":"This attribute is ignored if <code>clusters</code> array is used.<p>Name of the WebLogic Server application cluster that contains the Managed Servers for running the service applications.<p>The cluster name: <ul><li>Must not exceed 50 characters.</li><li>Must start with a letter.</li><li>Must contain only alphabetical characters, underscores (_), or dashes (-).</li><li>Must not contain any other special characters.</li><li>Must be unique within the identity domain.</li></ul>If no value is specified, the name of the cluster will be generated from the first eight characters of the Oracle Java Cloud Service instance name (specified in <code>serviceName</code>), using the following format: <code><i>first8charsOfServiceInstanceName</i>_cluster</code><p><b>Note</b>: If you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system) using Oracle Real Application Clusters (RAC) technology, specify a cluster name. Doing so ensures the DB cluster service is started for the RAC DB."
},
"clusters":{
"type":"array",
"description":"Groups properties for one or more clusters. <p>This attribute is optional for the WebLogic Server application cluster. You must, however, use the <code>clusters</code> array if you want to define a caching (data grid) cluster for the service instance.",
"items":{
"$ref":"#/definitions/clusters-array"
}
},
"connectString":{
"type":"string",
"description":"Connection string for the infrastructure schema database.<p>On <b>Oracle Cloud Infrastructure</b>: This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on Oracle Cloud Infrastructure Database (DB system).<p>The connection string is a concatenation of the Hostname Prefix and Host Domain Name.<p>For a virtual machine (VM) or Exadata DB system, note that <code>-scan</code> must be appended to the Hostname Prefix.<p>For a bare metal DB system, you do not have to append <code>-scan</code>.<p>To construct the connection string, find the values of <b>Hostname Prefix</b> and <b>Host Domain Name</b> on the Oracle Cloud Infrastructure console. Select <b>Bare Metal, VM, and Exadata</b> (under <b>Database</b>), select the compartment, and click the DB system name you want to use.<p>The connection string must be entered in one of these formats (depending on the DB system type):<ul><li><code>//<i>hostname</i>-scan.<i>networkdomain</i>:1521/<i>pdbname</i>.<i>networkdomain</i></code></li><li><code>//<i>hostname</i>.<i>networkdomain</i>:1521/<i>pdbname</i>.<i>networkdomain</i></code></li></ul><p>Where:<ul><li><i>hostname</i> is the Hostname Prefix. For example: <code>mydb1</code></li><li><i>networkdomain</i> is the Host Domain Name. For example: <code>sub1220.myvcn.oraclevcn.com</code></li><li><i>pdbname</i> is the PDB name you provided when you created the 12c or later DB system. For example: <code>PDB1</code><p>If a PDB name was not specified when you launched the 12c or later DB system, then <i>pdbname</i> is the DB name appended with <code>_PDB1</code>. For example: <code>mydbname_PDB1</code></li></ul><p>VM or Exadata DB system 12c or later examples: (<code>-scan</code> appended to the Hostname Prefix)<p><code>//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com</code><p><code>//mydb1-scan.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com</code><p>Bare metal DB system 12c or later examples: (<code>-scan</code> is not appended to the Hostname Prefix)<p><code>//mydb1.sub1220.myvcn.oraclevcn.com:1521/PDB1.sub1220.myvcn.oraclevcn.com</code><p><code>//mydb1.sub1220.myvcn.oraclevcn.com:1521/mydbname_PDB1.sub1220.myvcn.oraclevcn.com</code><p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>On <b>Oracle Cloud Infrastructure Classic</b>: This attribute is required if you specify a BASIC service level of Database Cloud Service in <code>dbServiceName</code>. It is used to connect to the database deployment on Database Cloud Service - Virtual Image.<p>The connection string must be entered using one of the following formats:<ul><li><code><i>host:port:SID</i></code></li><li><code><i>host:port/serviceName</i></code></li></ul><p>For example:<p><code>example.com:1521:orcl</code> or <code>example.com:1521/mydbservice</code>"
},
"contentPort":{
"type":"integer",
"description":"Port for accessing the deployed applications using HTTP. The default value is 8001.<p>This value is overridden by <code>privilegedContentPort</code> unless its value is set to 0.<p>If a load balancer is configured and enabled, this value has no effect.<p>Note that the <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique. "
},
"dbaName":{
"type":"string",
"description":"User name for the database administrator.<p>This value must <i>not</i> be <code>SYSTEM</code>. Specify a database user that has been granted the <code>SYSDBA</code> privilege. For service instances based on Oracle WebLogic Server 12c (any version), you can use the database user <code>SYS</code>.<p>On <b>Oracle Cloud Infrastructure:</b> This value is always <code>ADMIN</code> if using an infrastructure schema database that is deployed on Oracle Autonomous Transaction Processing."
},
"dbaPassword":{
"type":"string",
"description":"Password for the database administrator that was specified when the infrastructure schema database was created."
},
"dbServiceName":{
"type":"string",
"description":"Name of the infrastructure schema database deployment on Oracle Database Cloud Service (Classic) or Oracle Database Exadata Cloud Service.<p>On <b>Oracle Cloud Infrastructure</b>: This attribute is required only if you are using Oracle Database Cloud Service (Classic) for the infrastructure schema database. See <code>atpDBName</code> and <code>connectString</code> if you are not using Oracle Database Cloud Service (Classic).<p>On <b>Oracle Cloud Infrastructure Classic</b>: This attribute is required.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"deploymentChannelPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using WLST. The default value is <code>9001</code>."
},
"domainMode":{
"type":"string",
"description":"Mode of the domain. Valid values include: <code>DEVELOPMENT</code> and <code>PRODUCTION</code>. The default value is <code>PRODUCTION</code>."
},
"domainName":{
"type":"string",
"description":"Name of the WebLogic domain. By default, the domain name will be generated from the first eight characters of the Oracle Java Cloud Service instance name (<code>serviceName</code>), using the following format: <code><i>first8charsOfServiceInstanceName</i>_domain</code><p>By default, the Managed Server names will be generated from the first eight characters of the domain name name (<code>domainName</code>), using the following format: <code><i>first8charsOfDomainName</i>_server_<i>n</i></code>, where <i>n</i> starts with 1 and is incremented by 1 for each additional Managed Server to ensure each name is unique."
},
"domainPartitionCount":{
"type":"integer",
"description":"Number of partitions to enable in the domain for WebLogic Server 12.2.1. Valid values include: <code>0</code> (no partitions), <code>1</code>, <code>2</code>, and <code>4</code>.<p>Must be <code>0</code> if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product (<code>WCP</code> or <code>ODI</code>)."
},
"domainVolumeSize":{
"type":"string",
"description":"Size of the domain volume for the service. The value must be a multiple of GBs.<p>You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. <p>This value defaults to the system configured volume size."
},
"ipReservations":{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to Managed Server nodes in a WebLogic Server application cluster.<p>A single IP reservation name or a list of multiple IP reservation names separated by commas.<p>If using reserved IPs, all nodes in the cluster must be provisioned with pre-allocated IP addresses. In other words, the number of names in <code>ipReservations</code> must match the number of servers you are provisioning (using <code>managedServerCount</code> or <code>serverCount</code> in <code>clusters</code> array).<p>Note the difference between accounts where regions are supported and not supported.<ul><li><p>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. If <code>ipNetwork</code> is also specified, then <code>assignPublicIP</code> must be <code>true</code> to use <code>ipReservations</code>.<p>Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: When using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
},
"isOciRacDb":{
"type":"boolean",
"description":"This attribute is applicable only to provisioning on Oracle Cloud Infrastructure.<p>This attribute is required if you provision an Oracle Java Cloud Service instance with the associated infrastructure schema database deployed on an Oracle Cloud Infrastructure Database system that uses Oracle Real Application Clusters (RAC) technology.<p>Default is <code>false</code>. Set to <code>true</code> if the database system is a RAC database. See also <code>ociRacDBName</code>.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"ociRacDBName":{
"type":"string",
"description":"This attribute is applicable only to provisioning Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>This attribute is required if <code>isOciRacDb</code> is set to <code>true</code> during provisioning.<p>The DB name of the associated infrastructure schema database that uses Oracle Real Application Clusters (RAC) technology.<p>Other database restrictions may apply. See the following:<ul><li><a href='https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/java-cloud&id=JSCUG-GUID-25AC7709-8CBB-4D25-AC5C-FEA69834A7BC' target='_blank'>Create a Database</a> in <i>Administering Oracle Java Cloud Service</i></li><li><a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-E26D674D-B1C9-482F-84AF-8AF4121CEB05' target='_blank'>Database</a> in the <a href='http://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-FCD2A1F3-A67B-43FF-A5EF-94413C63E511' target='_blank'>Design Considerations for an Oracle Java Cloud Service Instance</a> topic in <i>Administering Oracle Java Cloud Service</i></li><li><a href='https://docs.oracle.com/en/cloud/paas/java-cloud/kjaas/index.html#KJAAS116' target='_blank'>Known Issues for Oracle Java Cloud Service</a></li></ul><p>"
},
"managedServerCount":{
"type":"integer",
"description":"Number of Managed Servers in the WebLogic Server application cluster. This attribute is ignored if <code>clusters</code> array is used. <p>Valid values include: <code>1</code>, <code>2</code>, <code>4</code>, and <code>8</code>. The default value is <code>1</code>."
},
"msInitialHeapMB":{
"type":"integer",
"description":"Initial Java heap size (<code>-Xms</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>If you specify this initial value, a value greater than 0 (zero) must also be specified for <code>msMaxHeapMB</code>, <code>msMaxPermMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msJvmArgs":{
"type":"string",
"description":"One or more Managed Server JVM arguments separated by a space.<p>You cannot specify any arguments that are related to JVM heap sizes and PermGen spaces (for example, <code>-Xms</code>, <code>-Xmx</code>, <code>-XX:PermSize</code>, and <code>-XX:MaxPermSize</code>).<p>A typical use case would be to set Java system properties using <code>-D<em>name</em>=<em>value</em></code> (for example, <code>-Dmyproject.debugDir=/var/myproject/log</code>).<p>You can overwrite or append the default JVM arguments, which are used to start Managed Server processes. See <code>overwriteMsJvmArgs</code> for information on how to overwrite or append the server start arguments."
},
"msMaxHeapMB":{
"type":"integer",
"description":"Maximum Java heap size (<code>-Xmx</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>If you specify this maximum value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxPermMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msMaxPermMB":{
"type":"integer",
"description":"Maximum Permanent Generation (PermGen) space in Java heap memory (<code>-XX:MaxPermSize</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>Not applicable for a WebLogic Server 12.2.1 instance, which uses JDK 8.<p>If you specify this maximum value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxHeapMB</code>, and <code>msPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"msPermMB":{
"type":"integer",
"description":"Initial Permanent Generation (PermGen) space in Java heap memory (<code>-XX:PermSize</code>) for a Managed Server JVM, specified in megabytes. The value must be greater than -1.<p>Not applicable for a WebLogic Server 12.2.1 instance which uses JDK 8.<p>If you specify this initial value, a value greater than 0 (zero) must also be specified for <code>msInitialHeapMB</code>, <code>msMaxHeapMB</code>, and <code>msMaxPermMB</code>. In addition, <code>msInitialHeapMB</code> must be less than <code>msMaxHeapMB</code>, and <code>msPermMB</code> must be less than <code>msMaxPermMB</code>."
},
"mwVolumeSize":{
"type":"string",
"description":"Size of the <code>MW_HOME</code> disk volume for the service (<code>/u01/app/oracle/middleware</code>). The value must be a multiple of GBs. You can specify this value in bytes or GBs. If specified in GBs, use the following format: <i>n</i>G, where <i>n</i> specifies the number of GBs. For example, you can express 10 GBs as bytes or GBs. For example: <code>100000000000</code> or <code>10G</code>. This value defaults to the system configured volume size."
},
"nodeManagerPort":{
"type":"integer",
"description":"Port for the Node Manager. The default value is <code>5556</code>.<p>Node Manager is a WebLogic Server utility that enables you to start, shut down, and restart Administration Server and Managed Server instances from a remote location.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"nodeManagerPassword":{
"type":"string",
"description":"Password for the Node Manager. This value defaults to the WebLogic Server administrator password (<code>adminPassword</code>) if no value is supplied."
},
"nodeManagerUserName":{
"type":"string",
"description":"User name for the Node Manager. This value defaults to the WebLogic Server administrator user name (<code>adminUserName</code>) if no value is supplied."
},
"overwriteMsJvmArgs":{
"type":"boolean",
"description":"Flag that determines whether the user defined Managed Server JVM arguments specified in <code>msJvmArgs</code> should replace the server start arguments (<code>true</code>), or append the server start arguments (<code>false</code>). Default is <code>false</code>.<p>The server start arguments are calculated automatically by Oracle Java Cloud Service from site default values.<p>If you append (that is, <code>overwriteMsJvmArgs</code> is <code>false</code> or is not set), the user defined arguments specified in <code>msJvmArgs</code> are added to the end of the server start arguments. If you overwrite (that is, set <code>overwriteMsJvmArgs</code> to <code>true</code>), the calculated server start arguments are replaced."
},
"pdbServiceName":{
"type":"string",
"description":"Name of the pluggable database for Oracle Database 12<i>c</i>. If not specified, the pluggable database name that was configured when the database was created will be used.<p><b>Note:</b> This value does not apply to Oracle Database 11<i>g</i>."
},
"privilegedContentPort":{
"type":"integer",
"description":"Privileged content port for accessing the deployed applications using HTTP. The default value is <code>80</code>.<p>If a load balancer is configured and enabled, this value has no effect.<p>To disable the privileged content port, set the value to 0. In this case, if a load balancer is not provisioned, the content port defaults to <code>contentPort</code>, if specified, or <code>8001</code>."
},
"privilegedSecuredContentPort":{
"type":"integer",
"description":"Privileged content port for accessing the deployed applications using HTTPS. The default value is <code>443</code>.<p>If a load balancer is configured and enabled, this value has no effect.<p>To disable the privileged listener port, set the value to 0. In this case, if a load balancer is not provisioned, this value defaults to <code>securedContentPort</code>, if specified, or <code>8002</code>."
},
"sampleAppDeploymentRequested":{
"type":"boolean",
"description":"Flag that specifies whether to automatically deploy and start the sample application, <code>sample-app.war</code>, to the default Managed Server in your service instance. The default value is <code>false</code>.See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=JSCUG-GUID-35722F36-98FE-4685-98EC-606A4C5F7DCA' target='_blank'>About the Sample Application Deployed to an Oracle Java Cloud Service Instance</a> in <i>Administering Oracle Java Cloud Service</i>."
},
"securedAdminPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using HTTPS. The default value is <code>7002</code>.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"securedContentPort":{
"type":"integer",
"description":"Port for accessing the WebLogic Administration Server using HTTPS. The default value is <code>8002</code>.<p>This value is overridden by <code>privilegedSecuredContentPort</code> unless its value is set to <code>0</code>. <p>If a load balancer is configured and enabled, this value has no effect.<p>The <code>adminPort</code>, <code>contentPort</code>, <code>securedAdminPort</code>, <code>securedContentPort</code>, and <code>nodeManagerPort</code> values must be unique."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the nodes in the cluster. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory)</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
},
"upperStackProductName":{
"type":"string",
"description":"This attribute is not applicable if using an Oracle Autonomous Transaction Processing database to host the associated infrastructure schema.<p>This attribute is required only if you are provisioning an Oracle Java Cloud Service instance for an Oracle Fusion Middleware product.<p>The Oracle Fusion Middleware product installer to add to this Oracle Java Cloud Service instance. Valid values are: <ul><li><code>ODI</code> - Oracle Data Integrator</li><li><code>WCP</code> - Oracle WebCenter Portal</li></ul><p>To use <code>upperStackProductName</code>, you must specify:<ul><li><code>12cRelease214</code> as the WebLogic Server software <code>serviceVersion</code> when provisioning on Oracle Cloud Infrastructure and Oracle Cloud Infrastructure Classic</li><li><code>EE</code> or <code>SUITE</code> as the <code>edition</code></li><li><code>PAAS</code> as the <code>serviceLevel</code></li><li><code>0</code> as the <code>domainPartitionCount</code></li></ul><p>After the service instance is provisioned, the specified Fusion Middleware product installer is available in <code>/u01/zips/upperstack</code> on the Administration Server virtual machine. To install the product over the provisioned domain, follow the instructions provided by the Oracle product's installation and configuration documentation.<p>Note: Patching is not supported for Oracle Java Cloud Service instances if you have installed any product that modifies <code>MW_HOME</code> (such as Oracle WebCenter Portal and Oracle Data Integrator). Patching is also not supported if you are reusing a license via the Bring Your Own License (BYOL) entitlement (for any product that modifies <code>MW_HOME</code>). Because patching replaces the contents of <code>MW_HOME</code>, patching prechecks flag this condition and patching fails."
}
},
"required":[
"adminPassword",
"adminUserName",
"atpDBName",
"atpDBLevel",
"connectString",
"dbaName",
"dbaPassword",
"dbServiceName",
"shape"
]
}
Nested Schema : ipReservations
Type: array
This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
Reserved or pre-allocated IP addresses can be assigned to user-managed load balancer nodes.
A single IP reservation name or two names separated by a comma.
The number of names in ipReservations
must match the number of load balancer nodes you are provisioning.
Note the difference between accounts where regions are supported and not supported.
Show Source
{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to user-managed load balancer nodes.<p>A single IP reservation name or two names separated by a comma.<p>The number of names in <code>ipReservations</code> must match the number of load balancer nodes you are provisioning.<p>Note the difference between accounts where regions are supported and not supported.<ul><li>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: If you are using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
}
Nested Schema : appDBs
Type: array
Groups details of database deployments that host application schemas, if any are used.
Applicable only if you provision a service instance with the associated infrastructure schema database on Oracle Database Cloud Service (Classic).
Show Source
-
Array of:
object appDBsm
Applicable only when the associated infrastructure schema database type is Oracle Database Cloud Service (Classic).
Details of a database deployment that is used to host application schemas (if used). You can specify up to four application schema database deployments. The application schema databases can be created using Oracle Database 11g Release 2, Oracle Database 12c Release 1, or Oracle Database 12c Release 2.
{
"type":"array",
"description":"Groups details of database deployments that host application schemas, if any are used.<p>Applicable only if you provision a service instance with the associated infrastructure schema database on Oracle Database Cloud Service (Classic).",
"items":{
"$ref":"#/definitions/appDBsm"
}
}
Nested Schema : clusters
Type: array
Groups properties for one or more clusters.
This attribute is optional for the WebLogic Server application cluster. You must, however, use the clusters
array if you want to define a caching (data grid) cluster for the service instance.
Show Source
-
Array of:
object clusters-array
Properties for WebLogic Server clusters.
One to eight application clusters can be specified.
Only one caching (data grid) cluster can be specified. You must use the clusters
array if you want to include a caching (data grid) cluster for the service instance.
{
"type":"array",
"description":"Groups properties for one or more clusters. <p>This attribute is optional for the WebLogic Server application cluster. You must, however, use the <code>clusters</code> array if you want to define a caching (data grid) cluster for the service instance.",
"items":{
"$ref":"#/definitions/clusters-array"
}
}
Nested Schema : ipReservations
Type: array
This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.
Reserved or pre-allocated IP addresses can be assigned to Managed Server nodes in a WebLogic Server application cluster.
A single IP reservation name or a list of multiple IP reservation names separated by commas.
If using reserved IPs, all nodes in the cluster must be provisioned with pre-allocated IP addresses. In other words, the number of names in ipReservations
must match the number of servers you are provisioning (using managedServerCount
or serverCount
in clusters
array).
Note the difference between accounts where regions are supported and not supported.
Where regions are supported: A region
name must be specified in order to use ipReservations
. If ipNetwork
is also specified, then assignPublicIP
must be true
to use ipReservations
.
Only those reserved IPs created in the specified region can be used.
See IP Reservations REST Endpoints for information about how to find unused IP reservations and, if needed, create new IP reservations.
- Where regions are not supported: When using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a
region
name is not required in order to use ipReservations
. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service (MOS Note 2163568.1).
Show Source
{
"type":"array",
"description":"This attribute is not applicable to Oracle Java Cloud Service instances on Oracle Cloud Infrastructure.<p>Reserved or pre-allocated IP addresses can be assigned to Managed Server nodes in a WebLogic Server application cluster.<p>A single IP reservation name or a list of multiple IP reservation names separated by commas.<p>If using reserved IPs, all nodes in the cluster must be provisioned with pre-allocated IP addresses. In other words, the number of names in <code>ipReservations</code> must match the number of servers you are provisioning (using <code>managedServerCount</code> or <code>serverCount</code> in <code>clusters</code> array).<p>Note the difference between accounts where regions are supported and not supported.<ul><li><p>Where regions are supported: A <code>region</code> name must be specified in order to use <code>ipReservations</code>. If <code>ipNetwork</code> is also specified, then <code>assignPublicIP</code> must be <code>true</code> to use <code>ipReservations</code>.<p>Only those reserved IPs created in the specified region can be used. <p>See <a href='http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=jcs_rest_ipreserves'>IP Reservations REST Endpoints</a> for information about how to find unused IP reservations and, if needed, create new IP reservations.</li><li>Where regions are not supported: When using an Oracle Database Exadata Cloud Service database deployment with your Oracle Java Cloud Service instance in an account where regions are not enabled, a <code>region</code> name is not required in order to use <code>ipReservations</code>. However, you must first submit a request to get the IP reservations. See the My Oracle Support document titled <i>How to Request Authorized IPs for Provisioning a Java Cloud Service with Database Exadata Cloud Service</i> (MOS Note 2163568.1).</li></ul>",
"items":{
"type":"string"
}
}
Nested Schema : appDBsm
Type: object
Applicable only when the associated infrastructure schema database type is Oracle Database Cloud Service (Classic).
Details of a database deployment that is used to host application schemas (if used). You can specify up to four application schema database deployments. The application schema databases can be created using Oracle Database 11g Release 2, Oracle Database 12c Release 1, or Oracle Database 12c Release 2.
Show Source
-
dbaName:
string
User name for the database administrator.
This value must not be SYSTEM
. Specify a database user that has been granted the SYSDBA
privilege. For service instances based on Oracle WebLogic Server 12c (any version), you can use the database user SYS
.
-
dbaPassword:
string
Database administrator password that was specified when the database deployment was created.
-
dbServiceName:
string
Name of the database deployment to use. The specified database deployment must be running.
The same database deployment can be used for multiple appDBs
associations. The same database deployment can be used for both the required infrastructure schema database and optional application schema databases.
-
pdbServiceName(optional):
string
Name of the pluggable database for Oracle Database 12
c. If not specified, the pluggable database name configured when the database was created will be used.
Note: This value does not apply to Oracle Database 11g.
{
"description":"Applicable only when the associated infrastructure schema database type is Oracle Database Cloud Service (Classic).<p>Details of a database deployment that is used to host application schemas (if used). You can specify up to four application schema database deployments. The application schema databases can be created using Oracle Database 11<i>g</i> Release 2, Oracle Database 12<i>c</i> Release 1, or Oracle Database 12<i>c</i> Release 2.",
"properties":{
"dbaName":{
"type":"string",
"description":"User name for the database administrator.<p>This value must <i>not</i> be <code>SYSTEM</code>. Specify a database user that has been granted the <code>SYSDBA</code> privilege. For service instances based on Oracle WebLogic Server 12c (any version), you can use the database user <code>SYS</code>."
},
"dbaPassword":{
"type":"string",
"description":"Database administrator password that was specified when the database deployment was created."
},
"dbServiceName":{
"type":"string",
"description":"Name of the database deployment to use. The specified database deployment must be running.<p>The same database deployment can be used for multiple <code>appDBs</code> associations. The same database deployment can be used for both the required infrastructure schema database and optional application schema databases. "
},
"pdbServiceName":{
"type":"string",
"description":"Name of the pluggable database for Oracle Database 12<i>c</i>. If not specified, the pluggable database name configured when the database was created will be used.<p><b>Note:</b> This value does not apply to Oracle Database 11<i>g</i>."
}
},
"required":[
"dbaName",
"dbaPassword",
"dbServiceName"
]
}
Nested Schema : clusters-array
Type: object
Properties for WebLogic Server clusters.
One to eight application clusters can be specified.
Only one caching (data grid) cluster can be specified. You must use the clusters
array if you want to include a caching (data grid) cluster for the service instance.
Show Source
-
clusterName(optional):
string
Name of the cluster to create.
The cluster name:
- Must not exceed 50 characters.
- Must start with a letter.
- Must contain only alphabetical characters, underscores (_), or dashes (-).
- Must not contain any other special characters.
- Must be unique within the identity domain.
-
pathPrefixes(optional):
array pathPrefixes
A single path prefix or multiple path prefixes separated by commas. A path prefix must be unique across clusters in the domain.
This attribute is only applicable to service instances where an Oracle-managed load balancer is configured. It is also only applicable to a cluster of type APPLICATION_CLUSTER
.
When path prefixes are specified, this means the load balancer can route to only those applications that have the context root matching one of the path prefixes.
For example, if you specified the following path prefixes:
["/myapp1", "/myapp2"]
...then the load balancer can route to only those applications that have the context root matching these:
/myapp1
/myapp1/*
/myapp2
/myapp2/*
-
serverCount(optional):
integer
Number of servers to create in this cluster.
- For
APPLICATION_CLUSTER
- Valid values include: 1
, 2
, 4
, and 8
. The default value is 1
. - For
CACHING_CLUSTER
- Use a number from 1 to 32 only. The default value is 1
.The serverCount
limit is based on the VM (cluster size) limit of four and the serversPerNode
limit of eight.
Note: The actual server number is rounded up to fill the number of nodes required to create the caching cluster. For example, if serversPerNode
is four and serverCount
is three, the actual number of servers that will be created is four.
-
serversPerNode(optional):
integer
Number of JVMs to start on each VM (node). This attribute is only applicable to cluster type
CACHING_CLUSTER
.
Use a number from 1 to 8 only. The default value is 1
.
-
shape(optional):
string
Desired compute shape for the nodes in this cluster. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM).
This shape attribute is optional. If no shape value is specified here, the shape is inherited from the WLS
component level shape
.
On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported.
You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs.
Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.
See Compute Shapes in the Oracle Cloud Infrastructure documentation.
On Oracle Cloud Infrastructure Classic, valid shapes include:
- oc3: 1 OCPU, 7.5 GB memory
- oc4: 2 OCPUs, 15 GB memory
- oc5: 4 OCPUs, 30 GB memory
- oc6: 8 OCPUs, 60 GB memory
- oc7: 16 OCPUs, 120 GB memory
- oc8: 24 OCPUs, 180 GB memory
- oc9: 32 OCPUs, 240 GB memory
- oc1m: 1 OCPU, 15 GB memory
- oc2m: 2 OCPUs, 30 GB memory
- oc3m: 4 OCPUs, 60 GB memory
- oc4m: 8 OCPUs, 120 GB memory
- oc5m: 16 OCPUs, 240 GB memory
- oc8m: 24 OCPUs, 360 GB memory
- oc9m: 32 OCPUs, 480 GB memory
Note: Some shapes might not be available in a region.
-
type(optional):
string
Type of cluster to create. Valid values include:
APPLICATION_CLUSTER
- Application cluster (default). This is the WebLogic cluster that will run the service applications, which are accessible via the user-managed load balancer resource (OTD) or the Oracle-managed load balancer.CACHING_CLUSTER
- Caching (data grid) cluster. This is the WebLogic cluster for Coherence storage.
{
"description":"Properties for WebLogic Server clusters.<p>One to eight application clusters can be specified.<p>Only one caching (data grid) cluster can be specified. You must use the <code>clusters</code> array if you want to include a caching (data grid) cluster for the service instance.",
"properties":{
"clusterName":{
"type":"string",
"description":"Name of the cluster to create.<p>The cluster name: <ul><li>Must not exceed 50 characters.</li><li>Must start with a letter.</li><li>Must contain only alphabetical characters, underscores (_), or dashes (-).</li><li>Must not contain any other special characters.</li><li>Must be unique within the identity domain.</li></ul>"
},
"pathPrefixes":{
"type":"array",
"description":"A single path prefix or multiple path prefixes separated by commas. A path prefix must be unique across clusters in the domain.<p>This attribute is only applicable to service instances where an Oracle-managed load balancer is configured. It is also only applicable to a cluster of type <code>APPLICATION_CLUSTER</code>.<p>When path prefixes are specified, this means the load balancer can route to only those applications that have the context root matching one of the path prefixes.<p>For example, if you specified the following path prefixes:<p><code>[\"/myapp1\", \"/myapp2\"]</code><p>...then the load balancer can route to only those applications that have the context root matching these:<ul><li><code>/myapp1</code></li><li><code>/myapp1/*</code></li><li><code>/myapp2</code></li><li><code>/myapp2/*</code></li></ul>",
"items":{
"type":"string"
}
},
"type":{
"type":"string",
"description":"Type of cluster to create. Valid values include:<ul><li><code>APPLICATION_CLUSTER</code> - Application cluster (default). This is the WebLogic cluster that will run the service applications, which are accessible via the user-managed load balancer resource (OTD) or the Oracle-managed load balancer.</li><li><code>CACHING_CLUSTER</code> - Caching (data grid) cluster. This is the WebLogic cluster for Coherence storage.</li></ul>"
},
"serverCount":{
"type":"integer",
"description":"Number of servers to create in this cluster. <ul><li>For <code>APPLICATION_CLUSTER</code> - Valid values include: <code>1</code>, <code>2</code>, <code>4</code>, and <code>8</code>. The default value is <code>1</code>.</li><li>For <code>CACHING_CLUSTER</code> - Use a number from 1 to 32 only. The default value is <code>1</code>.<p>The <code>serverCount</code> limit is based on the VM (cluster size) limit of four and the <code>serversPerNode</code> limit of eight.<p>Note: The actual server number is rounded up to fill the number of nodes required to create the caching cluster. For example, if <code>serversPerNode</code> is four and <code>serverCount</code> is three, the actual number of servers that will be created is four.</li></ul>"
},
"serversPerNode":{
"type":"integer",
"description":"Number of JVMs to start on each VM (node). This attribute is only applicable to cluster type <code>CACHING_CLUSTER</code>. <p>Use a number from 1 to 8 only. The default value is <code>1</code>."
},
"shape":{
"type":"string",
"description":"Desired compute shape for the nodes in this cluster. A shape defines the number of Oracle Compute Units (OCPUs) and amount of memory (RAM). <p>This shape attribute is optional. If no shape value is specified here, the shape is inherited from the <code>WLS</code> component level <code>shape</code>.<p>On Oracle Cloud Infrastructure, VM.Standard and BM.Standard shapes, and VM.Standard.E3.Flex, VM.Standard.E4.Flex, and VM.Standard3.Flex shapes are supported. <p>You can specify the number of OCPUs for the flex shapes. The maximum number of OCPUs for VM.Standard.E3.Flex and VM.Standard.E4.Flex is 64 OCPUs, and the maximum number of OCPUs for VM.Standard3.Flex is 32 OCPUs. The amount of memory is calculated based on the number of OCPUs as n*16, where n is the number of OCPUs. <p>Available shapes vary depending on your Oracle Cloud account and the region in which you provision a service instance.<p>See <a href='https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=oci_compute_shapes' target='_blank'>Compute Shapes</a> in the Oracle Cloud Infrastructure documentation.<p>On Oracle Cloud Infrastructure Classic, valid shapes include: <ul><li>oc3: 1 OCPU, 7.5 GB memory</li><li>oc4: 2 OCPUs, 15 GB memory</li><li>oc5: 4 OCPUs, 30 GB memory</li><li>oc6: 8 OCPUs, 60 GB memory</li><li>oc7: 16 OCPUs, 120 GB memory</li><li>oc8: 24 OCPUs, 180 GB memory</li><li>oc9: 32 OCPUs, 240 GB memory</li><li>oc1m: 1 OCPU, 15 GB memory</li><li>oc2m: 2 OCPUs, 30 GB memory</li><li>oc3m: 4 OCPUs, 60 GB memory</li><li>oc4m: 8 OCPUs, 120 GB memory</li><li>oc5m: 16 OCPUs, 240 GB memory</li><li>oc8m: 24 OCPUs, 360 GB memory</li><li>oc9m: 32 OCPUs, 480 GB memory</li></ul><p>Note: Some shapes might not be available in a region."
}
}
}
Nested Schema : pathPrefixes
Type: array
A single path prefix or multiple path prefixes separated by commas. A path prefix must be unique across clusters in the domain.
This attribute is only applicable to service instances where an Oracle-managed load balancer is configured. It is also only applicable to a cluster of type APPLICATION_CLUSTER
.
When path prefixes are specified, this means the load balancer can route to only those applications that have the context root matching one of the path prefixes.
For example, if you specified the following path prefixes:
["/myapp1", "/myapp2"]
...then the load balancer can route to only those applications that have the context root matching these:
/myapp1
/myapp1/*
/myapp2
/myapp2/*
Show Source
{
"type":"array",
"description":"A single path prefix or multiple path prefixes separated by commas. A path prefix must be unique across clusters in the domain.<p>This attribute is only applicable to service instances where an Oracle-managed load balancer is configured. It is also only applicable to a cluster of type <code>APPLICATION_CLUSTER</code>.<p>When path prefixes are specified, this means the load balancer can route to only those applications that have the context root matching one of the path prefixes.<p>For example, if you specified the following path prefixes:<p><code>[\"/myapp1\", \"/myapp2\"]</code><p>...then the load balancer can route to only those applications that have the context root matching these:<ul><li><code>/myapp1</code></li><li><code>/myapp1/*</code></li><li><code>/myapp2</code></li><li><code>/myapp2/*</code></li></ul>",
"items":{
"type":"string"
}
}
Nested Schema : subnets
Type: array
This attribute is available only on Oracle Cloud Infrastructure.
This attribute is required if you are provisioning an Oracle Java Cloud Service instance on a specific subnet using subnet
.
Subnets for the Oracle-managed load balancer nodes (node 1 and node 2).
Use the OCID of a public subnet. The OCID is a unique autogenerated ID. To find out the OCID of a subnet, go to the Oracle Cloud Infrastructure web console, select Networking and click the VCN that your subnet is in, then look for the OCID field under the subnet that you want to use.
Oracle recommends that you use a regional subnet for the load balancer to support failover to another availability domain if needed.
Note the following:
- In a
region
that has a single availability domain, only one subnet value can be provided. - If a regional subnet is specified, then only one subnet value can be provided.
- If a subnet that is scoped for an availability domain is specified, then two subnet values must be provided. For each Oracle-managed load balancer node, use a subnet from a different availability domain. For one of the nodes, Oracle recommends using a subnet from the same
availabilityDomain
as specified for the service instance. This ensures that, as long as the service instance is running, the applications deployed on it remain accessible through the Oracle-managed load balancer.
Show Source
{
"type":"array",
"description":"This attribute is available only on Oracle Cloud Infrastructure.<p>This attribute is required if you are provisioning an Oracle Java Cloud Service instance on a specific subnet using <code>subnet</code>.<p>Subnets for the Oracle-managed load balancer nodes (node 1 and node 2).<p>Use the OCID of a public subnet. The OCID is a unique autogenerated ID. To find out the OCID of a subnet, go to the Oracle Cloud Infrastructure web console, select <b>Networking</b> and click the VCN that your subnet is in, then look for the <b>OCID</b> field under the subnet that you want to use.<p>Oracle recommends that you use a regional subnet for the load balancer to support failover to another availability domain if needed.<p>Note the following:<ul><li>In a <code>region</code> that has a single availability domain, only one subnet value can be provided.</li><li>If a regional subnet is specified, then only one subnet value can be provided.</li><li>If a subnet that is scoped for an availability domain is specified, then two subnet values must be provided. For each Oracle-managed load balancer node, use a subnet from a different availability domain. For one of the nodes, Oracle recommends using a subnet from the same <code>availabilityDomain</code> as specified for the service instance. This ensures that, as long as the service instance is running, the applications deployed on it remain accessible through the Oracle-managed load balancer.</li></ul>",
"items":{
"type":"string"
}
}
Nested Schema : tagsassign-provision
Type: object
Each tag is a key/value pair.
For account non-metering tags, specify an existing tag key and value for assignment.
Show Source
-
key:
string
Specify the key for this tag. A tag key can contain letters, numbers, dashes (-), and underscores ( _ ), and it can contain up to 128 characters.
-
value(optional):
string
Specify the value for this tag. A tag value can contain up to 256 characters and is case-sensitive.
Default value is an empty string (if you do not provide a specific value).
{
"description":"Each tag is a key/value pair.<p>For account non-metering tags, specify an existing tag key and value for assignment.",
"properties":{
"key":{
"type":"string",
"description":"Specify the key for this tag. A tag key can contain letters, numbers, dashes (-), and underscores ( _ ), and it can contain up to 128 characters."
},
"value":{
"type":"string",
"description":"Specify the value for this tag. A tag value can contain up to 256 characters and is case-sensitive.<p>Default value is an empty string (if you do not provide a specific value)."
}
},
"required":[
"key"
]
}