Compartilhar via


NotificationEndPoint

O ponto de extremidade pelo qual as notificações sobre o estado do trabalho são enviadas.

Esse tipo foi adicionado aos Serviços de Mídia versão 2.1.

Observação

A notificação de fila do Azure pode sofrer atraso.

Este tópico oferece uma visão geral da entidade NotificationEndPoint e também demonstra como executar várias operações com a API REST dos Serviços de Mídia.

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades da entidade NotificationEndPoint

Propriedade Type Descrição
ID

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.
Edm.String Identificador exclusivo. Formato: nb:ncid:UUID:<GUID>.
Nome

Obrigatórios.
Edm.String Nome de exibição do ponto de extremidade de notificação.
Criado

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.
Edm.DateTime Esse valor é definido pelos Serviços de Mídia no momento da criação.
EndpointType

Obrigatórios. Não pode ser atualizada após a criação da entidade.
Edm.Int32 Tipo do ponto de extremidade da notificação.

O único valor válido é: AzureQueue = 1.
EndpointAddress

Obrigatórios. Não pode ser atualizada após a criação da entidade.
Edm.String EndpointAddress é o nome da AzureQueue a ser usada. As regras de nomenclatura da fila do Azure são impostas. Para obter mais informações, confira Nomeando filas e metadados.
CredentialType Edm.Int32 Defina o Tipo de credencial para o ponto de extremidade de notificação .
EncryptedEndPointCredential Edm.String A credencial do ponto de extremidade criptografado.
ProtectionKeyId Edm.String A ID da chave de proteção.
ProtectionKeyType Edm.Int32 O tipo de chave de proteção.

Criar um NotificationEndPoint

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

É possível criar um NotificationEndPoint usando a solicitação 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>  
  

Veja a seguir a resposta para a criação de 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://&lt;accountname&gt;.restv2.&lt;location&gt;.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://&lt;accountname&gt;.restv2.&lt;location&gt;.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://&lt;accountname&gt;.restv2.&lt;location&gt;.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 o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

É possível atualizar um NotificationEndPoint usando a solicitação 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://&lt;accountname&gt;.restv2.&lt;location&gt;.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>  
  

Veja a seguir a resposta para a atualização de 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 o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

A solicitação a seguir obtém o 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://&lt;accountname&gt;.restv2.&lt;location&gt;.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://&lt;accountname&gt;.restv2.&lt;location&gt;.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>  

Excluir um NotificationEndPoint

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

É possível excluir um NotificationEndPoint usando a solicitação 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  
  

Veja a seguir a resposta para a exclusão de 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