Remediations - List For Management Group

관리 그룹에 대한 모든 수정을 가져옵니다.

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 매개 변수

Name In Required Type Description
managementGroupId
path True
  • string

관리 그룹 ID입니다.

managementGroupsNamespace
path True

Microsoft Management RP의 네임스페이스 "Microsoft.Management"만 허용됩니다.

api-version
query True
  • string

클라이언트 API 버전입니다.

$filter
query
  • string

OData 필터 식입니다.

$top
query
  • integer
int32

반환할 최대 레코드 수입니다.

응답

Name Type Description
200 OK

검색된 수정입니다.

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

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 사용자 계정 가장

예제

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"
      }
    }
  ]
}

정의

createdByType

리소스를 만든 ID의 형식입니다.

ErrorDefinition

오류 정의입니다.

ErrorResponse

오류 응답입니다.

FailureThreshold

수정 실패 임계값 설정

ManagementGroupsNamespaceType

Microsoft Management RP의 네임스페이스 "Microsoft.Management"만 허용됩니다.

Remediation

수정 정의입니다.

RemediationDeploymentSummary

수정에서 만든 모든 배포에 대한 배포 상태 요약입니다.

RemediationFilters

수정할 리소스를 결정하기 위해 적용할 필터입니다.

RemediationListResult

수정 목록입니다.

ResourceDiscoveryMode

수정할 리소스를 검색하는 방법입니다. 지정하지 않으면 기본값은 ExistingNonCompliant입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

TypedErrorInfo

시나리오별 오류 세부 정보입니다.

createdByType

리소스를 만든 ID의 형식입니다.

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

ErrorDefinition

오류 정의입니다.

Name Type Description
additionalInfo

추가 시나리오 관련 오류 세부 정보입니다.

code
  • string

HTTP 오류 코드의 하위 통계 역할을 하는 서비스별 오류 코드입니다.

details

내부 오류 세부 정보입니다.

message
  • string

오류 설명입니다.

target
  • string

오류의 대상입니다.

ErrorResponse

오류 응답입니다.

Name Type Description
error

오류 세부 정보입니다.

FailureThreshold

수정 실패 임계값 설정

Name Type Description
percentage
  • number

실패율 임계값을 나타내는 0.0에서 1.0 사이의 숫자입니다. 실패한 수정 작업(예: 실패한 배포)의 비율이 이 임계값을 초과하면 수정이 실패합니다.

ManagementGroupsNamespaceType

Microsoft Management RP의 네임스페이스 "Microsoft.Management"만 허용됩니다.

Name Type Description
Microsoft.Management
  • string

Remediation

수정 정의입니다.

Name Type Description
id
  • string

수정의 ID입니다.

name
  • string

수정의 이름입니다.

properties.correlationId
  • string

수정 상관 관계 ID입니다. 활동 로그에서 수정과 관련된 이벤트를 찾는 데 사용할 수 있습니다.

properties.createdOn
  • string

수정을 만든 시간입니다.

properties.deploymentStatus

수정에서 만든 모든 배포에 대한 배포 상태 요약입니다.

properties.failureThreshold

수정 실패 임계값 설정

properties.filters

수정할 리소스를 결정하기 위해 적용할 필터입니다.

properties.lastUpdatedOn
  • string

수정이 마지막으로 업데이트된 시간입니다.

properties.parallelDeployments
  • integer

지정된 시간에 수정할 리소스 수를 결정합니다. 수정 속도를 늘리거나 줄이는 데 사용할 수 있습니다. 제공되지 않으면 기본 병렬 배포 값이 사용됩니다.

properties.policyAssignmentId
  • string

수정해야 하는 정책 할당의 리소스 ID입니다.

properties.policyDefinitionReferenceId
  • string

수정해야 하는 개별 정의의 정책 정의 참조 ID입니다. 수정 중인 정책 할당이 정책 집합 정의를 할당할 때 필요합니다.

properties.provisioningState
  • string

수정 상태입니다.

properties.resourceCount
  • integer

수정 작업에서 수정할 수 있는 최대 리소스 수를 결정합니다. 제공되지 않으면 기본 리소스 수가 사용됩니다.

properties.resourceDiscoveryMode

수정할 리소스를 검색하는 방법입니다. 지정하지 않으면 기본값은 ExistingNonCompliant입니다.

properties.statusMessage
  • string

수정 상태 메시지입니다. 수정 상태에 대한 추가 세부 정보를 제공합니다.

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

type
  • string

수정의 형식입니다.

RemediationDeploymentSummary

수정에서 만든 모든 배포에 대한 배포 상태 요약입니다.

Name Type Description
failedDeployments
  • integer

실패한 수정에 필요한 배포 수입니다.

successfulDeployments
  • integer

성공한 수정에 필요한 배포 수입니다.

totalDeployments
  • integer

수정에 필요한 배포 수입니다.

RemediationFilters

수정할 리소스를 결정하기 위해 적용할 필터입니다.

Name Type Description
locations
  • string[]

수정할 리소스 위치입니다.

RemediationListResult

수정 목록입니다.

Name Type Description
nextLink
  • string

다음 결과 집합을 가져올 URL입니다.

value

수정 정의의 배열입니다.

ResourceDiscoveryMode

수정할 리소스를 검색하는 방법입니다. 지정하지 않으면 기본값은 ExistingNonCompliant입니다.

Name Type Description
ExistingNonCompliant
  • string

이미 비준수로 알려진 리소스를 수정합니다.

ReEvaluateCompliance
  • string

리소스의 준수 상태를 다시 평가한 다음 비준수로 확인된 리소스를 수정합니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt
  • string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy
  • string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.

TypedErrorInfo

시나리오별 오류 세부 정보입니다.

Name Type Description
info

시나리오별 오류 세부 정보입니다.

type
  • string

포함된 오류 세부 정보의 유형입니다.