Create or update Streaming Locator

PUT

https://app.mk.io/api/v1/projects/:project_name/media/streamingLocators/:locator_name

PUT

/api/v1/projects/:project_name/media/streamingLocators/:locator_name

curl -X PUT https://app.mk.io/api/v1/projects/project_name/media/streamingLocators/locator_name \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "properties": {
    "assetName": "string",
    "streamingPolicyName": "string"
  }
}'

{
  "properties": {
    "assetName": "string",
    "streamingPolicyName": "string",
    "alternativeMediaId": "string",
    "contentId": "string",
    "contentKeys": [
      {
        "id": "string",
        "labelReferenceInStreamingPolicy": "string",
        "policyName": "string",
        "tracks": [
          {
            "trackSelections": [
              {
                "operation": {
                  "Equal": "string",
                  "Unknown": "string"
                },
                "property": "string",
                "value": "string"
              }
            ]
          }
        ],
        "type": "CommonEncryptionCenc",
        "value": "string"
      }
    ],
    "defaultContentKeyPolicyName": "string",
    "defaultManifestFilename": "string",
    "endTime": "2024-01-15T09:30:00Z",
    "filters": [
      "string"
    ],
    "provisioningState": "InProgress",
    "resourceState": "Creating",
    "startTime": "2024-01-15T09:30:00Z",
    "streamingLocatorId": "00000000-0000-0000-0000-000000000000",
    "suppressed": false
  },
  "id": "string",
  "name": "name",
  "systemData": {
    "createdAt": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "createdByType": "User",
    "internalId": "string",
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "type": "string"
}

Create or update a Streaming Locator. When updating a streaming locator, only start time, end time and suppressed can be modified.

RBAC Capability Required: ams.streaminglocator.create or ams.streaminglocator.update

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

locator_namestringRequired

Request

This endpoint expects an object.

propertiesobjectRequired

Properties for streaming locator

Response

Updated

propertiesobject

Properties for streaming locator

idstringOptionalRead-only

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

namestringOptionalRead-onlyformat: "^[^\^\'<>%&:\\?/*+]+$"1-260 characters

The name of the resource

systemDataobjectOptional

Metadata pertaining to creation and last modification of the resource.

typestringOptionalRead-only

The type of the resource. E.g. "Microsoft.Media/mediaservices/assets"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error