KMS API 1117

docs/kms/api-ref/PARAMETERS.txt

@@ -0,0 +1,3 @@
+version=""
+language="en-us"
+type=""

docs/kms/api-ref/dew_02_0307.html

@@ -0,0 +1,13 @@
+<a name="dew_02_0307"></a><a name="dew_02_0307"></a>
+
+<h1 class="topictitle1">Permissions Policies and Supported Actions</h1>
+<div id="body8662426"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="dew_02_0308.html">Introduction</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="dew_02_0309.html">Encryption Key Management</a></strong><br>
+</li>
+</ul>
+</div>
+

docs/kms/api-ref/dew_02_0308.html

@@ -0,0 +1,23 @@
+<a name="dew_02_0308"></a><a name="dew_02_0308"></a>
+
+<h1 class="topictitle1">Introduction</h1>
+<div id="body8662426"><p id="dew_02_0308__en-us_topic_0172275164_p122841827152813">This chapter describes fine-grained permissions management for your KMS. If your account does not need individual IAM users, then you may skip over this chapter.</p>
+<p id="dew_02_0308__en-us_topic_0172275164_p1386992104912">By default, new IAM users do not have permissions assigned. You need to add a user to one or more groups, and attach permissions policies or roles to these groups. Users inherit permissions from the groups to which they are added and can perform specified operations on cloud services based on the permissions.</p>
+<p id="dew_02_0308__en-us_topic_0172275164_p7869112110495">You can grant users permissions by using roles and policies. Roles are a type of coarse-grained authorization mechanism that defines permissions related to user responsibilities. Policies define API-based permissions for operations on specific resources under certain conditions, allowing for more fine-grained, secure access control of cloud resources.</p>
+<div class="note" id="dew_02_0308__en-us_topic_0172275164_note2789122144911"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dew_02_0308__en-us_topic_0172275164_p716514134549">Policy-based authorization is useful if you want to allow or deny the access to an API.</p>
+</div></div>
+<p id="dew_02_0308__en-us_topic_0172275164_p1487018213499">An account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. The permissions required for calling an API are determined by the actions supported by the API. Only users who have been granted permissions allowing the actions can call the API successfully. </p>
+<div class="section" id="dew_02_0308__en-us_topic_0172275164_section677212217497"><h4 class="sectiontitle">Supported Actions</h4><p id="dew_02_0308__en-us_topic_0172275164_p187062194916">You can use system-defined policies provided in IAM, or create custom policies to supplement the system-defined policies, implementing refined access control. Operations supported by policies are specific to APIs. The following are common concepts related to policies:</p>
+<ul id="dew_02_0308__en-us_topic_0172275164_ul1487018213498"><li id="dew_02_0308__en-us_topic_0172275164_li8870122134910">Permission: A statement in a policy that allows or denies certain operations.</li><li id="dew_02_0308__en-us_topic_0172275164_li3635501787">APIs: REST APIs that can be called in a custom policy.</li><li id="dew_02_0308__en-us_topic_0172275164_li118703217498">Actions: Added to a custom policy to control permissions for specific operations.</li><li id="dew_02_0308__en-us_topic_0172275164_li27972588819">Dependent actions: When assigning an action to users, you also need to assign dependent permissions for that action to take effect.</li><li id="dew_02_0308__en-us_topic_0172275164_li1987022154912">IAM projects or enterprise project: Scope of users a permission is granted to. Policies that contain actions supporting both IAM and enterprise projects can be assigned to user groups and take effect in both IAM and Enterprise Management. Policies that only contain actions supporting IAM projects can be assigned to user groups and only take effect in IAM. Such policies will not take effect if they are assigned to user groups in Enterprise Project. <div class="note" id="dew_02_0308__en-us_topic_0172275164_note1187734192"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dew_02_0308__en-us_topic_0172275164_p140015411092">√: supported; x: not supported</p>
+</div></div>
+</li></ul>
+<p id="dew_02_0308__en-us_topic_0172275164_p18681734368">KMS supports the following actions that can be defined in custom policies:</p>
+<p id="dew_02_0308__en-us_topic_0172275164_p0276549103610"><a href="dew_02_0309.html#dew_02_0309">Manage keys</a>, such as creating keys and querying keys.</p>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dew_02_0307.html">Permissions Policies and Supported Actions</a></div>
+</div>
+</div>
+

