Condividi tramite


Communication Services - Link Notification Hub

Collegare l'hub di notifica
Collega un hub di notifica di Azure a questo servizio di comunicazione.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
communicationServiceName
path True

string

Nome della risorsa CommunicationService.

Criterio di espressione regolare: ^[-\w]+$

resourceGroupName
path True

string

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

uuid

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
connectionString True

string

Stringa di connessione per l'hub di notifica

resourceId True

string

ID risorsa dell'hub di notifica

Risposte

Nome Tipo Descrizione
200 OK

LinkedNotificationHub

Successo. L'hub di notifica è stato collegato.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Esempio di richiesta

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

{
  "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"
}

Risposta di esempio

{
  "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"
  }
}

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

LinkedNotificationHub

Hub di notifica collegato al servizio di comunicazione

LinkNotificationHubParameters

Descrizione di un hub di notifica di Azure da collegare al servizio di comunicazione

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

LinkedNotificationHub

Hub di notifica collegato al servizio di comunicazione

Nome Tipo Descrizione
resourceId

string

ID risorsa dell'hub di notifica

LinkNotificationHubParameters

Descrizione di un hub di notifica di Azure da collegare al servizio di comunicazione

Nome Tipo Descrizione
connectionString

string

Stringa di connessione per l'hub di notifica

resourceId

string

ID risorsa dell'hub di notifica