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(다음 안에) 필수 형식 Description
managementGroupId
path True

string

관리 그룹 ID입니다.

managementGroupsNamespace
path True

ManagementGroupsNamespaceType

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

api-version
query True

string

클라이언트 API 버전.

$filter
query

string

OData 필터 식입니다.

$top
query

integer

int32

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

응답

Name 형식 Description
200 OK

RemediationListResult

검색된 수정입니다.

Other Status Codes

ErrorResponse

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

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

정의

Name Description
createdByType

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

ErrorDefinition

오류 정의입니다.

ErrorResponse

오류 응답입니다.

FailureThreshold

수정 실패 임계값 설정

ManagementGroupsNamespaceType

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

Remediation

수정 정의입니다.

RemediationDeploymentSummary

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

RemediationFilters

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

RemediationListResult

수정 목록입니다.

ResourceDiscoveryMode

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

systemData

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

TypedErrorInfo

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

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDefinition

오류 정의입니다.

Name 형식 Description
additionalInfo

TypedErrorInfo[]

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

code

string

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

details

ErrorDefinition[]

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

message

string

오류 설명입니다.

target

string

오류의 대상입니다.

ErrorResponse

오류 응답입니다.

Name 형식 Description
error

ErrorDefinition

오류 세부 정보입니다.

FailureThreshold

수정 실패 임계값 설정

Name 형식 Description
percentage

number

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

ManagementGroupsNamespaceType

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

Name 형식 Description
Microsoft.Management

string

Remediation

수정 정의입니다.

Name 형식 Description
id

string

수정의 ID입니다.

name

string

수정의 이름입니다.

properties.correlationId

string

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

properties.createdOn

string

수정을 만든 시간입니다.

properties.deploymentStatus

RemediationDeploymentSummary

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

properties.failureThreshold

FailureThreshold

수정 실패 임계값 설정

properties.filters

RemediationFilters

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

properties.lastUpdatedOn

string

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

properties.parallelDeployments

integer

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

properties.policyAssignmentId

string

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

properties.policyDefinitionReferenceId

string

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

properties.provisioningState

string

수정의 상태. 이는 개별 배포가 아닌 전체 수정 작업을 나타냅니다. 허용되는 값은 평가, 취소됨, 취소, 실패, 완료 또는 성공입니다.

properties.resourceCount

integer

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

properties.resourceDiscoveryMode

ResourceDiscoveryMode

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

properties.statusMessage

string

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

systemData

systemData

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

type

string

수정 유형입니다.

RemediationDeploymentSummary

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

Name 형식 Description
failedDeployments

integer

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

successfulDeployments

integer

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

totalDeployments

integer

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

RemediationFilters

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

Name 형식 Description
locations

string[]

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

RemediationListResult

수정 목록입니다.

Name 형식 Description
nextLink

string

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

value

Remediation[]

수정 정의의 배열입니다.

ResourceDiscoveryMode

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

Name 형식 Description
ExistingNonCompliant

string

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

ReEvaluateCompliance

string

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

systemData

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

Name 형식 Description
createdAt

string

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

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

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

lastModifiedAt

string

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

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

TypedErrorInfo

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

Name 형식 Description
info

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

type

string

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