Jump to

• Request
• Response
• Examples

Delete an IP Reservation

delete

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

This endpoint is available only in Cloud accounts that support Oracle Cloud Infrastructure Classic regions. Additionally, It is not applicable to Oracle Cloud Infrastructure.

Deletes an IP reservation created in Database Classic Cloud Service. Only unused IP reservations can be deleted. If a delete activity is already in progress, you cannot initiate another deletion request.

Request

Path Parameters

• identityDomainId: string
  Identity domain ID for the Database Classic Cloud Service account:
   

  • For a Cloud account with Identity Cloud Service: the identity service ID, which has the form idcs-letters-and-numbers. You can find this ID in the Identity Service Id field on the Overview tab of the Service Details page for Database Classic Cloud Service in My Services.

  • For a traditional cloud account: the name of the identity domain.

• ipResName: string
  Name of the unused IP reservation to delete. To retrieve the name, see View All IP Reservations.

Header Parameters

• Authorization: string
  Base64 encoding of the user name and password of the user making the request. For more information, see Security, Authentication and Authorization.
• X-ID-TENANT-NAME: string
  Identity domain ID for the Database Classic Cloud Service account:
   

  • For a Cloud account with Identity Cloud Service: the identity service ID, which has the form idcs-letters-and-numbers. You can find this ID in the Identity Service Id field on the Overview tab of the Service Details page for Database Classic Cloud Service in My Services.

  • For a traditional cloud account: the name of the identity domain.

Back to Top

Response

202 Response

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

Headers

• Location: string
  A REST URI you can use to check the progress and completion of the IP reservation deletion operation.

Body ()

Root Schema : Response Body

Type: object

Title: Response Body

Show Source

• computeSite(optional): string
  Location of the IP reservation.
• ipResName(optional): string
  Name of the unused IP reservation to be deleted.
• jobId(optional): string
  Job ID of the deletion operation.

{
    "title":"Response Body",
    "type":"object",
    "description":"",
    "properties":{
        "computeSite":{
            "type":"string",
            "description":"Location of the IP reservation."
        },
        "ipResName":{
            "type":"string",
            "description":"Name of the unused IP reservation to be deleted."
        },
        "jobId":{
            "type":"string",
            "description":"Job ID of the deletion operation."
        }
    }
}

409 Response

Conflict. Returned if the IP reservation is in use. The message displayed is: The IP Reservation [ip_reservation_name] is already in use by service [service_instance_name].

Back to Top

Examples

The following example shows how to delete an unused IP reservation for Database Classic Cloud Service instance by submitting a DELETE request on the REST endpoint using cURL.

This example uses a cloud account with Identity Cloud Service, so the {identityDomainId} path parameter and the X-ID-TENANT-NAME header parameter are set to the account's identity service ID, which begins with idcs-270644901b. The Oracle Cloud user name of the user making the call is dbcsadmin. Then name of the IP reservation being deleted is ipResViaRest.

Note that the Location response header provides a URI you can do a GET on to track completion of the deletion operation.

cURL Command

curl --include --request DELETE \
--user dbcsadmin:password \
--header "X-ID-TENANT-NAME:idcs-270644901b..." \
https://psm.us.oraclecloud.com/paas/api/v1.1/network/idcs-270644901b.../services/dbaas/ipreservations/ipResViaRest

HTTP Status Code and Response Headers

HTTP/1.0 200 Connection established

HTTP/1.1 202 Accepted
Server: Oracle-Application-Server-11g
Strict-Transport-Security: max-age=31536000;includeSubDomains
Location: https://psm.us.oraclecloud.com:443/paas/api/v1.1/activitylog/idcs-270644901b.../job/27058246
X-ORACLE-DMS-ECID: id-string
X-ORACLE-DMS-ECID: id-string
X-Frame-Options: DENY
Content-Language: en
Content-Type: application/json
Vary: user-agent
Date: date-and-time-stamp
Connection: close

Response Body

{
  "jobId": "27058246",
  "ipResName": "ipResViaRest",
  "computeSite": "uscom-central-1"
}

Back to Top