华为云用户手册

状态行 状态行格式如下： HTTP-Version Status-Code Reason-Phrase CRLF HTTP-Version：表示服务器HTTP协议的版本号。 Status-Code：表示服务器发回的响应状态代码。 状态代码由三位数字组成，第一个数字定义了响应的类别，且有五种可能取值： 1xx：指示信息，表示请求已接收，继续处理。 2xx：成功，表示请求已被成功接收、理解、接受。 3xx：重定向，要完成请求必须进行更进一步的操作。 4xx：客户端错误，请求有语法错误或请求无法实现。 5xx：服务器端错误，服务器未能实现合法的请求。 Reason-Phrase：表示状态代码的文本描述。

调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为 IAM 的终端节点，可以从地区和终端节点获取。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "cn-north-4", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：自定义策略中授权项定义的内容即为权限。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见IAM与企业管理的区别。 APM 支持自定义策略授权项如下所示： APM授权项：包括所有APM相关接口对应的授权项，例如查询应用列表、服务列表、服务实例列表、服务事务列表、调用链、调用链详情接口。

响应消息 表4 响应参数 参数 参数类型 描述 errorCode string 响应错误码 SV CS TG.ATS.2000：查询成功 SVCSTG.ATS.400101：参数校验失败 SVCSTG.ATS.200103：没有查询到服务信息 errorMessage string 响应错误信息描述 responseInfo list(string) 服务名称列表 响应示例 { "errorCode": "SVCSTG.ATS.2000", "errorMessage":null, "responseInfo": ["ams-calc:8080","ams-metric:8080"]}

状态码 状态码如表1 状态码所示 表1 状态码 状态码 编码 状态码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200 OK 请求响应成功。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。 父主题： 附录

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 200 SVCSTG.ATPS.2000 null - - 200 SVCSTG.ATS.2000 null - - 400 SVCSTG.ATS.400101 projectId in url is invalid. url中的projectId无效。 请检查对应的参数是否符合要求。 400 SVCSTG.ATS.200103 query trace result is empty. 查询调用链结果为空。 请检查对应的参数是否符合要求。

公共请求消息头 表1 公共请求消息头 名称 描述 是否必选 示例 X-Auth-Token 用户Token。 使用Token认证时必选 - Content-Type 内容类型。 该字段内容填为“application/json;charset=utf8”。 必选 application/json;charset=utf8 x-sdk-date 请求的发生时间 格式为(YYYYMMDD'T'HHMMSS'Z')。取值为当前系统的GMT时间 使用AK/SK认证时必选 20160629T101459Z Authorization 签名认证信息 该值来源于请求签名结果。 使用AK/SK认证时必选 - Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443 使用AK/SK认证时必选 - 父主题： 附录

