Fonctions de l'API REST
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Fonctions de l'API REST

 

Prise en charge des fonctions suivantes du Microsoft Azure Media Services entités en effectuant diverses tâches telles que l'annulation de travaux, lors de la récupération des clés de protection et ainsi de suite.

CancelJob. Utilise le paramètre suivant : jobid de Edm.String type.

GetProtectionKeyId. Utilise le paramètre suivant : contentKeyType de Edm.Int32 type. Retourne Edm.String.

GetProtectionKey. Utilise le paramètre suivant : protectionKeyId de Edm.String type. Retourne Edm.String.

CreateFileInfos. Utilise le paramètre suivant : assetid de Edm.String type.

RebindContentKey. Accepte les paramètres suivants : id de Edm.String type, x509Certificate de Edm.String type. Retourne Edm.String.

Publish. Utilise le paramètre suivant : assetid de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Asset type.

GetKeyDeliveryUrl. Accepte les paramètres suivants : contentKey de Microsoft.Cloud.Media.Vod.Rest.Data.Models.ContentKey type, keyDeliveryType de Edm.String type. Retourne Edm.Int32.

Start. Utilise le paramètre suivant : streamingEndpoint de Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint type.

Start. Utilise le paramètre suivant : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type.

Start. Utilise le paramètre suivant : programme de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program type.

Stop. Utilise le paramètre suivant : streamingEndpoint de Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint type.

Stop. Utilise le paramètre suivant : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type.

Stop. Utilise le paramètre suivant : programme de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program type.

Scale. Accepte les paramètres suivants : streamingEndpoint de Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint type, scaleUnits de Edm.String type.

ShowSlate. Accepte les paramètres suivants : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type, durée de Edm.Time type, assetId de Edm.String type.

StartAdvertisement. Accepte les paramètres suivants : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type, durée de Edm.Time type, cueId de Edm.Int32 type, showSlate de Edm.Boolean type.

HideSlate. Utilise le paramètre suivant : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type.

EndAdvertisement. Accepte les paramètres suivants : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type, cueId de Edm.Int32 type.

Reset. Utilise le paramètre suivant : channel de Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel type.

System_CAPS_importantImportant

Lors de l'utilisation de l'API REST Media Services, vous devez prendre en considération les aspects suivants :

Le reste de la rubrique affiche quelques exemples montrant comment appeler des fonctions à l'aide de REST.

Un travail en cours d'exécution peut être annulé en appelant CancelJob et en transmettant son ID.

Méthode

URI de demande

Version HTTP

get

https://Media.Windows.NET/API/CancelJob?JobID='URL-encodedvalue'

HTTP/1.1

System_CAPS_importantImportant

Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Pour obtenir les dernières x-ms-version:, consultez Référence de l'API REST Azure Media Services.

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

Une entité File est créée à l'aide de la fonction CreateFileInfos, en transmettant l'ID d'élément multimédia associé au fichier multimédia que vous avez chargé dans le stockage d'objets blob. Pour plus d'informations, consultez télécharger un fichier vers le stockage d'objets blob.

Méthode

URI de demande

Version HTTP

get

https://Media.Windows.NET/API/CreateFileInfos?AssetID='URL-encodedvalue'

HTTP/1.1

System_CAPS_importantImportant

Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Pour obtenir les dernières x-ms-version:, consultez Référence de l'API REST Azure Media Services.

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

La fonction GetProtectionKeyId récupère une empreinte de certificat X.509 utilisée pour vérifier que le certificat correct est installé sur votre ordinateur lors du chiffrement de la clé de contenu définie par l'utilisateur. Les valeurs possibles pour le paramètre contentKeyType sont mappées aux valeurs d'énumération ContentKeyType sur l'entité ContentKey. Pour plus d'informations, consultez Propriétés d'entité ContentKey.

Méthode

URI de demande

Version HTTP

get

https://Media.Windows.NET/API/GetProtectionKeyId?contentKeyType=valeur

HTTP/1.1

System_CAPS_importantImportant

Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Pour obtenir les dernières x-ms-version:, consultez Référence de l'API REST Azure Media Services.

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 récupère le certificat X.509 spécifique qui doit être utilisé pour chiffrer la clé de contenu définie par l'utilisateur.

Méthode

URI de demande

Version HTTP

get

https://Media.Windows.NET/API/GetProtectionKey?ProtectionKeyId='valeur'

HTTP/1.1

System_CAPS_importantImportant

Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Pour obtenir les dernières x-ms-version:, consultez Référence de l'API REST Azure Media Services.

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

Si vous souhaitez récupérer votre clé de contenu chiffré à partir de Media Services, puis appelez RebindContentKey et transmettez votre Id de ContentKey et le certificat X.509 (avec uniquement la clé publique) qui a été utilisé pour chiffrer les clés de contenu protection stockage désactivez le chiffrement commun. Si vous appelez RebindContentKey et transmettez une chaîne vide au paramètre x509Certificate, votre clé de contenu est encodée en Base64 et renvoyée en clair.

Méthode

URI de demande

Version HTTP

get

https://Media.Windows.NET/API/RebindContentKey?ID='contentkeyid' & x509Certificate ='URL-encodedvalue'

HTTP/1.1

System_CAPS_importantImportant

Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Pour obtenir les dernières x-ms-version:, consultez Référence de l'API REST Azure Media Services.

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
Afficher:
© 2016 Microsoft