You can use the vRealize Automation REST API to create an external, NAT, private, or routed network profile.

Input

Use the supported input parameters to control the command output.

Input

Description

URL

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

Method

Post

$host

Specifies the host name and fully qualified domain name or IP address of the vRealize Automation identity 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 Syntax for Getting a Network Profile Listtopic. 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://$host/iaas-proxy-provider/api/network/profiles/$networkProfileID.

$networkProfileID

Specifies the unique identifier of the new network profile.

curl Command

The following example command creates a network profile.

curl --insecure -H "Accept:application/json" 
-H "Authorization: Bearer $token" 
https://$host/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",
  "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 output contains an empty HTTP response body and the location and network profile ID in the header statement.

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.