일괄 VM 생성 문제 해결

이 문서에서는 일괄 인스턴스 API 생성 작업과 관련된 문제를 해결하는 방법을 설명합니다.

작업 오류

일괄 인스턴스 API를 사용하여 VM을 만들 때 요청이 성공적으로 시작되면 create 요청은 HTTP 200 OK를 RUNNING 상태로 반환합니다. 요청이 성공적으로 시작되지 않으면 API에서 다음 응답 중 하나를 반환합니다.

잘못됨

VM을 만들 때 다음 API 응답 필드가 있으면 API 요청이 올바르게 작성되지 않거나 일괄 API에서 지원하지 않는 속성을 사용한 것입니다.

API 응답 필드:

  • HTTP 400
  • "reason": "invalid"

이 문제를 해결하려면 다음 단계를 따르세요.

  1. 응답의 message 필드를 확인하여 요청에서 어느 속성이 오류의 원인인지 확인합니다.
  2. 오류를 발생시킨 속성을 업데이트합니다.
  3. 요청을 다시 시도합니다.
  4. 요청이 다시 실패하면 API 탐색기를 사용하여 요청 유효성을 검사해 보세요. 자세한 내용은 API 요청 유효성 검사를 참조하세요.

할당량 초과

VM을 만들 때 다음 API 응답 필드가 있으면 리소스의 할당량 한도에 도달한 것입니다. 할당량에 대한 자세한 내용은 리소스 할당량을 참조하세요.

API 응답 필드:

  • HTTP 403
  • "reason": "quotaExceeded"
이 문제를 해결하려면 다음 단계를 따르세요.

  1. `message` 필드를 보고 요청이 어느 리소스 할당량을 초과했는지 확인합니다.
  2. 다음 중 한 가지 방법을 사용합니다.

비율 제한 초과

VM을 만들 때 다음 API 응답 필드가 있으면 초당 요청 20개에 도달했거나 초당 10개가 넘는 일괄 작업이 동시에 실행된 것입니다.

API 응답 필드:

  • HTTP 403
  • "reason": "rateLimitExceeded"

이 문제를 해결하려면 일부 요청이 완료될 때까지 기다린 후에 다시 요청해 보세요.

용량 부족

VM을 만들 때 다음 API 응답 필드가 있으면 VM을 만들려고 하는 리전 또는 영역의 용량이 부족한 것입니다.

API 응답 필드:

  • HTTP 503
  • "reason": "insufficientCapacity"
이 문제를 해결하려면 다음 중 한 가지를 따르세요.

  • 다른 리전에 VM 만들기
  • 영역 엔드포인트를 사용하는 경우 다른 영역에 VM 만들기
  • 다른 VM 구성 시도
  • 나중에 요청 재시도

요청 상태 오류

일괄 인스턴스 API를 사용하여 VM을 만들 때 요청이 성공적으로 시작되면 create 요청에서 HTTP 200 OK를 RUNNING 상태로 반환합니다. 하지만 요청이 완료되기 전에 실패할 수 있습니다. 요청 상태를 확인하여 요청이 성공적으로 완료되었는지 확인할 수 있습니다. 요청이 성공적으로 완료되지 않으면 다음 요청 상태 중 하나가 표시됩니다.

할당량 초과

작업을 폴링할 때 다음 API 응답 필드가 있으면 리소스의 할당량 한도에 도달하여 요청이 실패한 것입니다. 할당량에 대한 자세한 내용은 리소스 할당량을 참조하세요.

API 응답 필드:

  • "status": "done"
  • "httpErrorMessage": "FORBIDDEN"
  • "code"": "QUOTA_EXCEEDED"

이 문제를 해결하려면 다음 단계를 따르세요.

  1. `message` 필드를 보고 요청이 어느 리소스 할당량을 초과했는지 확인합니다.
  2. 다음 중 한 가지 방법을 사용합니다.

리소스가 이미 있음

작업을 폴링할 때 다음 API 응답 필드가 있으면 요청에서 이미 있는 리소스를 만들려고 하여 요청이 실패한 것입니다.

API 응답 필드:

  • code: RESOURCE_ALREADY_EXISTS
  • httpErrorMessage: CONFLICT
  • status: DONE

이 문제를 해결하려면 다음 단계를 따르세요.

  1. message 필드를 확인하여 이미 있는 리소스의 이름을 확인합니다.
  2. 다른 namePattern를 사용하여 요청을 재시도합니다. 자세한 내용은 한 리전에 여러 VM 만들기를 참조하세요.

용량 부족

작업을 폴링할 때 다음 API 응답 필드가 있으면 VM을 만들려고 시도한 리전이나 영역(영역 엔드포인트를 사용하는 경우)의 용량이 부족하기 때문에 요청이 실패한 것입니다.

API 응답 필드:

  • "status": "DONE"
  • "httpErrorMessage": "SERVICE UNAVAILABLE"
  • "code": "ZONE_RESOURCE_POOL_EXHAUSTED"

이 문제를 해결하려면 다음 중 한 가지를 따르세요.

  • 다른 리전에 VM 만들기
  • 영역 엔드포인트를 사용하는 경우 다른 영역에 VM 만들기
  • 다른 VM 구성 시도
  • 나중에 요청 재시도

다음 단계