服务器返回的常见http状态码

刺骨的言语ヽ痛彻心扉 2023-09-23 21:54 58阅读 0赞

1.  ## http状态码的类型 ##

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">状态码</td> 
 <td style="width:268px;vertical-align:top;height:52px;">响应类别</td> 
 <td style="width:299px;vertical-align:top;height:52px;">原因短语</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">1xx</td> 
 <td style="width:268px;vertical-align:top;height:52px;">信息性状态码（Informational）</td> 
 <td style="width:299px;vertical-align:top;height:52px;">服务器正在处理请求</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">2xx</td> 
 <td style="width:268px;vertical-align:top;height:52px;">成功状态码（Success）</td> 
 <td style="width:299px;vertical-align:top;height:52px;">请求已正常处理完毕</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">3xx</td> 
 <td style="width:268px;vertical-align:top;height:52px;">重定向状态码（Redirection）</td> 
 <td style="width:299px;vertical-align:top;height:52px;">需要进行额外操作以完成请求</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">4xx</td> 
 <td style="width:268px;vertical-align:top;height:52px;">客户端错误状态码（Client Error）</td> 
 <td style="width:299px;vertical-align:top;height:52px;">客户端原因导致服务器无法处理请求</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">5xx</td> 
 <td style="width:268px;vertical-align:top;height:52px;">服务器错误状态码（Server Error）</td> 
 <td style="width:299px;vertical-align:top;height:52px;">服务器原因导致处理请求出错</td> 
 </tr> 
 </tbody> 
</table>

1.  ## 接口调用方式 ##

### 2.1. 通信协议 ###

支持HTTP 或 HTTPS 协议请求通信。为了获得更高的安全性，推荐使用 HTTPS 协议发送请

求。

### 2.2. 请求规则 ###

https:// + 请求域名 +请求路径 + ? +最终请求参数串

### 2.3. 请求方法 ###

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">方法</td> 
 <td style="width:567px;vertical-align:top;height:52px;">说明</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">GET </td> 
 <td style="width:567px;vertical-align:top;height:52px;">请求服务器返回指定资源。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">PUT </td> 
 <td style="width:567px;vertical-align:top;height:52px;">请求服务器更新指定资源。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">POST </td> 
 <td style="width:567px;vertical-align:top;height:52px;">请求服务器新增资源或执行特殊操作。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">DELETE </td> 
 <td style="width:567px;vertical-align:top;height:52px;">请求服务器删除指定资源，如删除对象等。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;">HEAD </td> 
 <td style="width:567px;vertical-align:top;height:52px;">请求服务器资源头部。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;vertical-align:top;height:52px;"> PATCH </td> 
 <td style="width:567px;vertical-align:top;height:52px;">请求服务器更新资源的部分内容。当资源不存在的时候，PATCH 可能会去创建一个新的资源。 </td> 
 </tr> 
 </tbody> 
</table>

### 2.4. 字符编码 ###

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

1.  ## 公共参数 ##

### 3.1. 公共请求参数 ###

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:99px;vertical-align:top;height:52px;">名称</td> 
 <td style="width:66px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:74px;vertical-align:top;height:52px;">类型</td> 
 <td style="width:90px;vertical-align:top;height:52px;">是否必须</td> 
 <td style="width:360px;vertical-align:top;height:52px;">描述</td> 
 </tr> 
 <tr> 
 <td style="width:99px;vertical-align:top;height:52px;"> Timestamp </td> 
 <td style="width:66px;vertical-align:top;height:52px;"> param </td> 
 <td style="width:74px;vertical-align:top;height:52px;"> string </td> 
 <td style="width:90px;vertical-align:top;height:52px;"> 是</td> 
 <td style="width:360px;vertical-align:top;height:52px;">当前UNIX 时间戳，可记录发起 API 请求的时间 </td> 
 </tr> 
 <tr> 
 <td style="width:99px;vertical-align:top;height:52px;"> Nonce </td> 
 <td style="width:66px;vertical-align:top;height:52px;"> param </td> 
 <td style="width:74px;vertical-align:top;height:52px;"> string </td> 
 <td style="width:90px;vertical-align:top;height:52px;"> 是</td> 
 <td style="width:360px;vertical-align:top;height:52px;">随机正整数，与Timestamp联合起来, 用于防止重放攻击 </td> 
 </tr> 
 <tr> 
 <td style="width:99px;vertical-align:top;height:52px;"> Version </td> 
 <td style="width:66px;vertical-align:top;height:52px;"> param </td> 
 <td style="width:74px;vertical-align:top;height:52px;"> string </td> 
 <td style="width:90px;vertical-align:top;height:52px;"> 是</td> 
 <td style="width:360px;vertical-align:top;height:52px;">API 版本号，使用 YYYY-MM-DD 日期格式。取值：2014-05-15 </td> 
 </tr> 
 </tbody> 
</table>

1.  ## 通用请求返回值 ##

