你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Topology - List By Home Region
获取一个列表,该列表允许生成订阅和位置的拓扑视图。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/topologies?api-version=2020-01-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
asc
|
path | True |
string |
ASC 存储订阅数据的位置。 可从获取位置检索 |
subscription
|
path | True |
string |
Azure 订阅 ID Regex pattern: |
api-version
|
query | True |
string |
操作的 API 版本 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Get topology on a subscription from security data location
Sample Request
GET https://management.azure.com/subscriptions/3eeab341-f466-499c-a8be-85427e154bad/providers/Microsoft.Security/locations/centralus/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"
}
]
}
定义
名称 | 说明 |
---|---|
Cloud |
对所有 Azure 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。 |
Cloud |
错误详细信息。 |
Error |
资源管理错误附加信息。 |
Topology |
|
Topology |
|
Topology |
|
Topology |
|
Topology |
CloudError
对所有 Azure 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。
名称 | 类型 | 说明 |
---|---|---|
error.additionalInfo |
错误附加信息。 |
|
error.code |
string |
错误代码。 |
error.details |
错误详细信息。 |
|
error.message |
string |
错误消息。 |
error.target |
string |
错误目标。 |
CloudErrorBody
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
TopologyList
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
用于提取下一页的 URI。 |
value |
TopologyResource
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID |
location |
string |
存储资源的位置 |
name |
string |
资源名称 |
properties.calculatedDateTime |
string |
计算拓扑的 UTC 时间 |
properties.topologyResources |
属于此拓扑资源的 Azure 资源 |
|
type |
string |
资源类型 |
TopologySingleResource
名称 | 类型 | 说明 |
---|---|---|
children |
连接到拓扑视图中处于较低级别的此资源的 Azure 资源 |
|
location |
string |
此资源的位置 |
networkZones |
string |
指示与 Internet (InternetFacing、Internal 等的资源连接级别 ) |
parents |
连接到此资源的 Azure 资源在拓扑视图中处于较高级别 |
|
recommendationsExist |
boolean |
指示资源是否具有安全建议 |
resourceId |
string |
Azure 资源 ID |
severity |
string |
资源的安全严重性 |
topologyScore |
integer |
基于资源安全严重性的分数 |
TopologySingleResourceChild
名称 | 类型 | 说明 |
---|---|---|
resourceId |
string |
在拓扑视图中用作子资源的 Azure 资源 ID |
TopologySingleResourceParent
名称 | 类型 | 说明 |
---|---|---|
resourceId |
string |
在拓扑视图中用作父资源的 Azure 资源 ID |