ML-Metadaten verwalten

In dieser Anleitung wird beschrieben, wie Sie Ihre ML-Metadaten verwalten.

Hinweis

Wenn Sie zum Beispiel in einem Google Cloud-Projekt Vertex ML Metadata verwenden, erstellt Vertex AI den Metadatenspeicher Ihres Projekts.

Wenn Ihre Metadaten mit einem vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) verschlüsselt werden sollen, müssen Sie Ihren Metadatenspeicher mit einem CMEK erstellen, bevor Sie Metadaten mit Vertex ML Metadata verfolgen oder analysieren. Verwenden Sie die Anleitung Erstellen eines Metadatenspeichers, der ein CMEK verwendet, um den Metadatenspeicher Ihres Projekts zu konfigurieren.

Artefaktverwaltung

Artefakt erstellen

So erstellen Sie ein Artefakt:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem das Artefakt erstellt wird. Der Standardmetadatenspeicher heißt default.
  • ARTIFACT_ID: (Optional) Die ID des Artefakteintrags. Wenn die Artefakt-ID nicht angegeben ist, haben Vertex ML-Metadaten eine eindeutige Kennzeichnung für dieses Artefakt erstellt.
  • DISPLAY_NAME: Der Anzeigename des Artefakts. Dieses Feld kann bis zu 128 Unicode-Zeichen enthalten.
  • URI: (Optional) Der Standort, an dem das Artefakt gespeichert ist.
  • ARTIFACT_STATE: (Optional) Ein Wert aus der State-Aufzählung, der den aktuellen Status des Artefakts darstellt. Dieses Feld wird von Clientanwendungen verwaltet. Vertex ML-Metadaten prüfen nicht die Gültigkeit von Statusübergängen.
  • METADATA_SCHEMA_TITLE: Der Titel des Schemas, das das Metadatenfeld beschreibt.
  • METADATA_SCHEMA_VERSION: (Optional) Die Version des Schemas, das das Metadatenfeld beschreibt.
  • METADATA: (Optional) Attribute, die das Artefakt beschreiben, z. B. den Dataset-Typ.
  • DESCRIPTION: (Optional) Eine Beschreibung der Ausführung.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/artifacts?artifactId=ARTIFACT_ID

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME",
  "uri": "URI",
  "state": "ARTIFACT_STATE",
  "schemaTitle": "METADATA_SCHEMA_TITLE",
  "schemaVersion": "METADATA_SCHEMA_VERSION",
  "metadata": {
    METADATA
  },
  "description": "DESCRIPTION"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie müssten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/12345/locations/us-central1/metadataStores/default/artifacts/example-artifact",
  "displayName": "Example artifact",
  "uri": "gs://your_bucket_name/artifacts/dataset.csv",
  "etag": "67891011",
  "createTime": "2021-05-18T00:29:24.344Z",
  "updateTime": "2021-05-18T00:29:24.344Z",
  "state": "LIVE",
  "schemaTitle": "system.Dataset",
  "schemaVersion": "0.0.1",
  "metadata": {
    "payload_format": "CSV"
  },
  "description": "Description of the example artifact."
}

Vorhandenes Artefakt suchen

Artefakte stellen Daten dar, die von Ihrem ML-Workflow verwendet oder erstellt werden, z. B. Datasets und Modelle. So suchen Sie ein vorhandenes Artefakt:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem das Artefakt erstellt wird. Der Standardmetadatenspeicher heißt default.
  • PAGE_SIZE: (Optional) Die maximale Anzahl der zurückzugebenden Artefakte. Wenn dieser Wert nicht angegeben ist, werden maximal 100 Einträge zurückgegeben.
  • PAGE_TOKEN: (Optional) Ein Seitentoken aus einem vorherigen Aufruf von MetadataService.ListArtifacts. Geben Sie dieses Token an, um die nächste Ergebnisseite abzurufen.
  • FILTER: Gibt die Bedingungen an, die erforderlich sind, um eine Ausführung in die Ergebnismenge aufzunehmen.

HTTP-Methode und URL:

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/artifacts?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "artifacts": [
    {
      "name": "projects/12345/locations/us-central1/metadataStores/default/artifacts/example-artifact",
      "displayName": "Example artifact",
      "uri": "gs://your_bucket_name/artifacts/dataset.csv",
      "etag": "67891011",
      "createTime": "2021-05-18T00:33:13.833Z",
      "updateTime": "2021-05-18T00:33:13.833Z",
      "state": "LIVE",
      "schemaTitle": "system.Dataset",
      "schemaVersion": "0.0.1",
      "metadata": {
        "payload_format": "CSV"
      },
      "description": "Description of the example artifact."
    },
    {
      "name": "projects/12345/locations/us-central1/metadataStores/default/artifacts/example-artifact-2",
      "displayName": "Another example artifact",
      "uri": "gs://your_bucket_name/artifacts/dataset-2.csv",
      "etag": "67891012",
      "createTime": "2021-05-18T00:29:24.344Z",
      "updateTime": "2021-05-18T00:29:24.344Z",
      "state": "LIVE",
      "schemaTitle": "system.Dataset",
      "schemaVersion": "0.0.1",
      "metadata": {
        "payload_format": "CSV"
      },
      "description": "Description of the other example artifact."
    }
  ]
}

