createInstance (SOA Cloud)
- Copy Page Tree
- Ben Hoffman
- Karl Henselin
Create a SOA Cloud Service instance, along with its Load Balancer if desired. Property Replacement is performed on the property file. See Property Replacement Support for more information about property replacement..
See the special considerations below for information about formatting the properties file.
Environment/Instance Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
Project Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
Inputs
| Input Name | Input Code | Required | Description |
|---|---|---|---|
| Identity Domain |
| Yes | The SOA Cloud Identity Domain |
| URL Prefix |
| No | The region prefix of the SOA Cloud REST resources. Defaults to " |
| Instance Name |
| Yes | The name of the SOA Cloud Service instance. |
| Username |
| Yes | The username with which to connect to the SOA Cloud Service instance. |
| Password |
| Yes | The password for |
| Timeout | FDSOA_CLOUD_TIMEOUT | No | The number of minutes to wait for the managed server to be removed. If the number of minutes is exceeded, the operation will exit with a failure. Defaults to 60 minutes. |
| Property File |
| Yes | The path to the properties file that describes the instance to be created. If a relative path is given, a path inside the |
Outputs
Output Name | Required | Description |
|---|---|---|
Artifacts
This operation consumes a property file artifact.
Endpoint Selection
This operation will select all available endpoints associated to the Environment/Instance.
Endpoint Execution
This operation will randomly execute on one of the endpoints identified during selection.
Special Considerations
The properties file is closely based on the Oracle REST Services. If you need more information than is found in this guide, please see the Oracle documentation.
If you receive a 500 error when creating an instance, check if your database instance is up and you have the correct name and password.
Property Name | Required | Description |
|---|---|---|
weblogic.adminUserName | Yes | The admin user name for the Weblogic Servers |
weblogic.adminPassword | Yes | The password for weblogic.adminUserName |
weblogic.dbServiceName | Yes | The Service name of the database for the Weblogic instances |
weblogic.dbaName | Yes | A database username which has sysdba rights |
weblogic.dbaPassword | Yes | The password for weblogic.dbaName |
weblogic.shape | Yes | The shape of the SOA server to create. |
weblogic.VMsPublicKey | Yes | The public key for the VM. This should be a String starting with "ssh-rsa". |
provisionOTD | No | Whether a load balancer should be provisioned for this instance (true / false). Defaults to false. |
topology | Yes | osb - Oracle Service Bus Topology. |
subscriptionType | No | HOURLY / MONTHLY Currently, Oracle only allows MONTHLY for this value. Please verify with Oracle Support that your billing will be as expected. |
cloudStorageContainer | No | The storage container e.g. SOAContainer1. Defaults to FDSOA_CLOUD_INSTANCE_NAME + "BK". The container is automatically created if it doesn't already exist in the Storage Cloud. |
cloudStorageUser | No | The username with which to connect to the Storage Cloud Service instance, if different from FDSOA_CLOUD_USERNAME |
cloudStoragePassword | No | The password for cloudStorageUser if different from FDSOA_CLOUD_PASSWORD |
If provisionOTD is set to true, this field is required:
Property Name | Required | Description |
|---|---|---|
otd.shape | Yes | The shape of the OTD instance. Current choices are |
This plugin is designed to accommodate changes in Oracle's REST API. It will pass all properties that don't start with weblogic. or otd. as top-level data in the JSON request, and pass each prefixed data as data inside of parameters as the type of the prefix. Any properties that Oracle supports can be used even if not listed in the tables above. If there is a validation error, the data from Oracle is excellent for providing the solution.
Here is an example error message from leaving a field blank:
flexagon.ff.common.core.exceptions.FlexCheckedException: FDSOACloud-00051: Unexpected status code 400 - Bad Request - SOA-PROVISIONING-13: validation error - field "type": "OTD" - shape - value is required.
This means that you need to send in otd.shape={value}
If you set it to an invalid value, you will receive an error like this:
flexagon.ff.common.core.exceptions.FlexCheckedException: FDSOACloud-00051: Unexpected status code 400 - Bad Request - SOA-PROVISIONING-14: validation error - field "type": "OTD" - shape - entered value thjklas is invalid, please set one of the values - OC3/OC4/OC5/OC6/OC7/OC1M/OC2M/OC3M/OC4M/OC5M
In this error, "OTD" – shape means that otd.shape had an invalid value, and lists possible correct values.
See
https://docs.oracle.com/cloud/latest/soacs_gs/SCSAP/op-instances-%7BidentityId%7D-post.html for more information about Oracle's API.
- style