Associating a Subnet with a Network ACL

Function

This API is used to associate a network ACL with a subnet to control the inbound and outbound traffic of the subnet.

Calling Method

For details, see Calling APIs.

URI

PUT /v3/{project_id}/vpc/firewalls/{firewall_id}/associate-subnets

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
firewall_id	Yes	String	Definition: Network ACL ID. You can call the API Querying Network ACLs to obtain the ID of the target network ACL, and then use this API to associate the network ACL with a subnet. Range: N/A
project_id	Yes	String	Definition: ID of the project that the network ACL belongs to. For details about how to obtain a project ID, see Obtaining a Project ID. Range: N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
subnets	Yes	Array of RequestFirewallAssociation objects	Definition: Request body for associating a network ACL with a subnet. Constraints: N/A Range: N/A Default Value: N/A
dry_run	No	Boolean	Definition: Whether to only check the request. Constraints: N/A Range: true: A check request will be sent and no network ACL will be associated with the subnet. Check items include mandatory parameters, request format, and constraints. If the check fails, an error will be returned. If the check succeeds, response code 202 will be returned. false: A request will be sent and a network ACL will be associated with the subnet. Default Value: false

**Table 3** RequestFirewallAssociation
Parameter	Mandatory	Type	Description
virsubnet_id	Yes	String	Definition: ID of the subnet associated with the network ACL. Constraints: If the network ACL type is normal, it can only be associated with common subnets. If the network ACL type is CloudDCN, it can only be associated with CloudDCN subnets. Range: N/A Range: N/A

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
firewall	FirewallDetail object	Definition: Response body for associating a network ACL with a subnet. Range: N/A
request_id	String	Definition: Request ID. Range: N/A

**Table 5** FirewallDetail
Parameter	Type	Description
id	String	Definition: Network ACL ID. Each network ACL comes with an ID, which uniquely identifies the network ACL. Range: The value is in UUID format with hyphens (-).
name	String	Definition: Name of the network ACL. Range: The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods.
description	String	Definition: Supplementary information about the network ACL. Range: The value can contain 0 to 255 characters and cannot contain angle brackets (< or >).
project_id	String	Definition: ID of the project that the network ACL belongs to. Range: N/A
created_at	String	Definition: Time when the network ACL was created. The value is automatically generated by the system. Range: The value is a UTC time in the format of yyyy-MM-ddTHH:mm:ssZ.
updated_at	String	Definition: Time when the network ACL was last updated. The value is automatically generated by the system. Range: The value is a UTC time in the format of yyyy-MM-ddTHH:mm:ssZ.
admin_state_up	Boolean	Definition: Network ACL administrative status. Range true: The network ACL is enabled. false: The network ACL is disabled.
status	String	Definition: Network ACL status. Range ACTIVE: The network ACL is associated with a subnet. INACTIVE: The network ACL is not associated with a subnet.
enterprise_project_id	String	Definition: ID of the enterprise project that the network ACL belongs to. Range: The value is 0 or a string that contains a maximum of 36 characters in UUID format with hyphens (-). 0 indicates the default enterprise project.
tags	Array of ResponseTag objects	Definition: Tags of a network ACL, including tag keys and tag values, which can be used to classify and identify resources. For details, see the tag objects. Range: N/A
associations	Array of FirewallAssociation objects	Definition: Subnets associated with the network ACL. Range: N/A
ingress_rules	Array of FirewallRuleDetail objects	Definition: Network ACL inbound rules. Range: N/A
egress_rules	Array of FirewallRuleDetail objects	Definition: Network ACL outbound rules. Range: N/A

**Table 6** ResponseTag
Parameter	Type	Description
key	String	Definition: Tag key. Range: A tag key can contain a maximum of 128 Unicode characters and cannot be left blank. Each tag key of a resource must be unique. The value can contain: Letters Digits Special characters: underscores (_), periods (.), colons (:), plus signs (+), hyphens (-), and equal signs (=) Chinese characters
value	String	Definition: Tag value. Range: Each value can contain a maximum of 255 Unicode characters and can be left blank. The value can contain: Letters Digits Special characters: underscores (_), periods (.), colons (:), plus signs (+), hyphens (-), and equal signs (=) Chinese characters

**Table 7** FirewallAssociation
Parameter	Type	Description
virsubnet_id	String	Definition: ID of the subnet associated with the network ACL. Range: If the network ACL type is normal, it can only be associated with common subnets. If the network ACL type is CloudDCN, it can only be associated with CloudDCN subnets.

