Экспорт (0) Печать
Развернуть все

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

Обновлено: Август 2014 г.

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

ImportantВажно!
При работе с API REST служб мультимедиа придерживайтесь следующих рекомендаций:

Запущенные задания можно отменить, вызвав сущность CancelJob и передав ИД задания текущего запущенного задания.

 

Метод URI-код запроса Версия HTTP

GET

https://media.windows.net/API/CancelJob?jobid='URL-encodedvalue'

HTTP/1.1

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

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.6
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 и передачи ИД ресурса, связанного с файлом мультимедиа, который был передан в хранилище больших двоичных объектов. Дополнительные сведения см. в разделе Передача файла в хранилище больших двоичных объектов.

 

Метод URI-код запроса Версия HTTP

GET

https://media.windows.net/api/CreateFileInfos?assetid='URL-encodedvalue'

HTTP/1.1

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

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.6
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

GET

https://media.windows.net/API/GetProtectionKeyId?contentKeyType=value

HTTP/1.1

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

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.6
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

GET

https://media.windows.net/API/GetProtectionKey?ProtectionKeyId='value'

HTTP/1.1

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

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.6
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

GET

https://media.windows.net/API/RebindContentKey?id='contentkeyid'&x509Certificate='URL-encodedvalue'

HTTP/1.1

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

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.6
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

См. также

Показ:
© 2014 Microsoft