ポリシーのコピー

Prev Next

Classic/VPC環境で利用できます。

既存の DRMポリシーをコピーして新しいポリシーを作成します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /api/v1/policy/{policyId}/copy

リクエストヘッダ

One Click Multi DRM APIで共通して使用されるヘッダの詳細は、One Click Multi DRMのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
policyId Integer Required DRMポリシー ID

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://multi-drm.apigw.ntruss.com/api/v1/policy/82/copy' \
--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' \
--header 'x-ncp-region_code: KR'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
success Boolean - API処理結果
  • true | false
    • true: 成功
    • false: 失敗
content Object - ポリシー情報
content.disabled Boolean - Sub Accountは無効化するか
  • true | false
    • true: 無効化
    • false: 有効化
content.policyId Integer - DRMポリシー ID
  • 0: Basic
content.policyName String - ポリシー名
content.policyStatus String - ポリシーの状態
  • CREATED | CREATING | READY | DELETED | UPDATING
    • CREATED: 作成完了
    • CREATING: 作成中
    • READY: 使用可能
    • DELETED: 削除完了
    • UPDATING: 更新中
content.policyCreatedTime Integer - ポリシーの作成日時(ミリ秒)
  • Unix Timestamp形式
content.policyUpdateTime Integer - ポリシーの更新日時(ミリ秒)
  • Unix Timestamp形式
content.persistent Boolean - オフライン用ライセンスを保存するか
  • true | false
    • true: ライセンスを維持
    • false: 再生後にライセンスを削除(ストリーミング)
content.rentalDuration Integer - オフラインライセンス取得後、コンテンツの初回再生の有効期間(秒)
content.playbackDuration Integer - コンテンツの初回再生開始時以降のライセンス有効期間(秒)
content.drmPolicyConfig Object - DRMタイプ別のポリシー設定
content.drmPolicyConfig.wideVine Object - Widevineタイプのポリシー
content.drmPolicyConfig.wideVine.useYn Boolean - Widevineポリシーを使用するか
  • true | false
    • true: 使用
    • false: 使用しない
content.drmPolicyConfig.wideVine.securityLevel Integer - Widevineセキュリティレベルの値
  • 1 | 2 | 3 | 4 | 5
    • 1: SW_SECURE_CRYPTO
    • 2: SW_SECURE_DECODE
    • 3: HW_SECURE_CRYPTO
    • 4: HW_SECURE_DECODE
    • 5: HW_SECURE_ALL (Widevine L1機器のみ再生可能)
  • 数字が大きいほどセキュリティレベルが高い
content.drmPolicyConfig.wideVine.hdcp String - デジタル出力のセキュリティ(HDCP)レベル
  • HDCP_NONE | HDCP_V1 | HDCP_V2 | HDCP_V2_1 | HDCP_V2_2 | HDCP_NO_DIGITAL_OUTPUT
  • バージョンが新しいほどセキュリティレベルが高い
content.drmPolicyConfig.wideVine.cgms String - アナログ出力のセキュリティ(CGMS-A)レベル
  • CGMS_NONE | COPY_FREE | COPY_ONCE | COPY_NEVER
content.drmPolicyConfig.wideVine.disableAnalogOutputYn Boolean - アナログ出力をブロックするか
  • true | false
    • true: ブロック
    • false: 許可
content.drmPolicyConfig.wideVine.hdcpSrmRule String - HDCP機器が SRM(System Renewability Message)を処理できない場合にそのトラックを再生するか
  • HDCP_SRM_RULE_NONE | CURRENT_SRM
    • HDCP_SRM_RULE_NONE: そのトラックを再生
    • CURRENT_SRM: そのトラックを再生しない
content.drmPolicyConfig.wideVine.deviceRevocation Boolean - Revoke (Widevineサポート対象から取り消された)Android機器に対するライセンス発行を許可するか
  • true | false
    • true: 許可
    • false: 許可しない
content.drmPolicyConfig.playReady Object - PlayReadyタイプのポリシー
content.drmPolicyConfig.playReady.useYn Boolean - PlayReadyポリシーを使用するか
  • true | false
    • true: 使用
    • false: 使用しない
content.drmPolicyConfig.playReady.securityLevel Integer - PlayReadyセキュリティレベルの値
  • 150 | 2000 | 3000
  • ハードウェア DRM適用時、3000に設定
  • 数字が大きいほどセキュリティレベルが高い
content.drmPolicyConfig.playReady.digitalVideoProtectionLevel Integer - デジタルビデオ出力のセキュリティレベル
  • 100 | 250 | 270 | 300 | 301
  • 数字が大きいほどセキュリティレベルが高い
content.drmPolicyConfig.playReady.analogVideoProtectionLevel Integer - アナログビデオ出力のセキュリティレベル
  • 100 | 150 | 200 | 201
  • 数字が大きいほどセキュリティレベルが高い
content.drmPolicyConfig.playReady.digitalAudioProtectionLevel Integer - デジタルオーディオ出力のセキュリティレベル
  • 100 | 250 | 300 | 301
  • 数字が大きいほどセキュリティレベルが高い
content.drmPolicyConfig.playReady.hdcpUseYn Boolean - OPL(出力保護レベル)設定により HDCPが適用される場合、Type 1(HDCP 2.2以降)が必要か
  • true | false
    • true: Type 1(HDCP 2.2以降)が必要
    • false: HDCPは必要なし
  • trueに設定すると HDCP 2.2以降に対応する機器のみコンテンツを再生できる
content.drmPolicyConfig.fairPlay Object - FairPlay Streamingタイプのポリシー
content.drmPolicyConfig.fairPlay.useYn Boolean - FairPlay Streamingポリシーを使用するか
  • true | false
    • true: 使用
    • false: 使用しない
content.drmPolicyConfig.fairPlay.hdcpEnforcement String - HDCPを適用するかどうかとバージョン
  • -1 | 0 | 1
    • -1: HDCP未適用
    • 0: HDCP Type 0 (バージョン関係なし)
    • 1: HDCP Type 1 (2.2以降が必要)
content.drmPolicyConfig.fairPlay.allowAirPlay Boolean - AirPlayを許可するか
  • true | false
    • true: 許可
    • false: 許可しない
content.drmPolicyConfig.fairPlay.allowAvAdaptor Boolean - デジタル AVアダプタを利用した出力を許可するか
  • true | false
    • true: 許可
    • false: 許可しない

レスポンスステータスコード

One Click Multi DRM APIで共通して使用されるレスポンスステータスコードの詳細は、One Click Multi DRMのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "success": true,
    "content": {
        "disabled": false,
        "policyId": 87,
        "policyName": "Copy_myPolicy",
        "policyStatus": "CREATED",
        "policyCreatedTime": 1760314185079,
        "policyUpdateTime": 1760314185089,
        "persistent": true,
        "rentalDuration": 10,
        "playbackDuration": 10,
        "drmPolicyConfig": {
            "wideVine": {
                "useYn": true,
                "securityLevel": 1,
                "hdcp": "HDCP_NONE",
                "cgms": "CGMS_NONE",
                "disableAnalogOutputYn": true,
                "hdcpSrmRule": "HDCP_SRM_RULE_NONE",
                "deviceRevocation": true
            },
            "playReady": {
                "useYn": true,
                "securityLevel": 150,
                "digitalVideoProtectionLevel": 100,
                "analogVideoProtectionLevel": 100,
                "digitalAudioProtectionLevel": 100,
                "hdcpUseYn": true
            },
            "fairPlay": {
                "useYn": true,
                "hdcpEnforcement": -1,
                "allowAirPlay": true,
                "allowAvAdaptor": true
            }
        }
    }
}