Share via

Service Bus Resource Manager 예외

  • 아티클

이 문서에서는 템플릿 또는 직접 호출을 통해 Azure Resource Manager를 사용하여 Azure Service Bus와 상호 작용할 때 생성되는 예외가 나열되어 있습니다.

Azure Resource Manager를 통해 표시되는 다양한 예외/오류는 다음과 같습니다.

오류: 잘못된 요청

“잘못된 요청”은 Resource Manager에서 받은 요청이 유효성 검사에 실패했음을 의미합니다.

오류 코드 오류 하위 코드 오류 메시지 설명 권장
Bad Request 40,000 하위 코드=40000 ‘namespace name’ 네임스페이스에서 ‘기본’ 계층을 사용하고 있으므로 큐를 만들 때 ‘property name’ 속성을 설정할 수 없습니다. 해당 작업은 ‘표준’ 또는 ‘프리미엄’ 계층에서만 지원됩니다. Azure Service Bus 기본 계층에서는 아래 속성을 설정하거나 업데이트할 수 없습니다.
  • RequiresDuplicateDetection
  • AutoDeleteOnIdle
  • RequiresSession
  • DefaultMessageTimeToLive
  • DuplicateDetectionHistoryTimeWindow
  • EnableExpress(프리미엄에서도 지원되지 않음)
  • ForwardTo
  • 토픽
해당 기능을 사용하려면 기본 계층에서 표준 또는 프리미엄 계층으로 업그레이드하는 것이 좋습니다.
Bad Request 40,000 하위 코드=40000 기존 큐(또는 토픽)의 ‘requiresDuplicateDetection’ 속성 값은 변경할 수 없습니다. 중복 검색은 엔터티를 만들 때 설정/해제해야 합니다. 중복 검색 구성 매개 변수를 만든 후에는 변경할 수 없습니다. 이전에 만든 큐/토픽에서 중복 검색을 사용하도록 설정하려면 중복 검색을 사용하여 새 큐/토픽을 만든 다음 원래 큐에서 새 큐/토픽으로 전달할 수 있습니다.
Bad Request 40,000 하위 코드=40000 지정된 값 16384가 잘못되었습니다. 속성 MaxSizeInMegabytes 은 다음 값 중 하나여야 합니다. 1024; 2048; 3072; 4096;5120. MaxSizeInMegabytes 값이 잘못되었습니다. MaxSizeInMegabytes가 1024, 2048, 3072, 4096, 5120 중 하나인지 확인합니다.
Bad Request 40,000 하위 코드=40000 큐/토픽에 대한 분할을 변경할 수 없습니다. 엔터티에 대한 분할을 변경할 수 없습니다. 새 엔터티(큐 또는 토픽)를 만들고 파티션을 사용하도록 설정합니다.
Bad Request 없음 네임스페이스 ‘namespace name’이 없습니다. 네임스페이스는 Azure 구독 내에 존재하지 않습니다. 이 오류를 해결하려면 다음을 수행합니다.
  • Azure 구독이 올바른지 확인합니다.
  • 네임스페이스가 있는지 확인합니다.
  • 네임스페이스 이름이 올바른지 확인합니다(철자 오류 또는 Null 문자열 없음).
Bad Request 40,000 하위 코드=40000 제공된 잠금 시간이 허용되는 최대 길이인 5분을 초과합니다. 메시지를 잠글 수 있는 시간은 1분(최소)에서 5분(최대) 사이여야 합니다. 제공된 잠금 시간이 1~5분 사이인지 확인합니다.
Bad Request 40,000 하위 코드=40000 DelayedPersistence 및 RequiresDuplicateDetection 속성을 함께 사용할 수 없습니다. 중복 검색이 설정된 엔터티는 영구적이어야 하므로 지속성을 연기할 수 없습니다. 중복 검색에 대해 자세히 알아보기
Bad Request 40,000 하위 코드=40000 기존 큐의 RequiresSession 속성 값은 변경할 수 없습니다. 세션에 대한 지원은 엔터티를 만들 때 사용하도록 설정해야 합니다. 만들고 나면 기존 엔터티(큐 또는 구독)에서 세션을 사용하거나 사용하지 않도록 설정할 수 없습니다. 삭제하고 “RequiresSession” 속성을 사용하도록 설정된 새 큐(또는 구독)를 다시 만듭니다.
Bad Request 40,000 하위 코드=40000 ‘URI_PATH’에 Service Bus에서 허용하지 않는 문자가 포함되어 있습니다. 엔터티 세그먼트에는 문자, 숫자, 마침표(.), 하이픈(-), 밑줄(_)만 사용할 수 있습니다. 엔터티 세그먼트에는 문자, 숫자, 마침표(.), 하이픈(-), 밑줄(_)만 사용할 수 있습니다. 다른 문자를 사용하면 요청이 실패합니다. URI 경로에 잘못된 문자가 없는지 확인합니다.
Bad Request 40,000 하위 코드=40000 잘못된 요청입니다. 자세히 알아보려면 https://aka.ms/sbResourceMgrExceptions를 방문하세요. TrackingId:00000000-0000-0000-0000-00000000000000_000, SystemTracker:contososbusnamesapce.servicebus.windows.net:myqueue, Timestamp:yyyy-mm-ddThh:mm:ss 이 오류는 값이 속성 maxMessageSizeInKilobytes로 설정된 프리미엄이 아닌 계층 네임스페이스에 큐를 만들려고 할 때 발생합니다. 이 속성은 프리미엄 네임스페이스의 큐에 대해서만 설정할 수 있습니다.
Bad Request 40300 하위 코드=40300 EnablePartioning == true 형식의 최대 리소스 수에 도달했거나 이를 초과했습니다. 네임스페이스당 분할된 엔터티 수에는 제한이 있습니다. 할당량 및 한도를 참조하세요.
Bad Request 40400 하위 코드=40400 자동 전달 대상 엔터티가 없습니다. 자동 전달 대상 엔터티의 대상이 없습니다. 대상 엔터티(큐 또는 토픽)는 원본이 만들어지기 전에 있어야 합니다. 대상 엔터티를 만든 후 다시 시도하세요.

