다음을 통해 공유


엔터티 만들기 또는 업데이트

메시징 엔터티를 만들거나 업데이트합니다.

요청

메서드 요청 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 요청에서 일부 설명 속성이 누락된 경우 기본값을 포함할 수 있습니다.