OOS开发者文档-v6.pdf资源-CSDN文库

需积分: 32 156 浏览量 2021-04-10 17:23:37 上传评论收藏 2.77MB PDF 举报

在中国电信股份有限公司云计算分公司提供的《天翼云OOS开发者文档-v6.pdf》中，详细介绍了对象存储服务（Object-Oriented Storage, OOS）的各方面内容，包括产品介绍、优势、主要概念、安全策略、HTTP REST接口操作以及统计API等。以下内容将基于文档提供的信息，对这些知识点进行详细阐述。 ### 1. 对象存储（OOS）对象存储是一种存储架构，用于管理大量的非结构化数据，如图片、视频、音频等。OOS是天翼云提供的对象存储服务，具备以下几个核心概念： #### 1.1 Account 指用户的账户信息，用户通过账户信息进行认证、授权以及资源使用计费等操作。 #### 1.2 Service 服务指的是OOS提供的核心对象存储服务，通常用于执行数据的存储和检索。 #### 1.3 Bucket Bucket是存储在OOS中的一个容器，用于存储对象。它相当于传统文件系统中的文件夹，可以组织对象数据。 #### 1.4 Object 对象是存储在Bucket中的数据实体。每个对象由数据和元数据组成。数据可以是任意二进制数据，元数据则是键值对，用于描述对象的属性。 #### 1.5 通过IPv6访问OOS 随着IPv6的普及，OOS支持通过IPv6地址访问，使得用户在新的网络协议下也可以使用对象存储服务。 ### 2. 统计与操作跟踪 #### 2.1 统计分析统计分析模块提供了对OOS使用的详细数据监控，帮助用户了解资源使用情况、成本估算和性能评估。 #### 2.2 操作跟踪操作跟踪记录了OOS上进行的所有操作，帮助用户实现对资源使用情况的审计和监控。 ### 3. 安全策略 #### 3.1 用户签名验证（V2和V4）用户签名验证是OOS安全访问控制的核心机制，确保用户的数据不被未授权访问。文档详细介绍了Signature Version 2和Signature Version 4的工作原理和认证方法。 #### 3.2 Bucket权限控制用户可以设置Bucket的权限，包括公开读、公开写等，以控制其他用户对Bucket的访问。 #### 3.3 BucketPolicy安全策略 BucketPolicy是一种灵活的权限管理方式，允许用户定义一系列的权限规则来管理Bucket的访问控制。 ### 4. HTTP REST接口（OOS API） OOS API提供了一套HTTP RESTful接口，允许用户通过标准的HTTP请求进行对象的存储和管理操作。 #### 4.1 接口请求/响应头接口请求头和响应头包含了控制HTTP请求行为和处理HTTP响应的必要信息。 #### 4.2 关于Service的操作包括列出所有Bucket、获取区域列表等服务级操作。 #### 4.3 关于Bucket的操作 Bucket操作涵盖了创建Bucket、设置Bucket属性、删除Bucket等功能。 #### 4.4 关于Object的操作 Object操作包括上传、下载、复制、删除对象以及操作的高级功能，例如断点续传、生成共享链接等。 #### 4.5 关于AccessKey的操作 AccessKey是用户的身份凭证，用户可以通过创建、删除、更新和列出AccessKey来管理认证信息。 #### 4.6 Backoff说明 Backoff是一种在网络请求中遇到错误时的重试策略，用于减少网络冲突和提高请求成功率。 #### 4.7 错误响应文档描述了REST错误响应的结构和错误码列表，方便开发者诊断问题。 #### 4.8 使用HttpURLConnection开发介绍了如何使用Java标准库中的HttpURLConnection类进行OOS API的开发。 ### 5. 统计API 统计API提供了对存储和访问统计信息的查询接口，帮助用户了解资源使用情况和费用估算。 #### 5.1 统计API请求结构提供了统计API的请求格式和响应格式说明，包括公共请求头和公共响应头。 #### 5.2 统计API概览概述了统计API提供的功能和操作指南。 #### 5.3 统计API 具体介绍了统计API的调用方法和结果获取，如GetCapacity获取存储容量统计信息等。这份开发者文档为开发者提供了OOS服务的全面技术细节，使他们能够有效地开发和管理基于OOS的云存储应用。

资源推荐

资源详情

资源评论

对象存储

（Object-Oriented Storage,OOS）

开发者文档 V6

中国电信股份有限公司

云计算分公司

 
 
 
 

目录 
对象存储（OOS）...................................................................................................... 8 
1 产品介绍........................................................................................................ 8 
2 产品优势........................................................................................................ 8 
主要概念.................................................................................................................... 9 
1 OOS 主要概念................................................................................................. 9 
1.1 Account ................................................................................................. 9 
1.2 Service................................................................................................... 9 
1.3 Bucket ................................................................................................. 10 
1.4 Object .................................................................................................. 11 
1.5  通过 IPv6 访问 OOS ......................................................................... 11 
2  统计............................................................................................................... 13 
2.1  什么是统计分析................................................................................ 13 
2.2  基本概念............................................................................................ 13 
3  操作跟踪....................................................................................................... 14 
3.1  什么是操作跟踪................................................................................ 14 
3.2  基本概念............................................................................................ 14 
4  访问控制....................................................................................................... 15 
4.1  什么是 IAM ....................................................................................... 15 
4.2  基本概念............................................................................................ 15 
5 Endpoint 列表 ................................................................................................ 17 
安全策略.................................................................................................................. 19 
1 用户签名验证(V2)...................................................................................... 19 
1.1 Head 中包含签名............................................................................. 19 
1.2 使用查询参数验证.......................................................................... 25 
2 用户签名验证（V4）.................................................................................. 27 
2.1 Signature Version 4 的工作原理.............................................. 27 
2.2 认证方法.......................................................................................... 27 
2.3 使用 Authorization 请求头验证.................................................. 28 

 
 
 
 

