doc-exports/docs/dms/api-ref/CreatePartition.html
Chen, Junjie ef239b7410 DMS API-REF 20230201 Version
Reviewed-by: Ziuzko, Stanislav <stanislav.ziuzko@t-systems.com>
Co-authored-by: Chen, Junjie <chenjunjie@huawei.com>
Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>
2024-07-03 17:41:26 +00:00

111 lines
7.6 KiB
HTML

<a name="CreatePartition"></a><a name="CreatePartition"></a>
<h1 class="topictitle1">Adding Partitions to a Topic for a Kafka Instance</h1>
<div id="body0000001724493598"><div class="section" id="CreatePartition__section17322125943915"><h4 class="sectiontitle">Function</h4><p id="CreatePartition__p103221159173916">This API is used to add partitions to a topic for a Kafka instance.</p>
<div class="note" id="CreatePartition__note159644115208"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="CreatePartition__p0964111132019">This API is out-of-date and may not be maintained in the future. Please use the API described in <a href="UpdateInstanceTopic.html">Modifying Topics of a Kafka Instance</a>.</p>
</div></div>
</div>
<div class="section" id="CreatePartition__section15322195903917"><h4 class="sectiontitle">URI</h4><p id="CreatePartition__p12322175916391">POST /v2/{project_id}/instances/{instance_id}/management/topics/{topic}/partitions-reassignment</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreatePartition__table33231259123914" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="CreatePartition__row18323105913397"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="CreatePartition__p33240598396">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="CreatePartition__p13324155915397">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="CreatePartition__p1632445919396">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="CreatePartition__p20324759193913">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreatePartition__row203234595393"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="CreatePartition__p113241459163915">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="CreatePartition__p132545911391">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="CreatePartition__p7325185973911">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="CreatePartition__p183251959183916">Project ID. For details about how to obtain a project ID, see <a href="kafka-api-0036212547.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="CreatePartition__row163238597391"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="CreatePartition__p173257591399">instance_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="CreatePartition__p832617599398">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="CreatePartition__p1032655917396">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="CreatePartition__p43261759133917">Instance ID.</p>
</td>
</tr>
<tr id="CreatePartition__row83231659193919"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="CreatePartition__p9326115910399">topic</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="CreatePartition__p12327359143918">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="CreatePartition__p732755916399">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="CreatePartition__p143273598392">Topic name.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreatePartition__section1327125910390"><h4 class="sectiontitle">Request</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreatePartition__request_CreatePartitionReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameter</caption><thead align="left"><tr id="CreatePartition__row032785953911"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="CreatePartition__p63282596399">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="CreatePartition__p1832855919396">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="CreatePartition__p232865916398">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="CreatePartition__p53281659183918">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreatePartition__row20328359193920"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="CreatePartition__p1532945910398">partition</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="CreatePartition__p032995918396">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="CreatePartition__p53296595395">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="CreatePartition__p19329175916394">Total number of partitions after the addition. The value must be larger than current number of partitions. Maximum value: <strong id="CreatePartition__b102951629151116">100</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreatePartition__section203291659153910"><h4 class="sectiontitle">Response</h4><p id="CreatePartition__p733075953920">None.</p>
</div>
<div class="section" id="CreatePartition__section3330959123917"><h4 class="sectiontitle">Example Request</h4><p id="CreatePartition__p153301359203919">Adding partitions to a topic.</p>
<pre class="screen" id="CreatePartition__screen19330105919390">POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/management/topics/{topic}/partitions-reassignment
{
"partition" : 3
}</pre>
</div>
<div class="section" id="CreatePartition__section43315599392"><h4 class="sectiontitle">Example Response</h4><p id="CreatePartition__p1033111599393">None.</p>
</div>
<div class="section" id="CreatePartition__section733110599397"><h4 class="sectiontitle">Status Code</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreatePartition__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="CreatePartition__row23311559173913"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="CreatePartition__p12332459133917">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="CreatePartition__p3332135916392">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreatePartition__row43311259193919"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="CreatePartition__p03321959183914">204</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="CreatePartition__p19332145910396">Partitions added successfully.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreatePartition__section18332125913914"><h4 class="sectiontitle">Error Code</h4><p id="CreatePartition__p73336596397">For details, see <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="kafka-api-0003.html">API V2</a></div>
</div>
</div>