NotificationEndPoint
O ponto final para o qual são enviadas as notificações sobre o estado da tarefa.
Este tipo foi adicionado na versão 2.1 dos Serviços de Multimédia.
Nota
A notificação da fila do Azure pode ter algum atraso.
Este tópico fornece uma descrição geral da NotificationEndPoint entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.
Importante
Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).
Propriedades da Entidade NotificationEndPoint
| Propriedade | Tipo | Description |
|---|---|---|
| Id Só de leitura. Definido pelos Serviços de Multimédia no momento da criação. |
Edm.String | Identificador exclusivo. Formato: nb:ncid:UUID:<GUID>. |
| Name Obrigatório. |
Edm.String | Nome a apresentar do ponto final de notificação. |
| Criado Só de leitura. Definido pelos Serviços de Multimédia no momento da criação. |
Edm.DateTime | Este valor é definido pelos Serviços de Multimédia no momento da criação. |
| EndpointType Obrigatório. Não é possível atualizar após a criação da entidade. |
Edm.Int32 | Tipo de ponto final de notificação. O único valor válido é: AzureQueue = 1. |
| EndpointAddress Obrigatório. Não é possível atualizar após a criação da entidade. |
Edm.String | É EndpointAddress o nome de AzureQueue a utilizar. As regras de nomenclatura da fila do Azure são impostas. Para obter mais informações, veja Naming Queues and Metadata (Atribuir Nomes a Filas e Metadados). |
| CredentialType | Edm.Int32 | Defina o Tipo de credencial para o ponto final de notificação . |
| EncryptedEndPointCredential | Edm.String | A credencial do ponto final encriptado. |
| ProtectionKeyId | Edm.String | O ID da Chave de Proteção. |
| ProtectionKeyType | Edm.Int32 | O tipo de chave de proteção. |
Criar um NotificationEndPoint
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
O NotificationEndPoint pode estar a criar com o pedido HTTP POST.
POST https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints HTTP/1.1
User-Agent: Microsoft ADO.NET Data Services
DataServiceVersion: 1.0
MaxDataServiceVersion: 3.0
Accept: application/atom+xml,application/xml
Accept-Charset: UTF-8
Authorization: Bearer <token value>
x-ms-version: 2.19
Content-Type: application/atom+xml
Host: media.windows.net
Content-Length: 533
Expect: 100-continue
<?xml version="1.0" encoding="utf-8"?><entry xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"><id /><title /><updated>2013-04-21T21:44:14Z</updated><author><name /></author><content type="application/xml"><m:properties><d:EndPointAddress>endpointpueu1</d:EndPointAddress><d:EndPointType m:type="Edm.Int32">1</d:EndPointType><d:Id m:null="true" /><d:Name>EndPointName1</d:Name></m:properties></content></entry>
Segue-se a resposta para a criação do NotificationEndPoint:
HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Length: 1113
Content-Type: application/atom+xml;type=entry;charset=utf-8
Location: https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A1b373460-1fc4-4e80-aad6-b2b0cdb9e674')
Server: Microsoft-IIS/7.5
request-id: 9da4221a-7284-4767-905b-4a6823ae2f6f
x-ms-request-id: 9da4221a-7284-4767-905b-4a6823ae2f6f
X-Content-Type-Options: nosniff
DataServiceVersion: 1.0;
X-Powered-By: ASP.NET
Date: Sun, 21 Apr 2013 21:44:17 GMT
<?xml version="1.0" encoding="utf-8"?><entry xml:base="https://<accountname>.restv2.<location>.media.azure.net/api/" xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"><id>https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A1b373460-1fc4-4e80-aad6-b2b0cdb9e674')</id><category term="Microsoft.Cloud.Media.Vod.Rest.Data.Models.NotificationEndPoint" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /><link rel="edit" title="NotificationEndPoint" href="NotificationEndPoints('nb%3Anepid%3AUUID%3A1b373460-1fc4-4e80-aad6-b2b0cdb9e674')" /><title /><updated>2013-04-21T21:44:17Z</updated><author><name /></author><content type="application/xml"><m:properties><d:Id>nb:nepid:UUID:1b373460-1fc4-4e80-aad6-b2b0cdb9e674</d:Id><d:Name>EndPointName1</d:Name><d:Created m:type="Edm.DateTime">2013-04-21T21:44:16.4802609Z</d:Created><d:EndPointAddress>endpointpueu1</d:EndPointAddress><d:EndPointType m:type="Edm.Int32">1</d:EndPointType></m:properties></content></entry>
Atualizar um NotificationEndPoint
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
O NotificationEndPoint pode ser atualizado com o pedido HTTP POST.
MERGE https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A64bb03ea-bb6a-4d3c-b6e9-4a0f3e346638') HTTP/1.1
User-Agent: Microsoft ADO.NET Data Services
DataServiceVersion: 1.0
MaxDataServiceVersion: 3.0
Accept: application/atom+xml,application/xml
Accept-Charset: UTF-8
Authorization: Bearer <token value>
x-ms-version: 2.19
Content-Type: application/atom+xml
Host: media.windows.net
Content-Length: 690
Expect: 100-continue
<?xml version="1.0" encoding="utf-8"?><entry xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"><id>https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A64bb03ea-bb6a-4d3c-b6e9-4a0f3e346638')</id><title /><updated>2013-04-21T21:56:15Z</updated><author><name /></author><content type="application/xml"><m:properties><d:EndPointAddress>endpointqueue2</d:EndPointAddress><d:EndPointType m:type="Edm.Int32">1</d:EndPointType><d:Id>nb:nepid:UUID:64bb03ea-bb6a-4d3c-b6e9-4a0f3e346638</d:Id><d:Name>NewEndPoint1</d:Name></m:properties></content></entry>
Segue-se a resposta para a atualização do NotificationEndPoint:
HTTP/1.1 204 No Content
Cache-Control: no-cache
Server: Microsoft-IIS/7.5
request-id: 6e1533d9-1efc-4c45-b299-8060d2355e48
x-ms-request-id: 6e1533d9-1efc-4c45-b299-8060d2355e48
X-Content-Type-Options: nosniff
DataServiceVersion: 1.0;
X-Powered-By: ASP.NET
Date: Sun, 21 Apr 2013 21:56:16 GMT
Obter um NotificationEndPoint
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
O pedido seguinte obtém um ponto de notificação especificado. Para obter todas as chamadas NotificationEndPoints de pontos de notificação sem um parâmetro: GET https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints.
GET https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A6286704e-e69f-454e-80e0-7fda53ce7dba') HTTP/1.1
DataServiceVersion: 1.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
Accept: application/atom+xml,application/xml
Accept-Charset: UTF-8
User-Agent: Microsoft ADO.NET Data Services
Authorization: Bearer <token value>
x-ms-version: 2.19
Host: media.windows.net
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Length: 1167
Content-Type: application/atom+xml;type=entry;charset=utf-8
Server: Microsoft-IIS/7.5
request-id: aa32c140-8e59-4043-bbe8-c2221ca61a5f
x-ms-request-id: aa32c140-8e59-4043-bbe8-c2221ca61a5f
X-Content-Type-Options: nosniff
DataServiceVersion: 1.0;
X-Powered-By: ASP.NET
Date: Fri, 02 Aug 2013 06:25:33 GMT
<?xml version="1.0" encoding="utf-8"?><entry xml:base="https://<accountname>.restv2.<location>.media.azure.net/api/" xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"><id>https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A6286704e-e69f-454e-80e0-7fda53ce7dba')</id><category term="Microsoft.Cloud.Media.Vod.Rest.Data.Models.NotificationEndPoint" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /><link rel="edit" title="NotificationEndPoint" href="NotificationEndPoints('nb%3Anepid%3AUUID%3A6286704e-e69f-454e-80e0-7fda53ce7dba')" /><title /><updated>2013-08-02T06:25:33Z</updated><author><name /></author><content type="application/xml"><m:properties><d:Id>nb:nepid:UUID:6286704e-e69f-454e-80e0-7fda53ce7dba</d:Id><d:Name>62abde48-420f-4f76-9ca4-9ba1d8852f38</d:Name><d:Created m:type="Edm.DateTime">2013-08-02T06:25:02.48</d:Created><d:EndPointAddress>b71b6ac6-e598-4fdf-b5cb-e8494cb955ef</d:EndPointAddress><d:EndPointType m:type="Edm.Int32">1</d:EndPointType></m:properties></content></entry>
Eliminar um NotificationEndPoint
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
O NotificationEndPoint pode ser eliminado com o pedido HTTP POST.
DELETE https://<accountname>.restv2.<location>.media.azure.net/api/NotificationEndPoints('nb%3Anepid%3AUUID%3A64bb03ea-bb6a-4d3c-b6e9-4a0f3e346638') HTTP/1.1
User-Agent: Microsoft ADO.NET Data Services
DataServiceVersion: 1.0
MaxDataServiceVersion: 3.0
Accept: application/atom+xml,application/xml
Accept-Charset: UTF-8
Authorization: Bearer <token value>
x-ms-version: 2.19
Host: media.windows.net
Content-Length: 0
Segue-se a resposta para a eliminação do NotificationEndPoint:
HTTP/1.1 204 No Content
Cache-Control: no-cache
Server: Microsoft-IIS/7.5
request-id: f838c56f-d9f6-4e6f-8e0a-945d10a7a48c
x-ms-request-id: f838c56f-d9f6-4e6f-8e0a-945d10a7a48c
X-Content-Type-Options: nosniff
DataServiceVersion: 1.0;
X-Powered-By: ASP.NET
Date: Sun, 21 Apr 2013 21:56:17 GMT