DescribeSendFileResults_云服务器 ECS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
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
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明:

  • 当您下发文件后,不代表文件一定成功下发。您需要通过接口返回值查看实际下发结果,并以实际输出结果为准。
  • 您可以查询最近 6 周的下发记录。
  • 分页查询首页时,仅需设置MaxResults以限制返回信息的条目数,返回结果中的NextToken将作为查询后续页的凭证。查询后续页时,将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证,并设置MaxResults限制返回条目数。

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ecs:DescribeSendFileResults
Get
Instance
acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

请求参数

字段名称字段详情
RegionIdstring

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

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

文件下发的资源组 ID。传入该参数后,需要在下发文件时指定 ResourceGroupId,支持筛选出对应的文件下发结果。

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

执行 ID。

示例值:f-hz0jdfwd9f****参考取值来源:
    InvokeCommand
Namestring

文件名称。传入该参数后,将查询该名称文件的所有的下发记录。

示例值:test.txt
InstanceIdstring

实例 ID。传入该参数后,将查询该实例所有的文件下发记录。

示例值:i-hz0jdfwd9f****参考取值来源:
    RunInstances
    StopInstances
    CreateInstance
    StartInstances
    RebootInstances
    DescribeInstances
    ModifyManagedInstance
    RenewReservedInstances
    AttachInstanceRamRole
    DetachInstanceRamRole
    DeregisterManagedInstance
    PurchaseReservedInstancesOffering
PageNumberinteger<int64>
说明 该参数即将下线,推荐您使用 NextToken 与 MaxResults 完成分页查询操作。
注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1
PageSizeinteger<int64>
说明 该参数即将下线,推荐您使用 NextToken 与 MaxResults 完成分页查询操作。
注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:10
MaxResultsinteger<int32>

分页查询时每页的最大条目数。展开详情

示例值:10
NextTokenstring

查询凭证(Token),取值为上一次 API 调用返回的 NextToken 参数值。

示例值:AAAAAdDWBF2
InvocationStatusstring

文件的总下发状态。总状态取决于本次下发的全部实例的共同执行状态,取值范围:展开详情

示例值:Success
Tagarray<object>

标签列表。

子级条数 <= 21

返回参数

字段名称字段详情
PageSizeinteger<int64>

每页行数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:10
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumberinteger<int64>

查询结果的当前页码。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:1
TotalCountinteger<int64>

脚本总个数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:2
NextTokenstring

本次调用返回的查询凭证值。

示例值:AAAAAdDWBF2
Invocationsobject

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
RegionId.ApiNotSupported
The api is not supported in this region.诊断
400
NumberExceed.Tags
The Tags parameter number is exceed.诊断
400
MissingParameter.TagKey
You must specify Tag.N.Key.诊断
400
Duplicate.TagKey
The Tag.N.Key contain duplicate key.诊断
400
InvalidTagKey.Malformed
The specified Tag.n.Key is not valid.诊断
400
InvalidTagValue.Malformed
The specified Tag.n.Value is not valid.诊断
400
InvalidParam.PageNumber
The specified parameter is invalid.诊断
400
InvalidParam.PageSize
The specified parameter is invalid.诊断
400
InvalidParameter.NextToken
The specified parameter NextToken is not valid.诊断
400
InvalidParameter.MaxResults
The specified parameter MaxResults is not valid.诊断
403
Operation.Forbidden
The operation is not permitted.诊断
404
InvalidRegionId.NotFound
The RegionId provided does not exist in our records.诊断
500
InternalError.Dispatch
An error occurred when you dispatched the request.诊断

变更历史

变更时间变更内容概要操作
2023-12-21
变更错误码400
新增请求参数MaxResults
新增请求参数NextToken
变更返回参数
2023-09-19
新增请求参数InvocationStatus
2023-05-12
变更错误码400
变更错误码403
删除返回参数
2022-10-28
新增请求参数ResourceGroupId
2022-02-25
变更错误码403
变更错误码404

相关示例