SendFile
向一台或多台ECS实例下发远程文件
服务地址：
华东1 金融云
输入参数
只看必填
RegionId目标ECS实例所在的地域ID
ResourceGroupId文件下发的资源组ID
Name文件名称
Description描述信息
Timeout下发文件的超时时间
TargetDir文件下发目标ECS实例中的目录
ContentType文件内容类型
Content文件内容
FileOwner文件的用户
FileGroup文件的用户组
FileMode文件的权限
Overwrite如果同名文件在目标目录已存在
请选择布尔值
InstanceId需要执行命令的ECS实例列表
0需要执行命令的ECS实例列表
添加
Tag标签列表
0标签列表
Key文件下发的标签键
Value文件下发的标签值
添加
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 目标 ECS 实例的状态必须为运行中（Running）。
  • 目标 ECS 实例必须预先安装云助手 Agent。
  • 云助手 Agent 版本需要高于以下对应的版本才能支持下发文件。如果结果返回ClientNeedUpgrade错误码，请将客户端更新至最新版本。
    • Linux：1.0.2.569
    • Windows：1.0.0.149
  • 文件内容在进行 Base64 编码后，大小不能超过 32 KB。
  • 文件下发可能会因为目标 ECS 实例的状态异常、网络异常或云助手 Agent 异常而出现失败的情况。请调用 DescribeSendFileResults ，或参考执行失败常见错误及修复建议进行问题排查。

请求参数

字段名称字段详情
RegionIdstring

目标 ECS 实例所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
ResourceGroupIdstring

文件下发的资源组 ID，当指定该参数时：展开详情

示例值:rg-bp67acfmxazb4p****参考取值来源:
    DescribeSecurityGroups
Namestring

文件名称。支持全字符集，长度不得超过 255 个字符。

示例值:file.txt
Descriptionstring

描述信息。支持全字符集，长度不得超过 512 个字符。

示例值:This is a test file.
Timeoutinteger<int64>

下发文件的超时时间。单位：秒。展开详情

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:60
TargetDirstring

文件下发目标 ECS 实例中的目录。如不存在则会自动创建。长度不得超过 255 个字符。

示例值:/home
ContentTypestring

文件内容类型。展开详情

示例值:PlainText
Contentstring

文件内容。文件内容在 Base64 编码后，大小不能超过 32 KB。展开详情

示例值:#!/bin/bash echo "Current User is :" echo $(ps | grep "$$" | awk '{print $2}') -------- oss://bucketName/objectName
FileOwnerstring

文件的用户。只对 Linux 实例生效，默认为 root。长度不得超过 64 个字符。展开详情

示例值:test参考取值来源:
    DescribeSendFileResults
FileGroupstring

文件的用户组。只对 Linux 实例生效，默认为 root。长度不得超过 64 个字符。展开详情

示例值:test
FileModestring

文件的权限。只对 Linux 实例生效，设置方式与 chmod 命令相同。展开详情

示例值:0644
Overwriteboolean

如果同名文件在目标目录已存在，是否覆盖文件。展开详情

示例值:true
InstanceIdarray<string>

需要执行命令的 ECS 实例列表。最多能指定 50 台 ECS 实例 ID。N 的取值范围为 1~50。

示例值:i-bp185dy2o3o6n****子级条数 <= 100
Tagarray<object>

标签列表。

子级条数 <= 21

返回参数

字段名称字段详情
InvokeIdstring

命令执行 ID。

示例值:f-7d2a745b412b46****
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
变更历史
变更时间变更内容概要操作
2023-05-12
变更错误码400
变更错误码403
删除返回参数
2022-10-28
变更错误码404
新增请求参数ResourceGroupId
2022-02-25
变更错误码403
变更错误码404