NotificationEndPoint
El extremo al que se envían las notificaciones sobre el estado del trabajo.
Este tipo se agregó en la versión 2.1 de Media Services.
Nota:
La notificación de la cola de Azure puede tener algún retraso.
En este tema encontrará un resumen de la entidad NotificationEndPoint y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.
Importante
Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración para el desarrollo de api REST de Media Services y conexión a Media Services con la API REST de Media Services.
Propiedades de la entidad NotificationEndPoint
| Propiedad | Tipo | Descripción |
|---|---|---|
| Identificador Solo lectura. Establezca por Media Services en el momento de la creación. |
Edm.String | Identificador único. Formato: nb:ncid:UUID:<GUID>. |
| Nombre Necesario. |
Edm.String | Nombre para mostrar del extremo de notificación. |
| Creado Solo lectura. Establezca por Media Services en el momento de la creación. |
Edm.DateTime | Media Services establece este valor en el momento de la creación. |
| EndpointType Necesario. No se puede actualizar después de la creación de la entidad. |
Edm.Int32 | Tipo de extremo de notificación. El único valor válido es: AzureQueue = 1. |
| EndpointAddress Necesario. No se puede actualizar después de la creación de la entidad. |
Edm.String |
EndpointAddress es el nombre de AzureQueue que se debe usar. Se aplican las reglas de nomenclatura de la cola de Azure. Para obtener más información, vea Nomenclatura de colas y metadatos. |
| CredentialType | Edm.Int32 | Establezca el tipo de credencial para el punto de conexión de notificación . |
| EncryptedEndPointCredential | Edm.String | Credencial de EndPoint cifrada. |
| ProtectionKeyId | Edm.String | Identificador de clave de protección. |
| ProtectionKeyType | Edm.Int32 | Tipo de clave de protección. |
Crear un NotificationEndPoint
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Para crear un NotificationEndPoint, puede usar una solicitud 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>
A continuación puede ver la respuesta para la creación de un 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>
Actualizar un NotificationEndPoint
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Para actualizar un NotificationEndPoint, puede usar una solicitud 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>
A continuación puede ver la respuesta para la actualización de un 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
Obtener un NotificationEndPoint
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
La siguiente solicitud obtiene un punto de notificación específico. Para obtener todas las llamadas de NotificationEndPoints puntos de notificación sin un 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 un NotificationEndPoint
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Para eliminar un NotificationEndPoint, puede usar una solicitud 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
A continuación puede ver la respuesta para la eliminación de un 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