**Table 8** FirewallRuleDetail
Parameter	Type	Description
id	String	Definition: Network ACL rule ID. Each network ACL rule comes with an ID, which uniquely identifies the network ACL rule. Range: The value is in UUID format with hyphens (-).
name	String	Definition: Network ACL rule name. Range: The value can contain 0 to 255 characters, including letters, digits, underscores (_), hyphens (-), and periods.
description	String	Definition: Supplementary information about the network ACL rule. Range: The value can contain 0 to 255 characters and cannot contain angle brackets (< or >).
action	String	Definition: Whether a network ACL rule allows or denies traffic. Range: allow: A network ACL rule allows traffic. deny: A network ACL rule denies traffic.
project_id	String	Definition: ID of the project that the network ACL rule belongs to. Range: N/A
protocol	String	Definition: Communication protocol of a network ACL rule. Range: tcp udp icmp icmpv6 IP protocol number (0-255) any: any protocol
ip_version	Integer	Definition: IP address version of a network ACL rule. Range: 4: IPv4 network ACL rule. 6: IPv6 network ACL rule.
source_ip_address	String	Definition: Source IP address or source IP address range of a network ACL rule. Range: source_ip_address and source_address_group_id cannot be specified at the same time.
destination_ip_address	String	Definition: Destination IP address or destination IP address range of a network ACL rule. Range: destination_ip_address and destination_address_group_id cannot be specified at the same time.
source_port	String	Definition: Source port of a network ACL rule. Range: Individual port: for example, 22 Consecutive ports: for example, 22-30 Non-consecutive ports: ports and port ranges, such as 22,23-30. You can specify up to 20 port ranges. Port ranges cannot overlap. All ports: Leave it empty or enter 1-65535.
destination_port	String	Definition: Destination port of a network ACL rule. Range: Individual port: for example, 22 Consecutive ports: for example, 22-30 Non-consecutive ports: ports and port ranges, such as 22,23-30. You can specify up to 20 port ranges. Port ranges cannot overlap. All ports: Leave it empty or enter 1-65535.
source_address_group_id	String	Definition: ID of the source IP address group of a network ACL rule. Range: source_ip_address and source_address_group_id cannot be specified at the same time.
destination_address_group_id	String	Definition: ID of the destination IP address group of a network ACL rule. Range: destination_ip_address and destination_address_group_id cannot be specified at the same time.
enabled	Boolean	Definition: Whether a network ACL rule is enabled. Range: true: (default value) A network ACL rule is enabled. false: A network ACL rule is disabled.

Example Requests

Associate the subnet whose ID is 8359e5b0-353f-4ef3-a071-98e67a34a143 with the network ACL whose ID is e9a7731d-5bd9-4250-a524-b9a076fd5629.

PUT https://{Endpoint}/v3/{project_id}/vpc/firewalls/e9a7731d-5bd9-4250-a524-b9a076fd5629/associate-subnets

{
  "subnets" : [ {
    "virsubnet_id" : "8359e5b0-353f-4ef3-a071-98e67a34a143"
  } ]
}

Example Responses

Status code: 200

Normal response to the PUT operation. For more status codes, see Status Codes.

{
  "firewall" : {
    "id" : "e9a7731d-5bd9-4250-a524-b9a076fd5629",
    "name" : "network_acl_test1",
    "description" : "network_acl_test1",
    "project_id" : "9476ea5a8a9849c38358e43c0c3a9e12",
    "created_at" : "2022-04-07T07:30:46.000+00:00",
    "updated_at" : "2022-04-07T07:30:46.000+00:00",
    "admin_state_up" : true,
    "enterprise_project_id" : "158ad39a-dab7-45a3-9b5a-2836b3cf93f9",
    "status" : "ACTIVE",
    "tags" : [ ],
    "ingress_rules" : [ {
      "id" : "774cf578-e70d-ec11-a40c-b864b1cf74ea",
      "name" : "network_acl_rule test",
      "description" : "network_acl_rule test",
      "action" : "allow",
      "project_id" : "9476ea5a8a9849c38358e43c0c3a9e12",
      "protocol" : "tcp",
      "ip_version" : 4,
      "source_ip_address" : "192.168.3.0/24",
      "destination_ip_address" : "192.168.6.0/24",
      "source_port" : "30-40,60-90",
      "destination_port" : "40-60,70-90"
    } ],
    "egress_rules" : [ {
      "id" : "f9a7731d-5bd9-4250-a524-b9a076fd5629",
      "name" : "network_acl_rule test",
      "description" : "network_acl_rule test",
      "action" : "allow",
      "project_id" : "9476ea5a8a9849c38358e43c0c3a9e12",
      "protocol" : "tcp",
      "ip_version" : 4,
      "source_ip_address" : "192.168.3.0/24",
      "destination_ip_address" : "192.168.6.0/24",
      "source_port" : "30-40,60-90",
      "destination_port" : "40-60,70-90"
    } ],
    "associations" : [ {
      "virsubnet_id" : "8359e5b0-353f-4ef3-a071-98e67a34a143"
    } ]
  }
}