이 문서에서는 템플릿 또는 직접 호출을 통해 Azure Resource Manager를 사용하여 Azure Service Bus와 상호 작용할 때 생성된 예외를 나열합니다.
Azure Resource Manager를 통해 표시되는 다양한 예외/오류는 다음과 같습니다.
오류: 잘못된 요청
"잘못된 요청"은 Resource Manager에서 받은 요청이 유효성 검사에 실패했음을 의미합니다.
| 오류 코드 | 오류 하위 코드 | 오류 메시지 | 설명 | 추천 |
|---|---|---|---|---|
| 잘못된 요청 | 40,000 | 하위 코드=40000. '네임스페이스 이름' 네임스페이스가 '기본' 계층을 사용하므로 큐를 만들 때 '속성 이름' 속성을 설정할 수 없습니다. 이 작업은 '표준' 또는 '프리미엄' 계층에서만 지원됩니다. | Azure Service Bus 기본 계층에서는 아래 속성을 설정하거나 업데이트할 수 없습니다.
|
이 기능을 사용하려면 기본 계층에서 표준 또는 프리미엄 계층으로 업그레이드하는 것이 좋습니다. |
| 잘못된 요청 | 40,000 | 하위 코드=40000. 기존 큐(또는 토픽)의 'requiresDuplicateDetection' 속성 값은 변경할 수 없습니다. | 엔터티를 만들면서 중복 검색을 사용하도록 설정하거나 사용하지 않도록 설정해야 합니다. 중복 검색 구성 매개 변수는 만든 후에 변경할 수 없습니다. | 이전에 만든 큐/토픽에서 중복 검색을 사용하도록 설정하려면 중복 검색을 사용하여 새 큐/토픽을 만든 다음 원래 큐에서 새 큐/토픽으로 전달할 수 있습니다. |
| 잘못된 요청 | 40,000 | 하위 코드=40000. 지정된 값 16384가 잘못되었습니다. 속성 MaxSizeInMegabytes 은 다음 값 중 하나여야 합니다. 1024; 2048; 3072; 4096;5120. |
MaxSizeInMegabytes 값이 잘못되었습니다. | MaxSizeInMegabytes가 1024, 2048, 3072, 4096, 5120 중 하나인지 확인합니다. |
| 잘못된 요청 | 40,000 | 하위 코드=40000. 큐/토픽에 대해 분할을 변경할 수 없습니다. | 엔터티에 대해 분할을 변경할 수 없습니다. | 새 엔터티(큐 또는 토픽)를 만들고 파티션을 사용하도록 설정합니다. |
| 잘못된 요청 | 없음 | 네임스페이스 '네임스페이스 이름'이 존재하지 않습니다. | 네임스페이스는 Azure 구독 내에 존재하지 않습니다. | 이 오류를 해결하려면 다음을 수행합니다.
|
| 잘못된 요청 | 40,000 | 하위 코드=40000. 제공된 잠금 시간이 허용되는 최대 '5분'을 초과합니다. | 메시지를 잠글 수 있는 시간은 1분(최소)에서 5분(최대) 사이여야 합니다. | 제공된 잠금 시간이 1분에서 5분 사이인지 확인합니다. |
| 잘못된 요청 | 40,000 | 하위 코드=40000. DelayedPersistence 및 RequiresDuplicateDetection 속성을 함께 사용할 수 없습니다. | 중복 검색을 사용하도록 설정된 엔터티는 영구적이어야 하므로 지속성을 지연할 수 없습니다. | 중복 검색에 대해 자세히 알아보기 |
| 잘못된 요청 | 40,000 | 하위 코드=40000. 기존 큐의 RequiresSession 속성 값은 변경할 수 없습니다. | 엔터티를 만들 때 세션에 대한 지원을 사용하도록 설정해야 합니다. 만든 후에는 기존 엔터티(큐 또는 구독)에서 세션을 사용하거나 사용하지 않도록 설정할 수 없습니다. | "RequiresSession" 속성을 사용하도록 설정된 새 큐(또는 구독)를 삭제하고 다시 만듭니다. |
| 잘못된 요청 | 40,000 | 하위 코드=40000. 'URI_PATH'에는 Service Bus에서 허용되지 않는 문자가 포함되어 있습니다. 엔터티 세그먼트는 문자, 숫자, 마침표(.), 하이픈(-) 및 밑줄(_)만 포함할 수 있습니다. | 엔터티 세그먼트는 문자, 숫자, 마침표(.), 하이픈(-) 및 밑줄(_)만 포함할 수 있습니다. 다른 문자를 사용하면 요청이 실패하게 됩니다. | URI 경로에 잘못된 문자가 없는지 확인합니다. |
| 잘못된 요청 | 40,000 | 하위 코드=40000. 잘못된 요청입니다. 더 알고 싶다면 https://aka.ms/sbResourceMgrExceptions를 방문하세요. TrackingId:00000000-0000-0000-000000000000000000_000, SystemTracker:contososbusnamesapce.servicebus.windows.net:myqueue, Timestamp:yyyy-mm-ddThh:mm:ss |
이 오류는 값이 속성 maxMessageSizeInKilobytes으로 설정된 프리미엄이 아닌 계층 네임스페이스에 큐를 만들려고 할 때 발생합니다. 이 속성은 프리미엄 네임스페이스의 큐에 대해서만 설정할 수 있습니다. |
|
| 잘못된 요청 | 40300 | 하위 코드=40300. 형식 EnablePartioning == true 의 최대 리소스 수에 도달했거나 초과했습니다. |
네임스페이스당 분할된 엔터티 수에 제한이 있습니다. 할당량 및 제한을 참조하세요. | |
| 잘못된 요청 | 40400 | 하위 코드=40400. 자동 전달 대상 엔터티가 없습니다. | 자동 전달 대상 엔터티의 대상이 없습니다. | 원본을 만들기 전에 대상 엔터티(큐 또는 토픽)가 있어야 합니다. 대상 엔터티를 만든 후 다시 시도합니다. |
오류 코드: 429
HTTP와 마찬가지로 "오류 코드 429"는 너무 많은 요청을 나타냅니다. 특정 리소스(네임스페이스)가 해당 리소스에 대해 너무 많은 요청(또는 충돌하는 작업으로 인해)으로 인해 제한되고 있음을 의미합니다.
| 오류 코드 | 오류 하위 코드 | 오류 메시지 | 설명 | 추천 |
|---|---|---|---|---|
| 429 | 50004 | 하위 코드=50004. 귀하의 네임스페이스가 제한되고 있으므로 요청이 종료되었습니다. | 들어오는 요청 수가 리소스의 제한을 초과하면 이 오류 조건이 적중됩니다. | 몇 초 정도 기다렸다가 다시 시도하세요. 할당량 및 Azure Resource Manager 요청 제한에 대해 자세히 알아보기 |
| 429 | 40901 | 하위 코드=40901. 다른 작업과 충돌 중인 작업이 진행 중입니다. | 동일한 리소스/엔터티에서 또 다른 충돌 작업이 진행 중입니다. | 다시 시도하기 전에 현재 진행 중인 작업이 완료되기를 기다립니다. |
| 429 | 40900 | 하위 코드=40900. 충돌. 리소스의 현재 상태에서 허용되지 않는 작업을 요청하고 있습니다. | 이 조건은 동일한 엔터티(큐, 토픽, 구독 또는 규칙)에서 동시에 작업을 수행하기 위해 여러 요청을 수행할 때 발생할 수 있습니다. | 몇 초 동안 기다렸다가 다시 시도하세요. |
| 429 | 40901 | 엔터티 '엔터티 이름' 에 대한 요청이 다른 요청과 충돌했습니다. | 동일한 리소스/엔터티에서 또 다른 충돌 작업이 진행 중입니다. | 다시 시도하기 전에 이전 작업이 완료되기를 기다립니다. |
| 429 | 40901 | 엔터티 <entity name>에 대한 업데이트 요청이 현재 진행 중입니다. |
동일한 리소스/엔터티에서 또 다른 충돌 작업이 진행 중입니다. | 다시 시도하기 전에 이전 작업이 완료되기를 기다립니다. |
| 429 | 없음 | 리소스 충돌이 발생했습니다. 또 다른 충돌이 발생하는 작업이 진행 중일 수 있습니다. 이 작업이 실패한 작업에 대한 재시도인 경우 백그라운드 정리는 여전히 보류 중입니다. 나중에 다시 시도하세요. | 동일한 엔터티에 대해 보류 중인 작업이 있는 경우 이 조건이 발생할 수 있습니다. | 다시 시도하기 전에 이전 작업이 완료되기를 기다립니다. |
오류 코드: 찾을 수 없음
이 오류 클래스는 리소스를 찾을 수 없음을 나타냅니다.
| 오류 코드 | 오류 하위 코드 | 오류 메시지 | 설명 | 추천 |
|---|---|---|---|---|
| 찾을 수 없음 | 없음 | 엔터티 '엔터티 이름'을 찾을 수 없습니다. | 작업이 실행된 엔터티를 찾을 수 없습니다. | 엔터티가 있는지 확인하고 작업을 다시 시도합니다. |
| 찾을 수 없음 | 없음 | 찾을 수 없습니다. 작업이 존재하지 않습니다. | 수행하려는 작업이 없습니다. | 작업을 확인하고 다시 시도합니다. |
| 찾을 수 없음 | 없음 | 들어오는 요청은 네임스페이스 정책 배치 요청으로 인식되지 않습니다. | 들어오는 요청 본문이 null이므로 put 요청으로 실행할 수 없습니다. | 요청 본문을 확인하여 null이 아닌지 확인합니다. |
| 찾을 수 없음 | 없음 | 메시징 엔터티 '엔터티 이름' 을 찾을 수 없습니다. | 작업을 실행하려는 엔터티를 찾을 수 없습니다. | 엔터티가 있는지 확인하고 작업을 다시 시도합니다. |
오류 코드: 내부 서버 오류
이 오류 클래스는 내부 서버 오류가 있음을 나타냅니다.
| 오류 코드 | 오류 하위 코드 | 오류 메시지 | 설명 | 추천 |
|---|---|---|---|---|
| 내부 서버 오류 | 50000 | 하위 코드=50000. 내부 서버 오류 | 여러 가지 이유로 발생할 수 있습니다. 증상 중 일부는 다음과 같습니다.
|
이 오류를 해결하려면 다음을 수행합니다.
|
오류 코드: 권한 없음
이 오류 클래스는 명령을 실행할 수 있는 권한 부여가 없음을 나타냅니다.
| 오류 코드 | 오류 하위 코드 | 오류 메시지 | 설명 | 추천 |
|---|---|---|---|---|
| 권한 없음 | 없음 | 보조 네임스페이스에 대한 잘못된 연산입니다. 보조 네임스페이스는 읽기 전용입니다. | 읽기 전용 네임스페이스로 설정된 보조 네임스페이스에 대해 작업이 수행되었습니다. | 기본 네임스페이스에 대해 명령을 다시 시도합니다. 보조 네임스페이스에 대한 자세한 정보 |
| 권한 없음 | 없음 | MissingToken: 권한 부여 헤더를 찾을 수 없습니다. | 이 오류는 권한 부여에 null 또는 잘못된 값이 있는 경우에 발생합니다. | 권한 부여 헤더에 언급된 토큰 값이 올바르고 null이 아닌지 확인합니다. |