Get First Free Address Space

You can get the first free IP address range of the created virtual network.

Request

To retrieve a representation of the first free IP address range, send the HTTP GET request to the /virtualNetworks/firstFreeAddressSpace endpoint.

HTTP Request

GET https://<hostname>/api/v2/cloudInfrastructure/virtualNetworks/firstFreeAddressSpace

Query Parameters

To control the amount and order of data in the response, you can use the following query parameters:

Query Parameter

Value

Description

subnetMask

integer($int32)

Specifies the subnet mask.

subscriptionId

string($uuid)

Returns only the IP address range available for the specified subscription.

Request Headers

The request contains the following headers.

Header

Required

Value

Description

Authorization

Required

Bearer <Access-Token>

Authenticates a client who sends the request to the server. Must contain the access token for the current logon session in the Bearer <Access-Token> format.

Response

The server returns the following response to the client.

Response Codes

A successfully completed operation returns a response code 200 (OK).

Response Headers

The response to this request contains the following headers. The response may also include additional standard HTTP headers.

Header

Value

Description

Content-length

integer

Identifies the length of the response body message, in bytes.

Content-type

  • application/json
  • application/problem+json

Identifies the media type of the response body message.

Response Body

In the response body, Veeam Backup for Microsoft Azure returns a representation of the /virtualNetworks/firstFreeAddressSpace collection.

Get First Free Address SpaceExample

The following request returns the first free IP address range.

Request:

GET https://51.11.247.127/api/v2/cloudInfrastructure/virtualNetworks/firstFreeAddressSpace

 

Request Header:

Authorization: Bearer <Access-Token>

 

Response:

200

 

Response Body:

"10.2.27.0/24"

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.