替换、移除或删除布置政策

本文档介绍如何替换、移除或删除布置政策。

在以下情况下，替换、移除或删除布置政策非常有用：

替换虚拟机 (VM) 实例中的布置政策，以将该虚拟机移至相对于其他虚拟机的不同位置。
如果您不再关注该虚拟机相对于其他虚拟机的位置，从虚拟机中移除布置政策。
如果不再需要布置政策，将其删除。

准备工作

查看布置政策的限制。
设置身份验证（如果尚未设置）。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例，您可以按如下方式向 Compute Engine 进行身份验证。

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

所需的角色

如需获得替换、移除或删除布置政策所需的权限，请让您的管理员为您授予项目的 Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含替换、移除或删除布置政策所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需替换、移除或删除布置政策，您需要具备以下权限：

从虚拟机中替换或移除布置政策： compute.instances.update on the project
删除布置政策： compute.resourcePolicies.delete on the project

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

替换虚拟机中的布置政策

在将虚拟机中的分散布置政策替换为紧凑布置政策之前，请确保该虚拟机使用受支持的机器类型和主机维护政策。如果您需要先更新虚拟机，然后再替换其布置政策，请执行以下任一操作或两者：

替换虚拟机中的布置政策后，您必须重启虚拟机，才能使新应用的布置政策生效。

如需替换虚拟机中的布置政策，请选择以下选项之一：

gcloud

创建一个空的 YAML 文件。
如需将虚拟机的属性导出到您刚刚创建的 YAML 文件中，请使用 gcloud compute instances export 命令。
```
gcloud compute instances export VM_NAME \
    --destination=FILE_PATH \
    --zone=ZONE
```
替换以下内容：
- VM_NAME：指定布置政策的现有虚拟机的名称。
- FILE_PATH：您在上一步中创建的 YAML 文件的路径。
- ZONE：该虚拟机所在的可用区。
在 YAML 配置文件中，修改 resourcePolicies 字段的值以指定其他布置政策。
```
resourcePolicies:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
```
替换以下内容：
- PROJECT_ID：布置政策所在项目的 ID。您只能指定与虚拟机位于同一项目中的布置政策。
- REGION：布置政策所在的区域。
- POLICY_NAME：布置政策的名称。
如需更新虚拟机并重启它，请使用 gcloud compute instances update-from-file 命令，并将 --most-disruptive-allowed-action 标志设置为 RESTART。
```
gcloud compute instances update-from-file VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE
```
替换以下内容：
- VM_NAME：虚拟机的名称。
- YAML_FILE：包含您在上一步中修改的配置数据的 YAML 文件的路径。
- ZONE：该虚拟机所在的可用区。

REST

创建一个空 JSON 文件。
如需查看现有虚拟机的属性，请向 instances.get 方法发出 GET 请求。
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
替换以下内容：
- PROJECT_ID：虚拟机所在项目的 ID。
- ZONE：该虚拟机所在的可用区。
- VM_NAME：指定布置政策的现有虚拟机的名称。
在您在上一步中创建的空 JSON 文件中，执行以下操作：
1. 输入 GET 请求输出中的虚拟机属性。
2. 找到 resourcePolicies 字段，然后修改其值以指定其他布置政策。
```
"resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
]
```
  替换以下内容：
  - PROJECT_ID：布置政策所在项目的 ID。您只能指定与虚拟机位于同一项目中的布置政策。
  - REGION：布置政策所在的区域。
  - POLICY_NAME：布置政策的名称。
如需更新虚拟机并重启它，请向 instances.update 方法发出 PUT 请求。在该请求中，执行以下操作：
- 在请求网址中添加 most_disruptive_allowed_action 查询参数并设置为 RESTART。
- 对于请求正文，请使用您在上一步中创建和更新的 JSON 文件中的虚拟机配置详细信息。
```
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?most_disruptive_allowed_action=RESTART

{
  ...
  "resourcePolicies": [
    "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  ...
}
```

如需详细了解如何更新虚拟机的属性，请参阅更新虚拟机属性。

从虚拟机中移除布置政策

如果您要从虚拟机中移除具有两个或更多可用性域的分散布置政策，则无需停止虚拟机即可移除。如果您要移除紧凑布置政策或仅具有一个可用性域的分散布置政策，则必须先停止虚拟机，然后才能移除挂接到该虚拟机的布置政策。

从虚拟机中移除布置政策不会影响其物理位置。但是，如果虚拟机正在实时迁移，Compute Engine 可能会将虚拟机移至其他物理位置。

如需从虚拟机中移除布置政策，请选择以下选项之一：

gcloud

如需从虚拟机中移除布置政策，请使用 gcloud compute instances remove-resource-policies 命令。

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

替换以下内容：

VM_NAME：指定布置政策的现有虚拟机的名称。
POLICY_NAME：应用于虚拟机的布置政策的名称。如需验证布置政策的名称，请查看虚拟机的详细信息并检查 resourcePolicies 字段的值。
ZONE：该虚拟机所在的可用区。

REST

如需从虚拟机中移除布置政策，请向 instances.removeResourcePolicies 方法发出 POST 请求。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

替换以下内容：

PROJECT_ID：虚拟机所在项目的 ID。
ZONE：该虚拟机所在的可用区。
VM_NAME：指定布置政策的现有虚拟机的名称。
REGION：布置政策所在的区域。
POLICY_NAME：应用于虚拟机的布置政策的名称。如需验证布置政策的名称，请查看虚拟机的详细信息并检查 resourcePolicies 字段的值。

删除布置政策

仅当未将某个布置政策应用于任何 Compute Engine 资源时，才能删除该布置政策。否则，删除布置政策会失败。如果您要删除应用于一个或多个 Compute Engine 资源的布置政策，请执行以下任一操作：

如果仅将政策应用于虚拟机，并且您希望保留虚拟机，请执行以下操作：
1. 按照本文档中所述从虚拟机中移除布置政策。
2. 按照本部分中所述删除布置政策。
否则，请执行以下操作：
1. 可选：按照本文档中所述从要保留的任何虚拟机中移除布置政策。
2. 按以下顺序删除应用了该布置政策的所有其他 Compute Engine 资源：
  1. 虚拟机
  2. 预订
  3. 实例模板
3. 按照本部分中所述删除布置政策。

如需删除布置政策，请选择以下选项之一：

gcloud

如需删除布置政策，请使用 gcloud compute resource-policies delete 命令。

gcloud compute resource-policies delete POLICY_NAME \
    --region=REGION

替换以下内容：

POLICY_NAME：现有布置政策的名称。
REGION：布置政策所在的区域。

REST

如需删除布置政策，请向 resourcePolicies.delete 方法发出 DELETE 请求。

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

替换以下内容：

PROJECT_ID：布置政策所在项目的 ID。
REGION：布置政策所在的区域。
POLICY_NAME：现有布置政策的名称。

后续步骤

了解如何查看布置政策。
了解如何使用指定布置政策的虚拟机执行以下操作：
- 查看虚拟机的状态。
- 连接到虚拟机。