REST API 函式
本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

REST API 函式

 

下列函數支援 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重要事項

當使用媒體服務 REST API,適用下列考量:

  • 中存取實體時 媒體服務, ,您必須在 HTTP 要求中設定特定的標頭欄位和值。 如需詳細資訊,請參閱 媒體服務 REST API 開發設定。

  • 順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

    如需詳細資訊,請參閱 連線到媒體服務 REST api 的媒體服務。

本主題的其餘部分會顯示如何使用 REST 呼叫函式的幾個範例。

執行的作業可以取消呼叫 CancelJob 並傳遞目前執行中作業的作業識別碼。

方法

要求 URI

HTTP 版本

取得

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

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

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 儲存體的媒體檔案相關聯的資產識別碼,會建立 File 實體。 如需詳細資訊,請參閱 檔案上傳至 blob 儲存體。

方法

要求 URI

HTTP 版本

取得

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

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

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 參數對應至 ContentKey 實體上的 ContentKeyType 列舉值的可能值的清單。 如需詳細資訊,請參閱 ContentKey 實體屬性。

方法

要求 URI

HTTP 版本

取得

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

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

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 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

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

如果您想要擷取加密的內容金鑰從 媒體服務, ,呼叫 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 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

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