Creación de un centro de notificaciones

Crea un nuevo centro de notificaciones, que contiene credenciales para los servicios de notificación de plataforma admitidos (WNS, APNS y GCM).

Solicitud

Método	URI de solicitud	Versión de HTTP
PUT	https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01	HTTP/1.1

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud	Descripción
Content-Type	application/xml;type=entry;charset=utf-8
Authorization	Token de SAS generado tal y como se especifica en Autenticación de firma de acceso compartido con Service Bus.
x-ms-version	2015-01

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una entrada Atom con un elemento NotificationHubDescription. Por ejemplo:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom">
<content type="application/xml">
    <NotificationHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
        <ApnsCredential>
            <Properties>
                <Property>
                    <Name>Endpoint</Name> 
                    <Value>gateway.push.apple.com</Value> 
                </Property>
                <Property>
                    <Name>ApnsCertificate</Name> 
                    <Value>{APNS certificate in Base64}</Value> 
                </Property>
                <Property>
                    <Name>CertificateKey</Name> 
                    <Value>{APNS certificate key}</Value> 
                </Property>
            </Properties>
        </ApnsCredential>
        <RegistrationTtl>P39D</RegistrationTtl> 
        <WnsCredential>
            <Properties>
                <Property>
                    <Name>PackageSid</Name> 
                    <Value>{PackageSid}</Value> 
                </Property>
                <Property>
                    <Name>SecretKey</Name> 
                    <Value>{SecretKey}</Value> 
                </Property>
            </Properties>
        </WnsCredential>
        <GcmCredential>
            <Properties>
                <Property>
                    <Name>GoogleApiKey</Name> 
                    <Value>{ApiKey}</Value> 
                </Property>
            </Properties>
        </GcmCredential>
        <MpnsCredential>
            <Properties>
                <Property>
                    <Name>MpnsCertificate</Name> 
                    <Value>{MPNS certificate in Base64}</Value> 
                </Property>
                <Property>
                    <Name>CertificateKey</Name> 
                    <Value>{MPNS certificate key}</Value> 
                </Property>
            </Properties>
        </MpnsCredential>
    </NotificationHubDescription>
</content></entry>

La propiedad endpoint de ApnsCredential puede ser gateway.push.apple.com (para servidores de producción) o gateway.sandbox.push.apple.com (para servidores de espacio aislado).

Todos los elementos secundarios de NotificationHubDescription son opcionales.

Las credenciales de WNS, APNS y GCM deben contener todas las propiedades mostradas anteriormente. Las credenciales de MPNS tampoco pueden contener propiedades, lo que habilita la inserción no autenticada para MPNS.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Código	Descripción
201	Tema de notificación creado correctamente.
400	Cuerpo de solicitud no válido. No se pudo crear el tema de notificación debido a que la solicitud era incorrecta (o no se pudo realizar la validación).
401	Error de autorización. La clave de acceso era incorrecta.
403	Cuota superada; hay demasiados centros de notificaciones en este espacio de nombres. Centro de notificaciones no creado.
409	El nodo ya contiene otra entidad.

Para obtener información sobre los códigos de estado, vea Códigos de estado y error.

Encabezados de respuesta

Ninguno.

Response body

Elemento NotificationHubDescription con todas las directivas definidas en el nodo actual.