docs/kms/api-ref/en-us_topic_00384375969.html

@@ -0,0 +1,8 @@
+<a name="en-us_topic_00384375969"></a><a name="en-us_topic_00384375969"></a>
+
+<h1 class="topictitle1">API Usage Guidelines</h1>
+<div id="body1530174454877"><p id="en-us_topic_00384375969__en-us_topic_0119070335_p1645204610259">Public cloud APIs comply with the RESTful API design principles. REST-based Web services are organized into resources. Each resource is identified by one or more Uniform Resource Identifiers (URIs). An application accesses a resource based on the resource's Unified Resource Locator (URL). A URL is usually in the following format: <em id="en-us_topic_00384375969__en-us_topic_0119070335_i1385069210259">https://Endpoint/uri</em>. In the URL, <strong id="en-us_topic_00384375969__en-us_topic_0119070335_b5754736910259">uri</strong> indicates the resource path, that is, the API access path.</p>
+<p id="en-us_topic_00384375969__en-us_topic_0119070335_p4816427810259">Public cloud APIs use HTTPS as the transmission protocol. Requests/Responses are transmitted by using JSON messages, with media type represented by <strong id="en-us_topic_00384375969__en-us_topic_0119070335_b3082532510259">Application/json</strong>.</p>
+<p id="en-us_topic_00384375969__en-us_topic_0119070335_p188289482118">For details about how to use APIs, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328001.html?tag=API Documents" target="_blank" rel="noopener noreferrer">API Usage Guidelines</a>.</p>
+</div>
+

docs/kms/api-ref/kms_02_0009.html

@@ -0,0 +1,22 @@
+<a name="kms_02_0009"></a><a name="kms_02_0009"></a>
+
+<h1 class="topictitle1">Obtaining a Project ID</h1>
+<div id="body32001227"><div class="section" id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_section59621329127"><h4 class="sectiontitle">Obtaining a Project ID from the Console</h4><p id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_p8112855194115">A project ID is required for some URLs when an API is called. To obtain a project ID, perform the following operations:</p>
+<ol id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_ol8715914194127"><li id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_li50056756194127">Log in to the management console.</li><li id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_li2804809915217">Click the username and choose <strong id="kms_02_0009__en-us_topic_0171850914_b8169259132211">My Credential</strong> from the drop-down list.<p id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_p136772519449">On the <strong id="kms_02_0009__en-us_topic_0171850914_b57411048112216">My Credential</strong> page, view project IDs in the project list.</p>
+</li></ol>
+<div class="fignone" id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_fig39324824103512"><span class="figcap"><b>Figure 1 </b>Viewing project IDs</span><br><span><img id="kms_02_0009__en-us_topic_0171850914_en-us_topic_0101662393_image538470016132" src="en-us_image_0218728478.jpg" title="Click to enlarge" class="imgResize"></span></div>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="kms_02_0300.html">Appendix</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/kms/api-ref/kms_02_0010.html

@@ -0,0 +1,81 @@
+<a name="kms_02_0010"></a><a name="kms_02_0010"></a>
+
+<h1 class="topictitle1">APIs</h1>
+<div id="body1516240388172"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="kms_02_0012.html">Creating a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0013.html">Enabling a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0014.html">Disabling a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0015.html">Scheduling the Deletion of a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0016.html">Canceling the Scheduled Deletion of a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0017.html">Querying the List of CMKs</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0018.html">Querying the Information About a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0019.html">Creating a Random Number</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0020.html">Creating a DEK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0021.html">Creating a Plaintext-Free DEK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0022.html">Encrypting a DEK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0023.html">Decrypting a DEK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0024.html">Querying the Number of Instances</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0025.html">Querying the Quota of a User</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0026.html">Changing the Alias of a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0027.html">Changing the Description of a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0028.html">Creating a Grant</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0029.html">Revoking a Grant</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0030.html">Retiring a Grant</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0031.html">Querying Grants on a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0032.html">Querying Grants That Can Be Retired</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0035.html">Obtaining CMK Import Parameters</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0036.html">Importing CMK Material</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0037.html">Deleting CMK Material</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0038.html">Enabling Rotation for a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0039.html">Changing the Rotation Interval for a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0040.html">Disabling Rotation for a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0041.html">Querying the Rotation Status of a CMK</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0042.html">Querying CMK Instances</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0043.html">Querying CMK Tags</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0044.html">Querying Project Tags</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0045.html">Adding or Deleting CMK Tags in Batches</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0046.html">Adding a CMK Tag</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0047.html">Deleting a CMK Tag</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0048.html">Querying All API Versions</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0049.html">Querying a Specified API Version</a></strong><br>
+</li>
+</ul>
+</div>
+

