educationSynchronizationProfile: uploadUrleducationSynchronizationProfile: uploadUrl

命名空间:microsoft.graphNamespace: microsoft.graph

重要

/betaMicrosoft Graph 中的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported. 若要确定 API 在 v1.0 中是否可用,请使用 版本 选择器。To determine whether an API is available in v1.0, use the Version selector.

检索共享访问签名 (SAS) ,用于将源文件上载到租户中的特定学校数据 同步配置文件 的 Azure blob 存储。Retrieve a shared access signature (SAS) for uploading source files to Azure blob storage for a specific school data synchronization profile in the tenant. SAS 令牌的有效期为1小时。The SAS token has a validity of one hour.

仅为 CSV 数据提供程序提供上载 URL。The upload URL is provided only for the CSV data provider.

注意: 若要使用 SAS 令牌访问 blob 存储,请使用 Azure 存储 sdkAzCopyNote: To access the blob storage with the SAS token, use the Azure storage SDKs or AzCopy.

权限Permissions

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

权限类型Permission type 权限Permissions
委派(工作或学校帐户)Delegated (work or school account) EduAdministration.ReadWriteEduAdministration.ReadWrite
委派 (个人 Microsoft 帐户Delegated (personal Microsoft account 不支持。Not supported.
应用程序Application 不支持。Not supported.

HTTP 请求HTTP request

GET /synchronizationProfiles/{id}/uploadUrl

请求标头Request headers

名称Name 类型Type 说明Description
AuthorizationAuthorization stringstring Bearer {token}。必需。Bearer {token}. Required.

请求正文Request body

请勿提供此方法的请求正文。Do not supply a request body for this method.

响应Response

如果成功,此方法 200 OK 在响应正文中返回响应代码和 EDUCATIONSYNCHRONIZATIONPROFILE 的 SAS URL。If successful, this method returns a 200 OK response code and a SAS URL for the educationSynchronizationProfile in the response body.

如果仍在处理前一个请求,则此方法将返回一个 409 Conflict 指示当前已为 educationSynchronizationProfile阻止了上载。If a previous request is still being processed, this method returns a 409 Conflict indicating that the upload is presently blocked for the educationSynchronizationProfile.

示例Example

请求Request

下面展示了示例请求。The following is an example of the request.

GET https://graph.microsoft.com/beta/education/synchronizationProfiles/{id}/uploadUrl
响应Response

下面展示了示例响应。The following is an example of the response.

注意: 为了提高可读性,可能缩短了此处显示的响应对象。所有属性都将通过实际调用返回。Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 201 OK
Content-type: application/json
Content-length: 314

{
    "@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"
}