API 调用部署和取消部署 Google AutoML 自然语言模型 - 文档错误？

Question

我们有一个 google automl 自然语言模型，并且在测试时，一直在控制台上手动部署和取消部署该模型。

我们在生产应用程序中也有一个 google 自动图像分类模型，我们使用 API.

从我们的应用程序部署和取消部署它

我现在正在查看 automl 自然语言模型的文档，我希望能够根据需要从我们的应用程序部署模型，并在完成后取消部署。显然，部署会产生费用，因此我们通过仅在需要时激活部署功能来最大限度地减少这些费用。

此功能的文档页面在此处 https://cloud.google.com/natural-language/automl/docs/manage-models#deploy-models 这是文档中描述在此处删除模型的部分的旁边 https://cloud.google.com/natural-language/automl/docs/manage-models#delete-model

在部署和取消部署模型中，它显示了您为取消部署所做的 API 调用 (:undeploy) 但它没有具体显示您为部署所做的调用（我假设是 :deploy 但文档中没有注明）

在删除模型部分，显示的 API 端点是取消部署端点。该文档特别指出，如果您使用 undeploy 命令，它会删除模型。我认为这是一个文档错误，但我不想尝试它，因为我不想错误地删除我们的模型。

它也没有具体说明这一点，但在我的图像模型中，它 returns 对我来说是一个很长的运行操作，我可以轮询它的状态。它在自然语言模型上也是这样吗？

感谢您的澄清

理查德

Answer 1

未针对 REST 用法正确记录部署模型。请参阅 deploy endpoint 以供参考。

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://automl.googleapis.com/v1/projects/your-project-id/locations/location-id/models/your-model-id:deploy

你是对的，这可能是文档错误。另一个错误是使用 :undeploy 时应该是 POST 而不是 GET。

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://automl.googleapis.com/v1/projects/your-project-id/locations/location-id/models/your-model-id:undeploy

对于 :delete 应该是 DELETE 而不是 GET。

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://automl.googleapis.com/v1/projects/your-project-id/locations/location-id/models/your-model-id

是的，您可以轮询给出的状态。有关详细信息，请参阅 Working with long-running operations for AutoML Natural Language。

我还针对您指出的错误发送了文档反馈。

API 调用部署和取消部署 Google AutoML 自然语言模型 - 文档错误？

API call for deploying and undeploying Google AutoML natural language model - documentation error?

google-cloud-automl