Compartir a través de


Remediations - Cancel At Management Group

Cancela una corrección en el ámbito del grupo de administración.

POST https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/cancel?api-version=2021-10-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
managementGroupId
path True

string

Identificador del grupo de administración.

managementGroupsNamespace
path True

ManagementGroupsNamespaceType

Espacio de nombres para el RP de administración de Microsoft; solo se permite "Microsoft.Management".

remediationName
path True

string

Nombre de la corrección.

api-version
query True

string

Versión de api de cliente.

Respuestas

Nombre Tipo Description
200 OK

Remediation

Corrección que se canceló.

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Cancel a remediation at management group scope

Sample Request

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

Sample Response

{
  "properties": {
    "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/financeMg/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
    "provisioningState": "Cancelling",
    "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/myRemediation",
  "name": "myRemediation",
  "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"
  }
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

ErrorDefinition

Definición de error.

ErrorResponse

Respuesta de error.

FailureThreshold

La configuración del umbral de error de corrección

ManagementGroupsNamespaceType

Espacio de nombres para el RP de administración de Microsoft; solo se permite "Microsoft.Management".

Remediation

Definición de corrección.

RemediationDeploymentSummary

Resumen del estado de implementación de todas las implementaciones creadas por la corrección.

RemediationFilters

Filtros que se aplicarán para determinar qué recursos corregir.

ResourceDiscoveryMode

Se detecta la forma en que se detectan los recursos para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

TypedErrorInfo

Detalles de error específicos del escenario.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDefinition

Definición de error.

Nombre Tipo Description
additionalInfo

TypedErrorInfo[]

Detalles adicionales del error específico del escenario.

code

string

Código de error específico del servicio que actúa como subestado para el código de error HTTP.

details

ErrorDefinition[]

Detalles internos del error.

message

string

Descripción del error.

target

string

Destino del error.

ErrorResponse

Respuesta de error.

Nombre Tipo Description
error

ErrorDefinition

Los detalles del error.

FailureThreshold

La configuración del umbral de error de corrección

Nombre Tipo Description
percentage

number

Número comprendido entre 0,0 y 1,0 que representa el umbral de error porcentual. Se producirá un error en la corrección si el porcentaje de operaciones de corrección con errores (es decir, implementaciones con errores) supera este umbral.

ManagementGroupsNamespaceType

Espacio de nombres para el RP de administración de Microsoft; solo se permite "Microsoft.Management".

Nombre Tipo Description
Microsoft.Management

string

Remediation

Definición de corrección.

Nombre Tipo Description
id

string

Identificador de la corrección.

name

string

Nombre de la corrección.

properties.correlationId

string

Identificador de correlación de corrección. Se puede usar para buscar eventos relacionados con la corrección en el registro de actividad.

properties.createdOn

string

Hora en la que se creó la corrección.

properties.deploymentStatus

RemediationDeploymentSummary

Resumen del estado de implementación de todas las implementaciones creadas por la corrección.

properties.failureThreshold

FailureThreshold

La configuración del umbral de error de corrección

properties.filters

RemediationFilters

Filtros que se aplicarán para determinar qué recursos corregir.

properties.lastUpdatedOn

string

Hora en la que se actualizó por última vez la corrección.

properties.parallelDeployments

integer

Determina cuántos recursos corregir en un momento dado. Se puede usar para aumentar o reducir el ritmo de la corrección. Si no se proporciona, se usa el valor predeterminado de implementaciones paralelas.

properties.policyAssignmentId

string

Identificador de recurso de la asignación de directiva que se debe corregir.

properties.policyDefinitionReferenceId

string

Identificador de referencia de definición de directiva de la definición individual que se debe corregir. Se requiere cuando la asignación de directiva que se va a corregir asigna una definición de conjunto de directivas.

properties.provisioningState

string

Estado de la corrección. Esto hace referencia a toda la tarea de corrección, no a implementaciones individuales. Los valores permitidos son Evaluación, Cancelación, Cancelación, Error, Completado o Correcto.

properties.resourceCount

integer

Determina el número máximo de recursos que el trabajo de corrección puede corregir. Si no se proporciona, se usa el recuento de recursos predeterminado.

properties.resourceDiscoveryMode

ResourceDiscoveryMode

Se detecta la forma en que se detectan los recursos para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica.

properties.statusMessage

string

Mensaje de estado de corrección. Proporciona detalles adicionales sobre el estado de la corrección.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type

string

Tipo de corrección.

RemediationDeploymentSummary

Resumen del estado de implementación de todas las implementaciones creadas por la corrección.

Nombre Tipo Description
failedDeployments

integer

Número de implementaciones requeridas por la corrección que ha producido un error.

successfulDeployments

integer

Número de implementaciones requeridas por la corrección que se han realizado correctamente.

totalDeployments

integer

Número de implementaciones requeridas por la corrección.

RemediationFilters

Filtros que se aplicarán para determinar qué recursos corregir.

Nombre Tipo Description
locations

string[]

Ubicaciones de recursos que se corregirán.

ResourceDiscoveryMode

Se detecta la forma en que se detectan los recursos para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica.

Nombre Tipo Description
ExistingNonCompliant

string

Corrija los recursos que ya se sabe que no son compatibles.

ReEvaluateCompliance

string

Vuelva a evaluar el estado de cumplimiento de los recursos y, a continuación, corrija los recursos encontrados como no compatibles.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

TypedErrorInfo

Detalles de error específicos del escenario.

Nombre Tipo Description
info

Detalles específicos del error del escenario.

type

string

Tipo de detalles de error incluidos.