Benachrichtigung Nachricht Telemetriedaten abrufen

  • Artikel

 

Diese API stellt zusätzliche Telemetrie auf die fertig Zustände ausgehenden Pushbenachrichtigungen bereit. Es dient Monitor Pushbenachrichtigungen von einem Hub gesendet. Die Benachrichtigungs-ID kann aus den HTTP-Location-Header in der Antwort auf eine sendeanforderung abgerufen werden.

Anforderung

Methode

Anforderungs-URI

HTTP-Version

GET

https://{Namespace}.Servicebus.Windows.NET/{NotificationHub}/Messages/{Notification-Nachrichten-Id}? api-Version = 2015-04

HTTP/1.1

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader

Beschreibung

Autorisierung

Gemäß der Shared Access Signature Authentifizierung mit generierte Token Servicebus, oder Servicebus Authentifizierung und Autorisierung über Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS).

x-ms-version

2015-04 (unterstützt durch 2015-01 oder höher)

Anforderungstext

Keine.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern. Antworttext bei Erfolg zurückgegeben.

Antwortcodes

Code

Beschreibung

200

Die Telemetrie, die Nachricht wurde erfolgreich abgerufen. Telemetriedaten möglicherweise eine partielle Antwort, abhängig von der Anzahl der Geräte, die das Ziel der Nachricht, die gesendet wurde.

400

Telemetrie Nachricht konnte nicht abgerufen werden, da die Anforderung falsch formatiert war.

401

Autorisierungsfehler Der Zugriffsschlüssel war falsch.

403

Die Anforderung abgelehnt, da diese Funktion nicht für die SKU aktiviert ist. Upgrade auf Standard.

404

Telemetrie ist nicht vorhanden. Dies wurde möglicherweise dadurch verursacht, da die benachrichtigungs-ID ungültig ist oder die Nachricht nicht weit genug in Verarbeitung fortgeschritten ist. Wenn Sie einen 404-Code erhalten, warten Sie, und versuchen Sie es nach 10 Sekunden. Dieser Zustand kann bis zu 30 Minuten weiter.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Antwortheader

Beschreibung

Content-type

Anwendung/Xml; Charset = Utf-8

Antworttext

Der Antworttext ein NotificationDetails Dokument besteht aus den folgenden Elementen.

Element

Beschreibung

Die benachrichtigungs-ID

Die ID der Anforderung, die die Benachrichtigung identifiziert übergeben.

Speicherort

URI für die Nachricht

US-Bundesstaat

Gibt den Fortschritt der Nachricht. Status kann einer der folgenden Werte sein:

  • In die Warteschlange eingereiht: Nachricht wurde akzeptiert, aber Verarbeitung noch nicht begonnen.

  • Verarbeitung: Nachrichtenverarbeitung wurde gestartet.

  • Abgeschlossen: Nachrichtenverarbeitung abgeschlossen wurde.

  •  Abgebrochen: Verarbeitung wurde abgebrochen. Dies ist der Fall bei
    die Nachricht konnte nicht verarbeitet werden, in das akzeptable Zeitfenster.
    Dies ist standardmäßig 30 Minuten.

  • Unbekannte: Verarbeitung von Nachrichten ist in einem unbekannten Status.

EnqueueTime

Gibt die Zeit an, die die Meldung akzeptiert wurde.

StartTime

Gibt an, die Hub-Benachrichtigungsdienst auf die Benachrichtigung beginnen.

EndTime

Gibt an, wenn der Hub-Benachrichtigungsdienst auf die Benachrichtigung abgeschlossen.

NotificationBody

Der Text der ursprünglichen Benachrichtigung.

TargetPlatforms

Gibt an, welche Plattformen von der Benachrichtigung gerichtet sind. Möglicherweise
die folgenden Werte als eine durch Trennzeichen getrennte Zeichenfolge:

  • Windows

  • Apple

  • GCM

  • Windows Phone

  • ADM

  • baidu

  • template

  • windowstemplate

  • appletemplate

  • gcmtemplate

  • windowsphonetemplate

  • admtemplate

  • baidutemplate

ApnsOutcomeCounts

Dieses Element wird für Benachrichtigungen an Apple Push Notification Service vorhanden sein.
Enthält eine Auflistung von Instanzen des Ergebnisses.

MpnsOutcomeCounts

