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:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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:
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.
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:
VM_NAME
: der VM-Name.ZONE
ist die Zone, in der sich die VM befindet.
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
Senden Sie eine GET
-Anfrage an die Methode instances.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:
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.
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.:
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 zu Maschinentypen finden Sie im Leitfaden zu Ressourcen und Vergleichen für Maschinenfamilien.
Nächste Schritte
Weitere Informationen über den VM-Lebenszyklus