Remediations - List For Management Group

Lekéri a felügyeleti csoport összes szervizelését.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.PolicyInsights/remediations?api-version=2021-10-01
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.PolicyInsights/remediations?$top={$top}&$filter={$filter}&api-version=2021-10-01

URI-paraméterek

Name In Required Type Description
managementGroupId
path True
  • string

Felügyeleti csoport azonosítója.

managementGroupsNamespace
path True

A Microsoft Management RP névtere; csak a "Microsoft.Management" engedélyezett.

api-version
query True
  • string

Ügyfél API-verziója.

$filter
query
  • string

OData-szűrőkifejezés.

$top
query
  • integer
int32

A visszaadandó rekordok maximális száma.

Válaszok

Name Type Description
200 OK

A lekért szervizelések.

Other Status Codes

Hibaválasz, amely leírja, hogy miért hiúsult meg a művelet.

Biztonság

azure_auth

OAuth2 Flow Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

List remediations at management group scope
List remediations at management group scope with query parameters

List remediations at management group scope

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/financeMg/providers/Microsoft.PolicyInsights/remediations?api-version=2021-10-01

Sample Response

{
  "value": [
    {
      "properties": {
        "policyAssignmentId": "/providers/microsoft.management/managementGroups/financeMg/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
        "provisioningState": "Succeeded",
        "createdOn": "2018-09-13T21:51:09.075918Z",
        "lastUpdatedOn": "2018-09-13T21:52:10.0011706Z",
        "resourceDiscoveryMode": "ExistingNonCompliant",
        "deploymentStatus": {
          "totalDeployments": 2,
          "successfulDeployments": 2,
          "failedDeployments": 0
        },
        "statusMessage": "Remediation extended status",
        "correlationId": "a14e1d60-dae9-4771-b4be-a556d69e77a6",
        "resourceCount": 42,
        "parallelDeployments": 6,
        "failureThreshold": {
          "percentage": 0.1
        }
      },
      "id": "/providers/Microsoft.Management/managementGroups/financeMg/providers/microsoft.policyinsights/remediations/790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "name": "790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "type": "Microsoft.PolicyInsights/remediations",
      "systemData": {
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "createdByType": "User",
        "createdAt": "2018-09-13T21:51:09.075918Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2018-09-13T21:52:10.0011706Z"
      }
    },
    {
      "properties": {
        "policyAssignmentId": "/providers/microsoft.management/managementGroups/financeMg/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
        "provisioningState": "Succeeded",
        "createdOn": "2018-09-13T21:49:16.4638131Z",
        "lastUpdatedOn": "2018-09-13T21:50:18.4647478Z",
        "resourceDiscoveryMode": "ExistingNonCompliant",
        "deploymentStatus": {
          "totalDeployments": 2,
          "successfulDeployments": 2,
          "failedDeployments": 0
        },
        "statusMessage": "Remediation extended status",
        "correlationId": "957378d3-a143-421e-8b0e-3048dff01932"
      },
      "id": "/providers/Microsoft.Management/managementGroups/financeMg/providers/microsoft.policyinsights/remediations/0866f0cc-6cb3-422c-9fb6-a4e3e2266da8",
      "name": "0866f0cc-6cb3-422c-9fb6-a4e3e2266da8",
      "type": "Microsoft.PolicyInsights/remediations",
      "systemData": {
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "createdByType": "User",
        "createdAt": "2018-09-13T21:49:16.4638131Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2018-09-13T21:50:18.4647478Z"
      }
    }
  ]
}

List remediations at management group scope with query parameters

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/financeMg/providers/Microsoft.PolicyInsights/remediations?$top=1&$filter=PolicyAssignmentId eq '/providers/microsoft.management/managementGroups/financeMg/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5'&api-version=2021-10-01

Sample Response

{
  "value": [
    {
      "properties": {
        "policyAssignmentId": "/providers/microsoft.management/managementGroups/financeMg/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
        "provisioningState": "Succeeded",
        "createdOn": "2018-09-13T21:51:09.075918Z",
        "lastUpdatedOn": "2018-09-13T21:52:10.0011706Z",
        "resourceDiscoveryMode": "ExistingNonCompliant",
        "deploymentStatus": {
          "totalDeployments": 2,
          "successfulDeployments": 2,
          "failedDeployments": 0
        },
        "statusMessage": "Remediation extended status",
        "correlationId": "a14e1d60-dae9-4771-b4be-a556d69e77a6",
        "resourceCount": 42,
        "parallelDeployments": 6,
        "failureThreshold": {
          "percentage": 0.1
        }
      },
      "id": "/providers/Microsoft.Management/managementGroups/financeMg/providers/microsoft.policyinsights/remediations/790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "name": "790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "type": "Microsoft.PolicyInsights/remediations",
      "systemData": {
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "createdByType": "User",
        "createdAt": "2018-09-13T21:51:09.075918Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2018-09-13T21:52:10.0011706Z"
      }
    }
  ]
}

Definíciók

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorDefinition

Hibadefiníció.

ErrorResponse

Hibaválasz.

FailureThreshold

A javítási hibák küszöbértékének beállításai

ManagementGroupsNamespaceType

A Microsoft Management RP névtere; csak a "Microsoft.Management" engedélyezett.

Remediation

A szervizelési definíció.

RemediationDeploymentSummary

