创建拉取队列

本页面介绍如何创建拉取队列。您必须先创建队列，然后才能向其中添加任务。本页面还介绍如何暂停或删除队列。

此 API 支持第一代运行时，并可在升级到相应的第二代运行时时使用。如果要更新到 App Engine Java 11/17 运行时，请参阅迁移指南以了解旧版捆绑服务的迁移选项。

使用 queue.yaml 定义队列

您可以使用应用的 queue.yaml 文件定义拉取队列。该过程与创建命名推送队列的过程相同，只是文件中会添加一个专用指令 mode: pull。

queue:
- name: my-queue-name
  mode: pull

您可以使用 gcloud CLI gcloud 命令上传该文件。

gcloud app deploy queue.yaml

注意：如果您使用服务帐号来管理用于部署队列配置文件的身份验证，则该帐号需要具有 serviceusage.services.list 权限。您可以使用 serviceusage.serviceUsageViewer 角色或者通过创建具有该权限的自定义角色来添加该权限。

注意：您也可以使用 Cloud Tasks API 直接提供的队列管理方法来管理任务队列服务的队列创建，但将 queue.yaml 上传方法与队列管理方法混用可能会产生意外的结果，因此不建议您这样做。如需了解详情，请参阅队列管理和 queue.yaml 概览。另请注意，通过低于 332.0.0 版本的 gcloud CLI 上传 queue.yaml 文件时，系统会使用已弃用的服务接口。从 2022-09-20 开始，尝试使用该上传方法可能会失败，并显示服务器错误。如需解决此问题，请确保在项目中启用 Cloud Tasks API，并将 gcloud CLI 至少更新到 332.0.0 版本。

停用队列

通过从队列配置文件中移除队列定义，然后上传更新后的文件，即可停用（暂停）队列。

一旦上传更新后的文件，队列就会设置为“已停用”并且其速率会设置为 0。系统不会处理该队列中的任何任务或添加到该队列的新任务。您可以重新启用已停用的队列，方法是：上传定义了该队列的新队列文件。

您还可以从控制台中的 Cloud Tasks 页面暂停队列。

删除队列

如需删除队列，您必须先将其停用：

1. 从队列配置文件中移除队列定义。

2. 上传更改后的文件。

   gcloud app deploy queue.yaml
   

停用队列后，请使用控制台将其删除。

1. 在控制台中，选择队列。

   打开 Cloud Tasks

2. 点击删除队列。

如果从控制台中删除队列，必须等待 7 天才能重新创建同名队列。

重要提示：本地开发服务器 (dev_appserver) 不支持拉取队列。如需测试拉取队列并确保配置的详细信息正确无误，您需要将队列配置文件推送到 App Engine 预演环境。

后续步骤

了解如何创建任务。