Topology - Get

特定のトポロジ コンポーネントを取得します。

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

URI パラメーター

名前 / 必須 説明
ascLocation
path True

string

ASC がサブスクリプションのデータを格納する場所。 [場所の取得] から取得できます

resourceGroupName
path True

string

ユーザーのサブスクリプション内のリソース グループの名前。 名前の大文字と小文字は区別されます。

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

subscriptionId
path True

string

Azure サブスクリプション ID

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

topologyResourceName
path True

string

トポロジ リソース コレクションの名前。

api-version
query True

string

操作の API バージョン

応答

名前 説明
200 OK

TopologyResource

OK

Other Status Codes

CloudError

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

Scopes

名前 説明
user_impersonation ユーザー アカウントの借用

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

定義

名前 説明
CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは、OData エラー応答形式にも従います)。

CloudErrorBody

エラーの詳細。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

TopologyResource
TopologySingleResource
TopologySingleResourceChild
TopologySingleResourceParent

CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは、OData エラー応答形式にも従います)。

名前 説明
error.additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

error.code

string

エラー コード。

error.details

CloudErrorBody[]

エラーの詳細です。

error.message

string

エラー メッセージ。

error.target

string

エラーのターゲット。

CloudErrorBody

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

CloudErrorBody[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

TopologyResource

名前 説明
id

string

リソース ID

location

string

リソースが格納されている場所

name

string

リソース名

properties.calculatedDateTime

string

トポロジが計算された UTC 時刻

properties.topologyResources

TopologySingleResource[]

このトポロジ リソースの一部である Azure リソース

type

string

リソースの種類

TopologySingleResource

名前 説明
children

TopologySingleResourceChild[]

トポロジ ビューの下位レベルにあるこのリソースに接続されている Azure リソース

location

string

このリソースの場所

networkZones

string

インターネット (InternetFacing、Internal など) へのリソース接続レベルを示します

parents

TopologySingleResourceParent[]

トポロジ ビューの上位レベルにあるこのリソースに接続されている Azure リソース

recommendationsExist

boolean

リソースにセキュリティに関する推奨事項があるかどうかを示します

resourceId

string

Azure リソース ID

severity

string

リソースのセキュリティの重大度

topologyScore

integer

セキュリティの重大度に基づくリソースのスコア

TopologySingleResourceChild

名前 説明
resourceId

string

トポロジ ビューで子リソースとして機能する Azure リソース ID

TopologySingleResourceParent

名前 説明
resourceId

string

トポロジ ビューで親リソースとして機能する Azure リソース ID