UploadSemanticFile - DataWorks - Alibaba Cloud ドキュメントセンター

一時的な OSS PUT アップロード URL をリクエストします。URL の有効期限が切れる前に PUT アップロードを完了し、返された FileId を CreateSemanticJob の ReferenceFileIds パラメーターに渡してください。

操作説明

シナリオ

CreateSemanticJob の singleTableFile ソース用のファイルを準備するために、リファレンスファイルのアップロードスロットをリクエストします。

プロシージャ

ファイル名、MIME タイプ、および実際のサイズをこの操作に渡し、Data.UploadUrl と Data.FileId を取得します。
UploadUrl の有効期限が切れる前に、同じ Content-Type で HTTP PUT アップロードを実行します。
アップロード完了後、FileId を CreateSemanticJob.ReferenceFileIds の唯一の要素として使用します。

セキュリティに関する考慮事項

UploadUrl は短命の署名付き PUT URL です。保持者は対応するオブジェクトに書き込むことができます。この URL をログに記録したり、共有したり、永続化したりしないでください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
FileName	string	必須	アップロードするリファレンスファイルの元のファイル名。最大長: 255 文字。singleTableFile で FileId を使用する場合、CSV または XLSX ファイルのみがサポートされます。	リファレンス.pdf
ContentType	string	必須	アップロードするオブジェクトの MIME タイプ。最大長: 128 文字。この値は UploadUrl の署名に含まれます。PUT リクエストを実行する際は、同じ Content-Type を使用してください。	application/pdf
SizeBytes	integer	必須	アップロードするファイルのサイズ (バイト単位)。この値は添付ファイルのメタデータとして記録されます。実際のファイルサイズを指定してください。	1024

各リクエストフィールドの説明に基づいてリクエストパラメーターを構築してください。

レスポンスフィールド

フィールド	型	説明	例
	object	添付ファイルのアップロードスロットをリクエストするための標準的な応答です。PUT アップロード完了後、Data.FileId を CreateSemanticJob.ReferenceFileIds 内の唯一のファイルリファレンスとして使用できます。
RequestId	string	リクエスト ID。ログの特定や問題のトラブルシューティングに使用されます。	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	リクエストが成功したかどうかを示します。
Data	object	添付ファイルのアップロードスロット情報。Data.ExpiresAt より前に Data.UploadUrl にファイルを PUT し、その後 Data.FileId を使用して単一ファイルのセマンティックタスクを作成します。
FileId	string	添付ファイルの一意識別子。UploadUrl への PUT アップロードを完了した後、この値を CreateSemanticJob の ReferenceFileIds パラメーターに渡します。	FID1
UploadUrl	string	一時的な OSS PUT アップロード URL。有効期間は 30 分です。指定されたオブジェクトのみアップロード可能です。PUT リクエストを実行する際は、リクエスト時の ContentType を使用してください。完全な URL をログに記録したり配布したりしないでください。	https://example.com/temporary-upload-url
ExpiresAt	integer	UploadUrl の有効期限時間 (ミリ秒単位の UNIX タイムスタンプ)。この時間以降は、UploadSemanticFile を再度呼び出して新しい URL をリクエストしてください。	1700001800000

応答フィールドの意味および後続の呼び出しとの関係については、各フィールドの説明を参照してください。

例

成功レスポンス

JSONJSON

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "FileId": "FID1",
    "UploadUrl": "https://example.com/temporary-upload-url",
    "ExpiresAt": 1700001800000
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。