Condividi tramite


Gateway - Regenerate Key

Rigenera la chiave del gateway specificata invalidando tutti i token creati con esso.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/regenerateKey?api-version=2021-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
gatewayId
path True

string

Identificatore di entità del gateway. Deve essere univoco nell'istanza corrente del servizio di Gestione API. Non deve avere il valore 'managed'

resourceGroupName
path True

string

Nome del gruppo di risorse.

serviceName
path True

string

Nome del servizio di Gestione API.

Criterio di espressione regolare: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

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

api-version
query True

string

Versione dell'API da usare con la richiesta client.

Corpo della richiesta

Nome Necessario Tipo Descrizione
keyType True

KeyType

Chiave rigenerata.

Risposte

Nome Tipo Descrizione
204 No Content

Chiave rigenerata correttamente

Other Status Codes

ErrorResponse

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

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

ApiManagementGatewayRegenerateKey

Esempio di richiesta

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gwId/regenerateKey?api-version=2021-08-01

{
  "keyType": "primary"
}

Risposta di esempio

Definizioni

Nome Descrizione
ErrorFieldContract

Contratto campo di errore.

ErrorResponse

Risposta errore.

GatewayKeyRegenerationRequestContract

Proprietà del contratto di richiesta di rigenerazione della chiave del gateway.

KeyType

Chiave rigenerata.

ErrorFieldContract

Contratto campo di errore.

Nome Tipo Descrizione
code

string

Codice di errore a livello di proprietà.

message

string

Rappresentazione leggibile dell'errore a livello di proprietà.

target

string

Nome della proprietà.

ErrorResponse

Risposta errore.

Nome Tipo Descrizione
error.code

string

Codice di errore definito dal servizio. Questo codice svolge la funzione di stato secondario per il codice di errore HTTP specificato nella risposta.

error.details

ErrorFieldContract[]

Elenco di campi non validi inviati nella richiesta, in caso di errore di convalida.

error.message

string

Rappresentazione leggibile dell'errore.

GatewayKeyRegenerationRequestContract

Proprietà del contratto di richiesta di rigenerazione della chiave del gateway.

Nome Tipo Descrizione
keyType

KeyType

Chiave rigenerata.

KeyType

Chiave rigenerata.

Nome Tipo Descrizione
primary

string

secondary

string