다음을 통해 공유

이벤트 허브 만들기

  • 아티클

새 이벤트 허브를 만듭니다. 이벤트 허브를 만들 때 다음 속성을 지정할 수 있습니다. 속성을 지정하지 않으면 Event Hubs는 이 속성의 기본값을 사용합니다. EventHubDescription 속성을 참조하세요.

속성

다음과 같이 나열된 속성 외에도 이벤트 허브 설명에 표시되지만 서비스에서 무시되는 추가 속성을 지정할 수 있습니다.

아래에 지정된 순서대로 속성을 지정해야 합니다. 순서대로 지정되지 않은 모든 속성은 사용자 속성으로 해석됩니다. 이 속성은 이벤트 허브 설명에 두 번 표시됩니다. 한 번은 사용자가 설정한 값으로, 한 번은 Event Hubs에서 사용하는 기본값으로 표시됩니다.

속성 이름 사용할 수 있는 API 버전 기본값 속성 설명
MessageRetentionInDays 2014-01 0 설명
Authorization 2014-01 (empty) 설명
Status 2014-01 Active 설명
UserMetadata 2014-01 (empty) 설명
PartitionCount 2014-01 16 설명

요청

메서드 요청 URI HTTP 버전
PUT https://{serviceNamespace}.servicebus.windows.net/{eventHubPath} HTTP/1.1

요청 헤더

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

요청 본문

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

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

응답

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

응답 코드

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

응답 본문

요청이 성공하면 응답 본문에 생성된 이벤트 허브에 대한 설명이 포함됩니다. 요청에 실패한 경우 본문에 오류 코드 및 오류 메시지가 포함됩니다.

예제

요청

참고

공통 매개 변수 및 헤더에 설명된 대로 권한 부여 헤더에 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  
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">  
    </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>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

다음 HTTP 요청은 사용자 지정 설정으로 이벤트 허브를 만듭니다.

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=your-sas-key&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
  
<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>  
      <PartitionCount>8</PartitionCount>  
    </EventHubDescription>  
  </content>  
</entry>

Event Hubs는 다음 응답을 반환합니다.

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>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>