Поделиться через


Streaming Locators - Create

Создание указателя потоковой передачи в учетной записи Служб мультимедиа

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}?api-version=2022-08-01

Параметры URI

Имя В Обязательно Тип Описание
accountName
path True

string

Имя учетной записи Служб мультимедиа.

resourceGroupName
path True

string

Имя группы ресурсов в подписке Azure.

streamingLocatorName
path True

string

Имя указателя потоковой передачи.

subscriptionId
path True

string

Уникальный идентификатор подписки Microsoft Azure.

api-version
query True

string

Версия API, которая будет использоваться с клиентским запросом.

Текст запроса

Имя Обязательно Тип Описание
properties.assetName True

string

Имя ресурса

properties.streamingPolicyName True

string

Указатель потоковой передачи использует имя политики потоковой передачи. Можно указать имя созданной вами политики потоковой передачи или использовать одну из предопределенных политик. В настоящее время доступны следующие предопределенные политики потоковой передачи: Predefined_DownloadOnly, Predefined_ClearStreamingOnly, Predefined_DownloadAndClearStreaming, Predefined_ClearKey, Predefined_MultiDrmCencStreaming и Predefined_MultiDrmStreaming.

properties.alternativeMediaId

string

Альтернативный идентификатор носителя этого указателя потоковой передачи

properties.contentKeys

StreamingLocatorContentKey[]

Указатель потоковой передачи использует ContentKeys.

properties.defaultContentKeyPolicyName

string

Указатель потоковой передачи использует имя по умолчанию ContentKeyPolicy.

properties.endTime

string

Время окончания работы указателя потоковой передачи.

properties.filters

string[]

Список фильтров активов или учетных записей, которые применяются к этому указателю потоковой передачи.

properties.startTime

string

Время начала работы указателя потоковой передачи.

properties.streamingLocatorId

string

StreamingLocatorId указателя потоковой передачи.

Ответы

Имя Тип Описание
201 Created

StreamingLocator

Создание

Other Status Codes

ErrorResponse

Подробные сведения об ошибке.

Примеры

Creates a Streaming Locator with clear streaming
Creates a Streaming Locator with secure streaming
Creates a Streaming Locator with user defined content keys

Creates a Streaming Locator with clear streaming

Образец запроса

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/UserCreatedClearStreamingLocator?api-version=2022-08-01

{
  "properties": {
    "streamingPolicyName": "clearStreamingPolicy",
    "assetName": "ClimbingMountRainier"
  }
}

Пример ответа

{
  "name": "UserCreatedClearStreamingLocator",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/UserCreatedClearStreamingLocator",
  "type": "Microsoft.Media/mediaservices/streamingLocators",
  "properties": {
    "assetName": "ClimbingMountRainier",
    "created": "2018-08-08T18:29:32.4323237Z",
    "endTime": "9999-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "e34b0fc4-3be0-4a3c-9793-1f6b7be5b013",
    "streamingPolicyName": "clearStreamingPolicy",
    "contentKeys": []
  }
}

Creates a Streaming Locator with secure streaming

Образец запроса

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocator?api-version=2022-08-01

{
  "properties": {
    "streamingPolicyName": "UserCreatedSecureStreamingPolicy",
    "assetName": "ClimbingMountRainier",
    "startTime": "2018-03-01T00:00:00Z",
    "endTime": "2028-12-31T23:59:59.9999999Z"
  }
}

Пример ответа

{
  "name": "UserCreatedSecureStreamingLocator",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocator",
  "type": "Microsoft.Media/mediaservices/streamingLocators",
  "properties": {
    "assetName": "ClimbingMountRainier",
    "created": "2018-08-08T18:29:32.6243295Z",
    "startTime": "2018-03-01T00:00:00Z",
    "endTime": "2028-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "962775be-41fb-452a-b0dc-72ca2543a945",
    "streamingPolicyName": "UserCreatedSecureStreamingPolicy",
    "contentKeys": [
      {
        "id": "1b2d5581-4518-4a51-ad8a-f55d3bf993d4",
        "type": "CommonEncryptionCbcs",
        "labelReferenceInStreamingPolicy": "cbcsDefaultKey",
        "tracks": []
      },
      {
        "id": "1a9858b1-3566-4bf1-9fee-60f2fb98e7e4",
        "type": "CommonEncryptionCenc",
        "labelReferenceInStreamingPolicy": "cencDefaultKey",
        "tracks": []
      },
      {
        "id": "5faac86a-3aca-4d6b-99c0-6bb8cc3497a1",
        "type": "EnvelopeEncryption",
        "labelReferenceInStreamingPolicy": "aesDefaultKey",
        "tracks": []
      }
    ]
  }
}

Creates a Streaming Locator with user defined content keys

Образец запроса

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys?api-version=2022-08-01

{
  "properties": {
    "assetName": "ClimbingMountRainier",
    "streamingPolicyName": "secureStreamingPolicy",
    "streamingLocatorId": "90000000-0000-0000-0000-00000000000A",
    "contentKeys": [
      {
        "labelReferenceInStreamingPolicy": "aesDefaultKey",
        "id": "60000000-0000-0000-0000-000000000001",
        "value": "1UqLohAfWsEGkULYxHjYZg=="
      },
      {
        "labelReferenceInStreamingPolicy": "cencDefaultKey",
        "id": "60000000-0000-0000-0000-000000000004",
        "value": "4UqLohAfWsEGkULYxHjYZg=="
      },
      {
        "labelReferenceInStreamingPolicy": "cbcsDefaultKey",
        "id": "60000000-0000-0000-0000-000000000007",
        "value": "7UqLohAfWsEGkULYxHjYZg=="
      }
    ]
  }
}