Dieses Element wird für Benachrichtigungen an Microsoft Push Notification Service vorhanden sein.
Enthält eine Auflistung von Instanzen des Ergebnisses.

WnsOutcomeCounts

Dieses Element wird für Benachrichtigungen an Windows-Benachrichtigungsdienst vorhanden sein.
Enthält eine Auflistung von Instanzen des Ergebnisses.

GcmOutcomeCounts

Dieses Element wird für Benachrichtigungen an Google Cloud Messaging vorhanden sein.
Enthält eine Auflistung von Instanzen des Ergebnisses.

AdmOutcomeCounts

Dieses Element wird für Benachrichtigungen an Amazon Device Messaging vorhanden sein.
Enthält eine Auflistung von Instanzen des Ergebnisses.

Ergebnis

Eine Auflistung dieser Instanzen bilden die Zahlen über für jede Plattform Notification Service. Jedes Ergebnis kann eine der folgenden Zahlen benannten sein.

Name

Count-Beschreibung

AbandonedNotificationMessages

Anzahl der senden-Anforderungen Push-Dienst, der aufgrund eines Timeouts gelöscht wurden.

BadChannel

Kommunikation mit der pushdienst ist fehlgeschlagen, da der Kanal ungültig war.

ChannelDisconnected

Drücken Sie Dienst nicht getrennt.

ChannelThrottled

Pushdienst verweigert den Zugriff aufgrund einer Einschränkung.

Gelöscht

Pushdienst gibt an, dass die Nachricht gelöscht wurde.

ExpiredChannel

Kommunikation mit der pushdienst ist fehlgeschlagen, da der Kanal ist abgelaufen.

InvalidCredentials

Fehler bei der Authentifizierung für den pushdienst verwendete Anmeldeinformationen.

InvalidNotificationFormat

Push-Anforderung wurde für den pushdienst falsch formatiert.

InvalidNotificationSize

Push-Anforderung ist zu groß.

NoTargets

Die Anzahl der Anforderungen, die nichts an gefunden.

PnsInterfaceError

Drücken Sie die Kommunikation des Vertrags ist fehlgeschlagen.

PnsServerError

Pushdienst angegeben, dass auf ihrer Seite ein Fehler aufgetreten.

PnsUnavailable

Pushdienst ist nicht verfügbar.

PnsUnreachable

Pushdienst hat nicht reagiert.

Übersprungen

Die Anzahl der doppelten Registrierungen (gleiche PNS-handle gefunden, verschiedene Registrierungs-ID).

Erfolgreich

An mehrere Geräte die Anforderung erfolgreich gesendet.

Eingeschränkt

Pushdienst verweigert den Zugriff aufgrund einer Einschränkung.

UnknownError

Ein Unbekannter Fehler aufgetreten ist.

WrongToken

Das PNS-Handle wurde nicht als gültiges Handle vom PNS erkannt.

Im folgenden ist Beispiel Telemetriedaten aus eine Benachrichtigung an WNS gesendet.

<NotificationDetails xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <NotificationId>{Your message id}</NotificationId> <Location>sb://{Your namespace}.servicebus.windows.net/{your hub name}/messages/{your message id}?api-version=2015-04</Location> <State>Completed</State> <EnqueueTime>2015-11-02T21:19:43Z</EnqueueTime> <StartTime>2015-11-02T21:19:43.9926996Z</StartTime> <EndTime>2015-11-02T21:19:43.9926996Z</EndTime> <NotificationBody>&lt;?xml version="1.0" encoding="utf-16"?&gt;&lt;toast&gt;&lt;visual&gt;&lt;binding template="ToastText01"&gt;&lt;text id="1"&gt;Hello from a .NET App!&lt;/text&gt;&lt;/binding&gt;&lt;/visual&gt;&lt;/toast&gt;</NotificationBody> <TargetPlatforms>windows</TargetPlatforms> <WnsOutcomeCounts> <Outcome> <Name>Success</Name> <Count>3</Count> </Outcome> <Outcome> <Name>WrongToken</Name> <Count>1</Count> </Outcome> </WnsOutcomeCounts> </NotificationDetails>

Siehe auch

Systemeigene GCM-Benachrichtigung senden
Senden einer Vorlagenbenachrichtigung
Senden einer systemeigenen WNS-Benachrichtigung
Senden einer systemeigenen APNS-Benachrichtigung
Senden einer systemeigenen MPNS-Benachrichtigung