Freigeben über


Communication Services - Link Notification Hub

Linkbenachrichtigungshub
Verknüpft einen Azure Notification Hub mit diesem Kommunikationsdienst.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}/linkNotificationHub?api-version=2023-03-31

URI-Parameter

Name In Erforderlich Typ Beschreibung
communicationServiceName
path True

string

Der Name der CommunicationService-Ressource.

RegEx-Muster: ^[-\w]+$

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

uuid

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
connectionString True

string

Verbindungszeichenfolge für den Notification Hub

resourceId True

string

Die Ressourcen-ID des Notification Hubs

Antworten

Name Typ Beschreibung
200 OK

LinkedNotificationHub

Erfolg. Der Notification Hub wurde verknüpft.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Beispiele

Beispielanforderung

POST https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/communicationServices/MyCommunicationResource/linkNotificationHub?api-version=2023-03-31

{
  "resourceId": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyOtherResourceGroup/providers/Microsoft.NotificationHubs/namespaces/MyNamespace/notificationHubs/MyHub",
  "connectionString": "Endpoint=sb://MyNamespace.servicebus.windows.net/;SharedAccessKey=abcd1234"
}

Beispiel für eine Antwort

{
  "resourceId": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyOtherResourceGroup/providers/Microsoft.NotificationHubs/namespaces/MyNamespace/notificationHubs/MyHub"
}
{
  "error": {
    "code": "WrongSubscription",
    "message": "The notification hub must be in the same subscription as the communication service"
  }
}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

LinkedNotificationHub

Ein Notification Hub, der mit dem Kommunikationsdienst verknüpft wurde

LinkNotificationHubParameters

Beschreibung einer Azure Notification Hub-Instanz zum Verknüpfen mit dem Kommunikationsdienst

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

LinkedNotificationHub

Ein Notification Hub, der mit dem Kommunikationsdienst verknüpft wurde

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID des Notification Hubs

LinkNotificationHubParameters

Beschreibung einer Azure Notification Hub-Instanz zum Verknüpfen mit dem Kommunikationsdienst

Name Typ Beschreibung
connectionString

string

Verbindungszeichenfolge für den Notification Hub

resourceId

string

Die Ressourcen-ID des Notification Hubs