Condividi tramite


Communication Services - Regenerate Key

Rigenerare la chiave
Rigenerare la chiave di accesso CommunicationService. PrimaryKey e SecondaryKey non possono essere rigenerati contemporaneamente.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}/regenerateKey?api-version=2023-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
communicationServiceName
path True

string

Nome della risorsa CommunicationService.

Criterio di espressione regolare: ^[-\w]+$

resourceGroupName
path True

string

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

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Tipo Descrizione
keyType

KeyType

KeyType da rigenerare. Deve essere 'primary' o 'secondary'(senza distinzione tra maiuscole e minuscole).

Risposte

Nome Tipo Descrizione
200 OK

CommunicationServiceKeys

Rigenerare la richiesta di chiave è stata completata correttamente. La risposta contiene la nuova chiave.

Other Status Codes

ErrorResponse

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

Esempio

Regenerate key

Esempio di richiesta

POST https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/communicationServices/MyCommunicationResource/regenerateKey?api-version=2023-04-01

{
  "keyType": "Primary"
}

Risposta di esempio

{
  "primaryKey": "1234",
  "primaryConnectionString": "endpoint=http://example.com;accesskey=1234"
}

Definizioni

Nome Descrizione
CommunicationServiceKeys

Classe che rappresenta le chiavi di accesso di un oggetto CommunicationService.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

KeyType

KeyType da rigenerare. Deve essere 'primary' o 'secondary'(senza distinzione tra maiuscole e minuscole).

RegenerateKeyParameters

I parametri descrivono la richiesta di rigenerazione delle chiavi di accesso

CommunicationServiceKeys

Classe che rappresenta le chiavi di accesso di un oggetto CommunicationService.

Nome Tipo Descrizione
primaryConnectionString

string

Stringa di connessione CommunicationService costruita tramite primaryKey

primaryKey

string

Chiave di accesso primaria.

secondaryConnectionString

string

Stringa di connessione CommunicationService costruita tramite secondaryKey

secondaryKey

string

Chiave di accesso secondaria.

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.

KeyType

KeyType da rigenerare. Deve essere 'primary' o 'secondary'(senza distinzione tra maiuscole e minuscole).

Nome Tipo Descrizione
Primary

string

Secondary

string

RegenerateKeyParameters

I parametri descrivono la richiesta di rigenerazione delle chiavi di accesso

Nome Tipo Descrizione
keyType

KeyType

KeyType da rigenerare. Deve essere 'primary' o 'secondary'(senza distinzione tra maiuscole e minuscole).