POST /api/network/profiles creates an external, NAT, private, or routed network profile.

curl Command

The following example command creates an external network profile without IPAM.

curl --insecure -H "Accept:application/json" 
-H "Authorization: Bearer $token" 
https://$vRA/iaas-proxy-provider/api/$networkProfileID -d “
{
  "@type": "ExternalNetworkProfile",
  "name": "externalTestCreate",
  "description": "",
  "isHidden": false,
  "definedRanges": [
    {
      "name": "range",
      "description": "",
      "beginIPv4Address": "10.110.183.221",
      "endIPv4Address": "10.110.183.240",
      "state": "UNALLOCATED"
    }
  ],
  "profileType": "EXTERNAL",
  "IPAMEndpointId": null,
  "subnetMask": "255.255.255.0",
  "gatewayAddress": "10.110.183.253",
  "primaryDnsAddress": "10.110.182.45",
  "secondaryDnsAddress": "",
  "dnsSuffix": "mycompany.com",
  "dnsSearchSuffix": "",
  "primaryWinsAddress": "10.0.0.1",
  "secondaryWinsAddress": ""
}  
“

JSON Output

The JSON output consists of a location URL, which points to the newly created network profile. The output contains an empty HTTP response body and the following or similar header statement. Copy the location URL into a text editor for future use.

Location:
https://vcac148-084-241.eng.mycompany.com/iaas-proxy-provider/api/network/profiles/263b80f5-d34f-47f2-b0b1-5a3db991c2e9

Copy the location URL into a text editor for future use.

Input

Use the supported input parameters to control the command output.

Input

Description

URL

https://$vRA/iaas-proxy-provider/api/network/profiles

Method

Post

$vRA

Specifies the appliance name and fully qualified domain name, or IP address of the vRealize Automation server.

$token

Specifies a valid HTTP bearer token with necessary credentials.

HTTP Body

The HTTP body describes the network profile to create.

Sample HTTP body field values are presented in the JSON Output section of the Get a Network Profile List Example topic. Format your HTTP body using this content as reference.

Output

The command output contains property names and values based on the command input parameters.

Property

Description

status

If the command is successful, the HTTP status is 201 Created.

Header.Location

The HTTP response should contain a Location attribute that is formatted as https://$vRA/iaas-proxy-provider/api/network/profiles/$networkProfileID.

$networkProfileID

Specifies the unique identifier of the new network profile.