v5.1_KMS

GET kms/config

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	GET

Returns a list of all KMS in the system, with its main configuration data.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config

Example Request

GET

https://192.168.10.53/api/5.1/kms/config

{
    "data": [
        {
            "uuid": "3fad1318-58f0-4023-9967-49dd3eb38308",
            "label": "atd",
            "created": "2023-08-24T12:24:53.674Z",
            "modified": "2023-08-24T12:24:53.674Z",
            "kms_type": "ATD-C",
            "attributes": {
                "host_url": "https://udrmv3.kaltura.com/cenc/widevine/encryption",
                "cpix_certificate": null,
                "use_cpix_encryption": false,
                "tls_certificate": null,
                "options": null,
                "asset_ids": [],
                "network": "f74cc09c-5ad0-4cf1-ae30-e8911fe7362d",
                "download_rate": "Disabled",
                "tls_private_key_set": false,
                "cpix_private_key_set": false
            }
        },
        {
            "uuid": "560360b0-8e2c-46c6-978b-dc62098c979d",
            "label": "sim1",
            "created": "2023-04-13T11:08:38.310Z",
            "modified": "2023-04-13T11:08:38.310Z",
            "kms_type": "Simulcrypt",
            "attributes": {
                "network": "2a62e295-f305-4d98-b6bb-237467f2221d"
            }
        }
    ],
    "metadata": {
        "item_count": 2,
        "total_items": 2,
        "current_page": 1,
        "sort_by": [
            {
                "label": "ASC"
            }
        ],
        "links": {
            "current": "http://192.168.10.53/api/5.1/kms/config"
        }
    }
}

GET kms/config/{uuid}

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	GET

Returns an extended single KMS configuration view, specified by the required {uuid} parameter.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config/{{uuid}}

Parameters

Parameter	Data Type	Description
uuid (required)	string	The UUID of the desired encoder.

Example Request

GET

https://192.168.10.53/api/5.1/kms/config/3fad1318-58f0-4023-9967-49dd3eb38308

{
    "data": {
        "uuid": "3fad1318-58f0-4023-9967-49dd3eb38308",
        "label": "atd",
        "created": "2023-08-24T12:24:53.674Z",
        "modified": "2023-08-24T12:24:53.674Z",
        "kms_type": "CPIX",
        "attributes": {
            "host_url": "https://udrmv3.kaltura.com/cenc/widevine/encryption",
            "certificate": null,
            "options": null,
            "asset_ids": [],
            "network": "f74cc09c-5ad0-4cf1-ae30-e8911fe7362d",
            "download_rate": "Disabled"
        }
    },
    "metadata": {}
}

GET kms/config/meta

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	GET

Returns all meta data used by KMS configuration.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config/meta

Example Request

GET

https://192.168.0.22/api/5.1/kms/config/meta

{
    "KmsTypes": [
        "Simulcrypt",
        "Huawei PlayReady",
        "Verimatrix, VMX",
        "Verimatrix, MultiRights",
        "SKY, CKS",
        "Irdeto",
        "ATD-C",
        "BISS-2",
        "SynMedia",
        "Axinom",
        "Static",
        "Kaltura UDRM",
        "BuyDRM",
        "M7",
        "WBD-XH"
    ]
}

DELETE kms/config/{uuid}

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	DELETE

Delete a specific KMS configuration.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config/{{uuid}}

Parameters

Parameter	Data Type	Description
uuid (required)	string	The UUID of the output to be deleted.

Example Request

DELETE

https://192.168.10.53/api/5.1/kms/config/c3060b16-493f-4528-aaf6-8a86a429e6c8

PUT kms/config/{uuid}

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	PUT

Edit a KMS configuration.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config/{{uuid}}

Parameters

Parameter	Data Type	Description
uuid (required)	byte	The UUID of the encoder to be edited.

Example Request

PUT

https://192.168.0.22/api/5.1/kms/config/07df0acc-d48a-487f-ab90-1a1d7bbf0f74

Body

Response

POST kms/config

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	POST

Add a new KMS, configured according to the attached data request.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config

Example Request

POST

https://192.168.10.53/api/5.1/kms/config

Body

Response

POST kms/config multi

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	POST

Add multiple KMS, configured according to the attached data request.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config

Example Request

POST

https://192.168.0.22/api/5.1/kms/config

Body

Response

PUT kms/config multi

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	PUT

Edit multiple KMS, configured according to the attached data request.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config

Example Request

PUT

https://192.168.0.22/api/5.1/kms/config

Body

Response

DELETE kms/config multi

Resource Information

Requires Authentication?	Yes
Response Formats	json
HTTP Methods	DELETE

Delete multiple KMS configuration.

Resource URL

https://{{ip_address}}:{{port}}/api/{{version}}/kms/config/{{uuid}}

Example Request

DELETE

https://192.168.0.22/api/5.1/kms/config

Body

Response