큐 업데이트
중요
이 API는 2021년 11월 1일 현재 사용되지 않으며 더 이상 사용되지 않아야 합니다.
큐 설명을 업데이트 해당 DB 항목을 업데이트하기 위해 업데이트 상태 FE/BE로 보냅니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path} | HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | Description |
|---|---|
| 콘텐츠 형식 | application/xml;type=entry;charset=utf-8 |
| If-Match | * |
| x-ms-version | 2012-03-01 |
요청에는 클라이언트 인증서도 필요합니다. 이 인증서는 해당 특정 구독에 업로드한 인증서와 일치해야 합니다.
요청 본문
다음 표에서는 요청 본문의 주요 요소에 대해 설명합니다. 이러한 속성만 업데이트할 수 있습니다. 하나의 속성만 변경하더라도 본문에 전체 큐 설명이 포함되어야 합니다. 다음과 같은 순서로 작업을 수행하는 것이 좋습니다.
큐 설명을 가져옵니다.
필수 요소를 업데이트합니다.
업데이트된 설명을 전달합니다.
| 속성 이름 | 형식 | Description |
|---|---|---|
| authorizationRules | AuthorizationRule[] | 권한 부여 규칙의 배열입니다. |
| autoDeleteOnIdle | 문자열 | 특정 시간 동안 유휴 상태일 때 엔터티를 자동으로 삭제할지 여부를 나타냅니다. |
| deadLetteringOnMessageExpiration | Boolean | 큐를 만들 때에만 설정할 수 있습니다. - 기본값: False입니다. 이 필드는 Service Bus가 만료된 TTL을 사용하여 메시지를 처리하는 방법을 제어합니다. true이고 메시지가 만료되면 Service Bus는 큐에서 큐의 배달 못한 편지 하위 큐로 메시지를 이동합니다. false이면 메시지가 큐에서 영구적으로 삭제됩니다. |
| defaultMessageTtl | XML 날짜/시간 | 배달 못한 편지의 사용 여부에 따라 메시지가 지정된 시간 이상 큐에 저장된 경우 자동으로 배달 못한 편지 큐로 이동되거나 삭제됩니다. 메시지 TTL이 큐에 설정된 TTL보다 작은 경우 메시지에 지정된 TTL이 이 값을 덮어씁니다. 큐를 만든 후에는 이 값을 변경할 수 없습니다. - 범위: 1초 ~ 14일. - 기본값: 14일. |
| duplicateDetectionHistoryTimeWindow | 시간 범위 | Service Bus에서 메시지 중복을 검색하는 시간 범위를 지정하는 속성입니다. - 범위: 1초~7일 - 기본값: 10분 |
| enableBatchedOperations | Boolean | 일괄 처리 작업을 사용할지 여부를 나타냅니다. |
| forwardDeadLetteredMessagesTo | 문자열 | 배달 못한 편지 메시지를 전달할 위치를 지정합니다. |
| forwardTo | 문자열 | 메시지를 전달할 위치를 지정합니다. |
| lockDuration | XML 날짜/시간 | 이 설정은 수신기가 처리할 수 있도록 메시지를 잠가야 하는 시간(초)을 결정합니다. 이 기간이 지나면 메시지 잠금이 해제되고 다음 수신기가 메시지를 사용할 수 있게 됩니다. 큐를 만들 때에만 설정할 수 있습니다. - 범위: 0~5분. 0은 메시지가 잠겨 있지 않음을 의미합니다. - 기본값: 30초 |
| maxDeliveryCount | 부호 없는 정수 | 배달 못 한 편지 또는 삭제되기 전에 Service Bus가 메시지를 배달하려고 시도하는 최대 횟수입니다. 기본값은 10입니다. |
| maxSizeInMegabytes | 부호 없는 정수 | 최대 크기(메가바이트)입니다. |
| status | EntityStatus | 엔터티의 상태입니다. |
| userMetadata | 문자열 | 사용자 메타데이터. |
, , requiresDuplicateDetectionenablePartitioning및 name속성을 업데이트requireSession할 수 없습니다.
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
응답 코드
참고
특수 또는 인코딩된 문자가 포함된 이름으로 큐를 만드는 경우(예: "test? "test%3FName%3Dvalue%26"으로 인코딩되는 Name=value&"에서 (401) 권한 없는 예외가 생성됩니다.
| 코드 | Description |
|---|---|
| 200 | 큐 설명을 업데이트했습니다. |
| 401 | 인증 실패 |
| 404 | 이 네임스페이스에 엔터티가 없습니다. |
| 500 | 내부 오류입니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
없음
응답 본문
없음