Eseményközpont frissítése

eseményközpont Frissítések. Eseményközpont frissítésekor csak az itt felsorolt tulajdonságokat módosíthatja. A többi tulajdonság módosítására tett kísérlet hibát eredményez. Azok a tulajdonságok, amelyek módosíthatók, de nincsenek megadva, az alapértelmezett értékekre vannak beállítva.

Tulajdonságok

Tulajdonság neve	Az API-verzió óta elérhető	Alapértelmezett	Tulajdonságleírás
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Kérés

Metódus	Kérés URI-ja
PUT	https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

Kérelemfejlécek

Tekintse meg az Event Hubshoz kapcsolódó összes kérés által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

További kérelemfejlécek

Kérelem fejléce	Kötelező vagy nem kötelező	Description
If-Match	Kötelező	Állítsa ezt a fejlécet "*" értékre az eseményközpont frissítéséhez. Meg kell adnia az összes kívánt tulajdonságértéket a frissített eseményközpontban; a nem megadott értékek a szolgáltatás alapértelmezett értékeire vannak beállítva. Ha ez a fejléc hiányzik, akkor a frissítési hívás hibát ad vissza, amely azt jelzi, hogy ez az eseményközpont már létezik.

Kérelem törzse

Atombejegyzés a tartalomba ágyazott leírással. Például:

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

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Válaszkódok

Code	Description
200	Sikeres művelet.
400	Rossz kérés.
401	Engedélyezési hiba.
409	Ütközés a hiányzó If-Match fejléc miatt.
500	Belső hiba történt.

Válasz törzse

Ha a kérés sikeres, a válasz törzse tartalmazza az eseményközpont leírását. A PUT kérelemből hiányzó tulajdonságokat a rendszer az alapértelmezett értékekkel adja vissza. Ha a kérés nem sikerül, a törzs tartalmaz egy hibakódot és egy hibaüzenetet.

Elem neve	Description
AuthorizationRules	Az engedélyezési szabályok.
MessageRetentionInDays	Az eseményközpont eseményeinek megőrzéséhez szükséges napok száma.
Status	Az eseményközpont aktuális állapota (engedélyezve vagy letiltva).
CreatedAt	Az eseményközpont létrehozásának pontos időpontja.
UpdatedAt	Az eseményközpont frissítésének pontos időpontja.
PartitionCount	Az eseményközpont partícióinak aktuális száma.
PartitionIds	Az eseményközponthoz létrehozott partíciók azonosítójai.

Példák

Kérés

Megjegyzés

Azure Active Directory-jogkivonatot is használhat az Engedélyezési fejléchez a Gyakori paraméterek és fejlécek részben leírtak szerint. Példa: 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>  

Válasz

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>