Guia de migração da API Cloud Functions
A API Cloud Functions v1beta2 está obsoleta. Para evitar potenciais interrupções no serviço, use a API Cloud Functions v1. Nesta página, fornecemos instruções para migrar da API Cloud Functions v1beta2 para a API Cloud Functions v1.
CLI gcloud
Clientes que usam a CLI do Google Cloud precisam fazer upgrade para a versão mais
recente do gcloud
, utilizando o seguinte comando em um terminal:
gcloud components update
Consulte a referência de gcloud components update para detalhes.
Firebase CLI
Os clientes que usam a Firebase CLI precisam fazer upgrade para a versão mais atual da CLI. Consulte a Referência da Firebase CLI para detalhes.
API
Os clientes que usam a API diretamente com Google API Client Libraries precisam usar as bibliotecas baseadas na API Cloud Functions v1:
Biblioteca de cliente de APIs do Google Cloud Functions para Java
Biblioteca de cliente de APIs do Google Cloud Functions para Python
Biblioteca de cliente de APIs do Google Cloud Functions para C#
Biblioteca de cliente da API Google Cloud Functions para Ruby
As diferenças entre a API v1 e a API v1beta2 são mínimas. Todas as diferenças estão listadas abaixo.
Dois novos campos foram adicionados à API v1. Esses campos não estão presentes na API v1beta2.
Campo da API v1 | Descrição |
---|---|
CloudFunction.description |
Permite definir uma descrição fácil de usar de uma função do Cloud Functions. |
CloudFunction.source_repository.deployed_url |
Permite ver o URL de um repositório de origem durante a implantação. Ele usa como referência um código de revisão específico, mesmo que a implantação tenha acontecido de um branch ou uma tag. |
Os quatro campos têm nomes diferentes na API v1.
Campo da API v1beta2 | Campo da API v1 |
---|---|
CloudFunction.source_repository_url |
CloudFunction.source_repository.url |
CloudFunction.service_account |
CloudFunction.service_account_email |
ListFunctions.location |
ListFunctions.parent |
EventTrigger.retry_policy |
EventTrigger.failure_policy |
CloudFunction.last_operation
foi removido. Recomendamos que você use o serviço
Operations
para localizar a última operação executada em uma determinada função.
A semântica para atualizar uma função
foi alterada de PUT
para PATCH
. A solicitação de atualização
(UpdateFunctionRequest
)
utiliza dois parâmetros: uma função do Cloud Functions e uma máscara de atualização.
Considerando que a API v1beta2
usa o nome da função como entrada, a
API v1
usa uma instância CloudFunction
. A máscara de atualização contém uma lista de todos os campos a serem atualizados. O nome da função é extraído da instância CloudFunction
e não precisa mais ser explicitamente fornecido.
Teste a nova API usando o APIs Explorer.