Topology - List

Szolgáltatás:

Defender for Cloud

API verzió:

2020-01-01

Lekéri azt a listát, amely lehetővé teszi egy előfizetés topológianézetének összeállítását.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/topologies?api-version=2020-01-01

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
subscriptionId	path	True	string pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$	Azure-előfizetés azonosítója
api-version	query	True	string	API-verzió a művelethez

Válaszok

Név	Típus	Leírás
200 OK	TopologyList	OKÉ
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

Típus: oauth2
Flow: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Leírás
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get topology on a subscription

Mintakérés

HTTP

GET https://management.azure.com/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/providers/Microsoft.Security/topologies?api-version=2020-01-01

Mintaválasz

Állapotkód:

200

{
  "value": [
    {
      "properties": {
        "calculatedDateTime": "2018-07-10T13:56:10.5755270Z",
        "topologyResources": [
          {
            "resourceId": "/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/resourceGroups/myservers/providers/Microsoft.Network/virtualNetworks/myvnet",
            "severity": "Healthy",
            "networkZones": "Internal",
            "recommendationsExist": false,
            "topologyScore": 0,
            "location": "westus",
            "children": [
              {
                "resourceId": "/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/resourceGroups/myservers/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet"
              }
            ]
          }
        ]
      },
      "id": "/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/resourceGroups/myservers/providers/Microsoft.Security/locations/centralus/topologies/vnets",
      "name": "vnets",
      "type": "Microsoft.Security/locations/topologies",
      "location": "westus"
    },
    {
      "properties": {
        "calculatedDateTime": "2018-07-10T13:56:10.5755270Z",
        "topologyResources": [
          {
            "resourceId": "/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/resourceGroups/myservers/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet",
            "severity": "Healthy",
            "networkZones": "Internal",
            "recommendationsExist": false,
            "topologyScore": 5,
            "location": "westus",
            "parents": [
              {
                "resourceId": "/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/resourceGroups/myservers/providers/Microsoft.Network/virtualNetworks/myvnet"
              }
            ]
          }
        ]
      },
      "id": "/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/resourceGroups/myservers/providers/Microsoft.Security/locations/centralus/topologies/subnets",
      "name": "subnets",
      "type": "Microsoft.Security/locations/topologies",
      "location": "westus"
    }
  ]
}

Meghatározások

Név	Leírás
CloudError	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
CloudErrorBody	A hiba részletei.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
TopologyList
TopologyResource
TopologySingleResource
TopologySingleResourceChild
TopologySingleResourceParent

CloudError

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Név	Típus	Leírás
error.additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
error.code	string	A hibakód.
error.details	CloudErrorBody[]	A hiba részletei.
error.message	string	A hibaüzenet.
error.target	string	A hibacél.

CloudErrorBody

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	CloudErrorBody[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

TopologyList

Tárgy

Név	Típus	Leírás
nextLink	string	A következő oldal beolvasásához az URI.
value	TopologyResource[]

TopologyResource

Tárgy

Név	Típus	Leírás
id	string	Erőforrás-azonosító
location	string	Az erőforrás tárolási helye
name	string	Erőforrás neve
properties.calculatedDateTime	string (date-time)	A topológia kiszámításának UTC-időpontja
properties.topologyResources	TopologySingleResource[]	A topológiai erőforrás részét képező Azure-erőforrások
type	string	Erőforrás típusa

TopologySingleResource

Tárgy

Név	Típus	Leírás
children	TopologySingleResourceChild[]	Az erőforráshoz csatlakoztatott Azure-erőforrások, amelyek a topológia nézetben alacsonyabb szinten vannak
location	string	Az erőforrás helye
networkZones	string	Az internethez való erőforrás-kapcsolat szintjét jelzi (InternetFacing, Internal stb.)
parents	TopologySingleResourceParent[]	Ehhez az erőforráshoz csatlakoztatott Azure-erőforrások, amelyek topológia nézetben magasabb szinten vannak
recommendationsExist	boolean	Azt jelzi, hogy az erőforrás rendelkezik-e biztonsági javaslatokkal
resourceId	string	Azure-erőforrás-azonosító
severity	string	Az erőforrás biztonsági súlyossága
topologyScore	integer	Az erőforrás pontszáma a biztonsági súlyossága alapján

TopologySingleResourceChild

Tárgy

Név	Típus	Leírás
resourceId	string	Azure-erőforrás-azonosító, amely gyermekerőforrásként szolgál a topológia nézetben

TopologySingleResourceParent

Tárgy

Név	Típus	Leírás
resourceId	string	Azure-erőforrás-azonosító, amely szülőerőforrásként szolgál topológia nézetben