오류 코드: 429

HTTP와 마찬가지로 "오류 코드 429"는 너무 많은 요청을 나타냅니다. 이는 해당 리소스에 대한 요청이 너무 많거나 충돌하는 작업으로 인해 특정 리소스(네임스페이스)가 제한되고 있음을 의미합니다.

오류 코드 오류 하위 코드 오류 메시지 설명 권장
429 50004 하위 코드=50004 사용자의 네임스페이스가 제한되므로 요청이 종료되었습니다. 해당 오류 조건은 들어오는 요청 수가 리소스의 제한을 초과하는 경우 발생합니다. 몇 초 정도 기다렸다가 다시 시도하세요.

할당량 및 Azure Resource Manager 요청 제한에 대해 자세히 알아보기
429 40901 하위 코드=40901 다른 충돌하는 작업이 진행 중입니다. 동일한 리소스/엔터티에서 다른 충돌하는 작업이 진행 중입니다. 현재 진행 중인 작업이 완료될 때까지 기다렸다가 다시 시도하세요.
429 40900 하위 코드=40900 충돌입니다. 리소스의 현재 상태에서 허용되지 않는 작업을 요청하고 있습니다. 이 조건은 동일한 엔터티(큐, 토픽, 구독 또는 규칙)에서 동시에 작업을 수행하기 위해 여러 요청을 수행할 때 발생할 수 있습니다. 몇 초 정도 기다렸다가 다시 시도하세요.
429 40901 ‘엔터티 이름’ 엔터티의 요청이 다른 요청과 충돌합니다. 동일한 리소스/엔터티에서 다른 충돌하는 작업이 진행 중입니다. 이전 작업이 완료될 때까지 기다렸다가 다시 시도하세요.
429 40901 엔터티에 대한 또 다른 업데이트 요청이 진행 중입니다. <entity name> 동일한 리소스/엔터티에서 다른 충돌하는 작업이 진행 중입니다. 이전 작업이 완료될 때까지 기다렸다가 다시 시도하세요.
429 없음 리소스 충돌이 발생했습니다. 또 다른 충돌 작업이 진행 중일 수 있습니다. 이 작업에서 실패한 작업을 다시 시도하는 경우 백그라운드 정리는 아직 보류 중입니다. 나중에 다시 시도하세요. 동일한 엔터티에 대해 보류 중인 작업이 있는 경우 이 조건이 발생할 수 있습니다. 이전 작업이 완료될 때까지 기다렸다가 다시 시도하세요.

오류 코드: 찾을 수 없음

해당 클래스의 오류는 리소스를 찾을 수 없음을 나타냅니다.

오류 코드 오류 하위 코드 오류 메시지 설명 권장
찾을 수 없음 없음 ‘엔터티 이름’ 엔터티를 찾을 수 없습니다. 작업을 실행한 엔터티를 찾을 수 없습니다. 엔터티가 있는지 확인하고 작업을 다시 시도하세요.
찾을 수 없음 없음 찾을 수 없음. 작업이 존재하지 않습니다. 수행하려는 작업이 존재하지 않습니다. 작업을 확인하고 다시 시도하세요.
찾을 수 없음 없음 들어오는 요청은 네임스페이스 정책 PUT 요청으로 인식되지 않습니다. 들어오는 요청 본문이 Null이므로 PUT 요청으로 실행할 수 없습니다. 요청 본문이 Null이 아닌지 확인하세요.
찾을 수 없음 없음 메시징 엔터티 ‘엔터티 이름’을 찾을 수 없습니다. 작업을 실행하려는 엔터티를 찾을 수 없습니다. 엔터티가 있는지 확인하고 작업을 다시 시도하세요.

오류 코드: 내부 서버 오류

이 오류 클래스는 내부 서버 오류가 있음을 나타냅니다.

오류 코드 오류 하위 코드 오류 메시지 설명 권장
Internal Server Error 50000 하위 코드=50000 Internal Server Error 다양한 이유로 발생할 수 있습니다. 일부 증상은 다음과 같습니다.
  • 클라이언트 요청/본문이 손상되어 오류가 발생합니다.
  • 서비스의 처리 문제로 인해 클라이언트 요청 시간이 초과되었습니다.
이 오류를 해결하려면 다음을 수행합니다.
  • 요청 매개 변수가 Null이거나 잘못된 형식이 아닌지 확인하세요.
  • 요청을 다시 시도하십시오.

오류 코드: 권한 없음

해당 오류 클래스는 명령을 실행하기 위한 권한이 없음을 나타냅니다.

오류 코드 오류 하위 코드 오류 메시지 설명 권장
Unauthorized 없음 보조 네임스페이스에 대한 작업이 잘못되었습니다. 보조 네임스페이스는 읽기 전용입니다. 보조 네임스페이스에 대한 작업을 수행했으며 이는 읽기 전용 네임스페이스로 설정됩니다. 기본 네임스페이스에 대해 명령을 다시 시도합니다. 보조 네임스페이스에 대해 자세히 알아보기
Unauthorized 없음 MissingToken: 인증 헤더를 찾을 수 없습니다. 해당 오류는 권한 부여의 값이 Null이거나 잘못된 경우 발생합니다. 인증 헤더에 언급된 토큰 값이 올바르고 Null이 아닌지 확인하세요.