Vorhandenes Artefakt löschen

So löschen Sie ein Artefakt:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem das Artefakt erstellt wird. Der Standardmetadatenspeicher heißt default.
  • ARTIFACT_ID: Die ID des zu löschenden Artefakteintrags.

HTTP-Methode und URL:

DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/artifacts/ARTIFACT_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/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/artifacts/ARTIFACT_ID/operations/85544",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-07-21T20:05:30.179713Z",
      "updateTime": "2021-07-21T20:05:30.179713Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Artefakte dauerhaft löschen

Verwenden Sie die folgende Anleitung, um mehrere Artefakte basierend auf einer Filterbedingung zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Artefakte erstellt wurden. Der Standardmetadatenspeicher heißt default.
  • FILTER: Gibt die Bedingungen an, die für die zu löschenden Artefakte erforderlich sind. Beispiel:
    • Filter für alle Artefakte, die example im Anzeigenamen enthalten: "display_name = \"*example*\"".
    • Filter für alle Artefakte, die vor dem 19.11.2020T11:30:00-04:00 erstellt wurden: "create_time < \"2020-11-19T11:30:00-04:00\"".
  • FORCE: Gibt an, ob der tatsächliche Löschvorgang ausgeführt werden soll oder nicht. Wenn das Flag auf "false" gesetzt ist, gibt die Methode eine Stichprobe von Artefaktnamen zurück, die gelöscht werden würden.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/artifacts:purge

JSON-Text anfordern:

{
  "filter": "FILTER",
  "force": FORCE
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/operations/11531",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.PurgeArtifactsMetadata",
    "genericMetadata": {
      "createTime": "2021-07-21T21:02:33.757991Z",
      "updateTime": "2021-07-21T21:02:33.757991Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.PurgeArtifactsResponse",
    "purgeCount": "15"
  }
}

Ausführungsverwaltung

Ausführung erstellen

Ausführungen stellen einen Schritt in Ihrem ML-Workflow dar. Verwenden Sie die folgenden Anleitungen, um eine Ausführung zu erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Ausführung erstellt wird. Der Standardmetadatenspeicher heißt default.
  • EXECUTION_ID: (Optional) Die ID des Ausführungsdatensatzes. Wenn die Ausführungs-ID nicht angegeben ist, hat Vertex ML-Metadaten eine eindeutige Kennzeichnung für diese Ausführung erstellt.
  • DISPLAY_NAME: Der Anzeigename der Ausführung. Dieses Feld kann bis zu 128 Unicode-Zeichen enthalten.
  • EXECUTION_STATE: (Optional) Ein Wert aus der Statusliste, der den aktuellen Status der Ausführung darstellt. Dieses Feld wird von Clientanwendungen verwaltet. Vertex ML-Metadaten prüfen nicht die Gültigkeit von Statusübergängen.
  • METADATA_SCHEMA_TITLE: Der Titel des Schemas, das das Metadatenfeld beschreibt.
  • METADATA_SCHEMA_VERSION: (Optional) Die Version des Schemas, das das Metadatenfeld beschreibt.
  • METADATA: (Optional) Attribute, die die Ausführung beschreiben, z. B. die Ausführungsparameter.
  • DESCRIPTION: (Optional) Eine Beschreibung der Ausführung.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/executions?executionId=EXECUTION_ID

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME",
  "state": "EXECUTION_STATE",
  "schemaTitle": "METADATA_SCHEMA_TITLE",
  "schemaVersion": "METADATA_SCHEMA_VERSION",
  "metadata": {
    METADATA
  },
  "description": "DESCRIPTION"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/12345/locations/us-central1/metadataStores/default/executions/example-execution",
  "displayName": "Example Execution",
  "etag": "67891011",
  "createTime": "2021-05-18T00:04:49.659Z",
  "updateTime": "2021-05-18T00:04:49.659Z",
  "schemaTitle": "system.Run",
  "schemaVersion": "0.0.1",
  "metadata": {},
  "description": "Description of the example execution."
}

Vorhandene Ausführung suchen

