删除永久性资源

永久性资源在被删除之前都可用。一旦删除，我们将无法保证您可以再次创建相同类型的永久性资源，因为该类型的资源可能会供应不足。本页面介绍如何使用 Google Cloud 控制台、Google Cloud CLI、Vertex AI SDK for Python 和 REST API 删除永久性资源。

所需的角色

如需获得删除永久性资源所需的权限，请让管理员向您授予项目的 Vertex AI Administrator (roles/aiplatform.admin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含删除永久性资源所需的 aiplatform.persistentResources.delete 权限。

您也可以使用自定义角色或其他预定义角色来获取此权限。

删除永久性资源

如需了解如何删除不再需要的永久性资源，可根据需要选择以下任一标签页。请注意，如果在您删除永久性资源时有自定义作业在该资源上运行，则这些自定义作业会在永久性资源删除之前自动取消。

控制台

如需在 Google Cloud 控制台中删除永久性资源，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到永久性资源页面。

    转到“永久性资源”

  2. 点击要删除的永久性资源的名称。

  3. 点击 删除。

  4. 点击确认。

gcloud

在使用下面的命令数据之前，请先进行以下替换：

  • PROJECT_ID：您要删除的永久性资源的项目 ID。
  • LOCATION：您要删除的永久性资源所在的区域。
  • PERSISTENT_RESOURCE_ID：您要删除的永久性资源的 ID。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID \
    --project=PROJECT_ID \
    --region=LOCATION

Windows (PowerShell)

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID `
    --project=PROJECT_ID `
    --region=LOCATION

Windows (cmd.exe)

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID ^
    --project=PROJECT_ID ^
    --region=LOCATION

您应该会收到类似如下所示的响应：

Using endpoint [https://us-central1-aiplatform.googleapis.com/]
Request to delete the PersistentResource [projects/sample-project/locations/us-central1/persistentResources/test-persistent-resource] has been sent.

You may view the status of your persistent resource with the command

  $ gcloud ai persistent-resources describe projects/sample-project/locations/us-central1/persistentResources/test-persistent-resource

Python

在尝试此示例之前，请按照《Vertex AI 快速入门：使用客户端库》中的 Python 设置说明执行操作。 如需了解详情，请参阅 Vertex AI Python API 参考文档。

如需向 Vertex AI 进行身份验证，请设置应用默认凭据。 如需了解详情，请参阅为本地开发环境设置身份验证。 

resource_to_delete = persistent_resource.PersistentResource(
    EXAMPLE_PERSISTENT_RESOURCE_ID
)

# Delete the persistent resource.
resource_to_delete.delete(sync=SYNC)

REST

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：您要删除的永久性资源的项目 ID。
  • LOCATION：您要删除的永久性资源所在的区域。
  • PERSISTENT_RESOURCE_ID：您要删除的永久性资源的 ID。

HTTP 方法和网址：

DELETE https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/123456789012/locations/us-central1/operations/1234567890123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-07-28T17:22:08.316883Z",
      "updateTime": "2023-07-28T17:22:08.316883Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

后续步骤