Namespaces - Create Or Update Authorization Rule

Servizio:: Notification Hubs

Versione API:: 2023-09-01

Crea una regola di autorizzazione per uno spazio dei nomi

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/authorizationRules/{authorizationRuleName}?api-version=2023-09-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
authorizationRuleName	path	True	string minLength: 1 maxLength: 256 pattern: ^[a-zA-Z0-9!()*-._]+$	Nome regola di autorizzazione
namespaceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z][a-zA-Z0-9-]*$	Nome spazio dei nomi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	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 minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
location	string	Deprecato: solo per la compatibilità.
properties	SharedAccessAuthorizationRuleProperties	Proprietà SharedAccessAuthorizationRule.
tags	object	Deprecato: solo per la compatibilità.

Risposte

Nome	Tipo	Descrizione
200 OK	SharedAccessAuthorizationRuleResource	Aggiornato
201 Created	SharedAccessAuthorizationRuleResource	Creato
Other Status Codes	ErrorResponse	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

Namespaces_CreateOrUpdateAuthorizationRule

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/authorizationRules/sdk-AuthRules-1788?api-version=2023-09-01

{
  "properties": {
    "rights": [
      "Listen",
      "Send"
    ]
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "properties": {
    "rights": [
      "Listen",
      "Send"
    ],
    "modifiedTime": "2023-04-26T10:09:19.9675121+00:00",
    "createdTime": "2023-04-26T10:09:19.9675121+00:00"
  },
  "id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/authorizationRules/NewAuthorizationRule",
  "name": "NewAuthorizationRule",
  "type": "Microsoft.NotificationHubs/namespaces/authorizationRules"
}

Codice di stato:: 201

{
  "properties": {
    "rights": [
      "Listen",
      "Send"
    ],
    "modifiedTime": "2023-04-26T10:09:19.9675121+00:00",
    "createdTime": "2023-04-26T10:09:19.9675121+00:00"
  },
  "id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/authorizationRules/NewAuthorizationRule",
  "name": "NewAuthorizationRule",
  "type": "Microsoft.NotificationHubs/namespaces/authorizationRules"
}

Definizioni

Nome	Descrizione
AccessRights	Definisce i valori per AccessRights.
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
SharedAccessAuthorizationRuleProperties	Proprietà SharedAccessAuthorizationRule.
SharedAccessAuthorizationRuleResource	Risposta per le richieste POST che restituiscono single SharedAccessAuthorizationRule.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AccessRights

Enumerazione

Definisce i valori per AccessRights.

Valore	Descrizione
Manage
Send
Listen

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

SharedAccessAuthorizationRuleProperties

Object

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 (date-time)	Ottiene l'ora di creazione per questa regola
keyName	string	Ottiene una stringa che descrive la regola di autorizzazione.
modifiedTime	string (date-time)	Ottiene l'ora dell'ultima modifica 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 di accesso condiviso.
revision	integer (int32)	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 di accesso condiviso.

SharedAccessAuthorizationRuleResource

Object

Risposta per le richieste POST che restituiscono single SharedAccessAuthorizationRule.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Deprecato: solo per la compatibilità.
name	string	Nome della risorsa
properties	SharedAccessAuthorizationRuleProperties	Proprietà SharedAccessAuthorizationRule.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Deprecato: solo per la compatibilità.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Namespaces - Create Or Update Authorization Rule

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Namespaces_CreateOrUpdateAuthorizationRule

Esempio di richiesta

Risposta di esempio

Definizioni

AccessRights

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SharedAccessAuthorizationRuleProperties

SharedAccessAuthorizationRuleResource

systemData