Method: projects.locations.privateClouds.delete

安排删除 PrivateCloud 资源。

如果 PrivateCloud 资源已安排删除，则 PrivateCloud.state 会设置为 DELETED，而 expireTime 会设置为删除操作最终完成且无法再撤消的时间。只要成功安排了删除操作（PrivateCloud），删除操作就会标记为完成（当 delayHours 设置为零时也是如此），并且在 PrivateCloud 清除之前，操作不会一直处于待处理状态。在 expireTime 过期之前，可以使用 privateClouds.undelete 方法恢复 PrivateCloud。达到 expireTime 后，删除操作即为最终操作，所有私有云资源都会被永久移除，并且结算会停止。在最终移除过程中，PrivateCloud.state 会设置为 PURGING。在整个删除和清除期间，可以使用标准 GET 方法轮询 PrivateCloud。只有在完全清除后，才不会返回。

HTTP 请求

DELETE https://vmwareengine.googleapis.com/v1/{name=projects/*/locations/*/privateClouds/*}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要删除的私有云的资源名称。资源名称是无方案 URI，遵循 https://cloud.google.com/apis/design/resource_names 中的惯例。例如 projects/my-project/locations/us-central1-a/privateClouds/my-cloud

必须对指定的资源 name 具有以下 IAM 权限才能进行授权：

  • vmwareengine.privateClouds.delete

查询参数

参数
requestId

string

可选。请求 ID 必须是有效的 UUID，且不支持全部由零组成的 UUID（即 00000000-0000-0000-0000-000000000000）。
force

boolean

可选。如果设置为 true，则启用级联删除，并且此私有云资源的所有子资源也会被删除。如果此标志设置为 false，则当存在管理集群以外的任何子项时，系统不会删除私有云。管理集群始终会被删除。
delayHours

integer

可选。以小时为单位指定的删除延迟时间。默认值为 3。为此字段指定非零值会将 PrivateCloud.state 的值更改为 DELETED，并将 expireTime 设置为计划的删除时间。在 expireTime 过期之前，可以使用 VmwareEngine.UndeletePrivateCloud 取消删除。如果为此字段指定值 0，系统会立即开始删除流程并停止结算。在最终删除过程中，PrivateCloud.state 的值会变为 PURGING。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。