Apache CloudStack 4.0.0-incubating User API Reference

associateIpAddress

Acquires and associates a public IP to an account.

Request parameters

Parameter NameDescriptionRequired
accountthe account to associate with this IP addressfalse
domainidthe ID of the domain to associate with this IP addressfalse
networkidThe network this ip address should be associated to.false
projectidDeploy vm for the projectfalse
vpcidthe VPC you want the ip address to be associated withfalse
zoneidthe ID of the availability zone you want to acquire an public IP address fromfalse

Response Tags

Response NameDescription
idpublic IP address id
accountthe account the public IP address is associated with
allocateddate the public IP address was acquired
associatednetworkidthe ID of the Network associated with the IP address
associatednetworknamethe name of the Network associated with the IP address
domainthe domain the public IP address is associated with
domainidthe domain ID the public IP address is associated with
forvirtualnetworkthe virtual network for the IP address
ipaddresspublic IP address
issourcenattrue if the IP address is a source nat address, false otherwise
isstaticnattrue if this ip is for static nat, false otherwise
issystemtrue if this ip is system ip (was allocated as a part of deployVm or createLbRule)
networkidthe ID of the Network where ip belongs to
physicalnetworkidthe physical network this belongs to
projectthe project name of the address
projectidthe project id of the ipaddress
purposepurpose of the IP address. In Acton this value is not null for Ips with isSystem=true, and can have either StaticNat or LB value
stateState of the ip address. Can be: Allocatin, Allocated and Releasing
virtualmachinedisplaynamevirutal machine display name the ip address is assigned to (not null only for static nat Ip)
virtualmachineidvirutal machine id the ip address is assigned to (not null only for static nat Ip)
virtualmachinenamevirutal machine name the ip address is assigned to (not null only for static nat Ip)
vlanidthe ID of the VLAN associated with the IP address
vlannamethe VLAN associated with the IP address
vpcidVPC the ip belongs to
zoneidthe ID of the zone the public IP address belongs to
zonenamethe name of the zone the public IP address belongs to
tags(*)the list of resource tags associated with ip address
accountthe account associated with the tag
customercustomer associated with the tag
domainthe domain associated with the tag
domainidthe ID of the domain associated with the tag
keytag key name
projectthe project name where tag belongs to
projectidthe project id the tag belongs to
resourceidid of the resource
resourcetyperesource type
valuetag value
jobidthe ID of the latest async job acting on this object
jobstatusthe current status of the latest async job acting on this object