Entitás létrehozása vagy frissítéseCreate or Update Entity

Létrehoz vagy frissít egy üzenetküldési entitást.Creates or updates a messaging entity.

KérésRequest

MetódusMethod Kérés URI-jaRequest URI HTTP-verzióHTTP Version
PUTPUT https://{serviceNamespace}. servicebus. Windows. net/{entitás elérési útja}https://{serviceNamespace}.servicebus.windows.net/{Entity Path} HTTP/1.1HTTP/1.1

Az entitás elérési útja lehet egy több szegmensből álló név, a szegmensek pedig a "/" karakterrel elválasztva.The entity path can be a multi-segment name, with segments separated by '/'. Az elérési út teljes egészében az entitások neve jelenik meg.The entirety of the path makes up the name of the entities. Több entitás is megoszthatja ugyanazt az előtag-szegmenst.Multiple entities can share the same prefix segments.

Kérések fejléceiRequest Headers

A következő táblázat ismerteti a kötelező és választható kérelmek fejléceit.The following table describes required and optional request headers.

Kérelem fejléceRequest Header LeírásDescription
EngedélyezésAuthorization A "Manage" jogokkal rendelkező közös hozzáférésű aláírási (SAS) tokent adja meg.Specifies a Shared Access Signature (SAS) token with "Manage" rights. A részletekért lásd: Service Bus hitelesítés közös hozzáférési aláírásokkal .See Service Bus authentication with Shared Access Signatures for details.
Content-TypeContent-Type Az Application/Atom + XML; típus = Entry; charset = UTF-8értékre van állítva.Set to application/atom+xml;type=entry;charset=utf-8.
If-MatchIf-Match Állítsa ezt a fejlécet "*" értékre az entitás frissítéséhez.Set this header to “*” to update the entity. Meg kell adnia az összes, a frissített entitáson kívánt tulajdonságértékeket.You must provide all the property values that are desired on the updated entity. A nem megadott értékek a szolgáltatás alapértelmezett értékeire vannak beállítva.Any values not provided are set to the service default values. Ha ez a fejléc hiányzik, a frissítési hívás egy hibaüzenetet ad vissza, amely azt jelzi, hogy ez az entitás már létezik.If this header is missing, the update call returns an error indicating that this entity already exists.

Kérelem törzseRequest Body

A kérelem törzsének tartalmaznia kell egy érvényes Atom XML-bejegyzést, amely beágyazza a létrehozandó entitás leírását.The body of the request must contain a valid Atom XML entry that embeds the description of the entity that shall be created

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {description}  
  </content>  
</entry>  

Ha a {Description} a legfelső szintű entitásokra vonatkozó üzenetsor vagy témakör, vagy egy előfizetéshez vagy szabályhoz kapcsolódik a fölérendelt entitásokhoz képest.whereby the {description} described either a Queue or a Topic for top-level entities, or a subscription or rule relative to their parent entities.

Az üzenetsor (például) egy elemmel van leírva QueueDescription .A queue, for instance, is described with a QueueDescription element. A várólista létrehozásához vagy frissítéséhez használt XML-adattartalom ezért a következő formában jelenhet meg, így az összes kihagyott tulajdonság feltételezi az alapértelmezett értékeket:The XML payload for creating or updating a queue therefore may take the following form, whereby all omitted properties assume their default values:

<?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>  

Az entitásokkal és azok elérési útjaival kapcsolatos további részletekért tekintse meg az áttekintést .See the Overview for more details on entities and how they relate to paths.

VálaszResponse

A válasz tartalmazza a HTTP-állapotkódot és a válasz fejlécek egy készletét.The response includes an HTTP status code and a set of response headers.

Reagálási kódokResponse Codes

Megjegyzés

Ha olyan entitást frissít, amelynek neve speciális vagy kódolt karaktereket tartalmaz (például "test? A name = Value& "), amely a" test% 3FName% 3Dvalue %26 ") kódolással lesz kódolva, a (z) (401) jogosulatlan kivétel jön létre.If you update an entity with a name containing special or encoded characters (for example, "test?Name=value&"), which gets encoded to "test%3FName%3Dvalue%26"), a (401) unauthorized exception will be generated.

CodeCode LeírásDescription
201201 Az entitás frissítve.Entity updated.
400400 Érvénytelen a kérelem törzse.Invalid request body.
401401 Engedélyezési hiba.Authorization failure.
403403 Kvóta túllépve; az entitás nem frissült.Quota exceeded; entity not updated.
500500 Belső hiba történt.Internal error.

Az állapotkódok részletes ismertetését lásd: állapot-és hibakódok.For information about status codes, see Status and Error Codes.

VálaszfejlécekResponse Headers

Nincsenek.None.

Válasz törzseResponse Body

A rendszer az entitás leírását adja vissza.The entity description is returned. Egyes leírási tulajdonságok tartalmazhatják az alapértelmezett értékeket, ha hiányoznak az PUT kérelemből.Some description properties might contain default values if they were missing from the PUT request.