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.
Permite que os revisores definam applyResult e applyDescription em todos os objetos accessReviewInstanceDecisionItem em um accessReviewInstance específico em lotes usando customDataProvidedResourceId.
OBSERVAÇÃO: A instância de revisão de acesso deve estar em um Applying estado.
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ão com privilégios mínimos |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
AccessReview.ReadWrite.All |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
AccessReview.ReadWrite.All |
Indisponível. |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. Esta operação dá suporte às seguintes funções internas, que fornecem apenas o menor privilégio necessário:
- Para gravar revisões de acesso de um grupo ou aplicativo: Administrador de Usuários, Administrador de Governança de Identidade
- Para gravar revisões de acesso de uma função do Microsoft Entra: Administrador de Governança de Identidade, Administrador de Função Privilegiada
Solicitação HTTP
POST /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
| x-accessreviews-version |
vNext. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON dos parâmetros.
A tabela a seguir lista os parâmetros quando você chama essa ação.
| Parâmetro |
Tipo |
Descrição |
| aplicar resultado |
accessReviewInstanceDecisionItemApplyResult |
O applyResult para a entidade que está sendo examinada. Os valores possíveis são: new, appliedSuccessfully, appliedWithUnknownFailure, appliedSuccessfullyButObjectNotFound, applyNotSupported. Obrigatório. |
| applyDescription |
Cadeia de caracteres |
Se fornecido, uma descrição para o applyResultdomínio . Opcional. |
| customDataProvidedResourceId |
Cadeia de caracteres |
O applyResult será definido em todos accessReviewInstanceDecisionItems cujo recurso id fornecido por dados personalizados corresponde ao customDataProvidedResourceId fornecido. Obrigatório. |
Resposta
Se tiver êxito, esta ação retornará um código de resposta 202 Accepted.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions
Content-Type: application/json
{
"applyResult": "appliedSuccessfully",
"applyDescription": "Access was removed from production application: GitHub-app.",
"customDataProvidedResourceId": "5c728447-be5c-4565-b4d3-cb248b609891"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.IdentityGovernance.AccessReviews.Definitions.Item.Instances.Item.BatchApplyCustomDataProvidedResourceDecisions;
using Microsoft.Graph.Beta.Models;
var requestBody = new BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody
{
ApplyResult = AccessReviewInstanceDecisionItemApplyResult.AppliedSuccessfully,
ApplyDescription = "Access was removed from production application: GitHub-app.",
CustomDataProvidedResourceId = "5c728447-be5c-4565-b4d3-cb248b609891",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.IdentityGovernance.AccessReviews.Definitions["{accessReviewScheduleDefinition-id}"].Instances["{accessReviewInstance-id}"].BatchApplyCustomDataProvidedResourceDecisions.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"
graphidentitygovernance "github.com/microsoftgraph/msgraph-beta-sdk-go/identitygovernance"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphidentitygovernance.NewBatchApplyCustomDataProvidedResourceDecisionsPostRequestBody()
applyResult := graphmodels.APPLIEDSUCCESSFULLY_ACCESSREVIEWINSTANCEDECISIONITEMAPPLYRESULT
requestBody.SetApplyResult(&applyResult)
applyDescription := "Access was removed from production application: GitHub-app."
requestBody.SetApplyDescription(&applyDescription)
customDataProvidedResourceId := "5c728447-be5c-4565-b4d3-cb248b609891"
requestBody.SetCustomDataProvidedResourceId(&customDataProvidedResourceId)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.IdentityGovernance().AccessReviews().Definitions().ByAccessReviewScheduleDefinitionId("accessReviewScheduleDefinition-id").Instances().ByAccessReviewInstanceId("accessReviewInstance-id").BatchApplyCustomDataProvidedResourceDecisions().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.identitygovernance.accessreviews.definitions.item.instances.item.batchapplycustomdataprovidedresourcedecisions.BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody batchApplyCustomDataProvidedResourceDecisionsPostRequestBody = new com.microsoft.graph.beta.identitygovernance.accessreviews.definitions.item.instances.item.batchapplycustomdataprovidedresourcedecisions.BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody();
batchApplyCustomDataProvidedResourceDecisionsPostRequestBody.setApplyResult(AccessReviewInstanceDecisionItemApplyResult.AppliedSuccessfully);
batchApplyCustomDataProvidedResourceDecisionsPostRequestBody.setApplyDescription("Access was removed from production application: GitHub-app.");
batchApplyCustomDataProvidedResourceDecisionsPostRequestBody.setCustomDataProvidedResourceId("5c728447-be5c-4565-b4d3-cb248b609891");
graphClient.identityGovernance().accessReviews().definitions().byAccessReviewScheduleDefinitionId("{accessReviewScheduleDefinition-id}").instances().byAccessReviewInstanceId("{accessReviewInstance-id}").batchApplyCustomDataProvidedResourceDecisions().post(batchApplyCustomDataProvidedResourceDecisionsPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const batchApplyCustomDataProvidedResourceDecisions = {
applyResult: 'appliedSuccessfully',
applyDescription: 'Access was removed from production application: GitHub-app.',
customDataProvidedResourceId: '5c728447-be5c-4565-b4d3-cb248b609891'
};
await client.api('/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions')
.version('beta')
.post(batchApplyCustomDataProvidedResourceDecisions);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\IdentityGovernance\AccessReviews\Definitions\Item\Instances\Item\BatchApplyCustomDataProvidedResourceDecisions\BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\AccessReviewInstanceDecisionItemApplyResult;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody();
$requestBody->setApplyResult(new AccessReviewInstanceDecisionItemApplyResult('appliedSuccessfully'));
$requestBody->setApplyDescription('Access was removed from production application: GitHub-app.');
$requestBody->setCustomDataProvidedResourceId('5c728447-be5c-4565-b4d3-cb248b609891');
$graphServiceClient->identityGovernance()->accessReviews()->definitions()->byAccessReviewScheduleDefinitionId('accessReviewScheduleDefinition-id')->instances()->byAccessReviewInstanceId('accessReviewInstance-id')->batchApplyCustomDataProvidedResourceDecisions()->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.identitygovernance.accessreviews.definitions.item.instances.item.batch_apply_custom_data_provided_resource_decisions.batch_apply_custom_data_provided_resource_decisions_post_request_body import BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody
from msgraph_beta.generated.models.access_review_instance_decision_item_apply_result import AccessReviewInstanceDecisionItemApplyResult
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = BatchApplyCustomDataProvidedResourceDecisionsPostRequestBody(
apply_result = AccessReviewInstanceDecisionItemApplyResult.AppliedSuccessfully,
apply_description = "Access was removed from production application: GitHub-app.",
custom_data_provided_resource_id = "5c728447-be5c-4565-b4d3-cb248b609891",
)
await graph_client.identity_governance.access_reviews.definitions.by_access_review_schedule_definition_id('accessReviewScheduleDefinition-id').instances.by_access_review_instance_id('accessReviewInstance-id').batch_apply_custom_data_provided_resource_decisions.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 202 Accepted