carto
/
grpc


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>GRPC Core: Status codes and their use in gRPC</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">GRPC Core
   &#160;<span id="projectnumber">6.0.0</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

</div><!-- top -->
<div class="header">
  <div class="headertitle">
<div class="title">Status codes and their use in gRPC </div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>gRPC uses a set of well defined status codes as part of the RPC API. All RPCs started at a client return a <code>status</code> object composed of an integer <code>code</code> and a string <code>message</code>. The server-side can choose the status it returns for a given RPC.</p>
<p>The gRPC client and server-side implementations may also generate and return <code>status</code> on their own when errors happen. Only a subset of the pre-defined status codes are generated by the gRPC libraries. This allows applications to be sure that any other code it sees was actually returned by the application (although it is also possible for the server-side to return one of the codes generated by the gRPC libraries).</p>
<p>The following table lists the codes that may be returned by the gRPC libraries (on either the client-side or server-side) and summarizes the situations in which they are generated.</p>
<table class="doxtable">
<tr>
<th>Case </th><th align="left">Code </th><th align="center">Generated at Client or Server  </th></tr>
<tr>
<td>Client Application cancelled the request </td><td align="left">CANCELLED </td><td align="center">Both </td></tr>
<tr>
<td>Deadline expires before server returns status </td><td align="left">DEADLINE_EXCEEDED </td><td align="center">Both </td></tr>
<tr>
<td>Method not found at server </td><td align="left">UNIMPLEMENTED </td><td align="center">Server </td></tr>
<tr>
<td>Server shutting down </td><td align="left">UNAVAILABLE </td><td align="center">Server </td></tr>
<tr>
<td>Server side application throws an exception (or does something other than returning a Status code to terminate an RPC) </td><td align="left">UNKNOWN </td><td align="center">Server </td></tr>
<tr>
<td>No response received before Deadline expires. This may occur either when the client is unable to send the request to the server or when the server fails to respond in time. </td><td align="left">DEADLINE_EXCEEDED </td><td align="center">Both </td></tr>
<tr>
<td>Some data transmitted (e.g., request metadata written to TCP connection) before connection breaks </td><td align="left">UNAVAILABLE </td><td align="center">Client </td></tr>
<tr>
<td>Could not decompress, but compression algorithm supported (Client -&gt; Server) </td><td align="left">INTERNAL </td><td align="center">Server </td></tr>
<tr>
<td>Could not decompress, but compression algorithm supported (Server -&gt; Client) </td><td align="left">INTERNAL </td><td align="center">Client </td></tr>
<tr>
<td>Compression mechanism used by client not supported at server </td><td align="left">UNIMPLEMENTED </td><td align="center">Server </td></tr>
<tr>
<td>Server temporarily out of resources (e.g., Flow-control resource limits reached) </td><td align="left">RESOURCE_EXHAUSTED </td><td align="center">Server </td></tr>
<tr>
<td>Client does not have enough memory to hold the server response </td><td align="left">RESOURCE_EXHAUSTED </td><td align="center">Client </td></tr>
<tr>
<td>Flow-control protocol violation </td><td align="left">INTERNAL </td><td align="center">Both </td></tr>
<tr>
<td>Error parsing returned status </td><td align="left">UNKNOWN </td><td align="center">Client </td></tr>
<tr>
<td>Incorrect Auth metadata ( Credentials failed to get metadata, Incompatible credentials set on channel and call, Invalid host set in <code>:authority</code> metadata, etc.) </td><td align="left">UNAUTHENTICATED </td><td align="center">Both </td></tr>
<tr>
<td>Request cardinality violation (method requires exactly one request but client sent some other number of requests) </td><td align="left">UNIMPLEMENTED </td><td align="center">Server </td></tr>
<tr>
<td>Response cardinality violation (method requires exactly one response but server sent some other number of responses) </td><td align="left">UNIMPLEMENTED </td><td align="center">Client </td></tr>
<tr>
<td>Error parsing response proto </td><td align="left">INTERNAL </td><td align="center">Client </td></tr>
<tr>
<td>Error parsing request proto </td><td align="left">INTERNAL </td><td align="center">Server </td></tr>
<tr>
<td>Sent or received message was larger than configured limit </td><td align="left">RESOURCE_EXHAUSTED </td><td align="center">Both </td></tr>
</table>
<p>The following status codes are never generated by the library:</p><ul>
<li>INVALID_ARGUMENT</li>
<li>NOT_FOUND</li>
<li>ALREADY_EXISTS</li>
<li>FAILED_PRECONDITION</li>
<li>ABORTED</li>
<li>OUT_OF_RANGE</li>
<li>DATA_LOSS </li>
</ul>
</div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Fri Apr 13 2018 15:03:52 for GRPC Core by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>