title | description | ms.localizationpriority | author | ms.subservice | doc_type |
---|---|---|---|---|---|
informationProtectionLabel: evaluateRemoval (deprecated) |
Evaluate which label to remove and how to remove it based on existing content info. Deprecated. |
medium |
tommoser |
security |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
[!INCLUDE informationprotection-deprecate]
Indicate to the consuming application what actions it should take to remove the label information.
Given contentInfo as an input, which includes existing content metadata key/value pairs, the API returns an informationProtectionAction that contains some combination of one of more of the following:
- justifyAction
- metadataAction
- removeContentFooterAction
- removeContentHeaderAction
- removeProtectionAction
- removeWatermarkAction
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
POST /informationProtection/policy/labels/evaluateRemoval
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Content-type | application/json. Required. |
User-Agent | Describes the name and version of the calling application. Details will surface in Azure Information Protection Analytics. Suggested format is ApplicationName/Version. Optional. |
In the request body, provide a JSON object with the following parameters.
Parameter | Type | Description |
---|---|---|
contentInfo | contentInfo | Provides details about the content format, content state, and existing metadata as key/value pairs. |
downgradeJustification | downgradeJustification | Justification that must be provided by the user or application logic. |
If successful, this method returns a 200 OK
response code and a new informationProtectionAction collection object in the response body. The informationProtectionAction object will contain a metadataAction object that informs the application which metadata to remove.
The following is an example of how to call this API.
The following example shows a request.
POST https://graph.microsoft.com/beta/informationProtection/policy/labels/evaluateRemoval
Content-type: application/json
User-agent: ContosoLOBApp/1.0
{
"contentInfo": {
"@odata.type": "#microsoft.graph.contentInfo",
"format@odata.type": "#microsoft.graph.contentFormat",
"format": "default",
"identifier": null,
"state@odata.type": "#microsoft.graph.contentState",
"state": "rest",
"metadata@odata.type": "#Collection(microsoft.graph.keyValuePair)",
"metadata": [
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled",
"value": "True"
},
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method",
"value": "Standard"
},
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate",
"value": "1/1/0001 12:00:00 AM"
},
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId",
"value": "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"
},
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name",
"value": "General"
},
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits",
"value": "0"
},
{
"@odata.type": "#microsoft.graph.keyValuePair",
"name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId",
"value": "00000000-0000-0000-0000-000000000000"
}
]
},
"downgradeJustification": {
"justificationMessage": "The information has been declassified.",
"isDowngradeJustified": true
}
}
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.informationProtectionAction)",
"value": [
{
"@odata.type": "#microsoft.graph.metadataAction",
"metadataToRemove": [
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled",
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method",
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate",
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId",
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name",
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits",
"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId"
],
"metadataToAdd": []
}
]
}