이벤트 허브 업데이트

아티클
08/05/2023

이벤트 허브를 업데이트. 이벤트 허브를 업데이트할 때 여기에 나열된 속성만 변경할 수 있습니다. 다른 속성을 변경하려고 시도하면 오류가 발생합니다. 변경할 수 있지만 지정되지 않은 속성은 기본값으로 설정됩니다.

속성

속성 이름	사용할 수 있는 API 버전	기본값	속성 설명
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

요청

메서드	요청 URI
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`

요청 헤더

Event Hubs와 관련된 모든 요청에 사용되는 헤더 및 매개 변수에 대한 일반적인 매개 변수 및 헤더를 참조하세요.

추가 요청 헤더

요청 헤더	필수 또는 선택 사항	Description
If-Match	필수	이 헤더를 "*"로 설정하여 이벤트 허브를 업데이트합니다. 업데이트된 이벤트 허브에서 원하는 모든 속성 값을 제공해야 합니다. 제공되지 않은 모든 값은 서비스 기본값으로 설정됩니다. 이 헤더가 없는 경우 업데이트 호출은 이 이벤트 허브가 이미 있음을 나타내는 오류를 반환합니다.

요청 본문

내용에 설명이 포함된 ATOM 항목입니다. 예를 들면 다음과 같습니다.

<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {EventHubDescription}  
  </content>  
</entry>

응답

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

응답 코드

코드	Description
200	성공.
400	잘못된 요청입니다.
401	인증 실패
409	If-Match 헤더가 누락되어 충돌합니다.
500	내부 오류입니다.

응답 본문

요청이 성공하면 응답 본문에 이벤트 허브 설명이 포함됩니다. PUT 요청에서 누락된 속성이 기본값으로 반환됩니다. 요청이 성공하지 못하면 본문에 오류 코드와 오류 메시지가 포함됩니다.

요소 이름	설명
`AuthorizationRules`	권한 부여 규칙입니다.
`MessageRetentionInDays`	이 이벤트 허브에 대한 이벤트를 보존할 일 수입니다.
`Status`	이벤트 허브의 현재 상태(사용 또는 사용 안 함)입니다.
`CreatedAt`	이벤트 허브를 만든 정확한 시간입니다.
`UpdatedAt`	이벤트 허브가 업데이트된 정확한 시간입니다.
`PartitionCount`	이벤트 허브의 현재 파티션 수입니다.
`PartitionIds`	이벤트 허브에 대해 만든 파티션의 식별자입니다.

예제

요청

참고

공통 매개 변수 및 헤더에 설명된 대로 권한 부여 헤더에 Azure Active Directory 토큰을 사용할 수도 있습니다. 예: Authorization: Bearer <Azure AD token>

PUT https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=tYu8qdH563Pc96Lky0SFs5PhbGnljF7mLYQwCZmk9M0%3d&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net
If-Match: *
Content-Length: 264  
Expect: 100-continue  
Connection: Keep-Alive  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
    </EventHubDescription>  
  </content>  
</entry>

응답

HTTP/1.1 201 Created  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Wed, 25 Jun 2014 22:43:27 GMT  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <id>https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01</id>  
  <title type="text">your-event-hub</title>  
  <published>2014-06-25T22:43:16Z</published>  
  <updated>2014-06-25T22:43:27Z</updated>  
  <author>  
     <name>your-namespace</name>  
  </author>  
  <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01"/>  
  <content type="application/xml">  
    <EventHubDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
        <MessageRetentionInDays>3</MessageRetentionInDays>  
    </EventHubDescription>  
  </content>  
</entry>

다음을 통해 공유