Merge pull request #25396 from microsoftgraph/binbwu/extendParametersForSnapshot

Lauragra · web-flow · commit 5f5830f8086a · 2024-12-12T22:10:41.000-08:00
[2410][CloudPC] Update createSnapshot and setReviewStatus APIs
diff --git a/api-reference/beta/api/cloudpc-createsnapshot.md b/api-reference/beta/api/cloudpc-createsnapshot.md
@@ -44,7 +44,14 @@ POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/createSnapshot
 
 ## Request body
 
-Don't supply a request body for this method.
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameter that you can use with this action.
+
+|Parameter|Type|Description|
+|:---|:---|:---|
+|storageAccountId|String| The storage account which receives the restore point (snapshot).|
+|accessTier|String|The access tier of the blob file that the snapshot is copied to. Possible values are `hot`, `cool`, `cold`, `archive`, and `unknownFutureValue`. The default value is `hot`.|
 
 ## Response
 
diff --git a/api-reference/beta/api/cloudpc-setreviewstatus.md b/api-reference/beta/api/cloudpc-setreviewstatus.md
@@ -72,7 +72,8 @@ Content-Type: application/json
   "reviewStatus": {
     "inReview": true,
     "userAccessLevel": "restricted",
-    "azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview"
+    "azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",
+    "accessTier": "hot"
   }
 }
 ```
diff --git a/api-reference/beta/api/manageddevice-getcloudpcreviewstatus.md b/api-reference/beta/api/manageddevice-getcloudpcreviewstatus.md
@@ -124,7 +124,8 @@ Content-Type: application/json
     "subscriptionName": "deschutes-INT-DR-test",
     "azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",
     "azureStorageAccountName": "snapshotsUnderReview",
-    "azureStorageContainerName": "snapshotsContainer"
+    "azureStorageContainerName": "snapshotsContainer",
+    "accessTier":"hot"
 }
 ```
 
