SendFile - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Envia arquivos remotos para uma ou mais instâncias ECS.

Descrição da operação

As instâncias ECS de destino devem estar no estado de execução (Running).
O Agente do Cloud Assistant deve ser instalado previamente nas instâncias ECS de destino.
A versão do Agente do Cloud Assistant deve ser posterior às seguintes versões para suportar o envio de arquivos. Se o código de erro ClientNeedUpgrade for retornado, atualize o agente para a versão mais recente.
- Linux: 1.0.2.569
- Windows: 1.0.0.149
Após a codificação Base64, o conteúdo do arquivo não pode exceder 32 KB de tamanho.
O envio de arquivos pode falhar devido a exceções no status da instância ECS de destino, problemas de rede ou exceções do Agente do Cloud Assistant. Chame DescribeSendFileResults ou consulte Erros comuns e soluções para falhas de execução para solucionar problemas.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:SendFile

update

*Instância.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região das instâncias ECS de destino. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ResourceGroupId	string	Não	O ID do grupo de recursos para o envio de arquivos. Se você especificar este parâmetro: A instância ECS especificada por InstanceId deve pertencer a este grupo de recursos. Você pode filtrar os resultados do envio de arquivos especificando este parâmetro ao chamar DescribeSendFileResults.	rg-bp67acfmxazb4p****
Name	string	Sim	O nome do arquivo. O conjunto de caracteres completo é suportado. O nome não pode exceder 255 caracteres de comprimento.	file.txt
Description	string	Não	A descrição. O conjunto de caracteres completo é suportado. A descrição não pode exceder 512 caracteres de comprimento.	Este é um arquivo de teste
Timeout	integer	Não	O período de tempo limite para o envio do arquivo. Unidade: segundos. Um tempo limite pode ocorrer quando o arquivo não pode ser enviado devido a um problema de processo, um módulo ausente ou um Agente do Cloud Assistant ausente. Se o período de tempo limite especificado for inferior a 10 segundos, o sistema definirá automaticamente o período de tempo limite como 10 segundos para garantir a entrega bem-sucedida. Valor padrão: 60.	60
TargetDir	string	Sim	A pasta de destino nas instâncias ECS de destino para o arquivo a ser enviado. Se a pasta não existir, a criação automática será realizada. O valor não pode exceder 255 caracteres de comprimento.	/home
ContentType	string	Não	O tipo de conteúdo do arquivo. Valores válidos: PlainText: texto simples. Base64: codificação Base64. Valor padrão: PlainText.	PlainText
Content	string	Sim	O conteúdo do arquivo. Após a codificação Base64, o conteúdo não pode exceder 32 KB de tamanho. Se ContentType estiver definido como PlainText, este parâmetro especifica o conteúdo em texto simples. Se ContentType estiver definido como Base64, este parâmetro especifica o conteúdo codificado em Base64.	#!/bin/bash echo "Current User is :" echo $(ps \| grep "$$" \| awk '{print $2}') -------- oss://bucketName/objectName
FileOwner	string	Não	O proprietário do arquivo. Este parâmetro entra em vigor apenas em instâncias Linux. Valor padrão: root. O valor não pode exceder 64 caracteres de comprimento. Nota Se você especificar outro usuário, certifique-se de que o usuário exista na instância.	test
FileGroup	string	Não	O grupo de usuários do arquivo. Este parâmetro entra em vigor apenas em instâncias Linux. Valor padrão: root. O valor não pode exceder 64 caracteres de comprimento. Nota Se você especificar outro grupo de usuários, certifique-se de que o grupo de usuários exista na instância.	test
FileMode	string	Não	As permissões do arquivo. Este parâmetro entra em vigor apenas em instâncias Linux. Você pode configurar este parâmetro da mesma forma que executa o comando chmod. Valor padrão: 0644, o que indica que o proprietário tem permissões de leitura e gravação, e o grupo e outros usuários têm permissões somente leitura.	0644
Overwrite	boolean	Não	Especifica se deve substituir um arquivo com o mesmo nome no diretório de destino. Valores válidos: true: Substituir o arquivo. false: Não substituir o arquivo. Valor padrão: false.	true
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. ClientToken suporta apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
InstanceId	array	Sim	Os IDs das instâncias ECS para as quais você deseja enviar o arquivo. Você pode especificar até 50 IDs de instância. Valores válidos de N: 1 a 50.	i-bp185dy2o3o6n****
	string	Não	Os IDs das instâncias ECS para as quais você deseja enviar o arquivo. Você pode especificar até 50 IDs de instância. Valores válidos de N: 1 a 50.	i-bp185dy2o3o6n****
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag para o envio de arquivos. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Se você usar uma única tag para filtrar recursos, a contagem de recursos com a tag não pode exceder 1.000. Se você usar várias tags para filtrar recursos, a contagem de recursos que possuem todas as tags especificadas anexadas não pode exceder 1.000. Se a contagem de recursos exceder 1.000, chame a operação ListTagResources para consultar recursos. A chave da tag pode ter até 64 caracteres de comprimento e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://.	TestKey
Value	string	Não	O valor da tag para o envio de arquivos. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres de comprimento e não pode conter http:// ou https://.	TestValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
InvokeId	string	O ID de execução.	f-7d2a745b412b46****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "InvokeId": "f-7d2a745b412b46****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	RegionId.ApiNotSupported	The api is not supported in this region.	A operação de API não é suportada na região especificada. Verifique se o valor do parâmetro RegionId está correto.
400	MissingParam.InstanceId	The parameter instanceId is missing or empty.	O ID da instância está vazio.
400	NumberExceed.Tags	The Tags parameter number is exceed.	O número de tags excede o limite máximo. Você pode especificar até 20 tags para esta operação.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Especifique uma chave de tag.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Existem chaves duplicadas nas tags. Certifique-se de que todas as chaves sejam únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	O parâmetro de chave de tag especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	O parâmetro de valor da tag especificado é inválido.
400	FileTargetDir.Invalid	The target directory of file is invalid.
400	FileMode.Invalid	The mode of file is invalid.
400	FileContent.DecodeError	The Content can not be base64 decoded.
400	FileContentType.Invalid	The ContentType of file is invalid.
400	InvalidParameter.FileOwner	The specified parameter FileOwner is not valid.	O parâmetro FileOwner especificado é inválido.
400	InvalidParameter.FileGroup	The specified parameter FileGroup is not valid.	O parâmetro FileGroup especificado é inválido.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	O parâmetro idempotente especificado é inválido.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	FileSize.ExceedLimit	The length of file content exceeds limit.	O comprimento do conteúdo do arquivo excede o limite superior.
403	FileName.ExceedLimit	The length of file name exceeds limit.	O comprimento do nome do arquivo excede o limite superior.
403	FileDesc.ExceedLimit	The length of file description exceeds limit.	O comprimento da descrição do arquivo excede o limite superior.
403	InstanceIds.ExceedLimit	The number of instance IDs exceeds the upper limit.	O número de instâncias de destino excede o limite superior.
403	Operation.Forbidden	The operation is not permitted.	A operação não é permitida.
403	InvalidTimeout.ExceedLimit	The specified parameter Timeout exceeds the upper limit.
403	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Os parâmetros da solicitação não correspondem à solicitação com o mesmo ClientToken.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	A solicitação idempotente anterior ainda está sendo processada. Tente novamente mais tarde.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	InvalidInstance.NotFound	The specified instances not found.	A instância especificada não existe.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos não foi encontrado nos registros.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.