Add 'Clone Snapshot' API Documentation (opensearch-project#8371)

* Add documentation for Clone Snapshot API

Signed-off-by: Reiya Downs <[email protected]>

* Light edits

Signed-off-by: Reiya Downs <[email protected]>

* Fixed title

Signed-off-by: Reiya Downs <[email protected]>

* Remove unnecessary clone-repository file

Signed-off-by: Reiya Downs <[email protected]>

* Update page with automation markers

Signed-off-by: Naarcha-AWS <[email protected]>

* Remove response body.

Will loop back around once all missing request descriptions have been added to core.

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Update clone-snapshot.md

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

---------

Signed-off-by: Reiya Downs <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Eric Pugh <[email protected]>

Author: 3 people

_api-reference/snapshots/clone-snapshot.md

@@ -0,0 +1,80 @@
+---
+layout: default
+title: Clone snapshot
+parent: Snapshot APIs
+nav_order: 10
+---
+
+# Clone snapshot
+Introduced 1.0
+{: .label .label-purple }
+
+Creates a clone of all or part of a snapshot in the same repository as the original.
+
+
+<!-- spec_insert_start
+api: snapshot.clone
+component: endpoints
+-->
+## Endpoints
+```json
+PUT /_snapshot/{repository}/{snapshot}/_clone/{target_snapshot}
+```
+<!-- spec_insert_end -->
+
+<!-- spec_insert_start
+api: snapshot.clone
+component: path_parameters
+-->
+## Path parameters
+
+The following table lists the available path parameters.
+
+| Parameter | Required | Data type | Description |
+| :--- | :--- | :--- | :--- |
+| `repository` | **Required** | String | The name of repository that will contain the snapshot clone. |
+| `snapshot` | **Required** | String | The name of the original snapshot. |
+| `target_snapshot` | **Required** | String | The name of the cloned snapshot. |
+
+<!-- spec_insert_end -->
+
+
+<!-- spec_insert_start
+api: snapshot.clone
+component: query_parameters
+include_deprecated: false
+-->
+## Query parameters
+
+The following table lists the available query parameters. All query parameters are optional.
+
+| Parameter | Data type | Description |
+| :--- | :--- | :--- |
+| `cluster_manager_timeout` | String | The amount of time to wait for a response from the cluster manager node. For more information about supported time units, see [Common parameters]({{site.url}}{{site.baseurl}}/api-reference/common-parameters/#time-units). |
+
+<!-- spec_insert_end -->
+
+
+## Example request
+
+The following request clones indexes `index_a` and `index_b` from `my_snapshot`, a snapshot located in the snapshot repository `my-opensearch-repo`, into a new snapshot in the same repository called `my_new_snapshot`:
+
+```json
+PUT /_snapshot/my-opensearch-repo/my_snapshot/_clone/my_new_snapshot
+{
+	“indices” : “index_a,index_b”
+}
+```
+{% include copy-curl.html %}
+
+
+## Example response
+
+The successful creation of a snapshot clone returns the following response:
+
+```json
+{ 
+    "acknowledged" : true
+}
+```
+