MENU
      getAddressGroupList

        getAddressGroupList


        Article summary

        Available in Classic

        Get the list of address groups.

        Request

        The following describes the request format for the endpoint. The request format is as follows:

        MethodURI
        POST/{type}/{zone}/getAddressGroupList

        Request headers

        For headers common to Secure Zone APIs, see Secure Zone request headers.

        Request path parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        typeStringRequiredfirewall type provided by Secure Zone
        • szfw | psfw
          • szfw: Secure Zone Standard
          • psfw: Secure Zone Advanced
        zoneStringRequiredZone in which Secure Zone is configured
        • kr1 | kr2
          • kr1: KR-1 zone
          • kr2: KR-2 zone

        Request body

        The following describes the request body.

        FieldTypeRequiredDescription
        addressGroupNameStringOptionalAddress group name
        addressGroupNoIntegerOptionalUnique number assigned to the address group
        addressZoneStringOptionalInformation for the zone the address belongs to
        • sz | os | vm | db | vpn | lb | kr1
          • sz: Secure Zone
          • os: Object Storage
          • vm: VM
          • db: Cloud DB
          • vpn: SSL VPN or IPsec VPN
          • lb: Load Balancer
          • kr1: KR-1 zone
        countPerPageIntegerOptionalNumber of items per page
        • 20 (default)
        pageIntegerOptionalPage index
        • 1 (default)

        Request example

        The following is a sample request.

        curl --location --request POST 'https://securezonefirewall.apigw.ntruss.com/api/v2/szfw/kr2/getAddressGroupList'
        --header 'x-ncp-apigw-timestamp: {Timestamp}' \
        --header 'x-ncp-iam-access-key: {Access Key}' \
        --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
        --header 'x-ncp-mbr_no: {User number}' \
        --header 'Content-Type: application/json' \
        --data '{
            "countPerPage": 0,
            "page": 0
        }'
        Curl

        Response

        The following describes the response format.

        Response body

        The following describes the response body.

        FieldTypeRequiredDescription
        actionString-Request type
        returnCodeInteger-Response code
        returnMessageString-Response message
        totalCountInteger-Total number of address groups
        addressGroupList[]Array-List of address groups to view
        addressGroupList[].addressGroupNoInteger-Unique number assigned to the address group
        addressGroupList[].addressGroupNameString-Address group name
        addressGroupList[].descriptionString-Address group description
        addressGroupList[].memberNoString-User's NAVER Cloud Platform member ID
        addressGroupList[].instanceNoString-Contract number assigned when creating the instance
        addressGroupList[].addressList[]Array-Information about addresses that belong to the address group
        addressGroupList[].addressList[].addressNoInteger-Unique number assigned to the address
        addressGroupList[].addressList[].memberNoString-User's NAVER Cloud Platform member ID
        addressGroupList[].addressList[].instanceNoString-Contract number assigned when creating the instance
        addressGroupList[].addressList[].nameString-Address name
        addressGroupList[].addressList[].ipString-IP address
        addressGroupList[].addressList[].portInteger-Port number
        • It is displayed if addressZone is db and type is fqdn
        addressGroupList[].addressList[].typeString-Address type information
        • ipmask | fqdn
          • ipmask: address defined by IP address and subnet mask
          • fqdn: fully qualified domain name (full domain name)
        addressGroupList[].addressList[].addressZoneString-Information for the zone the address belongs to
        • sz | os | vm | db | vpn | lb | kr1
          • sz: Secure Zone
          • os: Object Storage
          • vm: VM
          • db: Cloud DB
          • vpn: SSL VPN or IPsec VPN
          • lb: Load Balancer
          • kr1: KR-1 zone
        addressGroupList[].addressList[].fqdnString-Full domain name (FQDN)
        • It is displayed if type is fqdn
        addressGroupList[].addressList[].dbAddressZoneBoolean-DB address zone status
        addressGroupList[].addressList[].maskBitInteger-Subnet mask bit value
        • It is displayed for the Secure Zone Advanced type
        addressGroupList[].addressZoneString-Information for the zone the address belongs to
        • sz | os | vm | db | vpn | lb | kr1
          • sz: Secure Zone
          • os: Object Storage
          • vm: VM
          • db: Cloud DB
          • vpn: SSL VPN or IPsec VPN
          • lb: Load Balancer
          • kr1: KR-1 zone
        addressGroupList[].associatedPoliciesCountInteger-Not use
        addressGroupList[].objectStorageBoolean-Whether to use Object Storage
        • true | false
          • true: Object Storage is used
          • false: Object Storage is not used

        Response status codes

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

        Response example

        The following is a sample example.

        {
            "action": "getAddressGroupList",
            "returnCode": 0,
            "returnMessage": "success",
            "totalCount": 2,
            "addressGroupList": [
                {
                    "addressGroupNo": 5452,
                    "addressGroupName": "dbgroup",
                    "description": "",
                    "memberNo": "2795985",
                    "instanceNo": "25200511",
                    "addressList": [
                        {
                            "addressNo": 3646,
                            "memberNo": "27***85",
                            "instanceNo": "25****11",
                            "name": "test-db-001",
                            "ip": "***.***.***.***",
                            "port": "3306",
                            "type": "fqdn",
                            "addressZone": "db",
                            "fqdn": "db-****.cdb.ntruss.com"
                        }
                    ],
                    "addressZone": "db",
                    "associatedPoliciesCount": 0,
                    "objectStorage": false
                },
                {
                    "addressGroupNo": 5438,
                    "addressGroupName": "grp1",
                    "description": "",
                    "memberNo": "27***85",
                    "instanceNo": "25****11",
                    "addressList": [
                        {
                            "addressNo": 3644,
                            "memberNo": "27***85",
                            "instanceNo": "25****11",
                            "name": "s1906cf93f79",
                            "ip": "***.***.***.***",
                            "type": "ipmask",
                            "addressZone": "sz"
                        }
                    ],
                    "addressZone": "sz",
                    "associatedPoliciesCount": 0,
                    "objectStorage": false
                }
            ]
        }
        JSON

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.