匯出 (0) 列印
全部展開

ContentKey

更新日期: 2014年2月

ContentKey 提供資產的安全存取。除了建立 ContentKey 實體之外,您還必須使用保護金鑰將產生的內容金鑰加密。如需擷取保護金鑰的詳細資訊,請參閱Encrypt the Asset (Optional)REST API 函數

本主題概述 ContentKey 實體,也會示範如何使用 Media Services REST API 執行各種作業。

Important重要事項
使用 Media Services REST API 時,適用下列考量:

ContentKey 實體屬性

 

屬性 類型 說明

Id

必要。此值不是由 Media Services 設定。

Edm.String

使用者定義的唯一識別碼。

Created

唯讀。在建立時間由 Media Services 設定。

Edm.DateTime

此值是由 Media Services 在建立時設定。

LastModified

唯讀。由 Media Services 設定。

Edm.DateTime

Media Services 會在進行任何屬性變更之後更新此值。

ContentKeyType

選擇性。

Edm.Int32

指定內容金鑰類型的列舉值。有效值是:

  • CommonEncryption = 0

  • StorageEncryption = 1

  • ConfigurationEncryption = 2

EncryptedContentKey

選擇性。

Edm.String

使用 X.509 憑證之公開金鑰加密的內容金鑰。長度上限為 4000。

Name

選擇性。

Edm.String

ContentKey 的好記名稱。長度上限為 4000。

ProtectionKeyId

選擇性。

Edm.String

用來將儲存體、一般加密或組態加密金鑰加密之 X.509 憑證的指紋。呼叫 GetProtectionKeyId 函數時會傳回此值給您。長度上限為 4000。

ProtectionKeyType

選擇性。

Edm.Int32

指定保護金鑰類型的列舉值。有效值是:

  • X509CertificateThumbprint = 0

Checksum

選擇性。

Edm.String

ContentKey 的總和檢查碼。長度上限為 4000。

AuthorizationPolicyId

Edm.String

與 ContentKey 相關聯的授權原則識別碼。

建立 ContentKey

ContentKey 可以使用 POST HTTP 要求來建立。

 

方法 要求 URI HTTP 版本

POST

https://media.windows.net/API/ContentKeys

HTTP/1.1

範例要求

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

POST https://media.windows.net/api/ContentKeys 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=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334276569&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Cax61TKgo%2fLo5k6AWA%2brOLdAbMMd4poqvpVqiRPdTXk%3d
Host: media.windows.net
Content-Length: 572
Expect: 100-continue

{"Id" : "nb:kid:UUID:316d14d4-b603-4d90-b8db-0fede8aa48f8", "ContentKeyType" : 1, "EncryptedContentKey" : "Y4NPej7heOFa2vsd8ZEOcjjpu/qOq3RJ6GRfxa8CCwtAM83d6J2mKOeQFUmMyVXUSsBCCOdufmieTKi+hOUtNAbyNM4lY4AXI537b9GaY8oSeje0NGU8+QCOuf7jGdRac5B9uIk7WwD76RAJnqyep6U/OdvQV4RLvvZ9w7nO4bY8RHaUaLxC2u4aIRRaZtLu5rm8GKBPy87OzQVXNgnLM01I8s3Z4wJ3i7jXqkknDy4VkIyLBSQvIvUzxYHeNdMVWDmS+jPN9ScVmolUwGzH1A23td8UWFHOjTjXHLjNm5Yq+7MIOoaxeMlKPYXRFKofRY8Qh5o5tqvycSAJ9KUqfg==", "ProtectionKeyId" : "7D9BB04D9D0A4A24800CADBFEF232689E048F69C", "ProtectionKeyType" : 1, "Checksum" : "TfXtjCIlq1Y=" }

列出 ContentKey

ContentKey 是使用 GET HTTP 要求來擷取。

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/ContentKeys

HTTP/1.1

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/ContentKeys('contentkeyid')

HTTP/1.1

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/Assets('assetid')/ContentKeys

HTTP/1.1

範例要求

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

GET https://media.windows.net/API/ContentKeys('nb:kid:UUID:58b522a5-be4e-4988-8958-ee0cdb179273') 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=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334276569&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Cax61TKgo%2fLo5k6AWA%2brOLdAbMMd4poqvpVqiRPdTXk%3d
Host: media.windows.net

刪除 ContentKey

ContentKey 會透過 DELETE HTTP 要求來刪除。

 

方法 要求 URI HTTP 版本

DELETE

https://media.windows.net/API/ContentKeys('contentkeyid')

HTTP/1.1

範例要求

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

DELETE https://media.windows.net/API/ContentKeys('nb:kid:UUID:58b522a5-be4e-4988-8958-ee0cdb179273') 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=1337159050&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Pq9NUjGajGnOXSZQphVl2UsHeCdrxRiWbxTSv5n6cPY%3d
Host: media.windows.net
Content-Length: 0


另請參閱


建置日期:

2014-06-20

社群新增項目

顯示:
© 2014 Microsoft