industryDataRun: start
Espaço de nomes: microsoft.graph.industryData
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.
Iniciar um novo industryDataRun. Os dados do setor automatizam uma execução a cada 12 horas; No entanto, os utilizadores podem utilizar a ação de início para executar uma execução a pedido. O serviço de dados do setor limita o início das execuções, permitindo até cinco execuções com êxito a cada 12 horas. Uma execução a pedido faz com que a próxima execução agendada pelo sistema seja ignorada se estiver definida para ser executada nas próximas 10 horas.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
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) | IndustryData-Run.Start | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | IndustryData-Run.Start | Indisponível. |
Solicitação HTTP
POST /external/industryData/runs/start
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 tiver êxito, este método retornará um código de resposta 202 Accepted
. A resposta também contém um Location
cabeçalho, que contém a localização de [longRunningOperation(.). /resources/longrunningoperation.md). Para marcar a status desta operação de execução prolongada, faça um pedido GET para o URL de localização.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/external/industryData/runs/start
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/external/industryData/operations/171bf0b4-14e9-408f-71dd-08dcd2a15d23