1. REST API for Oracle Java Cloud Service
  2. Tasks
  3. Service Instances

Add Storage to an Existing or New Volume

post

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/storage/add

This functionality is not supported by Oracle Java Cloud Service - Virtual Image instances (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

Supported Media Types
Path Parameters
Header Parameters
Body ()
The request body defines the details of the request.
Root Schema : addstorage-postrequestm
Type: object
Show Source
Nested Schema : components
Type: object
Groups properties for the Oracle WebLogic Server component (WLS).
Show Source
  • 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.

Nested Schema : WLS
Type: object
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.

Show Source
  • Number of gigabytes (GBs) to add to the backup volume on the specified host, which must be the WebLogic Administration node.
  • Number of gigabytes (GBs) to add to the domains volume on the specified host.
  • 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.

  • Number of gigabytes (GBs) to add to the middleware volume on the specified host.
  • 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.

Nested Schema : hosts
Type: array
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.

Show Source
Back to Top

Response

Supported Media Types

202 Response

Accepted. The Location header returns a URI that can be used to view the job status. See View the Status of an Operation by Job Id.
Body ()
Root Schema : accepted-responsem
Type: object
The response body contains information about the operation. It can include an issues array for warning messages.
Show Source
Nested Schema : details
Type: object
Groups details of the operation.
Show Source
Nested Schema : issues
Type: array
Groups strings of warning messages, if any.
Show Source

400 Response

Bad Request. Returned if the request payload contains bad or missing details.

See Status Codes for information about other possible HTTP status codes.

Body ()
Root Schema : badrequest-responsem
Type: object
The response body contains information about the request. It can include an issues array for validation error messages.
Show Source
Nested Schema : details
Type: object
Groups details of the request.
Show Source
Nested Schema : issues
Type: array
Groups strings of validation error messages, if any.
Show Source
Back to Top

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]"
        ]
    }
}
Back to Top