Topology - List By Home Region
Aboneliğin ve konumun topoloji görünümünü oluşturmaya olanak tanıyan bir liste alır.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/topologies?api-version=2020-01-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
asc
|
path | True |
string |
ASC'nin aboneliğin verilerini depoladığı konum. Get konumlarından alınabilir |
subscription
|
path | True |
string |
Azure abonelik kimliği Regex pattern: |
api-version
|
query | True |
string |
İşlem için API sürümü |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Güvenlik
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 | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
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"
}
]
}
Tanımlar
Name | Description |
---|---|
Cloud |
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıtı biçimini de izler.). |
Cloud |
Hata ayrıntısı. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Topology |
|
Topology |
|
Topology |
|
Topology |
|
Topology |
CloudError
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıtı biçimini de izler.).
Name | Tür | Description |
---|---|---|
error.additionalInfo |
Hata ek bilgileri. |
|
error.code |
string |
Hata kodu. |
error.details |
Hata ayrıntıları. |
|
error.message |
string |
Hata iletisi. |
error.target |
string |
Hata hedefi. |
CloudErrorBody
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
TopologyList
Name | Tür | Description |
---|---|---|
nextLink |
string |
Sonraki sayfayı getirmek için URI. |
value |
TopologyResource
Name | Tür | Description |
---|---|---|
id |
string |
Kaynak Kimliği |
location |
string |
Kaynağın depolandığı konum |
name |
string |
Kaynak adı |
properties.calculatedDateTime |
string |
Topolojinin hesaplandığı UTC saati |
properties.topologyResources |
Bu topoloji kaynağının parçası olan Azure kaynakları |
|
type |
string |
Kaynak türü |
TopologySingleResource
Name | Tür | Description |
---|---|---|
children |
Topoloji görünümünde daha düşük düzeyde olan bu kaynağa bağlı Azure kaynakları |
|
location |
string |
Bu kaynağın konumu |
networkZones |
string |
İnternet'e kaynak bağlantı düzeyini gösterir (InternetFacing, İç vb.) |
parents |
Topoloji görünümünde daha üst düzeyde olan bu kaynağa bağlı Azure kaynakları |
|
recommendationsExist |
boolean |
Kaynağın güvenlik önerileri olup olmadığını gösterir |
resourceId |
string |
Azure kaynak kimliği |
severity |
string |
Kaynağın güvenlik önem derecesi |
topologyScore |
integer |
Kaynağın güvenlik önem derecesine göre puanı |
TopologySingleResourceChild
Name | Tür | Description |
---|---|---|
resourceId |
string |
Topoloji görünümünde alt kaynak olarak hizmet veren Azure kaynak kimliği |
TopologySingleResourceParent
Name | Tür | Description |
---|---|---|
resourceId |
string |
Topoloji görünümünde üst kaynak olarak hizmet veren Azure kaynak kimliği |