docs/kms/api-ref/kms_02_0300.html

@@ -0,0 +1,17 @@
+<a name="kms_02_0300"></a><a name="kms_02_0300"></a>
+
+<h1 class="topictitle1">Appendix</h1>
+<div id="body1474623297624"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="kms_02_0301.html">Status Codes</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_8888.html">Error Code</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0009.html">Obtaining a Project ID</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="kms_02_0305.html">API Permissions</a></strong><br>
+</li>
+</ul>
+</div>
+

docs/kms/api-ref/kms_02_0301.html

@@ -0,0 +1,64 @@
+<a name="kms_02_0301"></a><a name="kms_02_0301"></a>
+
+<h1 class="topictitle1">Status Codes</h1>
+<div id="body1520836088491">
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="kms_02_0301__en-us_topic_0112992355_t982da1e0196d4ec1a28d1fbff2cc8191" frame="border" border="1" rules="all"><thead align="left"><tr id="kms_02_0301__en-us_topic_0112992355_r6e963322c1e740d181726d2f0e91df5a"><th align="left" class="cellrowborder" valign="top" width="16.54%" id="mcps1.3.1.1.4.1.1"><p id="kms_02_0301__en-us_topic_0112992355_a3b5bbe5a7f644fd3a74cecbfb3f7ed60">Status Code</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="28.01%" id="mcps1.3.1.1.4.1.2"><p id="kms_02_0301__en-us_topic_0112992355_ad98d2f62bd064b4e96ea922645197c24">Status</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="55.45%" id="mcps1.3.1.1.4.1.3"><p id="kms_02_0301__en-us_topic_0112992355_a6bb6f1fe56a2454982832e8d56d354d8">Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="kms_02_0301__en-us_topic_0112992355_row26201381819"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.1.1.4.1.1 "><p id="kms_02_0301__en-us_topic_0112992355_p562018386813">200</p>
+</td>
+<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.1.1.4.1.2 "><p id="kms_02_0301__en-us_topic_0112992355_p7538425819">OK</p>
+</td>
+<td class="cellrowborder" valign="top" width="55.45%" headers="mcps1.3.1.1.4.1.3 "><p id="kms_02_0301__en-us_topic_0112992355_en-us_topic_0079615001_p35664277">Request processed successfully.</p>
+</td>
+</tr>
+<tr id="kms_02_0301__en-us_topic_0112992355_row516361086"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.1.1.4.1.1 "><p id="kms_02_0301__en-us_topic_0112992355_p15115364819">204</p>
+</td>
+<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.1.1.4.1.2 "><p id="kms_02_0301__en-us_topic_0112992355_p2123920113816">No Content</p>
+</td>
+<td class="cellrowborder" valign="top" width="55.45%" headers="mcps1.3.1.1.4.1.3 "><p id="kms_02_0301__en-us_topic_0112992355_p151239205384">The request is processed successfully and no content is returned.</p>
+</td>
+</tr>
+<tr id="kms_02_0301__en-us_topic_0112992355_row55915878143337"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.1.1.4.1.1 "><p id="kms_02_0301__en-us_topic_0112992355_p32892230143337">400</p>
+</td>
+<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.1.1.4.1.2 "><p id="kms_02_0301__en-us_topic_0112992355_p47024946143337">Bad Request</p>
+</td>
+<td class="cellrowborder" valign="top" width="55.45%" headers="mcps1.3.1.1.4.1.3 "><p id="kms_02_0301__en-us_topic_0112992355_p50924307143337">The request parameter is incorrect.</p>
+</td>
+</tr>
+<tr id="kms_02_0301__en-us_topic_0112992355_row63238796143346"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.1.1.4.1.1 "><p id="kms_02_0301__en-us_topic_0112992355_p22068881143346">403</p>
+</td>
+<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.1.1.4.1.2 "><p id="kms_02_0301__en-us_topic_0112992355_p42748959143346">Forbidden</p>
+</td>
+<td class="cellrowborder" valign="top" width="55.45%" headers="mcps1.3.1.1.4.1.3 "><p id="kms_02_0301__en-us_topic_0112992355_p40113629143346">The server understood the request, but is refusing to fulfill it.</p>
+</td>
+</tr>
+<tr id="kms_02_0301__en-us_topic_0112992355_row51469526143359"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.1.1.4.1.1 "><p id="kms_02_0301__en-us_topic_0112992355_p8282095143359">404</p>
+</td>
+<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.1.1.4.1.2 "><p id="kms_02_0301__en-us_topic_0112992355_p66869928143359">Not Found</p>
+</td>
+<td class="cellrowborder" valign="top" width="55.45%" headers="mcps1.3.1.1.4.1.3 "><p id="kms_02_0301__en-us_topic_0112992355_p47755049143359">The requested resource does not exist or not found.</p>
+</td>
+</tr>
+<tr id="kms_02_0301__en-us_topic_0112992355_row784572820273"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.1.1.4.1.1 "><p id="kms_02_0301__en-us_topic_0112992355_p1051020374274">500</p>
+</td>
+<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.1.1.4.1.2 "><p id="kms_02_0301__en-us_topic_0112992355_p1151033792714">Internal Server Error</p>
+</td>
+<td class="cellrowborder" valign="top" width="55.45%" headers="mcps1.3.1.1.4.1.3 "><p id="kms_02_0301__en-us_topic_0112992355_p1351163720274">Internal service error.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="kms_02_0300.html">Appendix</a></div>
+</div>
+</div>
+

