Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Defina o status de revisão de um dispositivo Cloud PC específico usando a ID do Cloud PC. Use essa API para definir o status de revisão de um PC na nuvem como em revisão se você considerar um PC na nuvem suspeito. Depois que a revisão for concluída, use essa API novamente para definir o PC na nuvem de volta a um estado normal.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global |
Governo dos EUA L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
✅ |
❌ |
❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
CloudPC.Read.All |
CloudPC.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
CloudPC.Read.All |
CloudPC.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/setReviewStatus
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON dos parâmetros.
A tabela a seguir mostra o parâmetro que você pode usar com essa ação.
| Parâmetro |
Tipo |
Descrição |
| reviewStatus |
cloudPcReviewStatus |
O novo status de revisão do PC na nuvem. |
Resposta
Se tiver êxito, esta ação retornará um código de resposta 204 No Content.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
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)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content