디지털 마스터 삭제 API

이 항목에서는 CMS API를 사용하여 비디오의 디지털 마스터를 삭제하는 방법에 대해 설명합니다.

서문

CMS API에는 Video Cloud 카탈로그에서 디지털 마스터 (비디오의 소스 파일) 를 삭제하는 기능이 있습니다. 이렇게하면 일회성 정리 작업을 수행하여 관리되는 콘텐츠의 크기를 줄일 수 있습니다.

마스터가 어떻게 보관되고, 마스터가 전혀 보관되지 않도록 할 수 있는지 알아보려면 (원하는 경우) 아카이빙 마스터를 참조하십시오 .

요구 사항

디지털 마스터 삭제는 다음을 사용하여 수행할 수 있습니다. 이 옵션은 Studio에서 사용할 수 없습니다. CMS API

마스터 삭제의 의미

계속하기 전에 디지털 마스터 삭제의 다음과 같은 의미를 이해해야합니다.

마스터가 삭제 된 후에는 더 이상 비디오를 다시 트랜스 코딩 할 수 없습니다. 새 렌디션이 필요한 경우 Studio또는동적 인제스트 API를 통해 비디오를 교체해야합니다.
일괄 프로비저닝 (지원 중단됨)을 통한 비디오 관리가 더 이상 작동하지 않습니다. 대신 CMS및동적 인제스트 API를 사용하세요.
디지털 마스터 삭제는영구적인작업입니다. 삭제된 디지털 마스터를복원할 수 없습니다.

단계: 디지털 마스터 삭제

디지털 마스터를 삭제하려면 다음 단계를 따르십시오.

확실히하다당신은 자신의 마스터 사본을 가지고 있습니다당신이 그것을 필요로하는 경우를 대비하여.
비디오를 다시 트랜스 코딩해야하는 경우 마스터를 삭제하기 전에이를 수행하십시오. 마스터가삭제되면 더 이상 비디오를 다시 트랜스코딩할 수 없습니다.

작업에 필요한 클라이언트 자격 증명을 얻습니다. 클라이언트 자격 증명에는 다음 작업에 대한 권한이 포함되어야합니다.

      [
          "video-cloud/asset/delete",
          "video-cloud/video/read"
      ]

이러한 권한은 Studio UI에서사용할 수 없으므로 OAuth API를사용하여 권한을 얻어야 합니다. 다음은 강조 표시된 항목을 자신의 정보로 바꾸면 작업을 수행하는 cURL 명령입니다.

      curl --request POST \
        --url https://oauth.brightcove.com/v4/client_credentials \
        --header 'authorization: BC_TOKEN YOUR_BC_TOKEN' \
        --header 'content-type: application/json' \
        --data '{
        "type": "credential",
        "maximum_scope": [
          {
            "identity": {
              "type": "video-cloud-account",
              "account-id": YOUR_ACCOUNT_ID
            },
            "operations": [
          "video-cloud/asset/delete",
          "video-cloud/video/read"
      ]
          }
        ],
        "name": "Delete-Masters"
      }'

BC_TOKEN을 얻으려면 Studio 페이지를 열고 (계정의 관리자 여야 함) 브라우저에서 자바 스크립트 콘솔을 열고 아래 자바 스크립트 코드를 붙여 넣은 다음 Enter 키를 누르세요.

      var cookiesArray = document.cookie.split(";"), cookiesObj = {}, i, tmpArray = [];
      for (i = 0; i < cookiesArray.length; i++) {
          tmpArray = cookiesArray[i].split("=");
          if (tmpArray[0].indexOf('BC_TOKEN') > -1) {
              cookiesObj.BC_TOKEN = tmpArray[1];
          }
      }
      window.prompt("BC_TOKEN:", cookiesObj.BC_TOKEN);

클라이언트 자격 증명을 사용하여 액세스 토큰을생성합니다.

이러한 엔드 포인트를 사용하여 디지털 마스터를 삭제하십시오.

마스터 삭제
기본 URL	`https://cms.api.brightcove.com/v1`
방법	`DELETE`
끝점	`/accounts/accountID/videos/videoID/digital_master`
머리글	`Authorization: Bearer Authorization: Bearer {access_token}`
대응	204 NO_CONTENT (204는 삭제 작업에 대한 표준 응답으로, 작업이 성공했거나 자산이 이미 삭제되었음을 나타냅니다.)