En este documento se explica cómo resolver problemas con las operaciones de creación de API de instancias en bloque.
Errores de la operación
Cuando usas la API de instancias en bloque para crear VMs, las solicitudes create
devuelven HTTP 200 OK
con el estado RUNNING
si la solicitud se inicia correctamente. Si la solicitud no se inicia correctamente, la API devuelve una de las respuestas que se indican a continuación.
No válida
Si los siguientes campos de respuesta de la API están presentes al crear máquinas virtuales, significa que tu solicitud a la API no está escrita correctamente o que usa una propiedad que no es compatible con la API masiva.
Campos de respuesta de la API:
HTTP 400
"reason": "invalid"
Para solucionar este problema, sigue estos pasos:
- Consulte el campo
message
de la respuesta para determinar qué propiedad de la solicitud ha provocado el error. - Actualiza la propiedad que ha provocado el error.
- Vuelve a intentar la solicitud.
- Si la solicitud vuelve a fallar, prueba a usar el Explorador de APIs para validarla. Para obtener más información, consulta Validar solicitudes de API.
Se ha superado la cuota
Si los siguientes campos de respuesta de la API están presentes al crear VMs, significa que has alcanzado el límite de cuota de un recurso. Para obtener más información sobre las cuotas, consulta Cuotas de recursos.
Campos de respuesta de la API:
HTTP 403
"reason": "quotaExceeded"
- Consulta el campo `message` para identificar qué cuota de recursos ha superado la solicitud.
- Sigue uno de estos pasos:
- Vuelve a intentar la solicitud con un número menor de máquinas virtuales
- Solicitar un aumento de cuota
Se ha superado el límite de frecuencia
Si los siguientes campos de respuesta de la API están presentes al crear máquinas virtuales, has alcanzado el límite de 20 solicitudes por segundo o tienes más de 10 operaciones masivas en curso al mismo tiempo.
Campos de respuesta de la API:
HTTP 403
"reason": "rateLimitExceeded"
Para solucionar este problema, espera a que se completen algunas solicitudes y vuelve a intentarlo.
Capacidad insuficiente
Si los siguientes campos de respuesta de la API están presentes al crear máquinas virtuales, significa que la región o la zona en la que has intentado crear las máquinas virtuales no tiene capacidad suficiente.
Campos de respuesta de la API:
HTTP 503
"reason": "insufficientCapacity"
- Crear VMs en otra región
- Crea máquinas virtuales en otra zona si usas el endpoint zonal.
- Probar otra configuración de VM
- Vuelve a intentarlo más tarde
Errores de estado de la solicitud
Cuando usas la API de instancias masivas para crear VMs, tu solicitud create
devuelve HTTP 200 OK
con el estado RUNNING
si la solicitud se inicia correctamente.
Sin embargo, es posible que la solicitud falle antes de completarse. Puedes consultar el estado de tu solicitud para asegurarte de que se ha completado correctamente. Si la solicitud no se ha completado correctamente, verás uno de los siguientes estados.
Se ha superado la cuota
Si los siguientes campos de respuesta de la API están presentes cuando sondeas las operaciones, significa que tu solicitud ha fallado porque has alcanzado el límite de cuota de un recurso. Para obtener más información sobre las cuotas, consulta Cuotas de recursos.
Campos de respuesta de la API:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
Para solucionar este problema, sigue estos pasos:
- Consulta el campo `message` para identificar qué cuota de recursos ha superado la solicitud.
- Sigue uno de estos pasos:
- Vuelve a intentar la solicitud con un número menor de máquinas virtuales
- Solicitar un aumento de cuota
El recurso ya existe
Si los siguientes campos de respuesta de la API están presentes al sondear las operaciones, significa que no se ha podido completar la solicitud porque se ha intentado crear un recurso que ya existe.
Campos de respuesta de la API:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
Para solucionar este problema, sigue estos pasos:
- Consulta el campo
message
para identificar el nombre del recurso que ya existe. - Vuelve a intentar hacer la solicitud con otro
namePattern
. Para obtener más información, consulta Crear varias VMs en una región.
Capacidad insuficiente
Si los siguientes campos de respuesta de la API están presentes al sondear las operaciones, significa que tu solicitud ha fallado porque la región o la zona (si usas el endpoint zonal) en la que has intentado crear las VMs no tiene capacidad suficiente.
Campos de respuesta de la API:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
Para solucionar este problema, haz una de las siguientes acciones:
- Crear VMs en otra región
- Crea máquinas virtuales en otra zona si usas el endpoint zonal.
- Probar otra configuración de VM
- Vuelve a intentarlo más tarde
Siguientes pasos
- Para obtener más información sobre cómo usar la API de instancias en bloque, consulta el artículo Usar la API de instancias en bloque.