diff --git a/api-reference/beta/resources/cloudpcbulkcreatesnapshot.md b/api-reference/beta/resources/cloudpcbulkcreatesnapshot.md
@@ -29,6 +29,19 @@ Inherits from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).
 |initiatedByUserPrincipalName|String|The user principal name (UPN) of the user who initiated this bulk action. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|
 |scheduledDuringMaintenanceWindow|Boolean|Indicates whether the bulk action is scheduled according to the maintenance window. When `true`, the bulk action uses the maintenance window to schedule the action; `false` means that the bulk action doesn't use the maintenance window. The default value is `false`. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|
 |status|[cloudPcBulkActionStatus](../resources/cloudpcbulkaction.md#cloudpcbulkactionstatus-values)|The status of the bulk actions. Possible values are `pending`, `succeeded`, `failed`, `unknownFutureValue`. The default value is `pending`. Read-only. Inherited from [cloudPcBulkAction](../resources/cloudpcbulkaction.md).|
+|storageAccountId|String|The unique identifier for Secure Azure Storage Account, which receives the restore points (snapshots). The value can't be modified after it's created. For example, '/subscriptions/06199b73-30a1-4922-8734-93feca64cdf6/resourceGroups/res2627/providers/Microsoft.Storage/storageAccounts/sto1125'. Read-Only.|
+|accessTier|[cloudPcBlobAccessTier](#cloudpcblobaccesstier-values)|Indicates the access tier of the blob file that the snapshot is copied to. Possible values are `hot`, `cool`, `cold`, `archive`, and `unknownFutureValue`. The default value is `hot`. Read-Only.|
+
+
+### cloudPcBlobAccessTier values
+
+|Member|Description|
+|:---|:---|
+|hot|Indicates an online tier optimized for storing data that is accessed or modified frequently.|
+|cool|Indicates an online tier optimized for storing data that is infrequently accessed or modified.|
+|cold|Indicates an online tier optimized for storing data that is rarely accessed or modified, but still requires fast retrieval.|
+|archive|Indicates an offline access tier optimized for storing data that is rarely accessed, and that has flexible latency requirements that can be up to a few hours.|
+|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.|
 
 ## Relationships
 None.
@@ -53,6 +66,8 @@ The following JSON representation shows the resource type.
   "id": "String (identifier)",
   "initiatedByUserPrincipalName": "String",
   "scheduledDuringMaintenanceWindow": "Boolean",
-  "status": "String"
+  "status": "String",
+  "storageAccountId": "String",
+  "accessTier": "String"
 }
 ```
diff --git a/api-reference/beta/resources/cloudpcforensicstorageaccount.md b/api-reference/beta/resources/cloudpcforensicstorageaccount.md
@@ -21,6 +21,7 @@ Represents the storage account information that can be used to store a snapshot
 |:---|:---|:---|
 |storageAccountId|String|The ID of the storage account.|
 |storageAccountName|String|The name of the storage account.|
+|immutableStorage|Boolean|Indicates whether immutability policies are configured for the storage account. When `true`, the storage account only accepts `hot` as the snapshot access tier. When `false`, the storage account accepts all valid access tiers. Read-Only.|
 
 ## Relationships
 None.
@@ -39,6 +40,7 @@ The following JSON representation shows the resource type.
 {
   "@odata.type": "#microsoft.graph.cloudPcForensicStorageAccount",
   "storageAccountId": "String",
-  "storageAccountName": "String"
+  "storageAccountName": "String",
+  "immutableStorage": "Boolean"
 }
 ```
diff --git a/api-reference/beta/resources/cloudpcreviewstatus.md b/api-reference/beta/resources/cloudpcreviewstatus.md
@@ -28,15 +28,25 @@ Represents details about the review status of a Cloud PC.
 |subscriptionId|String|The ID of the Azure subscription in which the Cloud PC snapshot is being saved, in GUID format.|
 |subscriptionName|String|The name of the Azure subscription in which the Cloud PC snapshot is being saved.|
 |userAccessLevel|[cloudPcUserAccessLevel](#cloudpcuseraccesslevel-values)|The access level of the end user on the Cloud PC. Possible values are: `unrestricted`, `restricted`.|
+|accessTier|[cloudPcBlobAccessTier](#cloudpcblobaccesstier-values)| The blob access tier of the Azure Storage account in which the Cloud PC snapshot is saved with. Possible values are `hot`, `cool`, `cold`, and `archive`, default value is `hot`.|
 
 ### cloudPcUserAccessLevel values
 
 |Member|Value|Description|
 |:---|:---|:---|
 |unrestricted|0|No restriction. Users can access the Cloud PC.|
-|restricted|1|Users are not allowed to access the Cloud PC.|
-|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.|
+|restricted|1|Users aren't allowed to access the Cloud PC.|
+|unknownFutureValue|999|Evolvable enumeration sentinel value. Don't use.|
 
+### cloudPcBlobAccessTier values
+
+|Member|Description|
+|:---|:---|
+|hot|Indicates an online tier optimized for storing data that is accessed or modified frequently.|
+|cool|Indicates an online tier optimized for storing data that is infrequently accessed or modified.|
+|cold|Indicates an online tier optimized for storing data that is rarely accessed or modified, but still requires fast retrieval.|
+|archive|Indicates an offline access tier optimized for storing data that is rarely accessed, and that has flexible latency requirements that can be up to a few hours.|
+|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.|
 
 ## Relationships
 None.
@@ -59,7 +69,8 @@ The following JSON representation shows the resource type.
   "reviewStartDateTime": "String (timestamp)",
   "subscriptionId": "String",
   "subscriptionName": "String",
-  "userAccessLevel": "String"
+  "userAccessLevel": "String",
+  "accessTier": "String"
 }
 ```
 
diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json
@@ -152,6 +152,56 @@
       "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
+    {
+      "ChangeList": [
+        {
+          "Id": "bf9197c4-808f-44b6-98dc-12491aa17bb5",
+          "ApiChange": "Enumeration",
+          "ChangedApiName": "cloudPcBlobAccessTier",
+          "ChangeType": "Addition",
+          "Description": "Added the **cloudPcBlobAccessTier** enumeration type.",
+          "Target": "cloudPcBlobAccessTier"
+        },
+        {
+          "Id": "bf9197c4-808f-44b6-98dc-12491aa17bb5",
+          "ApiChange": "Property",
+          "ChangedApiName": "accessTier",
+          "ChangeType": "Addition",
+          "Description": "Added the **accessTier** property to the [cloudPcReviewStatus](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcreviewstatus?view=graph-rest-beta) resource.",
+          "Target": "cloudPcReviewStatus"
+        },
+        {
+          "Id": "bf9197c4-808f-44b6-98dc-12491aa17bb5",
+          "ApiChange": "Property",
+          "ChangedApiName": "accessTier",
+          "ChangeType": "Addition",
+          "Description": "Added the **accessTier** property to the [cloudPcBulkCreateSnapshot](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcBulkCreateSnapshot?view=graph-rest-beta) resource.",
+          "Target": "cloudPcBulkCreateSnapshot"
+        },
+        {
+          "Id": "bf9197c4-808f-44b6-98dc-12491aa17bb5",
+          "ApiChange": "Property",
+          "ChangedApiName": "storageAccountId",
+          "ChangeType": "Addition",
+          "Description": "Added the **storageAccountId** property to the [cloudPcBulkCreateSnapshot](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcBulkCreateSnapshot?view=graph-rest-beta) resource.",
+          "Target": "cloudPcBulkCreateSnapshot"
+        },
+        {
+          "Id": "bf9197c4-808f-44b6-98dc-12491aa17bb5",
+          "ApiChange": "Parameter",
+          "ChangedApiName": "createSnapshot",
+          "ChangeType": "Addition",
+          "Description": "Added the **storageAccountId** and **accessTier** parameters to the [createSnapshot](https://learn.microsoft.com/en-us/graph/api/cloudpc-createsnapshot?view=graph-rest-beta) method.",
+          "Target": "cloudPC"
+        }
+      ],
+      "Id": "bf9197c4-808f-44b6-98dc-12491aa17bb5",
+      "Cloud": "Prod",
+      "Version": "beta",
+      "CreatedDateTime": "2024-12-12T09:26:48.3805974Z",
+      "WorkloadArea": "Device and app management",
+      "SubArea": "Cloud PC"
+    },
     {
       "ChangeList": [
         {

Original file line number	Diff line number	Diff line change
`@@ -72,7 +72,8 @@ Content-Type: application/json`
`72`	`72`	`"reviewStatus": {`
`73`	`73`	`"inReview": true,`
`74`	`74`	`"userAccessLevel": "restricted",`
`75`		`- "azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview"`
	`75`	`+ "azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",`
	`76`	`+ "accessTier": "hot"`
`76`	`77`	`}`
`77`	`78`	`}`
`78`	`79`	```
Original file line number	Diff line number	Diff line change
`@@ -124,7 +124,8 @@ Content-Type: application/json`
`124`	`124`	`"subscriptionName": "deschutes-INT-DR-test",`
`125`	`125`	`"azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",`
`126`	`126`	`"azureStorageAccountName": "snapshotsUnderReview",`
`127`		`- "azureStorageContainerName": "snapshotsContainer"`
	`127`	`+ "azureStorageContainerName": "snapshotsContainer",`
	`128`	`+ "accessTier":"hot"`
`128`	`129`	`}`
`129`	`130`	```
`130`	`131`