La API SendFile permite cargar archivos desde Object Storage Service (OSS) a una carpeta específica en las instancias de Cloud Phone. También permite usar un enlace público de descarga para distribuir e instalar automáticamente paquetes de aplicaciones. Este tema describe cuatro escenarios típicos para la distribución de archivos y aplicaciones.
Requisitos previos
-
Requisitos previos generales para todos los escenarios:
Todas las instancias de Cloud Phone de destino se encuentran en la misma región.
El estado de todas las instancias de Cloud Phone de destino es Active.
-
Requisitos previos específicos para el escenario 4 (descarga por Internet y distribución interna):
La primera instancia de Cloud Phone cuenta con permisos de acceso a Internet.
La primera instancia de Cloud Phone dispone de espacio de almacenamiento suficiente para el archivo o la aplicación.
-
Activó OSS. En este escenario, solo la primera instancia de Cloud Phone descarga el archivo o la aplicación desde Internet. Después, lo carga en un bucket de OSS de su propiedad ubicado en la misma región.
ImportanteEl almacenamiento de OSS genera costos adicionales. Para obtener más información, consulte Billing overview.
Escenario 1: Cargar un archivo común
Escenario
Necesita cargar el archivo snapshot.png desde un bucket de OSS en la región China (Hangzhou) hacia la carpeta /sdcard/Pictures de las instancias de Cloud Phone acp-c8rzmx8fnwba6**** y acp-5fc8mx8fnw9s5**** ubicadas en la misma región.
SendFile Ejemplo de llamada a la API
-
Mensaje de solicitud
{ "AndroidInstanceIdList": [ "acp-c8rzmx8fnwba6****", "acp-5fc8mx8fnw9s5****" ], "SourceFilePath": "/sdcard/Pictures", "UploadType": "OSS", "UploadUrl": "oss://cloudphone-saved-bucket-cn-hangzhou-****/picture/snapshot.png", "UploadEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com" } -
Mensaje de respuesta
{ "TaskId": "t-gk0ahswe4blor****", "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****", "Data": [ { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-c8rzmx8fnwba6****" }, { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-5fc8mx8fnw9s5****" } ] }
Escenario 2: Cargar e instalar automáticamente un paquete de aplicación
Escenario
Cuenta con un paquete de aplicación llamado SogouInput_12.15.0_android_sweb.apk almacenado en un bucket de OSS en la región China (Hangzhou). Necesita completar las siguientes tareas:
Cargue el paquete en la carpeta
/sdcard/Downloadde las instancias de Cloud Phoneacp-c8rzmx8fnwba6****yacp-5fc8mx8fnw9s5****ubicadas en la región China (Hangzhou).Cambie el nombre del archivo a
sougou.apk.Instale automáticamente la aplicación cuando finalice la carga.
SendFile Ejemplo de llamada a la API
-
Mensaje de solicitud
{ "AndroidInstanceIdList": [ "acp-c8rzmx8fnwba6****", "acp-5fc8mx8fnw9s5****" ], "SourceFilePath": "/sdcard/Download", "UploadType": "OSS", "UploadUrl": "oss://cloudphone-saved-bucket-cn-hangzhou-****/app/SogouInput_12.15.0_android_sweb.apk", "UploadEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com", "TargetFileName": "sougou.apk", "AutoInstall": "true" } -
Mensaje de respuesta
{ "TaskId": "t-gk0ahswe4blor****", "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****", "Data": [ { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-c8rzmx8fnwba6****" }, { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-5fc8mx8fnw9s5****" } ] }
Escenario 3: Descargar e instalar automáticamente un paquete de aplicación desde Internet (modo de descarga individual)
Escenario
Dispone de un enlace de descarga para un paquete de aplicación: https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk. Necesita completar las siguientes tareas:
Las instancias de Cloud Phone
acp-c8rzmx8fnwba6****yacp-5fc8mx8fnw9s5****de la región China (Hangzhou) descargan individualmente el paquete desde Internet. Luego, lo guardan en la carpeta/sdcard/Downloady le cambian el nombre asougou.apk.Instale automáticamente la aplicación cuando finalice la descarga.
SendFile Ejemplo de llamada a la API
-
Mensaje de solicitud
{ "AndroidInstanceIdList": [ "acp-c8rzmx8fnwba6****", "acp-5fc8mx8fnw9s5****" ], "SourceFilePath": "/sdcard/Download/sougou.apk", "UploadType": "DOWNLOAD_URL", "UploadUrl": "https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk", "AutoInstall": "true" } -
Mensaje de respuesta
{ "TaskId": "t-gk0ahswe4blor****", "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****", "Data": [ { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-c8rzmx8fnwba6****" }, { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-5fc8mx8fnw9s5****" } ] }
Escenario 4: Descargar e instalar automáticamente un paquete de aplicación desde Internet (modo de descarga por Internet y distribución interna)
Escenario
Dispone de un enlace de descarga para un paquete de aplicación: https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk. Necesita completar las siguientes tareas:
La instancia 1 de Cloud Phone,
acp-c8rzmx8fnwba6****, ubicada en la región China (Hangzhou) y con acceso a Internet, descarga el paquete desde Internet. A continuación, guarda el paquete en la carpeta/sdcard/Download, le cambia el nombre asougou.apke instala automáticamente la aplicación.Cargue el paquete mediante la red interna en un bucket de OSS predeterminado de su propiedad ubicado en la misma región.
Distribuya el paquete mediante la red interna a otras instancias de Cloud Phone especificadas en la misma región, como la instancia 2 de Cloud Phone
acp-5fc8mx8fnw9s5****. Después, instale automáticamente la aplicación.
La primera instancia de Cloud Phone debe contar con permisos de acceso a Internet y espacio de almacenamiento suficiente. De lo contrario, no podrá descargar ni almacenar el paquete de aplicación.
En comparación con el escenario 3, este escenario reduce los costos de transferencia de datos, pero genera costos adicionales de almacenamiento de OSS porque usa un bucket de OSS predeterminado como punto de tránsito. Elija el escenario que mejor se adapte a sus necesidades.
SendFile Ejemplo de llamada a la API
-
Mensaje de solicitud
{ "AndroidInstanceIdList": [ "acp-c8rzmx8fnwba6****", "acp-5fc8mx8fnw9s5****" ], "SourceFilePath": "/sdcard/Download", "UploadType": "OSS_BRIDGED", "UploadUrl": "https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk", "UploadEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com", "TargetFileName": "sougou.apk", "AutoInstall": "true" } -
Mensaje de respuesta
{ "TaskId": "t-gk0ahswe4blor****", "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****", "Data": [ { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-c8rzmx8fnwba6****" }, { "TaskId": "t-gk0ahswe4blor****", "AndroidInstanceId": "acp-5fc8mx8fnw9s5****" } ] }
Pasos siguientes
Una vez que la llamada a la API se complete correctamente, llame a la API DescribeTasks para consultar el progreso y el estado de la tarea mediante el valor TaskId devuelto.
Comparación de escenarios
Escenarios 1 y 2: si el archivo o el paquete de aplicación se almacena en un bucket de OSS dentro de la misma región que las instancias de Cloud Phone, la distribución se efectúa mediante la red interna y no consume tráfico de Internet.
Escenario 3: si el archivo o el paquete de aplicación se encuentra en Internet, cada instancia de Cloud Phone descarga su propia copia. Esto consume tráfico de Internet.
Escenario 4: si el archivo o el paquete de aplicación está en Internet, una sola instancia de Cloud Phone lo descarga y lo almacena en caché dentro de un bucket de OSS de su propiedad en la misma región. Posteriormente, la copia en caché se distribuye al resto de las instancias de Cloud Phone mediante la red interna, lo cual consume únicamente una pequeña cantidad de tráfico de Internet.