Crea argomento

  • Articolo

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 risorse recupera questa 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

La richiesta richiede 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 proprietà Tipo Obbligatoria Descrizione
MaxTopicSizeInMegaBytes Unsigned Integer Obbligatorio. Questo parametro specifica la dimensione massima dell'argomento in megabyte. Qualsiasi tentativo di accodamento di un messaggio che fa sì che l'argomento superi questo valore non riesca. 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 al fatto che l'invio di messaggi non recapitabili sia abilitato, se un messaggio è stato archiviato nell'argomento per più del tempo specificato, viene automaticamente spostato nella coda dei messaggi non recapitabili o 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 il bus di servizio gestisce un messaggio con un TTL scaduto. Se è abilitato e un messaggio scade, il bus di servizio sposta il messaggio dall'argomento alla coda secondaria 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 il 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.