Topics – Authorization Rules - Regenerate Keys

Rigenera le stringhe di connessione primaria o secondaria per l'argomento.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}/authorizationRules/{authorizationRuleName}/regenerateKeys?api-version=2021-11-01

Parametri dell'URI

Name In Required Type Description
authorizationRuleName
path True
  • string

Nome della regola di autorizzazione.

namespaceName
path True
  • string

Nome dello spazio dei nomi

resourceGroupName
path True
  • string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

subscriptionId
path True
  • string

Credenziali di sottoscrizione che identificano in modo univoco Microsoft Azure sottoscrizione. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

topicName
path True
  • string

Nome dell'argomento.

api-version
query True
  • string

Versione API client.

Corpo della richiesta

Name Required Type Description
keyType True

Chiave di accesso da rigenerare.

key
  • string

Facoltativo, se il valore della chiave specificato viene reimpostato per il valore KeyType o per il valore key di rigenerazione automatica impostato per keyType

Risposte

Name Type Description
200 OK

Le stringhe di connessione sono state rigenerate correttamente.

Other Status Codes

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

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

TopicAuthorizationRuleRegenerateKey

Sample Request

POST https://management.azure.com/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-ServiceBus-WestUS/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace8408/topics/sdk-Topics2075/authorizationRules/sdk-Authrules5067/regenerateKeys?api-version=2021-11-01
{
  "keyType": "PrimaryKey"
}

Sample Response

{
  "primaryConnectionString": "Endpoint=sb://sdk-namespace-6261.servicebus.windows-int.net/;SharedAccessKeyName=sdk-AuthRules-4310;SharedAccessKey=#############################################;EntityPath=sdk-Topics-1984",
  "secondaryConnectionString": "Endpoint=sb://sdk-namespace-6261.servicebus.windows-int.net/;SharedAccessKeyName=sdk-AuthRules-4310;SharedAccessKey=#############################################;EntityPath=sdk-Topics-1984",
  "primaryKey": "#############################################",
  "secondaryKey": "#############################################",
  "keyName": "sdk-AuthRules-4310"
}

Definizioni

AccessKeys

Spazio dei nomi/Stringa di connessione del bus di servizio

Error

Oggetto di errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorResponse

Risposta di errore di gestione delle risorse.

KeyType

Chiave di accesso da rigenerare.

RegenerateAccessKeyParameters

I parametri forniti all'operazione Rigenera regola di autorizzazione specificano quale chiave deve essere reimpostata.

AccessKeys

Spazio dei nomi/Stringa di connessione del bus di servizio

Name Type Description
aliasPrimaryConnectionString
  • string

Stringa di connessione primaria dell'alias se è abilitato il ripristino di emergenza geografico

aliasSecondaryConnectionString
  • string

Stringa di connessione secondaria dell'alias se è abilitato il ripristino di emergenza geografico

keyName
  • string

Stringa che descrive la regola di autorizzazione.

primaryConnectionString
  • string

Stringa di connessione primaria della regola di autorizzazione dello spazio dei nomi creata.

primaryKey
  • string

Chiave primaria a 256 bit con codifica Base 64 per la firma e la convalida del token di firma di accesso condiviso.

secondaryConnectionString
  • string

Stringa di connessione secondaria della regola di autorizzazione dello spazio dei nomi creata.

secondaryKey
  • string

Chiave primaria a 256 bit con codifica Base 64 per la firma e la convalida del token di firma di accesso condiviso.

Error

Oggetto di errore.

Name Type Description
additionalInfo

Informazioni aggiuntive sull'errore.

code
  • string

Codice di errore.

details

Dettagli dell'errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Name Type Description
info
  • object

Informazioni aggiuntive.

type
  • string

Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore di gestione delle risorse.

Name Type Description
error

Oggetto di errore.

KeyType

Chiave di accesso da rigenerare.

Name Type Description
PrimaryKey
  • string
SecondaryKey
  • string

RegenerateAccessKeyParameters

I parametri forniti all'operazione Rigenera regola di autorizzazione specificano quale chiave deve essere reimpostata.

Name Type Description
key
  • string

Facoltativo, se il valore della chiave specificato viene reimpostato per il valore KeyType o per il valore key di rigenerazione automatica impostato per keyType

keyType

Chiave di accesso da rigenerare.