产品
热门产品
人工智能
存储
网络
SaaS基础设施
视频云
物联网
应用PaaS
研发运维
专有部署
热门产品
云舟观测 GC
一站式数据采集与应用监控观测平台
人工智能
AI平台
天纪大模型开发 TLM
面向开发者的一站式大模型开发平台
天纪AI开发平台 TAI
面向开发者的一站式AI开发平台
天纪智能体开发 ADP
以大模型为核心控制器的一站式AI应用开发平台
天纪智能问答平台 RDP
天纪智能问答平台
AI应用
内容审核 CM
图片审核|文本审核|音频审核|视频审核
人脸人体识别 FHR
人脸识别|人体识别|人脸比对|摔倒检测
OCR识别 OCR
卡证识别|通用文本识别|车牌识别
图像技术 IA
面向图片场景提供的多种人工智能技术
模型市场 MaaS
图片、音频、视频等多场景的算法模型
视觉分析
视图计算 VEC
云边融合 AI赋能的智能视图计算
存储
对象存储 OBS
稳定、安全、可靠的云存储服务
文件存储 QHDFS
具有标准HDFS访问协议的分布式文件系统
网络
内容分发网络 CDN
安全、稳定、低延时的分发加速服务
P2P内容分发 PCDN
利用闲置资源而构建的低成本高品质CDN
SaaS基础设施
API文档管理 APICloud
API文档、调试、MOCK一体化协作平台
统一身份认证 IAM
统一的身份认证、授权管理
幕印企业学堂 MuYin
企业培训|内容付费|知识营销
视频云
视频直播 LIVE
大规模实时转码、低延时的直播服务
视频点播 VOD
视频流畅播放服务
音视频通话 RTC
便捷的跨平台实时音视频互动直播服务
媒体处理 MPC
简洁的云媒体转码及内容合成处理服务
视频工具 SDK
视频剪辑SDK | 播放SDK
易讲教室直播 YiJiang
视频技术与传统教室融合
物联网
帝视物联网 IOT
低延时、海量存储的物联网视频监控服务
企业物联网平台
设备管理|设备接入|规则引擎|应用开发
生活物联网平台
针对消费级智能设备的物联网平台
应用PaaS
云短信 SMS
融合三网,安全可信的短信服务
研发运维
云舟观测 GC
一站式数据采集与应用监控观测平台
三六零天御加固保 JiaGu
提供安全可靠的加固防护产品及服务
兼容性测试 OpenTest
提供数百款TOP机型的云测服务
真机租用 RentPhone
远程真机租用,流畅体验如手机在手
iOS预审 iOSPre
智能扫描、分析、筛查ios审核的被拒风险点
专有部署
360云计算管理平台 Stack
规划、建设、运维一体的云计算解决方案
奇麟大数据 QiLin
企业级一站式大数据平台
360容器管理平台 Container
可对外私有化的容器云平台
360AI开发平台专有版 Prophet
全流程机器学习开发平台
更多产品,敬请期待
解决方案
产品解决方案
行业解决方案
产品解决方案
视频
通用直播解决方案
短视频解决方案
公共语音房聊天室解决方案
物联网
儿童手表音视频通话
云端NVR解决方案
数据上云
通用存储解决方案
IoT设备
AI+IPC解决方案
智能门锁解决方案
安防传感解决方案
智能网关解决方案
个护健康解决方案
账号体系
360用户帐号体系解决方案
行业解决方案
智慧城市
智慧社区解决方案
智慧交通解决方案
电商视频解决方案
电商视频解决方案
电商平台收款解决方案
教育
在线教育解决方案
互动课堂解决方案
全屋智能
智慧公寓解决方案
智慧酒店解决方案
家庭智能解决方案
智慧安防解决方案
医疗
健康看护解决方案
智能制造
工业物联网解决方案
游戏
游戏音视频解决方案
更多解决方案,敬请期待
帮助支持
技术社区
关于我们
控制台
登录
注册
云存储
云直播
产品文档
常见问题
API文档
云点播
产品文档
快速入门
API文档
CDN
产品文档
API文档
云存储
产品文档
SDK手册
API文档
互动直播
产品文档
API文档
操作指南
SDK管理
播放SDK
上传SDK
剪辑SDK
媒体处理
产品文档
API文档
帝视
产品文档
API文档
操作指南
支付平台
产品列表
产品文档
渠道接入解析
内容审核
产品文档
API文档
OCR识别
产品文档
API文档
人脸与人体识别
产品文档
API文档
SSL证书
产品说明
购买指南
电子签章
产品介绍
接入流程
云短信
接口文档
物联网平台
产品简介
快速入门
幕印企业学堂
产品介绍
生活物联网平台
产品简介
快速入门
图片处理
产品介绍
接口文档
视图计算
产品介绍
快速入门
常见问题
易讲-教室直播
产品介绍
帮助说明
产品手册
产品概述
快速入门
控制台指南
产品计费
API手册2.0
接入须知
Bucket API
Object API
golang SDK接入示例
Python SDK接入示例
Java sdk接入示例
AWS Command Line使用示例
SDK参考
SDK接入说明
上传SDK
Web上传SDK
IOS版本说明
IOS开发文档
Android版本说明
Android开发文档
API手册
接入须知
上传过程
表单上传
分片上传初始化
分片上传传输
分片上传完成
下载过程
获取文件的内容
获取文件下载地址
批量获取下载地址
资源管理
查看资源信息
删除资源
批量删除文件
首页
>
开发者中心
>
云存储
>
API手册2.0
>
Object API
# Object API # Abort Multipart Upload >终止分片上传 ``` /:bucket_name/:object_name?uploadId=:upload_id ``` **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | | upload_id | String | 多片上传的任务id | >请求示例 ``` DELETE /mybucket/my-movie.m2ts?uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1 Host: www.sample-host.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: authorization string ``` >响应示例 ``` HTTP/1.1 204 No Content x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 0 Connection: close Server: AmazonS3 ``` # Complete Multipart Upload >完成分片上传,合并所有part `post` ``` /:bucket_name/:object_name?uploadId=:upload_id ``` **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | | upload_id | String | 多片上传的任务id | **Request Elements** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | CompleteMultipartUpload | String | 包含请求的容器 | | Part | String | 与先前特定的多片上传部分相关的元素 | | PartNumber | String | 标识多片上传各个部分的标号 | | ETag | String |当多片上传任务被上传后返回的Etag值 | > 请求示例 ``` POST /mybucket/my-movie.m2ts?uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1 Host: www.sample-host.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: authorization string <CompleteMultipartUpload> <Part> <PartNumber>1</PartNumber> <ETag>"a54357aff0632cce46d942af68356b38"</ETag> </Part> <Part> <PartNumber>2</PartNumber> <ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag> </Part> <Part> <PartNumber>3</PartNumber> <ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag> </Part> </CompleteMultipartUpload> ``` **响应内容说明** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | CompleteMultipartUploadResult | String | 返回体的容器 | | ETag | String | 所有Object的ETag的MD5值 | > 响应示例 ``` HTTP/1.1 204 No Content x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 0 Connection: close Server: AmazonS3 <CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>Example-Bucket</Bucket> <Key>Example-Object</Key> <ETag>"3858f62230ac3c915f300c664312c11f-9"</ETag> </CompleteMultipartUploadResult> ``` # DELETE Object > 删除object `Delete` ``` /:bucket_name/:object_name ``` **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | > 请求示例 ``` DELETE /bk1/ob1 HTTP/1.1 Host: www.sample-host.com Date: Wed, 01 Mar 2006 12:00:00 GMT Authorization: authorization string ``` > 响应示例 ``` HTTP/1.1 204 No Content x-amz-request-id: 32FE2CEB32F5EE25 Date: Wed, 01 Mar 2006 12:00:00 GMT Connection: close Server: AmazonS3 ``` # GET Object >获取(下载) Object `GET` ``` /:bucket_name/:object_name ``` **Request Headers** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | range | String | 获取部分Object | **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | > 请求示例 ``` GET /bucket/ob1 HTTP/1.1 Host: www.sample-host.com Date: Wed, 12 Oct 2009 17:50:00 GMT Authorization: authorization string Content-Type: text/plain ``` >请求示例 Range Header ``` GET /example-bucket/example-object HTTP/1.1 Host: www.sample-host.com x-amz-date: Fri, 28 Jan 2011 21:32:02 GMT Range: bytes=0-9 Authorization: AWS AKIAIOSFODNN7EXAMPLE:Yxg83MZaEgh3OZ3l0rLo5RTX11o= ``` > 响应示例 ``` HTTP/1.1 200 OK x-amz-id-2: eftixk72aD6Ap51TnqcoF8eFidJG9Z/2mkiDFu8yU9AS1ed4OpIszj7UDNEHGran x-amz-request-id: 318BC8BC148832E5 Date: Mon, 3 Oct 2016 22:32:00 GMT Last-Modified: Wed, 12 Oct 2009 17:50:00 GMT ETag: "fba9dede5f27731c9771645a39863328" Content-Length: 434234 [434234 bytes of object data] ``` > 响应示例 Range Header ``` HTTP/1.1 206 Partial Content x-amz-id-2: MzRISOwyjmnupCzjI1WC06l5TTAzm7/JypPGXLh0OVFGcJaaO3KW/hRAqKOpIEEp x-amz-request-id: 47622117804B3E11 Date: Fri, 28 Jan 2011 21:32:09 GMT x-amz-meta-title: the title Last-Modified: Fri, 28 Jan 2011 20:10:32 GMT ETag: "b2419b1e3fd45d596ee22bdf62aaaa2f" Accept-Ranges: bytes Content-Range: bytes 0-9/443 Content-Type: text/plain Content-Length: 10 Server: AmazonS3 [10 bytes of object data] ``` # HEAD Object >检查object 是否存在 `HEAD` ``` /:bucket_name/:object_name ``` **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | > 请求示例 ``` HEAD /bk1/ob2 HTTP/1.1 Date: Fri, 10 Feb 2012 21:34:55 GMT Authorization: authorization string Host: www.sample-host.com Connection: Keep-Alive ``` > 响应示例 ``` HTTP/1.1 200 OK x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80 x-amz-request-id: 32FE2CEB32F5EE25 Date: Fri, 10 2012 21:34:56 GMT ETag: "ac2e33f90b26451d1c8f8987678f860d" Last-Modified: Tue, 11 Apr 2017 03:22:24 GMT Server: AmazonS3 ``` # 初始化分片上传 > 初始化分片上传请求, 返回 upload ID `POSt` ``` /:bucket_name/:object_name?uploads= ``` **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | > 请求示例 ``` POST /bucket1/my-second-image.jpg?uploads= HTTP/1.1 Host: www.sample-host.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: authorization string ``` **响应内容说明** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | Bucket | String | Objects's bucket | | Key | String | Object's key | | UploadId | String | 上传任务的ID | > 响应示例 ``` HTTP/1.1 200 OK Date: Mon, 1 Nov 2010 20:34:56 GMT Content-Length: 197 Connection: keep-alive Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>example-bucket</Bucket> <Key>example-object</Key> <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId> </InitiateMultipartUploadResult> ``` # 列出object的所有分片 > 列出object的所有分片(最多1000个). `GET` ``` /:bucket_name/:object_name?uploadId=:upload_id ``` **Url 参数 ** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | | upload_id | String | 多片上传的任务id | | max-parts `可选` | Number | 需要返回的最大数量尺寸范围 : `0-1000` | | part-number-marker `可选` | String | 以此marker列出Objects | > 请求示例 ``` GET /mybucket/my-movie.m2ts?uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1 Host: www.sample-host.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: authorization string ``` **响应内容说明** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | PartNumberMarker | String | 标记返回的list从哪里开始 | | NextPartNumberMarker | String | 如果返回列表被截断,该字段说明是从哪里截断 | | MaxParts | String | 用户需要返回的最大值 | | IsTruncated | String | 列表是否截断 | > 响应示例 ``` HTTP/1.1 200 OK x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 985 Connection: keep-alive Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>example-bucket</Bucket> <Key>example-object</Key> <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</ UploadId> <Initiator> <ID>arn:aws:iam::111122223333:user/some-user-11116a31-17b5-4fb7-9df5- b288870f11xx</ID> <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</ DisplayName> </Initiator> <Owner> <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID> <DisplayName>someName</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <PartNumberMarker>1</PartNumberMarker> <NextPartNumberMarker>3</NextPartNumberMarker> <MaxParts>2</MaxParts> <IsTruncated>true</IsTruncated> <Part> <PartNumber>2</PartNumber> <LastModified>2010-11-10T20:48:34.000Z</LastModified> <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag> <Size>10485760</Size> </Part> <Part> <PartNumber>3</PartNumber> <LastModified>2010-11-10T20:48:33.000Z</LastModified> <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag> <Size>10485760</Size> </Part> </ListPartsResult> ``` # PUT Object - Copy > 复制一个存在的object `put` ``` /:bucket_name/:object_name ``` **Request Headers** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | x-amz-copy-source | String | /source_bucket/source_object | **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | > 请求示例 ``` PUT /bucket1/my-second-image.jpg HTTP/1.1 Host: www.sample-host.com Date: Wed, 28 Oct 2009 22:32:00 GMT x-amz-copy-source: /bucket/my-image.jpg Authorization: authorization string ``` **响应内容说明** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | CopyObjectResult | String | 目的对象的修改时间及ETag | > 响应示例 ``` HTTP/1.1 200 OK x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT ETag: "9a0364b9e99bb480dd25e1f0284c8555" Content-Length: 238 Connection: close Server: AmazonS3 <CopyObjectResult> <LastModified>2009-10-28T22:32:00</LastModified> <ETag>"9b2cf535f27731c974343645a3985328"</ETag> </CopyObjectResult> ``` # PUT Object > 创建 object, 用于上传文件(object) `PUT` ``` /:bucket_name/:object_name ``` **Url 参数 ** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | > 请求示例 ``` PUT /bk1/ob1 HTTP/1.1 Content-Type: application/x-www-form-urlencoded Host: www.sample-host.com X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 X-Amz-Date: 20170411T024836Z Authorization: authorization string Cache-Control: no-cache Postman-Token: e1428bef-0ef7-072f-0e4b-3b72fb6b37a3 content ``` > 响应示例 ``` HTTP/1.1 200 OK x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT ETag: "9a0364b9e99bb480dd25e1f0284c8555" Content-Length: 0 Connection: close Server: AmazonS3 ``` # Upload Part - Copy > 分片上传Object(复制现有对象的数据作为数据源) `PUT` ``` /:bucket_name/:object_name?uploadId=:upload_id&partNumber=:part_num ``` **Request Headers** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | x-amz-copy-source | String | /source_bucket/source_object | | x-amz-copy-source-range `可选` | String | 拷贝部分Object | **Url 参数** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | | upload_id | String | 多片上传的任务id | | part_num | String | 多片上传的次序 | >请求示例 ``` PUT /mybucket/my-movie.m2ts?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1 Host: www.sample-host.com Date: Wed, 28 Oct 2009 22:32:00 GMT x-amz-copy-source: /bucket/my-image.jpg Authorization: authorization string ``` **响应内容说明** | 字段 | 类型 | 描述 | ------------ | ------------ | ------------ | | CopyObjectResult | String | 目的对象的修改时间及ETag | > 响应示例 ``` HTTP/1.1 200 OK x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT ETag: "9a0364b9e99bb480dd25e1f0284c8555" Content-Length: 238 Connection: close Server: AmazonS3 <CopyObjectResult> <LastModified>2009-10-28T22:32:00</LastModified> <ETag>"9b2cf535f27731c974343645a3985328"</ETag> </CopyObjectResult> ``` # Upload Part > 分片上传Object `PUT` ``` /:bucket_name/:object_name?uploadId=:upload_id&partNumber=:part_num ``` **Url 参数 ** | 字段 | 类型 | 描述 | | ------------ | ------------ | ------------ | | bucket_name | String | Bucket 名称 | | object_name | String | Object 名称 | | upload_id | String | 多片上传的任务id | | part_num | String | 多片上传的次序 | > 请求示例 ``` PUT /mybucket/my-movie.m2ts?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1 Host: www.sample-host.com Date: Mon, 1 Nov 2010 20:34:56 GMT Content-Length: 10485760 Content-MD5: pUNXr/BjKK5G2UKvaRRrOA== Authorization: authorization string ***part data omitted*** ``` > 响应示例 ``` HTTP/1.1 200 OK Date: Mon, 1 Nov 2010 20:34:56 GMT Content-Length: 197 Connection: keep-alive ETag: "b54357faf0632cce46e942fa68356b38" Server: AmazonS3 ```
即刻开始使用
只需完成注册与实名认证,即可体验我们的贴心服务
立即使用
请您联系我们
邮箱
g-zyun@360.cn
电话
4000052360
小安提醒您
试用小安,请确保该账户已通过智汇云实名认证
前往认证中心>>
1对1免费
咨询智汇云专属顾问
为您量身定制产品解决方案
您的姓名 :
手机号 :
公司名称(选填) :
相关产品 :
留言内容 :
需求描述
产品建议
其他
提交
登录后才可以留言哦
立即登录
去注册账号