# 使用前必读
#### 概述
欢迎使用云空间服务（KooDrive）。KooDrive是华为云面向政企等客户推出的数据存储、访问、同步、管理和协作等功能的在线服务，是企业的一站式数字内容中枢，使能企业高效知识协作。
您可以使用本文档提供的API对云空间服务进行相关操作，如新增文件目录、获取文件详情、重命名文件等。支持的全部操作请参见[API概览](https://support.huaweicloud.com/api-koodrive/koodrive_05_0007.html)。
在调用KooDrive API之前，请确保已经充分了解KooDrive相关概念，详细信息请参见[《产品介绍》](https://support.huaweicloud.com/productdesc-koodrive/kd_01_0001.html)。
#### 调用说明
KooDrive提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见[如何调用API](https://support.huaweicloud.com/api-koodrive/koodrive_05_0008.html)。
#### 终端节点
终端节点（Endpoint）即调用API的**请求地址** ，不同服务不同区域的终端节点不同。**"华北-北京四"**区域，Endpoint为"cn.myhuaweicloud-koodrive.com"。
#### 约束与限制
调用[统计文件夹](https://support.huaweicloud.com/api-koodrive/StatsDir.html)接口前，需要了解文件的分类划分以及支持统计的格式。
表1文件类型及格式 
| 文件类型    | 支持统计的格式                                                                                                         |
|:---|:---|
| 图片      | bmp、ilbm、png、gif、jpeg、jpg、webp                                                                                  |
| 视频      | avi、mpeg、mpg、divx、xvid、rm、rmvb、mov、qt、asf、wmv、navi、vob、3gp、mp4、flv、avs、mkv、ogm、ts、tp、nsv                        |
| Word文件  | txt、rtf、doc、docx、docm、odt、dot、dotm、dotx                                                                         |
| Excel文件 | xls、xlsx、xlsm、xlsb、xml、xltx、xltm、xlt、prn、dif、slk、xlam、xla、csv、ods、sxc                                           |
| PPT文件   | ppt、pptx、pptm、potx、potm、pot、ppsx、ppsm、pps、ppam                                                                  |
| 音频      | wav、pcm、tta、flac、au、ape、mp3、wma、ogg、aac、ra、midi、mpc、pac、mv、cmf、cda、aif、aiff、m4a、mka、mp2、mpa、wv、ac3、dts、amr、3gpp |
| 压缩文件    | rar、zip、7z                                                                                                      |
| 应用      | pxl、ipa、deb、apk、sis、sisx、jar、jad、alx、cod、ota、xap、mrp、met、app、meg、vre、mor、exe                                    |
   
#### 基本概念
- 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用它进行日常管理工作。
  
- 用户 由租户管理员（也称为系统管理员），登录到KooDrive的业务面的控制中心，创建好KooDrive的用户。KooDrive用户登录业务系统后，会生成Access-Token（AT），后续的接口调用都是基于该AT进行认证和鉴权。
  
- 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。
  详情请参见[区域和可用区](https://support.huaweicloud.com/usermanual-iaas/zh-cn_topic_0184026189.html)。
  
- 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。