educationSynchronizationProfile: uploadUrl (preterido)
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.
Cuidado
A API do Perfil de Sincronização de Educação foi preterida e deixará de devolver dados a 31 de dezembro de 2024. Para obter informações sobre como migrar para a nova API de Dados do Setor, veja Transição do School Data Sync (Clássico).
Obtenha uma assinatura de acesso partilhado (SAS) para carregar ficheiros de origem para o armazenamento de blobs do Azure para um perfil de sincronização de dados escolares específico no inquilino. O token de SAS tem uma validade de uma hora.
O URL de carregamento é fornecido apenas para o fornecedor de dados CSV.
Nota: Para aceder ao armazenamento de blobs com o token de SAS, utilize os SDKs de armazenamento do Azure ou o AzCopy.
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) | EduAdministration.ReadWrite | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | EduAdministration.ReadWrite.All | Indisponível. |
Solicitação HTTP
GET /education/synchronizationProfiles/{id}/uploadUrl
Cabeçalhos de solicitação
Nome | Tipo | Descrição |
---|---|---|
Autorização | string | {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-sucedido, este método devolve um 200 OK
código de resposta e um URL de SAS para educationSynchronizationProfile no corpo da resposta.
Se um pedido anterior ainda estiver a ser processado, este método devolve um 409 Conflict
que indica que o carregamento está atualmente bloqueado para educationSynchronizationProfile.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/education/synchronizationProfiles/{id}/uploadUrl
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#String",
"value": "https://sdsstorage.blob.core.windows.net/86904b1e-c7d0-4ead-b13a-98f11fc400ee?sv=2015-07-08&sr=c&si=SharedAccessPolicy_20170704044441&sig=CH65vxxqXETCkQNH0Lfsu31cUo0s0XcEEo0OE2YiL6Q%3D&se=2017-07-04T08%3A43%3A01Z&sp=w"
}