云社区 > 云博客 > 博客详情
云社区 > 云博客 > 博客详情

如何使用华为云的API

伊涅斯塔Yang 发表于 2017-11-21 10:44:5211-21 10:44
伊涅斯塔Yang 发表于 2017-11-21 10:44:5211-21 10:44
0
1

【摘要】 华为云API符合RESTful API的设计理论。 REST从资源的角度来观察整个网络,分布在各处的资源由URI(Uniform Resource Identifier)确定,而客户端的应用通过URL(Unified Resource Locator)来获取资源。


华为云API符合RESTful API的设计理论。

REST从资源的角度来观察整个网络,分布在各处的资源由URIUniform Resource Identifier)确定,而客户端的应用通过URLUnified Resource Locator)来获取资源。

 

调用接口的格式:

URL的一般格式为:https://Endpoint/uri

URL中的参数说明如1-1所示。

1-1 URL中的参数说明

参数

描述

Endpoint

Web服务入口点的URL,从地区和终端节点中获取。

uri

资源路径,也即API访问路径。从具体接口的URI模块获取,例如“v3/auth/tokens”。

地区和终端节点的连接地址:http://developer.huaweicloud.com/endpoint.html

 

HTTP协议中,请求可以使用多种请求方法例如GET PUT POST DELETEPATCH,用于指明以何种方式来访问指定的资源,目前提供的REST接口支持的请求方法如下表1-2所示。

调用接口的方法

1-2请求方法一览表

方法

说明

GET

请求服务器返回指定资源。

PUT

请求服务器更新指定资源。

POST

请求服务器新增资源或执行特殊操作。

DELETE

请求服务器删除指定资源,如删除对象等。

PATCH

请求服务器更新资源的部分内容。

当资源不存在的时候,PATCH可能会去创建一个新的资源。

 

调用接口的认证方式

·         调用接口有如下两种认证方式,您可以任选其中一种进行认证鉴权。

·         Token认证:通过Token认证调用请求。

·         AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。

 

本文主要介绍,如何使用postman通过token认证的方式调用华为云的API

1、发送“POST https://IAMEndpoint/v3/auth/tokens”,获取IAMEndpoint及消息体中的区域名称。

请参考地区和终端节点

当服务区域名称为“所有”时,选择“中国华北区1”的Endpoint

请求内容示例如下:

下面示例代码中的红色字需要替换为实际内容

{

  "auth": {

    "identity": {

      "methods": [

        "password"

      ],

      "password": {

        "user": {

          "name": "username",

          "password": "password",

          "domain": {

            "name": "domainname"

          }

        }

      }

    },

    "scope": {

      "project": {

        "id": "0215ef11e49d4743be23dd97a1561e91" //假设id"0215ef11e49d4743be23dd97a1561e91"      

      }

    }

  }

}

2、请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

3、调用业务接口,在请求消息头中增加“X-Auth-Token”,“X-Auth-Token”的取值为2中获取的Token

 

在调用接口的时候,部分URL中需要填入项目编号(project_id或者tenant_id,本文中project_idtenant_id含义一样),所以需要先在管理控制台上获取到项目编号。项目编号获取步骤如下:

注册并登录管理控制台。

单击用户名,在下拉列表中单击“我的凭证”。

在“我的凭证”页面的项目列表中查看项目ID

zh-cn_image_0074387737.jpg


注:选择的项目ID与所属区域一定要对应的上,例如选择华南区IAMendpoint获取token,那项目ID也要选择华南区对应的项目ID

 

使用postman请求调用API示例(以华南区举例)如下:

一、   获取token

在地区和终端节点上,选择对应的区域以及终端节点,本例以华南区为例

获取tokenurlhttps://iam.cn-south-1.myhwclouds.com/v3/auth/tokens

1.jpg


二、   调用服务API

可以参考服务的API文档调用API,以调用网络接口查询router为例

url https://vpc.cn-south-1.myhwclouds.com/v2.0/routers

将第一步获取的token填入headerX-Auth-Token对应的value

2.png

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区),文章链接,文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件至:huaweicloud.bbs@huawei.com进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容。

分享文章到微博
分享文章到朋友圈

相关文章


评论(0)


0/1000
评论

登录后可评论,请 登录注册

评论
温馨提示

您确认删除评论吗?

确定
取消
温馨提示

您确认删除评论吗?

删除操作无法恢复,请谨慎操作。

确定
取消
温馨提示

您确认删除博客吗?

确定
取消

确认删除

您确认删除博客吗?

确认删除

您确认删除评论吗?

温馨提示

登录超时或用户已下线,请重新登录!!!

确定
取消