2.4 使用查询参数验证.......................................................................... 39 
3 Bucket 权限控制......................................................................................... 45 
4 Bucket Policy 安全策略........................................................................... 46 
4.1 介绍.................................................................................................. 46 
4.2 Bucket Policy 元素....................................................................... 47 
4.3  示例.................................................................................................... 51 
HTTP REST 接口（OOS API） ............................................................................. 54 
1 接口请求/响应头........................................................................................ 54 
1.1 通用请求头...................................................................................... 54 
1.2  通用响应头........................................................................................ 54 
2 关于 Service 的操作.................................................................................. 55 
2.1 GET Service（List Bucket）...................................................... 55 
2.2 GET Regions.................................................................................... 55 
3 关于 Bucket 的操作.................................................................................... 56 
3.1 PUT Bucket...................................................................................... 56 
3.2 GET Bucket location.................................................................... 61 
3.3 GET Bucket acl.............................................................................. 63 
3.4 GET Bucket (List Objects)........................................................ 65 
3.5 DELETE Bucket................................................................................ 68 
3.6 PUT Bucket Policy........................................................................ 69 
3.7 GET Bucket Policy........................................................................ 70 
3.8 DELETE Bucket Policy.................................................................. 71 
3.9 PUT Bucket WebSite...................................................................... 72 
3.10 GET Bucket WebSite.................................................................... 74 
3.11 DELETE Bucket WebSite.............................................................. 75 
3.12 List Multipart Uploads............................................................ 76 
3.13 PUT Bucket Logging.................................................................... 82 
3.14 GET Bucket Logging.................................................................... 85 
3.15 HEAD Bucket.................................................................................. 87 

 
 
 
 

3.16 PUT Bucket Lifecycle................................................................ 87 
3.17 GET Bucket Lifecycle................................................................ 94 
3.18 DELETE Bucket Lifecycle.......................................................... 96 
3.19 PUT Bucket accelerate.............................................................. 97 
3.20 GET Bucket accelerate.............................................................. 99 
3.21 PUT Bucket CORS........................................................................ 100 
3.22 GET Bucket CORS........................................................................ 104 
3.23 DELETE Bucket CORS.................................................................. 106 
4 关于 Object 的操作.................................................................................. 107 
4.1 PUT Object.................................................................................... 107 
4.2 GET Object.................................................................................... 109 
4.3 DELETE Object.............................................................................. 112 
4.4 PUT Object - Copy...................................................................... 113 
4.5 Initial Multipart Upload........................................................ 116 
4.6 Upload Part.................................................................................. 119 
4.7 Complete Multipart Upload...................................................... 121 
4.8 Abort Multipart Upload............................................................ 124 
4.9 List Part...................................................................................... 125 
4.10 Copy Part.................................................................................... 130 
4.11 Delete Multiple Object .................................................................... 132 
4.12 断点续传...................................................................................... 135 
4.13 POST Object................................................................................ 137 
4.14 OPTIONS Object.......................................................................... 147 
4.15 生成共享链接.............................................................................. 148 
4.16 HEAD Object................................................................................ 149 
5 关于 AccessKey 的操作............................................................................ 151 
5.1 CreateAccessKey.......................................................................... 151 
5.2 DeleteAccessKey.......................................................................... 151 
5.3 UpdateAccessKey.......................................................................... 151 

 
 
 
 

5.4 ListAccessKey.............................................................................. 151 
5.5 STS 临时授权访问 ......................................................................... 151 
6 Backoff 说明............................................................................................. 153 
7 错误响应.................................................................................................... 154 
7.1 REST 错误响应 ................................................................................ 154 
7.2  错误码列表...................................................................................... 154 
8 使用 HttpURLConnection 开发................................................................ 157 
统计 API ................................................................................................................ 161 
1  统计 API 请求结构 .................................................................................... 161 
1.1  公共请求头...................................................................................... 161 
1.2  状态响应码...................................................................................... 162 
1.3  公共响应头...................................................................................... 162 
2  统计 API 概览 ............................................................................................ 163 
3  统计 API ..................................................................................................... 164 
3.1 GetCapacity....................................................................................... 164 
3.2 GetDeleteCapacity ............................................................................ 168 
3.3 GetTraffics ........................................................................................ 172 
3.4 GetRequests ...................................................................................... 178 
3.5 GetReturnCode ................................................................................. 184 
3.6 GetConcurrentConnection ................................................................ 194 
3.7 GetUsage ........................................................................................... 198 
3.8 GetBandwidth ................................................................................... 203 
4  错误码列表................................................................................................. 208 
操作跟踪 API ........................................................................................................ 209 
1  操作跟踪 API 请求结构 ............................................................................ 209 
1.1  公共请求头...................................................................................... 209 
1.2  状态响应码...................................................................................... 210 
1.3  公共响应头...................................................................................... 210 
2  操作跟踪 API 概览 .................................................................................... 211 