阿里云api服务器 阿里云api服务器控制面板

阿里云调用 API 服务后返回什么结果

返回结果

成都创新互联公司服务项目包括乐陵网站建设、乐陵网站制作、乐陵网页制作以及乐陵网络营销策划等。多年来，我们专注于互联网行业，利用自身积累的技术优势、行业经验、深度合作伙伴关系等，向广大中小型企业、政府机构等提供互联网行业的解决方案，乐陵网站推广取得了明显的社会效益与经济效益。目前，我们服务的客户以成都为中心已经辐射到乐陵省份的部分城市，未来相信会继续扩大服务区域并继续获得客户的支持与信任！

调用 API 服务后返回数据采用统一格式，返回的 HTTP 状态码为 2xx，代表调用成功;返回 4xx 或 5xx 的 HTTP 状态码代表调用失败。调用成功返回的数据格式主要有 XML 和 JSON 两种，外部系统可以在请求时传入参数来制定返回的数据格式，默认为 XML 格式。本文档中的返回示例为了便于用户查看，做了格式化处理，实际返回结果是没有进行换行、缩进等处理的。

成功结果：

错误结果

调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码以及下述 2.3.3 的公共错误码来定位错误原因。当调用出错时，HTTP 请求返回一个 4xx 或 5xx 的 HTTP 状态码。返回的消息体中是具体的错误代码及错误信息。另外还包含一个全局唯一的请求 ID：RequestId 和一个您该次请求访问的站点 ID：HostId。在调用方找不到错误原因时，可以联系阿里云客服，并提供该 HostId 和 RequestId，以便我们尽快帮您解决问题。

公共错误码

错误代码

描述

Http 状态码

语义

MissingParameter    The input parameter “Action” that is mandatory for processing this request is not supplied    400    缺少 Action 字段  

MissingParameter    The input parameter “AccessKeyId” that is mandatory for processing this request is not supplied    400    缺少 AccessKeyId 字段  

MissingParameter    An input parameter “Signature” that is mandatory for processing the request is not supplied.    400    缺少 Signature 字段  

MissingParameter    The input parameter “TimeStamp” that is mandatory for processing this request is not supplied    400    缺少 Timestamp 字段  

MissingParameter    The input parameter “Version” that is mandatory for processing this request is not supplied    400    缺少 Version 字段  

InvalidParameter    The specified parameter “Action or Version” is not valid.    400    无效的 Action 值（该 API 不存在）  

InvalidAccessKeyId.NotFound    The Access Key ID provided does not exist in our records.    400    无效的 AccessKeyId 值（该 key 不存在）  

Forbidden.AccessKeyDisabled    The Access Key is disabled.    403    该 AccessKey 处于禁用状态  

IncompleteSignature    The request signature does not conform to Aliyun standards.    400    无效的 Signature 取值（签名结果错误）  

InvalidParamater    The specified parameter “SignatureMethod” is not valid.    400    无效的 SignatureMethod 取值  

InvalidParamater    The specified parameter “SignatureVersion” is not valid.    400    无效的 SignatureVersion 取值  

IllegalTimestamp    The input parameter “Timestamp” that is mandatory for processing this request is not supplied.    400    无效的 Timestamp 取值（Timestamp 与服务器时间相差超过了 1 个小时）  

SignatureNonceUsed    The request signature nonce has been used.    400    无效的 SignatureNonce（该 SignatureNonce 值已被使用过）  

InvalidParameter    The specified parameter “Action or Version” is not valid.    400    无效的 Version 取值  

InvalidOwnerId    The specified OwnerId is not valid.    400    无效的 OwnerId 取值  

InvalidOwnerAccount    The specified OwnerAccount is not valid.    400    无效的 OwnerAccount 取值  

InvalidOwner    OwnerId and OwnerAccount can’t be used at one API access.    400    同时使用了 OwnerId 和 OwnerAccount  

Throttling    Request was denied due to request throttling.    400    因系统流控拒绝访问  

Throttling    Request was denied due to request throttling.    400    该 key 的调用 quota 已用完  

InvalidAction    Specified action is not valid.    403    该 key 无权调用该 API  

UnsupportedHTTPMethod    This http method is not supported.    403    用户使用了不支持的 Http Method（当前 TOP 只支持 post 和 get）  

ServiceUnavailable    The request has failed due to a temporary failure of the server.    500    服务不可用  

UnsupportedParameter    The parameter ”” is not supported.    400    使用了无效的参数  

InternalError    The request processing has failed due to some unknown error, exception or failure.    500    其他情况  

MissingParameter    The input parameter OwnerId,OwnerAccount that is mandatory for processing this request is not supplied.    403    调用该接口没有指定 OwnerId  

Forbidden.SubUser    The specified action is not available for you。    403    无权调用订单类接口  

UnsupportedParameter    The parameter ”” is not supported.    400    该参数无权使用  

Forbidden.InstanceNotFound    The specified Instance is not found, so we cann’t get enough information to check permission in RAM.    404    使用了 RAM 授权子账号进行资源访问，但是本次访问涉及到的 Instance 不存在  

Forbidden.DiskNotFound    The specified Disk is not found, so we cann’t get enough information to check permission in RAM.    404    使用了 RAM 授权子账号进行资源访问,但是本次访问涉及到的 Disk 不存在  

