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

Name In Required Type Description
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

Name Type Description
200 OK

OK

Other Status Codes

Risposte di errore:

  • 400 Richiesta non valida.

  • 500 - Errore interno del server.

Esempio

Topics_Get

Sample Request

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

Sample Response

{
  "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

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.

Name Type Description
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.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DataResidencyBoundary

Data Residency Limite della risorsa.

Name Type Description
WithinGeopair
  • string
WithinRegion
  • string

IdentityInfo

Informazioni sull'identità per la risorsa.

Name Type Description
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

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

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned, UserAssigned
  • string
UserAssigned
  • string

InboundIpRule

Name Type Description
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.

Name Type Description
CloudEventSchemaV1_0
  • string
CustomEventSchema
  • string
EventGridSchema
  • string

IpActionType

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

Name Type Description
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.

Name Type Description
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.

Name Type Description
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.

Name Type Description
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.

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

PrivateEndpoint

Informazioni privateEndpoint.

Name Type Description
id
  • string

Identificatore arm per endpoint privato.

PrivateEndpointConnection

Name Type Description
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

Name Type Description
Disabled
  • string
Enabled
  • string

ResourceProvisioningState

Stato di provisioning della connessione dell'endpoint privato.

Name Type Description
Canceled
  • string
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

systemData

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

Name Type Description
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

Name Type Default Value Description
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.

Name Type Description
Canceled
  • string
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

UserIdentityProperties

Informazioni sull'identità utente.

Name Type Description
clientId
  • string

ID client dell'identità assegnata dall'utente.

principalId
  • string

ID principale dell'identità assegnata dall'utente.