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

View All IP Reservations

get

/paas/api/v1.1/network/{identityDomainId}/services/jaas/ipreservations

This endpoint is not available in accounts where regions are not supported. It is also not applicable to Oracle Cloud Infrastructure.

Returns information about the IP reservations created for Oracle Java Cloud Service in the given identity domain. Both used and unused IP reservations are returned.

IP reservations are assigned to Java Cloud Service instances that are attached to shared networks or IP networks. This endpoint can be used with the ?networkType query parameter to get all IP reservations (that is, for use with both IP networks and shared networks) or only those IP reservations that can be assigned to instances associated with IP networks. If you use the endpoint without specifying the query paramater, only those that can be used with shared networks are returned.

Request

Path Parameters
Query Parameters
  • Allowed values (case-sensitive):
    • ALL: Get details of all IP reservations (with shared networks and IP networks).
    • IPNetwork: Get details of only those IP reservations that can be assigned to instances attached to IP networks.
Header Parameters
Back to Top

Response

Supported Media Types

200 Response

OK. See Status Codes for information about other possible HTTP status codes.
Body ()
Root Schema : ipres-response
Type: object
The response body contains information about used and unused IP reservations.
Show Source
Nested Schema : activities
Type: array
Groups details about ongoing and failed activity messages, if any.
Show Source
Nested Schema : ipReservations
Type: array
Groups all IP reservations.
Show Source
Nested Schema : ipreservations-activities
Type: object
Show Source
Nested Schema : activity
Type: object
Ongoing and failed activities, if any.
Show Source
Nested Schema : ipreservations
Type: object
Show Source
Back to Top

Examples

The following example shows how to view all IP reservations created for Oracle Java Cloud Service, by submitting a GET request 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

  • To get the details of all the IP reservations:

    curl -i -X GET -u username:password -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/network/ExampleIdentityDomain/services/jaas/ipreservations?networkType=ALL

  • To get the details of the IP reservations that can be assigned to only instances attached to the shared network:

    curl -i -X GET -u username:password -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/network/ExampleIdentityDomain/services/jaas/ipreservations

  • To get the details of the IP reservations that can be assigned to only instances attached to IP networks:

    curl -i -X GET -u username:password -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/network/ExampleIdentityDomain/services/jaas/ipreservations?networkType=IPNetwork

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 200 OK
Date: Wed, 22 Mar 2017 21:24:07 GMT
Content-Language: en
Content-Type: application/json

Example of Response Body

The following is an example of the response returned in JSON format, showing USED and UNUSED IP reservations. This sample response is for a request that included the optional ?networkType=ALL query parameter. 

{
    "ipReservations": [
        {
            "id": 10008,
            "name": "ipres03",
            "ipAddress": "111.111.111.111",
            "status": "UNUSED",
            "identityDomain": "exampleidentitydomain",
            "serviceType": "JaaS",
            "computeSiteName": "uscom-central-1",
            "serviceEntitlementId": "1111111111",
            "creationTime": "2018-04-10T15:49:40.874+0000"
        },
        {
            "id": 12009,
            "name": "ipres04",
            "networkType": "IPNetwork",
            "ipAddress": "111.111.11.1",
            "status": "UNUSED",
            "identityDomain": "exampleidentitydomain",
            "serviceType": "JaaS",
            "computeSiteName": "uscom-east-1",
            "serviceEntitlementId": "1111111111",
            "creationTime": "2018-06-05T20:31:14.022+0000"
        },
        {
            "id": 7505,
            "name": "ipres01",
            "ipAddress": "129.158.72.44",
            "status": "UNUSED",
            "identityDomain": "exampleidentitydomain",
            "serviceType": "JaaS",
            "computeSiteName": "uscom-east-1",
            "serviceEntitlementId": "1111111111",
            "creationTime": "2018-02-06T22:36:42.562+0000"
        },
        {
            "id": 9359,
            "name": "ipres02",
            "networkType": "IPNetwork",
            "ipAddress": "111.111.111.11",
            "status": "USED",
            "identityDomain": "exampleidentitydomain",
            "serviceType": "JaaS",
            "computeSiteName": "uscom-east-1",
            "serviceName":"ExampleInstance",
            "hostName":"exampleinstance-wls-3",
            "serviceEntitlementId": "1111111111",
            "creationTime": "2018-03-21T05:06:47.480+0000"
        }
    ],
    "activities": [
        {
            "activity": {
                "message": "Creation of [ipres05] ip reservation(s) is in progress.",
                "status": "RUNNING"
            }
        }
    ]
}
Back to Top