Apache CloudStack 4.0.0-incubating User API Reference
createPortForwardingRule
Creates a port forwarding rule
Request parameters
| Parameter Name | Description | Required |
| ipaddressid | the IP address id of the port forwarding rule | true |
| privateport | the starting port of port forwarding rule's private port range | true |
| protocol | the protocol for the port fowarding rule. Valid values are TCP or UDP. | true |
| publicport | the starting port of port forwarding rule's public port range | true |
| virtualmachineid | the ID of the virtual machine for the port forwarding rule | true |
| cidrlist | the cidr list to forward traffic from | false |
| networkid | The network of the vm the Port Forwarding rule will be created for. Required when public Ip address is not associated with any Guest network yet (VPC case) | false |
| openfirewall | if true, firewall rule for source/end pubic port is automatically created; if false - firewall rule has to be created explicitely. If not specified 1) defaulted to false when PF rule is being created for VPC guest network 2) in all other cases defaulted to true | false |
| privateendport | the ending port of port forwarding rule's private port range | false |
| publicendport | the ending port of port forwarding rule's private port range | false |
Response Tags
| Response Name | Description |
| id | the ID of the port forwarding rule |
| cidrlist | the cidr list to forward traffic from |
| ipaddress | the public ip address for the port forwarding rule |
| ipaddressid | the public ip address id for the port forwarding rule |
| privateendport | the ending port of port forwarding rule's private port range |
| privateport | the starting port of port forwarding rule's private port range |
| protocol | the protocol of the port forwarding rule |
| publicendport | the ending port of port forwarding rule's private port range |
| publicport | the starting port of port forwarding rule's public port range |
| state | the state of the rule |
| virtualmachinedisplayname | the VM display name for the port forwarding rule |
| virtualmachineid | the VM ID for the port forwarding rule |
| virtualmachinename | the VM name for the port forwarding rule |
| tags(*) | the list of resource tags associated with the rule |
| account | the account associated with the tag |
| customer | customer associated with the tag |
| domain | the domain associated with the tag |
| domainid | the ID of the domain associated with the tag |
| key | tag key name |
| project | the project name where tag belongs to |
| projectid | the project id the tag belongs to |
| resourceid | id of the resource |
| resourcetype | resource type |
| value | tag value |