Topics - Get
Ottenere un argomento.
Ottiene le proprietà di un argomento.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}?api-version=2022-06-15
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione dell'utente. |
subscription
|
path | True |
string |
Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio. |
topic
|
path | True |
string |
Nome dell'argomento. |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Risposte di errore:
|
Esempio
Topics_Get
Esempio di richiesta
Risposta di esempio
{
"properties": {
"endpoint": "https://exampletopic2.westcentralus-1.eventgrid.azure.net/api/events",
"provisioningState": "Succeeded"
},
"id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2",
"location": "westcentralus",
"name": "exampletopic2",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"type": "Microsoft.EventGrid/topics"
}
Definizioni
Nome | Descrizione |
---|---|
Connection |
Informazioni di ConnectionState. |
created |
Tipo di identità che ha creato la risorsa. |
Data |
Data Residency Limite della risorsa. |
Identity |
Informazioni sull'identità per la risorsa. |
Identity |
Tipo di identità gestita usata. Il tipo "SystemAssigned, UserAssigned" include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà qualsiasi identità. |
Inbound |
|
Input |
Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nella risorsa di dominio di Griglia di eventi. |
Ip |
Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. |
Json |
Viene usato per esprimere l'origine di un mapping dello schema di input per un singolo campo di destinazione nello schema di eventi di Griglia di eventi. Attualmente viene usato nei mapping per le proprietà 'id', 'topic' e 'eventtime'. Rappresenta un campo nello schema degli eventi di input. |
Json |
Viene usato per esprimere l'origine di un mapping dello schema di input per un singolo campo di destinazione nello schema di eventi di Griglia di eventi. Attualmente viene usato nei mapping per le proprietà 'subject', 'eventtype' e 'dataversion'. Rappresenta un campo nello schema degli eventi di input insieme a un valore predefinito da usare e almeno una di queste due proprietà deve essere fornita. |
Json |
Ciò consente la pubblicazione in Griglia di eventi usando uno schema di input personalizzato. Può essere usato per eseguire il mapping delle proprietà da uno schema JSON di input personalizzato allo schema di eventi di Griglia di eventi. |
Persisted |
Stato della connessione. |
Private |
Informazioni privateEndpoint. |
Private |
|
Public |
Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando |
Resource |
Stato di provisioning della connessione dell'endpoint privato. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Topic |
Argomento eventgrid |
Topic |
Stato di provisioning dell'argomento. |
User |
Informazioni sull'identità utente. |
ConnectionState
Informazioni di ConnectionState.
Nome | Tipo | Descrizione |
---|---|---|
actionsRequired |
string |
Azioni necessarie (se presenti). |
description |
string |
Descrizione dello stato della connessione. |
status |
Stato della connessione. |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataResidencyBoundary
Data Residency Limite della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
WithinGeopair |
string |
|
WithinRegion |
string |
IdentityInfo
Informazioni sull'identità per la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string |
ID principale dell'identità della risorsa. |
tenantId |
string |
ID tenant della risorsa. |
type |
Tipo di identità gestita usata. Il tipo "SystemAssigned, UserAssigned" include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà qualsiasi identità. |
|
userAssignedIdentities |
<string,
User |
Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Questa proprietà non è attualmente utilizzata e riservata per l'utilizzo futuro. |
IdentityType
Tipo di identità gestita usata. Il tipo "SystemAssigned, UserAssigned" include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà qualsiasi identità.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
InboundIpRule
Nome | Tipo | Descrizione |
---|---|---|
action |
Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. |
|
ipMask |
string |
Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0/8. |
InputSchema
Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nella risorsa di dominio di Griglia di eventi.
Nome | Tipo | Descrizione |
---|---|---|
CloudEventSchemaV1_0 |
string |
|
CustomEventSchema |
string |
|
EventGridSchema |
string |
IpActionType
Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask.
Nome | Tipo | Descrizione |
---|---|---|
Allow |
string |
JsonField
Viene usato per esprimere l'origine di un mapping dello schema di input per un singolo campo di destinazione nello schema di eventi di Griglia di eventi. Attualmente viene usato nei mapping per le proprietà 'id', 'topic' e 'eventtime'. Rappresenta un campo nello schema degli eventi di input.
Nome | Tipo | Descrizione |
---|---|---|
sourceField |
string |
Nome di un campo nello schema degli eventi di input da usare come origine di un mapping. |
JsonFieldWithDefault
Viene usato per esprimere l'origine di un mapping dello schema di input per un singolo campo di destinazione nello schema di eventi di Griglia di eventi. Attualmente viene usato nei mapping per le proprietà 'subject', 'eventtype' e 'dataversion'. Rappresenta un campo nello schema degli eventi di input insieme a un valore predefinito da usare e almeno una di queste due proprietà deve essere fornita.
Nome | Tipo | Descrizione |
---|---|---|
defaultValue |
string |
Valore predefinito da usare per il mapping quando un oggetto SourceField non viene specificato o se non è presente alcuna proprietà con il nome specificato nel payload dell'evento JSON pubblicato. |
sourceField |
string |
Nome di un campo nello schema degli eventi di input da usare come origine di un mapping. |
JsonInputSchemaMapping
Ciò consente la pubblicazione in Griglia di eventi usando uno schema di input personalizzato. Può essere usato per eseguire il mapping delle proprietà da uno schema JSON di input personalizzato allo schema di eventi di Griglia di eventi.
Nome | Tipo | Descrizione |
---|---|---|
inputSchemaMappingType |
string:
Json |
Tipo di mapping personalizzato |
properties.dataVersion |
Informazioni di mapping per la proprietà DataVersion dell'evento di Griglia di eventi. |
|
properties.eventTime |
Informazioni di mapping per la proprietà EventTime dell'evento di Griglia di eventi. |
|
properties.eventType |
Informazioni di mapping per la proprietà EventType dell'evento di Griglia di eventi. |
|
properties.id |
Informazioni di mapping per la proprietà Id dell'evento di Griglia di eventi. |
|
properties.subject |
Informazioni di mapping per la proprietà Subject dell'evento di Griglia di eventi. |
|
properties.topic |
Informazioni di mapping per la proprietà Topic dell'evento di Griglia di eventi. |
PersistedConnectionStatus
Stato della connessione.
Nome | Tipo | Descrizione |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateEndpoint
Informazioni privateEndpoint.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Identificatore arm per endpoint privato. |
PrivateEndpointConnection
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Identificatore completo della risorsa. |
name |
string |
Nome della risorsa. |
properties.groupIds |
string[] |
GroupIds dalla risorsa del servizio di collegamento privato. |
properties.privateEndpoint |
Risorsa endpoint privato per la connessione. |
|
properties.privateLinkServiceConnectionState |
Dettagli sullo stato della connessione. |
|
properties.provisioningState |
Stato di provisioning della connessione dell'endpoint privato. |
|
type |
string |
Tipo di risorsa. |
PublicNetworkAccess
Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando
Nome | Tipo | Descrizione |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ResourceProvisioningState
Stato di provisioning della connessione dell'endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione di risorse (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
Topic
Argomento eventgrid
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
id |
string |
Identificatore completo della risorsa. |
|
identity |
Informazioni sull'identità per la risorsa. |
||
location |
string |
Posizione della risorsa. |
|
name |
string |
Nome della risorsa. |
|
properties.dataResidencyBoundary |
Data Residency Limite della risorsa. |
||
properties.disableLocalAuth |
boolean |
False |
Questo valore booleano viene usato per abilitare o disabilitare l'autenticazione locale. Il valore predefinito è false. Quando la proprietà è impostata su true, verrà usato solo il token AAD per l'autenticazione se l'utente è autorizzato a pubblicare nell'argomento. |
properties.endpoint |
string |
Endpoint per l'argomento. |
|
properties.inboundIpRules |
Questa opzione può essere usata per limitare il traffico da indirizzi IP specifici anziché da tutti gli indirizzi IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. |
||
properties.inputSchema | EventGridSchema |
Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nell'argomento. |
|
properties.inputSchemaMapping | InputSchemaMapping: |
Ciò consente la pubblicazione usando schemi di eventi personalizzati. È possibile specificare un oggetto InputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà obbligatorie dello schema EventGridEvent. |
|
properties.metricResourceId |
string |
ID risorsa metrica per l'argomento. |
|
properties.privateEndpointConnections | |||
properties.provisioningState |
Stato di provisioning dell'argomento. |
||
properties.publicNetworkAccess | Enabled |
Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando |
|
systemData |
Metadati di sistema relativi alla risorsa Argomento. |
||
tags |
object |
Tag della risorsa. |
|
type |
string |
Tipo di risorsa. |
TopicProvisioningState
Stato di provisioning dell'argomento.
Nome | Tipo | Descrizione |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
UserIdentityProperties
Informazioni sull'identità utente.
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string |
ID client dell'identità assegnata dall'utente. |
principalId |
string |
ID principale dell'identità assegnata dall'utente. |