示例 本节以查询服务列表为例，详细描述接口调用的流程。该示例中的实例是在已部署的SpringCloudDemo服务上，实现调用查询服务列表接口的过程。Spring Cloud是一个基于Spring Boot实现的微服务架构开发工具。它为微服务架构中涉及的配置管理、服务治理、断路器、智能路由、微代理、控制总线、全局锁、决策竞选、分布式会话和集群状态管理等操作提供了简单的方式。 实现查询服务列表接口调用流程如下： 首先， 获取Token 认证，因为在后续的请求中需要将token放到请求消息头中作为认证； 其次，构造调用查询服务列表接口的请求消息，构造完成并发起请求； 最后，查看获取到响应消息，分析调用查询服务列表接口是否成功。 前提准备： 服务器已部署的SpringCloudDemo应用； 已获取IAM和APM的Endpoint；此例中IAM的Endpoint以iam_Endpoint代替，APM的Endpoint以apm_Endpoint代替。 获取Token认证 发送“POST https://IAM的Endpoint/v3/auth/tokens”，此处IAM的Endpoint以iam_Endpoint代替，POST https://iam_Endpoint/v3/auth/tokens。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 请求内容示例如下： { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username",//username为用户名，请根据实际情况替换。 "password": "password",//password为用户密码，请根据实际情况替换。 "domain": { "name": "domainname"//domainname为 域名 ，请根据实际情况替换。 } } } }, "scope": { "project": { "name": "cn-north-1" //cn-north-1为IAM区域，请根据实际情况替换。 } } }} 构造请求消息并发送 每一个请求通常由三部分组成，分别是：请求行、请求消息头、请求正文(可选)。请求消息构造完成之后，发送该消息等待响应。 请求行 GET https://Endpoint/v1/{project_id}/ats/applications Endpoint 为APM的Endpoint，此处以apm_Endpoint代替。 {project_id}为路径参数 参数 参数类型 描述 project_id string 工程ID 用户Token认证过程中，请求响应成功后在响应消息体中包含{project_id}值，"id":"12ff18574dfe4b92......"。 请求行内容为： https://apm_Endpoint/v1/12ff18574dfe4b92....../ats/applications?monitorGroup=SpringCloudDemo 请求消息头 X-Auth-Token，此值即为在用户Token认证中得到的“X-Subject-Token”的值， X-Auth-Token：MIIRpQYJKoZIhvcNAQcCoIIRljCCEZICAQExDTALBglghkgBZQMEAgEwgg-zBgkqhkiG9w0BBwGggg...... Content-Type：application/json;charset=utf8 请求正文（此例不选） 响应消息 请求消息发送成功，得到响应消息。 响应结果： { "errorCode": "SVCSTG.ATS.2000", "errorMessage": null, "responseInfo": [ "spring-cloud-service-eureka-server", "spring-cloud-testservice-consumer", "spring-cloud-testservice-provider", "springboot1.2", "springboot1.3.8", "springboot1.4.7", "springboot1.5.13" ]} 响应结果由errorCode（响应错误码）、errorMessage（响应错误信息描述）、responseInfo（响应详情）这三个参数组成。 responseInfo参数中的内容为查询到SpringCloudDemo应用中的所有服务。 父主题： 接口使用方法

方法列表 返回类型 方法和说明 static KafkaConfig getConfig(String servers, String groupId) 获取一个配置，用于访问MQS提供的Kafka（不开启sasl_ssl）。 static KafkaConfig getSaslConfig(String servers, String groupId, String username, String password) 获取一个配置，用于访问MQS提供的Kafka（开启sasl_ssl）。

请求行 请求行以一个方法符号开头，以空格分开，后面跟着请求的URI和协议的版本，格式如下： Method Request-URI HTTP-Version CRLF Method：表示请求方法（所有方法全为大写），各个方法的解释如下： GET：请求获取Request-URI所标识的资源。 POST：在Request-URI所标识的资源后附加新的数据。 PUT：请求服务器存储一个资源，并用Request-URI作为其标识。 DELETE：请求服务器删除Request-URI所标识的资源。 PATCH：请求服务器更新资源的部分内容，当资源不存在的时候，PATCH可能会去创建一个新的资源。 Request-URI：是一个统一资源标识符。 可以在URI后面用‘?’和‘&’添加不同的查询条件组合。URI中“{}”中包含的内容为URI的参数，其中“?”之前的部分是路径参数，之后的部分是查询参数。 HTTP-Version：表示请求的HTTP协议版本。 CRLF：表示回车和换行（除了作为结尾的CRLF外，不允许出现单独的CR或LF字符）。

方法详情 public static KafkaConfig getConfig(String servers, String groupId) 访问MQS提供的kafka（不开启sasl_ssl）。 输入参数 servers：kafkaConfig中的bootstrap.servers信息 groupId：kafkaConfig中的group.id信息 返回信息 返回KafkaConfig对象 public static KafkaConfig getSaslConfig(String servers, String groupId, String username, String password) 访问MQS提供的kafka（开启sasl_ssl）。 输入参数 servers：kafkaConfig中的bootstrap.servers信息 groupId：kafkaConfig中的group.id信息 username：用户名 password：密码 返回信息 返回KafkaConfig对象

