すべてのプロダクト
Search
ドキュメントセンター

:SendFile

最終更新日:Sep 30, 2025

Object Storage Service (OSS) またはパブリックダウンロードリンクからクラウドフォンにファイルを送信します。

操作説明

現在、OSS からクラウドフォンに送信できるのは、ファイルまたはフォルダのみです。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

AndroidInstanceIdList

array

必須

インスタンスのリスト。

string

任意

インスタンス ID。

acp-34pqe4r0kd9kn****

SourceFilePath

string

必須

クラウドフォン内のアップロードパス。

説明

UploadType が OSS または OSS_BRIDGED に設定されている場合、SourceFilePath は /sdcard/Download などのクラウドフォン内のフォルダパスである必要があります。 UploadType が DOWNLOAD_URL に設定されている場合、SourceFilePath は /sdcard/Download/MyFile.txt などのクラウドフォン内のファイルパスである必要があります。

/sdcard/Download

UploadType

string

必須

ソースファイルのストレージタイプ。

  • OSS ファイルは OSS リソースです。

  • DOWNLOAD_URL ファイルはパブリックダウンロードリンクからのものです。

  • OSS_BRIDGED ファイルは、パブリックダウンロードリンクから OSS に同期された後、OSS 内部ネットワークを介してクラウドフォンインスタンスに分散されます。

列挙値:

  • OSS_BRIDGED :
    パブリックダウンロードリンクを OSS に同期した後に配布
  • DOWNLOAD_URL :

    ファイルのパブリックダウンロードリンク。

  • OSS :

    OSS ファイルリソース。

OSS

UploadEndpoint

string

任意

ファイルを OSS にアップロードするためのサービスエンドポイント。 このパラメーターは、UploadType が OSS または OSS_BRIDGED に設定されている場合に必要です。

説明

クラウドフォンと OSS バケットが同じリージョンにある場合は、内部の同一リージョンエンドポイントを使用してデータ転送を高速化し、インターネットトラフィック料金を回避できます。 たとえば、中国 (杭州) リージョンの内部エンドポイントは oss-cn-hangzhou-internal.aliyuncs.com です。 詳細については、「OSS のリージョンとエンドポイント」をご参照ください。

oss-cn-hangzhou-internal.aliyuncs.com

UploadUrl

string

必須

  • UploadType が OSS に設定されている場合、UploadUrl は OSS 内のファイルのクラウドアドレスです。

説明

OSS バケットの名前は、プレフィックス「cloudphone-saved-bucket-」で始まる必要があります (例: 「cloudphone-saved-bucket-example」)。 バックアップフォルダとして使用する OSS フォルダも作成する必要があります。 UploadUrl のフォーマットは、「oss://」 + 「バケット名」 + 「/」 + 「フォルダ名」 + 「/」 + 「ファイル名」です。

  • UploadType が DOWNLOAD_URL または OSS_BRIDGED に設定されている場合、UploadUrl はファイルのパブリックダウンロードリンクです。

oss://cloudphone-saved-bucket-example/send/a.txt

TargetFileName

string

任意

ファイルが OSS からクラウドフォンにアップロードされた後のファイル名。

説明

このパラメーターは、UploadType が OSS または OSS_BRIDGED に設定されている場合はオプションです。 このパラメーターを空のままにすると、ファイルはクラウドフォンにアップロードされた後も元の名前を保持します。 このパラメーターに値を指定すると、ファイルは SourceFilePath で指定されたパスにアップロードされた後、指定された値に名前が変更されます。 このパラメーターは、UploadType が DOWNLOAD_URL に設定されている場合は効果がありません。

test.txt

AutoInstall

boolean

任意

アップロードされたアプリケーションを自動的にインストールするかどうかを指定します。

true

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

Data

array<object>

返されたデータ。

425F351C-3F8E-5218-A520-B6311D0D****

object

結果オブジェクト。

AndroidInstanceId

string

インスタンス ID。

acp-34pqe4r0kd9kn****

TaskId

string

タスク ID。

t-4ks224ujixw****

RequestId

string

リクエストの一意の ID。 エラーが発生した場合は、この ID をトラブルシューティングのために提供してください。

425F351C-3F8E-5218-A520-B6311D0D****

TaskId

string

バッチタスクの ID。

t-ehs0yoedj0xe9****

成功レスポンス

JSONJSON

{
  "Data": [
    {
      "AndroidInstanceId": "acp-34pqe4r0kd9kn****",
      "TaskId": "t-4ks224ujixw****"
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "TaskId": "t-ehs0yoedj0xe9****"
}

エラーコード

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

変更履歴

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