Remediations - Cancel At Resource
Abbrechen einer Korrektur im Ressourcenbereich.
POST https://management.azure.com/{resourceId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/cancel?api-version=2021-10-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
remediation
|
path | True |
string |
Der Name der Korrektur. |
resource
|
path | True |
string |
Ressourcen-ID |
api-version
|
query | True |
string |
Client-API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Wiederherstellung, die abgebrochen wurde. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Cancel a remediation at individual resource scope
Beispielanforderung
Beispiel für eine Antwort
{
"properties": {
"policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myResourceGroup/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
"provisioningState": "Cancelling",
"createdOn": "2018-09-13T21:51:09.085918Z",
"lastUpdatedOn": "2018-09-13T21:52:10.0011706Z",
"resourceDiscoveryMode": "ExistingNonCompliant",
"deploymentStatus": {
"totalDeployments": 1,
"successfulDeployments": 1,
"failedDeployments": 0
},
"statusMessage": "Remediation extended status",
"correlationId": "a14e1d60-dae9-4771-b4be-a556d69e77a6",
"resourceCount": 42,
"parallelDeployments": 6,
"failureThreshold": {
"percentage": 0.1
}
},
"id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myResourceGroup/providers/microsoft.storage/storageaccounts/storAc1/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"
}
}
Definitionen
Name | Beschreibung |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Fehlerdefinition. |
Error |
Fehlerantwort. |
Failure |
Schwellenwerteinstellungen für Korrekturfehler |
Remediation |
Die Wartungsdefinition. |
Remediation |
Die Bereitstellung status Zusammenfassung für alle Bereitstellungen, die von der Wartung erstellt wurden. |
Remediation |
Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen wiederhergestellt werden sollen. |
Resource |
Die Art und Weise, wie Ressourcen ermittelt werden, die wiederhergestellt werden sollen. Wenn nicht angegeben, wird "ExistingNonCompliant" standardmäßig verwendet. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
Typed |
Szenariospezifische Fehlerdetails. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorDefinition
Fehlerdefinition.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Zusätzliche szenariospezifische Fehlerdetails. |
|
code |
string |
Dienstspezifischer Fehlercode, der als Unterstatus für den HTTP-Fehlercode dient. |
details |
Interne Fehlerdetails. |
|
message |
string |
Beschreibung des Fehlers |
target |
string |
Das Ziel des Fehlers. |
ErrorResponse
Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
error |
Die Fehlerdetails. |
FailureThreshold
Schwellenwerteinstellungen für Korrekturfehler
Name | Typ | Beschreibung |
---|---|---|
percentage |
number |
Eine Zahl zwischen 0,0 und 1,0, die den Fehlerschwellenwert in Prozent darstellt. Die Wartung schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlerhafte Bereitstellungen) diesen Schwellenwert überschreitet. |
Remediation
Die Wartungsdefinition.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Die ID der Wartung. |
name |
string |
Der Name der Korrektur. |
properties.correlationId |
string |
Die Korrekturkorrelations-ID. Kann verwendet werden, um Ereignisse im Zusammenhang mit der Korrektur im Aktivitätsprotokoll zu finden. |
properties.createdOn |
string |
Der Zeitpunkt, zu dem die Korrektur erstellt wurde. |
properties.deploymentStatus |
Die Bereitstellung status Zusammenfassung für alle Bereitstellungen, die von der Wartung erstellt wurden. |
|
properties.failureThreshold |
Schwellenwerteinstellungen für Korrekturfehler |
|
properties.filters |
Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen wiederhergestellt werden sollen. |
|
properties.lastUpdatedOn |
string |
Der Zeitpunkt, zu dem die Korrektur zuletzt aktualisiert wurde. |
properties.parallelDeployments |
integer |
Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt wiederhergestellt werden sollen. Kann verwendet werden, um das Tempo der Korrektur zu erhöhen oder zu verringern. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. |
properties.policyAssignmentId |
string |
Die Ressourcen-ID der Richtlinienzuweisung, die wiederhergestellt werden soll. |
properties.policyDefinitionReferenceId |
string |
Die Referenz-ID der Richtliniendefinition der einzelnen Definition, die wiederhergestellt werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. |
properties.provisioningState |
string |
Die status der Korrektur. Dies bezieht sich auf die gesamte Wartungsaufgabe, nicht auf einzelne Bereitstellungen. Zulässige Werte sind Auswertend, Abgebrochen, Abbruch, Fehler, Abgeschlossen oder Erfolgreich. |
properties.resourceCount |
integer |
Bestimmt die maximale Anzahl von Ressourcen, die durch den Wartungsauftrag behoben werden können. Wenn nicht angegeben, wird die Standardressourcenanzahl verwendet. |
properties.resourceDiscoveryMode |
Die Art und Weise, wie Ressourcen ermittelt werden, die wiederhergestellt werden sollen. Wenn nicht angegeben, wird "ExistingNonCompliant" standardmäßig verwendet. |
|
properties.statusMessage |
string |
Die Status-Meldung. Stellt zusätzliche Details zum Zustand der Wartung bereit. |
systemData |
Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen. |
|
type |
string |
Der Typ der Korrektur. |
RemediationDeploymentSummary
Die Bereitstellung status Zusammenfassung für alle Bereitstellungen, die von der Wartung erstellt wurden.
Name | Typ | Beschreibung |
---|---|---|
failedDeployments |
integer |
Die Anzahl der Bereitstellungen, die für die Wiederherstellung erforderlich sind, bei denen ein Fehler aufgetreten ist. |
successfulDeployments |
integer |
Die Anzahl der Bereitstellungen, die für die erfolgreiche Wartung erforderlich sind. |
totalDeployments |
integer |
Die Anzahl der Bereitstellungen, die für die Wartung erforderlich sind. |
RemediationFilters
Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen wiederhergestellt werden sollen.
Name | Typ | Beschreibung |
---|---|---|
locations |
string[] |
Die Ressourcenspeicherorte, die wiederhergestellt werden. |
ResourceDiscoveryMode
Die Art und Weise, wie Ressourcen ermittelt werden, die wiederhergestellt werden sollen. Wenn nicht angegeben, wird "ExistingNonCompliant" standardmäßig verwendet.
Name | Typ | Beschreibung |
---|---|---|
ExistingNonCompliant |
string |
Korrigieren sie Ressourcen, von denen bereits bekannt ist, dass sie nicht konform sind. |
ReEvaluateCompliance |
string |
Bewerten Sie den Konformitätsstatus der Ressourcen neu, und korrigieren Sie dann die Ressourcen, die als nicht konform eingestuft wurden. |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
TypedErrorInfo
Szenariospezifische Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
info |
Die szenariospezifischen Fehlerdetails. |
|
type |
string |
Der Typ der enthaltenen Fehlerdetails. |