使用示例 importClass(com.roma.apic.livedata.client.v1.SapRfcClient);importClass(com.roma.apic.livedata.config.v1.SapRfcConfig);function execute(data) { var config = new SapRfcConfig(); config.put("jco.client.ashost", "10.95.152.107");//服务器 config.put("jco.client.sysnr", "00"); //实例编号 config.put("jco.client.client", "400"); //SAP集团 config.put("jco.client.user", "SAPIDES");//SAP用户名 config.put("jco.client.passwd", "****");//密码 config.put("jco.client.lang", "zh");//登录语言 config.put("jco.destination.pool_capacity", "3");//最大连接数 config.put("jco.destination.peak_limit", "10");//最大连接线程 var client = new SapRfcClient(config); var res = client.executeFunction("FUNCTION1", { "A":"200", "B":"2", }) return res}

方法详情 public static String getPlainCipherText(String key) 解密密码箱中普通密码的key值 输入参数 key：普通密码的key值 返回信息 返回解密后的密码 public static Response getPlainCertificate(String key) 解密密码箱中证书密码的key值 输入参数 key：证书密码的key值 返回信息 返回解密后的证书密码消息体，消息体如下格式： {"cipherType": "CERTIFICATE","passphrase": "xxx","privateKey": "xx","privateKey": "xx",}

使用示例 importClass(com.roma.apic.livedata.client.v1.HttpClient);importClass(com.roma.apic.livedata.config.v1.HttpConfig);function execute(data) { var requestConfig = new HttpConfig(); requestConfig.setAccessKey("071fe245-9cf6-4d75-822d-c29945a1e06a"); requestConfig.setSecretKey("c6e52419-2270-****-****-ae7fdd01dcd5"); requestConfig.setMethod('POST'); requestConfig.setUrl("https://30030113-3657-4fb6-a7ef-90764239b038.apigw.exampleRegion.com/app1"); requestConfig.setContent("body"); requestConfig.setContentType('application/json'); var client = new HttpClient(); var resp = client.request(requestConfig); return resp.body().string()}

操作流程 获取MQS连接信息，具体请参考开发准备。 若ROMA Connect实例的消息集成在开启SASL_SSL的同时，也开启了VPC内网明文访问，则VPC内无法使用SASL方式连接消息集成的Topic。 使用SASL方式连接消息集成的Topic时，建议在客户端所在主机的“/etc/hosts”文件中配置host和IP的映射关系，否则会引入时延。 其中，IP地址必须为消息集成的连接地址，host为每个实例主机的名称，可以自定义，但不能重复。例如： 10.10.10.11 host01 10.10.10.12 host02 10.10.10.13 host03 参考示例代码，组装API请求，包括对API请求的签名。 对API请求签名，指使用SASL的用户名与密码作为密钥对，将请求URL、消息头时间戳等内容进行签名，供后端服务进行校验。点此了解签名流程 使用Demo向指定Topic生产消息、消费消息和确认消息时，返回的响应消息结构请参考生产消息接口说明、消费消息接口说明和消费确认接口说明。

导入工程 打开IntelliJ IDEA，在菜单栏选择“Import Project”。 弹出“Select File or Directory to Import”对话框。 在弹出的对话框中选择解压后的RESTful API Java Demo路径，单击“OK”。 “Import project from external model”选择“Eclipse”，单击“Next”，进入下一页后保持默认连续单击“Next”，直到“Please select project SDK”页面。 图1 Import Project 单击“Finish”，完成工程导入。 图2 Finish 编辑rest-config.properties 文件在src/main/resources目录下。将获取到的MQS实例连接地址、Topic名称，以及SASL信息填写到下述配置中。其中参数kafka.rest.group为消费组ID，可在客户端指定。 # Kafka rest endpoint.kafka.rest.endpoint=https://{MQS_Instance_IP_Addr}:9292# Kafka topic name.kafka.rest.topic=topic_name_demo# Kafka consume group.kafka.rest.group=group_id_demo# Kafka sasl username.kafka.rest.username=sasl_username_demo# Kafka sasl password.kafka.rest.password=sasl_user_passwd_demo 编辑log4j.properties 修改日志存储目录： log.directory=D://workspace/logs 运行示例工程，查看消息生产与消费样例。 消息生成与消费的Main方法在RestMain.java中，以Java Application的方式运行即可。

请求消息 请求参数 参数 类型 必选 说明 messages Array 是 消息列表，数组大小不能超过10，且不能为空数组。 表2 参数说明 参数 类型 必选 说明 handler String 是 消息handler。 status String 是 消费状态。只能为success，或者fail。 请求示例 { "messages": [ { "handler": "NCMxMDAjMTgjMA==", "status": "success" } ]}

使用前必读 物联网平台 作为消息接收方时，已默认订阅了相关Topic，设备只要向对应Topic发送消息，物联网平台就可以接收。 设备作为消息接收方时，需要先订阅相关Topic，这样物联网平台向对应Topic发送消息时，设备才能接收到。设备需要根据具体实现的业务来决定订阅哪些Topic。 Topic 支持的协议 消息发送方 （Publisher） 消息接收方 (Subscriber) 用途 /v1/devices/{gatewayId}/topo/add MQTT 边设备 物联网平台 边设备添加子设备 /v1/devices/{gatewayId}/topo/addResponse 物联网平台 边设备 物联网平台返回的添加子设备的响应 /v1/devices/{gatewayId}/topo/update 边设备 物联网平台 边设备更新子设备状态 /v1/devices/{gatewayId}/topo/updateResponse 物联网平台 边设备 物联网平台返回的更新子设备状态的响应 /v1/devices/{gatewayId}/topo/delete 物联网平台 边设备 物联网平台删除子设备 /v1/devices/{gatewayId}/topo/query 边设备 物联网平台 边设备查询网关信息 /v1/devices/{gatewayId}/topo/queryResponse 物联网平台 边设备 物联网平台返回的网关信息响应 /v1/devices/{gatewayId}/command 物联网平台 边设备 物联网平台给设备或边设备下发命令 /v1/devices/{gatewayId}/commandResponse 边设备 物联网平台 边设备返回给物联网平台的命令响应 /v1/devices/{gatewayId}/datas 边设备 物联网平台 边设备上报数据 {gatewayId}指设备标识。其中delete沿用了之前局点的规范，deleteResponse暂未提供。 父主题： MQTT协议Topic规范

示例 { "body": { "orginParameters": { "temperature": 123 }, "state": "ok" }, "errcode": 0, "mid": 54132, "msgType": "deviceRsp"}

前提条件 已获取API的调用信息，具体请参见开发准备。 已安装开发工具和PHP开发语言环境，具体请参见开发准备。 将PHP安装目录中的“php.ini-production”文件复制到“C:\windows”，改名为“php.ini”，并在文件中增加如下内容。 extension_dir = "php安装目录/ext"extension=opensslextension=curl 已在IntelliJ IDEA中安装PHP插件，如果未安装，请按照图1所示安装。 图1 安装PHP插件

方法列表 返回类型 方法和说明 static java.lang.String decode(java.lang.String content) 对字符串进行Base64解码 static java.lang.String decodeUrlSafe(java.lang.String content) 对字符串进行Base64解码（使用url兼容的字符集） static java.lang.String encode(byte[] content) 对字符数组进行Base64编码 static java.lang.String encode(java.lang.String content) 对字符串进行Base64编码 static java.lang.String encodeUrlSafe(byte[] content) 对字符数组进行Base64编码（使用url兼容的字符集） static java.lang.String encodeUrlSafe(java.lang.String content) 对字符串进行Base64编码（使用url兼容的字符集）

方法详情 public static java.lang.String decode(java.lang.String content) 对字符串进行Base64解密 输入参数 content：Base64加密后的字符串 返回信息 返回解密后的字符串 public static java.lang.String decodeUrlSafe(java.lang.String content) 对字符数组进行Base64解密（使用url兼容的字符集） 输入参数 content：Base64加密后的字符串 返回信息 返回解密后的字符串 public static java.lang.String encode(byte[] content) 对字符数组进行Base64加密 输入参数 content：待加密的字符数组 返回信息 返回加密后的字符串 public static java.lang.String encode(java.lang.String content) 对字符串进行Base64加密 输入参数 content：待加密的字符串 返回信息 返回加密后的字符串 public static java.lang.String encodeUrlSafe(byte[] content) 对字符数组进行Base64加密（使用url兼容的字符集） 输入参数 content：待加密的字符数组 返回信息 返回加密后的字符串 public static java.lang.String encodeUrlSafe(java.lang.String content) 对字符串进行Base64加密（使用url兼容的字符集） 输入参数 content：待加密的字符串 返回信息 返回加密后的字符串

使用示例 Base64编码示例： importClass(com.roma.apic.livedata.common.v1.Base64Utils);function execute(data) { var sourceCode = "Hello world!"; return Base64Utils.encode(sourceCode);} multipart-formdata上传文件示例： importClass(com.roma.apic.livedata.common.v1.Base64Utils);function execute(data) { var image = data.body.get("image") return { size: image.getSize(), name: image.getFileItem().getName(), base64: Base64Utils.encode(image.getFileItem().get()) }}

导入工程 打开IntelliJ IDEA，在菜单栏选择“Import Project”。 弹出“Select File or Directory to Import”对话框。 在弹出的对话框中选择解压后的SDK路径，单击“OK”。 “Import project from external model”选择“Eclipse”，单击“Next”，进入下一页后保持默认连续单击“Next”，直到“Please select project SDK”页面。 图2 Import Project 单击“Finish”，完成工程导入。 图3 Finish 完成导入后，目录结构如下图。 图4 目录结构

前提条件 准备装有1.8及以上版本JDK的Linux服务器。 IntelliJ IDEA版本为：2018.3.5或以上版本，Eclipse版本为：3.6.0或以上版本。 通过Demo（sha256:34c9bc8d99eba4ed193603019ce2b69afa3ed760a452231ece3c89fd7dd74da1）获取MysqlConnctor.rar包。 如果使用自定义连接器来写数据，需要用户自行保证数据的可重复幂等写入。 RESTful接口单次请求的处理时间不能超过60s。 FDI端会循环调用RESTful接口地址，直到读完数据为止。

使用示例 加密示例 importClass(com.roma.apic.livedata.common.v1.AesUtils);function execute(data) { var plainText = "plainText"; //加解密用的密钥硬编码到代码中有较大的安全风险，建议在配置文件中存放，本示例以在自定义后端的配置管理中配置的secretKey为例进行说明 var secretKey = "#{secretKey}"; var initialVector = "initialVector"; var encryptText = AesUtils.encrypt(plainText, secretKey, initialVector, AesUtils.KEYLENGTH.KL_128, AesUtils.MODE.GCM, AesUtils.PAD.NOPADDING); return encryptText} 解密示例 importClass(com.roma.apic.livedata.common.v1.AesUtils);function execute(data) { var encryptText = "encryptText"; //加解密用的密钥硬编码到代码中有较大的安全风险，建议在配置文件中存放，本示例以在自定义后端的配置管理中配置的secretKey为例进行说明 var secretKey = "#{secretKey}"; var initialVector = "initialVector"; var decryptText = AesUtils.decrypt(encryptText, secretKey, initialVector, AesUtils.KEYLENGTH.KL_128, AesUtils.MODE.GCM, AesUtils.PAD.NOPADDING); return decryptText}

方法列表 返回类型 方法和说明 static java.lang.String decrypt(java.lang.String encryptText, java.lang.String secretKey) 使用密钥对密文进行AES解密。 static java.lang.String encrypt(java.lang.String plainText, java.lang.String secretKey) 使用密钥对明文进行AES加密。 static java.lang.String decrypt(java.lang.String encryptText, java.lang.String secretKey, java.lang.String initialVector, AesUtils.KEYLENGTH length, AesUtils.MODE mode, AesUtils.PAD pad) 使用指定模式和长度的密钥对密文进行AES解密。 static java.lang.String encrypt(java.lang.String plainText, java.lang.String secretKey, java.lang.String initialVector, AesUtils.KEYLENGTH length, AesUtils.MODE mode, AesUtils.PAD pad) 使用指定模式和长度的密钥对明文进行AES加密。

方法详情 public static java.lang.String decrypt(java.lang.String encryptText, java.lang.String secretKey) 使用密钥对密文进行AES解密 输入参数 encryptText：待解密的密文，长度不超过8192 secretKey：密钥 返回信息 返回解密后的数据 public static java.lang.String encrypt(java.lang.String plainText, java.lang.String secretKey) 使用密钥对明文进行AES加密 输入参数 plainText：待加密的明文，长度不超过4096 secretKey：密钥 返回信息 返回加密后的数据 public static java.lang.String decrypt(java.lang.String encryptText, java.lang.String secretKey, java.lang.String initialVector, AesUtils.KEYLENGTH length, AesUtils.MODE mode, AesUtils.PAD pad) 使用指定模式和长度的密钥对密文进行AES解密 输入参数 encryptText：待解密的密文，长度不超过8192 secretKey：密钥 initialVector：初始向量 length：密钥的长度，取值范围：AesUtils.KEYLENGTH.KL_0、AesUtils.KEYLENGTH.KL_128、AesUtils.KEYLENGTH.KL_192、AesUtils.KEYLENGTH.KL_256 mode：工作模式，取值范围：AesUtils.MODE.GCM、AesUtils.MODE.CTR pad：填充模式，取值范围：AesUtils.PAD.PKCS5PADDING，AesUtils.PAD.NOPADDING 返回信息 返回解密后的数据 public static java.lang.String encrypt(java.lang.String plainText, java.lang.String secretKey, java.lang.String initialVector, AesUtils.KEYLENGTH length, AesUtils.MODE mode, AesUtils.PAD pad) 使用指定模式和长度的密钥对明文进行AES加密 输入参数 plainText：待加密的明文，长度不超过4096 secretKey：密钥 initialVector：初始向量 length：密钥的长度，取值范围：AesUtils.KEYLENGTH.KL_0、AesUtils.KEYLENGTH.KL_128、AesUtils.KEYLENGTH.KL_192、AesUtils.KEYLENGTH.KL_256 mode：工作模式，取值范围：AesUtils.MODE.GCM、AesUtils.MODE.CTR pad：填充模式，取值范围：AesUtils.PAD.PKCS5PADDING，AesUtils.PAD.NOPADDING 返回信息 返回加密后的数据

请求消息 请求参数 参数 类型 必选 说明 messages Array 是 消息列表，数组大小不能超过10，且不能为空数组。 表2 messages参数 参数 类型 必选 说明 content Object 是 消息内容。 id String 是 消息序号，序列号不能重复。 请求示例 { "messages": [ { "content": "hello roma-1", "id": "1" }, { "content": "hello roma-2", "id": "2" }, { "content": "hello roma-3", "id": "3" } ]}

生成AK、SK 如果已生成过AK/SK，则可跳过此步骤，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 如下图所示，文件包含了租户名（User Name），AK（Access Key Id），SK（Secret Access Key）。 图1 credential.csv文件内容 AK/SK生成步骤： 注册并登录管理控制台。 单击右上角的用户名，在下拉列表中单击“我的凭证”。 单击“访问密钥”。 单击“新增访问密钥”，进入“新增访问密钥”页面。 输入登录密码和验证码，单击“确定”，下载密钥，请妥善保管。 图2 访问密钥获取页面示意