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 기본 계층에서는 아래 속성을 설정하거나 업데이트할 수 없습니다.
|
해당 기능을 사용하려면 기본 계층에서 표준 또는 프리미엄 계층으로 업그레이드하는 것이 좋습니다. |
| 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 구독 내에 존재하지 않습니다. | 이 오류를 해결하려면 다음을 수행합니다.
|
| 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 | 다양한 이유로 발생할 수 있습니다. 일부 증상은 다음과 같습니다.
|
이 오류를 해결하려면 다음을 수행합니다.
|
오류 코드: 권한 없음
해당 오류 클래스는 명령을 실행하기 위한 권한이 없음을 나타냅니다.
| 오류 코드 | 오류 하위 코드 | 오류 메시지 | 설명 | 권장 |
|---|---|---|---|---|
| Unauthorized | 없음 | 보조 네임스페이스에 대한 작업이 잘못되었습니다. 보조 네임스페이스는 읽기 전용입니다. | 보조 네임스페이스에 대한 작업을 수행했으며 이는 읽기 전용 네임스페이스로 설정됩니다. | 기본 네임스페이스에 대해 명령을 다시 시도합니다. 보조 네임스페이스에 대해 자세히 알아보기 |
| Unauthorized | 없음 | MissingToken: 인증 헤더를 찾을 수 없습니다. | 해당 오류는 권한 부여의 값이 Null이거나 잘못된 경우 발생합니다. | 인증 헤더에 언급된 토큰 값이 올바르고 Null이 아닌지 확인하세요. |