cloudPcReports: getActionStatusReports
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.
Obtenha a ação remota status relatórios, incluindo dados como a ID do PC na Nuvem, o nome de exibição do dispositivo cloud PC, o início do nome principal do usuário, o nome da entidade de usuário do proprietário do dispositivo, a ação tomada e o estado de ação.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | CloudPC.Read.All | CloudPC.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | CloudPC.Read.All | CloudPC.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/virtualEndpoint/reports/getActionStatusReports
Cabeçalhos de solicitação
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 os parâmetros que podem ser usados com esse método.
Parâmetro | Tipo | Descrição |
---|---|---|
filter | Cadeia de caracteres | Sintaxe OData $filter . Os filtros com suporte são: and , , or , gt ge e eq . |
Groupby | Coleção de cadeias de caracteres | Especifica como agrupar os relatórios. Se usado, deve ter o mesmo conteúdo que o parâmetro de seleção . |
Orderby | Coleção de cadeias de caracteres | Especifica o nome da ordem por colunas. A coluna orderBy padrão é RequestDateTime . |
search | Cadeia de caracteres | Especifica uma cadeia de caracteres a ser pesquisada. |
select | Coleção de cadeias de caracteres | Sintaxe OData $select . As colunas selecionadas dos relatórios. |
skip | Int32 | Número de registros a serem pulados. |
top | Int32 | O número de registros principais a serem retornados. Se não for especificado, o limite padrão será 25, com um máximo de 100. |
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e um objeto Stream no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getActionStatusReports
Content-Type: application/json
Content-length: 199
{
"filter": "ActionState eq 'failed'",
"select": [
"Id",
"CloudPcDeviceDisplayName",
"BulkActionId",
"BulkActionDisplayName",
"CloudPcId",
"InitiatedByUserPrincipalName",
"DeviceOwnerUserPrincipalName",
"Action",
"ActionState",
"RequestDateTime",
"LastUpdatedDateTime",
"ActionParameters"
],
"skip": 0,
"top": 50
}
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/octet-stream
{
"TotalRowCount": 1,
"Schema": [
{
"Column": "Id",
"PropertyType": "String"
},
{
"Column": "CloudPcDeviceDisplayName",
"PropertyType": "String"
},
{
"Column": "BulkActionId",
"PropertyType": "String"
},
{
"Column": "BulkActionDisplayName",
"PropertyType": "String"
},
{
"Column": "CloudPcId",
"PropertyType": "String"
},
{
"Column": "InitiatedByUserPrincipalName",
"PropertyType": "String"
},
{
"Column": "DeviceOwnerUserPrincipalName",
"PropertyType": "String"
},
{
"Column": "Action",
"PropertyType": "String"
},
{
"Column": "ActionState",
"PropertyType": "String"
},
{
"Column": "RequestDateTime",
"PropertyType": "DateTime"
},
{
"Column": "LastUpdatedDateTime",
"PropertyType": "DateTime"
},
{
"Column": "ActionParameters",
"PropertyType": "Json"
}
],
"Values": [
[
"662009bc-7732-4f6f-8726-25883518b33e",
"CloudPC-Connie",
"bdc8e6dd-0455-4412-83d9-c818664fe1f1",
"Resize to 64GB RAM - John",
"bdc8e6dd-0455-4412-83d9-c818664fe1f1",
"john@contoso.com",
"connie@contoso.com",
"Resize",
"failed",
"2020-07-23T10:10:57Z",
"2023-07-23T18:14:34Z",
{
"targetServicePlanId": "3bba9856-7cf2-4396-904a-00de74fba3a4"
}
]
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de