### 4.1. 正常返回状态码 ###

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:89px;vertical-align:top;height:52px;">状态码</td> 
 <td style="width:199px;vertical-align:top;height:52px;">返回值</td> 
 <td style="width:424px;vertical-align:top;height:52px;">说明</td> 
 </tr> 
 <tr> 
 <td style="width:89px;vertical-align:top;height:52px;">200 </td> 
 <td style="width:199px;vertical-align:top;height:52px;">OK</td> 
 <td style="width:424px;vertical-align:top;height:52px;">请求成功。</td> 
 </tr> 
 <tr> 
 <td style="width:89px;vertical-align:top;height:52px;">202</td> 
 <td style="width:199px;vertical-align:top;height:52px;">Created</td> 
 <td style="width:424px;vertical-align:top;height:52px;">任务提交成功，当前系统繁忙，下发的任务会延迟处理。</td> 
 </tr> 
 <tr> 
 <td style="width:89px;vertical-align:top;height:52px;">204</td> 
 <td style="width:199px;vertical-align:top;height:52px;">No Content</td> 
 <td style="width:424px;vertical-align:top;height:52px;">任务提交成功。</td> 
 </tr> 
 </tbody> 
</table>

### 4.2. 异常返回状态码 ###

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">状态码</td> 
 <td style="width:200px;vertical-align:top;height:52px;">返回值</td> 
 <td style="width:423px;vertical-align:top;height:52px;">说明</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">300</td> 
 <td style="width:200px;vertical-align:top;height:52px;">multiple choices </td> 
 <td style="width:423px;vertical-align:top;height:52px;">被请求的资源存在多个可供选择的响应。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">400</td> 
 <td style="width:200px;vertical-align:top;height:52px;">Bad Request</td> 
 <td style="width:423px;vertical-align:top;height:52px;">服务器未能处理请求。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">401 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Unauthorized</td> 
 <td style="width:423px;vertical-align:top;height:52px;">被请求的页面需要用户名和密码。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">403 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Forbidden</td> 
 <td style="width:423px;vertical-align:top;height:52px;">对被请求页面的访问被禁止。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">404 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Not Found</td> 
 <td style="width:423px;vertical-align:top;height:52px;">服务器无法找到被请求的页面。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">405 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Method Not Allowed</td> 
 <td style="width:423px;vertical-align:top;height:52px;">请求中指定的方法不被允许。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">406 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Not Acceptable</td> 
 <td style="width:423px;vertical-align:top;height:52px;">服务器生成的响应无法被客户端所接受。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">407</td> 
 <td style="width:200px;vertical-align:top;height:52px;">Proxy Authentication Required </td> 
 <td style="width:423px;vertical-align:top;height:52px;">用户必须首先使用代理服务器进行验证，这样请求才会被处理。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">408 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Request Timeout</td> 
 <td style="width:423px;vertical-align:top;height:52px;">请求超出了服务器的等待时间。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">409 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Conflict</td> 
 <td style="width:423px;vertical-align:top;height:52px;">由于冲突，请求无法被完成。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">500 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Internal Server Error</td> 
 <td style="width:423px;vertical-align:top;height:52px;">请求未完成，服务异常。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">501 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Not Implemented</td> 
 <td style="width:423px;vertical-align:top;height:52px;">请求未完成，服务器不支持所请求的功能。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">502 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Bad Gateway</td> 
 <td style="width:423px;vertical-align:top;height:52px;">请求未完成，服务器从上游服务器收到一个无效的响应。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">503 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Service Unavailable</td> 
 <td style="width:423px;vertical-align:top;height:52px;">请求未完成，系统暂时异常。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">504 </td> 
 <td style="width:200px;vertical-align:top;height:52px;">Gateway Timeout</td> 
 <td style="width:423px;vertical-align:top;height:52px;">网关超时。</td> 
 </tr> 
 <tr> 
 <td style="width:77px;vertical-align:top;height:52px;">505</td> 
 <td style="width:200px;vertical-align:top;height:52px;">HTTP Version Not Supported</td> 
 <td style="width:423px;vertical-align:top;height:52px;">不支持的http版本。</td> 
 </tr> 
 </tbody> 
</table>

### 4.3. 公共错误码 ###

