cloudpcprovisioningpolicy: schedulePolicyApplyTask

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 uma tarefa de reprovisionamento automático agendada para fazer aplicação regular automática. Frontline shared somente. Somente administradores.

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.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application CloudPC.ReadWrite.All Indisponível.

Solicitação HTTP

POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/schedulePolicyApplyTask

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 do objeto cloudpcpolicyscheduledapplyactiondetail .

A tabela a seguir mostra as propriedades que podem ser fornecidas ao agendar uma tarefa de aplicação de política.

Parâmetro Tipo Descrição
reservePercentage Int32 Por Frontline shared apenas. A porcentagem de PCs na nuvem a serem mantidos disponíveis. Os administradores podem definir essa propriedade com um valor de 0 a 99. Os PCs na nuvem são reprovisionados somente quando não há usuários ativos e conectados.
cronScheduleExpression Cadeia de caracteres Os administradores podem definir uma expressão cron para definir as regras de agendamento para aplicação regular automática. Quando a provisão automática está desabilitada, é definida como nula, interrompendo o agendamento automático de tarefas (por exemplo, cronScheduleExpression "0 0 0 20 * *" significa agendar um trabalho para ser executado à meia-noite do dia 20 de cada mês). Somente leitura.
startDateTime String Indica que os administradores de TI podem definir uma data de início para definir a primeira execução do agendador após esse horário. Se não estiver definida, o padrão será a hora atual. Não há informações de fuso horário no momento, elas precisam ser coordenadas comtimezone, por exemplo, "2025-01-01 00:00:00" com "China Standard Time" significa que a regra de agendamento entrará em vigor após 01 de janeiro de 2025 00:00:00 GMT+0800 (Horário Padrão da China).
endDateTime String Indica que os administradores de TI podem definir uma data de término para definir a última execução do agendador antes desse horário. Se não estiver definido, o agendador será executado continuamente. Não há informações de fuso horário no momento, elas precisam ser coordenadas comtimezone, por exemplo, "2025-02-01 00:00:00" com "China Standard Time" significa que a regra de agendamento entrará em vigor antes de 01 de fevereiro de 2025 00:00:00 GMT+0800 (Horário Padrão da China).
timezone cloudPcPolicyTimezone Indica que os administradores de TI podem definir um fuso horário para definir o fuso horário de nextRunDateTime, startDateTime, endDateTime, o padrão é gmt. Os valores possíveis são gmt, bit, nut, hstlinttotfjtpgtsbtacstcstjstthaistbstpkteatgetcatcetazotgstartmitnstastpstakstmsteastest,unknownFutureValue

Resposta

Se tiver êxito, este método 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/deviceManagement/virtualEndpoint/provisioningPolicies/b0c2d35f-3385-46c8-a6f5-6c3dfad7708b/schedulePolicyApplyTask

{
  "reservePercentage": 50,
  "cronScheduleExpression": "0 0 0 20 * *",
  "startDateTime": "2025-03-12 00:00:00",
  "endDateTime": null,
  "timezone": "cst"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content