上傳檔案以進行分析
若要起啟分析工作,必須有可透過 URL 存取的 Azure Blob 路徑。 已提供使用上傳服務將檔案上載至指定地理區域中 Azure Blob 儲存體的功能。 不需要為了執行分析而使用上傳 API。 您可以使用 POST
要求上傳至下列位置:[Geographical URI]/api/upload?api-version=1.0
。 支援上傳上大小最多為 30 MB 的檔案。 對於更大型的檔案,您必須提供您自己的外部可存取 Azure 儲存體和 SAS URI。
注意
此 API 需要令牌 OAuth 。
標頭
姓名 | 類型 | 預期值 | 是必要的嗎? |
---|---|---|---|
授權 | string | OAuth ID 為 Application ID 聲明的 Microsoft Entra 1 個持有者令牌。 | yes |
x-ms-tenant-id | GUID | 應用程式的用戶識別碼。 | 是 |
x-ms-correlation-id | GUID | 分析執行的識別碼。 您應該為整段執行 (上傳、分析、狀態) 提供相同的識別碼。 | 是 |
內容-類型 | 物件 | multipart/form-data | 是 |
Content-Disposition | 物件 | 例如,包含 name 和 filename 參數:form-data; name="solution1.zip"; filename="solution1.zip" |
是 |
預期回應
HTTP 狀態碼 | 案例 | 結果 |
---|---|---|
200 | 上傳成功 | 沒有結果本文 |
400 | 已傳送非 zip 檔案、不正確的參數,或是已將檔案與病毒一起包含在其中 | 沒有結果本文 |
413 | 檔案太大 | 沒有結果本文 |
範例:上傳檔案
此範例示範如何上傳要進行分析的檔案。
請求
POST [Geographical URI]/api/upload
Accept: application/json
x-ms-correlation-id: aaaa0000-bb11-2222-33cc-444444dddddd
x-ms-tenant-id: aaaabbbb-0000-cccc-1111-dddd2222eeee
Content-Type: multipart/form-data
Content-Disposition: form-data; name=mySolution.zip; filename=mySolution.zip
回覆
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
["https://mystorage.blob.core.windows.net/solution-files/0a4cd700-d1d0-4ef8-8318-e4844cc1636c/mySolution.zip?sv=2017-11-09&sr=b&sig=xyz&se=2019-06-11T19%3A05%3A20Z&sp=rd"]