ListTempFiles - 列出临时文件信息

更新时间:
复制为 MD 格式

获取临时文件列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

paidsw:ListTempFiles

list

*全部资源

*

请求语法

GET /api/v2/tempfiles HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

Name

string

临时文件名称

filename

Prefix

string

路径前缀

somedir/

Delimiter

string

对 Object 名字进行分组的字符。所有名字包含指定的前缀且第一次出现 Delimiter 字符之间的 Object 作为一组元素 CommonPrefixes。

/

InstanceId

string

实例 ID。

dsw-730xxxxxxxxxx

PageNumber

integer

页码

1

PageSize

integer

分页数量大小

10

SortBy

string

排序字段

GmtModifiedTime

Order

string

排列顺序

DESC

返回参数

名称

类型

描述

示例值

object

临时文件列表

RequestId

string

请求 Id

E7D55162-4489-1619-AAF5-3F97D5FCA948

Success

boolean

成功标志

true

Message

string

说明

"XXX"

Code

string

状态码

"200"

HttpStatusCode

integer

http 状态码

200

TotalCount

integer

临时文件总数

35

TempFiles

array<object>

本分页中请求的临时文件列表

object

UserId

string

用户 Id

1612285282502324

OwnerId

string

Owner Id

1612285282502324

TaskId

string

任务 Id

task-05cexxxxxxxxx

InstanceId

string

实例 Id

dsw-730xxxxxxxxxx

Type

string

文件类型

type

GmtCreateTime

string

临时文件创建时间

2021-01-12T14:36:01Z

GmtModifiedTime

string

临时文件修改时间

2021-01-12T14:36:01Z

GmtExpiredTime

string

临时文件过期时间

2021-01-12T14:36:01Z

Uuid

string

临时文件 Id

tempfile-05cexxxxxxxxx

Name

string

临时文件名称

filename

Description

string

临时文件描述

desc

Capacity

integer

临时文件容量

1000

Status

string

临时文件状态

Created

Prefix

string

临时文件存储路径前缀

/1079135428626537/209170658818096848/

Bandwidth

integer

临时文件上传带宽

10Mi

UploadUrl

string

临时文件上传 url

http://examplebucket.yourEndpoint/exampledir/exampleobject.txt?Expires=1703123154&OSSAccessKeyId&Signature=5ekVo7r+CeeU5oYmCpnmrzrx2IM=

DownloadUrl

string

临时文件下载 url

http://examplebucket.yourEndpoint/exampledir/exampleobject.txt?Expires=1703123270&OSSAccessKeyId&Signature=Fn7xSv2kRQraU6UqRZ3+DMzQK14=

Quota

object

临时文件 Quota 信息

UsedFileNum

integer

已存储文件数量

100

TotalFileNum

integer

文件存储数量上限

1000

UsedCapacity

integer

已使用文件存储体积

1000

TotalCapacity

integer

总共可使用文件存储体积

1000

示例

正常返回示例

JSON格式

{
  "RequestId": "E7D55162-4489-1619-AAF5-3F97D5FCA948",
  "Success": true,
  "Message": "\"XXX\"",
  "Code": "\"200\"",
  "HttpStatusCode": 200,
  "TotalCount": 35,
  "TempFiles": [
    {
      "UserId": "1612285282502324",
      "OwnerId": "1612285282502324",
      "TaskId": "task-05cexxxxxxxxx",
      "InstanceId": "dsw-730xxxxxxxxxx",
      "Type": "type",
      "GmtCreateTime": "2021-01-12T14:36:01Z",
      "GmtModifiedTime": "2021-01-12T14:36:01Z",
      "GmtExpiredTime": "2021-01-12T14:36:01Z",
      "Uuid": "tempfile-05cexxxxxxxxx",
      "Name": "filename",
      "Description": "desc",
      "Capacity": 1000,
      "Status": "Created",
      "Prefix": "/1079135428626537/209170658818096848/",
      "Bandwidth": 0,
      "UploadUrl": "http://examplebucket.yourEndpoint/exampledir/exampleobject.txt?Expires=1703123154&OSSAccessKeyId&Signature=5ekVo7r+CeeU5oYmCpnmrzrx2IM=",
      "DownloadUrl": "http://examplebucket.yourEndpoint/exampledir/exampleobject.txt?Expires=1703123270&OSSAccessKeyId&Signature=Fn7xSv2kRQraU6UqRZ3+DMzQK14="
    }
  ],
  "Quota": {
    "UsedFileNum": 100,
    "TotalFileNum": 1000,
    "UsedCapacity": 1000,
    "TotalCapacity": 1000
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情