HTTP Methods Examples Provided 20231026

_api-reference/document-apis/index-document.md

@@ -11,7 +11,7 @@ redirect_from:
 **Introduced 1.0**
 {: .label .label-purple}
 
-Before you can search for data, you must first add documents. This operation adds a single document to your index.
+You can use the Index document operation to add a single document to your index.
 
 ## Example
 
@@ -33,6 +33,53 @@ PUT <index>/_create/<_id>
 POST <index>/_create/<_id>
 ```
 
+- PUT adds or updates documents with a specified ID in the index. Used for controlled document creation or updates.
+- POST adds documents to the index with auto-generated IDs. Useful for adding new documents without specifying IDs.
+- `_create` is a type identifier indicating document creation should only occur if the document with the specified ID doesn't already exist.
+- `<index>` represents the name of the index where the document will be added.
+- `<_id>` represents the unique identifier of the document.
+
+## Adding a sample index and documents to use the HTTP methods 
+
+To add a documents, do the following:
+To do this follow the steps:
+1. Open OpenSearch Dashboards.
+2. Navigate to the hamburger menu. 
+3. In the **Management** section, choose **Dev Tools**.
+4. Enter a command, then press the green triangle play button to send the request. Some example commands follow.
+
+### Create a sample-index
+```json
+PUT /sample-index
+```
+{% include copy-curl.html %}
+
+### Example PUT request
+
+```json
+PUT /sample_index/_doc/1
+{
+  "name": "Example",
+  "price": 29.99,
+  "description": "To be or not to be, that is the question"
+}
+```
+{% include copy-curl.html %}
+
+### Example POST request
+
+```json
+POST /sample_index/_doc
+{
+  "name": "Another Example",
+  "price": 19.99,
+  "description": "We are such stuff as dreams are made on"
+}
+
+```
+{% include copy-curl.html %}
+
+
 ## URL parameters
 
 In your request, you must specify the index you want to add your document to. If the index doesn't already exist, OpenSearch automatically creates the index and adds in your document. All other URL parameters are optional.

_security/access-control/document-level-security.md

@@ -4,35 +4,35 @@ title: Document-level security
 parent: Access control
 nav_order: 85
 redirect_from:
- - /security/access-control/document-level-security/
- - /security-plugin/access-control/document-level-security/
+- /security/access-control/document-level-security/
+- /security-plugin/access-control/document-level-security/
 ---
 
 # Document-level security (DLS)
+Document-level security lets you restrict a role to a subset of documents in an index. The easiest way to get started with document- and field-level security is to open OpenSearch Dashboards and choose **Security**. Then choose **Roles**, create a new role, and review the **Index Permissions** section.
 
-Document-level security lets you restrict a role to a subset of documents in an index.
-For more information about OpenSearch users and roles, see the [documentation](https://opensearch.org/docs/latest/security/access-control/users-roles/#create-roles).
-
-Use the following steps to get started with document-level and field-level security:
-1. Open OpenSearch Dashboards.
-2. Choose **Security** > **Roles**.
-3. Select **Create Role** and provide a name for the role.
-4. Review the **Index permissions** section and any necessary [index permissions](https://opensearch.org/docs/latest/security/access-control/permissions/) for the role. 
-5. Add document-level security, with the addition of a domain-specific language (DSL) query in the `Document level security - optional` section. A typical request sent to the `_search` API includes `{ "query": { ... } }` around the query, but with document-level security in OpenSearch Dashboards, you only need to specify the query itself. For example, the following DSL query specifies that for the new role to have access to a document, the query's `genres` field must include `Comedy`:
-
-   ```json
-   {
-     "bool": {
-       "must": {
-         "match": {
-           "genres": "Comedy"
-         }
-       }
-     }
-   }
-   ```
-
-   - ![Document- and field-level security screen in OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/images/security-dls.png)
+![Document- and field-level security screen in OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/images/security-dls.png)
+
+
+## Simple roles
+
+Document-level security uses the OpenSearch query DSL to define which documents a role grants access to. In OpenSearch Dashboards, choose an index pattern and provide a query in the **Document level security** section:
+
+```json
+{
+  "bool": {
+    "must": {
+      "match": {
+        "genres": "Comedy"
+      }
+    }
+  }
+}
+```
+
+This query specifies that for the role to have access to a document, its `genres` field must include `Comedy`.
+
+A typical request to the `_search` API includes `{ "query": { ... } }` around the query, but in this case, you only need to specify the query itself.
 
 ## Updating roles by accessing the REST API