Skapa en prenumeration

Viktigt

Det här API: et är föråldrat och har dragits tillbakafrån och med 2021-01-11 och bör inte längre användas.

Skapar en ny prenumeration. När prenumerationsresursmanifestet har skapats kan det inte ändras. Den här åtgärden är inte idempotent. Om du upprepar anropet skapa efter att en prenumeration med samma namn (under samma ämne och namnområde) har skapats, resulterar det i ett 409 Konflikt-felmeddelande.

Om du skapar en prenumeration med ett namn som innehåller särskilda eller kodade tecken (till exempel "test? Name=value&", som kodas till "test%3FName%3Dvalue%26"), genereras ett (401) otillåtet undantag.

Observera följande begränsningar för prenumerationsnamn:

1. Får endast innehålla bokstäver, siffror, punkter (.), bindestreck (-) och understreck (_).

2. Flera segment tillåts inte.

3. Snedstreck (/) tillåts inte som prefix eller suffix för prenumerationsnamnet.

4. Maximalt antal tecken är 50.

Förfrågan

Metod	URI för förfrågan	HTTP-version
PUT	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/Topics/Subscriptions/{Prenumerationsnamn}	HTTP/1.1

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Description
Content-Type	application/xml;type=entry; charset=utf-8
Namnområde	URL för hanteringsslutpunkt
x-ms-version	2012-03-01

Begäran kräver också ett klientcertifikat. Det här certifikatet måste matcha certifikatet som du laddade upp för den specifika prenumerationen.

Begärandetext

I följande tabell beskrivs de viktigaste elementen i begärandetexten:

Egenskapens namn	Typ	Description
DefaultMessageTimeToLive	XML Datetime	Baserat på om obeställbara bokstäver är aktiverat, om ett meddelande har lagrats i ämnet under mer än den angivna tiden flyttas det automatiskt till kön med obeställbara meddelanden eller tas bort. Det här värdet skrivs över av en TTL som anges i meddelandet om TTL-värdet för meddelandet är mindre än TTL-värdet som angetts för ämnet. Det här värdet kan inte ändras när ämnet har skapats: - Intervall: 1 sekund – 14 dagar. – Standard: 14 dagar.
LockDuration	XML Datetime	Den här inställningen anger hur lång tid i sekunder ett meddelande ska låsas för bearbetning av en mottagare. Efter den här perioden är meddelandet olåst och tillgängligt för användning av nästa mottagare. Endast inställningsbar när ämnet skapas: – Intervall: 0–5 min. 0 innebär att meddelandet inte är låst. – Standard: 30-talet.
RequiresSession	Boolesk	Kan endast användas när ämnet skapas. Om det är inställt på trueär ämnet sessionsmedveten och stöds bara SessionReceiver . Sessionsmedvetna ämnen stöds inte via REST. - Standard: Falskt.
EnableDeadLetteringOnMessageExpiration	Boolesk	Kan endast användas när prenumerationen skapas. - Standard: Falskt. Det här fältet bestämmer hur Service Bus hanterar ett meddelande med en TTL som har upphört att gälla. Om true och ett meddelande upphör att gälla flyttar Service Bus meddelandet från ämnet till underfrågan obeställbara meddelanden för det ämnet. Om falsetas meddelandet bort permanent från ämnet.
DeadLetteringOnFilterEvaluationExceptions		Avgör hur Service Bus hanterar ett meddelande som orsakar ett undantag under en utvärdering av prenumerationsfilter. Om trueflyttas meddelandet som orsakade undantaget till prenumerationens obeställbara kö. Annars tas den bort. Som standard är den här parametern inställd på true, vilket gör att du kan undersöka orsaken till undantaget. Det kan bero på ett felaktigt meddelande eller felaktiga antaganden som görs i filtret om meddelandets form. Kan endast användas när ämnet skapas. - Standard: true
EnableBatchedOperations		Aktiverar eller inaktiverar batchbearbetningsbeteende på tjänstsidan när åtgärder utförs för den specifika kön. När den är aktiverad samlar Service Bus in/batchar flera åtgärder till serverdelen för att vara mer effektiv i anslutningen. Om du vill ha kortare svarstider för åtgärder kan du inaktivera den här funktionen. Standard: false
MaxDeliveryCount	Osignerat heltal	Det maximala antalet gånger Som Service Bus försöker leverera ett meddelande innan meddelandet tas bort eller tas bort. - Standard: 10
MessageCount	Osignerat heltal	Rapporterar antalet meddelanden i prenumerationen som inte har dequeued ännu, enligt rapporter från övervakningssystemet.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Svarskoder

Anteckning

Om du skapar ett namnområde med ett namn som innehåller särskilda eller kodade tecken (till exempel test?Name=value&, som kodas till test%3FName%3Dvalue%26), genereras ett (401) undantagsfel av typen Obehörig.

Kod	Description
201	Prenumerationen har skapats.
400	Ogiltig begärandetext.
401	Auktoriseringsfel.
403	Kvoten har överskridits. prenumerationen har inte skapats.
409	Den angivna prenumerationen finns redan (eller så är den angivna sökvägen redan upptagen).
500	Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Inga.

Svarstext

Prenumerationsbeskrivningen returneras, eftersom när PUT-begäran inte anger värden för alla attribut i prenumerationen kan vissa beskrivningsegenskaper innehålla standardvärden.