docs/kms/api-ref/kms_02_0304.html

@@ -0,0 +1,96 @@
+<a name="kms_02_0304"></a><a name="kms_02_0304"></a>
+
+<h1 class="topictitle1">Change History </h1>
+<div id="body1477279684548">
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="kms_02_0304__en-us_topic_0112992352_table1557726816410" frame="border" border="1" rules="all"><thead align="left"><tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row2942532716410"><th align="left" class="cellrowborder" valign="top" width="27.27%" id="mcps1.3.1.1.3.1.1"><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p5627845516410"><strong id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_b5800814916410_2">Release Date</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="72.72999999999999%" id="mcps1.3.1.1.3.1.2"><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p2382284816410"><strong id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_b3316380216410_2">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row7294111142517"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p5298161118253">2022-09-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p1429811117254">This issue is the thirteenth official release.</p>
+<p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p1306154012720">Optimized descriptions in sections "Permissions Policies and Supported Actions".</p>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row1746561452516"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p13465181482512">2021-10-20</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p74651214172510">This issue is the twelfth official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul109541566020"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li18369658309">Added section "Permissions and Supported Actions".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li195415561019">Added description about default KMS performance thresholds in "CMK Management".</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row1690516152115"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p29051215517">2021-09-22</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p152360825317">This issue is the eleventh official release.</p>
+<p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p181531747125511">Modified the error code format in the "Error Codes" section.</p>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row97990818161"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p20531135218408">2019-12-10</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p43801553105213">This is the tenth official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_en-us_topic_0112992352_en-us_topic_0172241630_ul0290529141411"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li161864310418">Added the section "Enabling Rotation for a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li15226145616419">Added the section "Changing the Rotation Interval for a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li22511011194217">Added the section "Disabling Rotation for a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li101001019174218">Added the section "Querying the Rotation Status of a CMK".</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row91871221153214"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p1818862118320">2019-03-13</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p116483615523">This is the ninth official release.</p>
+<p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p121881421183217">Added the section "API Permissions".</p>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row851185441815"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p15512175415185">2018-09-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p12117173145218">This is the eighth official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul15991194214488"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li1599064219489">Added the section "Querying All API Versions."</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li169901042204812">Added the section "Querying a Specified API Version."</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row9343129123219"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p15343179193217">2018-07-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p4728163711516">This is the seventh official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul1580187105214"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li58014775219">Modified the section "Error Codes": added error codes KMS.0417, KMS.0418, and their descriptions.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li380137165218">Modified the descriptions about status codes returned following each request. The normal status codes and exception status codes are described separately.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li08014795210">Modified section "Status Codes": added status code <strong id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_b1316113594610">204</strong> and its description.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li148017755212">Modified the description of the <strong id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_b424415129716">resource_detail</strong> parameter in the section "Querying CMK Instances".</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row8698105511310"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p86981955161316">2018-03-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p33891849175012">This issue is the sixth official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul0290529141411"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li113601236181416">Added the section "Obtaining CMK Import Parameters".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li103641936111410">Added the section "Importing CMK Material".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li1436953671413">Added the section "Deleting CMK Material".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li85351258165017">Added the section "Querying CMK Instances".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li17137811175111">Added the section "Querying CMK Tags".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li518220261511">Added the section "Querying Project Tags".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li1840123895213">Added the section "Adding or Deleting CMK Tags in Batches".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li17486647155116">Added the section "Adding a CMK Tag".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li14514155445119">Added the section "Deleting a CMK Tag".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li261811151616">Optimized error codes and modified the section "Error Codes".<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul18624141121618"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li13627161151619">Added error codes KMS.0309, KMS.0310, and KMS.0401-KMS.0413 to the common error codes.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li863415111611">Added error codes and their description for importing CMK material.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li7638511167">Added error codes and their description for deleting CMK material.</li></ul>
+</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row25505869102932"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p52709507102932">2017-10-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p5485153665016">This is the fifth official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul46384363103019"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li36475385103522">Added the section "Creating a Grant".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li1716188103522">Added the section "Revoking a Grant".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li4793511103522">Added the section "Retiring a Grant".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li52730115103522">Added the section "Querying Grants on a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li43280919103522">Added the section "Querying Grants That Can Be Retired".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li46505555103551">Optimized request parameter description in the section "Creating a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li62391251103733">Optimized request and response parameter description in the section "Querying the List of CMKs".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li22583069104350">Optimized response parameter description in the section "Querying the Information About a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li1672803115534">Optimized response parameter description in the section "Creating a Random Number".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li21115822103819">Optimized response parameter description in the section "Querying the Quota of a User".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li63083672103456">Optimized error codes and modified the section "Error Codes".<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul4549509410351"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li10903795103019">Added public error code KMS.0308 and its description.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li2823147103215">Added error codes and their description for creating a grant.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li27348384103215">Added error codes and their description for querying grants on a CMK.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li626654103215">Added error codes and their description for querying grants that can be retired.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li50758988103215">Added error codes and their description for revoking a grant.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li17837330103215">Added error codes and their description for retiring a grant.</li></ul>
+</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row1138921173118"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p6630189315631">2017-06-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p419721845019">This is the fourth official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul4013984015821"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li635257515821">Added sections "Changing the Alias of a CMK" and "Changing the Description of a CMK".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li5338139315823">Optimized the type of parameter <strong id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_b84235270616521">keys</strong> in the section "Querying the List of CMKs".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li9722154152514">Optimized response parameter tables in sections "Querying the Number of Instances" and "Querying Quotas".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li51554625151536">Optimized error codes and modified the section "Error Code".<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul5325711151636"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li60242770151632">Added error codes and their description for changing the alias of a CMK.</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li881973151651">Added error codes and their description for changing the description of a CMK.</li></ul>
+</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row5442983815623"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p2960721015633">2017-02-08</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p122031516501">This is the third official release.</p>
+<p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p4171113415633">Added sections "Querying the Number of Instances" and "Querying Quotas".</p>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row15928092103325"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p2965087103325">2016-12-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p56791454124914">This is the second official release.</p>
+<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul6410828317222"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li3415554317222">Optimized error codes and modified the section "Error Codes".</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li75774017241">Added description about parameter <span class="parmname" id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_parmname778773275105418"><b>encryption_context</b></span> to the following sections:<ul id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_ul177498851752"><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li255312421752">"Creating a DEK"</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li4803734717521">"Creating a Plaintext-Free DEK"</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li3921861117535">"Encrypting a DEK"</li><li id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_li533775917541">"Decrypting a DEK"</li></ul>
+</li></ul>
+</td>
+</tr>
+<tr id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_row5947359616410"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.1.1.3.1.1 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p648803616410">2016-10-29</p>
+</td>
+<td class="cellrowborder" valign="top" width="72.72999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="kms_02_0304__en-us_topic_0112992352_en-us_topic_0172241630_p1946537916410">This is the first official release.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+