REST API 函數
下列函式藉由執行各種工作來支援 Microsoft Azure 媒體服務 實體，例如取消作業、擷取保護密鑰等等。
CancelJob. 採用下列參數：type 的 Edm.Stringjobid。
GetProtectionKeyId. 採用下列參數：type 的 Edm.Int32contentKeyType。 傳回 Edm.String。
GetProtectionKey. 採用下列參數：type 的 Edm.StringprotectionKeyId。 傳回 Edm.String。
CreateFileInfos. 採用下列參數：類型的 assetidEdm.String。
RebindContentKey. 採用下列參數：類型的標識符Edm.String，類型為 x509CertificateEdm.String。 傳回 Edm.String。
Publish. 採用下列參數：類型的 assetidMicrosoft.Cloud.Media.Vod.Rest.Data.Models.Asset。
GetKeyDeliveryUrl. 採用下列參數：type 的 Microsoft.Cloud.Media.Vod.Rest.Data.Models.ContentKeycontentKey、type 的 Edm.StringkeyDeliveryType。 傳回 Edm.Int32。
Start. 採用下列參數：類型為 Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpointstreamingEndpoint。
Start. 採用下列參數：類型的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道。
Start. 採用下列參數：類型的程式Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program。
Stop. 採用下列參數：類型為 Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpointstreamingEndpoint。
Stop. 採用下列參數：類型的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道。
Stop. 採用下列參數：類型的程式Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program。
Scale. 採用下列參數：type 的 Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpointstreamingEndpoint、type 的 Edm.StringscaleUnits。
ShowSlate. 採用下列參數：類型的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道、類型持續時間Edm.Time、類型的 assetIdEdm.String。
StartAdvertisement. 採用下列參數：型別的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道、類型的持續時間Edm.Time、類型的 cueIdEdm.Int32、類型的 showSlateEdm.Boolean。
HideSlate. 採用下列參數：類型的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道。
EndAdvertisement. 採用下列參數：類型的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道、類型的 cueIdEdm.Int32。
Reset. 採用下列參數：類型的Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel通道。
重要
在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。
本主題的其餘部分示範如何使用 REST 呼叫函式的一些範例。
CancelJob
可以呼叫 CancelJob 並傳遞目前執行之工作 (Job) 的工作識別碼，以取消執行中的工作 (Job)。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/CancelJob?jobid>='URL-encodedvalue' | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
CreateFileInfos
使用 CreateFileInfos 函數並傳遞您上傳到 Blob 儲存體中之媒體檔案相關的資產識別碼，以建立 File 實體。 如需詳細資訊，請參閱檔案上傳至 Blob 儲存。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/CreateFileInfos?assetid>='URL-encodedvalue' | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
GetProtectionKeyId
GetProtectionKeyId 函數會擷取 X.509 憑證指紋，在將使用者定義的內容金鑰加密時，使用此指紋以確定電腦上安裝的是正確憑證。 ContentKeyType 參數的可能值對應至 ContentKey 實體上的 ContentKeyType 列舉值的清單。 如需詳細資訊，請參閱 ContentKey 實體屬性。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/GetProtectionKeyId?contentKeyType>=value | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
GetProtectionKey
GetProtectionKey 會擷取用來將您的使用者定義內容金鑰加密的特定 X.509 憑證。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/GetProtectionKey?ProtectionKeyId>='value' | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
RebindContentKey
如果您想要從媒體服務擷取加密的內容金鑰，請呼叫 RebindContentKey 並傳入您的 ContentKey Id 和 X.509 憑證 (，並只包含用來加密清除記憶體加密/一般保護內容密鑰的公鑰) 。 如果呼叫 RebindContentKey 並傳送空字串給 x509Certificate 參數，則您的內容金鑰為 base64 編碼，而且會以純文字方式傳回。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/RebindContentKey?id>='contentkeyid'&x509Certificate='URL-encodedvalue' | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net