Topics - Get

Témakör lekérése.
Témakör tulajdonságainak lekérése.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}?api-version=2022-06-15

URI-paraméterek

Name In Required Type Description
resourceGroupName
path True
  • string

A felhasználó előfizetésén belüli erőforráscsoport neve.

subscriptionId
path True
  • string

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító minden szolgáltatáshívás URI-jának részét képezi.

topicName
path True
  • string

A témakör neve.

api-version
query True
  • string

Az ügyfélkéréshez használandó API verziója.

Válaszok

Name Type Description
200 OK

OK

Other Status Codes

Hibaválaszok: ***

  • 400 Rossz kérés.

  • 500 belső kiszolgálóhiba.

Példák

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

Definíciók

ConnectionState

ConnectionState-információk.

createdByType

Az erőforrást létrehozó identitás típusa.

DataResidencyBoundary

Data Residency erőforrás határa.

IdentityInfo

Az erőforrás identitásadatai.

IdentityType

A használt felügyelt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást.

InboundIpRule
InputSchema

Ez határozza meg, hogy az Event Grid milyen formátumot várjon az Event Grid tartományi erőforrásban közzétett bejövő eseményekhez.

IpActionType

Az IpMask egyezése vagy nem egyezése alapján végrehajtandó művelet.

JsonField

Ez az Event Grid-eseményséma egyetlen célmezőjének bemeneti sémaleképezésének forrását fejezi ki. Ez jelenleg az "id", a "topic" és az "eventtime" tulajdonságok leképezéseiben használatos. Ez a bemeneti eseményséma egyik mezőjét jelöli.

JsonFieldWithDefault

Ez az Event Grid-eseményséma egyetlen célmezőjének bemeneti sémaleképezésének forrását fejezi ki. Ez jelenleg a "subject", "eventtype" és "dataversion" tulajdonságok leképezéseiben használatos. Ez a bemeneti eseményséma egy mezőjét és egy alapértelmezett használandó értéket jelöl, és a két tulajdonság közül legalább egyet meg kell adni.

JsonInputSchemaMapping

Ez lehetővé teszi a közzétételt az Event Gridben egyéni bemeneti sémával. Ez használható az egyéni bemeneti JSON-sémák tulajdonságainak az Event Grid eseménysémára való leképezésére.

PersistedConnectionStatus

A kapcsolat állapota.

PrivateEndpoint

PrivateEndpoint-információk.

PrivateEndpointConnection
PublicNetworkAccess

Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. A meghatározott IP-címekre további korlátozást végezhet, ha konfigurálja a

ResourceProvisioningState

A privát végpontkapcsolat kiépítési állapota.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Topic

EventGrid-témakör

TopicProvisioningState

A témakör kiépítési állapota.

UserIdentityProperties

A felhasználói identitással kapcsolatos információk.

ConnectionState

ConnectionState-információk.

Name Type Description
actionsRequired
  • string

Szükséges műveletek (ha vannak ilyenek).

description
  • string

A kapcsolat állapotának leírása.

status

A kapcsolat állapota.

createdByType

Az erőforrást létrehozó identitás típusa.

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

DataResidencyBoundary

Data Residency erőforrás határa.

Name Type Description
WithinGeopair
  • string
WithinRegion
  • string

IdentityInfo

Az erőforrás identitásadatai.

Name Type Description
principalId
  • string

Az erőforrás-identitás fő azonosítója.

tenantId
  • string

Az erőforrás bérlőazonosítója.

type

A használt felügyelt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást.

userAssignedIdentities

Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Ez a tulajdonság jelenleg nincs használatban, és későbbi használatra van fenntartva.

IdentityType

A használt felügyelt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást.

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

InboundIpRule

Name Type Description
action

Az IpMask egyezése vagy nem egyezése alapján végrehajtandó művelet.

ipMask
  • string

IP-cím CIDR-jelölésben, pl. 10.0.0.0/8.

InputSchema

Ez határozza meg, hogy az Event Grid milyen formátumot várjon az Event Grid tartományi erőforrásban közzétett bejövő eseményekhez.

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

IpActionType

Az IpMask egyezése vagy nem egyezése alapján végrehajtandó művelet.

Name Type Description
Allow
  • string

JsonField

Ez az Event Grid-eseményséma egyetlen célmezőjének bemeneti sémaleképezésének forrását fejezi ki. Ez jelenleg az "id", a "topic" és az "eventtime" tulajdonságok leképezéseiben használatos. Ez a bemeneti eseményséma egyik mezőjét jelöli.

Name Type Description
sourceField
  • string

Egy mező neve a bemeneti eseménysémában, amelyet a leképezés forrásaként kell használni.

JsonFieldWithDefault

Ez az Event Grid-eseményséma egyetlen célmezőjének bemeneti sémaleképezésének forrását fejezi ki. Ez jelenleg a "subject", "eventtype" és "dataversion" tulajdonságok leképezéseiben használatos. Ez a bemeneti eseményséma egy mezőjét és egy alapértelmezett használandó értéket jelöl, és a két tulajdonság közül legalább egyet meg kell adni.

