Merge pull request #3088 from Ling-Cao/speech/caoling/0221BatchProperttyUpdate

[Batch Synthesis] Reduced default retention period from 31 days to  7 days

Author: prmerger-automator[bot]

articles/ai-services/speech-service/batch-synthesis-properties.md

@@ -45,7 +45,7 @@ Batch synthesis properties are described in the following table.
 |`properties.outputFormat`|The audio output format.<br/><br/>For information about the accepted values, see [audio output formats](rest-text-to-speech.md#audio-outputs). The default output format is `riff-24khz-16bit-mono-pcm`.|
 |`properties.sentenceBoundaryEnabled`|Determines whether to generate sentence boundary data. This optional `bool` value ("true" or "false") is "false" by default.<br/><br/>If sentence boundary data is requested, then a corresponding `[nnnn].sentence.json` file is included in the results data ZIP file.|
 |`properties.succeededAudioCount`|The count of batch synthesis inputs to audio output succeeded.<br/><br/>This property is read-only.|
-|`properties.timeToLiveInHours`|A duration in hours after the synthesis job is created, when the synthesis results will be automatically deleted. This optional setting is `744` (31 days) by default. The maximum time to live is 31 days. The date and time of automatic deletion (for synthesis jobs with a status of "Succeeded" or "Failed") is equal to the `lastActionDateTime` + `timeToLiveInHours` properties.<br/><br/>Otherwise, you can call the [delete](./batch-synthesis.md#delete-batch-synthesis) synthesis method to remove the job sooner.|
+|`properties.timeToLiveInHours`|A duration in hours after the synthesis job is completed, when the synthesis results will be automatically deleted. This optional setting is `168` (7 days) by default. The maximum time to live is `744` (31 days). The date and time of automatic deletion (for synthesis jobs with a status of "Succeeded" or "Failed") is equal to the `lastActionDateTime` + `timeToLiveInHours` properties.<br/><br/>Otherwise, you can call the [delete](./batch-synthesis.md#delete-batch-synthesis) synthesis method to remove the job sooner.|
 |`properties.wordBoundaryEnabled`|Determines whether to generate word boundary data. This optional `bool` value ("true" or "false") is "false" by default.<br/><br/>If word boundary data is requested, then a corresponding `[nnnn].word.json` file is included in the results data ZIP file.|
 |`status`|The batch synthesis processing status.<br/><br/>The status should progress from "NotStarted" to "Running", and finally to either "Succeeded" or "Failed".<br/><br/>This property is read-only.|
 |`synthesisConfig`|The configuration settings to use for batch synthesis of plain text.<br/><br/>This property is only applicable when `inputKind` is set to `"PlainText"`.|

articles/ai-services/speech-service/batch-synthesis.md

@@ -83,7 +83,7 @@ You should receive a response body in the following format:
   "inputKind": "SSML",
   "customVoices": {},
   "properties": {
-    "timeToLiveInHours": 744,
+    "timeToLiveInHours": 168,
     "outputFormat": "riff-24khz-16bit-mono-pcm",
     "concatenateResult": false,
     "decompressOutputFiles": false,
@@ -115,7 +115,7 @@ You should receive a response body in the following format:
   "inputKind": "SSML",
   "customVoices": {},
   "properties": {
-    "timeToLiveInHours": 744,
+    "timeToLiveInHours": 168,
     "outputFormat": "riff-24khz-16bit-mono-pcm",
     "concatenateResult": false,
     "decompressOutputFiles": false,
@@ -159,7 +159,7 @@ You should receive a response body in the following format:
       "inputKind": "SSML",
       "customVoices": {},
       "properties": {
-        "timeToLiveInHours": 744,
+        "timeToLiveInHours": 168,
         "outputFormat": "riff-24khz-16bit-mono-pcm",
         "concatenateResult": false,
         "decompressOutputFiles": false,
@@ -186,7 +186,7 @@ You should receive a response body in the following format:
       "inputKind": "SSML",
       "customVoices": {},
       "properties": {
-        "timeToLiveInHours": 744,
+        "timeToLiveInHours": 168,
         "outputFormat": "riff-24khz-16bit-mono-pcm",
         "concatenateResult": false,
         "decompressOutputFiles": false,
@@ -215,7 +215,7 @@ The `value` property in the json response lists your synthesis requests. The lis
 
 ## Delete batch synthesis
 
-Delete the batch synthesis job history after you retrieved the audio output results. The Speech service keeps batch synthesis history for up to 31 days, or the duration of the request `timeToLiveInHours` property, whichever comes sooner. The date and time of automatic deletion (for synthesis jobs with a status of "Succeeded" or "Failed") is equal to the `lastActionDateTime` + `timeToLiveInHours` properties.
+Delete the batch synthesis job history after you retrieved the audio output results. The Speech service keeps batch synthesis history for 168 hours (7 days) by default. Alternatively, you can specify this retention period using the `timeToLiveInHours` property, up to 744 hours (31 days). The date and time of automatic deletion (for synthesis jobs with a status of "Succeeded" or "Failed") is equal to the `lastActionDateTime` + `timeToLiveInHours` properties.
 
 To delete a batch synthesis job, make an HTTP DELETE request using the URI as shown in the following example. Replace `YourSynthesisId` with your batch synthesis ID, replace `YourSpeechKey` with your Speech resource key, and replace `YourSpeechRegion` with your Speech resource region.
 
@@ -248,9 +248,7 @@ The summary file contains the synthesis results for each text input. Here's an e
   "status": "Succeeded",
   "results": [
     {
-      "contents": [
-        "<speak version=\"1.0\" xml:lang=\"en-US\"><voice name=\"en-US-JennyNeural\">The rainbow has seven colors.</voice></speak>"
-      ],
+      "contents": ["<speak version=\"1.0\" xml:lang=\"en-US\"><voice name=\"en-US-JennyNeural\">The rainbow has seven colors.</voice></speak>"],
       "status": "Succeeded",
       "audioFileName": "0001.wav",
       "properties": {