你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
读取名称平台通知服务 (PNS) 凭据
命名空间级别推送通知服务 (PNS) API 专为跨多个中心的大型应用而设计。 它们使开发人员能够轻松读取和更新同一命名空间下多个中心的统一 PNS 设置。 使用此终结点在命名空间级别设置 PNS 凭据后,命名空间中的所有中心都将使用命名空间设置中提供的凭据。 不允许在命名空间中使用 PNS 凭据创建中心。 首先在中心级别设置 PNS 凭据时,此终结点将不再可用。
本主题是获取命名空间的统一 PNS 凭据的参考。 首先在中心级别设置 PNS 凭据时,此终结点将不再可用。
请求
方法 | 请求 URI | HTTP 版本 |
---|---|---|
GET | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/NotificationHubPnsCredentials/?api-version=2015-01 |
HTTP/1.1 |
请求标头
下表介绍必需的和可选的请求标头。
请求标头 | 说明 |
---|---|
授权 | 使用 服务总线进行共享访问签名身份验证中指定的生成的 SAS 令牌。 |
x-ms-version | 2015-01 |
请求正文
无。
响应
响应包括 HTTP 状态代码和一组响应标头。
响应代码
代码 | 说明 |
---|---|
400 | 请求正文无效。 无法读取设置,因为请求 (格式不正确或验证) 失败。 |
401 | 授权失败。 访问密钥不正确。 |
403 | 已超出配额。 |
404 | 找不到命名空间。 |
有关状态代码的信息,请参阅 状态和错误代码。
响应头
无。
响应正文
一个 NotificationHubPnsCredentials 元素,用于定义命名空间中所有中心的凭据。
<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>