Topology - List
구독의 토폴로지 보기를 빌드할 수 있는 목록을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/topologies?api-version=2020-01-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Azure 구독 ID입니다. Regex pattern: |
api-version
|
query | True |
string |
작업에 대한 API 버전 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Get topology on a subscription
Sample Request
GET https://management.azure.com/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/providers/Microsoft.Security/topologies?api-version=2020-01-01
Sample Response
{
"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"
}
]
}
정의
Name | Description |
---|---|
Cloud |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다. |
Cloud |
오류 세부 정보입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Topology |
|
Topology |
|
Topology |
|
Topology |
|
Topology |
CloudError
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.
Name | 형식 | Description |
---|---|---|
error.additionalInfo |
오류 추가 정보입니다. |
|
error.code |
string |
오류 코드입니다. |
error.details |
오류 세부 정보입니다. |
|
error.message |
string |
오류 메시지입니다. |
error.target |
string |
오류 대상입니다. |
CloudErrorBody
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
TopologyList
Name | 형식 | Description |
---|---|---|
nextLink |
string |
다음 페이지를 페치 위한 URI입니다. |
value |
TopologyResource
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID |
location |
string |
리소스가 저장되는 위치 |
name |
string |
리소스 이름 |
properties.calculatedDateTime |
string |
토폴로지를 계산한 UTC 시간 |
properties.topologyResources |
이 토폴로지 리소스의 일부인 Azure 리소스 |
|
type |
string |
리소스 유형 |
TopologySingleResource
Name | 형식 | Description |
---|---|---|
children |
토폴로지 보기에서 하위 수준에 있는 이 리소스에 연결된 Azure 리소스 |
|
location |
string |
이 리소스의 위치 |
networkZones |
string |
인터넷에 대한 리소스 연결 수준(InternetFacing, 내부 등)을 나타냅니다. |
parents |
토폴로지 보기에서 상위 수준인 이 리소스에 연결된 Azure 리소스 |
|
recommendationsExist |
boolean |
리소스에 보안 권장 사항이 있는지를 나타냅니다. |
resourceId |
string |
Azure 리소스 ID |
severity |
string |
리소스의 보안 심각도 |
topologyScore |
integer |
보안 심각도에 따라 리소스의 점수 |
TopologySingleResourceChild
Name | 형식 | Description |
---|---|---|
resourceId |
string |
토폴로지 보기에서 자식 리소스 역할을 하는 Azure 리소스 ID |
TopologySingleResourceParent
Name | 형식 | Description |
---|---|---|
resourceId |
string |
토폴로지 보기에서 부모 리소스 역할을 하는 Azure 리소스 ID |