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 |
---|---|---|---|---|
management
|
path | True |
string |
관리 그룹 ID입니다. |
management
|
path | True |
Microsoft Management RP의 네임스페이스; "Microsoft.Management"만 허용됩니다. |
|
api-version
|
query | True |
string |
클라이언트 API 버전. |
$filter
|
query |
string |
OData 필터 식입니다. |
|
$top
|
query |
integer int32 |
반환할 최대 레코드 수입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
검색된 수정입니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 |
---|---|
created |
리소스를 만든 ID 유형입니다. |
Error |
오류 정의입니다. |
Error |
오류 응답입니다. |
Failure |
수정 실패 임계값 설정 |
Management |
Microsoft Management RP의 네임스페이스; "Microsoft.Management"만 허용됩니다. |
Remediation |
수정 정의입니다. |
Remediation |
배포 상태 수정에서 만든 모든 배포에 대한 요약입니다. |
Remediation |
수정할 리소스를 결정하기 위해 적용할 필터입니다. |
Remediation |
수정 목록입니다. |
Resource |
수정할 리소스를 검색하는 방법입니다. 지정하지 않으면 기본값은 ExistingNonCompliant입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
Typed |
시나리오별 오류 세부 정보입니다. |
createdByType
리소스를 만든 ID 유형입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorDefinition
오류 정의입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
추가 시나리오별 오류 세부 정보입니다. |
|
code |
string |
HTTP 오류 코드의 하위 상태 역할을 하는 서비스별 오류 코드입니다. |
details |
내부 오류 세부 정보입니다. |
|
message |
string |
오류 설명입니다. |
target |
string |
오류의 대상입니다. |
ErrorResponse
오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
오류 세부 정보입니다. |
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 |
배포 상태 수정에서 만든 모든 배포에 대한 요약입니다. |
|
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 | 형식 | Description |
---|---|---|
failedDeployments |
integer |
실패한 수정에 필요한 배포 수입니다. |
successfulDeployments |
integer |
성공한 수정에 필요한 배포 수입니다. |
totalDeployments |
integer |
수정에 필요한 배포 수입니다. |
RemediationFilters
수정할 리소스를 결정하기 위해 적용할 필터입니다.
Name | 형식 | Description |
---|---|---|
locations |
string[] |
수정할 리소스 위치입니다. |
RemediationListResult
수정 목록입니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
다음 결과 집합을 가져올 URL입니다. |
value |
수정 정의의 배열입니다. |
ResourceDiscoveryMode
수정할 리소스를 검색하는 방법입니다. 지정하지 않으면 기본값은 ExistingNonCompliant입니다.
Name | 형식 | Description |
---|---|---|
ExistingNonCompliant |
string |
이미 비준수로 알려진 리소스를 수정합니다. |
ReEvaluateCompliance |
string |
리소스의 준수 상태를 다시 평가한 다음 비준수로 확인된 리소스를 수정합니다. |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID 유형입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
TypedErrorInfo
시나리오별 오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
시나리오별 오류 세부 정보입니다. |
|
type |
string |
포함된 오류 세부 정보의 유형입니다. |