엔터티 만들기 또는 업데이트
메시징 엔터티를 만들거나 업데이트합니다.
요청
메서드 | 요청 URI | HTTP 버전 |
---|---|---|
PUT | https://{serviceNamespace}.servicebus.windows.net/{엔터티 경로} | HTTP/1.1 |
엔터티 경로는 세그먼트가 '/'로 구분된 다중 세그먼트 이름이 될 수 있습니다. 전체 경로는 엔터티의 이름을 구성합니다. 여러 엔터티가 동일한 접두사 세그먼트를 공유할 수 있습니다.
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
요청 헤더 | Description |
---|---|
권한 부여 | "관리" 권한이 있는 SAS(공유 액세스 서명) 토큰을 지정합니다. 자세한 내용은 공유 액세스 서명을 사용한 Service Bus 인증을 참조하세요 . |
콘텐츠 형식 | application/atom+xml;type=entry;charset=utf-8로 설정합니다. |
If-Match | 엔터티를 업데이트하려면 이 헤더를 "*"로 설정합니다. 업데이트된 엔터티에 필요한 모든 속성 값을 제공해야 합니다. 제공하지 않는 값은 서비스 기본값으로 설정됩니다. 이 헤더가 누락되면 업데이트 호출에서 이 엔터티가 이미 있다는 오류를 반환합니다. |
요청 본문
요청 본문에는 생성할 엔터티에 대한 설명을 포함하는 유효한 Atom XML 항목이 포함되어야 합니다.
<?xml version="1.0" encoding="utf-8" ?>
<entry xmlns='http://www.w3.org/2005/Atom'>
<content type='application/xml'>
{description}
</content>
</entry>
여기서 {description}은 최상위 엔터티에 대한 큐 또는 토픽 또는 부모 엔터티를 기준으로 하는 구독 또는 규칙을 설명했습니다.
instance 큐는 요소로 QueueDescription
설명됩니다. 따라서 큐를 만들거나 업데이트하기 위한 XML 페이로드는 다음 형식을 사용할 수 있습니다. 따라서 생략된 모든 속성은 기본값을 가정합니다.
<?xml version="1.0" encoding="utf-8" ?>
<entry xmlns="http://www.w3.org/2005/Atom">
<content type="application/xml">
<QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
<LockDuration>T1M</LockDuration>
</QueueDescription>
</content>
</entry>
엔터티 및 엔터티와 경로의 관계에 대한 자세한 내용은 개요 를 참조하세요.
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
응답 코드
참고
특수 문자 또는 인코딩된 문자가 포함된 이름으로 엔터티를 업데이트하는 경우(예: "test? "test%3FName%3Dvalue%26"으로 인코딩되는 Name=value&") (401) 권한 없는 예외가 생성됩니다.
코드 | Description |
---|---|
201 | 엔터티가 업데이트되었습니다. |
400 | 잘못된 요청 본문입니다. |
401 | 인증 실패 |
403 | 할당량을 초과했습니다. 엔터티가 업데이트되지 않았습니다. |
500 | 내부 오류입니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
없음
응답 본문
엔터티 설명이 반환됩니다. PUT 요청에서 일부 설명 속성이 누락된 경우 기본값을 포함할 수 있습니다.