Share via

Notification - Get

  • Riferimento
Service:
API Management
API Version:
2022-08-01

Ottiene i dettagli della notifica specificata dal relativo identificatore.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}?api-version=2022-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
notificationName
 path True

NotificationName

Identificatore del nome della notifica.
resourceGroupName
 path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
serviceName
 path True

string

Nome del servizio di Gestione API.

Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$
subscriptionId
 path True

string

ID della sottoscrizione di destinazione.
api-version
 query True

string

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

NotificationContract

Il corpo della risposta contiene la notifica specificata.
Other Status Codes

ErrorResponse

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

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ApiManagementGetNotification

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage?api-version=2022-08-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage",
  "type": "Microsoft.ApiManagement/service/notifications",
  "name": "RequestPublisherNotificationMessage",
  "properties": {
    "title": "Subscription requests (requiring approval)",
    "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval.",
    "recipients": {
      "emails": [
        "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/contoso@live.com",
        "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/foobar!live",
        "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/foobar@live.com"
      ],
      "users": [
        "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
      ]
    }
  }
}

Definizioni

Nome Descrizione
ErrorFieldContract

Contratto campo di errore.
ErrorResponse

Risposta errore.
NotificationContract

Dettagli notifica.
NotificationName

Identificatore del nome della notifica.
RecipientsContractProperties

Contratto del parametro di notifica.

ErrorFieldContract

Contratto campo di errore.

Nome Tipo Descrizione
code

string

Codice di errore a livello di proprietà.
message

string

Rappresentazione leggibile dell'errore a livello di proprietà.
target

string

Nome della proprietà.

ErrorResponse

Risposta errore.

Nome Tipo Descrizione
error.code

string

Codice di errore definito dal servizio. Questo codice svolge la funzione di stato secondario per il codice di errore HTTP specificato nella risposta.
error.details

ErrorFieldContract[]

Elenco di campi non validi inviati nella richiesta, in caso di errore di convalida.
error.message

string

Rappresentazione leggibile dell'errore.

NotificationContract

Dettagli notifica.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

nome della risorsa.
properties.description

string

Descrizione della notifica.
properties.recipients

RecipientsContractProperties

Valori dei parametri del destinatario.
properties.title

string

Titolo della notifica.
type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

NotificationName

Identificatore del nome della notifica.

Nome Tipo Descrizione
AccountClosedPublisher

string

I destinatari e gli utenti di posta elettronica seguenti riceveranno notifiche tramite posta elettronica quando lo sviluppatore chiude il proprio account.
BCC

string

I destinatari seguenti riceveranno copie in carbonio cieco di tutti i messaggi di posta elettronica inviati agli sviluppatori.
NewApplicationNotificationMessage

string

I destinatari e gli utenti di posta elettronica seguenti riceveranno notifiche tramite posta elettronica quando le nuove applicazioni vengono inviate alla raccolta di applicazioni.
NewIssuePublisherNotificationMessage

string

I destinatari e gli utenti di posta elettronica seguenti riceveranno notifiche tramite posta elettronica quando viene inviato un nuovo problema o commento nel portale per sviluppatori.
PurchasePublisherNotificationMessage

string

I destinatari e gli utenti di posta elettronica seguenti riceveranno notifiche tramite posta elettronica relative alle nuove sottoscrizioni del prodotto API.
QuotaLimitApproachingPublisherNotificationMessage

string

I destinatari e gli utenti di posta elettronica seguenti riceveranno notifiche tramite posta elettronica quando l'utilizzo della sottoscrizione raggiunge la quota di utilizzo.
RequestPublisherNotificationMessage

string

I destinatari e gli utenti di posta elettronica seguenti riceveranno notifiche tramite posta elettronica sulle richieste di sottoscrizione per i prodotti API che richiedono l'approvazione.

RecipientsContractProperties

Contratto del parametro di notifica.

Nome Tipo Descrizione
emails

string[]

Elenco di messaggi di posta elettronica sottoscritti per la notifica.
users

string[]

Elenco di utenti sottoscritti per la notifica.