Notification Hubs - Create Or Update

Service:

Notification Hubs

API Version:

2023-09-01

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
namespaceName	path	True	string	Nome spazio dei nomi Regex pattern: ^[a-zA-Z][a-zA-Z0-9-]*$
notificationHubName	path	True	string	Nome hub di notifica Regex pattern: ^[a-zA-Z][a-zA-Z0-9-./_]*$
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta 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
location	True	string	Posizione geografica in cui risiede la risorsa
properties		NotificationHubProperties	Proprietà di NotificationHub.
sku		Sku	Descrizione sku per uno spazio dei nomi
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	NotificationHubResource	Aggiornato
201 Created	NotificationHubResource	Data di creazione
Other Status Codes	ErrorResponse	Codice di errore con motivo.

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

NotificationHubs_CreateOrUpdate

Sample Request

HTTP

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

Sample Response

Status code:

200

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

Status code:

201

{
  "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
AccessRights	Definisce i valori per AccessRights.
AdmCredential	Descrizione di un AdmCredential di NotificationHub.
AdmCredentialProperties	Descrizione di un AdmCredential di NotificationHub.
ApnsCredential	Descrizione di un ApnsCredential di NotificationHub.
ApnsCredentialProperties	Descrizione di un ApnsCredential di NotificationHub.
BaiduCredential	Descrizione di un oggetto NotificationHub BaiduCredential.
BaiduCredentialProperties	Descrizione di NotificationHub BaiduCredential.
BrowserCredential	Descrizione di un browser NotificationHubCredential.
BrowserCredentialProperties	Descrizione di un browser NotificationHubCredential.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GcmCredential	Descrizione di un GcmCredential di NotificationHub.
GcmCredentialProperties	Descrizione di un GcmCredential di NotificationHub.
MpnsCredential	Descrizione di un mpnsCredential di NotificationHub.
MpnsCredentialProperties	Descrizione di un mpnsCredential di NotificationHub.
NotificationHubProperties	Proprietà NotificationHub.
NotificationHubResource	Risorsa hub di notifica.
SharedAccessAuthorizationRuleProperties	Proprietà SharedAccessAuthorizationRule.
Sku	Descrizione sku per uno spazio dei nomi
SkuName	Nome SKU dello spazio dei nomi.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
WnsCredential	Descrizione di un WnsCredential di NotificationHub.
WnsCredentialProperties	Descrizione di un WnsCredential di NotificationHub.
XiaomiCredential	Descrizione di una NotificaHub XiaomiCredential.
XiaomiCredentialProperties	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	AdmCredentialProperties	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	ApnsCredentialProperties	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	BaiduCredentialProperties	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	BrowserCredentialProperties	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	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.

GcmCredential

Descrizione di un GcmCredential di NotificationHub.

Nome	Tipo	Descrizione
properties	GcmCredentialProperties	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	MpnsCredentialProperties	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	AdmCredential	Descrizione di un AdmCredential di NotificationHub.
apnsCredential	ApnsCredential	Descrizione di un ApnsCredential di NotificationHub.
authorizationRules	SharedAccessAuthorizationRuleProperties[]	Ottiene o imposta l'autorizzazioneRules dell'oggetto NotificationHub creato
baiduCredential	BaiduCredential	Descrizione di un oggetto NotificationHub BaiduCredential.
browserCredential	BrowserCredential	Descrizione di un browser NotificationHubCredential.
dailyMaxActiveDevices	integer
gcmCredential	GcmCredential	Descrizione di un GcmCredential di NotificationHub.
mpnsCredential	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	WnsCredential	Descrizione di un WnsCredential di NotificationHub.
xiaomiCredential	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	NotificationHubProperties	Proprietà NotificationHub.
sku	Sku	Descrizione sku per uno spazio dei nomi
systemData	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	AccessRights[]	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	SkuName	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	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	createdByType	Tipo di identità che ha modificato l'ultima risorsa.

WnsCredential

Descrizione di un WnsCredential di NotificationHub.

Nome	Tipo	Descrizione
properties	WnsCredentialProperties	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	XiaomiCredentialProperties	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.