requestCdnPlusPurge

Classic/VPC 환경에서 이용 가능합니다.

특정 CDN+ 인스턴스에 대하여 전체 파일, 디렉토리 단위, 개별 파일에 대한 퍼지를 수행합니다.

구문

requestCdnPlusPurge 구문은 다음과 같습니다.

./ncloud cdn requestCdnPlusPurge \
    --cdnInstanceNo <cdn-instance-no> \
    --isWholePurge <true|false> \
    --isWholeDomain <true|false> \
    [--domainIdList <domain-id-list>] \
    [--targetDirectoryName <target-directory-name>] \
    [--targetFileList <target-file-list>] \
    [--output <json|xml>]

옵션

requestCdnPlusPurge 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

requestCdnPlusPurge의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--cdnInstanceNo`	String	Required	CDN+ 인스턴스 번호 getCdnPlusInstanceList 참조
`--isWholePurge`	Boolean	Required	전체 파일 퍼지 여부 `true` \| `false` `true`: 전체 파일 퍼지 수행. 전체 퍼지 수행 시 원본으로 요청이 증가하여 부하가 발생할 수 있음 `false`: 특정 파일 퍼지 수행
`--isWholeDomain`	Boolean	Required	전체 도메인 퍼지 여부 `true` \| `false` `true`: 전체 도메인 퍼지 수행 `false`: 특정 도메인 퍼지 수행 CDN+ 인스턴스 정보의 `isAvailablePartialDomainPurge` 값이 `false`인 경우 `true`로만 입력. getCdnPlusInstanceList 참조

선택 옵션

requestCdnPlusPurge의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--domainIdList`	List	Optional	도메인 ID 리스트 공백으로 구분하여 여러 개 입력 가능 (예시: `--domainIdList 1234 2345`) `isWholeDomain`=`false`인 경우, 입력 가능
`--targetDirectoryName`	String	Optional	대상 디렉터리명 `isWholePurge`=`false`이고, `domainIdList`가 입력된 경우, 입력 가능 `isWholePurge`=`false`인 경우, `targetDirectoryName`, `targetFileList` 중 하나는 필수 입력 `targetFileList`과 함께 입력할 수 없음
`--targetFileList`	List	Optional	대상 파일 리스트 `isWholePurge`=`false`이고, `domainIdList`가 입력된 경우, 입력 가능 `isWholePurge`=`false`인 경우, `targetDirectoryName`, `targetFileList` 중 하나는 필수 입력 `targetDirectoryName`과 함께 입력할 수 없음 한 번에 100개까지만 수행 가능

공통 옵션

cdn 명령에서 공통으로 사용하는 옵션에 대한 정보는 CDN+ 옵션을 참조해 주십시오.

예시

퍼지 요청이 성공하면 퍼지 이력 정보가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud cdn requestCdnPlusPurge \
    --cdnInstanceNo 456400 \
    --isWholePurge true \
    --isWholeDomain true \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "requestCdnPlusPurgeResponse": {
    "requestId": "927ce830-934f-42e5-9202-5b34c20b372f",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 3,
    "cdnPlusPurgeHistoryList": [
      {
        "cdnInstanceNo": "456400",
        "purgeId": "PT000000000000001510",
        "isWholePurge": true,
        "isWholeDomain": true,
        "cdnPlusServiceDomainList": [
          {
            "domainId": "CD000000000000006585",
            "serviceDomainTypeCode": "USER",
            "protocolTypeCode": "HTTP",
            "defaultDomainName": "bamupnqrzjwh456400.cdn.ntruss.com",
            "userDomainName": "ncp-cdn.c.navercdn.com"
          }
        ],
        "targetDirectoryName": "",
        "targetFileList": [],
        "requestDate": "2018-02-27T23:33:20+0900",
        "purgeStatusName": "ready"
      },
      {
        "cdnInstanceNo": "456400",
        "purgeId": "PT000000000000001509",
        "isWholePurge": true,
        "isWholeDomain": true,
        "cdnPlusServiceDomainList": [
          {
            "domainId": "CD000000000000006581",
            "serviceDomainTypeCode": "USER",
            "protocolTypeCode": "HTTP",
            "defaultDomainName": "piytcmfpkjvy456400.cdn.ntruss.com",
            "userDomainName": "ncp-cdn.b.navercdn.com"
          }
        ],
        "targetDirectoryName": "",
        "targetFileList": [],
        "requestDate": "2018-02-27T23:33:20+0900",
        "purgeStatusName": "ready"
      },
      {
        "cdnInstanceNo": "456400",
        "purgeId": "PT000000000000001508",
        "isWholePurge": true,
        "isWholeDomain": true,
        "cdnPlusServiceDomainList": [
          {
            "domainId": "CD000000000000006580",
            "serviceDomainTypeCode": "USER",
            "protocolTypeCode": "HTTP",
            "defaultDomainName": "qhytwoxdervh456400.cdn.ntruss.com",
            "userDomainName": "ncp-cdn.a.navercdn.com"
          }
        ],
        "targetDirectoryName": "",
        "targetFileList": [],
        "requestDate": "2018-02-27T23:33:20+0900",
        "purgeStatusName": "ready"
      }
    ]
  }
}