Topology - Get
Obtient un composant de topologie spécifique.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/topologies/{topologyResourceName}?api-version=2020-01-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
asc
|
path | True |
string |
Emplacement où ASC stocke les données de l’abonnement. peut être récupéré à partir de Get locations |
resource
|
path | True |
string |
Nom du groupe de ressources dans l’abonnement de l’utilisateur. Le nom ne respecte pas la casse. Regex pattern: |
subscription
|
path | True |
string |
ID d’abonnement Azure Regex pattern: |
topology
|
path | True |
string |
Nom d’une collection de ressources de topologie. |
api-version
|
query | True |
string |
Version de l’API pour l’opération |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
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"
}
Définitions
Nom | Description |
---|---|
Cloud |
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.). |
Cloud |
Détail de l’erreur. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Topology |
|
Topology |
|
Topology |
|
Topology |
CloudError
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).
Nom | Type | Description |
---|---|---|
error.additionalInfo |
Informations supplémentaires sur l’erreur. |
|
error.code |
string |
Code d'erreur. |
error.details |
Détails de l’erreur. |
|
error.message |
string |
Message d’erreur. |
error.target |
string |
Cible d’erreur. |
CloudErrorBody
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d'erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires |
type |
string |
Type d’informations supplémentaires. |
TopologyResource
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource |
location |
string |
Emplacement où la ressource est stockée |
name |
string |
Nom de la ressource |
properties.calculatedDateTime |
string |
Heure UTC sur laquelle la topologie a été calculée |
properties.topologyResources |
Ressources Azure qui font partie de cette ressource de topologie |
|
type |
string |
Type de ressource |
TopologySingleResource
Nom | Type | Description |
---|---|---|
children |
Ressources Azure connectées à cette ressource qui se trouvent à un niveau inférieur dans la vue topologie |
|
location |
string |
Emplacement de cette ressource |
networkZones |
string |
Indique le niveau de connectivité des ressources à Internet (InternetFacing, Interne, etc.) |
parents |
Ressources Azure connectées à cette ressource qui se trouvent à un niveau supérieur dans la vue topologie |
|
recommendationsExist |
boolean |
Indique si la ressource a des recommandations de sécurité |
resourceId |
string |
ID de ressource Azure |
severity |
string |
Gravité de sécurité de la ressource |
topologyScore |
integer |
Noter la ressource en fonction de sa gravité de sécurité |
TopologySingleResourceChild
Nom | Type | Description |
---|---|---|
resourceId |
string |
ID de ressource Azure qui sert de ressource enfant en mode topologie |
TopologySingleResourceParent
Nom | Type | Description |
---|---|---|
resourceId |
string |
ID de ressource Azure qui sert de ressource parente en mode topologie |