doc-exports/docs/css/umn/css_01_0033.html

<a name="css_01_0033"></a><a name="css_01_0033"></a>

<h1 class="topictitle1">Index Backup and Restoration</h1>
<div id="body0000001282658978"><p id="css_01_0033__p8060118">You can back up index data in clusters. If data loss occurs or you want to retrieve data of a specified duration, you can restore the index data. Index backup is implemented by creating cluster snapshots. When creating a backup for the first time, you are advised to back up data of all indices.</p>
<ul id="css_01_0033__ul117631671909"><li id="css_01_0033__li137631973016"><a href="#css_01_0033__section18551039928">Managing Automatic Snapshot Creation</a>: Snapshots are automatically created at a specified time each day according to the rules you create. You can enable or disable the automatic snapshot creation function and set the automatic snapshot creation policy.</li><li id="css_01_0033__li4224650409"><a href="#css_01_0033__section43906502025">Manually creating a snapshot</a>: You can manually create a snapshot at any time to back up all data or data of specified indices.</li><li id="css_01_0033__li276715741117"><a href="#css_01_0033__section16538152014387">Restoring data</a>: You can use existing snapshots to restore the backup index data to a specified cluster.</li><li id="css_01_0033__li19371162171219"><a href="#css_01_0033__section3105193716428">Deleting a snapshot</a>: Delete snapshots you do not require and release resources.</li></ul>
<div class="note" id="css_01_0033__note172482918317"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="css_01_0033__ul537343941414"><li id="css_01_0033__li133731139171411">Before creating a snapshot, you need to perform basic configurations, including configuring the OBS bucket for storing snapshots and IAM agency used for security authentication.</li><li id="css_01_0033__li1737317391147">If there are available snapshots in the snapshot list when you configure the OBS bucket for storing cluster snapshots for the first time, you cannot change the bucket for snapshots that are subsequently created automatically or manually. Therefore, exercise caution when you configure the OBS bucket.</li><li id="css_01_0033__li133739391144">If you want to change the OBS bucket where there are snapshots, do as follows: Disable the snapshot function, enable it, and specify a new OBS bucket. After you disable the snapshot function, you cannot use previously created snapshots to restore the cluster.</li><li id="css_01_0033__li17941828132019">If a cluster is in the <span class="parmname" id="css_01_0033__parmname13651923162013"><b>Unavailable</b></span> status, you can use the cluster snapshot function only to restore clusters and view existing snapshot information.</li><li id="css_01_0033__li19928141414179">During backup and restoration of a cluster, you can perform only certain operations, including scaling out, accessing Kibana, viewing metric, and deleting other snapshots of clusters. However, you cannot perform the following operations: restarting or deleting the cluster, deleting a snapshot that is in the <strong id="css_01_0033__b207011520162010">Creating</strong> or <strong id="css_01_0033__b1475082742018">Restoring</strong> status, and creating or restoring another snapshot. If a snapshot is being created or restored for a cluster, any automatic snapshot creation task initiated for the cluster will be canceled.</li></ul>
</div></div>
<div class="section" id="css_01_0033__section914018211934"><h4 class="sectiontitle">Prerequisites</h4><p id="css_01_0033__p1353111291039">To use the function of creating or restoring snapshots, the account or IAM user that logs in to the <span id="css_01_0033__text384635914619">CSS</span> management console must have both of the following permissions:</p>
<ul id="css_01_0033__ul10364413962"><li id="css_01_0033__li111102134120"><span class="parmname" id="css_01_0033__parmname195505992117166"><b>Tenant Administrator</b></span> for project <span class="parmname" id="css_01_0033__parmname77759080917166"><b>OBS</b></span> in region <span class="parmname" id="css_01_0033__parmname127798320017166"><b>Global service</b></span></li><li id="css_01_0033__li754585517113"><span class="parmname" id="css_01_0033__parmname748916545244"><b>CSS Administrator</b></span> in the current region</li></ul>
</div>
<div class="section" id="css_01_0033__section18551039928"><a name="css_01_0033__section18551039928"></a><a name="section18551039928"></a><h4 class="sectiontitle">Managing Automatic Snapshot Creation</h4><ol id="css_01_0033__ol1072514121135"><li id="css_01_0033__li07251912434">In the left navigation pane of the <span id="css_01_0033__text19360182541711">CSS</span> management console, click <span class="parmname" id="css_01_0033__parmname15282708197"><b>Clusters</b></span>.</li><li id="css_01_0033__li392216231538">On the <span class="wintitle" id="css_01_0033__wintitle803835227104550"><b>Clusters</b></span> page that is displayed, click the name of the target cluster. On the displayed page, click <span class="wintitle" id="css_01_0033__wintitle14518182417449"><b>Cluster Snapshots</b></span>.</li><li id="css_01_0033__li15189162455017">On the displayed <span class="wintitle" id="css_01_0033__wintitle66381133203511"><b>Cluster Snapshots</b></span> page, click the icon to the right of <span class="parmname" id="css_01_0033__parmname106381433183513"><b>Cluster Snapshot</b></span> to enable the cluster snapshot function.</li><li id="css_01_0033__li1597517249415"><a name="css_01_0033__li1597517249415"></a><a name="li1597517249415"></a>(Optional) After the cluster snapshot function is enabled, <span id="css_01_0033__text893113713717">CSS</span> automatically creates the OBS bucket and IAM agency for you to store snapshots. The automatically created OBS bucket and IAM agency are displayed on the page. If you want to change the OBS bucket and IAM agency, click <span><img id="css_01_0033__image1493257471" src="en-us_image_0000001474246364.png"></span> to the right of <strong id="css_01_0033__b149326714716">Basic Configuration</strong>. To ensure the security of snapshot data, you can select a key to encrypt the snapshot.<p id="css_01_0033__p088212510411">In the displayed <strong id="css_01_0033__b175492416811">Edit Basic Configuration</strong> dialog box, you can either select an existing OBS bucket and IAM agency or create an OBS bucket and IAM agency. To create an OBS bucket, click <span class="uicontrol" id="css_01_0033__uicontrol13611524388"><b>Create Bucket</b></span>. To create an IAM agency, click <span class="uicontrol" id="css_01_0033__uicontrol861424186"><b>Create IAM Agency</b></span>. For details, see <a href="https://docs.otc.t-systems.com/en-us/usermanual/obs/en-us_topic_0045853662.html" target="_blank" rel="noopener noreferrer">Creating a Bucket</a> and <a href="https://docs.otc.t-systems.com/en-us/usermanual/iam/en-us_topic_0046613147.html" target="_blank" rel="noopener noreferrer">Creating an Agency</a>. To encrypt the snapshot, select <strong id="css_01_0033__b190019283419">Snapshot Encryption</strong> and select a key.</p>
<div class="p" id="css_01_0033__p87651121105618">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_01_0033__table109611127114919" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="css_01_0033__row595810278493"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.2.4.5.1.2.4.1.1"><p id="css_01_0033__p695812714916">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.950000000000003%" id="mcps1.3.5.2.4.5.1.2.4.1.2"><p id="css_01_0033__p1395852774918">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.05%" id="mcps1.3.5.2.4.5.1.2.4.1.3"><p id="css_01_0033__p495862734918">Restrictions</p>
</th>
</tr>
</thead>
<tbody><tr id="css_01_0033__row296002719498"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.2.4.5.1.2.4.1.1 "><p id="css_01_0033__p89581827124914">OBS Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="27.950000000000003%" headers="mcps1.3.5.2.4.5.1.2.4.1.2 "><p id="css_01_0033__p795832712491">Name of the OBS bucket used for storing snapshots.</p>
</td>
<td class="cellrowborder" valign="top" width="52.05%" headers="mcps1.3.5.2.4.5.1.2.4.1.3 "><p id="css_01_0033__p169581927104917">The following requirements must be met for existing OBS buckets or those that will be created:</p>
<ul id="css_01_0033__ul196015276499"><li id="css_01_0033__li1496042724916"><span class="parmname" id="css_01_0033__parmname10958122794915"><b>Storage Class</b></span> must be <span class="parmvalue" id="css_01_0033__parmvalue8960162719491"><b>Standard</b></span> or <strong id="css_01_0033__b10548121315362">Warm</strong>.</li><li id="css_01_0033__li153231929162313">When creating a bucket, do not enable the encryption function.</li></ul>
<div class="note" id="css_01_0033__note250514529446"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="css_01_0033__en-us_topic_0000001223754348_p12463145632710">To let an IAM user access an OBS bucket, you need to grant the GetBucketStoragePolicy, GetBucketLocation, ListBucket, and ListAllMyBuckets permissions to the user.</p>
</div></div>
</td>
</tr>
<tr id="css_01_0033__row1996112794910"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.2.4.5.1.2.4.1.1 "><p id="css_01_0033__p3960172744913">IAM Agency</p>
</td>
<td class="cellrowborder" valign="top" width="27.950000000000003%" headers="mcps1.3.5.2.4.5.1.2.4.1.2 "><p id="css_01_0033__p199601727134910">IAM agency authorized by the current account to <span id="css_01_0033__text145564221790">CSS</span> access or maintain data stored in the OBS bucket.</p>
</td>
<td class="cellrowborder" valign="top" width="52.05%" headers="mcps1.3.5.2.4.5.1.2.4.1.3 "><p id="css_01_0033__p15960122764916">The following requirements must be met for existing IAM agencies or those that will be created:</p>
<ul id="css_01_0033__ul29611827194917"><li id="css_01_0033__li1896011275492"><span class="parmname" id="css_01_0033__parmname735915391696"><b>Agency Type</b></span> must be <span class="parmvalue" id="css_01_0033__parmvalue19360739496"><b>Cloud service</b></span>.</li><li id="css_01_0033__li696032784920">Set <strong id="css_01_0033__b4348175752116">Cloud Service</strong> to <strong id="css_01_0033__b15404202192212">CSS</strong>.</li><li id="css_01_0033__li7961182754916">The agency must have the <span class="parmname" id="css_01_0033__parmname89611927134919"><b>Tenant Administrator</b></span> permission for the <strong id="css_01_0033__b11644165119473">OBS(S3)</strong> project in <strong id="css_01_0033__b1164545119472">OBS(S3)</strong>.</li></ul>
</td>
</tr>
<tr id="css_01_0033__row3355132444"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.2.4.5.1.2.4.1.1 "><p id="css_01_0033__p836313194418">Snapshot Encryption</p>
</td>
<td class="cellrowborder" valign="top" width="27.950000000000003%" headers="mcps1.3.5.2.4.5.1.2.4.1.2 "><p id="css_01_0033__p123620130447">Whether to enable the snapshot encryption function. Enabling the snapshot encryption function ensures the security of your snapshot data.</p>
</td>
<td class="cellrowborder" valign="top" width="52.05%" headers="mcps1.3.5.2.4.5.1.2.4.1.3 "><p id="css_01_0033__p83616131445">After selecting <strong id="css_01_0033__b12703185913513">Snapshot Encryption</strong>, select a key from the <strong id="css_01_0033__b1872813196616">Key Name</strong> drop-down list. If no key is available, click <span class="uicontrol" id="css_01_0033__uicontrol1932561718598"><b>Create/View Key</b></span> to switch to the KMS management console to create a key or modify an existing key. For details, see <a href="https://docs.otc.t-systems.com/en-us/usermanual/kms/en-us_topic_0034330265.html" target="_blank" rel="noopener noreferrer">Creating a CMK</a>.</p>
<ul id="css_01_0033__ul67444552406"><li id="css_01_0033__li1985427205916">You cannot use default master keys whose aliases end with <strong id="css_01_0033__b1687161012">/default</strong> in KMS to encrypt snapshots.</li><li id="css_01_0033__li125611344125910">If a snapshot has been stored in the OBS bucket, you cannot modify the parameters used for encrypting the snapshot.</li><li id="css_01_0033__li172633168116">If the key used for encryption is in the <span class="parmname" id="css_01_0033__parmname1438818421415"><b>Pending deletion</b></span> or <span class="parmname" id="css_01_0033__parmname173899429110"><b>disable</b></span> status, you cannot perform backup and restoration operations on the cluster. Specifically, you cannot create new snapshots for the cluster, or use existing snapshots to restore clusters. In this case, switch to the KMS management console and change the status of the target key to <strong id="css_01_0033__b317617751116">enable</strong> so that backup and restore operations are allowed on the cluster.</li><li id="css_01_0033__li116645272515">If you delete the key used for encryption, you cannot perform backup and restore operations on the cluster. In addition, you cannot restore the deleted key. Therefore, exercise caution when deleting a key.</li><li id="css_01_0033__li721012812516">You are advised to disable the automatic snapshot creation function if the key is deleted or is in the <span class="parmname" id="css_01_0033__parmname1364494865411"><b>Pending deletion</b></span> or <span class="parmname" id="css_01_0033__parmname36471248125410"><b>disable</b></span> status. In this case, automatic snapshots will be created based on the configured snapshot policy. However, all automatic snapshot creation tasks will fail, and the failed tasks will be displayed in the <strong id="css_01_0033__b5647348155418">Failed Tasks</strong> dialog box.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<p id="css_01_0033__p1623118111318"></p>
</li><li id="css_01_0033__li17312102775013">Click the icon to the right of <span class="parmname" id="css_01_0033__parmname79609170530"><b>Automatic Snapshot Creation</b></span> to enable the automatic snapshot creation function.</li><li id="css_01_0033__li2251154818503">In the displayed <span class="wintitle" id="css_01_0033__wintitle4492124155012"><b>Edit Snapshot Policy</b></span> dialog box, specify parameters as required.<ul id="css_01_0033__ul1149362415019"><li id="css_01_0033__li20492132417509"><strong id="css_01_0033__b1632713121415">Snapshot Name Prefix</strong>: Enter a maximum of 31 characters starting with a letter. Only lowercase letters, digits, hyphens (-), and underscores (_) are allowed.. A snapshot name consists of a snapshot name prefix and a timestamp. For example, <strong id="css_01_0033__b18316113210165">snapshot-2018022405925</strong>.</li><li id="css_01_0033__li202435371780"><span class="parmname" id="css_01_0033__parmname1371612219571"><b>Time Zone</b></span>: indicates the time zone for the backup time. Specify <span class="parmname" id="css_01_0033__parmname54531038111517"><b>Backup Started</b></span> based on the time zone.</li><li id="css_01_0033__li141069525163"><span class="parmname" id="css_01_0033__parmname2068818825618"><b>Index</b></span>: Enter the name of an index. The automatic snapshot creation function supports backup of certain indices in the cluster. Uppercase letters, spaces, and certain special characters (including "\&lt;|&gt;/?) are not allowed. Use commas (,) to separate multiple indices. If you do not specify this parameter, data of all indices in the cluster is backed up by default. You can use the asterisk (<span class="parmname" id="css_01_0033__parmname82931638265"><b>*</b></span>) to back up data of certain indices. For example, if you enter <strong id="css_01_0033__b1529463192613">index*</strong>, then data of indices with the name prefix of <strong id="css_01_0033__b829417314269">index</strong> will be backed up.<p id="css_01_0033__p7407254171620">You can run the <strong id="css_01_0033__b12606169152316">GET /_cat/indices</strong> command in Kibana to query names of all indices in the cluster. You can then enter the names of the indices you want to back up.</p>
</li><li id="css_01_0033__li164929248506"><span class="parmname" id="css_01_0033__parmname3680251557"><b>Backup Started</b></span>: indicates the time when the backup starts automatically every day. You can specify this parameter only in hours and not minutes, for example, <strong id="css_01_0033__b868018516551">00:00</strong> or <strong id="css_01_0033__b1768005125511">01:00</strong>. The value ranges from <strong id="css_01_0033__b8681254558">00:00</strong> to <strong id="css_01_0033__b146811851559">23:00</strong>. Select the backup time from the drop-down list box.</li><li id="css_01_0033__li9493824155013"><span class="parmname" id="css_01_0033__parmname2457445135517"><b>Retention Period (days)</b></span>: indicates the duration when snapshots are retained in the OBS bucket, in days. The value ranges from <strong id="css_01_0033__b1151115755418">1</strong> to <strong id="css_01_0033__b134975119556">90</strong>. You can specify this parameter as required. The system automatically deletes snapshots that are retained over the specified retention period on the half hour. For example, if you set the snapshot policy as shown in <a href="#css_01_0033__fig1797311351298">Figure 1</a>, the system will automatically delete in 35 days at 00:30 the automated snapshots that were created 35 days earlier at 00:00.</li></ul>
<div class="fignone" id="css_01_0033__fig1797311351298"><a name="css_01_0033__fig1797311351298"></a><a name="fig1797311351298"></a><span class="figcap"><b>Figure 1 </b>Automatic snapshot creation</span><br><span><img id="css_01_0033__image890613211913" src="en-us_image_0000001474725844.png"></span></div>
</li><li id="css_01_0033__li175372485117">Click <span class="uicontrol" id="css_01_0033__uicontrol64700751811611"><b>OK</b></span>.<p id="css_01_0033__p263819436501">After the policy for automatic snapshot creation is created, the policy information will be displayed on the <strong id="css_01_0033__b19901623182914">Cluster Snapshots</strong> page. If you need to change the policy due to business changes, click <span><img id="css_01_0033__image4370919114915" src="en-us_image_0000001474246364.png"></span>.</p>
<p id="css_01_0033__p156381843125015">Snapshots that are automatically created according to the snapshot policy are displayed in the snapshot list, along with manually created snapshots. You can distinguish them by the <strong id="css_01_0033__b56548137183">Snapshot Type</strong> setting. In the upper right corner of the snapshot list, enter the keyword of the snapshot name or snapshot ID to search for the desired snapshots. You can also click <span><img id="css_01_0033__image887164910374" src="en-us_image_0000001474246376.png"></span> to sort snapshots based on related parameter settings.</p>
<div class="fignone" id="css_01_0033__fig4952193916114"><span class="figcap"><b>Figure 2 </b>Automatic snapshot creation</span><br><span><img id="css_01_0033__image58049126119" src="en-us_image_0000001524766289.png"></span></div>
</li><li id="css_01_0033__li48981519132317">(Optional) Disable the automatic snapshot creation function.<p id="css_01_0033__p622541042417"><a name="css_01_0033__li48981519132317"></a><a name="li48981519132317"></a>After you disable the automatic snapshot creation function, the system stops automatic creation of snapshots. If the system is creating a snapshot based on the automatic snapshot creation policy and the snapshot is not yet displayed in the snapshot list, you cannot disable the automatic snapshot creation function. In this case, if you click the button next to <strong id="css_01_0033__b129214495615">Automatic Snapshot Creation</strong>, a message is displayed, indicating that you cannot disable the function. You are advised to disable the function after the system completes automatic creation of the snapshot, and the created snapshot is displayed in the snapshot list.</p>
<p id="css_01_0033__p196228429309">When disabling the automatic snapshot creation function, you can choose whether to delete the snapshots that have been automatically created by selecting <span class="parmname" id="css_01_0033__parmname1311414393420"><b>Delete automated snapshots</b></span> in the displayed dialog box. By default, automatically created snapshots are not deleted.</p>
<ul id="css_01_0033__ul599135212309"><li id="css_01_0033__li5991052103012">If you do not select <span class="parmname" id="css_01_0033__parmname1183151161215"><b>Delete automated snapshots</b></span>, automatically created snapshots are not deleted when you disable the automatic snapshot creation function. You can manually delete them later. For details, see <a href="#css_01_0033__section3105193716428">Deleting a Snapshot</a>. If you do not manually delete the automatically created snapshots and enable the automatic snapshot creation function again, then all snapshots with <span class="parmname" id="css_01_0033__parmname186791716181118"><b>Snapshot Type</b></span> set to <strong id="css_01_0033__b1868091681118">Automated</strong> in the snapshot list of the cluster can only be automatically deleted by the system. Specifically, the system automatically deletes snapshots based on the snapshot policy configured when you enable the automatic snapshot creation function again. For example, if you set <strong id="css_01_0033__b16983134319121">Retention Period (days)</strong> to <strong id="css_01_0033__b11834145615124">10</strong>, the system will automatically delete the snapshots that have been retained for more than 10 days.</li><li id="css_01_0033__li989615428317">If you select <span class="parmname" id="css_01_0033__parmname1759414932"><b>Delete automated snapshots</b></span>, all snapshots with <span class="parmname" id="css_01_0033__parmname1978752653214"><b>Snapshot Type</b></span> set to <strong id="css_01_0033__b1145124833914">Automated</strong> in the snapshot list will be deleted when you disable the automatic snapshot creation function.</li></ul>
</li></ol>
</div>
<div class="section" id="css_01_0033__section43906502025"><a name="css_01_0033__section43906502025"></a><a name="section43906502025"></a><h4 class="sectiontitle">Manually Creating a Snapshot</h4><ol id="css_01_0033__ol1597157201819"><li id="css_01_0033__li928020151910">In the left navigation pane of the <span id="css_01_0033__text1622158152316">CSS</span> management console, click <span class="parmname" id="css_01_0033__parmname1962278152313"><b>Clusters</b></span>.</li><li id="css_01_0033__li12822019195">On the <span class="wintitle" id="css_01_0033__wintitle1528218001917"><b>Clusters</b></span> page that is displayed, click the name of the target cluster. On the displayed page, click <span class="wintitle" id="css_01_0033__wintitle31445126442"><b>Cluster Snapshots</b></span>.<p id="css_01_0033__p13860113612194">Alternatively, on the <span class="wintitle" id="css_01_0033__wintitle1582091415440"><b>Clusters</b></span> page, locate the row that contains the target cluster and click <span class="uicontrol" id="css_01_0033__uicontrol17798537171919"><b>More</b></span> &gt; <span class="uicontrol" id="css_01_0033__uicontrol814301719112"><b>Back Up and Restore</b></span> in the <span class="parmname" id="css_01_0033__parmname208201914194412"><b>Operation</b></span> column to switch to the <span class="wintitle" id="css_01_0033__wintitle182101494419"><b>Cluster Snapshots</b></span> page.</p>
</li><li id="css_01_0033__li05161823125719">On the displayed <span class="wintitle" id="css_01_0033__wintitle351616231575"><b>Cluster Snapshots</b></span> page, click the icon to the right of <span class="parmname" id="css_01_0033__parmname48147403573"><b>Cluster Snapshot</b></span> to enable the cluster snapshot function.<p id="css_01_0033__p1611195019520"><span><img id="css_01_0033__image1611185014528" src="en-us_image_0000001525365809.png"></span> indicates that the cluster snapshot function is disabled.</p>
<p id="css_01_0033__p08141040195719"><span><img id="css_01_0033__image7713134075419" src="en-us_image_0000001525365829.png"></span> indicates that the cluster snapshot function is enabled.</p>
</li><li id="css_01_0033__li1371711473">(Optional) After the cluster snapshot function is enabled, <span id="css_01_0033__text089714310162">CSS</span> automatically creates the OBS bucket and IAM agency for you to store snapshots. The automatically created OBS bucket and IAM agency are displayed on the page. If you want to change the OBS bucket and IAM agency, click <span><img id="css_01_0033__image17898154371617" src="en-us_image_0000001474246364.png"></span> to the right of <strong id="css_01_0033__b9898154311165">Basic Configuration</strong>. For details about how to configure parameters involved in the basic configuration, see <a href="#css_01_0033__li1597517249415">4</a>.</li><li id="css_01_0033__li328516081910">After basic configurations are completed, click <strong id="css_01_0033__b1674112462533">Create</strong>.<ul id="css_01_0033__ul186887875617"><li id="css_01_0033__li143570341602"><strong id="css_01_0033__b19586434162914">Name</strong> indicates the name of the manually created snapshot, which can contain 4 to 64 characters and must start with a lowercase letter. Only lowercase letters, digits, hyphens (-), and underscores (_) are allowed. For snapshots you create manually, you can specify the snapshot name. The system will not automatically add the time information to the snapshot name.</li><li id="css_01_0033__li126881280561"><span class="parmname" id="css_01_0033__parmname1821891188"><b>Index</b></span>: Enter the name of an index. The manually created snapshot can back up data of certain indices in the cluster. The value can contain 0 to 1,024 characters. Uppercase letters, spaces, and certain special characters (including "\&lt;|&gt;/?) are not allowed. Multiple index names are separated by commas (,). If you do not specify this parameter, data of all indices in the cluster is backed up by default. You can use the asterisk (<span class="parmname" id="css_01_0033__parmname2111668232"><b>*</b></span>) to back up data of certain indices. For example, if you enter <strong id="css_01_0033__b1584973572">2018-06*</strong>, then data of indices with the name prefix of <strong id="css_01_0033__b1240961941">2018-06</strong> will be backed up.<div class="note" id="css_01_0033__note97714385358"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="css_01_0033__p677123811352">Run the <strong id="css_01_0033__b59612577164">GET /_cat/indices</strong> command in Kibana to query all index names in the cluster.</p>
</div></div>
</li><li id="css_01_0033__li86881810563"><span class="parmname" id="css_01_0033__parmname8688118135615"><b>Description</b></span>: indicates the description of the created snapshot. The value contains 0 to 256 characters, and certain special characters (<span class="parmname" id="css_01_0033__parmname1958446316174047"><b>&lt;&gt;</b></span>) are not allowed.</li></ul>
<div class="fignone" id="css_01_0033__fig78421105010"><span class="figcap"><b>Figure 3 </b>Creating a snapshot</span><br><span><img id="css_01_0033__image1054884585019" src="en-us_image_0000001524766273.png"></span></div>
</li><li id="css_01_0033__li162011519182916">Click <span class="uicontrol" id="css_01_0033__uicontrol8133254474"><b>OK</b></span>.<p id="css_01_0033__p522415013344">After the snapshot is created, it will be displayed in the snapshot list. The status <strong id="css_01_0033__b1743911132515">Available</strong> indicates that the snapshot is created successfully. All automatically and manually created snapshots are displayed in the snapshot list. You can distinguish them by the <strong id="css_01_0033__b1896771072519">Snapshot Type</strong> setting. In the upper right corner of the snapshot list, enter the keyword of the snapshot name or snapshot ID to search for the desired snapshots. You can also click <span><img id="css_01_0033__image693591775317" src="en-us_image_0000001474246376.png"></span> to sort snapshots based on related parameter settings.</p>
</li></ol>
</div>
<div class="section" id="css_01_0033__section16538152014387"><a name="css_01_0033__section16538152014387"></a><a name="section16538152014387"></a><h4 class="sectiontitle">Restoring Data</h4><p id="css_01_0033__p67277218011">You can use snapshots whose <span class="parmname" id="css_01_0033__parmname732012502566"><b>Snapshot Status</b></span> is <span class="parmvalue" id="css_01_0033__parmvalue116606822101313"><b>Available</b></span> to restore cluster data. The stored snapshot data can be restored to other clusters.</p>
<p id="css_01_0033__p9940624183817">Restoring data will overwrite current data in clusters. Therefore, exercise caution when restoring data.</p>
<ol id="css_01_0033__ol842420532406"><li id="css_01_0033__li16424353174016">In the <strong id="css_01_0033__b499312156487">Snapshots</strong> area, locate the row that contains the snapshot you want to restore and click <span class="uicontrol" id="css_01_0033__uicontrol17993171520488"><b>Restore</b></span> in the <span class="parmname" id="css_01_0033__parmname49930156485"><b>Operation</b></span> column.</li><li id="css_01_0033__li115316101430">In the displayed dialog box, specify parameters as required.<p id="css_01_0033__p5758729448"><a name="css_01_0033__li115316101430"></a><a name="li115316101430"></a><span class="parmname" id="css_01_0033__parmname305852533173346"><b>Index</b></span>: Enter the name of the index you want to restore. If you do not specify any index name, data of all indices will be restored. The value can contain 0 to 1,024 characters. Uppercase letters, spaces, and certain special characters (including "\&lt;|&gt;/?) are not allowed.</p>
<p id="css_01_0033__p1011936842"><span class="parmname" id="css_01_0033__parmname11775549718"><b>Rename Pattern</b></span>: Enter a regular expression. Indices that match the regular expression are restored. The default value <span class="parmvalue" id="css_01_0033__parmvalue215201401018"><b>index_(.+)</b></span> indicates restoring data of all indices. The value contains 0 to 1,024 characters. Uppercase letters, spaces, and certain special characters (including "\&lt;|&gt;/?,) are not allowed.</p>
<p id="css_01_0033__p461114482049"><span class="parmname" id="css_01_0033__parmname1293745717712"><b>Rename Replacement</b></span>: Enter the index renaming rule. The default value <span class="parmvalue" id="css_01_0033__parmvalue563703423114216"><b>restored_index_$1</b></span> indicates that <span class="parmvalue" id="css_01_0033__parmvalue806962896114232"><b>restored_</b></span> is added in front of the names of all restored indices. The value can contain 0 to 1,024 characters. Uppercase letters, spaces, and certain special characters (including "\&lt;|&gt;/?,) are not allowed. You can set <span class="parmname" id="css_01_0033__parmname8406743125715"><b>Rename Replacement</b></span> only if you have specified <span class="parmname" id="css_01_0033__parmname12507141054718"><b>Rename Pattern</b></span>.</p>
<p id="css_01_0033__p114165551149"><span class="parmname" id="css_01_0033__parmname0874120486"><b>Cluster</b></span>: Select the cluster that you want to restore. You can select the current cluster or others. However, you can only restore the snapshot to clusters whose status is <span class="parmname" id="css_01_0033__parmname18702145212217"><b>Available</b></span>. If the status of the current cluster is <span class="parmname" id="css_01_0033__parmname232675192211"><b>Unavailable</b></span>, you cannot restore the snapshot to the current cluster. If you select another cluster and two or more indices in the cluster have the same name, data of all indices with the same name as the name you specify will be overwritten. Therefore, exercise caution when you set the parameters.</p>
<div class="fignone" id="css_01_0033__fig128071912118"><span class="figcap"><b>Figure 4 </b>Restoring a snapshot</span><br><span><img id="css_01_0033__image1343149208" src="en-us_image_0000001525365813.png"></span></div>
<p id="css_01_0033__p1275412448014"></p>
</li><li id="css_01_0033__li14267162211412">Click <span class="uicontrol" id="css_01_0033__uicontrol1346108317431"><b>OK</b></span>. If restoration succeeds, <span class="parmname" id="css_01_0033__parmname316941968135515"><b>Task Status</b></span> of the snapshot in the snapshot list will change to <span class="parmvalue" id="css_01_0033__parmvalue1569249825135521"><b>Restoration succeeded</b></span>, and the index data is generated again according to the snapshot information.<div class="fignone" id="css_01_0033__fig25181595119"><span class="figcap"><b>Figure 5 </b>Successful restoration</span><br><span><img id="css_01_0033__image168371133144215" src="en-us_image_0000001474566000.png"></span></div>
</li></ol>
</div>
<div class="section" id="css_01_0033__section3105193716428"><a name="css_01_0033__section3105193716428"></a><a name="section3105193716428"></a><h4 class="sectiontitle">Deleting a Snapshot</h4><p id="css_01_0033__p17436039154214">If you no longer need a snapshot, delete it to release storage resources. If the automatic snapshot creation function is enabled, snapshots that are automatically created cannot be deleted manually, and the system automatically deletes these snapshots on the half hour after the time specified by <span class="parmname" id="css_01_0033__parmname1728812311264"><b>Retention Period (days)</b></span>. If you disable the automatic snapshot creation function while retaining the automated snapshots, then you can manually delete them later. If you do not manually delete the automatically created snapshots and enable the automatic snapshot creation function again, then all snapshots with <span class="parmname" id="css_01_0033__parmname23829423573"><b>Snapshot Type</b></span> set to <strong id="css_01_0033__b17638024456">Automated</strong> in the snapshot list of the cluster can only be automatically deleted by the system.</p>
<div class="note" id="css_01_0033__note1891143715433"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="css_01_0033__p8918371438">After a snapshot is deleted, its data cannot be restored. Exercise caution when deleting a snapshot.</p>
</div></div>
<ol id="css_01_0033__ol14193131411435"><li id="css_01_0033__li319341419439">In the <strong id="css_01_0033__b849151610485">Snapshots</strong> area, locate the row containing the target snapshot and click <span class="uicontrol" id="css_01_0033__uicontrol11491916184812"><b>Delete</b></span> in the <span class="parmname" id="css_01_0033__parmname10492016194817"><b>Operation</b></span> column.</li><li id="css_01_0033__li1219471434312">In the <span class="wintitle" id="css_01_0033__wintitle6195151413437"><b>Delete Snapshot</b></span> dialog box that is displayed, click <span class="uicontrol" id="css_01_0033__uicontrol7195014174316"><b>Yes</b></span>.</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_01_0009.html">Managing Elasticsearch Clusters</a></div>
</div>
</div>