Forbidden.SecurityGroupNotFound    The specified SecurityGroup is not found, so we cann’t get enough information to check permission in RAM.    404    使用了 RAM 授权子账号进行资源访问,但是本次访问涉及到的 SecurityGroup 不存在  

Forbidden.SnapshotNotFound    The specified Snapshot is not found, so we cann’t get enough information to check permission in RAM.    404    使用了 RAM 授权子账号进行资源访问,但是本次访问涉及到的 Snapshot 不存在  

Forbidden.ImageNotFound    The specified Image is not found, so we cann’t get enough information to check permission in RAM.    404    使用了 RAM 授权子账号进行资源访问,但是本次访问涉及到的 Image 不存在  

Forbidden.RAM    User not authorized to operate the specified resource, or this API doesn’t support RAM.    403    使用了 RAM 授权子账号进行资源访问,但是本次操作没有被正确的授权  

Forbidden.NotSupportRAM    This action does not support accessed by RAM mode.    403    该接口不允许使用 RAM 方式进行访问  

InsufficientBalance    Your account does not have enough balance.    400    余额不足  

IdempotentParameterMismatch    Request uses a client token in a previous request but is not identical to that request.    400    使用了一个已经使用过的 ClientToken，但此次请求内容却又与上一次使用该 Token 的 request 不一样.  

RealNameAuthenticationError    Your account has not passed the real-name authentication yet.    403    用户未进行实名认证  

InvalidIdempotenceParameter.Mismatch    The specified parameters are different from before    403    幂等参数不匹配  

LastTokenProcessing    The last token request is processing    403    上一次请求还在处理中  

InvalidParameter    The specified parameter is not valid    400    参数校验失败  

阿里云cdn的api是基于什么协议实现的

阿里云cdn的api是基于节点服务器协议实现的。用了CDN给API来加速，那移动用户访问API时，请求会先到距离用户最近的CDN节点服务器上，由这个节点服务器去请求API，这个CDN节点服务器多线接入的，这样会尽可能减少用户到机房的网络故障机率。

阿里云API网关

API 网关（API Gateway）提供高性能、高可用的 API 托管服务，帮助用户对外开放其部署在 ECS、容器服务等阿里云产品上的应用，提供完整的 API 发布、管理、维护生命周期管理。用户只需进行简单的操作，即可快速、低成本、低风险地开放数据或服务。辅助用户简单、快速、低成本、低风险的实现微服务聚合、前后端分离、系统集成，向合作伙伴、开发者开放功能和数据

提供防攻击、防重放、请求加密、身份认证、权限管理、流量控制等多重手段保证 API 安全，降低 API 开放风险。

提供 API 定义、测试、发布、下线等全生命周期管理，并生成 SDK、API 说明文档，提升 API 管理、迭代的效率。

提供便捷的监控、报警、分析、API 市场等运维、运营工具，降低 API 运营、维护成本。

API 网关将能力的复用率最大化，企业间能够互相借力，企业发展能够专注自身业务，实现共赢。

API 便捷管理 （便捷的 API 管理功能，便捷的 API 管理工具）

API 生命周期管理：覆盖 API 的定义、测试、发布的整个生命周期管理，便捷的日常管理、版本管理，支持热升级和快速回滚。

便捷工具文档：提供页面调试工具，自动生成 API 文档和 SDK，大大降低人力成本。

安全稳定 （严格的权限管理、精准的流量控制、全面的监控报警）

安全防护：API 请求到达网关需要经过严格的身份认证、权限认证，才能到达后端服务。支持 HMAC（SHA-1,SHA-256）算法签名，支持 SSL 加密

流量控制：可控制单位时间内 API 允许被调用次数。用来保护企业的后端服务，实现业务分级和用户分级。

支持对 API 流控，您可以根据 API 的重要程度来配置不同流控，从而保障重要业务的稳定运行。

支持用户、应用和例外流控，您可以根据用户的重要性来配置不同流控，从而可以保证大用户的权益。

流控粒度：分钟、小时、天。

请求管理 （通过参数校验过滤无效请求，通过参数转换实现 API 高度复用，一套 API 多种服务）

参数校验：请求经过 API 网关，可根据您的配置进行参数类型、参数值（范围、枚举、正则、Json Schema）的校验，减少后端对非法请求、无效请求的资源消耗和处理成本。

参数转换：您可以在 API 网关定义参数映射规则，网关通过映射规则将后端服务通过映射翻译成任何形式，以满足不同用户的不同需求，从而避免功能重复开发。

监控告警 （结合阿里云监控服务，提供灵活全面的监控告警能力，该部分持续升级中）

监控告警：提供实时、可视化的 API 监控，包括：调用量、调用方式、响应时间、错误率，让您能够清楚的了解 API 的运行状况和用户的行为习惯。

支持自定义报警规则，来针对异常情况进行报警，降低故障处理时间。

API 市场 （一站式解决 API 管理和 API 变现）

API 市场：API 接入 API 网关后，还能以 API 服务的方式上架到阿里云 API 市场。API 网关和API 市场将为您解决计量计费、Quota 控制、运营售卖等需求。