Skip to content

Deallocate IP through Global IP Allocator.

DELETE
/api/gia/gia/deallocateip
curl --request DELETE \
--url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/gia/gia/deallocateip \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "context": "example", "ip": "example" }'

DeallocateIP will de-allocate the specified IP address for tenant.

Examples of this operation.

Media typeapplication/json
DeAllocateIPRequest is used to deallocate an ip

This is the input message of the ‘DeAllocateIP’ RPC.

object
context
context

This is the global IP allocator context from which IP deallocation will happen Optional: If not specified, gia will try to deallocate given IP from default IP range.

string
<= 1024 characters
ip
ip address

IP which needs to de-allocated.

string
<= 1024 characters
Examplegenerated
{
"context": "example",
"ip": "example"
}

A successful response.

Media typeapplication/json
DeallocateIP Response

This is the output message of the ‘DeAllocateIP’ RPC.

object
message
message

Message from global IP allocator.

string
<= 1024 characters
Examplegenerated
{
"message": "example"
}

Returned when operation is not authorized.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when there is no permission to access resource.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when resource is not found.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation on resource is conflicting with current value.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation has been rejected as it is happening too frequently.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server encountered an error in processing API.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when service is unavailable temporarily.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server timed out processing request.

Media typeapplication/json
string format: string
Examplegenerated
example