Add Storage to an Existing or New Volume
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/storage/add
BASIC
service level).Extends an Oracle Java Cloud Service instance by adding block storage to an existing volume that is already attached to a node or you can create a new storage volume and attach it to a node.
For service instances provisioned on Oracle Cloud Infrastructure, the minimum size of a volume you can add is 50 GB.
For service instances provisioned on Oracle Cloud Infrastructure Classic, the minimum size of a volume you can add is 1 GB.
Request
- application/json
-
identityDomainId: string
Identity domain ID for the Oracle Java Cloud Service account.
-
serviceId: string
Name of the Oracle Java Cloud Service instance.
-
Authorization: string
Base64 encoded user name and password separated by a colon or OAuth access token obtained from Oracle Identity Cloud Service. See Authenticate.
-
X-ID-TENANT-NAME: string
Identity domain ID for the Oracle Java Cloud Service account.
object
-
components:
object components
Groups properties for the Oracle WebLogic Server component (
WLS
).
object
WLS
).-
WLS:
object WLS
Specify the host and the volume to extend.
On Oracle Cloud Infrastructure Classic:
- A host is limited to 10 volumes at 2000 GB each. This limit includes the 4 volumes that are attached automatically when the service instance was first created.
- The maximum storage of a volume you can add is 2000 GB, the minimum is 1 GB.
- The maximum number of times you can perform an operation is 6.
On Oracle Cloud Infrastructure:
- A host is limited to 20 volumes at 2000 GB each. This limit includes the 3 volumes that are attached automatically when the service instance was first created.
- You can add from 50 to 2000 GB, in 50 GB increments.
- The maximum number of times you can perform an operation is 17.
Note: You can specify more than one volume in a request. Adding storage to one volume is considered to be one operation.
object
On Oracle Cloud Infrastructure Classic:
- A host is limited to 10 volumes at 2000 GB each. This limit includes the 4 volumes that are attached automatically when the service instance was first created.
- The maximum storage of a volume you can add is 2000 GB, the minimum is 1 GB.
- The maximum number of times you can perform an operation is 6.
On Oracle Cloud Infrastructure:
- A host is limited to 20 volumes at 2000 GB each. This limit includes the 3 volumes that are attached automatically when the service instance was first created.
- You can add from 50 to 2000 GB, in 50 GB increments.
- The maximum number of times you can perform an operation is 17.
Note: You can specify more than one volume in a request. Adding storage to one volume is considered to be one operation.
-
backup(optional):
integer
Number of gigabytes (GBs) to add to the backup volume on the specified host, which must be the WebLogic Administration node.
-
domain(optional):
integer
Number of gigabytes (GBs) to add to the domains volume on the specified host.
-
hosts:
array hosts
Name of the host.
Use a comma separated list to specify more than one host.
The WebLogic Administration node must be specified if you want to extend the backup volume.
A new user defined partition can be added to any host.
-
middleware(optional):
integer
Number of gigabytes (GBs) to add to the middleware volume on the specified host.
-
user_defined_partitions(optional):
integer
Number of gigabytes (GBs) to add to a new partition in a new volume on the specified host.
On Oracle Cloud Infrastructure Classic: A host can have up to 10 volumes. This limit includes the 4 volumes that are attached automatically when the service instance was first created.
On Oracle Cloud Infrastructure: A host can have up to 20 volumes. This limit includes the 3 volumes that are attached automatically when the service instance was first created.
array
Use a comma separated list to specify more than one host.
The WebLogic Administration node must be specified if you want to extend the backup volume.
A new user defined partition can be added to any host.
Response
- application/json
202 Response
Location
header returns a URI that can be used to view the job status. See View the Status of an Operation by Job Id.object
issues
array for warning messages.-
details:
object details
Groups details of the operation.
object
-
issues(optional):
array issues
Groups strings of warning messages, if any.
-
jobId:
string
Job ID for the operation. Not available if the response status code is 400.
-
message:
string
System message that describes the operation.
400 Response
See Status Codes for information about other possible HTTP status codes.
object
issues
array for validation error messages.-
details(optional):
object details
Groups details of the request.
object
-
issues(optional):
array issues
Groups strings of validation error messages, if any.
-
message(optional):
string
System message that describes the request.
Examples
The following example shows how to add block storage to an existing Oracle Java Cloud Service instance. A POST request is submitted on the REST resource using cURL.
Note: The command in this example uses the URL structure https://rest_server_url/resource-path
, where rest_server_url
is the REST server to contact for your identity domain (or Cloud Account). See Send Requests.
cURL Command
curl -i -X POST -u username:password -d @addstorage.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/storage/add
Example of Request Body
The following shows an example of the request body to add storage to the domains volume.
{
"components": {
"WLS": {
"domain": 2,
"hosts":["exampleinstance-wls-1"]
}
}
}
The following shows an example of the request body to add a user defined partition, which is created in a new volume named user_defined_partitions
. Subsequent user defined partitions are added to the same user_defined_partitions
volume.
{
"components": {
"WLS": {
"user_defined_partitions": 2,
"hosts":["exampleinstance-wls-1"]
}
}
}
Example of Response Header
The following shows an example of the response header. The Location
header returns the URI that can be used to view the job status. See View the Status of an Operation by Job Id.
HTTP/1.1 202 Accepted
Date: Wed, 25 Oct 2017 19:20:01 GMT
Server: Oracle-HTTP-Server-11g
Location: https://rest_server_url/paas/api/v1.1/activitylog/ExampleIdentityDomain/job/7120528
Content-Length: 129
Content-Language: en
Example of Response Body
The following shows an example of a 202 response returned in JSON format.
{
"details":
{
"message": "Submitted job to add storage for service [ExampleInstance] in domain [ExampleIdentityDomain].",
"jobId": "7120528"
}
}
The following shows an example of a 400 response returned in JSON format.
{
"details": {
"message": "PSM-LCM-06004 Unable to submit request to add storage. Check additional validation errors for details.",
"issues": [
"[Value for parameter [Domain Volume Size GB (domain) ] is not a valid Integer]"
]
}
}