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

:FetchFile

最終更新日:Apr 13, 2026

クラウドフォンから Object Storage Service (OSS) にファイルをフェッチします。

操作説明

この操作は、クラウドフォンから Object Storage Service にファイルまたはフォルダのみをフェッチします。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

AndroidInstanceIdList

array

必須

クラウドフォンのインスタンス ID のリスト。

string

任意

クラウドフォンのインスタンス ID。

acp-34pqe4r0kd9kn****

SourceFilePath

string

必須

クラウドフォンからフェッチするファイルまたはフォルダのパス。

/data/a.txt

UploadType

string

必須

フェッチしたファイルのストレージサービスのタイプ。

説明

現在、サポートされているのは `Object Storage Service (OSS)` のみです。

OSS

UploadEndpoint

string

必須

ファイルを `OSS` にアップロードするためのエンドポイント。

説明

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

oss-cn-hangzhou-internal.aliyuncs.com

UploadUrl

string

必須

`OSS` 内の送信先 URL。

説明

送信先バケット名のプレフィックスは `cloudphone-saved-bucket-` である必要があります。例:`cloudphone-saved-bucket-example`。送信先ディレクトリとして機能するフォルダをバケット内に作成する必要もあります。`UploadUrl` は `oss:///` のフォーマットに従う必要があります。

oss://cloudphone-saved-bucket-example/received

ClientToken

string

任意

リクエストのべき等性を保証する、クライアントで生成されたトークン。最大 100 文字です。

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

レスポンスフィールド

フィールド

説明

object

応答オブジェクト。

Data

array<object>

リクエストで指定された各インスタンスのエントリを含む結果の配列。

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

object

単一のクラウドフォンインスタンスの結果。

AndroidInstanceId

string

クラウドフォンのインスタンス ID。

acp-34pqe4r0kd9kn****

TaskId

string

この特定のインスタンスに対して作成されたタスクの ID。

t-bp67acfmxazb4p****

RequestId

string

リクエスト ID。トラブルシューティングのためにサポートに連絡する際に、この ID をご提供ください。

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

TaskId

string

バッチタスク ID。

t-ehs0yoedj0xe9****

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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