Appearance
异常处理
系统异常
FOS系统异常提示有如下三种方式：
| 异常方法 | 说明 |
|---|---|
| FosHttpClientError | 重试时抛出的异常 |
| last_error | 最后一次重试时抛出的异常 |
| FosClientError | FOS客户端产生的异常 |
| FosInvalidArgumentError | 传递参数产生的异常 |
| FosServerError | FOS服务器产生的异常 |
用户可以使用try获取某个事件所产生的异常：
python
from flymeyun_fos import exception
from flymeyun_fos.services import fos
try:
fos_client.delete_object(bucket_name, object_key)
except exception.FosHttpClientError as e:
print e.last_error返回为：
python
FosHttpClientError: Unable to execute HTTP request. Retried 0 times. All trace backs:
Traceback (most recent call last):
File "/home/work/python-2.7/lib/python2.7/site-packages/flymeyun_fos/http/fos_http_client.py", line 184, in send_request
if handler_function(http_response, response):
File "/home/work/python-2.7/lib/python2.7/site-packages/flymeyun_fos/http/handler.py", line 71, in parse_error raise bse
FosServerError: The specified key does not exist.客户端异常
客户端异常表示客户端尝试向FOS发送请求以及数据传输时遇到的异常。 例如，当发送请求时网络连接不可用时，则会抛出FosHttpClientError；当上传文件时发生IO异常时，也会抛出FosClientError。
服务端异常
当FOS服务端出现异常时，FOS服务端会返回给用户相应的错误信息，以便定位问题。常见服务端异常可参见FOS错误信息格式
参数异常
FOS Python SDK的每个调用都有一些类型固定不可以为空的参数，若该参数传入为空值则返回ValueError，若该参数传入类型错误则返回TypeError。 参数与调用的对应关系如下：
| FOS调用 | 参数 | 说明 | 类型 |
|---|---|---|---|
| create_bucket, does_bucket_exist, delete_bucket, get_bucket_location, get_bucket_lifecycle, delete_bucket_lifecycle, get_bucket_cors, delete_bucket_cors, get_bucket_logging, delete_bucket_logging, list_objects, list_all_objects, delete_object, get_bucket_acl, list_multipart_uploads, list_all_multipart_uploads | bucket_name | Bucket名称 | string, unicode |
| put_bucket_logging | source_bucket，target_bucket | 源Bucket和目标Bucket名称 | string, unicode |
| set_bucket_acl | bucket_name | Bucket名称 | string, unicode |
| acl | ACL主体包含被授权人及权限 | list, dict | |
| set_bucket_canned_acl | bucket_name | Bucket名称 | string, unicode |
| canned_acl | CannedAcl权限 | string | |
| put_bucket_lifecycle | bucket_name | Bucket名称 | string, unicode |
| rules | 生命周期管理规则主体，包含资源及操作动作 | list, dict | |
| put_bucket_cors | bucket_name | Bucket名称 | string, unicode |
| cors_configuration | 跨域资源共享（CORS）的规则主体，包含允许的跨域请求的来源及允许的header等 | list, dict | |
| get_object, get_object_as_string, get_object_meta_data, initiate_multipart_upload, generate_pre_signed_url | bucket_name | Bucket名称 | string, unicode |
| key | Object名称 | string | |
| get_object_to_file, put_object_from_file | bucket_name | Bucket名称 | string, unicode |
| key | Object名称 | string | |
| file_name | 文件名 | string | |
| put_object, append_object | bucket_name | Bucket名称 | string, unicode |
| key | Object名称 | string | |
| data | 流对象 | object | |
| content_length | 上传Object的大小 | int, long | |
| content_md5 | 上传Object的MD5 | string | |
| put_object_from_string，append_object_from_string | bucket_name | Bucket名称 | string, unicode |
| key | Object名称 | string | |
| data | 上传字符串 | string, unicode | |
| copy_object | source_bucket_name, target_bucket_name | 源Bucket和目标Bucket名称 | string, unicode |
| source_key, target_key | 源Object和目标Object名称 | string | |
| upload_part | bucket_name, upload_id | Bucket名称，标识MultUpload操作全局ID | string, unicode |
| key | Object名称 | string | |
| part_number | 分块编号 | int | |
| part_size | 上传分块的大小 | int, long | |
| part_fp | 上传分块对象 | object | |
| upload_part_from_file | bucket_name, upload_id | Bucket名称，标识MultUpload操作全局ID | string, unicode |
| key | Object名称 | string | |
| part_number | 分块编号 | int | |
| part_size | 上传分块的大小 | int, long | |
| file_name | 文件名 | string | |
| offset | 分块的开始偏移位置 | int | |
| complete_multipart_upload | bucket_name, upload_id | Bucket名称，标识MultUpload操作全局ID | string, unicode |
| key | Object名称 | string | |
| part_list | 分块列表 | list | |
| abort_multipart_upload, list_parts, list_all_parts | bucket_name, upload_id | Bucket名称，标识MultUpload操作全局ID | string, unicode |
| key | Object名称 | string | |
| delete_multiple_objects | bucket_name | Bucket名称 | string, unicode |
| key_list | object列表 | list |