# 生成访问凭证信息 - CreateBucketCredential #### 功能介绍 生成桶凭证信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/Workspace/doc?api=CreateBucketCredential)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-workspace/workspace_09_0128.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | workspace:appcenter:createBucketCredential | Write | - | - | - | - obs:bucket:getBucketAcl - obs:object:putObject - obs:object:deleteObject | #### URI POST /v1/{project_id}/app-center/buckets/actions/create-credential 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | file_name | 是 | String | 文件完整名称,不允许包含如下字符:\^;\|\~\`{}\[\]\<\>。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | server_end_point | String | 访问的服务终端节点。 | | bucket_name | String | 存放的桶名称。 | | object_path | String | OBS对象路径。 注: path是对象在obs中的完整路径。 例如桶存在如下目录结构的数据。 Bucket: ├─dir1 \| ├─object1.txt \| └─object2.txt └─object3.txt Object1的path: dir1/object1.txt Object2的path: dir1/object2.txt Object3的path: object3.txt | | policy | [ObsPolicy] object | 访问策略。 | | credential | [ObsCredential] object | 对应的凭据信息。 | 表4ObsPolicy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version | String | 版本号。 | | statement | [ObsPolicyStatement] object | obs桶存放的策略内容。 | 表5ObsPolicyStatement | 参数 | 参数类型 | 描述 | |:---|:---|:---| | effect | String | 状态(正常、禁用)： - 'Allow' - 允许 - 'Deny' - 禁用 | | action | Array of strings | 可以进行操作的权限合集。 | | resource | Array of strings | 允许访问的资源。 | 表6ObsCredential | 参数 | 参数类型 | 描述 | |:---|:---|:---| | access | String | access key。 | | secret | String | secret key。 | | security_token | String | 安全校验token。 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：403** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：404** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：405** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：500** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：503** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | #### 请求示例 ``` { "file_name" : "xxx.exe" } ``` #### 响应示例 **状态码：200** 成功响应。 ``` { "server_end_point" : "obs.cn-north-xx.myhuaweicloud.com", "bucket_name" : "", "object_path" : "app-file/xxxx.exe", "policy" : { "version" : "1.1", "statement" : { "effect" : "Allow", "action" : [ "obs:object:PutObject" ], "resource" : [ "obs:*:*:object:file/xxx.exe" ] } }, "credential" : { "access" : "nvf***********390", "secret" : "nvf***********390", "security_token" : "nvf***********390" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功响应。 | | 400 | 由于包含语法错误，当前请求无法被服务器理解。 | | 401 | 鉴权失败。 | | 403 | 没有操作权限。 | | 404 | 找不到资源。 | | 405 | 请求中指定的方法不被允许。 | | 500 | 服务内部错误，具体返回错误码请参见错误码说明。 | | 503 | 服务不可用。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-workspace/ErrorCode.html)。