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
resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione dell'utente.

subscriptionId
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.

topicName
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

Topic

OK

Other Status Codes

Risposte di errore:

  • 400 Richiesta non valida.

  • 500 - Errore interno del server.

Esempio

Topics_Get

Esempio di richiesta

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2?api-version=2022-06-15

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
ConnectionState

Informazioni di ConnectionState.

createdByType

Tipo di identità che ha creato la risorsa.

DataResidencyBoundary

Data Residency Limite della risorsa.

IdentityInfo

Informazioni sull'identità per la risorsa.

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à.

InboundIpRule
InputSchema

Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nella risorsa di dominio di Griglia di eventi.

IpActionType

Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask.

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.

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.

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.

PersistedConnectionStatus

Stato della connessione.

PrivateEndpoint

Informazioni privateEndpoint.

PrivateEndpointConnection
PublicNetworkAccess

Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando

ResourceProvisioningState

Stato di provisioning della connessione dell'endpoint privato.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Topic

Argomento eventgrid

TopicProvisioningState

Stato di provisioning dell'argomento.

UserIdentityProperties

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

PersistedConnectionStatus

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

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à.

userAssignedIdentities

<string,  UserIdentityProperties>

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

IpActionType

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

JsonFieldWithDefault

Informazioni di mapping per la proprietà DataVersion dell'evento di Griglia di eventi.

properties.eventTime

JsonField

Informazioni di mapping per la proprietà EventTime dell'evento di Griglia di eventi.

properties.eventType

JsonFieldWithDefault

Informazioni di mapping per la proprietà EventType dell'evento di Griglia di eventi.

properties.id

JsonField

Informazioni di mapping per la proprietà Id dell'evento di Griglia di eventi.

properties.subject

JsonFieldWithDefault

Informazioni di mapping per la proprietà Subject dell'evento di Griglia di eventi.

properties.topic

JsonField

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

PrivateEndpoint

Risorsa endpoint privato per la connessione.

properties.privateLinkServiceConnectionState

ConnectionState

Dettagli sullo stato della connessione.

properties.provisioningState

ResourceProvisioningState

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

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

createdByType

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

IdentityInfo

Informazioni sull'identità per la risorsa.

location

string

Posizione della risorsa.

name

string

Nome della risorsa.

properties.dataResidencyBoundary

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

InboundIpRule[]

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

InputSchema

EventGridSchema

Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nell'argomento.

properties.inputSchemaMapping InputSchemaMapping:

JsonInputSchemaMapping

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

PrivateEndpointConnection[]

properties.provisioningState

TopicProvisioningState

Stato di provisioning dell'argomento.

properties.publicNetworkAccess

PublicNetworkAccess

Enabled

Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando

systemData

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.