MENU
      Edge 조회
        • PDF

        Edge 조회

        • PDF

        기사 요약

        개요

        생성된 CDN Edge 정보를 조회합니다.

        요청

        요청 URL

        GET
        https://edge.apigw.ntruss.com/api/v1/cdn-edges/{edgeId}
        Plain text

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        edgeIdYesLong생성된 Edge의 ID 정보

        응답

        모든 응답은 HTTP Status Code로 성공 또는 실패를 반환합니다.

        HTTP 상태 코드코드 메시지설명
        200Success조회 성공
        401Unauthorized인증 실패
        500Internal Server Error서버 오류

        예시

        요청 예시

        https://edge.apigw.ntruss.com/api/v1/cdn-edges/123
        Plain text

        응답 예시

        {
            "code": "0000",
            "message": "Success",
            "result": {
                "profileId": 234,
                "edgeName": "sample-edge",
                "distributionConfig": {
                    "protocolType": "ALL",
                    "regionType": "KOREA",
                    "serviceDomain": {
                        "domainType": "NCP_DOMAIN_AUTO",
                        "domainName": "lurn5qzs123.edge.naverncp.com"
                    },
                    "edgeLogging": {
                        "enabled": true,
                        "bucketPrefix": "log/sample",
                        "objectStorage": {
                            "region": "KR",
                            "bucketName": "sample-bucket"
                        }
                    }
                },
                "originalCopyConfig": {
                    "originalCopyLocation": {
                        "type": "OBJECT_STORAGE",
                        "region": "KR",
                        "bucketName": "sample-bucket"
                    },
                    "forwardHostHeader": {
                        "type": "ORIGIN_HOSTNAME"
                    },
                    "originalCopyProtocol": {
                        "type": "HTTP",
                        "port": 80
                    },
                    "originShield": {
                        "enabled": true,
                        "region": "USWN"
                    }
                },
                "cachingConfig": {
                    "defaultCaching": {
                        "enabled": true,
                        "ruleDefinitionType": "CACHING",
                        "cacheRevalidateConfig": {
                            "type": "IF_POSSIBLE",
                            "ageType": "HOURS",
                            "age": 10
                        }
                    },
                    "negativeTtl": true,
                    "bypassQueryString": {
                        "enabled": true,
                        "queryStrings": [
                            "aaa",
                            "bbb",
                            "ccc"
                        ]
                    },
                    "cacheKeyHostname": "INCOMING_HOST_HEADER",
                    "cacheKeyIgnoreQueryString": {
                        "type": "ALL_ALLOWED"
                    },
                    "removeVaryHeader": true,
                    "edgeAuth": {
                        "enabled": true,
                        "type": "SIGNED_URL",
                        "tokenKey": "902bceb96b2139771716910ff0b9befb",
                        "bypassValues":[".ts",".jpg",".exe"],
                        "tokenBypassValues":["playlist.m3u8","index.m3u8"]
                    }
                },
                "managedRule": {
                    "cors": true,
                    "http2": true,
                    "trueClientIpHeader": true,
                    "hsts": false
                },
                "headerPolicies": [
                    {
                        "type": "ORIGIN_REQUEST",
                        "ruleName": "Modify Origin Reqeust Header",
                        "header": {
                            "type": "ADD",
                            "name": "name",
                            "value": "value"
                        }
                    },
                    {
                        "type": "CLIENT_RESPONSE",
                        "ruleName": "Modify Client Response Header",
                        "header": {
                            "type": "MODIFY",
                            "name": "name",
                            "value": "value"
                        }
                    }
                ],
                "optimizationConfig": {
                    "httpCompression": true,
                    "largeFileOptimization": true
                },
                "accessControl": {
                    "type": "WHITELIST",
                    "ipPolicies": [
                        "1.1.1.1",
                        "2.2.2.2",
                        "3.3.3.3"
                    ],
                    "geoPolicies": [
                        "AL",
                        "SK",
                        "ZM"
                    ],
                    "refererPolicies": [
                        "ncloud.com",
                        "naver.com"
                    ]
                }
            }
        }
        JSON

        오류 코드

        Error 코드설명
        0032허용되지 않은 요청
        9999서버 오류 발생

        이 문서가 도움이 되었습니까?

        What's Next
        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.