Gateway - List Debug Credentials
Creare nuove credenziali di debug per il gateway.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/listDebugCredentials?api-version=2023-09-01-preview
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
gateway
|
path | True |
string |
Identificatore di entità del gateway. Deve essere univoco nell'istanza corrente del servizio Gestione API. Non deve avere il valore 'managed' |
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
service
|
path | True |
string |
Nome del servizio Gestione API. Criterio di espressione regolare: |
subscription
|
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 |
---|---|---|---|
apiId | True |
string |
ID risorsa completo di un'API. |
purposes | True |
Scopi della credenziale di debug. |
|
credentialsExpireAfter |
string |
Scadenza delle credenziali nel formato ISO8601. La durata massima delle credenziali è PT1H. Quando la proprietà non viene specificata, viene usato il valore PT1H. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Il corpo della risposta contiene le credenziali di debug da usare nel gateway. |
|
Other Status Codes |
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
ApiManagementGatewayListDebugCredentials
Esempio di richiesta
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/listDebugCredentials?api-version=2023-09-01-preview
{
"credentialsExpireAfter": "PT1H",
"apiId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
"purposes": [
"tracing"
]
}
Risposta di esempio
{
"token": "p=tracing&aid=a1&ex=20230504000000&sn=ZdfxSJoCsOJE0/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/8LchGl7gu/Q=="
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Gateway |
Credenziali di debug del gateway. |
Gateway |
Elencare le proprietà delle credenziali di debug. |
Gateway |
Scopi della credenziale di debug. |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
GatewayDebugCredentialsContract
Credenziali di debug del gateway.
Nome | Tipo | Descrizione |
---|---|---|
token |
string |
Token di debug del gateway. |
GatewayListDebugCredentialsContract
Elencare le proprietà delle credenziali di debug.
Nome | Tipo | Descrizione |
---|---|---|
apiId |
string |
ID risorsa completo di un'API. |
credentialsExpireAfter |
string |
Scadenza delle credenziali nel formato ISO8601. La durata massima delle credenziali è PT1H. Quando la proprietà non viene specificata, viene usato il valore PT1H. |
purposes |
Scopi della credenziale di debug. |
GatewayListDebugCredentialsContractPurpose
Scopi della credenziale di debug.
Nome | Tipo | Descrizione |
---|---|---|
tracing |
string |
Scopo della traccia. |