Skip to content

Commit 1dfd422

Browse files
Evolvable enumerations note in property description for:
additionalOptions additionalDataOptions exportOptions exportFileStructure
1 parent 7264e90 commit 1dfd422

14 files changed

+22
-21
lines changed

api-reference/beta/api/security-ediscoveryreviewset-addtoreviewset.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The following table shows the parameters that can be used with this action.
4848
|Parameter|Type|Description|
4949
|:---|:---|:---|
5050
|search|[microsoft.graph.security.ediscoverySearch](../resources/security-ediscoverysearch.md)|The ID of the eDiscovery search you'd like to add to the review set.|
51-
|additionalDataOptions|microsoft.graph.security.additionalDataOptions|The options for adding items to reviewSet. The possible values are `allVersions`, `linkedFiles`, `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`, `unknownFutureValue`. Note: `locationsWithoutHits` and `advancedIndexing` are only considered if the **itemsToIncude** parameter is set to `partiallyIndexed`.|
51+
|additionalDataOptions|microsoft.graph.security.additionalDataOptions|The options for adding items to reviewSet. The possible values are `allVersions`, `linkedFiles`, `unknownFutureValue`, `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`. Note: `locationsWithoutHits` and `advancedIndexing` are only considered if the **itemsToIncude** parameter is set to `partiallyIndexed`.|
5252
| cloudAttachmentVersion | microsoft.graph.security.cloudAttachmentVersion | Specify how many versions of cloud attachments to collect. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|
5353
| documentVersion | microsoft.graph.security.documentVersion | Specify how many versions of documents to collect. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|
5454
| itemsToInclude | microsoft.graph.security.itemsToInclude | The items to include in the review set. The possible values are `searchHits`, `partiallyIndexed`, `unknownFutureValue`. |

