Topology - List

Tjänst:

Defender for Cloud

API-version:

2015-06-01-preview

Hämtar en lista som gör det möjligt att skapa en topologivy över en prenumeration.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
subscriptionId	path	True	string pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$	Azure-prenumerations-ID
api-version	query	True	string	API-version för åtgärden

Svar

Name	Typ	Description
200 OK	TopologyList	OKEJ
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Get topology on a subscription

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
CloudError	Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
CloudErrorBody	Felinformationen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
TopologyList
TopologyResource
TopologySingleResource
TopologySingleResourceChild
TopologySingleResourceParent

CloudError

Objekt

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
error.code	string	Felkoden.
error.details	CloudErrorBody[]	Felinformationen.
error.message	string	Felmeddelandet.
error.target	string	Felmålet.

CloudErrorBody

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	CloudErrorBody[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

TopologyList

Objekt

Name	Typ	Description
nextLink	string	URI:n för att hämta nästa sida.
value	TopologyResource[]

TopologyResource

Objekt

Name	Typ	Description
id	string	Resurs-ID
location	string	Plats där resursen lagras
name	string	Resursnamn
properties.calculatedDateTime	string (date-time)	UTC-tiden då topologin beräknades
properties.topologyResources	TopologySingleResource[]	Azure-resurser som ingår i den här topologiresursen
type	string	Resurstyp

TopologySingleResource

Objekt

Name	Typ	Description
children	TopologySingleResourceChild[]	Azure-resurser som är anslutna till den här resursen som ligger på lägre nivå i topologivyn
location	string	Platsen för den här resursen
networkZones	string	Anger resursanslutningsnivån till Internet (InternetFacing, Intern osv.)
parents	TopologySingleResourceParent[]	Azure-resurser som är anslutna till den här resursen på högre nivå i topologivyn
recommendationsExist	boolean	Anger om resursen har säkerhetsrekommendationer
resourceId	string	Azure-resurs-ID
severity	string	Resursens säkerhets allvarlighetsgrad
topologyScore	integer	Poäng för resursen baserat på dess säkerhets allvarlighetsgrad

TopologySingleResourceChild

Objekt

Name	Typ	Description
resourceId	string	Azure-resurs-ID som fungerar som underordnad resurs i topologivyn

TopologySingleResourceParent

Objekt

Name	Typ	Description
resourceId	string	Azure-resurs-ID som fungerar som överordnad resurs i topologivyn