Edge 조회
    • PDF

    Edge 조회

    • PDF

    기사 요약

    개요

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

    요청

    요청 URL

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

    요청 파라미터

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

    응답

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

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

    예시

    요청 예시

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

    응답 예시

    {
        "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"
                ]
            }
        }
    }
    

    오류 코드

    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.