Freigeben über


Batch Account - Get Keys

Ruft die Kontoschlüssel für das angegebene Batchkonto ab.
Dieser Vorgang gilt nur für Batchkonten mit allowedAuthenticationModes, die "SharedKey" enthalten. Wenn das Batchkonto "SharedKey" nicht in seinem allowedAuthenticationMode enthält, können Clients keine gemeinsamen Schlüssel für die Authentifizierung verwenden und müssen stattdessen eine andere allowedAuthenticationModes verwenden. In diesem Fall schlägt das Abrufen der Schlüssel fehl.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/listKeys?api-version=2024-07-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-zA-Z0-9]+$

Der Name des Batchkontos.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die das Batchkonto enthält.

subscriptionId
path True

string

Die Azure-Abonnement-ID. Dies ist eine GUID-formatierte Zeichenfolge (z. B. 0000000-0000-0000-0000-0000000000000)

api-version
query True

string

Die API-Version, die mit der HTTP-Anforderung verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

BatchAccountKeys

Der Vorgang war erfolgreich. Die Antwort enthält die Schlüssel des Batchkontos.

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Microsoft Entra OAuth 2.0-Authentifizierungscodefluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

BatchAccountGetKeys

Beispielanforderung

POST https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/listKeys?api-version=2024-07-01

Beispiel für eine Antwort

{
  "accountName": "sampleacct",
  "primary": "AAAA==",
  "secondary": "BBBB=="
}

Definitionen

Name Beschreibung
BatchAccountKeys

Eine Reihe von Azure Batch-Kontoschlüsseln.

CloudError

Eine Fehlerantwort des Batchdiensts.

CloudErrorBody

Eine Fehlerantwort des Batchdiensts.

BatchAccountKeys

Eine Reihe von Azure Batch-Kontoschlüsseln.

Name Typ Beschreibung
accountName

string

Der Name des Batchkontos.

primary

string

Der Primärschlüssel, der dem Konto zugeordnet ist.

secondary

string

Der dem Konto zugeordnete sekundäre Schlüssel.

CloudError

Eine Fehlerantwort des Batchdiensts.

Name Typ Beschreibung
error

CloudErrorBody

Der Textkörper der Fehlerantwort.

CloudErrorBody

Eine Fehlerantwort des Batchdiensts.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

details

CloudErrorBody[]

Eine Liste mit zusätzlichen Details zum Fehler.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

target

string

Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.