Delen via

Alerts - List For Scope

  • Referentie
Service:
Authorization
API-versie:
2022-08-01-preview

Hiermee worden waarschuwingen voor een resourcebereik ophaalt.

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleManagementAlerts?api-version=2022-08-01-preview

URI-parameters

Name In Vereist Type Description
scope
 path True

string

Het bereik van de waarschuwing.
api-version
 query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

AlertListResult

OK: retourneert een matrix met waarschuwingen.
Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

GetAlerts

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/afa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleManagementAlerts?api-version=2022-08-01-preview

Voorbeeldrespons

Statuscode:
200 
{
  "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"
    }
  ]
}

Definities

Name Description
Alert

De waarschuwing.
AlertConfiguration

Waarschuwingsconfiguratie.
AlertDefinition

Waarschuwingsdefinitie
AlertIncident

Waarschuwingsincident
AlertListResult

Resultaat van de bewerking van de waarschuwingslijst.
CloudError

Een foutreactie van de service.
CloudErrorBody

Een foutreactie van de service.
SeverityLevel

Ernstniveau van de waarschuwing.

Alert

De waarschuwing.

Name Type Description
id

string

De waarschuwings-id.
name

string

De naam van de waarschuwing.
properties.alertConfiguration

AlertConfiguration

De waarschuwingsconfiguratie.
properties.alertDefinition

AlertDefinition

De waarschuwingsdefinitie.
properties.alertIncidents

AlertIncident[]

De waarschuwingsincidenten.
properties.incidentCount

integer

Het aantal gegenereerde incidenten van de waarschuwing.
properties.isActive

boolean

Standaard onwaar; waar als de waarschuwing actief is.
properties.lastModifiedDateTime

string

De datum waarop de waarschuwingsconfiguratie is bijgewerkt of waarop nieuwe incidenten zijn gegenereerd.
properties.lastScannedDateTime

string

De datum waarop de waarschuwing voor het laatst is gescand.
properties.scope

string

Het waarschuwingsbereik.
type

string

Het waarschuwingstype.

AlertConfiguration

Waarschuwingsconfiguratie.

Name Type Description
id

string

De configuratie-id van de waarschuwing.
name

string

De naam van de waarschuwingsconfiguratie.
properties.alertConfigurationType

string

Het type waarschuwingsconfiguratie.
properties.alertDefinition

AlertDefinition

De waarschuwingsdefinitie.
properties.alertDefinitionId

string

De id van de waarschuwingsdefinitie.
properties.isEnabled

boolean

Waar als de waarschuwing is ingeschakeld, wordt het scannen voor de specifieke waarschuwing uitgeschakeld door onwaar.
properties.scope

string

Het waarschuwingsbereik.
type

string

Het type waarschuwingsconfiguratie.

AlertDefinition

Waarschuwingsdefinitie

Name Type Description
id

string

De id van de waarschuwingsdefinitie.
name

string

De naam van de waarschuwingsdefinitie.
properties.description

string

De beschrijving van de waarschuwing.
properties.displayName

string

De weergavenaam van de waarschuwing.
properties.howToPrevent

string

De manieren om de waarschuwing te voorkomen.
properties.isConfigurable

boolean

Waar als de waarschuwingsconfiguratie kan worden geconfigureerd; onwaar, anders.
properties.isRemediatable

boolean

Waar als de waarschuwing kan worden hersteld; onwaar, anders.
properties.mitigationSteps

string

De methoden om de waarschuwing te beperken.
properties.scope

string

Het waarschuwingsbereik.
properties.securityImpact

string

Beveiligingsimpact van de waarschuwing.
properties.severityLevel

SeverityLevel

Ernstniveau van de waarschuwing.
type

string

Het type waarschuwingsdefinitie.

AlertIncident

Waarschuwingsincident

Name Type Description
id

string

De id van het waarschuwingsincident.
name

string

De naam van het waarschuwingsincident.
properties.alertIncidentType

string

Het type waarschuwingsincident.
type

string

Het type waarschuwingsincident.

AlertListResult

Resultaat van de bewerking van de waarschuwingslijst.

Name Type Description
nextLink

string

De URL die moet worden gebruikt voor het ophalen van de volgende set resultaten.
value

Alert[]

Lijst met waarschuwingen

CloudError

Een foutreactie van de service.

Name Type Description
error

CloudErrorBody

Een foutreactie van de service.

CloudErrorBody

Een foutreactie van de service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

SeverityLevel

Ernstniveau van de waarschuwing.

Name Type Description
High

string

Low

string

Medium

string