[docs] Migrate docs from AsciiDoc to Markdown (#2635)

* delete asciidoc files * add migrated files * Apply suggestions from review Co-authored-by: Josh Mock <josh@joshmock.com> * Apply suggestions from review Co-authored-by: Josh Mock <josh@joshmock.com> * add the new ci checks (#2634) --------- Co-authored-by: Marci W <333176+marciw@users.noreply.github.com> Co-authored-by: Josh Mock <josh@joshmock.com>
2025-02-27 11:51:14 -06:00
parent ac231c859e
commit 3e5e568c07
142 changed files with 18203 additions and 31131 deletions
--- a/docs/reference/transport_request_examples.md
+++ b/docs/reference/transport_request_examples.md
@ -0,0 +1,76 @@
+---
+mapped_pages:
+  - https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/transport_request_examples.html
+---
+
+# transport.request [transport_request_examples]
+
+It can happen that you need to communicate with {{es}} by using an API that is not supported by the client, to mitigate this issue you can directly call `client.transport.request`, which is the internal utility that the client uses to communicate with {{es}} when you use an API method.
+
+::::{note}
+When using the `transport.request` method you must provide all the parameters needed to perform an HTTP call, such as `method`, `path`, `querystring`, and `body`.
+::::
+
+
+::::{tip}
+If you find yourself use this method too often, take in consideration the use of `client.extend`, which will make your code look cleaner and easier to maintain.
+::::
+
+
+```js
+'use strict'
+
+const { Client } = require('@elastic/elasticsearch')
+const client = new Client({
+  cloud: { id: '<cloud-id>' },
+  auth: { apiKey: 'base64EncodedKey' }
+})
+
+async function run () {
+  const bulkResponse = await client.bulk({
+    refresh: true,
+    operations: [
+      { index: { _index: 'game-of-thrones' } },
+      {
+        character: 'Ned Stark',
+        quote: 'Winter is coming.'
+      },
+
+      { index: { _index: 'game-of-thrones' } },
+      {
+        character: 'Daenerys Targaryen',
+        quote: 'I am the blood of the dragon.'
+      },
+
+      { index: { _index: 'game-of-thrones' } },
+      {
+        character: 'Tyrion Lannister',
+        quote: 'A mind needs books like a sword needs a whetstone.'
+      }
+    ]
+  })
+
+  if (bulkResponse.errors) {
+    console.log(bulkResponse)
+    process.exit(1)
+  }
+
+  const response = await client.transport.request({
+    method: 'POST',
+    path: '/game-of-thrones/_search',
+    body: {
+      query: {
+        match: {
+          quote: 'winter'
+        }
+      }
+    },
+    querystring: {}
+  })
+
+  console.log(response)
+}
+
+run().catch(console.log)
+```
+