CreateScreenshot API による Cloud Phone スクリーンショットの自動化 - Cloud Phone

操作説明

クラウドフォンのスクリーンショットを作成し、デフォルトの Object Storage Service (OSS) バケットにアップロードします。この操作は TaskId を返します。DescribeTasks 操作を呼び出して、スクリーンショットのダウンロードリンクをクエリできます。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
AndroidInstanceIdList	array	必須	インスタンス ID のリスト。バッチスクリーンショットをサポートします。
	string	必須	インスタンス ID。	acp-ig2bdpk374l12****
OssBucketName	string	任意	カスタム OSS バケット。バケット名は `cloudphone-saved-bucket-` プレフィックスで始まる必要があります。クラウドフォンインスタンスのリージョンは、OSS バケットのリージョンと同じである必要があります。このパラメーターを空のままにすると、`cloudphone-saved-bucket-{RegionOfCloudPhone}-{AliUid}` という名前のデフォルトバケットが作成されます。	cloudphone-saved-bucket-cn-shanghai-default
SkipCheckPolicyConfig	string	任意	スクリーンショットポリシーのチェックをスキップするかどうかを指定します。デフォルト値は false です。	false
ScreenshotId	string	任意	スクリーンショット ID。生成されたスクリーンショットの名前は `ScreenshotId_AndroidInstanceId.png` です。重要 `ScreenshotId` は、長さが 2～128 文字である必要があります。文字または漢字で始まる必要があります。`http://` または `https://` で始めることはできません。数字、アンダースコア (_)、ハイフン (-) を含めることができます。	image

レスポンスフィールド

フィールド	型	説明	例
	object	PlainResult
RequestId	string	リクエストの一意の ID。問題が発生した場合は、トラブルシューティングのためにこの ID を提供してください。	3AF82CE1-2801-52CE-BF64-B491DD7C****
Tasks	array<object>	タスクのリスト。
	object	タスク。
AndroidInstanceId	string	インスタンス ID。	acp-bwhtebzah2fse****
TaskId	string	タスク ID。この TaskId を使用して DescribeTasks 操作を呼び出し、インスタンスのスクリーンショットタスクをクエリします。タスクが完了すると、スクリーンショットのダウンロードリンクを取得できます。	t-imr0fufqd7cle****
ScreenshotId	string	スクリーンショット ID。生成されたスクリーンショットの名前は `ScreenshotId_AndroidInstanceId.png` です。	image

例

成功レスポンス

JSONJSON

{
  "RequestId": "3AF82CE1-2801-52CE-BF64-B491DD7C****",
  "Tasks": [
    {
      "AndroidInstanceId": "acp-bwhtebzah2fse****",
      "TaskId": "t-imr0fufqd7cle****",
      "ScreenshotId": "image"
    }
  ]
}

エラーコード

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

変更履歴

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