In diesem Dokument wird beschrieben, wie Sie die Details einer vorhandenen Instanz einer virtuellen Maschine (VM) 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. Wenn Sie
Code oder Beispiele aus einer lokalen Entwicklungsumgebung ausführen möchten, können Sie sich bei
Compute Engine authentifizieren, indem Sie eine der folgenden Optionen auswählen:
Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud initWenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
- Legen Sie eine Standardregion und -zone fest.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Weitere Informationen finden Sie in der Google Cloud Authentifizierungsdokumentation 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. Fügen Sie die IAM-Rolle Compute Instance Admin (Version 1) (roles/compute.instanceAdmin.v1) für die VM oder das Projekt hinzu.
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
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 auf der Seite VM-Instanzen. 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.
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:
VM_NAME: der VM-Name.ZONEist 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
REST
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.ZONEist 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. Beispiel:
c3-standard-22: `c3` ist der Name der Maschinenserie,standardist der Typ der Arbeitsspeicherzuweisung für die Instanz, und22ist die Anzahl der vCPUs, die der Instanz zugewiesen sind. In der Regel wird bei einemstandard-Maschinentyp 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,ultamemundmegamemkö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. Dies gilt nicht für N1-Maschinentypen, bei denen die Maschinenserie nicht angegeben ist. Die erste Zahl nachcustomist die Anzahl der vCPUs und die letzte Zahl ist die Größe des Arbeitsspeichers (in MB), der der Instanz zugewiesen ist.
Weitere Informationen zu Maschinentypen finden Sie unter Leitfaden zu Ressourcen und Vergleichen für Maschinenfamilien.
Nächste Schritte
Weitere Informationen über den VM-Lebenszyklus