Freigeben über

Managed Clusters - Get Command Result

Dienst:
AKS
API-Version:
2025-05-01

Ruft die Ergebnisse eines Befehls ab, der auf dem verwalteten Cluster ausgeführt wurde.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/commandResults/{commandId}?api-version=2025-05-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
commandId
 path True

string

ID des Befehls.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
resourceName
 path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

Der Name der verwalteten Clusterressource.
subscriptionId
 path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

RunCommandResult

Befehl abgeschlossen
202 Accepted

Angenommen

Header

Location: string
Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. Wenn der Cluster nicht vorhanden ist, wird 404 (Nicht gefunden) zurückgegeben.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

commandFailedResult
commandSucceedResult

commandFailedResult

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/commandResults/def7b3ea71bd4f7e9d226ddbc0f00ad9?api-version=2025-05-01

Beispiel für eine Antwort

Statuscode:
202 
location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/commandResults/0e9872e6629349dc865e27ee6f8bab2d?api-version=2025-05-01
Statuscode:
200 
{
  "id": "def7b3ea71bd4f7e9d226ddbc0f00ad9",
  "properties": {
    "provisioningState": "failed",
    "reason": "ImagePullBackoff"
  }
}

commandSucceedResult

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/commandResults/def7b3ea71bd4f7e9d226ddbc0f00ad9?api-version=2025-05-01

Beispiel für eine Antwort

Statuscode:
202 
location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/commandResults/0e9872e6629349dc865e27ee6f8bab2d?api-version=2025-05-01
Statuscode:
200 
{
  "id": "def7b3ea71bd4f7e9d226ddbc0f00ad9",
  "properties": {
    "provisioningState": "succeeded",
    "exitCode": 0,
    "startedAt": "2021-02-17T00:28:20Z",
    "finishedAt": "2021-02-17T00:28:33Z",
    "logs": "namespace dummy created"
  }
}

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort des Containerdiensts.
CloudErrorBody

Eine Fehlerantwort des Containerdiensts.
RunCommandResult

Befehlsergebnis ausführen.

CloudError

Objekt

Eine Fehlerantwort des Containerdiensts.

Name Typ Beschreibung
error

CloudErrorBody

Details zum Fehler.

CloudErrorBody

Objekt

Eine Fehlerantwort des Containerdiensts.

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.

RunCommandResult

Objekt

Befehlsergebnis ausführen.

Name Typ Beschreibung
id

string

Die Befehls-ID.
properties.exitCode

integer (int32)

Der Beendigungscode des Befehls
properties.finishedAt

string (date-time)

Der Zeitpunkt, zu dem der Befehl abgeschlossen ist.
properties.logs

string

Die Befehlsausgabe.
properties.provisioningState

string

Bereitstellungsstatus
properties.reason

string

Eine Erläuterung, warum "provisioningState" auf "failed" festgelegt ist (falls ja).
properties.startedAt

string (date-time)

Der Zeitpunkt, zu dem der Befehl gestartet wurde.