Alerts - List For Scope
Hämtar aviseringar för ett resursomfång.
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleManagementAlerts?api-version=2022-08-01-preview
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
scope
|
path | True |
string |
Aviseringens omfattning. |
api-version
|
query | True |
string |
Den API-version som ska användas för den här åtgärden. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK – Returnerar en matris med aviseringar. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
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 | personifiera ditt användarkonto |
Exempel
GetAlerts
Sample Request
GET https://management.azure.com/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts?api-version=2022-08-01-preview
Sample Response
{
"value": [
{
"properties": {
"scope": "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f",
"incidentCount": 1,
"lastModifiedDateTime": "2022-04-05T03:04:06.467+00:00",
"lastScannedDateTime": "2022-04-06T18:25:00.38+00:00",
"isActive": true,
"alertDefinition": {
"properties": {
"displayName": "Too many permanent owners assigned to a resource",
"scope": "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f",
"description": "The number of users set to never expire is too high. To enhance the security of your resources, we recommend requiring activation for role use. Take a moment to review the list of users, and suggested changes here.",
"severityLevel": "Medium",
"securityImpact": "Providing users permanent access in a role may leave resources vulnerable to accidental or malicious activity.",
"mitigationSteps": "To mitigate this issue, require the user to activate the role before use.",
"howToPrevent": "Enable “Activation Required” in the role settings menu. This will ensure newly added users must activate their role.",
"isRemediatable": true,
"isConfigurable": true
},
"name": "TooManyPermanentOwnersAssignedToResource",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlertDefinitions/TooManyPermanentOwnersAssignedToResource",
"type": "Microsoft.Authorization/roleManagementAlertDefinitions"
},
"alertIncidents": [
{
"properties": {
"alertIncidentType": "TooManyPermanentOwnersAssignedToResourceAlertIncident",
"assigneeName": "testUser",
"assigneeType": "User"
},
"name": "a9f38501-74ec-43ea-8663-6c538602150d",
"type": "Microsoft.Authorization/roleManagementAlerts/alertIncidents",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts/TooManyPermanentOwnersAssignedToResource/alertIncidents/a9f38501-74ec-43ea-8663-6c538602150d"
}
],
"alertConfiguration": {
"properties": {
"alertConfigurationType": "TooManyPermanentOwnersAssignedToResourceAlertConfiguration",
"alertDefinitionId": "TooManyPermanentOwnersAssignedToResource",
"scope": "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f",
"isEnabled": true,
"thresholdNumberOfPermanentOwners": 10,
"thresholdPercentageOfPermanentOwnersOutOfAllOwners": 10
},
"name": "TooManyPermanentOwnersAssignedToResource",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlertConfigurations/TooManyPermanentOwnersAssignedToResource",
"type": "Microsoft.Authorization/roleManagementAlertConfigurations"
}
},
"name": "TooManyPermanentOwnersAssignedToResource",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts/TooManyPermanentOwnersAssignedToResource",
"type": "Microsoft.Authorization/roleManagementAlerts"
},
{
"properties": {
"scope": "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f",
"incidentCount": 1,
"lastModifiedDateTime": "2022-04-05T03:04:06.467+00:00",
"lastScannedDateTime": "2022-04-06T18:25:00.38+00:00",
"isActive": true,
"alertDefinition": {
"properties": {
"displayName": "Too many owners assigned to a resource",
"scope": "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f",
"description": "The number of users with the Owner role is too high. We recommend assigning these individuals to less privileged roles or roles more suitable to their daily needs. Take a moment to review the current assignments, and suggested changes here.",
"severityLevel": "Medium",
"securityImpact": "As the number of users with the owner role increases, so does the potential for malicious or mistaken actions affecting your resource.",
"mitigationSteps": "To mitigate this issue, reduce the number of users in the Owner role. Review the list of users in the list, and reassign them to a less privileged role such as Contributor.",
"howToPrevent": "Choose a role that provides the fewest privileges necessary for a user or group to complete their tasks.",
"isRemediatable": true,
"isConfigurable": true
},
"name": "TooManyOwnersAssignedToResource",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlertDefinitions/TooManyOwnersAssignedToResource",
"type": "Microsoft.Authorization/roleManagementAlertDefinitions"
},
"alertIncidents": [
{
"properties": {
"alertIncidentType": "TooManyOwnersAssignedToResourceAlertIncident",
"assigneeName": "testUser",
"assigneeType": "User"
},
"name": "a9f38501-74ec-43ea-8663-6c538602150d",
"type": "Microsoft.Authorization/roleManagementAlerts/alertIncidents",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts/TooManyOwnersAssignedToResource/alertIncidents/a9f38501-74ec-43ea-8663-6c538602150d"
}
],
"alertConfiguration": {
"properties": {
"alertConfigurationType": "TooManyOwnersAssignedToResourceAlertConfiguration",
"alertDefinitionId": "TooManyOwnersAssignedToResource",
"scope": "subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f",
"isEnabled": true,
"thresholdNumberOfOwners": 2,
"thresholdPercentageOfOwnersOutOfAllRoleMembers": 3
},
"name": "TooManyOwnersAssignedToResource",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlertConfigurations/TooManyOwnersAssignedToResource",
"type": "Microsoft.Authorization/roleManagementAlertConfigurations"
}
},
"name": "TooManyOwnersAssignedToResource",
"id": "/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts/TooManyOwnersAssignedToResource",
"type": "Microsoft.Authorization/roleManagementAlerts"
}
]
}
Definitioner
Name | Description |
---|---|
Alert |
Aviseringen. |
Alert |
Aviseringskonfiguration. |
Alert |
Aviseringsdefinition |
Alert |
Aviseringsincident |
Alert |
Resultat av aviseringslistans åtgärd. |
Cloud |
Ett felsvar från tjänsten. |
Cloud |
Ett felsvar från tjänsten. |
Severity |
Allvarlighetsgrad för aviseringen. |
Alert
Aviseringen.
Name | Typ | Description |
---|---|---|
id |
string |
Aviserings-ID:t. |
name |
string |
Aviseringsnamnet. |
properties.alertConfiguration |
Aviseringskonfigurationen. |
|
properties.alertDefinition |
Aviseringsdefinitionen. |
|
properties.alertIncidents |
Aviseringsincidenterna. |
|
properties.incidentCount |
integer |
Antalet genererade incidenter i aviseringen. |
properties.isActive |
boolean |
Falskt som standard; sant om aviseringen är aktiv. |
properties.lastModifiedDateTime |
string |
Datum när aviseringskonfigurationen uppdaterades eller nya incidenter genererades. |
properties.lastScannedDateTime |
string |
Datum när aviseringen senast genomsökdes. |
properties.scope |
string |
Aviseringsomfånget. |
type |
string |
Aviseringstypen. |
AlertConfiguration
Aviseringskonfiguration.
Name | Typ | Description |
---|---|---|
id |
string |
Konfigurations-ID för avisering. |
name |
string |
Namnet på aviseringskonfigurationen. |
properties.alertConfigurationType |
string |
Aviseringskonfigurationstypen. |
properties.alertDefinition |
Aviseringsdefinitionen. |
|
properties.alertDefinitionId |
string |
Aviseringsdefinitionens ID. |
properties.isEnabled |
boolean |
Sant om aviseringen är aktiverad, false inaktiverar genomsökningen efter den specifika aviseringen. |
properties.scope |
string |
Aviseringsomfånget. |
type |
string |
Aviseringskonfigurationstypen. |
AlertDefinition
Aviseringsdefinition
Name | Typ | Description |
---|---|---|
id |
string |
Aviseringsdefinitionens ID. |
name |
string |
Aviseringsdefinitionens namn. |
properties.description |
string |
Aviseringsbeskrivningen. |
properties.displayName |
string |
Aviseringsvisningsnamnet. |
properties.howToPrevent |
string |
Sätt att förhindra aviseringen. |
properties.isConfigurable |
boolean |
Sant om aviseringskonfigurationen kan konfigureras. falskt, annars. |
properties.isRemediatable |
boolean |
Sant om aviseringen kan åtgärdas. falskt, annars. |
properties.mitigationSteps |
string |
Metoder för att minska aviseringen. |
properties.scope |
string |
Aviseringsomfånget. |
properties.securityImpact |
string |
Säkerhetspåverkan av aviseringen. |
properties.severityLevel |
Allvarlighetsgrad för aviseringen. |
|
type |
string |
Aviseringsdefinitionstypen. |
AlertIncident
Aviseringsincident
Name | Typ | Description |
---|---|---|
id |
string |
Aviseringsincidentens ID. |
name |
string |
Namnet på aviseringsincidenten. |
properties.alertIncidentType |
string |
Typen av aviseringsincident. |
type |
string |
Typen av aviseringsincident. |
AlertListResult
Resultat av aviseringslistans åtgärd.
Name | Typ | Description |
---|---|---|
nextLink |
string |
Den URL som ska användas för att hämta nästa uppsättning resultat. |
value |
Alert[] |
Aviseringslista |
CloudError
Ett felsvar från tjänsten.
Name | Typ | Description |
---|---|---|
error |
Ett felsvar från tjänsten. |
CloudErrorBody
Ett felsvar från tjänsten.
Name | Typ | Description |
---|---|---|
code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
message |
string |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
SeverityLevel
Allvarlighetsgrad för aviseringen.
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Medium |
string |