Topology - Get

Ottiene un componente di topologia specifico.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
ascLocation
path True

string

Percorso in cui il Centro sicurezza di Azure archivia i dati della sottoscrizione. può essere recuperato da Recupera posizioni

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione dell'utente. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID sottoscrizione di Azure

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

topologyResourceName
path True

string

Nome di una raccolta di risorse della topologia.

api-version
query True

string

Versione dell'API per l'operazione

Risposte

Nome Tipo Descrizione
200 OK

TopologyResource

OK

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get topology

Sample Request

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

Sample Response

{
  "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": "InternetFacing",
        "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"
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

CloudErrorBody

Dettagli dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

TopologyResource
TopologySingleResource
TopologySingleResourceChild
TopologySingleResourceParent

CloudError

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

Nome Tipo Descrizione
error.additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

error.code

string

Codice di errore.

error.details

CloudErrorBody[]

Dettagli dell'errore.

error.message

string

Messaggio di errore.

error.target

string

Destinazione dell'errore.

CloudErrorBody

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

CloudErrorBody[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

TopologyResource

Nome Tipo Descrizione
id

string

ID risorsa

location

string

Posizione in cui è archiviata la risorsa

name

string

Nome risorsa

properties.calculatedDateTime

string

Ora UTC in cui è stata calcolata la topologia

properties.topologyResources

TopologySingleResource[]

Risorse di Azure che fanno parte di questa risorsa di topologia

type

string

Tipo di risorsa

TopologySingleResource

Nome Tipo Descrizione
children

TopologySingleResourceChild[]

Risorse di Azure connesse a questa risorsa di livello inferiore nella visualizzazione topologia

location

string

Posizione di questa risorsa

networkZones

string

Indica il livello di connettività delle risorse a Internet (InternetFacing, Interno e così via)

parents

TopologySingleResourceParent[]

Risorse di Azure connesse a questa risorsa di livello superiore nella visualizzazione topologia

recommendationsExist

boolean

Indica se la risorsa include raccomandazioni sulla sicurezza

resourceId

string

ID risorsa di Azure

severity

string

Gravità della sicurezza della risorsa

topologyScore

integer

Punteggio della risorsa in base alla gravità della sicurezza

TopologySingleResourceChild

Nome Tipo Descrizione
resourceId

string

ID risorsa di Azure che funge da risorsa figlio nella visualizzazione topologia

TopologySingleResourceParent

Nome Tipo Descrizione
resourceId

string

ID risorsa di Azure che funge da risorsa padre nella visualizzazione topologia