cloudAppDiscoveryReport: aggregatedAppsDetails

Espaço de nomes: microsoft.graph.security

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.

Obtenha os detalhes agregados das aplicações detetadas ao fornecer o período de tempo. Os períodos de tempo suportados são os últimos 7, 30 ou 90 dias.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão	Permissões com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	CloudApp-Discovery.Read.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	CloudApp-Discovery.Read.All	Indisponível.

Solicitação HTTP

GET /security/dataDiscovery/cloudAppDiscovery/uploadedStreams/{streamId}/microsoft.graph.security.aggregatedAppsDetails(period=duration'{duration}')

Parâmetros de função

A tabela seguinte lista os parâmetros que são necessários quando chama esta função.

Parâmetro	Tipo	Descrição
ponto	Duração	Indique o período de tempo no qual pretende consultar os dados. Os intervalos de tempo suportados são os últimos 7, 30 ou 90 dias.

Parâmetros de consulta opcionais

Este método suporta os $selectparâmetros de consulta , $filter, $skipe $top OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedida, esta função devolve um 200 OK código de resposta e uma coleção de objetos microsoft.graph.security.discoveredCloudAppDetail no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

HTTP

GET https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/93b60b3e-3a28-bf33-2d73-3cb0199c5f7a/microsoft.graph.security.aggregatedAppsDetails(period=duration'P90D')

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.DataDiscovery.CloudAppDiscovery.UploadedStreams["{cloudAppDiscoveryReport-id}"].MicrosoftGraphSecurityAggregatedAppsDetailsWithPeriod(TimeSpan.Parse("{period}")).GetAsAggregatedAppsDetailsWithPeriodGetResponseAsync();

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

CLI

mgc-beta security data-discovery cloud-app-discovery uploaded-streams microsoft-graph-security-aggregated-apps-details-with-period get --period {period-id} --cloud-app-discovery-report-id {cloudAppDiscoveryReport-id}

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Ir

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
period , err := abstractions.ParseISODuration("{period}")
microsoftGraphSecurityAggregatedAppsDetails, err := graphClient.Security().DataDiscovery().CloudAppDiscovery().UploadedStreams().ByCloudAppDiscoveryReportId("cloudAppDiscoveryReport-id").MicrosoftGraphSecurityAggregatedAppsDetailsWithPeriod(&period).GetAsAggregatedAppsDetailsWithPeriodGetResponse(context.Background(), nil)

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

var result = graphClient.security().dataDiscovery().cloudAppDiscovery().uploadedStreams().byCloudAppDiscoveryReportId("{cloudAppDiscoveryReport-id}").microsoftGraphSecurityAggregatedAppsDetailsWithPeriod(PeriodAndDuration.ofDuration(Duration.parse("{period}"))).get();

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let aggregatedAppsDetails = await client.api('/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/93b60b3e-3a28-bf33-2d73-3cb0199c5f7a/microsoft.graph.security.aggregatedAppsDetails(period=duration'P90D')')
	.version('beta')
	.get();

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->security()->dataDiscovery()->cloudAppDiscovery()->uploadedStreams()->byCloudAppDiscoveryReportId('cloudAppDiscoveryReport-id')->microsoftGraphSecurityAggregatedAppsDetailsWithPeriod(new \DateInterval('{period}'))->get()->wait();

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.security.data_discovery.cloud_app_discovery.uploaded_streams.by_cloud_app_discovery_report_id('cloudAppDiscoveryReport-id').microsoft_graph_security_aggregated_apps_details_with_period("{period}").get()

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.discoveredCloudAppDetail",
      "id": "12345",
      "displayName": "Example App",
      "tags": [
        "Sanctioned"
      ],
      "riskScore": 8,
      "uploadNetworkTrafficInBytes": 1024,
      "downloadNetworkTrafficInBytes": 2048,
      "transactionCount": 20,
      "ipAddressCount": 5,
      "userCount": 3,
      "lastSeenDateTime": "2024-06-13T00:00:00Z",
      "domains": [
        "example.com"
      ],
      "category": "health"
    }
  ]
}