CreateVpcFirewall
API Request
URLs
POST zstack/v1/vpcfirewalls
Headers
Authorization: OAuth the-session-uuid
Body
Note: In
the preceding sample, both systemTags and userTags are optional.
These two fields can be included in the body structure.
{
"params": {
"vpcUuid": "bc370cafacc83fad8f3ad583dea8da12",
"description": "example-des",
"name": "example-name"
},
"systemTags": [],
"userTags": []
}

Curl
Sample
curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X POST -d '{"params":{"vpcUuid":"bc370cafacc83fad8f3ad583dea8da12","description":"example-des","name":"example-name"}}' http://localhost:8080/zstack/v1/vpcfirewalls
Request Parameters
Name | Type | Location | Description | Optional Value | Starting Version |
---|---|---|---|---|---|
vpcUuid | String | body (contained in the params structure) | 3.6.0 | ||
description | String | body (contained in the params structure) | Optional. The detailed description of the resource. | 3.6.0 | |
name | String | body (contained in the params structure) | The resource name. | 3.6.0 | |
resourceUuid | String | body (contained in the params structure) | Optional. | 3.6.0 | |
tagUuids | List | body (contained in the params structure) | Optional. The tag UUID list. | 3.6.0 | |
systemTags | List | body | Optional. The system tags. | 3.6.0 | |
userTags | List | body | Optional. The user tags. | 3.6.0 |
API Response
Sample
Response
{
"inventory": {
"name": "name",
"refs": [
{
"id": 1.0,
"ruleSetUuid": "06fc56b0483a3bf487b9cdfeaa6c4be2",
"l3NetworkUuid": "27e1a95342083ce4a790d4f9dcf7f9bd",
"packetsForwardType": "in",
"createDate": "Nov 14, 2017 10:20:57 PM",
"lastOpDate": "Nov 14, 2017 10:20:57 PM"
}
],
"description": "example-des"
}
}
Name | Type | Description | Starting Version |
---|---|---|---|
error | ErrorCode | The error code. If not null, the operation fails, or vice versa. For more information, see error. | 3.6.0 |
inventory | VpcFirewallInventory | See inventory. | 3.6.0 |
#error
Name | Type | Description | Starting Version |
---|---|---|---|
code | String | The error code, which is a numbered or alphanumeric code that specifies an error. For example, SYS.1000, HOST.1001. | 3.6.0 |
description | String | The brief description of the error. | 3.6.0 |
details | String | The details about the error. | 3.6.0 |
elaboration | String | The reserved field. Default value: null. | 3.6.0 |
opaque | LinkedHashMap | The reserved field. Default value: null. | 3.6.0 |
cause | ErrorCode | The root error, which is the associated root cause of the current error. If no root error exists, this parameter is null. | 3.6.0 |
#inventory
Name | Type | Description | Starting Version |
---|---|---|---|
uuid | String | The resource UUID. | 3.6.0 |
name | String | The resource name. | 3.6.0 |
createDate | Timestamp | The creation date. | 3.6.0 |
lastOpDate | Timestamp | The last operation date. | 3.6.0 |
description | String | The detailed description of the resource. | 3.6.0 |
refs | List | See refs. | 3.6.0 |
#refs
Name | Type | Description | Starting Version |
---|---|---|---|
id | long | 3.6.0 | |
ruleSetUuid | String | 3.6.0 | |
l3Uuid | String | 3.6.0 | |
createDate | Timestamp | The creation date. | 3.6.0 |
lastOpDate | Timestamp | The last operation date. | 3.6.0 |
packetsForwardType | PacketsForwardType | See packetsForwardType. | 3.6.0 |
#packetsForwardType
Name | Type | Description | Starting Version |
---|---|---|---|
in | PacketsForwardType | 3.6.0 | |
out | PacketsForwardType | 3.6.0 | |
local | PacketsForwardType | 3.6.0 |
SDK Sample
Java
SDK
CreateVpcFirewallAction action = new CreateVpcFirewallAction();
action.vpcUuid = "bc370cafacc83fad8f3ad583dea8da12";
action.description = "example-des";
action.name = "example-name";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
CreateVpcFirewallAction.Result res = action.call();
Python
SDK
CreateVpcFirewallAction action = CreateVpcFirewallAction()
action.vpcUuid = "bc370cafacc83fad8f3ad583dea8da12"
action.description = "example-des"
action.name = "example-name"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
CreateVpcFirewallAction.Result res = action.call()