Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Функции API-интерфейса REST

 

Следующие функции поддержки Microsoft Azure Media Services сущностей по выполнению различных задач, таких как отмена заданий, получение ключей защиты и т. д.

CancelJob. Принимает следующие параметры: jobid из Edm.String типа.

GetProtectionKeyId. Принимает следующие параметры: contentKeyType из Edm.Int32 типа. Возвращает Edm.String.

GetProtectionKey. Принимает следующие параметры: protectionKeyId из Edm.String типа. Возвращает Edm.String.

CreateFileInfos. Принимает следующие параметры: assetid из Edm.String типа.

RebindContentKey. Принимает следующие параметры: идентификатор из Edm.String типа, x509Certificate из Edm.String типа. Возвращает Edm.String.

Publish. Принимает следующие параметры: assetid из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Asset типа.

GetKeyDeliveryUrl. Принимает следующие параметры: contentKey из Microsoft.Cloud.Media.Vod.Rest.Data.Models.ContentKey типа, keyDeliveryType из Edm.String типа. Возвращает Edm.Int32.

Start. Принимает следующие параметры: streamingEndpoint из Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint типа.

Start. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа.

Start. Принимает следующие параметры: программы из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program типа.

Stop. Принимает следующие параметры: streamingEndpoint из Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint типа.

Stop. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа.

Stop. Принимает следующие параметры: программы из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program типа.

Scale. Принимает следующие параметры: streamingEndpoint из Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint типа, scaleUnits из Edm.String типа.

ShowSlate. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа, длительность из Edm.Time типа, assetId из Edm.String типа.

StartAdvertisement. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа, длительность из Edm.Time типа, cueId из Edm.Int32 типа, showSlate из Edm.Boolean типа.

HideSlate. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа.

EndAdvertisement. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа, cueId из Edm.Int32 типа.

Reset. Принимает следующие параметры: канала из Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel типа.

System_CAPS_importantВажно

При работе с API REST служб мультимедиа следует руководствоваться следующими рекомендациями.

В остальной части раздела показано несколько примеров того, как вызывать функции, с помощью REST.

Выполнение заданий можно отменить вызовом CancelJob и передав идентификатор задания в данный момент выполняется задание.

Метод

URI запроса

Версия HTTP

ПОЛУЧИТЬ

https://Media.Windows.NET/API/CancelJob?JobId= "URL-адрес encodedvalue"

HTTP/1.1

System_CAPS_importantВажно

После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

Чтобы получить последнюю версию x-ms-version:, в разделе Справочник по API REST служб мультимедиа Azure.

GET https://media.windows.net/API/CancelJob?jobid='nb%3ajid%3aUUID%3a9e9533ba-2b9b-fa4c-a33d-73eebd49039b' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1336908753&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kolAgnFfbQIeRv4lWxKSFa4USyjWXRm15Kd%2bNd5g8eA%3d
Host: media.windows.net

Сущность «файл» создается с помощью функции CreateFileInfos и передачи в идентификатор ресурса, связанного с файлом мультимедиа, переданным в хранилище BLOB-объектов. Дополнительные сведения см. в разделе Отправить файл в хранилище BLOB-объектов.

Метод

URI запроса

Версия HTTP

ПОЛУЧИТЬ

https://Media.Windows.NET/API/CreateFileInfos?AssetId= "URL-адрес encodedvalue"

HTTP/1.1

System_CAPS_importantВажно

После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

Чтобы получить последнюю версию x-ms-version:, в разделе Справочник по API REST служб мультимедиа Azure.

GET https://media.windows.net/api/CreateFileInfos?assetid='nb%3Acid%3AUUID%3Ac80d312d-7cb1-44aa-bb23-2c35d10c44bd' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1336547485&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=ISzXspEIbgWifYYXqiPK1vo3%2bDHnTsX85umNxRjD3kQ%3d
Host: media.windows.net
Content-Length: 0

Функция GetProtectionKeyId получает отпечаток сертификата X.509, который позволяет обеспечить правильный сертификат, установлены на компьютере, при шифровании ключа содержимого определяемых пользователем. Список возможных значений для параметра contentkeytype сопоставляется со значениями перечислений ContentKeyType на сущности ContentKey. Дополнительные сведения см. в разделе свойства сущности ContentKey.

Метод

URI запроса

Версия HTTP

ПОЛУЧИТЬ

https://Media.Windows.NET/API/GetProtectionKeyId?contentKeyType=значение

HTTP/1.1

System_CAPS_importantВажно

После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

Чтобы получить последнюю версию x-ms-version:, в разделе Справочник по API REST служб мультимедиа Azure.

GET https://media.windows.net/API/GetProtectionKeyId?contentKeyType=1 HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1335862109&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=ErOpftkPKjzX3bdYcEUZTK9yAwKIDc20y0kxEBZLvCk%3d
Host: media.windows.net

GetProtectionKey получает указанный сертификат X.509, который должен использоваться для шифрования ключа содержимого определяемых пользователем.

Метод

URI запроса

Версия HTTP

ПОЛУЧИТЬ

https://Media.Windows.NET/API/GetProtectionKey?ProtectionKeyId= "значение"

HTTP/1.1

System_CAPS_importantВажно

После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

Чтобы получить последнюю версию x-ms-version:, в разделе Справочник по API REST служб мультимедиа Azure.

GET https://media.windows.net/API/GetProtectionKey?ProtectionKeyId='B2FE17BEF56FFCB9A3FC4267D0F2AFE25CD2DE22' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1335935139&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=s2dI0Ulkutx%2b5pTL0QGRnPQEv1Ogwz%2ff2SHRWK8bmyw%3d
Host: media.windows.net

Если вы хотите получить зашифрованный ключ контента обратно из Службы Media Services, необходимо вызвать RebindContentKey и передать идентификатор ContentKey и сертификата X.509 (с помощью открытого ключа), который использовался для шифрования содержимого ключей защиты шифрования или общего хранилища. Если вызвать RebindContentKey и передать пустую строку параметру x509Certificate, то ключ содержимого base64 и возвращаться в снимите флажок.

Метод

URI запроса

Версия HTTP

ПОЛУЧИТЬ

https://Media.Windows.NET/API/RebindContentKey?ID= "contentkeyid" & x509Certificate = "URL-адрес encodedvalue"

HTTP/1.1

System_CAPS_importantВажно

После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

Чтобы получить последнюю версию x-ms-version:, в разделе Справочник по API REST служб мультимедиа Azure.

GET https://media.windows.net/API/RebindContentKey?id='nb%3akid%3aUUID%3a2eeba14e-613e-4af7-a926-413372cca8d5'&x509Certificate='' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337251388&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=LdLXZO6LQ5vhvWfc%2bkL%2fYz%2fc3ZPf2v30h0LCCn2Kdis%3d
Host: media.windows.net
Показ: