Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Legen Sie den Überprüfungsstatus eines bestimmten Cloud-PC-Geräts mithilfe der Cloud-PC-ID fest. Verwenden Sie diese API, um die Überprüfungs-status eines Cloud-PCs auf "In Überprüfung" festzulegen, wenn Sie einen Cloud-PC für verdächtig halten. Verwenden Sie nach Abschluss der Überprüfung diese API erneut, um den Cloud-PC wieder in einen normalen Zustand zu versetzen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
✅ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
CloudPC.Read.All |
CloudPC.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
CloudPC.Read.All |
CloudPC.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/setReviewStatus
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.
Die folgende Tabelle zeigt den Parameter, den Sie bei dieser Aktion verwenden können.
| Parameter |
Typ |
Beschreibung |
| reviewStatus |
cloudPcReviewStatus |
Der neue Überprüfungs-Status des Cloud-PCs. |
Antwort
Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/setReviewStatus
Content-Type: application/json
{
"reviewStatus": {
"inReview": true,
"userAccessLevel": "restricted",
"azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",
"accessTier": "hot"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.DeviceManagement.VirtualEndpoint.CloudPCs.Item.SetReviewStatus;
using Microsoft.Graph.Beta.Models;
var requestBody = new SetReviewStatusPostRequestBody
{
ReviewStatus = new CloudPcReviewStatus
{
InReview = true,
UserAccessLevel = CloudPcUserAccessLevel.Restricted,
AzureStorageAccountId = "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",
AccessTier = CloudPcBlobAccessTier.Hot,
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.DeviceManagement.VirtualEndpoint.CloudPCs["{cloudPC-id}"].SetReviewStatus.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphdevicemanagement "github.com/microsoftgraph/msgraph-beta-sdk-go/devicemanagement"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphdevicemanagement.NewSetReviewStatusPostRequestBody()
reviewStatus := graphmodels.NewCloudPcReviewStatus()
inReview := true
reviewStatus.SetInReview(&inReview)
userAccessLevel := graphmodels.RESTRICTED_CLOUDPCUSERACCESSLEVEL
reviewStatus.SetUserAccessLevel(&userAccessLevel)
azureStorageAccountId := "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview"
reviewStatus.SetAzureStorageAccountId(&azureStorageAccountId)
accessTier := graphmodels.HOT_CLOUDPCBLOBACCESSTIER
reviewStatus.SetAccessTier(&accessTier)
requestBody.SetReviewStatus(reviewStatus)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.DeviceManagement().VirtualEndpoint().CloudPCs().ByCloudPCId("cloudPC-id").SetReviewStatus().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.devicemanagement.virtualendpoint.cloudpcs.item.setreviewstatus.SetReviewStatusPostRequestBody setReviewStatusPostRequestBody = new com.microsoft.graph.beta.devicemanagement.virtualendpoint.cloudpcs.item.setreviewstatus.SetReviewStatusPostRequestBody();
CloudPcReviewStatus reviewStatus = new CloudPcReviewStatus();
reviewStatus.setInReview(true);
reviewStatus.setUserAccessLevel(CloudPcUserAccessLevel.Restricted);
reviewStatus.setAzureStorageAccountId("/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview");
reviewStatus.setAccessTier(CloudPcBlobAccessTier.Hot);
setReviewStatusPostRequestBody.setReviewStatus(reviewStatus);
graphClient.deviceManagement().virtualEndpoint().cloudPCs().byCloudPCId("{cloudPC-id}").setReviewStatus().post(setReviewStatusPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const setReviewStatus = {
reviewStatus: {
inReview: true,
userAccessLevel: 'restricted',
azureStorageAccountId: '/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview',
accessTier: 'hot'
}
};
await client.api('/deviceManagement/virtualEndpoint/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/setReviewStatus')
.version('beta')
.post(setReviewStatus);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\DeviceManagement\VirtualEndpoint\CloudPCs\Item\SetReviewStatus\SetReviewStatusPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\CloudPcReviewStatus;
use Microsoft\Graph\Beta\Generated\Models\CloudPcUserAccessLevel;
use Microsoft\Graph\Beta\Generated\Models\CloudPcBlobAccessTier;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new SetReviewStatusPostRequestBody();
$reviewStatus = new CloudPcReviewStatus();
$reviewStatus->setInReview(true);
$reviewStatus->setUserAccessLevel(new CloudPcUserAccessLevel('restricted'));
$reviewStatus->setAzureStorageAccountId('/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview');
$reviewStatus->setAccessTier(new CloudPcBlobAccessTier('hot'));
$requestBody->setReviewStatus($reviewStatus);
$graphServiceClient->deviceManagement()->virtualEndpoint()->cloudPCs()->byCloudPCId('cloudPC-id')->setReviewStatus()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.devicemanagement.virtualendpoint.cloudpcs.item.set_review_status.set_review_status_post_request_body import SetReviewStatusPostRequestBody
from msgraph_beta.generated.models.cloud_pc_review_status import CloudPcReviewStatus
from msgraph_beta.generated.models.cloud_pc_user_access_level import CloudPcUserAccessLevel
from msgraph_beta.generated.models.cloud_pc_blob_access_tier import CloudPcBlobAccessTier
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = SetReviewStatusPostRequestBody(
review_status = CloudPcReviewStatus(
in_review = True,
user_access_level = CloudPcUserAccessLevel.Restricted,
azure_storage_account_id = "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",
access_tier = CloudPcBlobAccessTier.Hot,
),
)
await graph_client.device_management.virtual_endpoint.cloud_p_cs.by_cloud_p_c_id('cloudPC-id').set_review_status.post(request_body)
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content