getNetworkAclList

Prev Next

Available in VPC

Get the list of network ACLs based on the conditions the user specifies.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET, POST /getNetworkAclList

Request headers

For information about the headers common to all VPC APIs, see VPC common headers.

Request query parameters

The following describes the parameters.

Field Type Required Description
regionCode String Optional Region code where you want to query the network ACL list
  • First Region of the query result (default)
  • Check through getRegionList.
  • networkAclName String Optional Query the list with the network ACL name.
    networkAclStatusCode String Optional Query the list with the network ACL status code.
    • INIT | SET | RUN | TERMTING
    networkAclNoList.N List<String> Optional Query the list with the network ACL number.
    • networkAclNo can be obtained through getNetworkAclList.
    • Example: networkAclNoList.1=1234&networkAclNoList.2=2345
    pageNo Integer Optional Page numbers in paged results
    • Page the result values using pageNo and pageSize.
    pageSize Integer Conditional
    vpcNo String Optional Query the list with the VPC number.
    responseFormatType String Optional Format of the response result
    • xml (default) | json

    Request example

    The request example is as follows:

    curl --location 'https://ncloud.apigw.ntruss.com/vpc/v2/getNetworkAclList
    ?regionCode=KR
    &networkAclName=test-***
    &networkAclStatusCode=RUN
    &networkAclNoList.1=***31
    &vpcNo=***04' 
    --header 'x-ncp-apigw-timestamp: {Timestamp}' 
    --header 'x-ncp-iam-access-key: {Sub Account Access Key}' 
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
    

    Response

    This section describes the response format.

    Response body

    See NetworkAclList for the response body.

    Response status codes

    For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.

    Response example

    The response example is as follows:

    <getNetworkAclListResponse>
      <requestId>dc9325b1-a000-4db5-ac28-e33819b910eb</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <networkAclList>
        <networkAcl>
          <networkAclNo>***31</networkAclNo>
          <networkAclName>test-***</networkAclName>
          <vpcNo>***04</vpcNo>
          <networkAclStatus>
            <code>RUN</code>
            <codeName>run</codeName>
          </networkAclStatus>
          <networkAclDescription></networkAclDescription>
          <createDate>2020-07-31T14:29:14+0900</createDate>
          <isDefault>false</isDefault>
        </networkAcl>
      </networkAclList>
    </getNetworkAclListResponse>