Este documento mostra como resolver problemas com operações de criação da API de instância em massa.
Erros de operação
Quando você usa a API de instância em massa para criar VMs, as solicitações create
retornam
HTTP 200 OK
com o status RUNNING
se a solicitação for iniciada com sucesso. Se
a solicitação não for iniciada com sucesso, a API retornará uma das respostas
abaixo.
Inválida
Se os seguintes campos de resposta da API estiverem presentes quando você criar VMs, a solicitação de API não será gravada corretamente ou usará uma propriedade que incompatível com a API em massa
Campos de resposta da API:
HTTP 400
"reason": "invalid"
Para resolver esse problema, faça o seguinte:
- Visualize o campo
message
na resposta para determinar qual propriedade na solicitação causou o erro. - Atualize a propriedade que causou o erro.
- Tente fazer a solicitação novamente.
- Se a solicitação falhar novamente, tente usar o APIs Explorer para validá-la. Para mais informações, consulte Como validar solicitações de API.
Cota excedida
Se os seguintes campos de resposta da API estiverem presentes quando você criar VMs, quer dizer que você atingiu um limite de cota para um recurso. Para mais informações sobre cotas, consulte Cotas de recursos.
Campos de resposta da API:
HTTP 403
"reason": "quotaExceeded"
- Visualize o campo "mensagem" para identificar qual cota de recurso a solicitação excedeu.
- Escolha uma destas opções:
- Repita a solicitação com um número menor de VMs
- Solicitar um aumento de cota
Limitação de taxa excedida
Se os campos de resposta da API a seguir estiverem presentes que você criar VMs, quer dizer que você atingiu o limite de 20 solicitações por segundo ou tem mais de 10 operações em massa em execução ao mesmo tempo.
Campos de resposta da API:
HTTP 403
"reason": "rateLimitExceeded"
Para resolver esse problema, aguarde a conclusão de algumas solicitações e tente novamente.
Capacidade insuficiente
Se os seguintes campos de resposta da API estiverem presentes quando você criar VMs, a região ou zona em que você tentou criar VMs tem capacidade insuficiente.
Campos de resposta da API:
HTTP 503
"reason": "insufficientCapacity"
- Crie VMs em uma região diferente
- Crie VMs em uma zona diferente se estiver usando o endpoint zonal
- Tente uma configuração de VM diferente
- Tente fazer a solicitação novamente mais tarde
Erros de status da solicitação
Quando você usa a API de instância em massa para criar VMs, sua solicitação create
retorna
HTTP 200 OK
com status RUNNING
se a solicitação for iniciada.
No entanto, a solicitação pode falhar antes de ser concluída. Verifique
o status da sua solicitação
para garantir que ela foi concluída. Se a solicitação não foi concluída,
você verá um dos status a seguir.
Cota excedida
Se os campos de resposta da API a seguir estiverem presentes quando você pesquisar operações, a solicitação falhou porque você atingiu o limite de cota de um recurso. Para mais informações sobre cotas, consulte Cotas de recursos.
Campos de resposta da API:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
Para resolver esse problema, faça o seguinte:
- Visualize o campo "mensagem" para identificar qual cota de recurso a solicitação excedeu.
- Escolha uma destas opções:
- Repita a solicitação com um número menor de VMs
- Solicitar um aumento de cota
O recurso já existe
Se os seguintes campos de resposta da API estiverem presentes quando você pesquisar operações, a solicitação falhou porque ela tentou criar um recurso que já existe.
Campos de resposta da API:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
Para resolver esse problema, faça o seguinte:
- Visualize o campo
message
para identificar o nome do recurso que já existe. - Tente fazer a solicitação novamente usando outro
namePattern
. Para mais informações, consulte Como criar várias VMs em uma região.
Capacidade insuficiente
Se os campos de resposta de API a seguir estiverem presentes quando você pesquisar operações, a solicitação falhou porque a região ou zona (se estiver usando o endpoint zonal) em que você tentou criar VMs tem capacidade insuficiente.
Campos de resposta da API:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
Para resolver esse problema, faça uma das seguintes ações:
- Crie VMs em uma região diferente
- Crie VMs em uma zona diferente se estiver usando o endpoint zonal
- Tente uma configuração de VM diferente
- Tente fazer a solicitação novamente mais tarde
A seguir
- Para saber mais sobre como usar a API de instância em massa, consulte Como usar a API de instância em massa.