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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Auf der Seite VM-Instanzen finden Sie die folgenden Informationen zu einer Compute-Instanz:
- Der Name der Instanz.
- Die Zone, in der sich die Instanz befindet;
- Der von der Instanz verwendete Maschinentyp.
- Das Bereitstellungsmodell, das angibt, ob die Instanz als Spot-VM erstellt wurde.
- 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 zu ändern, welche Spalten für jede VM angezeigt werden.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 Arbeitsspeicherzuweisungstyp für die Instanz und22
ist die Anzahl der vCPUs, die der Instanz zugewiesen sind. Normalerweise wird für einenstandard
-Maschinentyp ein Verhältnis von 4 GB Arbeitsspeicher pro vCPU verwendet. Dieser Maschinentyp hat 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 Maschinenreihe, mit Ausnahme von N1-Maschinentypen, die die Maschinenreihe überhaupt nicht enthalten. Die erste Zahl nachcustom
ist die Anzahl der vCPUs und die letzte Zahl ist der der Instanz zugewiesene Arbeitsspeicher (in MB).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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen den Compute-Instanzadministrator (Version 1) zu gewähren, um die Berechtigung zu erhalten, die Sie zum Aufrufen der Details einer VM benötigen. (
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, können 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: 2024-12-22 (UTC).
-