Compartir a través de


Leer las credenciales de Platform Notification Services (PNS)

Las API de Servicios de notificaciones push de nivel de espacio de nombres (PNS) están diseñadas para aplicaciones grandes que abarcan varios centros de conectividad. Permiten a los desarrolladores leer y actualizar fácilmente la configuración unificada de PNS para varios centros en el mismo espacio de nombres a la vez. Cuando las credenciales de PNS se han establecido en el nivel de espacio de nombres mediante este punto de conexión, todos los centros del espacio de nombres usarán las credenciales proporcionadas con la configuración del espacio de nombres. No se permitirán las creaciones de concentrador en el espacio de nombres con credenciales PNS. Cuando las credenciales de PNS se establecen primero en el nivel de centro, este punto de conexión ya no estará disponible.

Este tema es una referencia para obtener las credenciales de PNS unificadas para un espacio de nombres. Cuando las credenciales de PNS se establecen primero en el nivel de centro, este punto de conexión ya no estará disponible.

Solicitud

Método URI de solicitud Versión de HTTP
GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/NotificationHubPnsCredentials/?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
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

Ninguno.

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
400 Cuerpo de solicitud no válido. No se pudo leer la configuración porque la solicitud tenía un formato incorrecto (o se produjo un error en la validación).
401 Error de autorización. La clave de acceso era incorrecta.
403 Cuota superada.
404 Espacio de nombres no encontrado.

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

Encabezados de respuesta

Ninguno.

Response body

Elemento NotificationHubPnsCredentials que define las credenciales de todos los centros de conectividad del espacio de nombres.

<NotificationHubPnsCredentials 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>

</NotificationHubPnsCredentials>

Consulte también

Creación o actualización de credenciales de PNS de espacio de nombres
Métodos de la API rest