Freigeben über


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

AlertListResult

OK : Gibt ein Array von Warnungen zurück.

Other Status Codes

CloudError

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.

AlertConfiguration

Warnungskonfiguration.

AlertDefinition

Warnungsdefinition

AlertIncident

Warnungsvorfall

AlertListResult

Ergebnis des Warnungslistenvorgangs.

CloudError

Eine Fehlerantwort des Diensts.

CloudErrorBody

Eine Fehlerantwort des Diensts.

SeverityLevel

Schweregrad der Warnung.

Alert

Die Warnung.

Name Typ Beschreibung
id

string

Die Warnungs-ID.

name

string

Der Warnungsname.

properties.alertConfiguration

AlertConfiguration

Die Warnungskonfiguration.

properties.alertDefinition

AlertDefinition

Die Warnungsdefinition.

properties.alertIncidents

AlertIncident[]

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

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

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

CloudErrorBody

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