api-reference/beta/api/security-ediscoveryreviewset-export.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ The following table shows the parameters that can be used with this action.
4848
|Parameter|Type|Description|
4949
|:---|:---|:---|
5050
|description|String| Description of the export. |
51-
|exportOptions|String|Specifies options that control the format of the export. Possible values are: `originalFiles`, `text`, `pdfReplacement`, `fileInfo`, `tags`, `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`, `optimizedPartitionSize`, `unknownFutureValue`. The `fileInfo` member is deprecated and stopped returning data. The summary and load file are always included. Note: If `originalFiles` isn't selected, only the `tags` member is considered. |
52-
|exportStructure|String| Bitwise options that control file structure and packaging of the export. Possible values are: `none`, `directory`, `pst`, `msg`. Note: `directory` is on the way for deprecation. Currently, if `directory` is selected, the format is `msg`, and the export options `splitSource`, `includeFolderAndPath`, and `friendlyName` are disregarded.|
51+
|exportOptions|String|Specifies options that control the format of the export. Possible values are: `originalFiles`, `text`, `pdfReplacement`, `fileInfo`, `tags`, `unknownFutureValue`, `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`, `optimizedPartitionSize`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`, `optimizePartitionSize`. The `fileInfo` member is deprecated and stopped returning data. The summary and load file are always included. Note: If `originalFiles` isn't selected, only the `tags` member is considered. |
52+
|exportStructure|String| Bitwise options that control file structure and packaging of the export. Possible values are: `none`, `directory`, `pst`, `unknownFutureValue`, `msg`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `msg`. Note: `directory` is on the way for deprecation. Currently, if `directory` is selected, the format is `msg`, and the export options `splitSource`, `includeFolderAndPath`, and `friendlyName` are disregarded.|
5353
|outputName|String| Name of the export. Required. |
5454
|azureBlobContainer (deprecated)|String| When you export to your own Azure storage account, the value is the container URL. The **azureBlobContainer** property is deprecated and stopped returning data. |
5555
|azureBlobToken (deprecated)|String| When you export to your own Azure storage account, SAS token for the container URL. The **azureBlobToken** property is deprecated and stopped returning data. |

api-reference/beta/api/security-ediscoverysearch-exportreport.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ The following table lists the parameters that you can use with this action.
5151

5252
| Parameter | Type | Description |
5353
|:---|:---|:---|
54-
| additionalOptions | [microsoft.graph.security.additionalOptions](../resources/security-ediscoverysearchexportoperation.md#additionaloptions-values) | The additional options for the export. The possible values are: `none`, `teamsAndYammerConversations`, `cloudAttachments`, `allDocumentVersions`, `subfolderContents`, `listAttachments`, `htmlTranscripts`, `advancedIndexing`, `allItemsInFolder`, `unknownFutureValue`. Note: `advancedIndexing` is only available if **exportCriteria** includes `partiallyIndexed`. Required. |
54+
| additionalOptions | [microsoft.graph.security.additionalOptions](../resources/security-ediscoverysearchexportoperation.md#additionaloptions-values) | The additional options for the export. The possible values are: `none`, `teamsAndYammerConversations`, `cloudAttachments`, `allDocumentVersions`, `subfolderContents`, `listAttachments`, `unknownFutureValue`, `htmlTranscripts`, `advancedIndexing`, `allItemsInFolder`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `htmlTranscripts`, `advancedIndexing`, `allItemsInFolder`. Note: `advancedIndexing` is only available if **exportCriteria** includes `partiallyIndexed`. Required. |
5555
| cloudAttachmentVersion | microsoft.graph.security.cloudAttachmentVersion | The versions to include for cloud attachments in messages. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|
5656
| description | String | The description of the export report. |
5757
| documentVersion | microsoft.graph.security.documentVersion | The versions to include for files in sharepoint. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|

api-reference/beta/api/security-ediscoverysearch-exportresult.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ The following table lists the parameters that you can use with this action.
5151

5252
| Parameter | Type | Description |
5353
|:---|:---|:---|
54-
| additionalOptions | [microsoft.graph.security.additionalOptions](../resources/security-ediscoverysearchexportoperation.md#additionaloptions-values) | The additional options for the export. The possible values are: `none`, `teamsAndYammerConversations`, `cloudAttachments`, `allDocumentVersions`, `subfolderContents`, `listAttachments`, `htmlTranscripts`, `advancedIndexing`, `allItemsInFolder`, `includeFolderAndPath`, `condensePaths`, `friendlyName`, `splitSource`, `optimizedPartitionSize`, `includeReport`,`unknownFutureValue`. Note: `advancedIndexing` is only available if exportCriteria includes `partiallyIndexed`. Required.|
54+
| additionalOptions | [microsoft.graph.security.additionalOptions](../resources/security-ediscoverysearchexportoperation.md#additionaloptions-values) | The additional options for the export. The possible values are: `none`, `teamsAndYammerConversations`, `cloudAttachments`, `allDocumentVersions`, `subfolderContents`, `listAttachments`, `unknownFutureValue`, `htmlTranscripts`, `advancedIndexing`, `allItemsInFolder`, `includeFolderAndPath`, `condensePaths`, `friendlyName`, `splitSource`, `optimizedPartitionSize`, `includeReport`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `htmlTranscripts`, `advancedIndexing`, `allItemsInFolder`, `includeFolderAndPath`, `condensePaths`, `friendlyName`, `splitSource`, `optimizedPartitionSize`, `includeReport`. Note: `advancedIndexing` is only available if exportCriteria includes `partiallyIndexed`. Required.|
5555
| cloudAttachmentVersion | microsoft.graph.security.cloudAttachmentVersion | The versions to include for cloud attachments in messages. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|
5656
| description | String | The description of the export result. |
5757
| displayName | String | The display name of the export result. |

api-reference/beta/resources/security-ediscoveryaddtoreviewsetoperation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ None.
2424
|Property|Type|Description|
2525
|:---|:---|:---|
2626
|action|[microsoft.graph.security.caseAction](../resources/security-caseoperation.md#caseaction-values)| The type of action the operation represents. Possible values are: `ooocontentExport`, `applyTags`, `convertToPdf`, `index`, `estimateStatistics`, `addToReviewSet`, `holdUpdate`, `unknownFutureValue`, `purgeData`, `exportReport`, `exportResult`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `purgeData`, `exportReport`, `exportResult`. Inherited from [caseOperation](../resources/security-caseoperation.md).|
27-
|additionalDataOptions|String| The options for adding items to reviewSet. |
27+
|additionalDataOptions|String| The options for adding items to reviewSet. Possible values are: `allVersions`, `linkedFiles`, `unknownFutureValue`, `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`.|
2828
|cloudAttachmentVersion|String| How many most recent versions of cloud attachments to collect.|
2929
|completedDateTime|DateTimeOffset| The date and time the operation was completed. Inherited from [caseOperation](../resources/security-caseoperation.md).|
3030
|createdBy|[identitySet](../resources/identityset.md)| The user that created the operation. Inherited from [caseOperation](../resources/security-caseoperation.md).|
@@ -41,13 +41,13 @@ None.
4141
|:---|:---|
4242
|allVersions|include all versions of a sharepoint document matching the source collection query. Caution: SharePoint versions can significantly increase the volume of items |
4343
|linkedFiles|include linked files that were shared in outlook, teams, or Yammer messages by attaching a link to the file.|
44+
|unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
4445
|advancedIndexing|To reduce false matches, perform advanced indexing during export.|
4546
|listAttachments|Include list attachments.|
4647
|htmlTranscripts|Contextual chat messages are threaded into HTML transcript.|
4748
|messageConversationExpansion|Include conversation context around a hit.|
4849
|locationsWithoutHits|Look for unindexed items even in locations without hits.|
4950
|allItemsInFolder|Include all content in folder if the folder itself matches a query.|
50-
|unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
5151

5252
### itemsToInclude values
5353
|Member|Description|

api-reference/beta/resources/security-ediscoveryexportoperation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,8 @@ Inherits from [caseOperation](../resources/security-caseoperation.md).
3232
|createdDateTime|DateTimeOffset| The date and time the export was created. Inherited from [caseOperation](../resources/security-caseoperation.md).|
3333
|description|String| The description provided for the export.|
3434
|exportFileMetadata | [microsoft.graph.security.ediscoveryExportFileMetadata](../resources/security-ediscoveryexportfilemetadata.md)| Contains the properties for an export file metadata, including **downloadUrl**, **fileName**, and **size**. If you export to an Azure storage location, this property returns empty. |
35-
|exportOptions|microsoft.graph.security.exportOptions| The options provided for the export. For more information, see [reviewSet: export](../api/security-ediscoveryreviewset-export.md). The `fileInfo` member is deprecated and stopped returning data on April 30, 2023. Going forward, the summary and load file are always included. |
36-
|exportStructure|microsoft.graph.security.exportFileStructure|The options that specify the structure of the export. For more information, see [reviewSet: export](../api/security-ediscoveryreviewset-export.md). Possible values are: `none`, `directory`, `pst`.|
35+
|exportOptions|microsoft.graph.security.exportOptions| The options provided for the export. For more information, see [reviewSet: export](../api/security-ediscoveryreviewset-export.md). The `fileInfo` member is deprecated and stopped returning data on April 30, 2023. Going forward, the summary and load file are always included. Possible values are: `originalFiles`, `text`, `pdfReplacement`, `tags`, `unknownFutureValue`, `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`, `optimizedPartitionSize`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `splitSource`, `includeFolderAndPath`, `friendlyName`, `condensePaths`, `optimizedPartitionSize`.|
36+
|exportStructure|microsoft.graph.security.exportFileStructure|The options that specify the structure of the export. For more information, see [reviewSet: export](../api/security-ediscoveryreviewset-export.md). Possible values are: `none`, `directory`, `pst`, `unknownFutureValue`, `msg`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `msg`.|
3737
|id|String| The ID for the operation. Read-only. Inherited from [caseOperation](../resources/security-caseoperation.md).|
3838
|outputName|String| The name provided for the export.|
3939
|percentProgress|Int32| The progress of the operation. Inherited from [caseOperation](../resources/security-caseoperation.md).|

api-reference/beta/resources/security-ediscoverysearchexportoperation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Inherits from [caseOperation](../resources/security-caseoperation.md).
2323
|Property|Type|Description|
2424
|:---|:---|:---|
2525
|action|[microsoft.graph.security.caseAction](../resources/security-caseoperation.md#caseaction-values)| The type of action the operation represents. Possible values are: `contentExport`, `applyTags`, `convertToPdf`, `index`, `estimateStatistics`, `addToReviewSet`, `holdUpdate`, `unknownFutureValue`, `purgeData`, `exportReport`, `exportResult`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `purgeData`, `exportReport`, `exportResult`. Inherited from [caseOperation](../resources/security-caseoperation.md).|
26-
|additionalOptions|[microsoft.graph.security.additionalOptions](../resources/security-ediscoverysearchexportoperation.md#additionaloptions-values)| The additional items to include in the export. The possible values are: `none`, `teamsAndYammerConversations`, `cloudAttachments`, `allDocumentVersions`, `subfolderContents`, `listAttachments`, `htmlTranscripts`,`advancedIndexing`, `allItemsInFolder`, `includeFolderAndPath`, `condensePaths`, `friendlyName`, `splitSource`, `optimizedPartitionSize`, `includeReport`,`unknownFutureValue`. |
26+
|additionalOptions|[microsoft.graph.security.additionalOptions](../resources/security-ediscoverysearchexportoperation.md#additionaloptions-values)| The additional items to include in the export. The possible values are: `none`, `teamsAndYammerConversations`, `cloudAttachments`, `allDocumentVersions`, `subfolderContents`, `listAttachments`, `unknownFutureValue`, `htmlTranscripts`,`advancedIndexing`, `allItemsInFolder`, `includeFolderAndPath`, `condensePaths`, `friendlyName`, `splitSource`, `optimizedPartitionSize`, `includeReport`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `htmlTranscripts`,`advancedIndexing`, `allItemsInFolder`, `includeFolderAndPath`, `condensePaths`, `friendlyName`, `splitSource`, `optimizedPartitionSize`, `includeReport`.|
2727
|cloudAttachmentVersion|[microsoft.graph.security.cloudAttachmentVersion](../resources/enums-security.md#cloudattachmentversion-values)|The versions to include for cloud attachments in messages.|
2828
|completedDateTime|DateTimeOffset|The date and time when the operation was completed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [caseOperation](../resources/security-caseoperation.md).|
2929
|createdBy|[microsoft.graph.identitySet](../resources/identityset.md)|The user who created the operation. Inherited from [caseOperation](../resources/security-caseoperation.md).|

api-reference/v1.0/api/security-ediscoveryreviewset-addtoreviewset.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The following table shows the parameters that can be used with this action.
4848
|Parameter|Type|Description|
4949
|:---|:---|:---|
5050
|search|[microsoft.graph.security.ediscoverySearch](../resources/security-ediscoverysearch.md)|The ID of the eDiscovery search you'd like to add to the review set.|
51-
|additionalDataOptions|microsoft.graph.security.additionalDataOptions|The options for adding items to reviewSet. Note: `locationsWithoutHits` and `advancedIndexing` are only considered if **itemsToIncude** is set to `partiallyIndexed`.|
51+
|additionalDataOptions|microsoft.graph.security.additionalDataOptions|The options for adding items to reviewSet. Note: `locationsWithoutHits` and `advancedIndexing` are only considered if **itemsToIncude** is set to `partiallyIndexed`. The possible values are `allVersions`, `linkedFiles`, `unknownFutureValue`, `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/concepts/best-practices-concept#handling-future-members-in-evolvable-enumerations): `advancedIndexing`, `listAttachments`, `htmlTranscripts`, `messageConversationExpansion`, `locationsWithoutHits`, `allItemsInFolder`.|
5252
| cloudAttachmentVersion | [microsoft.graph.security.cloudAttachmentVersion](../resources/enums-security.md#cloudattachmentversion-values) | The number of most recent versions of cloud attachments to collect. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|
5353
| documentVersion | [microsoft.graph.security.documentVersion](../resources/enums-security.md#documentversion-values) | The number of most recent versions of documents to collect. The possible values are `latest`, `recent10`, `recent100`, `all`. Default is `latest`.|
5454
| itemsToInclude | microsoft.graph.security.itemsToInclude | The items to include in the review set. The possible values are `searchHits`, `partiallyIndexed`, `unknownFutureValue`. |

0 commit comments

Comments
 (0)