Guest Agents - Get

Dienst:

Azure Arc enabled SCVMM

API-Version:

2024-06-01

Ruft GuestAgent ab.
Implementiert die GuestAgent GET-Methode.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.ScVmm/virtualMachineInstances/default/guestAgents/default?api-version=2024-06-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceUri	path	True	string	Der vollqualifizierte Azure Resource Manager-Bezeichner der Ressource.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	GuestAgent	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

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

GuestAgents_Get_MaximumSet

GuestAgents_Get_MinimumSet

GuestAgents_Get_MaximumSet

Beispielanforderung

HTTP

GET https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default/guestAgents/default?api-version=2024-06-01

Beispiel für eine Antwort

Statuscode:

200

{
  "properties": {
    "uuid": "hbsgztyakewtgbuxbesezncnzu",
    "credentials": {
      "username": "jqxuwirrcpfv"
    },
    "httpProxyConfig": {
      "httpsProxy": "uoyzyticmohohomlkwct"
    },
    "provisioningAction": "install",
    "status": "jpoukrzfenzrmjdahimkl",
    "customResourceName": "mhqymxkapuvsugd",
    "provisioningState": "Succeeded",
    "privateLinkScopeResourceId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.HybridCompute/privateLinkScopes/privateLinkResourceName"
  },
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default/guestAgents/default",
  "name": "rwecpthzyt",
  "type": "dkcgcbtlwtsedxzhvtu",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

GuestAgents_Get_MinimumSet

Beispielanforderung

HTTP

GET https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default/guestAgents/default?api-version=2024-06-01

Beispiel für eine Antwort

Statuscode:

200

{}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
GuestAgent	Definiert den GuestAgent.
GuestCredential	Benutzername/Kennwortanmeldeinformationen zum Herstellen einer Verbindung mit Gast.
HttpProxyConfiguration	HTTP-Proxykonfiguration für den virtuellen Computer.
ProvisioningAction	Gast-Agent-Bereitstellungsaktion.
ProvisioningState	Der Bereitstellungsstatus der Ressource.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

GuestAgent

Objekt

Definiert den GuestAgent.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.credentials	GuestCredential	Benutzername/Kennwortanmeldeinformationen zum Bereitstellen des Gast-Agents.
properties.customResourceName	string	Ruft den Namen der entsprechenden Ressource in Kubernetes ab.
properties.httpProxyConfig	HttpProxyConfiguration	HTTP-Proxykonfiguration für den virtuellen Computer.
properties.privateLinkScopeResourceId	string (arm-id)	Die Ressourcen-ID des privaten Verknüpfungsbereichs, dem dieser Computer zugewiesen ist, falls vorhanden.
properties.provisioningAction	ProvisioningAction	Ruft die Bereitstellungsaktion des Gast-Agents ab oder legt sie fest.
properties.provisioningState	ProvisioningState	Bereitstellungsstatus der Ressource.
properties.status	string	Ruft den Status des Gast-Agents ab.
properties.uuid	string	Ruft einen eindeutigen Bezeichner für diese Ressource ab.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

GuestCredential

Objekt

Benutzername/Kennwortanmeldeinformationen zum Herstellen einer Verbindung mit Gast.

Name	Typ	Beschreibung
password	string (password)	Ruft das Kennwort ab, um eine Verbindung mit dem Gast herzustellen, oder legt es fest.
username	string	Ruft den Benutzernamen ab, der mit dem Gast verbunden werden soll, oder legt diesen fest.

HttpProxyConfiguration

Objekt

HTTP-Proxykonfiguration für den virtuellen Computer.

Name	Typ	Beschreibung
httpsProxy	string	Dient zum Abrufen oder Festlegen der httpsProxy-URL.

ProvisioningAction

Enumeration

Gast-Agent-Bereitstellungsaktion.

Wert	Beschreibung
install	Installieren Sie den Gast-Agent.
repair	Reparieren sie den Gast-Agent.
uninstall	Deinstallieren Sie den Gast-Agent.

ProvisioningState

Enumeration

Der Bereitstellungsstatus der Ressource.

Wert	Beschreibung
Accepted	Die Ressource wurde akzeptiert.
Canceled	Die Ressourcenerstellung wurde abgebrochen.
Created	Die Ressource wurde erstellt.
Deleting	Die Ressource wird gelöscht.
Failed	Fehler bei der Ressourcenerstellung.
Provisioning	Die Ressource wird bereitgestellt.
Succeeded	Ressource wurde erstellt.
Updating	Die Ressource wird aktualisiert.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.