接入地址

对象存储网络接入地址为：oos-cn-iam.ctyunapi.cn，对象存储网络2接入地址为：oos-cn2-iam.ctyunapi.cn，香港精品网和香港普通网的接入地址为oos-cnhk-iam.ctyunapi.cn。

通信协议

为了保证通信的安全性，IAM仅支持HTTPS。

请求方法

IAM支持POST请求方法发送请求。

请求参数

每个请求都需要指定如下信息：

• 要执行的操作：Action参数。
• 每个操作接口都需要包含的公共请求参数。
• 操作接口所特有的请求参数。

                    
注意
                    
请求的参数都需要url encode，服务端进行url decode。
                    
                  
                  

公共参数

                    
说明
                    
在后续提到具体IAM API时，举例中都会有公共请求头，但是不对其进行描述和解释。
                    
                  
                  

在每个请求中，都需要携带公共参数和对应的接口参数。公共请求参数如表所示：

名称
描述
是否必须
Host
IAM访问域名：
对象存储网络：oos-cn-iam.ctyunapi.cn。
对象存储网络2：oos-cn2-iam.ctyunapi.cn。	
香港精品网和香港普通网：oos-cnhk-iam.ctyunapi.cn。
是
Authorization
请求头签名。
支持V4签名认证。
类型：字符串
是
X-Amz-Date
日期和时间格式必须遵循ISO 8601标准，并且必须使用“yyyyMMddTHHmmssZ”格式进行格式化。例如，如果日期和时间是“08/01/2018 15：32：41.982-700”，则必须首先将其转换为UTC（协调世界时），然后提交为“20180801T083241Z”。
是
Content-Type
请求内容类型。
类型：字符串
取值：application/octet-stream。
是
Connection
客户端与OOS服务器之间的连接状态。
取值：
keep-alive：长连接，请求结束后继续保持连接。
close：短连接，请求结束后关闭连接。
默认值为：keep-alive。
否

响应结果

                    
说明
                    
调用IAM API后返回数据采用统一格式，响应结果格式为XML格式。本文档中的响应示例为了便于用户查看，做了格式化处理，实际返回结果是没有进行换行、缩进等处理的。
                    
                  
                  

公共响应头

                    
说明
                    
在后续提到具体IAM API时，举例中都会有公共响应头，但是不对其进行描述和解释。
                    
                  
                  

每个IAM API响应结果中都会包含公共响应头。公共响应头如下：

名称
描述
x-amz-request-id
服务端生成的用于标识请求的ID。
Content-Type
响应内容类型。
Date
响应日期。
Server
服务器名。
Content-Length
响应体的长度，单位为Byte。
Connection
客户端与OOS服务器之间的连接状态。
如果请求时Connection值为keep-alive，请求结束后继续保持连接，不返回此响应头。
如果请求时Connection值为close，请求结束后关闭连接，返回此响应头Connection: close。

成功响应结果

调用IAM API成功后，如果响应结果HTTP状态为：200 OK，代表IAM API调用成功。示例如下：

HTTP/1.1 200 OK
<公共响应头>
 
具体响应结果>
<公共响应参数>

失败响应结果

调用IAM API失败后，如果响应结果HTTP状态为：4xx或者5xx，代表调用失败。示例如下：

HTTP/1.1 4xx或者5xx
<公共响应头>
 
具体响应结果>
<公共响应参数>

字符编码

请求及返回结果都使用UTF-8字符集进行编码。