CreateSelectObjectMeta_对象存储_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.

接口说明

  • CreateSelectObjectMeta操作要求您对该 Object 有写权限。

  • 如果该 API 执行正确,返回 200。如果目标文件不是合法 CSV 或者 JSON LINES 文件,或者指定的 CSV 分隔符和目标 CSV 不匹配,则返回 400。

流控信息

当前云产品API请求速率暂未透出。

授权信息

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

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
oss:PutObject
Create
Object
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
oss:ExistingObjectTag
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:GetObject

请求语法

POST /{key} HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<CsvMetaRequest>
  <InputSerialization>
    <CompressionType>string</CompressionType>
    <CSV>
      <FileHeaderInfo>string</FileHeaderInfo>
      <RecordDelimiter>string</RecordDelimiter>
      <FieldDelimiter>string</FieldDelimiter>
      <QuoteCharacter>string</QuoteCharacter>
      <CommentCharacter>string</CommentCharacter>
      <Range>string</Range>
      <AllowQuotedRecordDelimiter>boolean</AllowQuotedRecordDelimiter>
    </CSV>
    <JSON>
      <Type>string</Type>
      <Range>string</Range>
      <ParseJsonNumberAsString>boolean</ParseJsonNumberAsString>
    </JSON>
  </InputSerialization>
  <OverwriteIfExists>boolean</OverwriteIfExists>
</CsvMetaRequest>

路径参数

字段名称字段详情
keystring

Object 的完整路径。

示例值:exampledir/exampleobject.png

请求参数

字段名称字段详情
bucketstring

Bucket 名称。

示例值:examplebucket
x-oss-processstring

如果是 csv 文件,该值需要设置为 csv/meta;如果是 json 文件,则需要设置为 json/meta。

示例值:csv/meta
bodyobject

保存 CreateSelectObjectMeta 请求的容器。

返回参数

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

8 位整数,扫描结束时的文件偏移。

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

8 位整数,最终扫描过的数据大小。

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

4 位整数,最终的 status。

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

4 位整数,总 split 个数。

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

8 位整数,总行数。

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

4 位整数,总列数。

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

详细的错误信息。如果无错误,则 error_message 为空。

示例值:The body size in select request exceeds the max allowed size.

返回示例

变更历史

变更时间变更内容概要操作
2025-03-04
新增请求参数body
新增请求参数x-oss-process

相关示例