In diesem Dokument wird beschrieben, wie Sie die Details einer vorhandenen VM-Instanz aufrufen.
Das Aufrufen der Details einer VM ist nützlich, um ihre Konfiguration und ihren Status zu sehen, z. B. angehängte Laufwerke, Zeitstempel der Erstellung, Maschinentyp und die ID der VM. Damit können Sie mit einem unveränderlichen Wert auf die VM verweisen.
Hinweise
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud -Dienste und APIs überprüft.
Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.
<x0A>Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:
Auf der Seite VM-Instanzen können Sie die folgenden Informationen für eine Compute-Instanz aufrufen:
- Der Name der Instanz.
- Die Zone, in der sich die Instanz befindet;
- Der von der Instanz verwendete Maschinentyp.
- Das Bereitstellungsmodell.
- Alle verfügbaren Empfehlungen für die Instanz.
- Ob die VM-Instanz Teil einer Instanzgruppe ist
- Die von der Instanz verwendeten IP-Adressen.
Die vorherige Liste enthält die Standardspalten, die auf der Seite VM-Instanzen angezeigt werden. Sie können auf
Spaltenanzeigeoptionen klicken, um die für jede VM angezeigten Spalten zu ändern.Klicken Sie in der Spalte Name auf den VM-Namen, um weitere Details zur VM-Instanz aufzurufen.
VM_NAME
: der VM-Name.ZONE
ist die Zone, in der sich die VM befindet.PROJECT_ID
: die Projekt-ID des Projekts, in dem sich die VM befindet.ZONE
ist die Zone, in der sich die VM befindet.VM_NAME
: der VM-Name.c3-standard-22
: C3 ist der Name der Maschinenreihe,standard
ist der Typ der Speicherzuweisung für die Instanz und22
ist die Anzahl der vCPUs, die der Instanz zugewiesen sind. Normalerweise wird für den Maschinentypstandard
ein Verhältnis von 4 GB Arbeitsspeicher pro vCPU verwendet. Dieser Maschinentyp hätte also 88 GB RAM.Die Speicher-zu-CPU-Verhältnisse für die Maschinentypen
standard
,highmem
,highcpu
,ultamem
undmegamem
können für jede Maschinenserie geringfügig variieren. Auf der Seite der Maschinenserie können Sie die genaue Größe des Arbeitsspeichers ermitteln, der jedem Maschinentyp zugewiesen ist.n2-custom-8-16384
: Bei benutzerdefinierten Maschinentypen ist der erste Teil des Maschinentyps die Maschinenserie. Das gilt nicht für N1-Maschinentypen, die die Maschinenserie überhaupt nicht enthalten. Die erste Zahl nachcustom
ist die Anzahl der vCPUs und die letzte Zahl ist die Menge des Arbeitsspeichers (in MB), die der Instanz zugewiesen ist.Weitere Informationen über den VM-Lebenszyklus
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die Berechtigung zum Aufrufen der Details einer VM zu erteilen. Compute-Instanzadministrator (Version 1) (
roles/compute.instanceAdmin.v1
) IAM-Rolle für die VM oder das Projekt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.Diese vordefinierte Rolle enthält die Berechtigung
compute.instances.get
, die zum Aufrufen der Details einer VM erforderlich ist.Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Details einer VM ansehen
Wählen Sie eine der folgenden Optionen aus, um die Details einer VM aufzurufen:
Console
gcloud
Wenn Sie die Details einer VM aufrufen möchten, verwenden Sie den Befehl
gcloud compute instances describe
.gcloud compute instances describe VM_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
canIpForward: false confidentialInstanceConfig: enableConfidentialCompute: false cpuPlatform: Intel Broadwell creationTimestamp: '2023-08-18T10:00:21.801-07:00' deletionProtection: false description: '' disks: - architecture: X86_64 autoDelete: true boot: true deviceName: example-vm diskSizeGb: '10' guestOsFeatures: - type: UEFI_COMPATIBLE - type: VIRTIO_SCSI_MULTIQUEUE - type: GVNIC - type: SEV_CAPABLE index: 0 interface: SCSI kind: compute#attachedDisk licenses: - https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-11-bullseye mode: READ_WRITE source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-vm type: PERSISTENT displayDevice: enableDisplay: false fingerprint: CQp-QBEACqw= id: '6404261768674286922' keyRevocationActionType: NONE kind: compute#instance labelFingerprint: 42WmSpB8rSM= lastStartTimestamp: '2023-08-18T10:00:28.182-07:00' machineType: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/machineTypes/e2-medium metadata: fingerprint: lQ-dD2sMrMY= items: - key: enable-oslogin value: 'true' kind: compute#metadata name: example-vm networkInterfaces: - accessConfigs: - kind: compute#accessConfig name: External NAT natIP: 34.27.53.198 networkTier: PREMIUM type: ONE_TO_ONE_NAT fingerprint: QR3z6TgVFjg= kind: compute#networkInterface name: nic0 network: https://www.googleapis.com/compute/v1/projects/example-project/global/networks/default networkIP: 10.128.0.28 stackType: IPV4_ONLY subnetwork: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/subnetworks/default reservationAffinity: consumeReservationType: ANY_RESERVATION scheduling: automaticRestart: true onHostMaintenance: MIGRATE preemptible: false provisioningModel: STANDARD selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-vm serviceAccounts: - email: 790569220780-compute@developer.gserviceaccount.com scopes: - https://www.googleapis.com/auth/devstorage.read_only - https://www.googleapis.com/auth/logging.write - https://www.googleapis.com/auth/monitoring.write - https://www.googleapis.com/auth/servicecontrol - https://www.googleapis.com/auth/service.management.readonly - https://www.googleapis.com/auth/trace.append shieldedInstanceConfig: enableIntegrityMonitoring: true enableSecureBoot: false enableVtpm: true shieldedInstanceIntegrityPolicy: updateAutoLearnPolicy: true startRestricted: false status: RUNNING tags: fingerprint: 42WmSpB8rSM= zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
REST
Senden Sie eine
GET
-Anfrage an die Methodeinstances.get
, um die Details einer VM aufzurufen.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
{ "canIpForward": false, "confidentialInstanceConfig": { "enableConfidentialCompute": false }, "cpuPlatform": "Intel Broadwell", "creationTimestamp": "2023-08-18T10:00:21.801-07:00", "deletionProtection": false, "description": "", "disks": [ { "architecture": "X86_64", "autoDelete": true, "boot": true, "deviceName": "example-vm", "diskSizeGb": "10", "guestOsFeatures": [ { "type": "UEFI_COMPATIBLE" }, { "type": "VIRTIO_SCSI_MULTIQUEUE" }, { "type": "GVNIC" }, { "type": "SEV_CAPABLE" } ], "index": 0, "interface": "SCSI", "kind": "compute#attachedDisk", "licenses": [ "https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-11-bullseye" ], "mode": "READ_WRITE", "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-vm", "type": "PERSISTENT" } ], "displayDevice": { "enableDisplay": false }, "fingerprint": "CQp-QBEACqw=", "id": "6404261768674286922", "keyRevocationActionType": "NONE", "kind": "compute#instance", "labelFingerprint": "42WmSpB8rSM=", "lastStartTimestamp": "2023-08-18T10:00:28.182-07:00", "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/machineTypes/e2-medium", "metadata": { "fingerprint": "lQ-dD2sMrMY=", "items": [ { "key": "enable-oslogin", "value": "true" } ], "kind": "compute#metadata" }, "name": "example-vm", "networkInterfaces": [ { "accessConfigs": [ { "kind": "compute#accessConfig", "name": "External NAT", "natIP": "34.27.53.198", "networkTier": "PREMIUM", "type": "ONE_TO_ONE_NAT" } ], "fingerprint": "QR3z6TgVFjg=", "kind": "compute#networkInterface", "name": "nic0", "network": "https://www.googleapis.com/compute/v1/projects/example-project/global/networks/default", "networkIP": "10.128.0.28", "stackType": "IPV4_ONLY", "subnetwork": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/subnetworks/default" } ], "reservationAffinity": { "consumeReservationType": "ANY_RESERVATION" }, "scheduling": { "automaticRestart": true, "onHostMaintenance": "MIGRATE", "preemptible": false, "provisioningModel": "STANDARD" }, "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-vm", "serviceAccounts": [ { "email": "790569220780-compute@developer.gserviceaccount.com", "scopes": [ "https://www.googleapis.com/auth/devstorage.read_only", "https://www.googleapis.com/auth/logging.write", "https://www.googleapis.com/auth/monitoring.write", "https://www.googleapis.com/auth/servicecontrol", "https://www.googleapis.com/auth/service.management.readonly", "https://www.googleapis.com/auth/trace.append" ] } ], "shieldedInstanceConfig": { "enableIntegrityMonitoring": true, "enableSecureBoot": false, "enableVtpm": true }, "shieldedInstanceIntegrityPolicy": { "updateAutoLearnPolicy": true }, "startRestricted": false, "status": "RUNNING", "tags": { "fingerprint": "42WmSpB8rSM=" }, "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a" }
CPU- und Arbeitsspeicherzuweisung für eine Instanz ermitteln
Die Anzahl der CPUs und der Arbeitsspeicher, die einer Compute-Instanz zugewiesen sind, kann anhand des von der Instanz verwendeten Maschinentyps ermittelt werden, z. B.:
Weitere Informationen zu Maschinentypen finden Sie im Leitfaden zu Ressourcen und Vergleichen für Maschinenfamilien.
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-14 (UTC).
-