Folgen Sie dieser Anleitung, um eine vorhandene Ausführung zu suchen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Ausführung erstellt wird. Der Standardmetadatenspeicher heißt default.
  • PAGE_SIZE: (Optional) Die maximale Anzahl der Ausführungen, die zurückgegeben werden sollen. Wenn dieser Wert nicht angegeben ist, werden maximal 100 Einträge zurückgegeben.
  • PAGE_TOKEN: (Optional) Ein Seitentoken aus einem früheren MetadataService.ListExecutions-Aufruf. Geben Sie dieses Token an, um die nächste Ergebnisseite abzurufen.
  • FILTER: Gibt die Bedingungen an, die erforderlich sind, um eine Ausführung in die Ergebnismenge aufzunehmen.

HTTP-Methode und URL:

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/executions?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "executions": [
    {
      "name": "projects/12345/locations/us-central1/metadataStores/default/executions/example-execution-1",
      "displayName": "Example execution 1",
      "etag": "67891011",
      "createTime": "2021-05-18T00:06:56.177Z",
      "updateTime": "2021-05-18T00:06:56.177Z",
      "schemaTitle": "system.Run",
      "schemaVersion": "0.0.1",
      "metadata": {},
      "description": "Descrption of the example execution."
    },
    {
      "name": "projects/12345/locations/us-central1/metadataStores/default/executions/example-execution-2",
      "displayName": "Example execution 2",
      "etag": "67891011",
      "createTime": "2021-05-18T00:04:49.659Z",
      "updateTime": "2021-05-18T00:04:49.659Z",
      "schemaTitle": "system.Run",
      "schemaVersion": "0.0.1",
      "metadata": {},
      "description": "Descrption of the example execution."
    }
  ]
}

Vorhandene Ausführung löschen

So löschen Sie eine Ausführung:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Ausführung erstellt wird. Der Standardmetadatenspeicher heißt default.
  • EXECUTION_ID: Die ID des zu löschenden Ausführungseintrags.

HTTP-Methode und URL:

DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/executions/EXECUTION_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/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/executions/EXECUTION_ID/operations/85544",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-07-21T20:05:30.179713Z",
      "updateTime": "2021-07-21T20:05:30.179713Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Löschvorgänge ausführen

Verwenden Sie die folgende Anleitung, um mehrere Ausführungen basierend auf einer Filterbedingung zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Ausführung erstellt wird. Der Standardmetadatenspeicher heißt default.
  • FILTER: Gibt die Bedingungen an, die von den zu löschenden Ausführungen benötigt werden. Beispiel:
    • Filter für alle Ausführungen, die example im Anzeigenamen enthalten: "display_name = \"*example*\"".
    • Filter für alle Ausführungen, die vor dem 19.11.2020T11:30:00-04:00 erstellt wurden: "create_time < \"2020-11-19T11:30:00-04:00\"".
  • FORCE: Gibt an, ob der tatsächliche Löschvorgang ausgeführt werden soll oder nicht. Wenn das Flag auf "false" gesetzt ist, gibt die Methode eine Auswahl von Ausführungsnamen zurück, die gelöscht werden würden.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/executions:purge

JSON-Text anfordern:

{
  "filter": "FILTER",
  "force": FORCE
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/operations/11531",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.PurgeExecutionsMetadata",
    "genericMetadata": {
      "createTime": "2021-07-21T21:02:45.757991Z",
      "updateTime": "2021-07-21T21:02:45.757991Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.PurgeExecutionsResponse",
    "purgeCount": "2"
  }
}

Kontextverwaltung

Kontext erstellen

Mit Kontexten können Sie Gruppen von Artefakten und Ausführungen gruppieren. Gehen Sie nach der folgenden Anleitung vor, um einen Kontext zu erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Ausführung erstellt wird. Der Standardmetadatenspeicher heißt default.
  • CONTEXT_ID: (Optional) : Die ID des Kontext-Eintrags. Wenn keine Kontext-ID angegeben ist, haben Vertex ML-Metadaten für diesen Kontext eine eindeutige Kennzeichnung erstellt.
  • DISPLAY_NAME: Der Anzeigename des Kontexts. Dieses Feld kann bis zu 128 Unicode-Zeichen enthalten.
  • Geben Sie den Ressourcennamen PARENT_CONTEXT für alle übergeordneten Kontexte an. Ein Kontext kann nicht mehr als 10 übergeordnete Kontexte haben.
  • METADATA_SCHEMA_TITLE: Der Titel des Schemas, das das Metadatenfeld beschreibt.
  • METADATA_SCHEMA_VERSION: (Optional) Die Version des Schemas, das das Metadatenfeld beschreibt.
  • METADATA: (Optional) Attribute, die den Kontext beschreiben.
  • DESCRIPTION: (Optional) Eine Beschreibung der Ausführung.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/contexts?contextId=CONTEXT_ID

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME:",
  "parentContexts": [
    "PARENT_CONTEXT_1",
    "PARENT_CONTEXT_2"
  ],
  "schemaTitle": "METADATA_SCHEMA_TITLE",
  "schemaVersion": "METADATA_SCHEMA_VERSION",
  "metadata": {
    METADATA
  },
  "description": "DESCRIPTION"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/12345/locations/us-central1/metadataStores/default/contexts/example-context",
  "displayName": "Example context:",
  "etag": "67891011",
  "createTime": "2021-05-18T01:52:51.642Z",
  "updateTime": "2021-05-18T01:52:51.642Z",
  "schemaTitle": "system.Experiment",
  "schemaVersion": "0.0.1",
  "metadata": {},
  "description": "Description of the example context."
}

