Alerts - List For Scope
Ruft Warnungen für einen Ressourcenbereich ab.
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleManagementAlerts?api-version=2022-08-01-preview
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
scope
|
path | True |
string |
Der Bereich der Warnung. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OK : Gibt ein Array von Warnungen zurück. |
|
| Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
GetAlerts
Beispielanforderung
GET https://management.azure.com/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts?api-version=2022-08-01-preview
Beispiel für eine Antwort
{
"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"
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
| Alert |
Die Warnung. |
|
Alert |
Warnungskonfiguration. |
|
Alert |
Warnungsdefinition |
|
Alert |
Warnungsvorfall |
|
Alert |
Ergebnis des Warnungslistenvorgangs. |
|
Cloud |
Eine Fehlerantwort des Diensts. |
|
Cloud |
Eine Fehlerantwort des Diensts. |
|
Severity |
Schweregrad der Warnung. |
Alert
Die Warnung.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Die Warnungs-ID. |
| name |
string |
Der Warnungsname. |
| properties.alertConfiguration |
Die Warnungskonfiguration. |
|
| properties.alertDefinition |
Die Warnungsdefinition. |
|
| properties.alertIncidents |
Die Warnungsvorfälle. |
|
| properties.incidentCount |
integer (int32) |
Die Anzahl der generierten Vorfälle der Warnung. |
| properties.isActive |
boolean |
False standardmäßig; true, wenn die Warnung aktiv ist. |
| properties.lastModifiedDateTime |
string (date-time) |
Datum, zu dem die Warnungskonfiguration aktualisiert oder neue Vorfälle generiert wurden. |
| properties.lastScannedDateTime |
string (date-time) |
Das Datum, zu dem die Warnung zuletzt gescannt wurde. |
| properties.scope |
string |
Der Warnungsbereich. |
| type |
string |
Der Warnungstyp. |
AlertConfiguration
Warnungskonfiguration.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Die Konfigurations-ID der Warnung. |
| name |
string |
Der Name der Warnungskonfiguration. |
| properties.alertConfigurationType |
string |
Der Konfigurationstyp der Warnung. |
| properties.alertDefinition |
Die Warnungsdefinition. |
|
| properties.alertDefinitionId |
string |
Die Id der Warnungsdefinition. |
| properties.isEnabled |
boolean |
True, wenn die Warnung aktiviert ist, deaktiviert false die Überprüfung auf die jeweilige Warnung. |
| properties.scope |
string |
Der Warnungsbereich. |
| type |
string |
Der Konfigurationstyp der Warnung. |
AlertDefinition
Warnungsdefinition
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Die Id der Warnungsdefinition. |
| name |
string |
Der Name der Warnungsdefinition. |
| properties.description |
string |
Die Warnungsbeschreibung. |
| properties.displayName |
string |
Der Anzeigename der Warnung. |
| properties.howToPrevent |
string |
Die Möglichkeiten, die Warnung zu verhindern. |
| properties.isConfigurable |
boolean |
True, wenn die Warnungskonfiguration konfiguriert werden kann; false, andernfalls. |
| properties.isRemediatable |
boolean |
True, wenn die Warnung behoben werden kann; false, andernfalls. |
| properties.mitigationSteps |
string |
Die Methoden zum Mindern der Warnung. |
| properties.scope |
string |
Der Warnungsbereich. |
| properties.securityImpact |
string |
Auswirkungen auf die Sicherheit der Warnung. |
| properties.severityLevel |
Schweregrad der Warnung. |
|
| type |
string |
Der Warnungsdefinitionstyp. |
AlertIncident
Warnungsvorfall
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Die Id des Warnungsvorfalls. |
| name |
string |
Der Name des Warnungsvorfalls. |
| properties.alertIncidentType |
string |
Der Warnungsvorfalltyp. |
| type |
string |
Der Warnungsvorfalltyp. |
AlertListResult
Ergebnis des Warnungslistenvorgangs.
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string |
Die URL, die zum Abrufen des nächsten Resultsets verwendet werden soll. |
| value |
Alert[] |
Warnungsliste |
CloudError
Eine Fehlerantwort des Diensts.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Eine Fehlerantwort des Diensts. |
CloudErrorBody
Eine Fehlerantwort des Diensts.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden. |
| message |
string |
Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist. |
SeverityLevel
Schweregrad der Warnung.
| Wert | Beschreibung |
|---|---|
| Low | |
| Medium | |
| High |