Delete an IP Reservation
/paas/api/v1.1/network/{identityDomainId}/services/SOA/ipreservations/{ipResName}
Deletes an IP reservation created in Oracle SOA Cloud Service. Only unused IP reservations can be deleted. If a delete activity is already in progress, you cannot initiate another delete request.
Request
-
identityDomainId: string
Identity domain ID for the Oracle SOA Cloud Service account.
-
ipResName: string
Name of the unused IP reservation to delete. To retrieve the name, see View All IP Reservations.
-
X-ID-TENANT-NAME: string
Identity domain ID for the Oracle SOA Cloud Service account.
Response
202 Response
The Location
header returns a URI that can be used to view the job status, as described in View the Status of an Operation by Job Id.
object
-
computeSite:
string
Location of the IP reservation.
-
ipResName:
string
Name of the unused IP reservation to be deleted.
-
jobId:
string
Job ID of the delete operation.
409 Response
The IP Reservation [ip_reservation_name] is already in use by service [service_instance_name]
.Examples
The following example shows how to delete an IP reservation from Oracle SOA Cloud Service by submitting a DELETE 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
curl -i -X DELETE -u username:Password! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/network/ExampleIdentityDomain/services/soa/ipreservations/ipres04
Example of Response Header
The following example shows 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, 22 Nov 2021 23:02:17 GMT
Transfer-Encoding: chunked
Location: https://rest_server_url/paas/api/v1.1/activitylog/ExampleIdentityDomain/job/1401148
Content-Type: application/json
Example of Response Body
The following example shows the response body in JSON format:
{
"jobId":"1401148",
"ipResName":"ipres04",
"computeSite":"uscom-central-1"
}