本节介绍ＲＥＳＴ ＡＰＩ请求的组成，并以调用ＩＡＭ服务的管理员创建ＩＡＭ用户来说明如何调用ＡＰＩ，该ＡＰＩ获取用户的Ｔｏｋｅｎ，Ｔｏｋｅｎ可以用于调用其他ＡＰＩ时鉴权。
您还可以通过这个视频教程了解如何构造请求调用ＡＰＩ：ｈｔｔｐｓ：／／ｂｂｓ．ｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ／ｖｉｄｅｏｓ／１０２９８７。
请求ＵＲＩ
请求ＵＲＩ由如下部分组成：
｛ＵＲＩ－ｓｃｈｅｍｅ｝：／／｛Ｅｎｄｐｏｉｎｔ｝／｛ｒｅｓｏｕｒｃｅ－ｐａｔｈ｝？｛ｑｕｅｒｙ－ｓｔｒｉｎｇ｝
尽管请求ＵＲＩ包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。
表１ ＵＲＩ中的参数说明
参数
描述
ＵＲＩ－ｓｃｈｅｍｅ
表示用于传输请求的协议，当前所有ＡＰＩ均采用ＨＴＴＰＳ协议。
Ｅｎｄｐｏｉｎｔ
指定承载ＲＥＳＴ服务端点的服务器域名或ＩＰ，不同服务不同区域的Ｅｎｄｐｏｉｎｔ不同，您可以从地区和终端节点获取。
例如ＩＡＭ服务在“华北－北京四”区域的Ｅｎｄｐｏｉｎｔ为“ｉａｍ．ｃｎ－ｎｏｒｔｈ－４．ｍｙｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ”。
ｒｅｓｏｕｒｃｅ－ｐａｔｈ
资源路径，即ＡＰＩ访问路径。从具体ＡＰＩ的ＵＲＩ模块获取，例如“获取用户Ｔｏｋｅｎ”ＡＰＩ的ｒｅｓｏｕｒｃｅ－ｐａｔｈ为“／ｖ３／ａｕｔｈ／ｔｏｋｅｎｓ”。
ｑｕｅｒｙ－ｓｔｒｉｎｇ
查询参数，是可选部分，并不是每个ＡＰＩ都有查询参数。查询参数前面需要带一个“？”，形式为“参数名＝参数取值”，例如“？ｌｉｍｉｔ＝１０”，表示查询不超过１０条数据。
例如您需要获取ＩＡＭ在“华北－北京四”区域的Ｔｏｋｅｎ，则需使用“华北－北京四”区域的Ｅｎｄｐｏｉｎｔ（ｉａｍ．ｃｎ－ｎｏｒｔｈ－４．ｍｙｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ），并在管理员创建ＩＡＭ用户的ＵＲＩ部分找到ｒｅｓｏｕｒｃｅ－ｐａｔｈ（／ｖ３．０／ＯＳ－ＵＳＥＲ／ｕｓｅｒｓ），拼接起来如下所示。
ｈｔｔｐｓ：／／ｉａｍ．ｃｎ－ｎｏｒｔｈ－４．ｍｙｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ／ｖ３．０／ＯＳ－ＵＳＥＲ／ｕｓｅｒｓ
图１ ＵＲＩ示意图
说明：
为方便查看，在每个具体ＡＰＩ的ＵＲＩ部分，只给出ｒｅｓｏｕｒｃｅ－ｐａｔｈ部分，并将请求方法写在一起。这是因为ＵＲＩ－ｓｃｈｅｍｅ都是ＨＴＴＰＳ，而Ｅｎｄｐｏｉｎｔ在同一个区域也相同，所以简洁起见将这两部分省略。
请求方法
ＨＴＴＰ请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。
表２ ＨＴＴＰ方法
方法
说明
ＧＥＴ
请求服务器返回指定资源。
ＰＵＴ
请求服务器更新指定资源。
ＰＯＳＴ
请求服务器新增资源或执行特殊操作。
ＤＥＬＥＴＥ
请求服务器删除指定资源，如删除对象等。
ＨＥＡＤ
请求服务器资源头部。
ＰＡＴＣＨ
请求服务器更新资源的部分内容。
当资源不存在的时候，ＰＡＴＣＨ可能会去创建一个新的资源。
在管理员创建ＩＡＭ用户的ＵＲＩ部分，您可以看到其请求方法为“ＰＯＳＴ”，则其请求为：
ＰＯＳＴ ｈｔｔｐｓ：／／ｉａｍ．ｃｎ－ｎｏｒｔｈ－１．ｍｙｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ／ｖ３．０／ＯＳ－ＵＳＥＲ／ｕｓｅｒｓ
请求消息头
附加请求头字段，如指定的ＵＲＩ和ＨＴＴＰ方法所要求的字段。例如定义消息体类型的请求头“Ｃｏｎｔｅｎｔ－Ｔｙｐｅ”，请求鉴权信息等。
详细的公共请求消息头字段请参见表３。
表３ 公共请求消息头
名称
描述
是否必选
示例
Ｈｏｓｔ
请求的服务器信息，从服务ＡＰＩ的ＵＲＬ中获取。值为ｈｏｓｔｎａｍｅ［：ｐｏｒｔ］。端口缺省时使用默认的端口，ｈｔｔｐｓ的默认端口为４４３。
否
使用ＡＫ／ＳＫ认证时该字段必选。
ｃｏｄｅ．ｔｅｓｔ．ｃｏｍ
ｏｒ
ｃｏｄｅ．ｔｅｓｔ．ｃｏｍ：４４３
Ｃｏｎｔｅｎｔ－Ｔｙｐｅ
消息体的类型（格式）。推荐用户使用默认值ａｐｐｌｉｃａｔｉｏｎ／ｊｓｏｎ，有其他取值时会在具体接口中专门说明。
是
ａｐｐｌｉｃａｔｉｏｎ／ｊｓｏｎ
Ｃｏｎｔｅｎｔ－Ｌｅｎｇｔｈ
请求ｂｏｄｙ长度，单位为Ｂｙｔｅ。
否
３４９５
Ｘ－Ｐｒｏｊｅｃｔ－Ｉｄ
ｐｒｏｊｅｃｔ ｉｄ，项目编号。请参考获取项目ＩＤ章节获取项目编号。
否
如果是专属云场景采用ＡＫ／ＳＫ认证方式的接口请求，或者多ｐｒｏｊｅｃｔ场景采用ＡＫ／ＳＫ认证的接口请求，则该字段必选。
ｅ９９９３ｆｃ７８７ｄ９４ｂ６ｃ８８６ｃｂａａ３４０ｆ９ｃ０ｆ４
Ｘ－Ａｕｔｈ－Ｔｏｋｅｎ
用户Ｔｏｋｅｎ。
用户Ｔｏｋｅｎ也就是调用获取用户Ｔｏｋｅｎ接口的响应值，该接口是不需要认证的接口。
请求响应成功后在响应消息头（Ｈｅａｄｅｒｓ）中包含的“Ｘ－Ｓｕｂｊｅｃｔ－Ｔｏｋｅｎ”的值即为Ｔｏｋｅｎ值。
否
使用Ｔｏｋｅｎ认证时该字段必选。
注：以下仅为Ｔｏｋｅｎ示例片段。
ＭＩＩＰＡｇＹＪＫｏＺＩｈｖｃＮＡＱｃＣｏ．．．ｇｇｇ１ＢＢＩＩＮＰＸｓｉｄＧ９ｒＺ
说明：
ＡＰＩ同时支持使用ＡＫ／ＳＫ认证，ＡＫ／ＳＫ认证使用ＳＤＫ对请求进行签名，签名过程会自动往请求中添加Ａｕｔｈｏｒｉｚａｔｉｏｎ（签名认证信息）和Ｘ－Ｓｄｋ－Ｄａｔｅ（请求发送的时间）请求头。
ＡＫ／ＳＫ认证的详细说明请参见认证鉴权的“ＡＫ／ＳＫ认证”。
对于管理员创建ＩＡＭ用户接口，使用ＡＫ／ＳＫ方式认证时，添加消息头后的请求如下所示。
ＰＯＳＴ ｈｔｔｐｓ：／／ｉａｍ．ｃｎ－ｎｏｒｔｈ－１．ｍｙｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ／ｖ３．０／ＯＳ－ＵＳＥＲ／ｕｓｅｒｓ
Ｃｏｎｔｅｎｔ－Ｔｙｐｅ： ａｐｐｌｉｃａｔｉｏｎ／ｊｓｏｎ
Ｘ－Ｓｄｋ－Ｄａｔｅ： ２０２４０４１６Ｔ０９５３４１Ｚ
Ａｕｔｈｏｒｉｚａｔｉｏｎ： ＳＤＫ－ＨＭＡＣ－ＳＨＡ２５６ Ａｃｃｅｓｓ＝＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊， ＳｉｇｎｅｄＨｅａｄｅｒｓ＝ｃｏｎｔｅｎｔ－ｔｙｐｅ；ｈｏｓｔ；ｘ－ｓｄｋ－ｄａｔｅ， Ｓｉｇｎａｔｕｒｅ＝＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊
请求消息体（可选）
该部分可选。请求消息体通常以结构化格式（如ＪＳＯＮ或ＸＭＬ）发出，与请求消息头中Ｃｏｎｔｅｎｔ－Ｔｙｐｅ对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为ＵＴＦ－８编码。
每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），ＧＥＴ、ＤＥＬＥＴＥ操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。
对于管理员创建ＩＡＭ用户接口，您可以从接口的请求部分看到所需的请求参数及参数说明，将消息体加入后的请求如下所示，其中加粗的字段需要根据实际值填写。
ａｃｃｏｕｎｔｉｄ为ＩＡＭ用户所属的账号ＩＤ。
ｕｓｅｒｎａｍｅ为要创建的ＩＡＭ用户名。
ｅｍａｉｌ为ＩＡＭ用户的邮箱。
＊＊＊＊＊＊＊＊＊＊为ＩＡＭ用户的登录密码。
ＰＯＳＴ ｈｔｔｐｓ：／／ｉａｍ．ｃｎ－ｎｏｒｔｈ－４．ｍｙｈｕａｗｅｉｃｌｏｕｄ．ｃｏｍ／ｖ３．０／ＯＳ－ＵＳＥＲ／ｕｓｅｒｓ
Ｃｏｎｔｅｎｔ－Ｔｙｐｅ： ａｐｐｌｉｃａｔｉｏｎ／ｊｓｏｎ
Ｘ－Ｓｄｋ－Ｄａｔｅ： ２０２４０４１６Ｔ０９５３４１Ｚ
Ａｕｔｈｏｒｉｚａｔｉｏｎ： ＳＤＫ－ＨＭＡＣ－ＳＨＡ２５６ Ａｃｃｅｓｓ＝＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊， ＳｉｇｎｅｄＨｅａｄｅｒｓ＝ｃｏｎｔｅｎｔ－ｔｙｐｅ；ｈｏｓｔ；ｘ－ｓｄｋ－ｄａｔｅ， Ｓｉｇｎａｔｕｒｅ＝＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊
｛
＂ｕｓｅｒ＂： ｛
＂ｄｏｍａｉｎ＿ｉｄ＂： ＂ａｃｃｏｕｎｔｉｄ＂，
＂ｎａｍｅ＂： ＂ｕｓｅｒｎａｍｅ＂，
＂ｐａｓｓｗｏｒｄ＂： ＂＊＊＊＊＊＊＊＊＊＊＂，
＂ｅｍａｉｌ＂： ＂ｅｍａｉｌ＂，
＂ｄｅｓｃｒｉｐｔｉｏｎ＂： ＂ＩＡＭ Ｕｓｅｒ Ｄｅｓｃｒｉｐｔｉｏｎ＂
｝
｝
到这里为止这个请求需要的内容就具备齐全了，您可以使用ｃｕｒｌ、Ｐｏｓｔｍａｎ或直接编写代码等方式发送请求调用ＡＰＩ。对于获取用户Ｔｏｋｅｎ接口，返回的响应消息头中的“Ｘ－Ｓｕｂｊｅｃｔ－Ｔｏｋｅｎ”就是需要获取的用户Ｔｏｋｅｎ。有了Ｔｏｋｅｎ之后，您就可以使用Ｔｏｋｅｎ认证调用其他ＡＰＩ。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱）[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]