A szervizelés által létrehozott összes üzemelő példány üzembehelyezési állapotának összegzése.

RemediationFilters

A szervizelendő erőforrások meghatározásához alkalmazott szűrők.

RemediationListResult

A szervizelések listája.

ResourceDiscoveryMode

Az erőforrások szervizelésének módja. A ExistingNonCompliant alapértelmezett értéke, ha nincs megadva.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

TypedErrorInfo

Forgatókönyv-specifikus hibaadatok.

createdByType

Az erőforrást létrehozó identitás típusa.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorDefinition

Hibadefiníció.

Name Type Description
additionalInfo

További esetspecifikus hibaadatok.

code
  • string

Szolgáltatásspecifikus hibakód, amely a HTTP-hibakód alállapotaként szolgál.

details

Belső hiba részletei.

message
  • string

A hiba leírása.

target
  • string

A hiba célja.

ErrorResponse

Hibaválasz.

Name Type Description
error

A hiba részletei.

FailureThreshold

A javítási hibák küszöbértékének beállításai

Name Type Description
percentage
  • number

A hiba küszöbértékét jelölő 0,0 és 1,0 közötti szám. A szervizelés sikertelen lesz, ha a sikertelen szervizelési műveletek (például sikertelen üzembe helyezések) százalékos aránya meghaladja ezt a küszöbértéket.

ManagementGroupsNamespaceType

A Microsoft Management RP névtere; csak a "Microsoft.Management" engedélyezett.

Name Type Description
Microsoft.Management
  • string

Remediation

A szervizelési definíció.

Name Type Description
id
  • string

A szervizelés azonosítója.

name
  • string

A szervizelés neve.

properties.correlationId
  • string

A szervizelési korreláció azonosítója. A szervizeléssel kapcsolatos események megkeresésére használható a tevékenységnaplóban.

properties.createdOn
  • string

A szervizelés létrehozásának időpontja.

properties.deploymentStatus

A szervizelés által létrehozott összes üzemelő példány üzembehelyezési állapotának összegzése.

properties.failureThreshold

A javítási hibák küszöbértékének beállításai

properties.filters

A szervizelendő erőforrások meghatározásához alkalmazott szűrők.

properties.lastUpdatedOn
  • string

A szervizelés utolsó frissítésének időpontja.

properties.parallelDeployments
  • integer

Meghatározza, hogy egy adott időpontban hány erőforrást kell szervizelni. Segítségével növelhető vagy csökkenthető a szervizelés üteme. Ha nincs megadva, a rendszer az alapértelmezett párhuzamos üzembe helyezési értéket használja.

properties.policyAssignmentId
  • string

A szervizelendő szabályzat-hozzárendelés erőforrás-azonosítója.

properties.policyDefinitionReferenceId
  • string

A szervizelendő egyéni definíció szabályzatdefiníció-referenciaazonosítója. Akkor szükséges, ha a szervizelés alatt álló szabályzat-hozzárendelés hozzárendel egy szabályzatkészlet-definíciót.

properties.provisioningState
  • string

A szervizelés állapota.

properties.resourceCount
  • integer

Meghatározza a szervizelési feladat által orvosolható erőforrások maximális számát. Ha nincs megadva, a rendszer az alapértelmezett erőforrásszámot használja.

properties.resourceDiscoveryMode

Az erőforrások szervizelésének módja. A ExistingNonCompliant alapértelmezett értéke, ha nincs megadva.

properties.statusMessage
  • string

A szervizelési állapotüzenet. További részleteket tartalmaz a szervizelés állapotáról.

systemData

Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatokat.

type
  • string

A szervizelés típusa.

RemediationDeploymentSummary

A szervizelés által létrehozott összes üzemelő példány üzembehelyezési állapotának összegzése.

Name Type Description
failedDeployments
  • integer

A sikertelen szervizeléshez szükséges üzemelő példányok száma.

successfulDeployments
  • integer

A sikeres szervizeléshez szükséges üzembe helyezések száma.

totalDeployments
  • integer

A szervizeléshez szükséges üzemelő példányok száma.

RemediationFilters

A szervizelendő erőforrások meghatározásához alkalmazott szűrők.

Name Type Description
locations
  • string[]

A szervizelendő erőforráshelyek.

RemediationListResult

A szervizelések listája.

Name Type Description
nextLink
  • string

A következő eredményhalmaz lekéréséhez megadott URL-cím.

value

A szervizelési definíciók tömbje.

ResourceDiscoveryMode

Az erőforrások szervizelésének módja. A ExistingNonCompliant alapértelmezett értéke, ha nincs megadva.

Name Type Description
ExistingNonCompliant
  • string

A már ismerten nem megfelelő erőforrások szervizelése.

ReEvaluateCompliance
  • string

Értékelje újra az erőforrások megfelelőségi állapotát, majd szervizelje a nem megfelelőnek talált erőforrásokat.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Type Description
createdAt
  • string

Az erőforrás-létrehozás időbélyege (UTC).

createdBy
  • string

Az erőforrást létrehozó identitás.

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt
  • string

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy
  • string

Az erőforrást utoljára módosító identitás.

lastModifiedByType

Az erőforrást utoljára módosító identitás típusa.

TypedErrorInfo

Forgatókönyv-specifikus hibaadatok.

Name Type Description
info

A forgatókönyv konkrét hibaadatai.

type
  • string

A hiba részleteinek típusa.