Qin Ying, Fan 7e6f07b803 VPC API 20240320 version

Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>

2024-09-05 12:25:23 +00:00

17 KiB

Raw Blame History

Creating a Firewall Policy

Function

This API is used to create a firewall policy which must be bound to a firewall group. You can learn more about the relationships among firewall groups, policies, and rules.

URI

POST /v2.0/fwaas/firewall_policies

Request Parameters

**Table 1** Request parameter
Parameter	Type	Mandatory	Description
firewall_policy	firewall_policy object	Yes	Specifies the firewall policy. For details, see Table 2.

**Table 2** **Firewall Policy** objects
Attribute	Mandatory	Type	Description
name	No	String	Specifies the name of the firewall policy. The value can contain a maximum of 255 characters.
description	No	String	Provides supplementary information about the firewall policy. The value can contain a maximum of 255 characters.
firewall_rules	No	Array of strings	Specifies the firewall rules referenced by the firewall policy.
audited	No	Boolean	Specifies the audit flag. The value can be true or false.

Example Request

Create an ACL policy named test-policy and associate it with the ACL rule whose ID is b8243448-cb3c-496e-851c-dadade4c161b.

POST https://{Endpoint}/v2.0/fwaas/firewall_policies

{
    "firewall_policy": {
        "name": "test-policy", 
        "firewall_rules": [
            "b8243448-cb3c-496e-851c-dadade4c161b"
        ]
    }
}

Response Parameters

**Table 3** Response parameter
Parameter	Type	Description
firewall_policy	firewall_policy object	Specifies the firewall policy. For details, see Table 4.

**Table 4** **Firewall Policy** objects
Attribute	Type	Description
id	String	Specifies the UUID of the firewall policy.
name	String	Specifies the name of the firewall policy.
description	String	Provides supplementary information about the firewall policy.
tenant_id	String	Specifies the project ID.
firewall_rules	Array of strings	Specifies the firewall rules referenced by the firewall policy.
audited	Boolean	Specifies the audit flag.
public	Boolean	Specifies whether the firewall policy can be shared by different tenants.
project_id	String	Specifies the project ID.

Example Response

{
    "firewall_policy": {
        "description": "", 
        "firewall_rules": [
            "b8243448-cb3c-496e-851c-dadade4c161b"
        ], 
        "tenant_id": "23c8a121505047b6869edf39f3062712", 
        "public": false, 
        "id": "2fb0e81f-9f63-44b2-9894-c13a3284594a", 
        "audited": false, 
        "name": "test-policy",
        "project_id": "23c8a121505047b6869edf39f3062712"
    }
}

Status Code

See Status Codes.

Error Code

See Error Codes.

Parent topic: Firewall

17 KiB Raw Blame History