SendFile - Cloud Phone: Central de Documentação do Alibaba Cloud

Envia arquivos do Object Storage Service (OSS) ou de um link de download público para um ou mais cloud phones.

Descrição da operação

Use esta operação para enviar arquivos ou pastas do Object Storage Service (OSS) para cloud phones.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AndroidInstanceIdList	array	Sim	Os IDs de uma ou mais instâncias de cloud phone.
	string	Não	O ID da instância de cloud phone.	acp-34pqe4r0kd9kn****
SourceFilePath	string	Sim	O caminho de destino no cloud phone. Nota Se `UploadType` for `OSS` ou `OSS_BRIDGED`, `SourceFilePath` deve especificar um diretório, por exemplo, `/sdcard/Download/`. Se `UploadType` for `DOWNLOAD_URL`, `SourceFilePath` deve especificar um caminho completo de arquivo, por exemplo, `/sdcard/Download/MyFile.txt`.	/sdcard/Download
UploadType	string	Sim	O tipo de armazenamento do arquivo de origem. Valores válidos: OSS: O arquivo está armazenado no Object Storage Service (OSS). DOWNLOAD_URL: O arquivo está acessível por meio de um link de download público. OSS_BRIDGED: O serviço primeiro baixa o arquivo de um link de download público para um bucket interno do OSS e, em seguida, o distribui para as instâncias de cloud phone pela rede interna. Valores válidos: DOWNLOAD_URL : OSS :	OSS
UploadEndpoint	string	Não	O endpoint de serviço do Object Storage Service (OSS). Este parâmetro é obrigatório se `UploadType` for `OSS` ou `OSS_BRIDGED`. Nota Se a instância de cloud phone e o bucket do OSS estiverem na mesma região, você pode especificar um endpoint interno para acelerar a transferência de dados e evitar custos de transferência de dados pela rede pública. Por exemplo, o endpoint interno para a região China (Hangzhou) é `oss-cn-hangzhou-internal.aliyuncs.com`. Para obter uma lista completa de endpoints, consulte Regiões e endpoints do OSS.	oss-cn-hangzhou-internal.aliyuncs.com
UploadUrl	string	Sim	Se `UploadType` for `OSS`, este parâmetro especifica a URI do objeto de origem no Object Storage Service (OSS). Nota A URI deve estar no formato `oss://<bucket-name>/<object-key>`. O nome do bucket do OSS especificado deve ter o prefixo `cloudphone-saved-bucket-`, por exemplo, `cloudphone-saved-bucket-example`. Se `UploadType` for `DOWNLOAD_URL` ou `OSS_BRIDGED`, este parâmetro especifica o link de download público do arquivo de origem.	oss://cloudphone-saved-bucket-example/send/a.txt
TargetFileName	string	Não	O nome do arquivo de destino no cloud phone. Nota Este parâmetro é opcional e só entra em vigor quando `UploadType` está definido como `OSS` ou `OSS_BRIDGED`. Se você especificar este parâmetro, o arquivo será salvo com este nome no caminho especificado por `SourceFilePath`. Se você deixar este parâmetro vazio, o nome do arquivo de origem será usado. Este parâmetro é ignorado quando `UploadType` está definido como `DOWNLOAD_URL`.	test.txt
AutoInstall	boolean	Não	Especifica se o aplicativo deve ser instalado automaticamente após o upload do arquivo.	true
ClientToken	string	Não	Um token gerado pelo cliente que garante a idempotência da solicitação e evita envios duplicados. O token pode conter até 100 caracteres.	425F351C-3F8E-5218-A520-B6311D0D****
FileMd5	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
Data	array<object>	Os detalhes das tarefas criadas.	425F351C-3F8E-5218-A520-B6311D0D****
	object	Os detalhes de uma única tarefa.
AndroidInstanceId	string	O ID da instância.	acp-34pqe4r0kd9kn****
TaskId	string	O ID da tarefa individual para um cloud phone específico.	t-4ks224ujixw****
RequestId	string	Um identificador exclusivo para a solicitação. Se você encontrar um problema, forneça este ID de solicitação ao suporte técnico para solução de problemas.	425F351C-3F8E-5218-A520-B6311D0D****
TaskId	string	O ID da tarefa em lote.	t-ehs0yoedj0xe9****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.