Auf dieser Seite erfahren Sie, wie Sie mit der Google Cloud Console, der Google Cloud CLI, dem Vertex AI SDK für Python und der REST API eine Liste nichtflüchtiger Ressourcen abrufen und Informationen zu einer bestimmten nichtflüchtigen Ressource abrufen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die Rolle Vertex AI Viewer (roles/aiplatform.viewer
) für Ihr Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Abrufen persistenter Ressourceninformationen benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Abrufen von Informationen zu nichtflüchtigen Ressourcen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Informationen zu nichtflüchtigen Ressourcen abzurufen:
-
aiplatform.persistentResources.get
-
aiplatform.persistentResources.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Liste der nichtflüchtigen Ressourcen abrufen
Wählen Sie einen der folgenden Tabs aus, um zu erfahren, wie Sie eine Liste der vorhandenen nichtflüchtigen Ressourcen abrufen.
Console
Sie können sich in der Google Cloud Console eine Liste der nichtflüchtigen Ressourcen auf der Seite Nichtflüchtige Ressourcen anzeigen lassen.
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- PROJECT_ID: Die Projekt-ID des Google Cloud-Projekts, für das Sie eine Liste nichtflüchtiger Ressourcen abrufen möchten.
- LOCATION: Die Region, in der Sie die nichtflüchtige Ressource erstellen möchten. Eine Liste der unterstützten Regionen finden Sie unter Featureverfügbarkeit.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud ai persistent-resources list \ --project=PROJECT_ID \ --region=LOCATION
Windows (PowerShell)
gcloud ai persistent-resources list ` --project=PROJECT_ID ` --region=LOCATION
Windows (cmd.exe)
gcloud ai persistent-resources list ^ --project=PROJECT_ID ^ --region=LOCATION
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Antwort
Using endpoint [https://us-central1-aiplatform.googleapis.com/] --- createTime: '2023-09-12T20:45:33.220989Z' displayName: test name: projects/123456789012/locations/us-central1/persistentResources/test-persistent-resource resourcePools: - autoscalingSpec: maxReplicaCount: '4' minReplicaCount: '1' diskSpec: bootDiskSizeGb: 100 bootDiskType: pd-standard id: n1-highmem-2-nvidia-tesla-k80-1 machineSpec: acceleratorCount: 1 acceleratorType: NVIDIA_TESLA_K80 machineType: n1-highmem-2 replicaCount: '1' startTime: '2023-09-12T20:50:36.992739253Z' state: RUNNING updateTime: '2023-09-12T20:50:42.813723Z' --- createTime: '2023-09-12T20:37:21.691977Z' displayName: my-persistent-resource name: projects/123456789012/locations/us-central1/persistentResources/my-persistent-resource resourcePools: - autoscalingSpec: maxReplicaCount: '12' minReplicaCount: '4' diskSpec: bootDiskSizeGb: 200 bootDiskType: pd-standard id: n1-highmem-2-nvidia-tesla-k80-1 machineSpec: acceleratorCount: 1 acceleratorType: NVIDIA_TESLA_K80 machineType: n1-highmem-2 replicaCount: '4' - diskSpec: bootDiskSizeGb: 100 bootDiskType: pd-ssd id: n1-standard-4 machineSpec: machineType: n1-standard-4 replicaCount: '4' startTime: '2023-09-12T20:42:46.495575169Z' state: RUNNING updateTime: '2023-09-12T20:42:51.519271Z'
Python
Bevor Sie dieses Beispiel anwenden, folgen Sie den Python-Einrichtungsschritten in der Vertex AI-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Vertex AI Python API.
Richten Sie zur Authentifizierung bei Vertex AI Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
# Optional arguments: # filter (str): An expression for filtering the results of the request. For # field names both snake_case and camelCase are supported. # order_by (str): A comma-separated list of fields to order by, sorted in # ascending order. Use "desc" after a field name for descending. Supported # fields: `display_name`, `create_time`, `update_time` # List the persistent resource on the project. resource_list = persistent_resource.PersistentResource.list() for i in range(len(resource_list)): print(resource_list[i].name) print(resource_list[i].state)
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Die Projekt-ID des Google Cloud-Projekts, für das Sie eine Liste nichtflüchtiger Ressourcen abrufen möchten.
- LOCATION: Die Region, in der Sie die nichtflüchtige Ressource erstellen möchten. Eine Liste der unterstützten Regionen finden Sie unter Featureverfügbarkeit.
HTTP-Methode und URL:
GET https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Informationen zu einer nichtflüchtigen Ressource abrufen
Wählen Sie einen der folgenden Tabs aus, um zu erfahren, wie Sie Informationen zu einer nichtflüchtigen Ressource abrufen, darunter Status, Hardwarekonfiguration und verfügbarer Replikate.
Console
So rufen Sie Informationen zu einer nichtflüchtigen Ressource in der Google Cloud Console auf:
Öffnen Sie in der Google Cloud Console die Seite Nichtflüchtige Ressourcen.
Klicken Sie auf den Namen der nichtflüchtigen Ressource, die Sie aufrufen möchten.
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- PROJECT_ID: Die Projekt-ID der nichtflüchtigen Ressource, zu der Sie Informationen abrufen möchten.
- LOCATION: Die Region der nichtflüchtigen Ressource, zu der Sie Informationen abrufen möchten.
- PERSISTENT_RESOURCE_ID: Die ID der nichtflüchtigen Ressource, zu der Sie Informationen abrufen möchten.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud ai persistent-resources describe PERSISTENT_RESOURCE_ID \ --project=PROJECT_ID \ --region=LOCATION
Windows (PowerShell)
gcloud ai persistent-resources describe PERSISTENT_RESOURCE_ID ` --project=PROJECT_ID ` --region=LOCATION
Windows (cmd.exe)
gcloud ai persistent-resources describe PERSISTENT_RESOURCE_ID ^ --project=PROJECT_ID ^ --region=LOCATION
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Antwort
Using endpoint [https://us-central1-aiplatform.googleapis.com/] createTime: '2023-07-06T18:47:42.098296Z' displayName: Test-Persistent-Resource name: projects/123456789012/locations/us-central1/persistentResources/my-persistent-resource resourcePools: - diskSpec: bootDiskSizeGb: 100 bootDiskType: pd-ssd machineSpec: machineType: n1-highmem-4 replicaCount: '4' - diskSpec: bootDiskSizeGb: 100 bootDiskType: pd-ssd machineSpec: acceleratorCount: 1 acceleratorType: NVIDIA_TESLA_P4 machineType: n1-standard-4 replicaCount: '4' usedReplicaCOunt: '2' startTime: '2023-07-06T18:51:53.209127117Z' state: RUNNING updateTime: '2023-07-06T18:52:01.545109Z'
Python
Bevor Sie dieses Beispiel anwenden, folgen Sie den Python-Einrichtungsschritten in der Vertex AI-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Vertex AI Python API.
Richten Sie zur Authentifizierung bei Vertex AI Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
resource_to_get = persistent_resource.PersistentResource( EXAMPLE_PERSISTENT_RESOURCE_ID ) print(resource_to_get.display_name) print(resource_to_get.state) print(resource_to_get.start_time)
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Die Projekt-ID der nichtflüchtigen Ressource, zu der Sie Informationen abrufen möchten.
- LOCATION: Die Region der nichtflüchtigen Ressource, zu der Sie Informationen abrufen möchten.
- PERSISTENT_RESOURCE_ID: Die ID der nichtflüchtigen Ressource, zu der Sie Informationen abrufen möchten.
HTTP-Methode und URL:
GET https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "name": "projects/123456789012/locations/us-central1/persistentResources/test-persistent-resource", "displayName": "test", "resourcePools": [ { "id": "n1-highmem-2-nvidia-tesla-k80-1", "machineSpec": { "machineType": "n1-highmem-2", "acceleratorType": "NVIDIA_TESLA_K80", "acceleratorCount": 1 }, "replicaCount": "1", "diskSpec": { "bootDiskType": "pd-standard", "bootDiskSizeGb": 100 }, "autoscalingSpec": { "minReplicaCount": "1", "maxReplicaCount": "4" } } ], "state": "RUNNING", "createTime": "2023-09-12T20:45:33.220989Z", "startTime": "2023-09-12T20:50:36.992739253Z", "updateTime": "2023-09-12T20:50:42.813723Z" }
Nächste Schritte
- Mehr über nichtflüchtige Ressourcen erfahren.
- Trainingsjobs für eine nichtflüchtige Ressource ausführen.
- Informationen zu einer nichtflüchtigen Ressource abrufen.
- Nichtflüchtige Ressource neu starten.
- Nichtflüchtige Ressource löschen.