すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:AddFile

    ドキュメントセンター

    Alibaba Cloud Model Studio:AddFile

    最終更新日:Jul 07, 2026

    Alibaba Cloud Model Studio の一時ストレージからファイルを Alibaba Cloud Model Studio データ接続 (旧アプリケーションデータ) にインポートします。

    操作説明

    • Resource Access Management (RAM) ユーザーは、この操作を呼び出す前に、Alibaba Cloud Model Studio の API 権限 (AliyunBailianDataFullAccess が必要で、これには sfm:AddFile 権限が含まれます) を取得し、ワークスペースに参加する必要があります。Alibaba Cloud アカウントは、権限付与なしでこの操作を直接呼び出せます。最新の Alibaba Cloud Model Studio SDK を使用してこの操作を呼び出してください。

    • この操作は冪等ではありません。

    速度制限: この操作は速度制限の対象となります。毎秒 10 回を超える呼び出しを行わないでください。速度制限を受けた場合は、後でリトライしてください。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    sfm:AddFile

    create

    *All Resource

    *

    		 なし なし

    リクエスト構文

    PUT /{WorkspaceId}/datacenter/file HTTP/1.1

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    WorkspaceId

    string

    必須

    ワークスペースの ID。ファイルはこのワークスペースにアップロードされます。ワークスペース ID の取得方法については、「ワークスペースの使用方法」をご参照ください。

    llm-3shx2gu255oqxxxx

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    LeaseId

    string

    必須

    アップロードリース ID。ApplyFileUploadLease 操作によって返される FileUploadLeaseId に対応します。

    68abd1dea7b6404d8f7d7b9f7fbd332d.17166xxxxxxxx
    Parser

    string

    必須

    パーサのタイプ。有効な値:

    • DOCMIND: インテリジェントドキュメント解析

    • DOCMIND_DIGITAL: 電子ドキュメント解析

    • DOCMIND_LLM_VERSION: large 言語モデルドキュメント解析

    • DASH_QWEN_VL_PARSER: Qwen VL 解析

    • DOCMIND_LLM_VERSION_MEDIA: オーディオおよびビデオ解析

    • AUTO_SELECT: 自動パーサ選択

    説明 アップロードされたファイルは、現在指定されているパーサを使用して解析されます。このパラメーターを AUTO_SELECT に設定した場合、カテゴリに設定されているパーサが使用されます。

    AUTO_SELECT
    CategoryId

    string

    必須

    このパラメーターをアップロードするファイルのカテゴリ ID (AddCategory 操作によって返される CategoryId) に設定します。また、アプリケーションデータ に移動し、[ファイル] タブをクリックしてから、カテゴリ名の横にある ID アイコンをクリックしてカテゴリ ID を取得することもできます。このパラメーターを default に設定すると、システムによって作成されたデフォルトカテゴリを使用できます。

    cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx
    Tags

    array

    任意

    • ファイルに関連付けられたタグのリスト。最大 100 個のタグを指定でき、すべてのタグの合計文字数は 700 を超えることはできません。

    • デフォルト値: 空 (タグが設定されていないことを意味します)。

    string

    任意

    ファイルのタグ。各タグには最大 32 文字を含めることができます。タグは Unicode 文字カテゴリの文字 (英字、漢字、数字を含む)、アンダースコア (_)、ハイフン (-) をサポートしています。

    产品介绍
    CategoryType

    string

    任意

    カテゴリのタイプ。このパラメーターは任意です。デフォルト値: UNSTRUCTURED。有効な値:

    • UNSTRUCTURED: ナレッジベース構築シナリオに使用されるカテゴリ。

    UNSTRUCTURED
    OriginalFileUrl

    string

    任意

    ファイルの URL を指定します。システムはドキュメント検索ナレッジベースを構築する際にこの URL を記録します。Alibaba Cloud Model Studio コンソールを使用してエージェントアプリケーションと対話する場合、この URL は docUrl フィールドを通じてファイルの取得結果とともに返されます。

    説明

    エージェントアプリケーションで ナレッジベース が有効になっており、回答ソースを表示 特徴がオンになっている必要があります。そうでない場合、このパラメーターは効果を持ちません。

    www.test.com/111.docx
    ParserConfig

    object

    任意

    パーサの構成。このパラメーターは、パーサタイプが Qwen VL 解析に設定されている場合にのみ必須です。

    ModelName

    string

    任意

    モデルの名前。

    qwen-vl-max
    ModelPrompt

    string

    任意

    Qwen VL 解析の呼び出し時に使用されるプロンプト。

    #角色 你是一个专业的图片内容标注人员，擅长识别并描述出图片中的内容。 # 任务目标 请结合输入图片，详细描述图片中的内容。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマ。

    Code

    string

    エラーコード。

    DataCenter.FileTooLarge
    Data

    object

    操作によって返されるデータフィールド。

    FileId

    string

    ファイルの ID。このファイルに関連する後続のすべての API 操作で使用されるため、この値を安全に保管してください。

    file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx
    Parser

    string

    ファイルの解析に使用されるパーサのタイプ。有効な値:

    • DASHSCOPE_DOCMIND: Alibaba Cloud インテリジェントドキュメント解析。

    DASHSCOPE_DOCMIND
    Message

    string

    エラーメッセージ。

    User not authorized to operate on the specified resource.
    RequestId

    string

    リクエストの ID。

    778C0B3B-xxxx-5FC1-A947-36EDD13606AB
    Status

    string

    操作によって返される状態コード。

    200
    Success

    string

    呼び出しが成功したかどうかを示します。有効な値:

    • true: 呼び出しが成功しました。

    • false: 呼び出しが失敗した。

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "DataCenter.FileTooLarge",
  "Data": {
    "FileId": "file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx",
    "Parser": "DASHSCOPE_DOCMIND"
  },
  "Message": "User not authorized to operate on the specified resource.",
  "RequestId": "778C0B3B-xxxx-5FC1-A947-36EDD13606AB",
  "Status": "200",
  "Success": "true"
}

    エラーコード

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

    変更履歴

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