Name Type Description
defaultValue
  • string

A leképezéshez használt alapértelmezett érték, ha a SourceField nincs megadva, vagy ha nincs a megadott nevű tulajdonság a közzétett JSON-esemény hasznos adatai között.

sourceField
  • string

Egy mező neve a bemeneti eseménysémában, amelyet a leképezés forrásaként kell használni.

JsonInputSchemaMapping

Ez lehetővé teszi a közzétételt az Event Gridben egyéni bemeneti sémával. Ez használható az egyéni bemeneti JSON-sémák tulajdonságainak az Event Grid eseménysémára való leképezésére.

Name Type Description
inputSchemaMappingType string:
  • Json

Az egyéni leképezés típusa

properties.dataVersion

Az Event Grid-esemény DataVersion tulajdonságának leképezési információi.

properties.eventTime

Az Event Grid-esemény EventTime tulajdonságának leképezési információi.

properties.eventType

Az Event Grid-esemény EventType tulajdonságának leképezési információi.

properties.id

Az Event Grid-esemény Azonosító tulajdonságának leképezési információi.

properties.subject

Az Event Grid-esemény Tárgy tulajdonságának leképezési információi.

properties.topic

Az Event Grid-esemény Témakör tulajdonságának leképezési információi.

PersistedConnectionStatus

A kapcsolat állapota.

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

PrivateEndpoint

PrivateEndpoint-információk.

Name Type Description
id
  • string

A privát végpont ARM-azonosítója.

PrivateEndpointConnection

Name Type Description
id
  • string

Az erőforrás teljes azonosítója.

name
  • string

Az erőforrás neve.

properties.groupIds
  • string[]

A privát kapcsolat szolgáltatás erőforrásából származó GroupId-azonosítók.

properties.privateEndpoint

A kapcsolat privát végponti erőforrása.

properties.privateLinkServiceConnectionState

A kapcsolat állapotának részletei.

properties.provisioningState

A privát végpontkapcsolat kiépítési állapota.

type
  • string

Az erőforrás típusa.

PublicNetworkAccess

Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. A meghatározott IP-címekre további korlátozást végezhet, ha konfigurálja a

Name Type Description
Disabled
  • string
Enabled
  • string

ResourceProvisioningState

A privát végpontkapcsolat kiépítési állapota.

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

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Type Description
createdAt
  • string

Az erőforrás-létrehozás időbélyege (UTC).

createdBy
  • string

Az erőforrást létrehozó identitás.

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt
  • string

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy
  • string

Az erőforrást utoljára módosító identitás.

lastModifiedByType

Az erőforrást utoljára módosító identitás típusa.

Topic

EventGrid-témakör

Name Type Default Value Description
id
  • string

Az erőforrás teljes azonosítója.

identity

Az erőforrás identitásadatai.

location
  • string

Az erőforrás helye.

name
  • string

Az erőforrás neve.

properties.dataResidencyBoundary

Data Residency erőforrás határa.

properties.disableLocalAuth
  • boolean
False

Ez a logikai érték a helyi hitelesítés engedélyezésére vagy letiltására szolgál. Az alapértelmezett érték hamis. Ha a tulajdonság értéke igaz, a rendszer csak az AAD-jogkivonatot használja a hitelesítéshez, ha a felhasználó közzéteheti a témakört.

properties.endpoint
  • string

A témakör végpontja.

properties.inboundIpRules

Ez az összes IP-cím helyett adott IP-címekről érkező forgalom korlátozására használható. Megjegyzés: Ezek csak akkor tekinthetők meg, ha a PublicNetworkAccess engedélyezve van.

properties.inputSchema EventGridSchema

Ez határozza meg, hogy az Event Grid milyen formátumot várjon a témakörben közzétett bejövő eseményekhez.

properties.inputSchemaMapping InputSchemaMapping:

Ez lehetővé teszi a közzétételt egyéni eseménysémák használatával. Az InputSchemaMapping paraméterrel leképezhetők a forrásséma különböző tulajdonságai az EventGridEvent séma különböző szükséges tulajdonságaira.

properties.metricResourceId
  • string

A témakör metrikaerőforrás-azonosítója.

properties.privateEndpointConnections
properties.provisioningState

A témakör kiépítési állapota.

properties.publicNetworkAccess Enabled

Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. A meghatározott IP-címekre további korlátozást végezhet, ha konfigurálja a

systemData

A témakör-erőforráshoz kapcsolódó rendszer metaadatai.

tags
  • object

Az erőforrás címkéi.

type
  • string

Az erőforrás típusa.

TopicProvisioningState

A témakör kiépítési állapota.

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

UserIdentityProperties

A felhasználói identitással kapcsolatos információk.

Name Type Description
clientId
  • string

A felhasználó által hozzárendelt identitás ügyfél-azonosítója.

principalId
  • string

A felhasználó által hozzárendelt identitás egyszerű azonosítója.