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 |
---|---|---|---|---|
management
|
path | True |
string |
Identificador del grupo de administración. |
management
|
path | True |
Espacio de nombres para el RP de administración de Microsoft; solo se permite "Microsoft.Management". |
|
remediation
|
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 |
Corrección que se canceló. |
|
Other Status Codes |
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 |
---|---|
created |
Tipo de identidad que creó el recurso. |
Error |
Definición de error. |
Error |
Respuesta de error. |
Failure |
La configuración del umbral de error de corrección |
Management |
Espacio de nombres para el RP de administración de Microsoft; solo se permite "Microsoft.Management". |
Remediation |
Definición de corrección. |
Remediation |
Resumen del estado de implementación de todas las implementaciones creadas por la corrección. |
Remediation |
Filtros que se aplicarán para determinar qué recursos corregir. |
Resource |
Se detecta la forma en que se detectan los recursos para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
Typed |
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 |
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 |
Detalles internos del error. |
|
message |
string |
Descripción del error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error.
Nombre | Tipo | Description |
---|---|---|
error |
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 |
Resumen del estado de implementación de todas las implementaciones creadas por la corrección. |
|
properties.failureThreshold |
La configuración del umbral de error de corrección |
|
properties.filters |
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 |
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 |
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 |
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 |
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. |