Este documento mostra como resolver problemas com as operações de criação da API de instâncias em massa.
Erros de operação
Quando usa a API de instâncias em massa para criar VMs, os pedidos create
devolvem HTTP 200 OK
com o estado RUNNING
se o pedido for iniciado com êxito. Se o pedido não for iniciado com êxito, a API devolve uma das respostas abaixo.
Inválido
Se os seguintes campos de resposta da API estiverem presentes quando criar VMs, o seu pedido de API não está escrito corretamente ou usa uma propriedade que não é suportada pela API em massa.
Campos de resposta da API:
HTTP 400
"reason": "invalid"
Para resolver este problema, faça o seguinte:
- Veja o campo
message
na resposta para determinar que propriedade no pedido causou o erro. - Atualize a propriedade que causou o erro.
- Volte a tentar o pedido.
- Se o pedido falhar novamente, experimente usar o Explorador de APIs para validar o pedido. Para mais informações, consulte o artigo Validar pedidos de API.
Quota excedida
Se os seguintes campos de resposta da API estiverem presentes quando cria VMs, significa que atingiu um limite de quota para um recurso. Para mais informações sobre quotas, consulte o artigo Quotas de recursos.
Campos de resposta da API:
HTTP 403
"reason": "quotaExceeded"
- Veja o campo "message" para identificar a quota de recursos que o pedido excedeu.
- Realize um dos seguintes passos:
- Tente novamente o pedido com um número inferior de VMs
- Peça um aumento da quota
Limite de taxa excedido
Se os seguintes campos de resposta da API estiverem presentes quando criar VMs, significa que atingiu o limite de 20 pedidos por segundo ou tem mais de 10 operações em massa em execução em simultâneo.
Campos de resposta da API:
HTTP 403
"reason": "rateLimitExceeded"
Para resolver este problema, aguarde até que alguns pedidos sejam concluídos e tente novamente o seu pedido.
Capacidade insuficiente
Se os seguintes campos de resposta da API estiverem presentes quando criar VMs, significa que a região ou a zona em que tentou criar VMs tem capacidade insuficiente.
Campos de resposta da API:
HTTP 503
"reason": "insufficientCapacity"
- Crie VMs numa região diferente
- Crie VMs numa zona diferente se usar o ponto final zonal
- Experimente uma configuração de VM diferente
- Volte a tentar o seu pedido mais tarde
Erros de estado do pedido
Quando usa a API de instâncias em massa para criar VMs, o seu pedido create
devolve HTTP 200 OK
com o estado RUNNING
se o pedido for iniciado com êxito.
No entanto, o pedido pode falhar antes de ser concluído. Pode
verificar o estado da sua solicitação
para garantir que foi concluída com êxito. Se o pedido não for concluído com êxito, é apresentado um dos seguintes estados do pedido.
Quota excedida
Se os seguintes campos de resposta da API estiverem presentes quando sondar operações, o seu pedido falhou porque atingiu um limite de quota para um recurso. Para mais informações sobre quotas, consulte o artigo Quotas de recursos.
Campos de resposta da API:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
Para resolver este problema, faça o seguinte:
- Veja o campo "message" para identificar a quota de recursos que o pedido excedeu.
- Realize um dos seguintes passos:
- Tente novamente o pedido com um número inferior de VMs
- Peça um aumento da quota
O recurso já existe
Se os seguintes campos de resposta da API estiverem presentes quando sondar operações, o seu pedido falhou porque tentou criar um recurso que já existe.
Campos de resposta da API:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
Para resolver este problema, faça o seguinte:
- Veja o campo
message
para identificar o nome do recurso que já existe. - Tente novamente o pedido com um
namePattern
diferente. Para mais informações, consulte o artigo Criar várias VMs numa região.
Capacidade insuficiente
Se os seguintes campos de resposta da API estiverem presentes quando sondar operações, o seu pedido falhou porque a região ou a zona (se estiver a usar o ponto final zonal) em que tentou criar VMs tem capacidade insuficiente.
Campos de resposta da API:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
Para resolver este problema, faça uma das seguintes ações:
- Crie VMs numa região diferente
- Crie VMs numa zona diferente se usar o ponto final zonal
- Experimente uma configuração de VM diferente
- Volte a tentar o seu pedido mais tarde
O que se segue?
- Para saber mais sobre a utilização da API de instâncias em massa, reveja o artigo Usar a API de instâncias em massa.