Adaptive Network Hardenings - Get
Gets a single Adaptive Network Hardening resource
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Security/adaptiveNetworkHardenings/{adaptiveNetworkHardeningResourceName}?api-version=2020-01-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
adaptive
|
path | True |
string |
The name of the Adaptive Network Hardening resource. |
resource
|
path | True |
string |
The name of the resource group within the user's subscription. The name is case insensitive. Regex pattern: |
resource
|
path | True |
string |
Name of the resource. |
resource
|
path | True |
string |
The Namespace of the resource. |
resource
|
path | True |
string |
The type of the resource. |
subscription
|
path | True |
string |
Azure subscription ID Regex pattern: |
api-version
|
query | True |
string |
API version for the operation |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
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 | impersonate your user account |
Examples
Get a single Adaptive Network Hardening resource
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Security/adaptiveNetworkHardenings/default?api-version=2020-01-01
Sample Response
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Security/adaptiveNetworkHardenings/default",
"name": "default",
"type": "Microsoft.Security/adaptiveNetworkHardenings",
"properties": {
"rulesCalculationTime": "2018-08-15T00:00:00.0000000Z",
"rules": [
{
"name": "rule1",
"direction": "Inbound",
"destinationPort": 3389,
"protocols": [
"TCP"
],
"ipAddresses": [
"100.10.1.1",
"200.20.2.2",
"81.199.3.0/24"
]
},
{
"name": "rule2",
"direction": "Inbound",
"destinationPort": 22,
"protocols": [
"TCP"
],
"ipAddresses": []
}
],
"effectiveNetworkSecurityGroups": [
{
"networkInterface": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1",
"networkSecurityGroups": [
"/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/nicNsg",
"/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/subnetNsg"
]
},
{
"networkInterface": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg2/providers/Microsoft.Network/networkInterfaces/nic2",
"networkSecurityGroups": [
"/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nicNsg"
]
}
]
}
}
Definitions
Name | Description |
---|---|
Adaptive |
The resource whose properties describes the Adaptive Network Hardening settings for some Azure resource |
Cloud |
Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.). |
Cloud |
The error detail. |
direction |
The rule's direction |
Effective |
Describes the Network Security Groups effective on a network interface |
Error |
The resource management error additional info. |
Rule |
Describes remote addresses that is recommended to communicate with the Azure resource on some (Protocol, Port, Direction). All other remote addresses are recommended to be blocked |
transport |
The rule's transport protocols |
AdaptiveNetworkHardening
The resource whose properties describes the Adaptive Network Hardening settings for some Azure resource
Name | Type | Description |
---|---|---|
id |
string |
Resource Id |
name |
string |
Resource name |
properties.effectiveNetworkSecurityGroups |
The Network Security Groups effective on the network interfaces of the protected resource |
|
properties.rules |
Rule[] |
The security rules which are recommended to be effective on the VM |
properties.rulesCalculationTime |
string |
The UTC time on which the rules were calculated |
type |
string |
Resource type |
CloudError
Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
Name | Type | Description |
---|---|---|
error.additionalInfo |
The error additional info. |
|
error.code |
string |
The error code. |
error.details |
The error details. |
|
error.message |
string |
The error message. |
error.target |
string |
The error target. |
CloudErrorBody
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
direction
The rule's direction
Name | Type | Description |
---|---|---|
Inbound |
string |
|
Outbound |
string |
EffectiveNetworkSecurityGroups
Describes the Network Security Groups effective on a network interface
Name | Type | Description |
---|---|---|
networkInterface |
string |
The Azure resource ID of the network interface |
networkSecurityGroups |
string[] |
The Network Security Groups effective on the network interface |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
Rule
Describes remote addresses that is recommended to communicate with the Azure resource on some (Protocol, Port, Direction). All other remote addresses are recommended to be blocked
Name | Type | Description |
---|---|---|
destinationPort |
integer |
The rule's destination port |
direction |
The rule's direction |
|
ipAddresses |
string[] |
The remote IP addresses that should be able to communicate with the Azure resource on the rule's destination port and protocol |
name |
string |
The name of the rule |
protocols |
The rule's transport protocols |
transportProtocol
The rule's transport protocols
Name | Type | Description |
---|---|---|
TCP |
string |
|
UDP |
string |