Amazon Free IPs

Table 1. API: GET Amazon Free Ips
Element Description
API ReserveAndGetAWSFreeIpDetails
Description API reserves and returns IPaddress for an object i.e. IP will be blocked in passed subnet.
Method POST
URL Http(s)://{xx.xxxx.xx.xx:xxx}/v3/aws/provisioningEndPoints/{endpointId}/subnets/{subnetEntityId}/freeIps
URL Parameters (fields in curly {} braces)
  • endpointId (Mandatory): This is a unique identifier of Cloud Endpoint created in HCL BigFix CLM. It can be any value either PlatformEntityId or Name of the Platform available on Manage Provisioning Platform screen.
  • subnetEntityId (Mandatory): this parameter represents the subnet entity id for which IPs are to be fetched.
Body Parameters
{
"objectId": "string",
"nicPrefix": "string"
}
  • Objectid (Mandatory): This is a unique identifier of Resource like VM -Virtual Machine, LB-Load Balancer etc.
  • Nicprefix: Prefix of IP addresses such as NIC1, NIC2.
Header
  • Authorization Key: The initial step that needs to be performed before consuming HCL BigFix CLM API is to obtain the Token Value for an authorization key. Once a Token value is obtained, it remains valid for all API calls made in a session. For more information on how to do that, refer Token API description.
  • Content-type: application/json
Response

A Sample Response:

{
 "subnetName": "PublicSubnet3",
 "ipAddress": "xxxxxx",
 "subnetMask": "255.255.252.0",
 "defaultGateway": "xxxxxx",
 "networkType": "NET_T1"
}
Response Parameters
  • Result:
  • SubnetName
  • ipAddress
  • subnetmask
  • defaultGateway
  • networkType