Vorhandenen Kontext suchen

Gehen Sie wie unten beschrieben vor, um einen vorhandenen Kontext zu suchen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in dem die Ausführung erstellt wird. Der Standardmetadatenspeicher heißt default.
  • PAGE_SIZE: (Optional) Die maximale Anzahl von Kontexten, die zurückgegeben werden sollen. Wenn dieser Wert nicht angegeben ist, werden maximal 100 Einträge zurückgegeben.
  • PAGE_TOKEN: (Optional) Ein Seitentoken aus einem früheren MetadataService.ListExecutions-Aufruf. Geben Sie dieses Token an, um die nächste Ergebnisseite abzurufen.
  • FILTER: Gibt die Bedingungen an, die erforderlich sind, um einen Kontext in die Ergebnismenge aufzunehmen.

HTTP-Methode und URL:

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/contexts?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "contexts": [
    {
      "name": "projects/12345/locations/us-central1/metadataStores/default/contexts/experiment-1",
      "displayName": "Experiment 1",
      "etag": "67891011",
      "createTime": "2021-05-18T22:36:02.153Z",
      "updateTime": "2021-05-18T22:36:02.153Z",
      "parentContexts": [],
      "schemaTitle": "system.Experiment",
      "schemaVersion": "0.0.1",
      "metadata": {}
    },
    {
      "name": "projects/12345/locations/us-central1/metadataStores/default/contexts/pipeline-run-1",
      "displayName": "Pipeline run 1",
      "etag": "67891011",
      "createTime": "2021-05-18T22:35:02.600Z",
      "updateTime": "2021-05-18T22:35:02.600Z",
      "parentContexts": [],
      "schemaTitle": "system.PipelineRun",
      "schemaVersion": "0.0.1",
      "metadata": {}
    }
  ]
}

Vorhandenen Kontext löschen

Folgen Sie der Anleitung unten, um einen Kontext zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die ID des Metadatenspeichers, in der der Kontext erstellt wurde. Der Standardmetadatenspeicher heißt default.
  • CONTEXT_ID: Die ID des zu löschenden Kontexteintrags.

HTTP-Methode und URL:

DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/contexts/CONTEXT_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/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/contexts/CONTEXT_ID/operations/85544",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-07-21T20:05:30.179713Z",
      "updateTime": "2021-07-21T20:05:30.179713Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Kontexte dauerhaft löschen

Verwenden Sie die folgende Anleitung, um mehrere Kontexte basierend auf einer Filterbedingung zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION: Ihre Region.
  • PROJECT: Ihre Projekt-ID oder Projektnummer
  • METADATA_STORE: Die Metadatenspeicher-ID, in der die Kontexte erstellt wurden. Der Standardmetadatenspeicher heißt default.
  • FILTER: Gibt die Bedingungen an, die für die zu löschenden Kontexte erforderlich sind. Beispiel:
    • Filter für alle Kontexte, die example im angezeigten Namen enthalten: "display_name = \"*example*\"".
    • Filter für alle Kontexte, die vor 2020-11-19T11:30:00-04:00 erstellt wurden: "create_time < \"2020-11-19T11:30:00-04:00\"".
  • FORCE: Gibt an, ob der tatsächliche Löschvorgang ausgeführt werden soll oder nicht. Wenn das Flag auf "false" gesetzt ist, gibt die Methode eine Stichprobe von Kontextnamen zurück, die gelöscht werden würden.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/contexts:purge

JSON-Text anfordern:

{
  "filter": "FILTER",
  "force": FORCE
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT/locations/LOCATION/metadataStores/METADATA_STORE/operations/11531",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.PurgeContextsMetadata",
    "genericMetadata": {
      "createTime": "2021-07-21T21:02:40.757991Z",
      "updateTime": "2021-07-21T21:02:40.757991Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.PurgeContextsResponse",
    "purgeCount": "5"
  }
}

Nächste Schritte