Todos los productos
Search
Centro de documentos

Cloud Phone:SendFile

Última actualización: Oct 27, 2026

Transfiere archivos desde OSS o URL de descarga públicas a teléfonos en la nube.

Descripción de la operación

Actualmente, solo se pueden enviar archivos o carpetas desde Object Storage Service (OSS) a los teléfonos en la nube.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

AndroidInstanceIdList

array

Sí

La lista de instancias.

string

No

El ID de la instancia.

acp-34pqe4r0kd9kn****

SourceFilePath

string

Sí

La ruta de carga dentro del teléfono en la nube a la que se sube el archivo.

Nota

Si UploadType es OSS o OSS_BRIDGED, la ruta de carga SourceFilePath dentro del teléfono en la nube debe ser un directorio, como /sdcard/Download. Si UploadType es DOWNLOAD_URL, la ruta de carga SourceFilePath dentro del teléfono en la nube debe ser un archivo, como /sdcard/Download/MyFile.txt.

/sdcard/Download

UploadType

string

Sí

El tipo de almacenamiento del archivo que se va a cargar.

  • OSS: El archivo que se va a cargar es un recurso de OSS.

  • DOWNLOAD_URL: El archivo que se va a cargar es una URL de descarga pública.

  • OSS_BRIDGED: El archivo se sincroniza con OSS a través de una URL de descarga pública y luego se distribuye a las instancias de teléfonos en la nube a través de la red interna de OSS.

Valores válidos:

  • DOWNLOAD_URL :

    URL de descarga pública de un archivo.

  • OSS :

    Recurso de archivo de OSS.

OSS

UploadEndpoint

string

No

El nombre de dominio del servicio para cargar archivos en OSS. Este parámetro es obligatorio cuando UploadType se establece en OSS o OSS_BRIDGED.

Nota

Si el teléfono en la nube y el bucket de OSS están en la misma región, puede usar un endpoint interno para acelerar la velocidad de transmisión y evitar tarifas de tráfico de Internet. Por ejemplo, el endpoint interno para la región China (Hangzhou) es oss-cn-hangzhou-internal.aliyuncs.com. Para obtener más información sobre la asignación entre regiones y endpoints, consulte Regiones y endpoints.

oss-cn-hangzhou-internal.aliyuncs.com

UploadUrl

string

Sí

  • Si UploadType es OSS, UploadUrl es la dirección en la nube del archivo cargado en OSS.

Nota

El nombre del bucket de OSS debe comenzar con el prefijo "cloudphone-saved-bucket-", como "cloudphone-saved-bucket-example". Debe crear una carpeta de OSS como directorio de respaldo. El formato de UploadUrl es "oss://" + "Nombre del bucket" + "/" + "Nombre de la carpeta" + "Nombre del archivo cargado".

  • Si UploadType es DOWNLOAD o OSS_BRIDGED, UploadUrl es la URL de descarga pública del archivo.

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

TargetFileName

string

No

El nombre del archivo cargado desde OSS al teléfono en la nube.

Nota

Si UploadType es OSS o OSS_BRIDGED, el parámetro TargetFileName es opcional. Si TargetFileName está vacío, se conserva el nombre original del archivo cuando el archivo de OSS se carga en el teléfono en la nube. Si TargetFileName no está vacío, el nombre del archivo en el directorio SourceFilePath del teléfono en la nube se establece con el valor de TargetFileName. Si UploadType es DOWNLOAD_URL, el parámetro TargetFileName no surte efecto.

test.txt

AutoInstall

boolean

No

Especifica si se debe instalar automáticamente la aplicación cargada.

true

ClientToken

string

No

El token de cliente que se utiliza para garantizar la idempotencia de la solicitud y evitar envíos duplicados. El token puede tener una longitud de hasta 100 caracteres.

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

FileMd5

string

No

El valor MD5 del archivo de entrada.

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los parámetros de respuesta.

Data

array<object>

Los datos devueltos.

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

object

El objeto de resultado devuelto.

AndroidInstanceId

string

El ID de la instancia.

acp-34pqe4r0kd9kn****

TaskId

string

El ID de la tarea.

t-4ks224ujixw****

RequestId

string

El ID único de la solicitud. Si encuentra algún problema, proporcione este ID de solicitud al equipo de soporte técnico para la solución de problemas.

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

TaskId

string

El ID de la tarea por lotes.

t-ehs0yoedj0xe9****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.