#### 4.3.1. 云服务器操作类常见公共错误码 ####

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:105px;vertical-align:top;height:52px;">错误码</td> 
 <td style="width:246px;vertical-align:top;height:52px;">错误信息</td> 
 <td style="width:122px;vertical-align:top;height:52px;">http状态码</td> 
 <td style="width:217px;vertical-align:top;height:52px;">说明</td> 
 </tr> 
 <tr> 
 <td style="width:105px;vertical-align:top;height:52px;">101.001004 </td> 
 <td style="width:246px;vertical-align:top;height:52px;">云服务器费用已过期，不能操作，请续费</td> 
 <td style="width:122px;vertical-align:top;height:52px;">400 </td> 
 <td style="width:217px;vertical-align:top;height:52px;">云服务器已过期，需要续费</td> 
 </tr> 
 <tr> 
 <td style="width:105px;vertical-align:top;height:52px;"> 101.001012 </td> 
 <td style="width:246px;vertical-align:top;height:52px;">存在未知状态的云服务器，请重新选择云服务器</td> 
 <td style="width:122px;vertical-align:top;height:52px;"> 400 </td> 
 <td style="width:217px;vertical-align:top;height:52px;">云服务器不满足操作的前置状态</td> 
 </tr> 
 <tr> 
 <td style="width:105px;vertical-align:top;height:52px;"> 101.001013 </td> 
 <td style="width:246px;vertical-align:top;height:52px;">存在未知所属的云服务器，请重新选择云服务器</td> 
 <td style="width:122px;vertical-align:top;height:52px;"> 400 </td> 
 <td style="width:217px;vertical-align:top;height:52px;">云服务器不属于操作用户或者不存在</td> 
 </tr> 
 <tr> 
 <td style="width:105px;vertical-align:top;height:52px;"> 101.001014 </td> 
 <td style="width:246px;vertical-align:top;height:52px;">存在未付费类型的云服务器，请重新选择云服务器</td> 
 <td style="width:122px;vertical-align:top;height:52px;"> 400 </td> 
 <td style="width:217px;vertical-align:top;height:52px;"> 云服务器在BSS 无计费信息 </td> 
 </tr> 
 </tbody> 
</table>

1.  ## 附录 ##

### 5.1. 云服务器状态字段转义对照图 ###

状态字段的转义如下：

1.  取status 字段，不区分大小写

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">status </td> 
 <td style="width:362px;vertical-align:top;height:52px;">translation </td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">ACTIVE </td> 
 <td style="width:362px;vertical-align:top;height:52px;">运行中</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">DELETED </td> 
 <td style="width:362px;vertical-align:top;height:52px;">已删除</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">ERROR </td> 
 <td style="width:362px;vertical-align:top;height:52px;">错误/创建失败 </td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">PAUSED </td> 
 <td style="width:362px;vertical-align:top;height:52px;">暂停</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">SOFT_DELETED </td> 
 <td style="width:362px;vertical-align:top;height:52px;">软删除</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">STOPPED </td> 
 <td style="width:362px;vertical-align:top;height:52px;">停止</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">SHUTOFF </td> 
 <td style="width:362px;vertical-align:top;height:52px;">已关机</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">BUILD </td> 
 <td style="width:362px;vertical-align:top;height:52px;">创建中</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">REBOOT </td> 
 <td style="width:362px;vertical-align:top;height:52px;">软重启中</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">HARD_REBOOT </td> 
 <td style="width:362px;vertical-align:top;height:52px;">硬重启中</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">RESIZE </td> 
 <td style="width:362px;vertical-align:top;height:52px;">变更规格中</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">REBUILD </td> 
 <td style="width:362px;vertical-align:top;height:52px;">重置系统中</td> 
 </tr> 
 <tr> 
 <td style="width:328px;vertical-align:top;height:52px;">PASSWORD </td> 
 <td style="width:362px;vertical-align:top;height:52px;">重置密码中</td> 
 </tr> 
 </tbody> 
</table>

1.  取task\_state 字段，不区分大小写

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:346px;vertical-align:top;height:52px;">task_state</td> 
 <td style="width:346px;vertical-align:top;height:52px;">translation</td> 
 </tr> 
 <tr> 
 <td style="width:346px;vertical-align:top;height:52px;">powering-on</td> 
 <td style="width:346px;vertical-align:top;height:52px;">开机中</td> 
 </tr> 
 <tr> 
 <td style="width:346px;vertical-align:top;height:52px;">powering-off</td> 
 <td style="width:346px;vertical-align:top;height:52px;">关机中</td> 
 </tr> 
 <tr> 
 <td style="width:346px;vertical-align:top;height:52px;">deleting</td> 
 <td style="width:346px;vertical-align:top;height:52px;">删除中</td> 
 </tr> 
 </tbody> 
</table>

1.  私有镜像状态字段转义对照图

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
 <tr> 
 <td style="width:350px;vertical-align:top;height:52px;">status</td> 
 <td style="width:343px;vertical-align:top;height:52px;">translation</td> 
 </tr> 
 <tr> 
 <td style="width:350px;vertical-align:top;height:52px;">queued(排队中)、saving(保存中)</td> 
 <td style="width:343px;vertical-align:top;height:52px;">创建中</td> 
 </tr> 
 <tr> 
 <td style="width:350px;vertical-align:top;height:52px;">killed</td> 
 <td style="width:343px;vertical-align:top;height:52px;">创建失败/错误</td> 
 </tr> 
 <tr> 
 <td style="width:350px;vertical-align:top;height:52px;">active</td> 
 <td style="width:343px;vertical-align:top;height:52px;">可用</td> 
 </tr> 
 <tr> 
 <td style="width:350px;vertical-align:top;height:52px;">pending_delete</td> 
 <td style="width:343px;vertical-align:top;height:52px;">删除中</td> 
 </tr> 
 </tbody> 
</table>