중요
이 API는 2021년 11월 1일 현재 사용되지 않으며 더 이상 사용되지 않아야 합니다.
새 구독을 만듭니다. 만든 구독 리소스 매니페스트는 변경할 수 없습니다. 이 작업은 idempotent가 아닙니다. 동일한 이름의 구독(동일한 토픽 및 네임스페이스 아래)이 성공적으로 만들어진 후 만들기 호출을 반복하면 409 충돌 오류 메시지가 발생합니다.
특수 문자 또는 인코딩된 문자가 포함된 이름으로 구독을 만드는 경우(예: "test? "test%3FName%3Dvalue%26"으로 인코딩되는 name=value&", (401) 권한 없는 예외가 생성됩니다.
다음 구독 이름 제한 사항에 유의하세요.
문자, 숫자, 마침표(.), 하이픈(-) 및 밑줄(_)만 포함할 수 있습니다.
여러 세그먼트가 허용되지 않습니다.
슬래시(/)는 구독 이름의 접두사 또는 접미사로 사용할 수 없습니다.
최대 문자 수는 50자입니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/Topics/Subscriptions/{Subscription Name} | HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | Description |
|---|---|
| 콘텐츠 형식 | application/xml;type=entry;charset=utf-8 |
| 네임스페이스 | 관리 엔드포인트 URL |
| x-ms-version | 2012-03-01 |
요청에는 클라이언트 인증서도 필요합니다. 이 인증서는 해당 특정 구독에 업로드한 인증서와 일치해야 합니다.
요청 본문
다음 표에서는 요청 본문의 주요 요소에 대해 설명합니다.
| 속성 이름 | 형식 | Description |
|---|---|---|
| DefaultMessageTimeToLive | XML 날짜/시간 | 배달 못한 편지가 사용되는지 여부에 따라 메시지가 지정된 시간 이상 토픽에 저장된 경우 자동으로 배달 못 한 편지 큐로 이동되거나 삭제됩니다. 메시지 TTL이 토픽에 설정된 TTL보다 작은 경우 메시지에 지정된 TTL이 이 값을 덮어씁니다. 토픽을 만든 후에는 이 값을 변경할 수 없습니다. - 범위: 1초 ~ 14일. - 기본값: 14일. |
| LockDuration | XML 날짜/시간 | 이 설정은 수신자가 처리하기 위해 메시지를 잠가야 하는 시간(초)을 결정합니다. 이 기간이 지나면 메시지 잠금이 해제되고 다음 수신기가 메시지를 사용할 수 있게 됩니다. 토픽을 만들 때만 설정할 수 있습니다. - 범위: 0~5분. 0은 메시지가 잠겨 있지 않음을 의미합니다. - 기본값: 30s. |
| RequiresSession | Boolean | 토픽을 만들 때만 설정할 수 있습니다. 로 true설정된 경우 토픽은 세션 인식이며 지원 SessionReceiver 됩니다. 세션 인식 topics REST를 통해 지원되지 않습니다.- 기본값: False입니다. |
| EnableDeadLetteringOnMessageExpiration | Boolean | 구독 작성 시에만 설정할 수 있습니다. - 기본값: False입니다. 이 필드는 Service Bus가 만료된 TTL을 사용하여 메시지를 처리하는 방법을 결정합니다. 및 메시지가 만료되면 true Service Bus는 토픽의 메시지를 해당 토픽의 배달 못한 편지 하위 큐로 이동합니다. 이면 false메시지가 토픽에서 영구적으로 삭제됩니다. |
| DeadLetteringOnFilterEvaluationExceptions | Service Bus가 구독 필터 평가 중에 예외를 일으키는 메시지를 처리하는 방법을 결정합니다. 이면 true예외를 발생시킨 메시지가 구독의 배달 못 한 편지 큐로 이동됩니다. 그렇지 않으면 삭제됩니다. 기본적으로 이 매개 변수는 true로 설정되므로 예외의 원인을 조사할 수 있습니다. 형식이 잘못된 메시지 또는 메시지 형식에 대한 필터에서 잘못된 가정이 발생할 수 있습니다. 토픽을 만들 때만 설정할 수 있습니다.- 기본값: true |
|
| EnableBatchedOperations | 특정 큐에 대한 작업을 수행할 때 서비스 쪽 일괄 처리 동작을 사용하거나 사용하지 않도록 설정합니다. 사용하도록 설정하면 Service Bus는 여러 작업을 백 엔드에 수집/일괄 처리하여 연결에서 더 효율적입니다. 작업 대기 시간을 단축하려는 경우 이 기능을 사용하지 않도록 설정할 수 있습니다. 기본값: false |
|
| MaxDeliveryCount | 부호 없는 정수 | 메시지를 배달하지 않거나 삭제하기 전에 Service Bus가 메시지를 배달하려고 시도하는 최대 횟수입니다. - 기본값: 10 |
| MessageCount | 부호 없는 정수 | 모니터링 시스템에서 보고한 대로 아직 큐에서 제거되지 않은 구독의 메시지 수를 보고합니다. |
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
응답 코드
참고
특수 또는 인코딩된 문자(예 test?Name=value&: 로 인코딩 test%3FName%3Dvalue%26되는 )가 포함된 이름으로 네임스페이스를 만들면 (401) 권한 없는 예외가 생성됩니다.
| 코드 | Description |
|---|---|
| 201 | 구독이 성공적으로 생성되었습니다. |
| 400 | 잘못된 요청 본문입니다. |
| 401 | 인증 실패 |
| 403 | 할당량을 초과했습니다. 구독이 만들어지지 않았습니다. |
| 409 | 지정한 구독이 이미 있거나 지정한 경로가 이미 사용되고 있습니다. |
| 500 | 내부 오류입니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
없음
응답 본문
PUT 요청이 구독의 모든 특성에 대한 값을 지정하지 않으면 일부 설명 속성에 기본값이 포함될 수 있으므로 구독 설명이 반환됩니다.