일시적인 오류 이해

  • 3분

이 섹션에서는 Azure Cosmos DB 서비스를 사용할 수 없는 예외를 진단하고 해결 합니다. 일반적으로 요청이 상태 코드 503을 반환하는 경우 이 예외를 식별할 수 있습니다. 서비스를 사용할 수 없기 때문에 작업을 완료할 수 없음을 의미합니다. 이 예외가 발생하는 이유는 여러 가지가 있습니다. 네트워크 연결 또는 서비스 가용성 문제로 인해 상태 코드가 반환될 수 있습니다. 대부분의 경우 작업을 다시 시도하면 문제가 해결되었을 수 있습니다. 문제가 지속되면 Azure 지원에 문의해야 합니다. 이 상태 코드가 반환되는 경우의 세 가지 주요 사례를 살펴보겠습니다.

필요한 포트가 차단됨

SQL API에 대해 다음 포트를 사용할 수 있는지 확인합니다.

연결 모드 지원되는 프로토콜 지원되는 SDK API/서비스 포트
게이트웨이 HTTPS 모든 SDK SQL(443)
직접 TCP .NET SDK, Java SDK 퍼블릭/서비스 엔드포인트를 사용하는 경우: 10000~20000 범위의 포트. 프라이빗 엔드포인트를 사용하는 경우: 0-65535 범위의 포트

클라이언트 측 임시 연결 문제

이 예외는 시간 제한을 유발하는 일시적인 연결 문제가 있는 경우에 발생할 수 있습니다. 이 시나리오와 관련된 스택 추적에는 TransportException 오류가 포함됩니다. 이 오류는 다음과 같습니다.

TransportException: A client transport error occurred: The request timed out while waiting for a server response. 
(Time: xxx, activity ID: xxx, error code: ReceiveTimeout [0x0010], base error: HRESULT 0x80131500

이 오류는 요청 시간 제한 오류(상태 코드 408)와 같은 문제를 해결해야 합니다.

서비스 중단

Azure 상태 페이지를 확인하여 진행 중인 문제가 있는지 확인합니다.