Crea argomento

Importante

Questa API è obsoleta e ritirata a partire dal 11/1/2021 e non deve più essere usata.

Crea un nuovo argomento. Dopo la creazione, il manifesto delle risorse dell'argomento non può essere modificato. Questa operazione è idempotente. Se si ripete la chiamata di creazione dopo che è stata creata una coda con lo stesso nome, verrà generato un messaggio di errore di conflitto 409.

Tenere presente quanto segue:

  • L'argomento non viene eliminato immediatamente. Viene contrassegnato per l'eliminazione e l'agente di gestione delle risorse recupera la richiesta di eliminazione entro 5 minuti. L'interfaccia utente, tuttavia, dovrebbe rispecchiare immediatamente questa operazione, in base al codice HTTP ricevuto.

  • Il nome dell'argomento è effettivamente il percorso dell'URI. L'espressione regolare seguente convalida ogni segmento nel percorso dell'URI dopo la rimozione di possibile codifica di tipo %.

  • Il nome dell'argomento deve essere conforme all'espressione regolare seguente.

    public static readonly Regex SafeMessagingEntityNameExpression = new Regex(@"^[\w-\.\$]*/?$", RegexOptions.Compiled | RegexOptions.ECMAScript);

    Ciò comporta quanto segue:

    • Nei segmenti di entità possono essere inclusi solo lettere, numeri, punti (.), trattini (-) e caratteri di sottolineatura (_).

    • Sono consentiti più segmenti (ad esempio, se il nome della coda = "a/b/c", contiene tre segmenti).

    • La barra (/) non è consentita come prefisso o suffisso del nome della coda.

    • Il numero massimo di caratteri consentiti è 50.

Richiesta

Metodo URI richiesta Versione HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/{Percorso argomento} HTTP/1.1

Intestazioni richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Content-Type application/xml;type=entry;charset=utf-8
x-ms-version 2012-03-01

Tenere presente che per la richiesta è necessario anche un certificato client. Questo certificato deve corrispondere a quello caricato per la sottoscrizione specifica.

Corpo della richiesta

Nella tabella seguente vengono descritti gli elementi chiave del corpo della richiesta:

Nome della proprietà Tipo Obbligatorio Descrizione
MaxTopicSizeInMegaBytes Unsigned Integer Obbligatorio. Questo parametro specifica la dimensione massima dell'argomento in megabyte. Qualsiasi tentativo di accodare un messaggio che comporti il superamento di tale valore nell'argomento avrà esito negativo. Per il calcolo di questo valore viene considerato solo il contenuto utente. Può essere impostato in fase di creazione dell'argomento e in fase di esecuzione:

- Intervallo: 1-5*1024.

- Impostazione predefinita: 1*1024.
TopicSizeinBytes Unsigned Integer Sola lettura. Non necessario in fase di creazione. Questo parametro indica il numero effettivo di byte attualmente occupati dai messaggi nell'argomento rispetto alla quota dell'argomento.

Intervallo: 0 – MaxTopicSizeinMegaBytes
DefaultMessageTimeToLive Datetime XML facoltativo. In base all'abilitazione o meno della gestione messaggi non recapitabili, se un messaggio è stato archiviato nell'argomento per un periodo di tempo superiore a quello specificato, verrà spostato automaticamente alla coda di messaggi non recapitabili o verrà eliminato. Questo valore viene sovrascritto dalla durata TTL specificata per il messaggio se tale durata è inferiore a quella specificata per l'argomento. Questo valore non può essere modificato dopo la creazione dell'argomento:

- Intervallo: 1 secondo - 14 giorni.

- Impostazione predefinita: 14 giorni.
RequiresDuplicateDetection Boolean facoltativo. Può essere impostata solo al momento della creazione dell'argomento.

- Impostazione predefinita per l'argomento durevole: False.
EnableDeadLetteringOnMessageExpiration Boolean facoltativo. Può essere impostata solo al momento della creazione dell'argomento.

- Impostazione predefinita: False.

Questo campo determina il modo in cui bus di servizio gestisce un messaggio con un TTL scaduto. Se è abilitato e un messaggio scade, bus di servizio sposta il messaggio dall'argomento nella sottoquery dei messaggi non recapitabili per tale argomento. Se è disabilitata, il messaggio viene eliminato definitivamente dall'argomento.
DuplicateDetectionHistoryTimeWindow Intervallo di tempo facoltativo. Proprietà che specifica l'intervallo di tempo durante il quale bus di servizio rileva la duplicazione dei messaggi.

- Intervallo: 1 secondo - 7 giorni.

- Impostazione predefinita: 10 minuti.
NumberOfSubscriptions Integer Sola lettura. Non necessario in fase di creazione. Numero di sottoscrizioni all'argomento.
Status string Sola lettura. Uno dei valori seguenti:

- Creazione: quando è ancora in fase di creazione.
- Attivo: per impostazione predefinita dopo la creazione o quando l'utente lo attiva dopo l'ultima sospensione.
- Sospeso: quando l'utente aggiorna l'entità da sospendere.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Nota

Se si crea un argomento con un nome contenente caratteri speciali o codificati (ad esempio, test?Name=value&, codificato in test%3FName%3Dvalue%26), viene generata un'eccezione non autorizzata (401).

Codice Descrizione
201 Argomento creato correttamente.
400 Corpo della richiesta non valido.
401 Errore di autorizzazione.
403 Quota superata, coda non aggiornata.
500 Errore interno.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni della risposta

Intestazione di risposta Descrizione
Content-Type application/xml;type=entry;charset=utf-8

Corpo della risposta

Viene restituita la descrizione dell'argomento, poiché eventuali proprietà mancanti dalla richiesta PUT potrebbero contenere valori predefiniti.