Notification Hubs - Create Or Update
Crea/aggiorna un oggetto NotificationHub in uno spazio dei nomi.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/notificationHubs/{notificationHubName}?api-version=2023-09-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
namespace
|
path | True |
string |
Nome spazio dei nomi Criterio di espressione regolare: |
notification
|
path | True |
string |
Nome hub di notifica Criterio di espressione regolare: |
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
subscription
|
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 |
---|---|---|---|
location | True |
string |
Posizione geografica in cui risiede la risorsa |
properties |
Proprietà di NotificationHub. |
||
sku |
Descrizione sku per uno spazio dei nomi |
||
tags |
object |
Tag delle risorse. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornato |
|
201 Created |
Data di creazione |
|
Other Status Codes |
Codice di errore con motivo. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
NotificationHubs_CreateOrUpdate
Esempio di richiesta
PUT https://management.azure.com/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/notificationHubs/nh-sdk-hub?api-version=2023-09-01
{
"location": "eastus",
"properties": {}
}
Risposta di esempio
{
"location": "East US",
"properties": {
"name": "test",
"registrationTtl": "10675199.02:48:05.4775807",
"dailyMaxActiveDevices": 0
},
"id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/notificationHubs/test",
"name": "test",
"type": "Microsoft.NotificationHubs/namespaces/notificationHubs",
"tags": {
"hubTag1": "hubTagValue1",
"hubTag2": "hubTagValue2"
}
}
{
"location": "East US",
"properties": {
"name": "test",
"registrationTtl": "10675199.02:48:05.4775807",
"dailyMaxActiveDevices": 0
},
"id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/notificationHubs/test",
"name": "test",
"type": "Microsoft.NotificationHubs/namespaces/notificationHubs",
"tags": {
"hubTag1": "hubTagValue1",
"hubTag2": "hubTagValue2"
}
}
Definizioni
Nome | Descrizione |
---|---|
Access |
Definisce i valori per AccessRights. |
Adm |
Descrizione di un AdmCredential di NotificationHub. |
Adm |
Descrizione di un AdmCredential di NotificationHub. |
Apns |
Descrizione di un ApnsCredential di NotificationHub. |
Apns |
Descrizione di un ApnsCredential di NotificationHub. |
Baidu |
Descrizione di un oggetto NotificationHub BaiduCredential. |
Baidu |
Descrizione di NotificationHub BaiduCredential. |
Browser |
Descrizione di un browser NotificationHubCredential. |
Browser |
Descrizione di un browser NotificationHubCredential. |
created |
Tipo di identità che ha creato la risorsa. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Gcm |
Descrizione di un GcmCredential di NotificationHub. |
Gcm |
Descrizione di un GcmCredential di NotificationHub. |
Mpns |
Descrizione di un mpnsCredential di NotificationHub. |
Mpns |
Descrizione di un mpnsCredential di NotificationHub. |
Notification |
Proprietà NotificationHub. |
Notification |
Risorsa hub di notifica. |
Shared |
Proprietà SharedAccessAuthorizationRule. |
Sku |
Descrizione sku per uno spazio dei nomi |
Sku |
Nome SKU dello spazio dei nomi. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Wns |
Descrizione di un WnsCredential di NotificationHub. |
Wns |
Descrizione di un WnsCredential di NotificationHub. |
Xiaomi |
Descrizione di una NotificaHub XiaomiCredential. |
Xiaomi |
Descrizione di NotificationHubCredentialProperties. |
AccessRights
Definisce i valori per AccessRights.
Nome | Tipo | Descrizione |
---|---|---|
Listen |
string |
|
Manage |
string |
|
Send |
string |
AdmCredential
Descrizione di un AdmCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un AdmCredential di NotificationHub. |
AdmCredentialProperties
Descrizione di un AdmCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
authTokenUrl |
string |
Ottiene o imposta l'URL del token di autorizzazione. |
clientId |
string |
Ottiene o imposta l'identificatore client. |
clientSecret |
string |
Ottiene o imposta la chiave di accesso segreto delle credenziali. |
ApnsCredential
Descrizione di un ApnsCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un ApnsCredential di NotificationHub. |
ApnsCredentialProperties
Descrizione di un ApnsCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
apnsCertificate |
string |
Ottiene o imposta il certificato APNS. |
appId |
string |
Ottiene o imposta la chiave dell'attestazione registrata (iss), il cui valore è l'ID team di 10 caratteri, ottenuto dall'account sviluppatore |
appName |
string |
Ottiene o imposta il nome dell'applicazione |
certificateKey |
string |
Ottiene o imposta la chiave del certificato. |
endpoint |
string |
Ottiene o imposta l'endpoint di questa credenziale. |
keyId |
string |
Ottiene o imposta una chiave di 10 caratteri (kid), ottenuta dall'account sviluppatore |
thumbprint |
string |
Ottiene o imposta l'identificazione personale del certificato APNS |
token |
string |
Ottiene o imposta il token di autenticazione del provider, ottenuto tramite l'account sviluppatore |
BaiduCredential
Descrizione di un oggetto NotificationHub BaiduCredential.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un oggetto NotificationHub BaiduCredential. |
BaiduCredentialProperties
Descrizione di NotificationHub BaiduCredential.
Nome | Tipo | Descrizione |
---|---|---|
baiduApiKey |
string |
Ottiene o imposta la chiave API baidu. |
baiduEndPoint |
string |
Ottiene o imposta l'endpoint baidu. |
baiduSecretKey |
string |
Ottiene o imposta la chiave privata baidu |
BrowserCredential
Descrizione di un browser NotificationHubCredential.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un browser NotificationHubCredential. |
BrowserCredentialProperties
Descrizione di un browser NotificationHubCredential.
Nome | Tipo | Descrizione |
---|---|---|
subject |
string |
Ottiene o imposta l'oggetto push Web. |
vapidPrivateKey |
string |
Ottiene o imposta la chiave privata VAPID. |
vapidPublicKey |
string |
Ottiene o imposta la chiave pubblica VAPID. |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
GcmCredential
Descrizione di un GcmCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un GcmCredential di NotificationHub. |
GcmCredentialProperties
Descrizione di un GcmCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
gcmEndpoint |
string |
Ottiene o imposta l'endpoint GCM. |
googleApiKey |
string |
Ottiene o imposta la chiave API Google. |
MpnsCredential
Descrizione di un mpnsCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un mpnsCredential di NotificationHub. |
MpnsCredentialProperties
Descrizione di un mpnsCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
certificateKey |
string |
Ottiene o imposta la chiave del certificato per questa credenziale. |
mpnsCertificate |
string |
Ottiene o imposta il certificato MPNS. |
thumbprint |
string |
Ottiene o imposta l'identificazione personale del certificato MPNS |
NotificationHubProperties
Proprietà NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
admCredential |
Descrizione di un AdmCredential di NotificationHub. |
|
apnsCredential |
Descrizione di un ApnsCredential di NotificationHub. |
|
authorizationRules |
Ottiene o imposta l'autorizzazioneRules dell'oggetto NotificationHub creato |
|
baiduCredential |
Descrizione di un oggetto NotificationHub BaiduCredential. |
|
browserCredential |
Descrizione di un browser NotificationHubCredential. |
|
dailyMaxActiveDevices |
integer |
|
gcmCredential |
Descrizione di un GcmCredential di NotificationHub. |
|
mpnsCredential |
Descrizione di un mpnsCredential di NotificationHub. |
|
name |
string |
Ottiene o imposta il nome di NotificationHub. |
registrationTtl |
string |
Ottiene o imposta l'oggetto RegistrationTtl dell'oggetto NotificationHub creato |
wnsCredential |
Descrizione di un WnsCredential di NotificationHub. |
|
xiaomiCredential |
Descrizione di una NotificaHub XiaomiCredential. |
NotificationHubResource
Risorsa hub di notifica.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Posizione geografica in cui vive la risorsa |
name |
string |
nome della risorsa. |
properties |
Proprietà NotificationHub. |
|
sku |
Descrizione sku per uno spazio dei nomi |
|
systemData |
Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy. |
|
tags |
object |
Tag di risorse. |
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
SharedAccessAuthorizationRuleProperties
Proprietà SharedAccessAuthorizationRule.
Nome | Tipo | Descrizione |
---|---|---|
claimType |
string |
Ottiene una stringa che descrive il tipo di attestazione |
claimValue |
string |
Ottiene una stringa che descrive il valore dell'attestazione |
createdTime |
string |
Ottiene il tempo creato per questa regola |
keyName |
string |
Ottiene una stringa che descrive la regola di autorizzazione. |
modifiedTime |
string |
Ottiene l'ultima volta modificata per questa regola |
primaryKey |
string |
Ottiene una chiave primaria a 256 bit con codifica base64 per la firma e la convalida del token di firma. |
revision |
integer |
Ottiene il numero di revisione per la regola |
rights |
Ottiene o imposta i diritti associati alla regola. |
|
secondaryKey |
string |
Ottiene una chiave primaria a 256 bit con codifica base64 per la firma e la convalida del token di firma. |
Sku
Descrizione sku per uno spazio dei nomi
Nome | Tipo | Descrizione |
---|---|---|
capacity |
integer |
Ottiene o imposta la capacità della risorsa |
family |
string |
Ottiene o imposta la famiglia di sku |
name |
Nome SKU dello spazio dei nomi. |
|
size |
string |
Ottiene o imposta le dimensioni dello SKU |
tier |
string |
Ottiene o imposta il livello di sku specifico |
SkuName
Nome SKU dello spazio dei nomi.
Nome | Tipo | Descrizione |
---|---|---|
Basic |
string |
|
Free |
string |
|
Standard |
string |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione di risorse (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima risorsa. |
WnsCredential
Descrizione di un WnsCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un WnsCredential di NotificationHub. |
WnsCredentialProperties
Descrizione di un WnsCredential di NotificationHub.
Nome | Tipo | Descrizione |
---|---|---|
certificateKey |
string |
Ges o imposta la chiave del certificato WNS. |
packageSid |
string |
Ottiene o imposta l'ID pacchetto per questa credenziale. |
secretKey |
string |
Ottiene o imposta la chiave privata. |
windowsLiveEndpoint |
string |
Ottiene o imposta l'endpoint Windows Live. |
wnsCertificate |
string |
Ottiene o imposta il certificato WNS. |
XiaomiCredential
Descrizione di una NotificaHub XiaomiCredential.
Nome | Tipo | Descrizione |
---|---|---|
properties |
Descrizione di un oggetto NotificationHub XiaomiCredentialProperties. |
XiaomiCredentialProperties
Descrizione di NotificationHubCredentialProperties.
Nome | Tipo | Descrizione |
---|---|---|
appSecret |
string |
Ottiene o imposta il segreto dell'app. |
endpoint |
string |
Ottiene o imposta l'endpoint del servizio Dip. |