큐 만들기

  • 아티클

중요

이 API는 2021년 11월 1일 현재 사용되지 않으며 더 이상 사용되지 않아야 합니다.

새 큐를 만듭니다. 큐를 만든 후에는 큐 리소스 매니페스트를 변경할 수 없습니다. 이 작업은 idempotent 방식입니다. 같은 이름의 큐를 만든 후에 만들기 호출을 반복하면 409 충돌 오류 메시지가 표시됩니다.

요청

메서드 요청 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
x-ms-version 2012-03-01

요청에는 클라이언트 인증서도 필요합니다. 이 인증서는 해당 특정 구독에 업로드한 인증서와 일치해야 합니다.

요청 본문

다음 표에서는 요청 본문의 주요 요소에 대해 설명합니다.

속성 이름 형식 필수 Description
MaxQueueSizeInMegaBytes 부호 없는 정수 필수 이 매개 변수는 최대 큐 크기를 MB 단위로 지정합니다. 큐가 이 값을 초과하도록 하는 메시지를 큐에 추가하려는 시도는 실패합니다. 사용자 콘텐츠만 이 값을 계산할 때 포함됩니다. 큐를 만들 때와 런타임에 설정 가능합니다.

- 범위: 1-5*1024.

- 기본값: 1*1024.
QueueSizeinBytes 부호 없는 정수 읽기 전용입니다. 만들 때는 필요하지 않습니다. 이 매개 변수는 큐에 있는 메시지가 현재 큐 할당량에서 차지하는 실제 바이트를 반영합니다.

범위: 0 –MaxTopicSizeinMegaBytes
QueueDepth 부호 없는 정수 읽기 전용입니다. 만들 때는 필요하지 않습니다. 이 매개 변수는 현재 큐에 있는 메시지 수를 표시합니다.
DefaultMessageTimeToLive XML 날짜/시간 선택적 요소로, 기본값은 14일입니다. 배달 못한 편지 사용 여부에 따라 메시지가 지정된 시간 이상 큐에 저장된 경우 자동으로 배달 못한 편지 큐로 이동되거나 삭제됩니다. 메시지 TTL이 큐에 설정된 TTL보다 작은 경우 메시지에 지정된 TTL이 이 값을 덮어씁니다. 큐를 만든 후에는 이 값을 변경할 수 없습니다.

- 범위: 1초 ~ 14일.

- 기본값: 14일.
LockDuration XML 날짜/시간 선택적 요소로, 기본값은 30초입니다. 이 설정은 수신기가 처리할 수 있도록 메시지를 잠가야 하는 시간(초)을 결정합니다. 이 기간이 지나면 메시지 잠금이 해제되고 다음 수신기가 메시지를 사용할 수 있게 됩니다. 큐를 만들 때에만 설정할 수 있습니다.

- 범위: 0~5분. 0은 메시지가 잠겨 있지 않음을 의미합니다.

- 기본값: 30초.
RequiresSession Boolean 선택 사항 큐를 만들 때에만 설정할 수 있습니다. 로 true설정하면 큐가 세션을 인식하고 만 SessionReceiver 지원됩니다. 세션 인식 큐는 REST를 통해 지원되지 않습니다.

- 기본값: False입니다.
RequiresDuplicateDetection Boolean 선택 사항 큐를 만들 때에만 설정할 수 있습니다.

- 지속성 큐의 기본값: false.
EnableDeadLetteringOnMessageExpiration Boolean 선택 사항 큐를 만들 때에만 설정할 수 있습니다.

- 기본값: false입니다.

이 필드는 Service Bus가 만료된 TTL을 사용하여 메시지를 처리하는 방법을 결정합니다. true이고 메시지가 만료되면 Service Bus는 큐에서 큐의 배달 못한 편지 하위 큐로 메시지를 이동합니다. false이면 메시지가 큐에서 영구적으로 삭제됩니다.
DuplicateDetectionHistoryTimeWindow 시간 범위 선택 사항입니다. Service Bus에서 메시지 중복을 검색하는 시간 범위를 지정하는 속성입니다.

- 범위: 1초~7일.

- 기본값: 10분.
상태 문자열 읽기 전용입니다. 만들 때는 필요하지 않습니다. 다음 값 중 하나일 수 있습니다.

  • Active
  • 만드는 중
  • 삭제 중
  • ReceiveDisabled
  • SendDisabled
  • 사용 안 함
  • 이름 바꾸기
  • 복원 중
  • Unknown

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

응답 코드

참고

"test?Name=value&"("test%3FName%3Dvalue%26"으로 인코딩됨)처럼 특수 문자나 인코딩된 문자를 포함하는 이름으로 큐를 만들면 (400) 잘못된 요청 예외가 생성됩니다.

코드 Description
201 큐를 만들었습니다.
400 잘못된 요청 본문입니다.
401 인증 실패
403 할당량을 초과했습니다. 큐가 만들어지지 않았습니다.
409 지정한 큐가 이미 있거나 지정한 경로가 이미 사용되고 있습니다.
500 내부 오류입니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.

응답 헤더

없음

응답 본문

큐 설명이 반환됩니다. PUT 요청에서 누락된 일부 설명 속성의 경우 기본값을 포함할 수 있습니다.