Пример ответа

{
  "name": "UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys",
  "type": "Microsoft.Media/mediaservices/streamingLocators",
  "properties": {
    "assetName": "ClimbingMountRainier",
    "created": "2018-08-08T18:29:32.7859424Z",
    "endTime": "9999-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "90000000-0000-0000-0000-00000000000a",
    "streamingPolicyName": "secureStreamingPolicy",
    "contentKeys": [
      {
        "id": "60000000-0000-0000-0000-000000000007",
        "type": "CommonEncryptionCbcs",
        "labelReferenceInStreamingPolicy": "cbcsDefaultKey",
        "tracks": []
      },
      {
        "id": "60000000-0000-0000-0000-000000000004",
        "type": "CommonEncryptionCenc",
        "labelReferenceInStreamingPolicy": "cencDefaultKey",
        "tracks": []
      },
      {
        "id": "60000000-0000-0000-0000-000000000001",
        "type": "EnvelopeEncryption",
        "labelReferenceInStreamingPolicy": "aesDefaultKey",
        "tracks": []
      }
    ]
  }
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

StreamingLocator

Ресурс указателя потоковой передачи

StreamingLocatorContentKey

Класс для ключа содержимого в указателе потоковой передачи

StreamingLocatorContentKeyType

Тип шифрования ключа содержимого

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

TrackPropertyCompareOperation

Отслеживание операции с условием свойства

TrackPropertyCondition

Класс для указания одного условия свойства track

TrackPropertyType

Отслеживание типа свойства

TrackSelection

Класс для выбора дорожки

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект error.

StreamingLocator

Ресурс указателя потоковой передачи

Имя Тип Описание
id

string

Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Имя ресурса.

properties.alternativeMediaId

string

Альтернативный идентификатор носителя этого указателя потоковой передачи

properties.assetName

string

Имя ресурса

properties.contentKeys

StreamingLocatorContentKey[]

Указатель потоковой передачи использует ContentKeys.

properties.created

string

Время создания указателя потоковой передачи.

properties.defaultContentKeyPolicyName

string

Указатель потоковой передачи использует имя по умолчанию ContentKeyPolicy.

properties.endTime

string

Время окончания работы указателя потоковой передачи.

properties.filters

string[]

Список фильтров активов или учетных записей, которые применяются к этому указателю потоковой передачи.

properties.startTime

string

Время начала работы указателя потоковой передачи.

properties.streamingLocatorId

string

StreamingLocatorId указателя потоковой передачи.

properties.streamingPolicyName

string

Указатель потоковой передачи использует имя политики потоковой передачи. Можно указать имя созданной вами политики потоковой передачи или использовать одну из предопределенных политик. В настоящее время доступны следующие предопределенные политики потоковой передачи: Predefined_DownloadOnly, Predefined_ClearStreamingOnly, Predefined_DownloadAndClearStreaming, Predefined_ClearKey, Predefined_MultiDrmCencStreaming и Predefined_MultiDrmStreaming.

systemData

systemData

Системные метаданные, относящиеся к этому ресурсу.

type

string

Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts.

StreamingLocatorContentKey

Класс для ключа содержимого в указателе потоковой передачи

Имя Тип Описание
id

string

Идентификатор ключа содержимого

labelReferenceInStreamingPolicy

string

Метка ключа содержимого, указанная в политике потоковой передачи

policyName

string

ContentKeyPolicy, используемый ключом содержимого

tracks

TrackSelection[]

Отслеживает, в которых используется этот ключ содержимого

type

StreamingLocatorContentKeyType

Тип шифрования ключа содержимого

value

string

Значение ключа содержимого

StreamingLocatorContentKeyType

Тип шифрования ключа содержимого

Имя Тип Описание
CommonEncryptionCbcs

string

Общее шифрование с помощью CBCS

CommonEncryptionCenc

string

Общее шифрование с помощью CENC

EnvelopeEncryption

string

Шифрование конверта

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Удостоверение, которое последним изменял ресурс.

lastModifiedByType

createdByType

Тип удостоверения, которое последним изменял ресурс.

TrackPropertyCompareOperation

Отслеживание операции с условием свойства

Имя Тип Описание
Equal

string

Операция равенства

Unknown

string

Операция сравнения свойств неизвестной трассы

TrackPropertyCondition

Класс для указания одного условия свойства track

Имя Тип Описание
operation

TrackPropertyCompareOperation

Отслеживание операции с условием свойства

property

TrackPropertyType

Отслеживание типа свойства

value

string

Отслеживание значения свойства

TrackPropertyType

Отслеживание типа свойства

Имя Тип Описание
FourCC

string

Отслеживание FourCC

Unknown

string

Неизвестное свойство track

TrackSelection

Класс для выбора дорожки

Имя Тип Описание
trackSelections

TrackPropertyCondition[]

TrackSelections — это список условий свойств отслеживания, который может указывать дорожки