Create Geo and CIDR map

Prev Next

Available in Classic and VPC

Create a Geo/CIDR map according to the specified conditions.

Request

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

Method URI
POST /maps

Request headers

For headers common to all Geo/CIDR map APIs, see Geo/CIDR map API common headers.

Request syntax

The request syntax is as follows.

{
    "detailedMapList": [
        {
            "content": "10.10.10.0/24",
            "geoIdMappings": [
                {
                    "geoName": "America",
                    "geoType": "NATION"
                }
            ],
            "name": "map1"
        }
    ],
    "mapType": "GEO",
    "name": "map1"
}

Request body

See MapRequest for the request body.

Request example

The following is a sample request.

curl --location --request POST 'https://globaltrafficmanager.apigw.ntruss.com/gtm/v1/maps' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
    "detailedMapList": [
        {
            "content": "**.10.**.0/**",
            "geoIdMappings": [
                {
                    "geoName": "Afghanistan",
                    "geoType": "NATION"
                }
            ],
            "name": "zone"
        }
    ],
    "mapType": "GEO",
    "name": "map000"
}'

Response

The following describes the response format.

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 response.

***

Error code example

The following is a sample error code.

{
  "result": "FAIL",
  "error": {
    "errorCode": "05X000",
    "message": "Invalid value.<br>Hover your mouse over the displayed area to see the details in a tooltip.",
    "devMessage": "Invalid value.",
    "moreInfo": {
      "validationInfo": [
        {
          "fieldPath": "detailedMapList[0].content",
          "msg": "No. 1: The subnet information is invalid. E.g., Valid subnets: 10.20.145.0/24,10.10.130.0/25 | Invalid subnets: 192.12.21.12/24"
        }
      ],
      "timestamp": "2022-11-16T19:17:59.594+09:00"
    }
  }
}