From 320264a370c48b786fe3dbfb1f5935e3aa638e70 Mon Sep 17 00:00:00 2001 From: rakhi-prathap Date: Tue, 10 Jun 2025 09:41:18 +0530 Subject: [PATCH 01/25] [DOC-10001] Update Query Admin API to add new logging parameters (#167) --- docs/modules/n1ql-rest-admin/pages/index.adoc | 139 +++++++++++++++++- src/admin/swagger/admin.yaml | 50 +++++++ 2 files changed, 188 insertions(+), 1 deletion(-) diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 2e2e8b0d..22ef7fd2 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -4599,7 +4599,7 @@ endif::[] [#models] = Definitions -:count-models: 10 +:count-models: 12 :leveloffset: +1 @@ -4616,6 +4616,8 @@ endif::collapse-models[] <> <> <> +<> +<> <> <> <> @@ -5008,6 +5010,40 @@ If specified, all completed queries with this user name are logged. a| String +a| +*statement* + +_optional_ +a| + +[markdown] +-- +A LIKE search pattern to match against the query text. +If specified, all completed queries where the pattern is found are logged. + +-- + +[%hardbreaks] +*Default:* `pass:c[""]` +*Example:* `pass:c["%FIND USER%"]` +{blank} +a| String + + +a| +*plan* + +_optional_ +a| + +[markdown] +-- +include::index.adoc[tag=desc-Logging_Parameters_Plan, opts=optional] +-- + +[%hardbreaks] +{blank} +a| <> + + |=== //end::Logging_Parameters[] @@ -5025,6 +5061,107 @@ a| String +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#Logging_Parameters_Plan] += Plan Qualifier + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan/definition-begin.adoc[opts=optional] + + +.icon:bars[fw] Composite Schema +{blank} + +One of the following: + +* <> + + +* <> + array + + + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan_Pairs/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#Logging_Parameters_Plan_Pairs] += Field:Value Pairs + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan_Pairs/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::Logging_Parameters_Plan_Pairs[] + + +[cols="25,55,20"] +|=== +| Property | | Schema + +a| +_additional + +property_ +a| + +[markdown] +-- +A field:value pair describing a field in the query plan, and the value that the field must have for the request to be logged. +The name of the property is the name of the field in the query plan. +The value may be a string, number, array, or any other JSON value. + +Within a single JSON object, if multiple field:value pairs are specified, then all pairs must be matched (using AND). +For example, `{"index": "ix1", "#operator": "IntersectScan"}` specifies that if the query plan has an `index` field with the value `"ix1"` AND has an `IntersectScan` operator, then the request should be logged. + +Within an array of JSON objects, each field:value pair must be unique, but fields can be repeated. +For example, `[{"index": "ix1"}, {"index": "ix2"}]` specifies that if the query plan has an `index` field with the value `"ix1"` AND another `index` field with the value `"ix2"`, then the request should be logged. +-- + +[%hardbreaks] +{blank} +a| Any Type + + +|=== + +//end::Logging_Parameters_Plan_Pairs[] + + + + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan_Pairs/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/Logging_Parameters_Plan_Pairs/definition-after.adoc[opts=optional] + + + + // markup not found, no include::{specDir}definitions/Metrics/definition-before.adoc[opts=optional] diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index e09ecb9c..7e96bbd6 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -1474,6 +1474,18 @@ components: description: | A user name, as given in the request credentials. If specified, all completed queries with this user name are logged. + statement: + type: string + default: "" + example: "%FIND USER%" + x-has-default: true + x-has-example: true + description: | + A LIKE search pattern to match against the query text. + If specified, all completed queries where the pattern is found are logged. + plan: + $ref: "#/components/schemas/Logging_Parameters_Plan" + completed-limit: type: integer format: int32 @@ -2151,6 +2163,44 @@ components: [queryUseReplica]: #queryUseReplica [use_replica_req]: #use_replica_req + Logging_Parameters_Plan: + title: Plan Qualifier + description: |- + An object, or an array of objects, containing one or more field:value pairs to match against the query plan. + Each pair describes a field in the query plan and the value it must have. + All completed queries where the specified field:value pairs are found in the plan are logged. + oneOf: + - $ref: '#/components/schemas/Logging_Parameters_Plan_Pairs' + - type: array + title: 'Repeated Field:Value Pairs' + example: + - index: ix1 + - index: ix2 + x-has-example: true + items: + $ref: '#/components/schemas/Logging_Parameters_Plan_Pairs' + + Logging_Parameters_Plan_Pairs: + type: object + title: 'Field:Value Pairs' + default: {} + example: + index: ix1 + '#operator': IntersectScan + x-has-default: true + x-has-example: true + additionalProperties: + description: |- + A field:value pair describing a field in the query plan, and the value that the field must have for the request to be logged. + The name of the property is the name of the field in the query plan. + The value may be a string, number, array, or any other JSON value. + + Within a single JSON object, if multiple field:value pairs are specified, then all pairs must be matched (using AND). + For example, `{"index": "ix1", "#operator": "IntersectScan"}` specifies that if the query plan has an `index` field with the value `"ix1"` AND has an `IntersectScan` operator, then the request should be logged. + + Within an array of JSON objects, each field:value pair must be unique, but fields can be repeated. + For example, `[{"index": "ix1"}, {"index": "ix2"}]` specifies that if the query plan has an `index` field with the value `"ix1"` AND another `index` field with the value `"ix2"`, then the request should be logged. + Garbage: type: object title: Garbage Collection From b8ec7faa51342b25ede693315cb0bf49e2a8e279 Mon Sep 17 00:00:00 2001 From: rakhi-prathap Date: Thu, 12 Jun 2025 15:05:55 +0530 Subject: [PATCH 02/25] [DOC-13257] Add new request fields to Query Service and Query Admin APIs (#168) --- docs/modules/n1ql-rest-admin/pages/index.adoc | 97 +++++++++++++++++++ docs/modules/n1ql-rest-query/pages/index.adoc | 95 +++++++++++++++++- src/admin/swagger/admin.yaml | 51 ++++++++++ src/query-service/swagger/query-service.yaml | 50 ++++++++++ 4 files changed, 290 insertions(+), 3 deletions(-) diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 22ef7fd2..274e763f 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -5606,6 +5606,25 @@ Refer to the [request-level][client_context_id] `client_context_id` parameter fo a| String +a| +*cpuTime* + +_optional_ +a| + +[markdown] +-- +The total sum of [execTime][exec_time] across all operators. + +[exec_time]: ../n1ql-rest-query/index.html#exec_time + +-- + +[%hardbreaks] +*Example:* `pass:c["90.734075ms"]` +{blank} +a| String (duration) + + a| *elapsedTime* + _optional_ @@ -5638,6 +5657,25 @@ Total number of errors encountered while executing the query. a| Integer +a| +*ioTime* + +_optional_ +a| + +[markdown] +-- +The total sum of [servTime][serv_time] across all operators. + +[serv_time]: ../n1ql-rest-query/index.html#serv_time + +-- + +[%hardbreaks] +*Example:* `pass:c["752.858519ms"]` +{blank} +a| String (duration) + + a| *memoryQuota* + _optional_ @@ -5836,6 +5874,28 @@ Total amount of calendar time taken to complete the query. a| String (duration) +a| +*sessionMemory* + +_optional_ +a| + +[markdown] +-- +The memory session size for the request, in bytes. + +Each request has a dedicated memory session. +When a query requires a document or value, memory is allocated from this session based on the size of the document or value. +Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. + +This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. + +-- + +[%hardbreaks] +{blank} +a| Integer (bytes) + + a| *state* + _optional_ @@ -5934,6 +5994,43 @@ Username with whose privileges the query is run. a| String +a| +*waitTime* + +_optional_ +a| + +[markdown] +-- +The total sum of [kernTime][kern_time] across all operators. + +[kern_time]: ../n1ql-rest-query/index.html#kern_time + +-- + +[%hardbreaks] +*Example:* `pass:c["1.201307s"]` +{blank} +a| String (duration) + + +a| +*~analysis* + +_optional_ +a| + +[markdown] +-- +An array of text phrases that provide a basic analysis of the request execution. +These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. + +-- + +[%hardbreaks] +*Example:* `["High IO time","High primary scan document count"]` +{blank} +a| String + array + |=== //end::Requests[] diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 5cf73b93..d6e7c4fa 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -1191,6 +1191,26 @@ The number of warnings that occurred during the request. a| Integer (unsigned) +a| +*sessionMemory* + +_optional_ +a| + +[markdown] +-- +The memory session size for the request, in bytes. + +Each request has a dedicated memory session. When a query requires a document or value, memory is allocated from this session based on the size of the document or value. Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. + +This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. + +-- + +[%hardbreaks] +{blank} +a| Integer (bytes) + + |=== //end::Metrics[] @@ -1340,6 +1360,75 @@ include::index.adoc[tag=desc-Execution_Timings, opts=optional] a| <> +a| +*ioTime* + +_optional_ +a| + +[markdown] +-- +The total sum of [servTime](#serv_time) across all operators. + +-- + +[%hardbreaks] +*Example:* `pass:c["752.858519ms"]` +{blank} +a| String (duration) + + +a| +*waitTime* + +_optional_ +a| + +[markdown] +-- +The total sum of [kernTime](#kern_time) across all operators. + +-- + +[%hardbreaks] +*Example:* `pass:c["1.201307s"]` +{blank} +a| String (duration) + + +a| +*cpuTime* + +_optional_ +a| + +[markdown] +-- +The total sum of [execTime](#exec_time) across all operators. + +-- + +[%hardbreaks] +*Example:* `pass:c["90.734075ms"]` +{blank} +a| String (duration) + + +a| +*~analysis* + +_optional_ +a| + +[markdown] +-- +An array of text phrases that provide a basic analysis of the request execution. +These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. + +-- + +[%hardbreaks] +*Example:* `["High IO time","High primary scan document count"]` +{blank} +a| String + array + |=== //end::Profile[] @@ -2788,7 +2877,7 @@ Number of switches between executing, waiting for services, or waiting for the g a| Integer (int32) -a| +a| [#exec_time] *execTime* + _optional_ a| @@ -2804,7 +2893,7 @@ Time spent executing the operator code inside SQL++ query engine. a| String (duration) -a| +a| [#kern_time] *kernTime* + _optional_ a| @@ -2820,7 +2909,7 @@ Time spent waiting to be scheduled for CPU time. a| String (duration) -a| +a| [#serv_time] *servTime* + _optional_ a| diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index 7e96bbd6..ce53cba0 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -660,6 +660,15 @@ components: [client_context_id]: ../n1ql-rest-query/index.html#client_context_id x-desc-refs: | [client_context_id]: #client_context_id + cpuTime: + type: string + format: duration + description: | + The total sum of [execTime][exec_time] across all operators. + + [exec_time]: ../n1ql-rest-query/index.html#exec_time + x-has-example: true + example: "90.734075ms" elapsedTime: type: string format: duration @@ -669,6 +678,15 @@ components: errorCount: type: integer description: Total number of errors encountered while executing the query. + ioTime: + type: string + format: duration + description: | + The total sum of [servTime][serv_time] across all operators. + + [serv_time]: ../n1ql-rest-query/index.html#serv_time + x-has-example: true + example: "752.858519ms" memoryQuota: type: integer description: | @@ -747,6 +765,17 @@ components: type: string format: duration description: Total amount of calendar time taken to complete the query. + sessionMemory: + type: integer + format: bytes + description: | + The memory session size for the request, in bytes. + + Each request has a dedicated memory session. + When a query requires a document or value, memory is allocated from this session based on the size of the document or value. + Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. + + This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. state: type: string description: | @@ -773,6 +802,28 @@ components: users: type: string description: Username with whose privileges the query is run. + waitTime: + type: string + format: duration + description: | + The total sum of [kernTime][kern_time] across all operators. + + [kern_time]: ../n1ql-rest-query/index.html#kern_time + x-has-example: true + example: "1.201307s" + ~analysis: + type: array + items: + type: string + description: | + An array of text phrases that provide a basic analysis of the request execution. + These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. + x-has-example: true + example: + [ + "High IO time", + "High primary scan document count" + ] Statements: type: object diff --git a/src/query-service/swagger/query-service.yaml b/src/query-service/swagger/query-service.yaml index 429e5ba8..76012f96 100644 --- a/src/query-service/swagger/query-service.yaml +++ b/src/query-service/swagger/query-service.yaml @@ -1198,6 +1198,19 @@ components: type: integer format: unsigned description: The number of warnings that occurred during the request. + sessionMemory: + type: integer + format: bytes + description: > + The memory session size for the request, in bytes. + + + Each request has a dedicated memory session. + When a query requires a document or value, memory is allocated from this session based on the size of the document or value. + Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. + + + This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. Controls: type: object @@ -1326,18 +1339,21 @@ components: execTime: type: string format: duration + x-desc-name: exec_time description: Time spent executing the operator code inside SQL++ query engine. x-has-example: true example: "128.434µs" kernTime: type: string format: duration + x-desc-name: kern_time description: Time spent waiting to be scheduled for CPU time. x-has-example: true example: "15.027879ms" servTime: type: string format: duration + x-desc-name: serv_time description: | Time spent waiting for another service, such as index or data. @@ -1349,6 +1365,40 @@ components: '~child': type: object description: Further nested operators, each with their own execution timings. + ioTime: + type: string + format: duration + description: | + The total sum of [servTime](#serv_time) across all operators. + x-has-example: true + example: "752.858519ms" + waitTime: + type: string + format: duration + description: | + The total sum of [kernTime](#kern_time) across all operators. + x-has-example: true + example: "1.201307s" + cpuTime: + type: string + format: duration + description: | + The total sum of [execTime](#exec_time) across all operators. + x-has-example: true + example: "90.734075ms" + ~analysis: + type: array + items: + type: string + description: | + An array of text phrases that provide a basic analysis of the request execution. + These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. + x-has-example: true + example: + [ + "High IO time", + "High primary scan document count" + ] securitySchemes: Header: From 1cbe3ffd89b915a8716b612ce88098be4355d15a Mon Sep 17 00:00:00 2001 From: Simon Dew Date: Tue, 19 Aug 2025 21:42:24 +0100 Subject: [PATCH 03/25] DOC-12312: streaming completed requests to local files (#149) * Add completed-stream-size to Admin REST API --- src/admin/swagger/admin.yaml | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index ce53cba0..61e92791 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -1451,7 +1451,7 @@ components: A nested object that sets the parameters for the completed requests catalog. All completed requests that match these parameters are tracked in the completed requests catalog. - Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. + Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config properties: @@ -1501,7 +1501,7 @@ components: description: | A unique string which tags a set of qualifiers. - Refer to [Configure the Completed Requests][sys-completed-config] for more information. + Refer to [Configure Completed Requests][sys-completed-config] for more information. [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config threshold: @@ -1551,7 +1551,7 @@ components: Increase this when the completed request keyspace is not big enough to track the slow requests, such as when you want a larger sample of slow requests. - Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. + Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1578,7 +1578,7 @@ components: Queries with plans larger than this are not logged. You must obtain execution plans for such queries via profiling or using the EXPLAIN statement. - Refer to [Configure the Completed Requests][sys-completed-config] for more information. + Refer to [Configure Completed Requests][sys-completed-config] for more information. The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1587,6 +1587,22 @@ components: [queryCompletedMaxPlanSize]: ../n1ql-rest-settings/index.html#queryCompletedMaxPlanSize x-desc-refs: | [queryCompletedMaxPlanSize]: #queryCompletedMaxPlanSize + completed-stream-size: + type: integer + format: int32 + default: 0 + x-desc-name: completed-stream-size + description: | + A file size in MiB. + When specified, completed requests are saved to the Couchbase Server `logs` directory. + Completed requests are saved to GZIP archives with the prefix `local_request_log`. + The value of this property determines the size of the data to retain, per node. + + Specify `0` (the default) to disable completed request streaming. + + Refer to [Stream Completed Requests][sys-history] for more information and examples. + + [sys-history]: /server/8.0/manage/monitor/monitoring-n1ql-query.html#sys-history completed-threshold: type: integer format: int32 @@ -1602,7 +1618,7 @@ components: Specify `0` to track all requests, independent of duration. Specify any negative number to track none. - Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. + Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. From 55fe125a1e3c55461b2f95b7ac81f0fa4cd06849 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Fri, 29 Nov 2024 23:19:16 +0000 Subject: [PATCH 04/25] DOC-12776: Create OpenAPI spec for Eventing REST API (#160) * Add Eventing REST API * Add links to external schemas * Update build.gradle and settings.gradle * Add example snippets * Add partials * Add page alias * Template: update passthroughs in fixed-width text * Templates: implement external docs at spec-level * Templates: use alternate table separator to allow vertical bars * Templates: Move consumes and produces into operation description * Rebuild output documentation --- build.gradle | 1 + .../analytics-rest-admin/pages/index.adoc | 708 +- .../analytics-rest-config/pages/index.adoc | 411 +- .../analytics-rest-library/pages/index.adoc | 134 +- .../analytics-rest-links/pages/index.adoc | 1238 ++- .../analytics-rest-service/pages/index.adoc | 425 +- .../analytics-rest-settings/pages/index.adoc | 58 +- .../eventing-rest-api/pages/index.adoc | 8598 +++++++++++++++++ .../AddFunction/definition-before.adoc | 4 + .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 57 + .../partials/overview/document-end.adoc | 9 + .../adv_function_import/http-request.adoc | 21 + .../adv_function_import_all/http-request.adoc | 11 + .../paths/adv_function_view/http-request.adoc | 39 + .../adv_function_view_all/http-request.adoc | 20 + .../paths/adv_function_zap/http-request.adoc | 19 + .../adv_function_zap_all/http-request.adoc | 10 + .../adv_multiple_export/http-request.adoc | 20 + .../adv_multiple_import/http-request.adoc | 11 + .../paths/adv_settings_get/http-request.adoc | 39 + .../adv_settings_update/http-request.adoc | 159 + .../paths/adv_structure_get/http-request.adoc | 39 + .../adv_structure_update/http-request.adoc | 63 + .../paths/adv_text_get/http-request.adoc | 39 + .../paths/adv_text_update/http-request.adoc | 71 + .../paths/basic_deploy/http-request.adoc | 19 + .../paths/basic_pause/http-request.adoc | 19 + .../paths/basic_resume/http-request.adoc | 19 + .../paths/basic_undeploy/http-request.adoc | 19 + .../paths/config_get/http-request.adoc | 10 + .../paths/config_update/http-request.adoc | 45 + .../operation-description-after.adoc | 8 + .../partials/paths/list_all/http-request.adoc | 10 + .../paths/list_query/http-request.adoc | 30 + .../partials/paths/log_view/http-request.adoc | 59 + .../paths/stats_all/http-request.adoc | 19 + .../paths/stats_execution/http-request.adoc | 19 + .../paths/stats_failure/http-request.adoc | 19 + .../paths/stats_latency/http-request.adoc | 19 + .../paths/stats_reset/http-request.adoc | 19 + .../paths/status_all/http-request.adoc | 10 + .../paths/status_function/http-request.adoc | 19 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../modules/index-rest-stats/pages/index.adoc | 379 +- docs/modules/n1ql-rest-admin/pages/index.adoc | 1829 ++-- .../n1ql-rest-functions/pages/index.adoc | 200 +- docs/modules/n1ql-rest-query/pages/index.adoc | 700 +- .../n1ql-rest-settings/pages/index.adoc | 287 +- settings.gradle | 3 + src/eventing/eventing.gradle | 32 + src/eventing/swagger/eventing.yaml | 929 ++ templates/index.mustache | 49 +- templates/model.mustache | 16 +- templates/param.mustache | 12 +- templates/params.mustache | 20 +- templates/property.mustache | 6 +- 58 files changed, 13813 insertions(+), 3222 deletions(-) create mode 100644 docs/modules/eventing-rest-api/pages/index.adoc create mode 100644 docs/modules/eventing-rest-api/partials/definitions/AddFunction/definition-before.adoc create mode 100644 docs/modules/eventing-rest-api/partials/header-attributes.adoc create mode 100644 docs/modules/eventing-rest-api/partials/overview/document-before.adoc create mode 100644 docs/modules/eventing-rest-api/partials/overview/document-end.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_function_import/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_function_import_all/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_function_view/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_function_view_all/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_function_zap/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_function_zap_all/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_multiple_export/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_multiple_import/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_settings_get/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_structure_get/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_structure_update/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_text_get/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/adv_text_update/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/basic_deploy/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/basic_pause/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/basic_resume/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/basic_undeploy/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/list_all/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/list_query/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/log_view/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/stats_all/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/stats_execution/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/stats_failure/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/stats_latency/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/stats_reset/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/status_all/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/paths/status_function/http-request.adoc create mode 100644 docs/modules/eventing-rest-api/partials/security/document-begin.adoc create mode 100644 docs/modules/eventing-rest-api/partials/security/document-end.adoc create mode 100644 src/eventing/eventing.gradle create mode 100644 src/eventing/swagger/eventing.yaml diff --git a/build.gradle b/build.gradle index 7bfefd4b..a8e27363 100644 --- a/build.gradle +++ b/build.gradle @@ -26,6 +26,7 @@ wrapper { defaultTasks 'admin:openApiGenerate', 'query-service:openApiGenerate', 'query-settings:openApiGenerate', + 'eventing:openApiGenerate', 'functions:openApiGenerate', 'indexes:openApiGenerate', 'analytics-admin:openApiGenerate', diff --git a/docs/modules/analytics-rest-admin/pages/index.adoc b/docs/modules/analytics-rest-admin/pages/index.adoc index abfdd0c0..55cb5e0c 100644 --- a/docs/modules/analytics-rest-admin/pages/index.adoc +++ b/docs/modules/analytics-rest-admin/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Analytics service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Analytics service REST port. Use `18095` for secure access. [%hardbreaks] *Values:* `8095`, `18095` -*Example:* `pass:c[8095]` +*Example:* `+++8095+++` // end |=== @@ -179,6 +179,15 @@ Cancels an active request. // markup not found, no include::{specDir}paths/cancel_request/operation-description-end.adoc[opts=optional] + +[#cancel_request-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#cancel_request-produces] +.Produces +* application/json + :leveloffset: -1 @@ -204,13 +213,13 @@ Cancels an active request. .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *client_context_id* + +a¦ *client_context_id* + _required_ -a| +a¦ [markdown] @@ -221,7 +230,7 @@ Identifier passed by the client that is used to identify an active request to be [%hardbreaks] {blank} -a| String +a¦ String @@ -239,16 +248,6 @@ a| String // markup not found, no include::{specDir}paths/cancel_request/operation-parameters-after.adoc[opts=optional] -[#cancel_request-produces] -= Produces - -* application/json - -[#cancel_request-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/cancel_request/operation-responses-before.adoc[opts=optional] @@ -388,6 +387,12 @@ Shows various details about the current status of the Analytics Service, such as // markup not found, no include::{specDir}paths/cluster_status/operation-description-end.adoc[opts=optional] + + +[#cluster_status-produces] +.Produces +* application/json + :leveloffset: -1 @@ -405,12 +410,6 @@ Shows various details about the current status of the Analytics Service, such as // markup not found, no include::{specDir}paths/cluster_status/operation-parameters-after.adoc[opts=optional] -[#cluster_status-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/cluster_status/operation-responses-before.adoc[opts=optional] @@ -546,6 +545,12 @@ Gets a list of all completed analytic requests. // markup not found, no include::{specDir}paths/completed_requests/operation-description-end.adoc[opts=optional] + + +[#completed_requests-produces] +.Produces +* application/json + :leveloffset: -1 @@ -563,12 +568,6 @@ Gets a list of all completed analytic requests. // markup not found, no include::{specDir}paths/completed_requests/operation-parameters-after.adoc[opts=optional] -[#completed_requests-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/completed_requests/operation-responses-before.adoc[opts=optional] @@ -704,6 +703,12 @@ Shows the progress of ingestion by the Analytics service, for each Analytics col // markup not found, no include::{specDir}paths/ingestion_status/operation-description-end.adoc[opts=optional] + + +[#ingestion_status-produces] +.Produces +* application/json + :leveloffset: -1 @@ -721,12 +726,6 @@ Shows the progress of ingestion by the Analytics service, for each Analytics col // markup not found, no include::{specDir}paths/ingestion_status/operation-parameters-after.adoc[opts=optional] -[#ingestion_status-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/ingestion_status/operation-responses-before.adoc[opts=optional] @@ -866,6 +865,12 @@ NOTE: This endpoint may not return meaningful results in Couchbase Server 7.0 an // markup not found, no include::{specDir}paths/monitor_node/operation-description-end.adoc[opts=optional] + + +[#monitor_node-produces] +.Produces +* application/json + :leveloffset: -1 @@ -883,12 +888,6 @@ NOTE: This endpoint may not return meaningful results in Couchbase Server 7.0 an // markup not found, no include::{specDir}paths/monitor_node/operation-parameters-after.adoc[opts=optional] -[#monitor_node-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/monitor_node/operation-responses-before.adoc[opts=optional] @@ -1024,6 +1023,12 @@ Restarts all Analytics Service nodes in the cluster. // markup not found, no include::{specDir}paths/restart_cluster/operation-description-end.adoc[opts=optional] + + +[#restart_cluster-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1041,12 +1046,6 @@ Restarts all Analytics Service nodes in the cluster. // markup not found, no include::{specDir}paths/restart_cluster/operation-parameters-after.adoc[opts=optional] -[#restart_cluster-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/restart_cluster/operation-responses-before.adoc[opts=optional] @@ -1182,6 +1181,12 @@ Restarts the specified Analytics Service node. // markup not found, no include::{specDir}paths/restart_node/operation-description-end.adoc[opts=optional] + + +[#restart_node-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1199,12 +1204,6 @@ Restarts the specified Analytics Service node. // markup not found, no include::{specDir}paths/restart_node/operation-parameters-after.adoc[opts=optional] -[#restart_node-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/restart_node/operation-responses-before.adoc[opts=optional] @@ -1340,6 +1339,12 @@ Gets a list of the analytic requests that are running. // markup not found, no include::{specDir}paths/return_active_requests/operation-description-end.adoc[opts=optional] + + +[#return_active_requests-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1357,12 +1362,6 @@ Gets a list of the analytic requests that are running. // markup not found, no include::{specDir}paths/return_active_requests/operation-parameters-after.adoc[opts=optional] -[#return_active_requests-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/return_active_requests/operation-responses-before.adoc[opts=optional] @@ -1539,14 +1538,14 @@ An object containing a single links property. //end::desc-Ingestion[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *links* + _optional_ -a| +a¦ [markdown] -- @@ -1555,7 +1554,7 @@ An array of objects, each giving information about a single linked Analytics sco [%hardbreaks] {blank} -a| <> +a¦ <> array |=== @@ -1595,14 +1594,14 @@ endif::collapse-models[] //tag::IngestionLink[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *name* + _optional_ -a| +a¦ [markdown] -- @@ -1610,15 +1609,15 @@ The name of the link. -- [%hardbreaks] -*Example:* `pass:c["Local"]` +*Example:* `+++"Local"+++` {blank} -a| String +a¦ String -a| +a¦ *scope* + _optional_ -a| +a¦ [markdown] -- @@ -1626,15 +1625,15 @@ The name of the Analytics scope. -- [%hardbreaks] -*Example:* `pass:c["travel-sample/inventory"]` +*Example:* `+++"travel-sample/inventory"+++` {blank} -a| String +a¦ String -a| +a¦ *status* + _optional_ -a| +a¦ [markdown] -- @@ -1643,15 +1642,15 @@ The status of the Analytics scope. [%hardbreaks] *Values:* `"healthy"`, `"stopped"`, `"unhealthy"`, `"suspended"` -*Example:* `pass:c["healthy"]` +*Example:* `+++"healthy"+++` {blank} -a| String +a¦ String -a| +a¦ *state* + _optional_ -a| +a¦ [markdown] -- @@ -1663,7 +1662,7 @@ Analytics collections which have the same ingestion state within this Analytics [%hardbreaks] {blank} -a| <> +a¦ <> array |=== @@ -1703,14 +1702,14 @@ endif::collapse-models[] //tag::IngestionLinkState[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *timestamp* + _required_ -a| +a¦ [markdown] -- @@ -1720,13 +1719,13 @@ The time since epoch that this sample was calculated, in milliseconds. [%hardbreaks] *Example:* `1631273689161` {blank} -a| Integer +a¦ Integer -a| +a¦ *progress* + _required_ -a| +a¦ [markdown] -- @@ -1738,13 +1737,13 @@ The percentage (fraction from 0 to 1) of ingestion progress at the current time. *Maximum:* `1` *Example:* `0` {blank} -a| Double (double) +a¦ Double (double) -a| +a¦ *timeLag* + _optional_ -a| +a¦ [markdown] -- @@ -1755,13 +1754,13 @@ The estimated time that the ingestion lags behind the Data service, in milliseco [%hardbreaks] *Example:* `9744` {blank} -a| Integer +a¦ Integer -a| +a¦ *itemsProcessed* + _optional_ -a| +a¦ [markdown] -- @@ -1774,13 +1773,13 @@ Note that this value is reset on connect, so it may appear to get smaller. [%hardbreaks] *Example:* `12301` {blank} -a| Integer +a¦ Integer -a| +a¦ *seqnoAdvances* + _optional_ -a| +a¦ [markdown] -- @@ -1791,13 +1790,13 @@ The change in sequence number (seqno) since last connect. Only displayed for Ana [%hardbreaks] *Example:* `61` {blank} -a| Integer +a¦ Integer -a| +a¦ *scopes* + _required_ -a| +a¦ [markdown] -- @@ -1806,7 +1805,7 @@ An array of objects, each one giving information about a single Analytics scope. [%hardbreaks] {blank} -a| <> +a¦ <> array |=== @@ -1846,14 +1845,14 @@ endif::collapse-models[] //tag::IngestionLinkStateScope[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *name* + _required_ -a| +a¦ [markdown] -- @@ -1861,15 +1860,15 @@ The name of the Analytics scope. -- [%hardbreaks] -*Example:* `pass:c["travel-sample/inventory"]` +*Example:* `+++"travel-sample/inventory"+++` {blank} -a| String +a¦ String -a| +a¦ *collections* + _required_ -a| +a¦ [markdown] -- @@ -1878,7 +1877,7 @@ An array of objects, each one giving information about a single Analytics collec [%hardbreaks] {blank} -a| <> +a¦ <> array |=== @@ -1918,14 +1917,14 @@ endif::collapse-models[] //tag::IngestionLinkStateScopeColl[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *name* + _required_ -a| +a¦ [markdown] -- @@ -1933,9 +1932,9 @@ The name of the Analytics collection. -- [%hardbreaks] -*Example:* `pass:c["route"]` +*Example:* `+++"route"+++` {blank} -a| String +a¦ String |=== @@ -1980,14 +1979,14 @@ An object containing one or more nested scope objects, one for each available An //end::desc-Mutations[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -1996,7 +1995,7 @@ include::index.adoc[tag=desc-MutationsColl, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -2044,14 +2043,14 @@ The name of the object is the name of the Analytics scope, in display form. For //end::desc-MutationsColl[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -2061,7 +2060,7 @@ The number of mutations in the DCP queue that have not yet been ingested. The na [%hardbreaks] {blank} -a| Integer +a¦ Integer |=== @@ -2106,14 +2105,14 @@ An object giving information about an Analytics service request. //end::desc-Request[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *cancellable* + _optional_ -a| +a¦ [markdown] -- @@ -2122,13 +2121,13 @@ Whether this request can be cancelled. [%hardbreaks] {blank} -a| Boolean +a¦ Boolean -a| +a¦ *clientContextID* + _optional_ -a| +a¦ [markdown] -- @@ -2136,15 +2135,15 @@ A context ID for debugging purposes. -- [%hardbreaks] -*Example:* `pass:c["28379d60-7139-44d6-b57a-95935540b586"]` +*Example:* `+++"28379d60-7139-44d6-b57a-95935540b586"+++` {blank} -a| String +a¦ String -a| +a¦ *elapsedTime* + _optional_ -a| +a¦ [markdown] -- @@ -2154,13 +2153,13 @@ How long the request has been running in seconds. [%hardbreaks] *Example:* `0.126` {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *jobCreateTime* + _optional_ -a| +a¦ [markdown] -- @@ -2168,15 +2167,15 @@ The date and time when the request's job was created. -- [%hardbreaks] -*Example:* `pass:c["2024-05-28T19:47:02.512"]` +*Example:* `+++"2024-05-28T19:47:02.512"+++` {blank} -a| String +a¦ String -a| +a¦ *jobId* + _optional_ -a| +a¦ [markdown] -- @@ -2185,15 +2184,15 @@ The request's job ID. This value can be null if request did not run (for example -- [%hardbreaks] -*Example:* `pass:c["JID:0.14"]` +*Example:* `+++"JID:0.14"+++` {blank} -a| String +a¦ String -a| +a¦ *jobQueueTime* + _optional_ -a| +a¦ [markdown] -- @@ -2203,13 +2202,13 @@ How long the request's job has been in the queue waiting to run in seconds. [%hardbreaks] *Example:* `0` {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *jobRequiredCPUs* + _optional_ -a| +a¦ [markdown] -- @@ -2219,13 +2218,13 @@ The number of CPU cores required to run this request. [%hardbreaks] *Example:* `1` {blank} -a| Integer +a¦ Integer -a| +a¦ *jobRequiredMemory* + _optional_ -a| +a¦ [markdown] -- @@ -2236,13 +2235,13 @@ The bytes of RAM being used to process this request. [%hardbreaks] *Example:* `34013184` {blank} -a| Integer +a¦ Integer -a| +a¦ *jobStartTime* + _optional_ -a| +a¦ [markdown] -- @@ -2250,15 +2249,15 @@ The date and time the request's job began running. -- [%hardbreaks] -*Example:* `pass:c["2024-05-28T19:47:02.514"]` +*Example:* `+++"2024-05-28T19:47:02.514"+++` {blank} -a| String +a¦ String -a| +a¦ *jobStatus* + _optional_ -a| +a¦ [markdown] -- @@ -2267,15 +2266,15 @@ The state of the request's job. [%hardbreaks] *Values:* `"PENDING"`, `"RUNNING"`, `"TERMINATED"`, `"FAILURE"`, `"FAILURE_BEFORE_EXECUTION"`, `"null"` -*Example:* `pass:c["RUNNING"]` +*Example:* `+++"RUNNING"+++` {blank} -a| String +a¦ String -a| +a¦ *plan* + _optional_ -a| +a¦ [markdown] -- @@ -2284,13 +2283,13 @@ The query plan for this request. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *node* + _optional_ -a| +a¦ [markdown] -- @@ -2298,15 +2297,15 @@ The Analytics node that received the request. -- [%hardbreaks] -*Example:* `pass:c["172.20.0.2:8095"]` +*Example:* `+++"172.20.0.2:8095"+++` {blank} -a| String +a¦ String -a| +a¦ *remoteAddr* + _optional_ -a| +a¦ [markdown] -- @@ -2314,15 +2313,15 @@ The network address and port of the client that made the request. -- [%hardbreaks] -*Example:* `pass:c["172.20.0.123:53612"]` +*Example:* `+++"172.20.0.123:53612"+++` {blank} -a| String +a¦ String -a| +a¦ *requestTime* + _optional_ -a| +a¦ [markdown] -- @@ -2330,15 +2329,15 @@ The date and time the request was received. -- [%hardbreaks] -*Example:* `pass:c["2024-05-28T19:44:07.730"]` +*Example:* `+++"2024-05-28T19:44:07.730"+++` {blank} -a| String +a¦ String -a| +a¦ *scanConsistency* + _optional_ -a| +a¦ [markdown] -- @@ -2346,15 +2345,15 @@ The Scan Consistency setting used for the request's query. -- [%hardbreaks] -*Example:* `pass:c["not_bounded"]` +*Example:* `+++"not_bounded"+++` {blank} -a| String +a¦ String -a| +a¦ *state* + _optional_ -a| +a¦ [markdown] -- @@ -2363,15 +2362,15 @@ The state of the request. [%hardbreaks] *Values:* `"received"`, `"running"`, `"cancelled"`, `"completed"` -*Example:* `pass:c["running"]` +*Example:* `+++"running"+++` {blank} -a| String +a¦ String -a| +a¦ *statement* + _optional_ -a| +a¦ [markdown] -- @@ -2379,15 +2378,15 @@ The SQL++ query statement being run by the request. -- [%hardbreaks] -*Example:* `pass:c["select count(*) from hotel_endorsement_view;"]` +*Example:* `+++"select count(*) from hotel_endorsement_view;"+++` {blank} -a| String +a¦ String -a| +a¦ *userAgent* + _optional_ -a| +a¦ [markdown] -- @@ -2395,15 +2394,15 @@ The user agent string of the browser that made the request. -- [%hardbreaks] -*Example:* `pass:c["Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:126.0) Gecko/20100101 Firefox/126.0"]` +*Example:* `+++"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:126.0) Gecko/20100101 Firefox/126.0"+++` {blank} -a| String +a¦ String -a| +a¦ *users* + _optional_ -a| +a¦ [markdown] -- @@ -2411,15 +2410,15 @@ The user who made the request. -- [%hardbreaks] -*Example:* `pass:c["Administrator"]` +*Example:* `+++"Administrator"+++` {blank} -a| String +a¦ String -a| +a¦ *uuid* + _optional_ -a| +a¦ [markdown] -- @@ -2427,9 +2426,9 @@ The unique identifier for this request. -- [%hardbreaks] -*Example:* `pass:c["91f60338-a3e0-4163-9287-5e723fda29ef"]` +*Example:* `+++"91f60338-a3e0-4163-9287-5e723fda29ef"+++` {blank} -a| String +a¦ String |=== @@ -2474,14 +2473,14 @@ An object giving information about the status of the Analytics service. //end::desc-Status[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *authorizedNodes* + _optional_ -a| +a¦ [markdown] -- @@ -2491,13 +2490,13 @@ An array of strings, each of which is the ID of an authorized Analytics node. [%hardbreaks] *Example:* `["86586a966202b5aa4aed31633f330aba","948fb3af810a9b7bc6c76e2a69ba35d9"]` {blank} -a| String +a¦ String array -a| +a¦ *ccNodeId* + _optional_ -a| +a¦ [markdown] -- @@ -2505,15 +2504,15 @@ The ID of the cluster controller node. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeConfigUri* + _optional_ -a| +a¦ [markdown] -- @@ -2521,15 +2520,15 @@ The path of the Analytics Node Configuration REST API. -- [%hardbreaks] -*Example:* `pass:c["/analytics/config/node"]` +*Example:* `+++"/analytics/config/node"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeDiagnosticsUri* + _optional_ -a| +a¦ [markdown] -- @@ -2538,15 +2537,15 @@ The path of the Analytics Node Diagnostics REST API. For internal use only. -- [%hardbreaks] -*Example:* `pass:c["/analytics/node/diagnostics"]` +*Example:* `+++"/analytics/node/diagnostics"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeRestartUri* + _optional_ -a| +a¦ [markdown] -- @@ -2554,15 +2553,15 @@ The path of the Analytics Node Restart REST API. -- [%hardbreaks] -*Example:* `pass:c["/analytics/node/restart"]` +*Example:* `+++"/analytics/node/restart"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeServiceUri* + _optional_ -a| +a¦ [markdown] -- @@ -2570,15 +2569,15 @@ The path of the Analytics Query Service REST API. -- [%hardbreaks] -*Example:* `pass:c["/analytics/service"]` +*Example:* `+++"/analytics/service"+++` {blank} -a| String +a¦ String -a| +a¦ *serviceConfigUri* + _optional_ -a| +a¦ [markdown] -- @@ -2586,15 +2585,15 @@ The path of the Analytics Service Configuration REST API. -- [%hardbreaks] -*Example:* `pass:c["/analytics/config/service"]` +*Example:* `+++"/analytics/config/service"+++` {blank} -a| String +a¦ String -a| +a¦ *serviceDiagnosticsUri* + _optional_ -a| +a¦ [markdown] -- @@ -2603,15 +2602,15 @@ The full URI of the Analytics Service Diagnostics REST API. For internal use onl -- [%hardbreaks] -*Example:* `pass:c["http://localhost:8095/analytics/cluster/diagnostics"]` +*Example:* `+++"http://localhost:8095/analytics/cluster/diagnostics"+++` {blank} -a| String +a¦ String -a| +a¦ *serviceRestartUri* + _optional_ -a| +a¦ [markdown] -- @@ -2619,15 +2618,15 @@ The full URI of the Analytics Cluster Restart REST API. -- [%hardbreaks] -*Example:* `pass:c["http://localhost:8095/analytics/cluster/restart"]` +*Example:* `+++"http://localhost:8095/analytics/cluster/restart"+++` {blank} -a| String +a¦ String -a| +a¦ *state* + _optional_ -a| +a¦ [markdown] -- @@ -2636,15 +2635,15 @@ The state of the Analytics Service. [%hardbreaks] *Values:* `"ACTIVE"`, `"REBALANCE_REQUIRED"`, `"UNUSABLE"`, `"SHUTTING_DOWN"` -*Example:* `pass:c["ACTIVE"]` +*Example:* `+++"ACTIVE"+++` {blank} -a| String +a¦ String -a| +a¦ *nodes* + _optional_ -a| +a¦ [markdown] -- @@ -2653,13 +2652,13 @@ An array of objects, each giving information about one Analytics node. [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *partitions* + _optional_ -a| +a¦ [markdown] -- @@ -2668,13 +2667,13 @@ An array of objects, each giving information about one Analytics partition. [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *partitionsTopology* + _optional_ -a| +a¦ [markdown] -- @@ -2683,7 +2682,7 @@ include::index.adoc[tag=desc-StatusTopology, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -2723,14 +2722,14 @@ endif::collapse-models[] //tag::StatusNodes[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *apiBase* + _optional_ -a| +a¦ [markdown] -- @@ -2738,15 +2737,15 @@ The URI scheme, host, and port for HTTP access to Analytics REST APIs on this no -- [%hardbreaks] -*Example:* `pass:c["http://192.168.8.101:8095"]` +*Example:* `+++"http://192.168.8.101:8095"+++` {blank} -a| String +a¦ String -a| +a¦ *apiBaseHttps* + _optional_ -a| +a¦ [markdown] -- @@ -2754,15 +2753,15 @@ The URI scheme, host, and port for secure HTTPS access to Analytics REST APIs on -- [%hardbreaks] -*Example:* `pass:c["https://192.168.8.101:18095"]` +*Example:* `+++"https://192.168.8.101:18095"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeId* + _optional_ -a| +a¦ [markdown] -- @@ -2770,15 +2769,15 @@ The ID of the node. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeName* + _optional_ -a| +a¦ [markdown] -- @@ -2786,9 +2785,9 @@ The name or IP address of the node, including the cluster administration port. -- [%hardbreaks] -*Example:* `pass:c["192.168.8.101:8091"]` +*Example:* `+++"192.168.8.101:8091"+++` {blank} -a| String +a¦ String |=== @@ -2828,14 +2827,14 @@ endif::collapse-models[] //tag::StatusPartitions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *active* + _optional_ -a| +a¦ [markdown] -- @@ -2845,13 +2844,13 @@ Indicates whether this partition is active. [%hardbreaks] *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *activeNodeId* + _optional_ -a| +a¦ [markdown] -- @@ -2859,15 +2858,15 @@ The ID of the node where this partition is currently active. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *iodeviceNum* + _optional_ -a| +a¦ [markdown] -- @@ -2877,13 +2876,13 @@ The number of the IO Device where this partition is located. [%hardbreaks] *Example:* `0` {blank} -a| Integer +a¦ Integer -a| +a¦ *nodeId* + _optional_ -a| +a¦ [markdown] -- @@ -2891,15 +2890,15 @@ The ID of the node where this partition originated. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *partitionId* + _optional_ -a| +a¦ [markdown] -- @@ -2909,13 +2908,13 @@ The ID of this partition. [%hardbreaks] *Example:* `0` {blank} -a| Integer +a¦ Integer -a| +a¦ *path* + _optional_ -a| +a¦ [markdown] -- @@ -2923,15 +2922,15 @@ The path of the IO Device where this partition is located. -- [%hardbreaks] -*Example:* `pass:c["/data/@analytics/v_iodevice_0"]` +*Example:* `+++"/data/@analytics/v_iodevice_0"+++` {blank} -a| String +a¦ String -a| +a¦ *pendingActivation* + _optional_ -a| +a¦ [markdown] -- @@ -2941,7 +2940,7 @@ Indicates whether this partition is waiting to become active. [%hardbreaks] *Example:* `false` {blank} -a| Boolean +a¦ Boolean |=== @@ -2986,14 +2985,14 @@ An object giving information about the partition topology. //end::desc-StatusTopology[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *balanced* + _optional_ -a| +a¦ [markdown] -- @@ -3003,13 +3002,13 @@ Indicates whether the Analytics nodes are balanced. [%hardbreaks] *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *ccNodeId* + _optional_ -a| +a¦ [markdown] -- @@ -3017,15 +3016,15 @@ The ID of the cluster controller node. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *metadataPartition* + _optional_ -a| +a¦ [markdown] -- @@ -3035,13 +3034,13 @@ The ID of the metadata partition. [%hardbreaks] *Example:* `-1` {blank} -a| Integer +a¦ Integer -a| +a¦ *numReplicas* + _optional_ -a| +a¦ [markdown] -- @@ -3051,13 +3050,13 @@ The number of Analytics replicas. [%hardbreaks] *Example:* `1` {blank} -a| Integer +a¦ Integer -a| +a¦ *revision* + _optional_ -a| +a¦ [markdown] -- @@ -3067,13 +3066,13 @@ The revision number of the partition topology. [%hardbreaks] *Example:* `1` {blank} -a| Integer +a¦ Integer -a| +a¦ *version* + _optional_ -a| +a¦ [markdown] -- @@ -3083,13 +3082,13 @@ The version number of the partition topology. [%hardbreaks] *Example:* `1` {blank} -a| Integer +a¦ Integer -a| +a¦ *partitions* + _optional_ -a| +a¦ [markdown] -- @@ -3098,7 +3097,7 @@ An array of objects, each giving information about the state of one Analytics pa [%hardbreaks] {blank} -a| <> +a¦ <> array |=== @@ -3138,14 +3137,14 @@ endif::collapse-models[] //tag::StatusTopologyState[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *id* + _optional_ -a| +a¦ [markdown] -- @@ -3155,13 +3154,13 @@ The partition ID. [%hardbreaks] *Example:* `0` {blank} -a| Integer +a¦ Integer -a| +a¦ *master* + _optional_ -a| +a¦ [markdown] -- @@ -3169,15 +3168,15 @@ The ID of the node where the partition is currently active. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *origin* + _optional_ -a| +a¦ [markdown] -- @@ -3185,15 +3184,15 @@ The ID of the node where the partition originated. -- [%hardbreaks] -*Example:* `pass:c["86586a966202b5aa4aed31633f330aba"]` +*Example:* `+++"86586a966202b5aa4aed31633f330aba"+++` {blank} -a| String +a¦ String -a| +a¦ *replicas* + _optional_ -a| +a¦ [markdown] -- @@ -3202,7 +3201,7 @@ An array of objects, each giving information about the state of one Analytics re [%hardbreaks] {blank} -a| <> +a¦ <> array |=== @@ -3242,14 +3241,14 @@ endif::collapse-models[] //tag::StatusTopologyStateReplicas[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *location* + _optional_ -a| +a¦ [markdown] -- @@ -3257,15 +3256,15 @@ The name or IP address of the node where this replica is located, including the -- [%hardbreaks] -*Example:* `pass:c["192.168.8.102:9120"]` +*Example:* `+++"192.168.8.102:9120"+++` {blank} -a| String +a¦ String -a| +a¦ *nodeId* + _optional_ -a| +a¦ [markdown] -- @@ -3273,15 +3272,15 @@ The ID of the node where this replica is located. -- [%hardbreaks] -*Example:* `pass:c["948fb3af810a9b7bc6c76e2a69ba35d9"]` +*Example:* `+++"948fb3af810a9b7bc6c76e2a69ba35d9"+++` {blank} -a| String +a¦ String -a| +a¦ *status* + _optional_ -a| +a¦ [markdown] -- @@ -3290,15 +3289,15 @@ The synchronization status of the replica. [%hardbreaks] *Values:* `"IN_SYNC"`, `"CATCHING_UP"`, `"DISCONNECTED"` -*Example:* `pass:c["IN_SYNC"]` +*Example:* `+++"IN_SYNC"+++` {blank} -a| String +a¦ String -a| +a¦ *syncProgress* + _optional_ -a| +a¦ [markdown] -- @@ -3310,7 +3309,7 @@ The percentage (fraction from 0 to 1) of synchronization progress for this repli *Maximum:* `1` *Example:* `1` {blank} -a| Double (double) +a¦ Double (double) |=== @@ -3468,3 +3467,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/analytics-rest-config/pages/index.adoc b/docs/modules/analytics-rest-config/pages/index.adoc index 9b8593da..897f0181 100644 --- a/docs/modules/analytics-rest-config/pages/index.adoc +++ b/docs/modules/analytics-rest-config/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Analytics service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Analytics service REST port. Use `18095` for secure access. [%hardbreaks] *Values:* `8095`, `18095` -*Example:* `pass:c[8095]` +*Example:* `+++8095+++` // end |=== @@ -175,6 +175,12 @@ Views node-specific parameters, which apply to the node receiving the request. // markup not found, no include::{specDir}paths/get_node/operation-description-end.adoc[opts=optional] + + +[#get_node-produces] +.Produces +* application/json + :leveloffset: -1 @@ -192,12 +198,6 @@ Views node-specific parameters, which apply to the node receiving the request. // markup not found, no include::{specDir}paths/get_node/operation-parameters-after.adoc[opts=optional] -[#get_node-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_node/operation-responses-before.adoc[opts=optional] @@ -327,6 +327,12 @@ Views service-level parameters, which apply to all nodes running the Analytics s // markup not found, no include::{specDir}paths/get_service/operation-description-end.adoc[opts=optional] + + +[#get_service-produces] +.Produces +* application/json + :leveloffset: -1 @@ -344,12 +350,6 @@ Views service-level parameters, which apply to all nodes running the Analytics s // markup not found, no include::{specDir}paths/get_service/operation-parameters-after.adoc[opts=optional] -[#get_service-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_service/operation-responses-before.adoc[opts=optional] @@ -486,6 +486,16 @@ or restart the Analytics cluster using the [Cluster Restart API][2]. // markup not found, no include::{specDir}paths/put_node/operation-description-end.adoc[opts=optional] + +[#put_node-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#put_node-produces] +.Produces +* application/json + :leveloffset: -1 @@ -512,13 +522,13 @@ include::{specDir}paths/put_node/operation-parameters-begin.adoc[opts=optional] .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _optional_ -a| +a¦ [markdown] @@ -529,7 +539,7 @@ An object specifying one or more of the configurable node-level parameters on th [%hardbreaks] {blank} -a| <> +a¦ <> @@ -546,17 +556,6 @@ a| <> // markup not found, no include::{specDir}paths/put_node/operation-parameters-after.adoc[opts=optional] -[#put_node-produces] -= Produces - -* application/json - -[#put_node-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/put_node/operation-responses-before.adoc[opts=optional] @@ -697,6 +696,16 @@ you must restart the Analytics cluster using the [Cluster Restart API][1]. // markup not found, no include::{specDir}paths/put_service/operation-description-end.adoc[opts=optional] + +[#put_service-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#put_service-produces] +.Produces +* application/json + :leveloffset: -1 @@ -723,13 +732,13 @@ include::{specDir}paths/put_service/operation-parameters-begin.adoc[opts=optiona .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _optional_ -a| +a¦ [markdown] @@ -740,7 +749,7 @@ An object specifying one or more of the configurable service-level parameters. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -757,17 +766,6 @@ a| <> // markup not found, no include::{specDir}paths/put_service/operation-parameters-after.adoc[opts=optional] -[#put_service-produces] -= Produces - -* application/json - -[#put_service-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/put_service/operation-responses-before.adoc[opts=optional] @@ -928,14 +926,14 @@ endif::collapse-models[] //tag::Errors[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *error* + _required_ -a| +a¦ [markdown] -- @@ -944,7 +942,7 @@ An error message. [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -984,14 +982,14 @@ endif::collapse-models[] //tag::Node[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *jvmArgs* + _optional_ -a| +a¦ [markdown] -- @@ -1010,13 +1008,13 @@ To pass arguments opaquely, you may use [Java command-line argument files][3]. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *storageBuffercacheSize* + _optional_ -a| +a¦ [markdown] -- @@ -1028,13 +1026,13 @@ The default is 1/4 of the allocated Analytics Service memory. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *storageMemorycomponentGlobalbudget* + _optional_ -a| +a¦ [markdown] -- @@ -1046,7 +1044,7 @@ The default is 1/4 of the allocated Analytics Service memory. [%hardbreaks] {blank} -a| Integer +a¦ Integer |=== @@ -1086,14 +1084,14 @@ endif::collapse-models[] //tag::Service[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *activeMemoryGlobalBudget* + _optional_ -a| +a¦ [markdown] -- @@ -1103,13 +1101,13 @@ The memory budget (in bytes) for the active runtime. [%hardbreaks] *Default:* `67108864` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *activeStopTimeout* + _optional_ -a| +a¦ [markdown] -- @@ -1119,13 +1117,13 @@ The maximum time (in seconds) to wait for a graceful stop of an active runtime. [%hardbreaks] *Default:* `3600` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *activeSuspendTimeout* + _optional_ -a| +a¦ [markdown] -- @@ -1135,13 +1133,13 @@ The maximum time (in seconds) to wait for a graceful suspend of an active runtim [%hardbreaks] *Default:* `3600` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *analyticsBroadcastDcpStateMutationCount* + _optional_ -a| +a¦ [markdown] -- @@ -1151,13 +1149,13 @@ The number of processed mutations after which the DCP state is broadcast to stor [%hardbreaks] *Default:* `10000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *analyticsHttpRequestQueueSize* + _optional_ -a| +a¦ [markdown] -- @@ -1167,13 +1165,13 @@ The maximum number of HTTP requests to queue pending ability to execute. [%hardbreaks] *Default:* `256` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *analyticsHttpThreadCount* + _optional_ -a| +a¦ [markdown] -- @@ -1183,13 +1181,13 @@ The number of threads to service HTTP requests. [%hardbreaks] *Default:* `16` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *bindAddress* + _optional_ -a| +a¦ [markdown] -- @@ -1198,13 +1196,13 @@ The bind address to use. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *bindToHost* + _optional_ -a| +a¦ [markdown] -- @@ -1214,13 +1212,13 @@ Bind to configured hostname instead of wildcard address. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *clusterConnectRetries* + _optional_ -a| +a¦ [markdown] -- @@ -1230,13 +1228,13 @@ Number of attempts to contact CC before giving up. [%hardbreaks] *Default:* `5` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *collectDcpStateFromNodesTimeout* + _optional_ -a| +a¦ [markdown] -- @@ -1246,13 +1244,13 @@ The maximum time to wait to collect DCP state from all nodes in seconds. [%hardbreaks] *Default:* `600` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *compilerFramesize* + _optional_ -a| +a¦ [markdown] -- @@ -1262,13 +1260,13 @@ The page size (in bytes) for computation. [%hardbreaks] *Default:* `32768` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *compilerGroupmemory* + _optional_ -a| +a¦ [markdown] -- @@ -1278,13 +1276,13 @@ The memory budget (in bytes) for a group by operator instance in a partition. [%hardbreaks] *Default:* `33554432` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *compilerJoinmemory* + _optional_ -a| +a¦ [markdown] -- @@ -1294,13 +1292,13 @@ The memory budget (in bytes) for a join operator instance in a partition. [%hardbreaks] *Default:* `33554432` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *compilerParallelism* + _optional_ -a| +a¦ [markdown] -- @@ -1311,13 +1309,13 @@ The degree of parallelism for query execution. Zero means to use the storage par [%hardbreaks] *Default:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *compilerSortParallel* + _optional_ -a| +a¦ [markdown] -- @@ -1327,13 +1325,13 @@ Enables or disables full parallel sort. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *compilerSortmemory* + _optional_ -a| +a¦ [markdown] -- @@ -1343,13 +1341,13 @@ The memory budget (in bytes) for a sort operator instance in a partition. [%hardbreaks] *Default:* `33554432` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *compilerWindowmemory* + _optional_ -a| +a¦ [markdown] -- @@ -1359,13 +1357,13 @@ The memory budget (in bytes) for a window operator instance in a partition. [%hardbreaks] *Default:* `33554432` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *coresMultiplier* + _optional_ -a| +a¦ [markdown] -- @@ -1375,13 +1373,13 @@ The factor to multiply by the number of cores to determine maximum query concurr [%hardbreaks] *Default:* `3` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *dcpBufferAckWatermark* + _optional_ -a| +a¦ [markdown] -- @@ -1394,13 +1392,13 @@ The percentage of DCP connection buffer size at which to acknowledge bytes consu *Minimum:* `1` *Maximum:* `100` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *dcpChannelReconnectRemoteIdleSeconds* + _optional_ -a| +a¦ [markdown] -- @@ -1411,13 +1409,13 @@ Reconnect remote DCP channels that are idle for the specified number of seconds [%hardbreaks] *Default:* `120` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *dcpConnectionBufferSize* + _optional_ -a| +a¦ [markdown] -- @@ -1429,13 +1427,13 @@ Otherwise, the default is 1% of the JVM maximum heap size divided by the number [%hardbreaks] {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *deadlockWatchdogHaltDelaySeconds* + _optional_ -a| +a¦ [markdown] -- @@ -1445,13 +1443,13 @@ The delay (in seconds) to wait for graceful shutdown due to deadlocked threads, [%hardbreaks] *Default:* `120` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *deadlockWatchdogPollSeconds* + _optional_ -a| +a¦ [markdown] -- @@ -1461,13 +1459,13 @@ The frequency (in seconds) to scan for deadlocked threads. [%hardbreaks] *Default:* `300` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *jobHistorySize* + _optional_ -a| +a¦ [markdown] -- @@ -1477,13 +1475,13 @@ Limits the number of historical jobs remembered by the system to the specified v [%hardbreaks] *Default:* `10` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *jobQueueCapacity* + _optional_ -a| +a¦ [markdown] -- @@ -1493,13 +1491,13 @@ The maximum number of jobs to queue before rejecting new jobs. [%hardbreaks] *Default:* `4096` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *jvmArgs* + _optional_ -a| +a¦ [markdown] -- @@ -1515,13 +1513,13 @@ To pass arguments opaquely, you may use [Java command-line argument files][3]. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *logLevel* + _optional_ -a| +a¦ [markdown] -- @@ -1529,15 +1527,15 @@ The logging level. -- [%hardbreaks] -*Default:* `pass:c["DEBUG"]` +*Default:* `+++"DEBUG"+++` {blank} -a| String +a¦ String -a| +a¦ *maxWebRequestSize* + _optional_ -a| +a¦ [markdown] -- @@ -1547,13 +1545,13 @@ The maximum accepted web request size in bytes. [%hardbreaks] *Default:* `52428800` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *netBufferCount* + _optional_ -a| +a¦ [markdown] -- @@ -1563,13 +1561,13 @@ Number of network buffers per input/output channel. [%hardbreaks] *Default:* `1` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *netThreadCount* + _optional_ -a| +a¦ [markdown] -- @@ -1579,13 +1577,13 @@ Number of threads to use for Network I/O. [%hardbreaks] *Default:* `1` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *rebalancePullDatasetSizeFrequency* + _optional_ -a| +a¦ [markdown] -- @@ -1595,13 +1593,13 @@ The frequency at which the Analytics collection size is pulled from nodes during [%hardbreaks] *Default:* `5` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *remoteLinkConnectTimeoutSeconds* + _optional_ -a| +a¦ [markdown] -- @@ -1612,13 +1610,13 @@ The maximum time (in seconds) to wait for a remote link connection to establish. [%hardbreaks] *Default:* `60` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *remoteLinkSocketTimeoutSeconds* + _optional_ -a| +a¦ [markdown] -- @@ -1629,13 +1627,13 @@ The maximum time (in seconds) to wait after establishing the connection for remo [%hardbreaks] *Default:* `60` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *requestsArchiveSize* + _optional_ -a| +a¦ [markdown] -- @@ -1645,13 +1643,13 @@ The maximum number of archived requests to maintain. [%hardbreaks] *Default:* `50` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *resultSweepThreshold* + _optional_ -a| +a¦ [markdown] -- @@ -1661,13 +1659,13 @@ The duration within which an instance of the result cleanup should be invoked in [%hardbreaks] *Default:* `60000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *resultTtl* + _optional_ -a| +a¦ [markdown] -- @@ -1677,13 +1675,13 @@ Limits the amount of time results for asynchronous jobs should be retained by th [%hardbreaks] *Default:* `86400000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *storageBuffercacheMaxopenfiles* + _optional_ -a| +a¦ [markdown] -- @@ -1693,13 +1691,13 @@ The maximum number of open files in the buffer cache. [%hardbreaks] *Default:* `2147483647` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *storageBuffercachePagesize* + _optional_ -a| +a¦ [markdown] -- @@ -1709,13 +1707,13 @@ The page size in bytes for pages in the buffer cache. [%hardbreaks] *Default:* `131072` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *storageCompressionBlock* + _optional_ -a| +a¦ [markdown] -- @@ -1723,15 +1721,15 @@ The default compression scheme for the storage. -- [%hardbreaks] -*Default:* `pass:c["snappy"]` +*Default:* `+++"snappy"+++` {blank} -a| String +a¦ String -a| +a¦ *storageMemorycomponentNumcomponents* + _optional_ -a| +a¦ [markdown] -- @@ -1741,13 +1739,13 @@ The number of memory components to be used per LSM index. [%hardbreaks] *Default:* `2` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *storageMemorycomponentPagesize* + _optional_ -a| +a¦ [markdown] -- @@ -1757,13 +1755,13 @@ The page size in bytes for pages allocated to memory components. [%hardbreaks] *Default:* `131072` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *storageWriteRateLimit* + _optional_ -a| +a¦ [markdown] -- @@ -1774,13 +1772,13 @@ The maximum disk write rate for each storage partition in bytes per second. Disa [%hardbreaks] *Default:* `0` {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *threaddumpFrequencySeconds* + _optional_ -a| +a¦ [markdown] -- @@ -1790,13 +1788,13 @@ The frequency (in seconds) at which to log diagnostic thread dumps. [%hardbreaks] *Default:* `300` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *threaddumpLogLevel* + _optional_ -a| +a¦ [markdown] -- @@ -1804,15 +1802,15 @@ The log level at which to emit diagnostic thread dumps. -- [%hardbreaks] -*Default:* `pass:c["DEBUG"]` +*Default:* `+++"DEBUG"+++` {blank} -a| String +a¦ String -a| +a¦ *traceCategories* + _optional_ -a| +a¦ [markdown] -- @@ -1823,13 +1821,13 @@ Categories for tracing. The default is the empty array — no categories. [%hardbreaks] *Default:* `[]` {blank} -a| String +a¦ String array -a| +a¦ *txnDatasetCheckpointInterval* + _optional_ -a| +a¦ [markdown] -- @@ -1839,7 +1837,7 @@ The interval (in seconds) after which an Analytics collection is considered idle [%hardbreaks] *Default:* `3600` {blank} -a| Integer (int32) +a¦ Integer (int32) |=== @@ -1923,3 +1921,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/analytics-rest-library/pages/index.adoc b/docs/modules/analytics-rest-library/pages/index.adoc index f43ef615..4a098278 100644 --- a/docs/modules/analytics-rest-library/pages/index.adoc +++ b/docs/modules/analytics-rest-library/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Analytics service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Analytics service REST port. Use `18095` for secure access. [%hardbreaks] *Values:* `8095`, `18095` -*Example:* `pass:c[8095]` +*Example:* `+++8095+++` // end |=== @@ -174,6 +174,12 @@ Deletes the specified library entirely. // markup not found, no include::{specDir}paths/delete_library/operation-description-end.adoc[opts=optional] + + +[#delete_library-produces] +.Produces +* application/json + :leveloffset: -1 @@ -196,13 +202,13 @@ Deletes the specified library entirely. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *library* + +a¦ *library* + _required_ -a| +a¦ [markdown] @@ -213,13 +219,13 @@ The name of a library. [%hardbreaks] {blank} -a| String +a¦ String -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -233,7 +239,7 @@ The scope name may contain one or two identifiers, separated by a slash (/). You [%hardbreaks] {blank} -a| String +a¦ String @@ -254,12 +260,6 @@ a| String // markup not found, no include::{specDir}paths/delete_library/operation-parameters-after.adoc[opts=optional] -[#delete_library-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/delete_library/operation-responses-before.adoc[opts=optional] @@ -395,6 +395,12 @@ Returns all libraries and functions. // markup not found, no include::{specDir}paths/get_collection/operation-description-end.adoc[opts=optional] + + +[#get_collection-produces] +.Produces +* application/json + :leveloffset: -1 @@ -412,12 +418,6 @@ Returns all libraries and functions. // markup not found, no include::{specDir}paths/get_collection/operation-parameters-after.adoc[opts=optional] -[#get_collection-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_collection/operation-responses-before.adoc[opts=optional] @@ -554,6 +554,15 @@ Creates the specified library and its associated functions. If the specified lib include::{specDir}paths/post_library/operation-description-end.adoc[opts=optional] + +[#post_library-consumes] +.Consumes +* multipart/form-data + +[#post_library-produces] +.Produces +* application/json + :leveloffset: -1 @@ -576,13 +585,13 @@ include::{specDir}paths/post_library/operation-description-end.adoc[opts=optiona .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *library* + +a¦ *library* + _required_ -a| +a¦ [markdown] @@ -593,13 +602,13 @@ The name of a library. [%hardbreaks] {blank} -a| String +a¦ String -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -613,7 +622,7 @@ The scope name may contain one or two identifiers, separated by a slash (/). You [%hardbreaks] {blank} -a| String +a¦ String @@ -625,13 +634,13 @@ a| String .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *data* + +a¦ *data* + _required_ -a| +a¦ [markdown] @@ -642,13 +651,13 @@ The library and all its dependencies, packaged by shiv. [%hardbreaks] {blank} -a| File (binary) +a¦ File (binary) -a| *type* + +a¦ *type* + _required_ -a| +a¦ [markdown] @@ -660,7 +669,7 @@ The language of the library. *Values:* `"python"` {blank} -a| String +a¦ String @@ -678,16 +687,6 @@ a| String // markup not found, no include::{specDir}paths/post_library/operation-parameters-after.adoc[opts=optional] -[#post_library-produces] -= Produces - -* application/json - -[#post_library-consumes] -= Consumes - -* multipart/form-data - // markup not found, no include::{specDir}paths/post_library/operation-responses-before.adoc[opts=optional] @@ -849,14 +848,14 @@ endif::collapse-models[] //tag::Errors[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *error* + _required_ -a| +a¦ [markdown] -- @@ -865,7 +864,7 @@ An error message. [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -905,14 +904,14 @@ endif::collapse-models[] //tag::Libraries[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *scope* + _optional_ -a| +a¦ [markdown] -- @@ -923,15 +922,15 @@ The scope name may contain one or two identifiers, separated by a slash (/). -- [%hardbreaks] -*Example:* `pass:c["travel-sample/inventory"]` +*Example:* `+++"travel-sample/inventory"+++` {blank} -a| String +a¦ String -a| +a¦ *hash_md5* + _optional_ -a| +a¦ [markdown] -- @@ -940,13 +939,13 @@ A MD5 hash of the library residing on the server. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *name* + _optional_ -a| +a¦ [markdown] -- @@ -954,9 +953,9 @@ The name of the library. -- [%hardbreaks] -*Example:* `pass:c["mylib"]` +*Example:* `+++"mylib"+++` {blank} -a| String +a¦ String |=== @@ -1072,3 +1071,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/analytics-rest-links/pages/index.adoc b/docs/modules/analytics-rest-links/pages/index.adoc index b66a75bc..3cccae3a 100644 --- a/docs/modules/analytics-rest-links/pages/index.adoc +++ b/docs/modules/analytics-rest-links/pages/index.adoc @@ -58,7 +58,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -69,7 +69,7 @@ The host name or IP address of a node running the Analytics service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -80,7 +80,7 @@ The Analytics service REST port. Use `18095` for secure access. [%hardbreaks] *Values:* `8095`, `18095` -*Example:* `pass:c[8095]` +*Example:* `+++8095+++` // end |=== @@ -177,6 +177,15 @@ An alternative endpoint for [deleting a link](#delete_link), provided for backwa // markup not found, no include::{specDir}paths/delete_alt/operation-description-end.adoc[opts=optional] + +[#delete_alt-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#delete_alt-produces] +.Produces +* application/json + :leveloffset: -1 @@ -202,13 +211,13 @@ An alternative endpoint for [deleting a link](#delete_link), provided for backwa .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *dataverse* + +a¦ *dataverse* + _required_ -a| +a¦ [markdown] @@ -219,13 +228,13 @@ The name of the Analytics scope containing the link. With this parameter, the s [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -236,7 +245,7 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String @@ -254,16 +263,6 @@ a| String // markup not found, no include::{specDir}paths/delete_alt/operation-parameters-after.adoc[opts=optional] -[#delete_alt-produces] -= Produces - -* application/json - -[#delete_alt-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/delete_alt/operation-responses-before.adoc[opts=optional] @@ -400,6 +399,15 @@ An alternative endpoint for [creating a link](#post_link), provided for backward // markup not found, no include::{specDir}paths/post_alt/operation-description-end.adoc[opts=optional] + +[#post_alt-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#post_alt-produces] +.Produces +* application/json + :leveloffset: -1 @@ -425,13 +433,13 @@ An alternative endpoint for [creating a link](#post_link), provided for backward .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *dataverse* + +a¦ *dataverse* + _required_ -a| +a¦ [markdown] @@ -442,13 +450,13 @@ The name of the Analytics scope containing the link. With this parameter, the s [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -459,13 +467,13 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String -a| *type* + +a¦ *type* + _required_ -a| +a¦ [markdown] @@ -478,13 +486,13 @@ include::index.adoc[tag=desc-CommonType, opts=optional] *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| +a¦ include::index.adoc[tag=type-CommonType, opts=optional] -a| *hostname* + +a¦ *hostname* + _required_ -a| +a¦ [markdown] @@ -495,13 +503,13 @@ For Couchbase links only. The remote hostname. [%hardbreaks] {blank} -a| String +a¦ String -a| *username* + +a¦ *username* + _optional_ -a| +a¦ [markdown] @@ -512,13 +520,13 @@ For Couchbase links only. The remote username. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *password* + +a¦ *password* + _optional_ -a| +a¦ [markdown] @@ -529,13 +537,13 @@ For Couchbase links only. The remote password. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *encryption* + +a¦ *encryption* + _required_ -a| +a¦ [markdown] @@ -547,13 +555,13 @@ For Couchbase links only. The type of encryption used by the link. For details, *Values:* `"none"`, `"half"`, `"full"` {blank} -a| String +a¦ String -a| *certificate* + +a¦ *certificate* + _optional_ -a| +a¦ [markdown] @@ -564,13 +572,13 @@ For Couchbase links only. The content of the target cluster root certificate. Re [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificate* + +a¦ *clientCertificate* + _optional_ -a| +a¦ [markdown] @@ -581,13 +589,13 @@ For Couchbase links, this is the content of the client certificate. Required for [%hardbreaks] {blank} -a| String +a¦ String -a| *clientKey* + +a¦ *clientKey* + _optional_ -a| +a¦ [markdown] @@ -598,13 +606,13 @@ For Couchbase links only. The content of the client key. Required for links with [%hardbreaks] {blank} -a| String +a¦ String -a| *accessKeyId* + +a¦ *accessKeyId* + _required_ -a| +a¦ [markdown] @@ -615,13 +623,13 @@ For S3 links only. The Amazon S3 access key ID. [%hardbreaks] {blank} -a| String +a¦ String -a| *secretAccessKey* + +a¦ *secretAccessKey* + _required_ -a| +a¦ [markdown] @@ -632,13 +640,13 @@ For S3 links only. The Amazon S3 secret access key. You should URL-encode this [%hardbreaks] {blank} -a| String +a¦ String -a| *sessionToken* + +a¦ *sessionToken* + _optional_ -a| +a¦ [markdown] @@ -649,13 +657,13 @@ For S3 links only. The Amazon S3 session token. Use this parameter if you want t [%hardbreaks] {blank} -a| String +a¦ String -a| *region* + +a¦ *region* + _required_ -a| +a¦ [markdown] @@ -666,13 +674,13 @@ For S3 links only. The Amazon S3 region. [%hardbreaks] {blank} -a| String +a¦ String -a| *serviceEndpoint* + +a¦ *serviceEndpoint* + _optional_ -a| +a¦ [markdown] @@ -683,13 +691,13 @@ For S3 links only. The Amazon S3 service endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| *endpoint* + +a¦ *endpoint* + _optional_ -a| +a¦ [markdown] @@ -700,13 +708,13 @@ For Azure Blob links and Google Cloud Storage links. The endpoint URI. Required [%hardbreaks] {blank} -a| String +a¦ String -a| *accountName* + +a¦ *accountName* + _optional_ -a| +a¦ [markdown] @@ -717,13 +725,13 @@ For Azure Blob links only. The account name. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *accountKey* + +a¦ *accountKey* + _optional_ -a| +a¦ [markdown] @@ -734,13 +742,13 @@ For Azure Blob links only. The account key. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *sharedAccessSignature* + +a¦ *sharedAccessSignature* + _optional_ -a| +a¦ [markdown] @@ -751,13 +759,13 @@ For Azure Blob links only. A token that can be used for authentication. Used for [%hardbreaks] {blank} -a| String +a¦ String -a| *managedIdentityId* + +a¦ *managedIdentityId* + _optional_ -a| +a¦ [markdown] @@ -768,13 +776,13 @@ For Azure Blob links only. The managed identity ID. Used for managed identity au [%hardbreaks] {blank} -a| String +a¦ String -a| *clientId* + +a¦ *clientId* + _optional_ -a| +a¦ [markdown] @@ -785,13 +793,13 @@ For Azure Blob links only. The client ID for the registered application. Used fo [%hardbreaks] {blank} -a| String +a¦ String -a| *tenantId* + +a¦ *tenantId* + _optional_ -a| +a¦ [markdown] @@ -802,13 +810,13 @@ For Azure Blob links only. The tenant ID where the registered application is cre [%hardbreaks] {blank} -a| String +a¦ String -a| *clientSecret* + +a¦ *clientSecret* + _optional_ -a| +a¦ [markdown] @@ -819,13 +827,13 @@ For Azure Blob links only. The client secret for the registered application. Use [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificatePassword* + +a¦ *clientCertificatePassword* + _optional_ -a| +a¦ [markdown] @@ -836,13 +844,13 @@ For Azure Blob links only. The client certificate password for the registered ap [%hardbreaks] {blank} -a| String +a¦ String -a| *jsonCredentials* + +a¦ *jsonCredentials* + _optional_ -a| +a¦ [markdown] @@ -853,13 +861,13 @@ For Google Cloud Storage links only. The JSON credentials of the link. This par [%hardbreaks] {blank} -a| String +a¦ String -a| *applicationDefaultCredentials* + +a¦ *applicationDefaultCredentials* + _optional_ -a| +a¦ [markdown] @@ -871,7 +879,7 @@ For Google Cloud Storage links only. If present, indicates that the link should *Values:* `"true"` {blank} -a| String +a¦ String @@ -889,16 +897,6 @@ a| String // markup not found, no include::{specDir}paths/post_alt/operation-parameters-after.adoc[opts=optional] -[#post_alt-produces] -= Produces - -* application/json - -[#post_alt-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_alt/operation-responses-before.adoc[opts=optional] @@ -1036,6 +1034,15 @@ An alternative endpoint for [editing a link](#put_link), provided for backward c // markup not found, no include::{specDir}paths/put_alt/operation-description-end.adoc[opts=optional] + +[#put_alt-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#put_alt-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1061,13 +1068,13 @@ An alternative endpoint for [editing a link](#put_link), provided for backward c .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *dataverse* + +a¦ *dataverse* + _required_ -a| +a¦ [markdown] @@ -1078,13 +1085,13 @@ The name of the Analytics scope containing the link. With this parameter, the s [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -1095,13 +1102,13 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String -a| *type* + +a¦ *type* + _optional_ -a| +a¦ [markdown] @@ -1114,13 +1121,13 @@ include::index.adoc[tag=desc-CommonTypeEdit, opts=optional] *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| +a¦ include::index.adoc[tag=type-CommonTypeEdit, opts=optional] -a| *hostname* + +a¦ *hostname* + _required_ -a| +a¦ [markdown] @@ -1131,13 +1138,13 @@ For Couchbase links only. The remote hostname. [%hardbreaks] {blank} -a| String +a¦ String -a| *username* + +a¦ *username* + _optional_ -a| +a¦ [markdown] @@ -1148,13 +1155,13 @@ For Couchbase links only. The remote username. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *password* + +a¦ *password* + _optional_ -a| +a¦ [markdown] @@ -1165,13 +1172,13 @@ For Couchbase links only. The remote password. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *encryption* + +a¦ *encryption* + _required_ -a| +a¦ [markdown] @@ -1183,13 +1190,13 @@ For Couchbase links only. The type of encryption used by the link. For details, *Values:* `"none"`, `"half"`, `"full"` {blank} -a| String +a¦ String -a| *certificate* + +a¦ *certificate* + _optional_ -a| +a¦ [markdown] @@ -1200,13 +1207,13 @@ For Couchbase links only. The content of the target cluster root certificate. Re [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificate* + +a¦ *clientCertificate* + _optional_ -a| +a¦ [markdown] @@ -1217,13 +1224,13 @@ For Couchbase links, this is the content of the client certificate. Required for [%hardbreaks] {blank} -a| String +a¦ String -a| *clientKey* + +a¦ *clientKey* + _optional_ -a| +a¦ [markdown] @@ -1234,13 +1241,13 @@ For Couchbase links only. The content of the client key. Required for links with [%hardbreaks] {blank} -a| String +a¦ String -a| *accessKeyId* + +a¦ *accessKeyId* + _required_ -a| +a¦ [markdown] @@ -1251,13 +1258,13 @@ For S3 links only. The Amazon S3 access key ID. [%hardbreaks] {blank} -a| String +a¦ String -a| *secretAccessKey* + +a¦ *secretAccessKey* + _required_ -a| +a¦ [markdown] @@ -1268,13 +1275,13 @@ For S3 links only. The Amazon S3 secret access key. You should URL-encode this [%hardbreaks] {blank} -a| String +a¦ String -a| *sessionToken* + +a¦ *sessionToken* + _optional_ -a| +a¦ [markdown] @@ -1285,13 +1292,13 @@ For S3 links only. The Amazon S3 session token. Use this parameter if you want t [%hardbreaks] {blank} -a| String +a¦ String -a| *region* + +a¦ *region* + _required_ -a| +a¦ [markdown] @@ -1302,13 +1309,13 @@ For S3 links only. The Amazon S3 region. [%hardbreaks] {blank} -a| String +a¦ String -a| *serviceEndpoint* + +a¦ *serviceEndpoint* + _optional_ -a| +a¦ [markdown] @@ -1319,13 +1326,13 @@ For S3 links only. The Amazon S3 service endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| *endpoint* + +a¦ *endpoint* + _optional_ -a| +a¦ [markdown] @@ -1336,13 +1343,13 @@ For Azure Blob links and Google Cloud Storage links. The endpoint URI. Required [%hardbreaks] {blank} -a| String +a¦ String -a| *accountName* + +a¦ *accountName* + _optional_ -a| +a¦ [markdown] @@ -1353,13 +1360,13 @@ For Azure Blob links only. The account name. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *accountKey* + +a¦ *accountKey* + _optional_ -a| +a¦ [markdown] @@ -1370,13 +1377,13 @@ For Azure Blob links only. The account key. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *sharedAccessSignature* + +a¦ *sharedAccessSignature* + _optional_ -a| +a¦ [markdown] @@ -1387,13 +1394,13 @@ For Azure Blob links only. A token that can be used for authentication. Used for [%hardbreaks] {blank} -a| String +a¦ String -a| *managedIdentityId* + +a¦ *managedIdentityId* + _optional_ -a| +a¦ [markdown] @@ -1404,13 +1411,13 @@ For Azure Blob links only. The managed identity ID. Used for managed identity au [%hardbreaks] {blank} -a| String +a¦ String -a| *clientId* + +a¦ *clientId* + _optional_ -a| +a¦ [markdown] @@ -1421,13 +1428,13 @@ For Azure Blob links only. The client ID for the registered application. Used fo [%hardbreaks] {blank} -a| String +a¦ String -a| *tenantId* + +a¦ *tenantId* + _optional_ -a| +a¦ [markdown] @@ -1438,13 +1445,13 @@ For Azure Blob links only. The tenant ID where the registered application is cre [%hardbreaks] {blank} -a| String +a¦ String -a| *clientSecret* + +a¦ *clientSecret* + _optional_ -a| +a¦ [markdown] @@ -1455,13 +1462,13 @@ For Azure Blob links only. The client secret for the registered application. Use [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificatePassword* + +a¦ *clientCertificatePassword* + _optional_ -a| +a¦ [markdown] @@ -1472,13 +1479,13 @@ For Azure Blob links only. The client certificate password for the registered ap [%hardbreaks] {blank} -a| String +a¦ String -a| *jsonCredentials* + +a¦ *jsonCredentials* + _optional_ -a| +a¦ [markdown] @@ -1489,13 +1496,13 @@ For Google Cloud Storage links only. The JSON credentials of the link. This par [%hardbreaks] {blank} -a| String +a¦ String -a| *applicationDefaultCredentials* + +a¦ *applicationDefaultCredentials* + _optional_ -a| +a¦ [markdown] @@ -1507,7 +1514,7 @@ For Google Cloud Storage links only. If present, indicates that the link should *Values:* `"true"` {blank} -a| String +a¦ String @@ -1525,16 +1532,6 @@ a| String // markup not found, no include::{specDir}paths/put_alt/operation-parameters-after.adoc[opts=optional] -[#put_alt-produces] -= Produces - -* application/json - -[#put_alt-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/put_alt/operation-responses-before.adoc[opts=optional] @@ -1693,6 +1690,12 @@ Returns information about all links in all Analytics scopes. // markup not found, no include::{specDir}paths/get_all/operation-description-end.adoc[opts=optional] + + +[#get_all-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1716,13 +1719,13 @@ Returns information about all links in all Analytics scopes. .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *dataverse* + +a¦ *dataverse* + _optional_ -a| +a¦ [markdown] @@ -1738,13 +1741,13 @@ This parameter is provided for backward compatibility. Note that it is deprecate [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _optional_ -a| +a¦ [markdown] @@ -1758,13 +1761,13 @@ This parameter is provided for backward compatibility. Note that it is deprecate [%hardbreaks] {blank} -a| String +a¦ String -a| *type* + +a¦ *type* + _optional_ -a| +a¦ [markdown] @@ -1777,7 +1780,7 @@ The type of the link. If this parameter is omitted, all link types are retrieved *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| String +a¦ String @@ -1797,12 +1800,6 @@ a| String // markup not found, no include::{specDir}paths/get_all/operation-parameters-after.adoc[opts=optional] -[#get_all-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_all/operation-responses-before.adoc[opts=optional] @@ -1940,6 +1937,12 @@ Returns information about all links in the specified Analytics scope. // markup not found, no include::{specDir}paths/get_scope/operation-description-end.adoc[opts=optional] + + +[#get_scope-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1962,13 +1965,13 @@ Returns information about all links in the specified Analytics scope. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -1982,7 +1985,7 @@ With this parameter, the scope name may contain one or two identifiers, separate [%hardbreaks] {blank} -a| String +a¦ String @@ -1992,13 +1995,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *type* + +a¦ *type* + _optional_ -a| +a¦ [markdown] @@ -2011,7 +2014,7 @@ The type of the link. If this parameter is omitted, all link types are retrieved *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| String +a¦ String @@ -2031,12 +2034,6 @@ a| String // markup not found, no include::{specDir}paths/get_scope/operation-parameters-after.adoc[opts=optional] -[#get_scope-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_scope/operation-responses-before.adoc[opts=optional] @@ -2200,6 +2197,12 @@ Deletes a link in the specified Analytics scope. The link cannot be deleted if a // markup not found, no include::{specDir}paths/delete_link/operation-description-end.adoc[opts=optional] + + +[#delete_link-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2222,13 +2225,13 @@ Deletes a link in the specified Analytics scope. The link cannot be deleted if a .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -2242,13 +2245,13 @@ With this parameter, the scope name may contain one or two identifiers, separate [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -2259,7 +2262,7 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String @@ -2280,12 +2283,6 @@ a| String // markup not found, no include::{specDir}paths/delete_link/operation-parameters-after.adoc[opts=optional] -[#delete_link-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/delete_link/operation-responses-before.adoc[opts=optional] @@ -2421,6 +2418,12 @@ Returns information about a link in the specified Analytics scope. // markup not found, no include::{specDir}paths/get_link/operation-description-end.adoc[opts=optional] + + +[#get_link-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2443,13 +2446,13 @@ Returns information about a link in the specified Analytics scope. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -2463,13 +2466,13 @@ With this parameter, the scope name may contain one or two identifiers, separate [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -2480,7 +2483,7 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String @@ -2490,13 +2493,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *type* + +a¦ *type* + _optional_ -a| +a¦ [markdown] @@ -2509,7 +2512,7 @@ include::index.adoc[tag=desc-CommonTypeEdit, opts=optional] *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| +a¦ include::index.adoc[tag=type-CommonTypeEdit, opts=optional] @@ -2529,12 +2532,6 @@ include::index.adoc[tag=type-CommonTypeEdit, opts=optional] // markup not found, no include::{specDir}paths/get_link/operation-parameters-after.adoc[opts=optional] -[#get_link-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_link/operation-responses-before.adoc[opts=optional] @@ -2672,6 +2669,15 @@ Creates a link in the specified Analytics scope. // markup not found, no include::{specDir}paths/post_link/operation-description-end.adoc[opts=optional] + +[#post_link-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#post_link-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2694,13 +2700,13 @@ include::{specDir}paths/post_link/operation-description-after.adoc[opts=optional .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -2714,13 +2720,13 @@ With this parameter, the scope name may contain one or two identifiers, separate [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -2731,7 +2737,7 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String @@ -2743,13 +2749,13 @@ a| String .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *type* + +a¦ *type* + _required_ -a| +a¦ [markdown] @@ -2762,13 +2768,13 @@ include::index.adoc[tag=desc-CommonType, opts=optional] *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| +a¦ include::index.adoc[tag=type-CommonType, opts=optional] -a| *hostname* + +a¦ *hostname* + _required_ -a| +a¦ [markdown] @@ -2779,13 +2785,13 @@ For Couchbase links only. The remote hostname. [%hardbreaks] {blank} -a| String +a¦ String -a| *username* + +a¦ *username* + _optional_ -a| +a¦ [markdown] @@ -2796,13 +2802,13 @@ For Couchbase links only. The remote username. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *password* + +a¦ *password* + _optional_ -a| +a¦ [markdown] @@ -2813,13 +2819,13 @@ For Couchbase links only. The remote password. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *encryption* + +a¦ *encryption* + _required_ -a| +a¦ [markdown] @@ -2831,13 +2837,13 @@ For Couchbase links only. The type of encryption used by the link. For details, *Values:* `"none"`, `"half"`, `"full"` {blank} -a| String +a¦ String -a| *certificate* + +a¦ *certificate* + _optional_ -a| +a¦ [markdown] @@ -2848,13 +2854,13 @@ For Couchbase links only. The content of the target cluster root certificate. Re [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificate* + +a¦ *clientCertificate* + _optional_ -a| +a¦ [markdown] @@ -2865,13 +2871,13 @@ For Couchbase links, this is the content of the client certificate. Required for [%hardbreaks] {blank} -a| String +a¦ String -a| *clientKey* + +a¦ *clientKey* + _optional_ -a| +a¦ [markdown] @@ -2882,13 +2888,13 @@ For Couchbase links only. The content of the client key. Required for links with [%hardbreaks] {blank} -a| String +a¦ String -a| *accessKeyId* + +a¦ *accessKeyId* + _required_ -a| +a¦ [markdown] @@ -2899,13 +2905,13 @@ For S3 links only. The Amazon S3 access key ID. [%hardbreaks] {blank} -a| String +a¦ String -a| *secretAccessKey* + +a¦ *secretAccessKey* + _required_ -a| +a¦ [markdown] @@ -2916,13 +2922,13 @@ For S3 links only. The Amazon S3 secret access key. You should URL-encode this [%hardbreaks] {blank} -a| String +a¦ String -a| *sessionToken* + +a¦ *sessionToken* + _optional_ -a| +a¦ [markdown] @@ -2933,13 +2939,13 @@ For S3 links only. The Amazon S3 session token. Use this parameter if you want t [%hardbreaks] {blank} -a| String +a¦ String -a| *region* + +a¦ *region* + _required_ -a| +a¦ [markdown] @@ -2950,13 +2956,13 @@ For S3 links only. The Amazon S3 region. [%hardbreaks] {blank} -a| String +a¦ String -a| *serviceEndpoint* + +a¦ *serviceEndpoint* + _optional_ -a| +a¦ [markdown] @@ -2967,13 +2973,13 @@ For S3 links only. The Amazon S3 service endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| *endpoint* + +a¦ *endpoint* + _optional_ -a| +a¦ [markdown] @@ -2984,13 +2990,13 @@ For Azure Blob links and Google Cloud Storage links. The endpoint URI. Required [%hardbreaks] {blank} -a| String +a¦ String -a| *accountName* + +a¦ *accountName* + _optional_ -a| +a¦ [markdown] @@ -3001,13 +3007,13 @@ For Azure Blob links only. The account name. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *accountKey* + +a¦ *accountKey* + _optional_ -a| +a¦ [markdown] @@ -3018,13 +3024,13 @@ For Azure Blob links only. The account key. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *sharedAccessSignature* + +a¦ *sharedAccessSignature* + _optional_ -a| +a¦ [markdown] @@ -3035,13 +3041,13 @@ For Azure Blob links only. A token that can be used for authentication. Used for [%hardbreaks] {blank} -a| String +a¦ String -a| *managedIdentityId* + +a¦ *managedIdentityId* + _optional_ -a| +a¦ [markdown] @@ -3052,13 +3058,13 @@ For Azure Blob links only. The managed identity ID. Used for managed identity au [%hardbreaks] {blank} -a| String +a¦ String -a| *clientId* + +a¦ *clientId* + _optional_ -a| +a¦ [markdown] @@ -3069,13 +3075,13 @@ For Azure Blob links only. The client ID for the registered application. Used fo [%hardbreaks] {blank} -a| String +a¦ String -a| *tenantId* + +a¦ *tenantId* + _optional_ -a| +a¦ [markdown] @@ -3086,13 +3092,13 @@ For Azure Blob links only. The tenant ID where the registered application is cre [%hardbreaks] {blank} -a| String +a¦ String -a| *clientSecret* + +a¦ *clientSecret* + _optional_ -a| +a¦ [markdown] @@ -3103,13 +3109,13 @@ For Azure Blob links only. The client secret for the registered application. Use [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificatePassword* + +a¦ *clientCertificatePassword* + _optional_ -a| +a¦ [markdown] @@ -3120,13 +3126,13 @@ For Azure Blob links only. The client certificate password for the registered ap [%hardbreaks] {blank} -a| String +a¦ String -a| *jsonCredentials* + +a¦ *jsonCredentials* + _optional_ -a| +a¦ [markdown] @@ -3137,13 +3143,13 @@ For Google Cloud Storage links only. The JSON credentials of the link. This par [%hardbreaks] {blank} -a| String +a¦ String -a| *applicationDefaultCredentials* + +a¦ *applicationDefaultCredentials* + _optional_ -a| +a¦ [markdown] @@ -3155,7 +3161,7 @@ For Google Cloud Storage links only. If present, indicates that the link should *Values:* `"true"` {blank} -a| String +a¦ String @@ -3173,16 +3179,6 @@ a| String // markup not found, no include::{specDir}paths/post_link/operation-parameters-after.adoc[opts=optional] -[#post_link-produces] -= Produces - -* application/json - -[#post_link-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_link/operation-responses-before.adoc[opts=optional] @@ -3319,6 +3315,15 @@ Edits an existing link in the specified Analytics scope. The link name, type, an // markup not found, no include::{specDir}paths/put_link/operation-description-end.adoc[opts=optional] + +[#put_link-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#put_link-produces] +.Produces +* application/json + :leveloffset: -1 @@ -3341,13 +3346,13 @@ Edits an existing link in the specified Analytics scope. The link name, type, an .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *scope* + +a¦ *scope* + _required_ -a| +a¦ [markdown] @@ -3361,13 +3366,13 @@ With this parameter, the scope name may contain one or two identifiers, separate [%hardbreaks] {blank} -a| String +a¦ String -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -3378,7 +3383,7 @@ The name of the link. [%hardbreaks] {blank} -a| String +a¦ String @@ -3390,13 +3395,13 @@ a| String .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *type* + +a¦ *type* + _optional_ -a| +a¦ [markdown] @@ -3409,13 +3414,13 @@ include::index.adoc[tag=desc-CommonTypeEdit, opts=optional] *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| +a¦ include::index.adoc[tag=type-CommonTypeEdit, opts=optional] -a| *hostname* + +a¦ *hostname* + _required_ -a| +a¦ [markdown] @@ -3426,13 +3431,13 @@ For Couchbase links only. The remote hostname. [%hardbreaks] {blank} -a| String +a¦ String -a| *username* + +a¦ *username* + _optional_ -a| +a¦ [markdown] @@ -3443,13 +3448,13 @@ For Couchbase links only. The remote username. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *password* + +a¦ *password* + _optional_ -a| +a¦ [markdown] @@ -3460,13 +3465,13 @@ For Couchbase links only. The remote password. Required for links with no encryp [%hardbreaks] {blank} -a| String +a¦ String -a| *encryption* + +a¦ *encryption* + _required_ -a| +a¦ [markdown] @@ -3478,13 +3483,13 @@ For Couchbase links only. The type of encryption used by the link. For details, *Values:* `"none"`, `"half"`, `"full"` {blank} -a| String +a¦ String -a| *certificate* + +a¦ *certificate* + _optional_ -a| +a¦ [markdown] @@ -3495,13 +3500,13 @@ For Couchbase links only. The content of the target cluster root certificate. Re [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificate* + +a¦ *clientCertificate* + _optional_ -a| +a¦ [markdown] @@ -3512,13 +3517,13 @@ For Couchbase links, this is the content of the client certificate. Required for [%hardbreaks] {blank} -a| String +a¦ String -a| *clientKey* + +a¦ *clientKey* + _optional_ -a| +a¦ [markdown] @@ -3529,13 +3534,13 @@ For Couchbase links only. The content of the client key. Required for links with [%hardbreaks] {blank} -a| String +a¦ String -a| *accessKeyId* + +a¦ *accessKeyId* + _required_ -a| +a¦ [markdown] @@ -3546,13 +3551,13 @@ For S3 links only. The Amazon S3 access key ID. [%hardbreaks] {blank} -a| String +a¦ String -a| *secretAccessKey* + +a¦ *secretAccessKey* + _required_ -a| +a¦ [markdown] @@ -3563,13 +3568,13 @@ For S3 links only. The Amazon S3 secret access key. You should URL-encode this [%hardbreaks] {blank} -a| String +a¦ String -a| *sessionToken* + +a¦ *sessionToken* + _optional_ -a| +a¦ [markdown] @@ -3580,13 +3585,13 @@ For S3 links only. The Amazon S3 session token. Use this parameter if you want t [%hardbreaks] {blank} -a| String +a¦ String -a| *region* + +a¦ *region* + _required_ -a| +a¦ [markdown] @@ -3597,13 +3602,13 @@ For S3 links only. The Amazon S3 region. [%hardbreaks] {blank} -a| String +a¦ String -a| *serviceEndpoint* + +a¦ *serviceEndpoint* + _optional_ -a| +a¦ [markdown] @@ -3614,13 +3619,13 @@ For S3 links only. The Amazon S3 service endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| *endpoint* + +a¦ *endpoint* + _optional_ -a| +a¦ [markdown] @@ -3631,13 +3636,13 @@ For Azure Blob links and Google Cloud Storage links. The endpoint URI. Required [%hardbreaks] {blank} -a| String +a¦ String -a| *accountName* + +a¦ *accountName* + _optional_ -a| +a¦ [markdown] @@ -3648,13 +3653,13 @@ For Azure Blob links only. The account name. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *accountKey* + +a¦ *accountKey* + _optional_ -a| +a¦ [markdown] @@ -3665,13 +3670,13 @@ For Azure Blob links only. The account key. Used for shared key authentication. [%hardbreaks] {blank} -a| String +a¦ String -a| *sharedAccessSignature* + +a¦ *sharedAccessSignature* + _optional_ -a| +a¦ [markdown] @@ -3682,13 +3687,13 @@ For Azure Blob links only. A token that can be used for authentication. Used for [%hardbreaks] {blank} -a| String +a¦ String -a| *managedIdentityId* + +a¦ *managedIdentityId* + _optional_ -a| +a¦ [markdown] @@ -3699,13 +3704,13 @@ For Azure Blob links only. The managed identity ID. Used for managed identity au [%hardbreaks] {blank} -a| String +a¦ String -a| *clientId* + +a¦ *clientId* + _optional_ -a| +a¦ [markdown] @@ -3716,13 +3721,13 @@ For Azure Blob links only. The client ID for the registered application. Used fo [%hardbreaks] {blank} -a| String +a¦ String -a| *tenantId* + +a¦ *tenantId* + _optional_ -a| +a¦ [markdown] @@ -3733,13 +3738,13 @@ For Azure Blob links only. The tenant ID where the registered application is cre [%hardbreaks] {blank} -a| String +a¦ String -a| *clientSecret* + +a¦ *clientSecret* + _optional_ -a| +a¦ [markdown] @@ -3750,13 +3755,13 @@ For Azure Blob links only. The client secret for the registered application. Use [%hardbreaks] {blank} -a| String +a¦ String -a| *clientCertificatePassword* + +a¦ *clientCertificatePassword* + _optional_ -a| +a¦ [markdown] @@ -3767,13 +3772,13 @@ For Azure Blob links only. The client certificate password for the registered ap [%hardbreaks] {blank} -a| String +a¦ String -a| *jsonCredentials* + +a¦ *jsonCredentials* + _optional_ -a| +a¦ [markdown] @@ -3784,13 +3789,13 @@ For Google Cloud Storage links only. The JSON credentials of the link. This par [%hardbreaks] {blank} -a| String +a¦ String -a| *applicationDefaultCredentials* + +a¦ *applicationDefaultCredentials* + _optional_ -a| +a¦ [markdown] @@ -3802,7 +3807,7 @@ For Google Cloud Storage links only. If present, indicates that the link should *Values:* `"true"` {blank} -a| String +a¦ String @@ -3820,16 +3825,6 @@ a| String // markup not found, no include::{specDir}paths/put_link/operation-parameters-after.adoc[opts=optional] -[#put_link-produces] -= Produces - -* application/json - -[#put_link-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/put_link/operation-responses-before.adoc[opts=optional] @@ -4052,14 +4047,14 @@ These properties are common to all links. //end::desc-ResponseAll[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *scope* + _required_ -a| +a¦ [markdown] -- @@ -4070,15 +4065,15 @@ The scope name may contain one or two identifiers, separated by a slash (/). -- [%hardbreaks] -*Example:* `pass:c["travel-sample/inventory"]` +*Example:* `+++"travel-sample/inventory"+++` {blank} -a| String +a¦ String -a| +a¦ *name* + _required_ -a| +a¦ [markdown] -- @@ -4086,15 +4081,15 @@ The name of the link. -- [%hardbreaks] -*Example:* `pass:c["myLink"]` +*Example:* `+++"myLink"+++` {blank} -a| String +a¦ String -a| [#type] +a¦ [#type] *type* + _required_ -a| +a¦ [markdown] -- @@ -4109,7 +4104,7 @@ The type of the link. [%hardbreaks] *Values:* `"couchbase"`, `"s3"`, `"azureblob"`, `"gcs"` {blank} -a| String +a¦ String |=== @@ -4208,14 +4203,14 @@ endif::collapse-models[] //tag::ResponseAzureBlobSpecific[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *accountKey* + _optional_ -a| +a¦ [markdown] -- @@ -4224,15 +4219,15 @@ The account key. Used for shared key authentication. This is redacted for the sa -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *accountName* + _optional_ -a| +a¦ [markdown] -- @@ -4241,15 +4236,15 @@ The account name. Used for shared key authentication. If not set, this property -- [%hardbreaks] -*Example:* `pass:c["myAccountName"]` +*Example:* `+++"myAccountName"+++` {blank} -a| String +a¦ String -a| +a¦ *clientCertificate* + _optional_ -a| +a¦ [markdown] -- @@ -4258,15 +4253,15 @@ The client certificate for the registered application. Used for Azure Active Dir -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *clientCertificatePassword* + _optional_ -a| +a¦ [markdown] -- @@ -4275,15 +4270,15 @@ The client certificate password for the registered application. Used for Azure A -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *clientId* + _optional_ -a| +a¦ [markdown] -- @@ -4292,15 +4287,15 @@ The client ID for the registered application. Used for Azure Active Directory cl -- [%hardbreaks] -*Example:* `pass:c["myClientID"]` +*Example:* `+++"myClientID"+++` {blank} -a| String +a¦ String -a| +a¦ *clientSecret* + _optional_ -a| +a¦ [markdown] -- @@ -4309,15 +4304,15 @@ The client secret for the registered application. Used for Azure Active Director -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *endpoint* + _required_ -a| +a¦ [markdown] -- @@ -4325,15 +4320,15 @@ The endpoint URI. -- [%hardbreaks] -*Example:* `pass:c["my.endpoint.uri"]` +*Example:* `+++"my.endpoint.uri"+++` {blank} -a| String +a¦ String -a| +a¦ *managedIdentityId* + _optional_ -a| +a¦ [markdown] -- @@ -4342,15 +4337,15 @@ The managed identity ID. Used for managed identity authentication. If not set, t -- [%hardbreaks] -*Example:* `pass:c["myManagedIdentityID"]` +*Example:* `+++"myManagedIdentityID"+++` {blank} -a| String +a¦ String -a| +a¦ *sharedAccessSignature* + _optional_ -a| +a¦ [markdown] -- @@ -4359,15 +4354,15 @@ A token that can be used for authentication. Used for shared access signature au -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *tenantId* + _optional_ -a| +a¦ [markdown] -- @@ -4376,9 +4371,9 @@ The tenant ID where the registered application is created. Used for Azure Active -- [%hardbreaks] -*Example:* `pass:c["myTenantID"]` +*Example:* `+++"myTenantID"+++` {blank} -a| String +a¦ String |=== @@ -4455,14 +4450,14 @@ endif::collapse-models[] //tag::ResponseCouchbaseSpecific[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *activeHostname* + _required_ -a| +a¦ [markdown] -- @@ -4470,15 +4465,15 @@ The remote hostname. -- [%hardbreaks] -*Example:* `pass:c["remoteHostName:8091"]` +*Example:* `+++"remoteHostName:8091"+++` {blank} -a| String +a¦ String -a| +a¦ *bootstrapAlternateAddress* + _required_ -a| +a¦ [markdown] -- @@ -4488,13 +4483,13 @@ Specifies whether the provided (bootstrap) hostname is an alternative address. [%hardbreaks] *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *bootstrapHostname* + _required_ -a| +a¦ [markdown] -- @@ -4502,15 +4497,15 @@ The provided (bootstrap) hostname. -- [%hardbreaks] -*Example:* `pass:c["remoteHostName:8091"]` +*Example:* `+++"remoteHostName:8091"+++` {blank} -a| String +a¦ String -a| +a¦ *certificate* + _required_ -a| +a¦ [markdown] -- @@ -4520,13 +4515,13 @@ The content of the target cluster root certificate. Only set for links with full [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *clientCertificate* + _required_ -a| +a¦ [markdown] -- @@ -4536,13 +4531,13 @@ The content of the client certificate. Only set for links with full encryption u [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *clientKey* + _required_ -a| +a¦ [markdown] -- @@ -4552,13 +4547,13 @@ The content of the client key. Only set for links with full encryption using cli [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *clusterCompatibility* + _required_ -a| +a¦ [markdown] -- @@ -4568,13 +4563,13 @@ For internal use only. [%hardbreaks] *Example:* `393221` {blank} -a| Integer +a¦ Integer -a| [#encryption] +a¦ [#encryption] *encryption* + _required_ -a| +a¦ [markdown] -- @@ -4589,13 +4584,13 @@ The type of encryption used by the link. [%hardbreaks] *Values:* `"none"`, `"half"`, `"full"` {blank} -a| String +a¦ String -a| +a¦ *nodes* + _required_ -a| +a¦ [markdown] -- @@ -4604,13 +4599,13 @@ An array of objects, each of which contains information about a node in the targ [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *password* + _required_ -a| +a¦ [markdown] -- @@ -4619,15 +4614,15 @@ The password used to connect to the link. This is redacted for the sake of secur -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *username* + _required_ -a| +a¦ [markdown] -- @@ -4636,15 +4631,15 @@ The remote username. Not set for links with full encryption using client certifi -- [%hardbreaks] -*Example:* `pass:c["remote.user"]` +*Example:* `+++"remote.user"+++` {blank} -a| String +a¦ String -a| +a¦ *uuid* + _required_ -a| +a¦ [markdown] -- @@ -4652,9 +4647,9 @@ A UUID uniquely identifying the link. -- [%hardbreaks] -*Example:* `pass:c["6331e2a390125b662f7bcfd63ecb3a73"]` +*Example:* `+++"6331e2a390125b662f7bcfd63ecb3a73"+++` {blank} -a| UUID (UUID) +a¦ UUID (UUID) |=== @@ -4694,14 +4689,14 @@ endif::collapse-models[] //tag::ResponseCouchbaseSpecificNode[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *alternateAddresses* + _optional_ -a| +a¦ [markdown] -- @@ -4711,13 +4706,13 @@ The alternate address defined on the node, if any. If not defined, this property [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *hostname* + _optional_ -a| +a¦ [markdown] -- @@ -4727,13 +4722,13 @@ The hostname of the node. If not defined, this property returns `null`. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *services* + _optional_ -a| +a¦ [markdown] -- @@ -4742,7 +4737,7 @@ include::index.adoc[tag=desc-ResponseCouchbaseSpecificNodeServices, opts=optiona [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -4787,14 +4782,14 @@ An object giving information about the services and ports configured on this nod //end::desc-ResponseCouchbaseSpecificNodeServices[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *cbas* + _optional_ -a| +a¦ [markdown] -- @@ -4804,13 +4799,13 @@ The port number for a connection to the Analytics service. [%hardbreaks] *Example:* `8095` {blank} -a| Integer +a¦ Integer -a| +a¦ *cbasSSL* + _optional_ -a| +a¦ [markdown] -- @@ -4820,13 +4815,13 @@ The port number for an encrypted connection to the Analytics service. [%hardbreaks] *Example:* `18095` {blank} -a| Integer +a¦ Integer -a| +a¦ *kv* + _optional_ -a| +a¦ [markdown] -- @@ -4836,13 +4831,13 @@ The port number for a connection to the Data service. [%hardbreaks] *Example:* `11210` {blank} -a| Integer +a¦ Integer -a| +a¦ *kvSSL* + _optional_ -a| +a¦ [markdown] -- @@ -4852,13 +4847,13 @@ The port number for an encrypted connection to the Data service. [%hardbreaks] *Example:* `11207` {blank} -a| Integer +a¦ Integer -a| +a¦ *mgmt* + _optional_ -a| +a¦ [markdown] -- @@ -4868,13 +4863,13 @@ The port number for a connection to the Cluster Manager service. [%hardbreaks] *Example:* `8091` {blank} -a| Integer +a¦ Integer -a| +a¦ *mgmtSSL* + _optional_ -a| +a¦ [markdown] -- @@ -4884,7 +4879,7 @@ The port number for an encrypted connection to the Cluster Manager service. [%hardbreaks] *Example:* `18091` {blank} -a| Integer +a¦ Integer |=== @@ -4961,14 +4956,14 @@ endif::collapse-models[] //tag::ResponseGCSSpecific[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *applicationDefaultCredentials* + _required_ -a| +a¦ [markdown] -- @@ -4978,15 +4973,15 @@ If present, indicates that the link should use the Google Application Default Cr [%hardbreaks] *Values:* `"true"` -*Example:* `pass:c["true"]` +*Example:* `+++"true"+++` {blank} -a| String +a¦ String -a| +a¦ *endpoint* + _required_ -a| +a¦ [markdown] -- @@ -4995,15 +4990,15 @@ The endpoint URI. If not set, this property returns `null`. -- [%hardbreaks] -*Example:* `pass:c["https://storage.googleapis.com"]` +*Example:* `+++"https://storage.googleapis.com"+++` {blank} -a| String +a¦ String -a| +a¦ *jsonCredentials* + _required_ -a| +a¦ [markdown] -- @@ -5012,9 +5007,9 @@ The JSON credentials of the link. If not set, this property returns `null`. -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String |=== @@ -5091,14 +5086,14 @@ endif::collapse-models[] //tag::ResponseS3Specific[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *accessKeyId* + _required_ -a| +a¦ [markdown] -- @@ -5106,15 +5101,15 @@ The Amazon S3 access key ID. -- [%hardbreaks] -*Example:* `pass:c["myAccessKey"]` +*Example:* `+++"myAccessKey"+++` {blank} -a| String +a¦ String -a| +a¦ *region* + _required_ -a| +a¦ [markdown] -- @@ -5122,15 +5117,15 @@ The Amazon S3 region. -- [%hardbreaks] -*Example:* `pass:c["us-east-1"]` +*Example:* `+++"us-east-1"+++` {blank} -a| String +a¦ String -a| +a¦ *secretAccessKey* + _required_ -a| +a¦ [markdown] -- @@ -5139,15 +5134,15 @@ The Amazon S3 secret access key. This is redacted for the sake of security. -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *sessionToken* + _optional_ -a| +a¦ [markdown] -- @@ -5156,15 +5151,15 @@ The Amazon S3 session token. Indicates that the link has temporary access, and t -- [%hardbreaks] -*Example:* `pass:c[""]` +*Example:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *serviceEndpoint* + _required_ -a| +a¦ [markdown] -- @@ -5173,9 +5168,9 @@ Amazon S3 service endpoint. If not set, this property returns `null`. -- [%hardbreaks] -*Example:* `pass:c["my.endpoint.uri"]` +*Example:* `+++"my.endpoint.uri"+++` {blank} -a| String +a¦ String |=== @@ -5215,14 +5210,14 @@ endif::collapse-models[] //tag::Wrong[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *error* + _required_ -a| +a¦ [markdown] -- @@ -5231,7 +5226,7 @@ An error message. [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -5315,3 +5310,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/analytics-rest-service/pages/index.adoc b/docs/modules/analytics-rest-service/pages/index.adoc index 4801f648..30b33051 100644 --- a/docs/modules/analytics-rest-service/pages/index.adoc +++ b/docs/modules/analytics-rest-service/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Analytics service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Analytics service REST port. Use `18095` for secure access. [%hardbreaks] *Values:* `8095`, `18095` -*Example:* `pass:c[8095]` +*Example:* `+++8095+++` // end |=== @@ -175,6 +175,12 @@ An alternative endpoint for the [Read-Only Query Service](#get_service), provide // markup not found, no include::{specDir}paths/get_query/operation-description-end.adoc[opts=optional] + + +[#get_query-produces] +.Produces +* application/json + :leveloffset: -1 @@ -198,13 +204,13 @@ An alternative endpoint for the [Read-Only Query Service](#get_service), provide .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *body* + +a¦ *body* + _required_ -a| +a¦ [markdown] @@ -215,7 +221,7 @@ Specify the parameters in the query URL in URL-encoded format. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -235,12 +241,6 @@ a| <> // markup not found, no include::{specDir}paths/get_query/operation-parameters-after.adoc[opts=optional] -[#get_query-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_query/operation-responses-before.adoc[opts=optional] @@ -381,6 +381,12 @@ This is intended for situations where use of the `POST` method is restricted. // markup not found, no include::{specDir}paths/get_service/operation-description-end.adoc[opts=optional] + + +[#get_service-produces] +.Produces +* application/json + :leveloffset: -1 @@ -404,13 +410,13 @@ This is intended for situations where use of the `POST` method is restricted. .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *body* + +a¦ *body* + _required_ -a| +a¦ [markdown] @@ -421,7 +427,7 @@ Specify the parameters in the query URL in URL-encoded format. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -441,12 +447,6 @@ a| <> // markup not found, no include::{specDir}paths/get_service/operation-parameters-after.adoc[opts=optional] -[#get_service-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_service/operation-responses-before.adoc[opts=optional] @@ -584,6 +584,16 @@ An alternative endpoint for the [Query Service](#post_service), provided for too // markup not found, no include::{specDir}paths/post_query/operation-description-end.adoc[opts=optional] + +[#post_query-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#post_query-produces] +.Produces +* application/json + :leveloffset: -1 @@ -610,13 +620,13 @@ include::{specDir}paths/post_query/operation-parameters-begin.adoc[opts=optional .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _required_ -a| +a¦ [markdown] @@ -627,7 +637,7 @@ An object specifying one or more query parameters. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -644,17 +654,6 @@ a| <> // markup not found, no include::{specDir}paths/post_query/operation-parameters-after.adoc[opts=optional] -[#post_query-produces] -= Produces - -* application/json - -[#post_query-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_query/operation-responses-before.adoc[opts=optional] @@ -774,6 +773,16 @@ Enables you to execute a SQL\+\+ for Analytics statement. This method allows you // markup not found, no include::{specDir}paths/post_service/operation-description-end.adoc[opts=optional] + +[#post_service-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#post_service-produces] +.Produces +* application/json + :leveloffset: -1 @@ -800,13 +809,13 @@ include::{specDir}paths/post_service/operation-parameters-begin.adoc[opts=option .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _required_ -a| +a¦ [markdown] @@ -817,7 +826,7 @@ An object specifying one or more query parameters. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -834,17 +843,6 @@ a| <> // markup not found, no include::{specDir}paths/post_service/operation-parameters-after.adoc[opts=optional] -[#post_service-produces] -= Produces - -* application/json - -[#post_service-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_service/operation-responses-before.adoc[opts=optional] @@ -1052,14 +1050,14 @@ endif::collapse-models[] //tag::ParametersCommon[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *statement* + _required_ -a| +a¦ [markdown] -- @@ -1068,13 +1066,13 @@ Specifies at least one valid SQL\+\+ for Analytics statement to run. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *client_context_id* + _optional_ -a| +a¦ [markdown] -- @@ -1084,13 +1082,13 @@ An identifier passed by the client that is returned verbatim in the query respon [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *format* + _optional_ -a| +a¦ [markdown] -- @@ -1102,15 +1100,15 @@ Note that the only possible format is `JSON`. [%hardbreaks] *Values:* `"JSON"` -*Default:* `pass:c["JSON"]` +*Default:* `+++"JSON"+++` {blank} -a| String +a¦ String -a| +a¦ *pretty* + _optional_ -a| +a¦ [markdown] -- @@ -1120,13 +1118,13 @@ If `true`, the result is indented. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *query_context* + _optional_ -a| +a¦ [markdown] -- @@ -1135,15 +1133,15 @@ A scope for the statement. The value of this parameter must start with `default: -- [%hardbreaks] -*Default:* `pass:c["default:Default"]` +*Default:* `+++"default:Default"+++` {blank} -a| String +a¦ String -a| +a¦ *readonly* + _optional_ -a| +a¦ [markdown] -- @@ -1153,13 +1151,13 @@ If `true`, then DDL statements are not allowed. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *scan_consistency* + _optional_ -a| +a¦ [markdown] -- @@ -1169,15 +1167,15 @@ The consistency guarantee constraint for index scanning. If `not_bounded`, the q [%hardbreaks] *Values:* `"not_bounded"`, `"request_plus"` -*Default:* `pass:c["not_bounded"]` +*Default:* `+++"not_bounded"+++` {blank} -a| String +a¦ String -a| +a¦ *scan_wait* + _optional_ -a| +a¦ [markdown] -- @@ -1186,15 +1184,15 @@ The maximum time to wait for datasets to be updated before the query is executed -- [%hardbreaks] -*Default:* `pass:c[""]` +*Default:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *timeout* + _optional_ -a| +a¦ [markdown] -- @@ -1203,15 +1201,15 @@ Maximum time to spend on the request before timing out. The format includes an a -- [%hardbreaks] -*Default:* `pass:c[""]` +*Default:* `+++""+++` {blank} -a| String +a¦ String -a| +a¦ *args* + _optional_ -a| +a¦ [markdown] -- @@ -1220,13 +1218,13 @@ An array of positional parameter values. [%hardbreaks] {blank} -a| Any Type +a¦ Any Type array -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -1235,7 +1233,7 @@ A named parameter value. [%hardbreaks] {blank} -a| Any Type +a¦ Any Type |=== @@ -1275,14 +1273,14 @@ endif::collapse-models[] //tag::ParametersLocal[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *plan-format* + _optional_ -a| +a¦ [markdown] -- @@ -1291,15 +1289,15 @@ The plan format. [%hardbreaks] *Values:* `"JSON"`, `"STRING"` -*Default:* `pass:c["JSON"]` +*Default:* `+++"JSON"+++` {blank} -a| String +a¦ String -a| +a¦ *logical-plan* + _optional_ -a| +a¦ [markdown] -- @@ -1309,13 +1307,13 @@ If `true`, the logical plan is included in the query response. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *optimized-logical-plan* + _optional_ -a| +a¦ [markdown] -- @@ -1325,13 +1323,13 @@ If `true`, the optimized logical plan is included in the query response. [%hardbreaks] *Default:* `true` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *expression-tree* + _optional_ -a| +a¦ [markdown] -- @@ -1341,13 +1339,13 @@ If `true`, the expression tree is included in the query response. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *rewritten-expression-tree* + _optional_ -a| +a¦ [markdown] -- @@ -1357,13 +1355,13 @@ If `true`, the rewritten expression tree is included in the query response. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *job* + _optional_ -a| +a¦ [markdown] -- @@ -1373,13 +1371,13 @@ If `true`, the job details are included in the query response. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *max-warnings* + _optional_ -a| +a¦ [markdown] -- @@ -1389,7 +1387,7 @@ An integer specifying the maximum number of warning messages to be included in t [%hardbreaks] *Default:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) |=== @@ -1466,14 +1464,14 @@ endif::collapse-models[] //tag::ResponsesCommon[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *requestID* + _optional_ -a| +a¦ [markdown] -- @@ -1482,13 +1480,13 @@ A unique identifier for the response. [%hardbreaks] {blank} -a| UUID (UUID) +a¦ UUID (UUID) -a| +a¦ *clientContextID* + _optional_ -a| +a¦ [markdown] -- @@ -1504,13 +1502,13 @@ refer to `client_context_id` in [Query Parameters][1]. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *signature* + _optional_ -a| +a¦ [markdown] -- @@ -1520,13 +1518,13 @@ The schema of the results. Present only when the query completes successfully. [%hardbreaks] {blank} -a| Object +a¦ Object -a| +a¦ *results* + _optional_ -a| +a¦ [markdown] -- @@ -1536,13 +1534,13 @@ An array of all the objects returned by the query. An object can be any JSON val [%hardbreaks] {blank} -a| Any Type +a¦ Any Type array -a| +a¦ *status* + _optional_ -a| +a¦ [markdown] -- @@ -1552,13 +1550,13 @@ The status of the request. [%hardbreaks] *Values:* `"success"`, `"running"`, `"failed"`, `"timeout"`, `"fatal"` {blank} -a| String +a¦ String -a| +a¦ *errors* + _optional_ -a| +a¦ [markdown] -- @@ -1568,13 +1566,13 @@ An array of error objects. Present only if 1 or more errors are returned during [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *warnings* + _optional_ -a| +a¦ [markdown] -- @@ -1595,13 +1593,13 @@ By default, no warnings are returned, even if warnings have occurred during proc [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *metrics* + _optional_ -a| +a¦ [markdown] -- @@ -1610,7 +1608,7 @@ include::index.adoc[tag=desc-ResponsesCommonYardsticks, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -1650,14 +1648,14 @@ endif::collapse-models[] //tag::ResponsesCommonErrors[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *code* + _optional_ -a| +a¦ [markdown] -- @@ -1666,13 +1664,13 @@ A number that identifies the error. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *msg* + _optional_ -a| +a¦ [markdown] -- @@ -1682,7 +1680,7 @@ A message describing the error in detail. Refer to [Error Codes](/cloud/analytic [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -1722,14 +1720,14 @@ endif::collapse-models[] //tag::ResponsesCommonWarnings[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *code* + _optional_ -a| +a¦ [markdown] -- @@ -1738,13 +1736,13 @@ A number that identifies the warning. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *msg* + _optional_ -a| +a¦ [markdown] -- @@ -1753,7 +1751,7 @@ A message describing the warning in detail. [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -1798,14 +1796,14 @@ An object containing metrics about the request. //end::desc-ResponsesCommonYardsticks[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *elapsedTime* + _optional_ -a| +a¦ [markdown] -- @@ -1815,13 +1813,13 @@ The total time taken for the request, that is the time from when the request was [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *executionTime* + _optional_ -a| +a¦ [markdown] -- @@ -1831,13 +1829,13 @@ The time taken for the execution of the request, that is the time from when quer [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *resultCount* + _optional_ -a| +a¦ [markdown] -- @@ -1846,13 +1844,13 @@ The total number of objects in the results. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *resultSize* + _optional_ -a| +a¦ [markdown] -- @@ -1861,13 +1859,13 @@ The total number of bytes in the results. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *errorCount* + _optional_ -a| +a¦ [markdown] -- @@ -1876,13 +1874,13 @@ The number of errors that occurred during the request. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *warningCount* + _optional_ -a| +a¦ [markdown] -- @@ -1891,7 +1889,7 @@ The number of warnings that occurred during the request. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) |=== @@ -1931,14 +1929,14 @@ endif::collapse-models[] //tag::ResponsesLocal[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *plans* + _optional_ -a| +a¦ [markdown] -- @@ -1947,13 +1945,13 @@ include::index.adoc[tag=desc-ResponsesLocalPlans, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> -a| +a¦ *metrics* + _optional_ -a| +a¦ [markdown] -- @@ -1962,7 +1960,7 @@ include::index.adoc[tag=desc-ResponsesLocalYardsticks, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -2007,14 +2005,14 @@ An object containing the query plans, if requested. //end::desc-ResponsesLocalPlans[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *logicalPlan* + _optional_ -a| +a¦ [markdown] -- @@ -2023,13 +2021,13 @@ The logical plan. [%hardbreaks] {blank} -a| Object +a¦ Object -a| +a¦ *optimizedLogicalPlan* + _optional_ -a| +a¦ [markdown] -- @@ -2038,13 +2036,13 @@ The optimized logical plan. [%hardbreaks] {blank} -a| Object +a¦ Object -a| +a¦ *rewrittenExpressionTree* + _optional_ -a| +a¦ [markdown] -- @@ -2053,13 +2051,13 @@ The rewritten expression tree. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *expressionTree* + _optional_ -a| +a¦ [markdown] -- @@ -2068,13 +2066,13 @@ The expression tree. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *job* + _optional_ -a| +a¦ [markdown] -- @@ -2083,7 +2081,7 @@ The job details. [%hardbreaks] {blank} -a| Object +a¦ Object |=== @@ -2128,14 +2126,14 @@ An object containing metrics about the request. //end::desc-ResponsesLocalYardsticks[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *processedObjects* + _optional_ -a| +a¦ [markdown] -- @@ -2144,7 +2142,7 @@ Number of processed tuples during query execution. [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) |=== @@ -2231,3 +2229,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/analytics-rest-settings/pages/index.adoc b/docs/modules/analytics-rest-settings/pages/index.adoc index 9afcc159..18f3dc16 100644 --- a/docs/modules/analytics-rest-settings/pages/index.adoc +++ b/docs/modules/analytics-rest-settings/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Analytics service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Cluster administration REST port. Use `18091` for secure access. Note that [%hardbreaks] *Values:* `8091`, `18091` -*Example:* `pass:c[8091]` +*Example:* `+++8091+++` // end |=== @@ -174,6 +174,12 @@ Retrieves cluster-level Analytics settings. Note that only one setting is availa include::{specDir}paths/get_settings/operation-description-end.adoc[opts=optional] + + +[#get_settings-produces] +.Produces +* application/json + :leveloffset: -1 @@ -191,12 +197,6 @@ include::{specDir}paths/get_settings/operation-description-end.adoc[opts=optiona // markup not found, no include::{specDir}paths/get_settings/operation-parameters-after.adoc[opts=optional] -[#get_settings-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_settings/operation-responses-before.adoc[opts=optional] @@ -327,6 +327,15 @@ Sets cluster-level Analytics settings. Note that only one setting is available: include::{specDir}paths/post_settings/operation-description-end.adoc[opts=optional] + +[#post_settings-consumes] +.Consumes +* application/x-www-form-urlencoded + +[#post_settings-produces] +.Produces +* application/json + :leveloffset: -1 @@ -352,13 +361,13 @@ include::{specDir}paths/post_settings/operation-description-end.adoc[opts=option .Form Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *numReplicas* + +a¦ *numReplicas* + _optional_ -a| +a¦ [markdown] @@ -371,7 +380,7 @@ Specifies the number of replicas for Analytics. *Maximum:* `3` {blank} -a| Integer +a¦ Integer @@ -389,16 +398,6 @@ a| Integer // markup not found, no include::{specDir}paths/post_settings/operation-parameters-after.adoc[opts=optional] -[#post_settings-produces] -= Produces - -* application/json - -[#post_settings-consumes] -= Consumes - -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_settings/operation-responses-before.adoc[opts=optional] @@ -559,14 +558,14 @@ endif::collapse-models[] //tag::Settings[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *numReplicas* + _optional_ -a| +a¦ [markdown] -- @@ -578,7 +577,7 @@ Specifies the number of replicas for Analytics. *Maximum:* `3` *Example:* `3` {blank} -a| Integer +a¦ Integer |=== @@ -663,3 +662,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc new file mode 100644 index 00000000..88590463 --- /dev/null +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -0,0 +1,8598 @@ += Eventing REST API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Eventing REST API provides methods to work with and manipulate Couchbase Eventing functions. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Eventing service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Eventing service REST port. Use `18096` for secure access. +-- + +[%hardbreaks] +*Values:* `8096`, `18096` +*Example:* `+++8096+++` +// end + +|=== + + +include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 7 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Activation] += Activation +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-before.adoc[opts=optional] + + +[#basic_deploy] += Deploy a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_deploy/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function}/deploy +.... + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-description-before.adoc[opts=optional] + + +[#basic_deploy-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_deploy/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Deploys an undeployed function. +This is the preferred invocation. +-- + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-parameters-before.adoc[opts=optional] + + +[#basic_deploy-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_deploy/operation-parameters-begin.adoc[opts=optional] + + +[#basic_deploy-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#basic_deploy-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-responses-before.adoc[opts=optional] + + +[#basic_deploy-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_deploy/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-security-before.adoc[opts=optional] + + +[#basic_deploy-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_deploy/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}basic_deploy/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}basic_deploy/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_deploy/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-before.adoc[opts=optional] + + +[#basic_pause] += Pause a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_pause/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function}/pause +.... + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-description-before.adoc[opts=optional] + + +[#basic_pause-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_pause/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Pauses a function and creates a DCP checkpoint such that on a subsequent resume no mutations will be lost. +This is the preferred invocation. +-- + + +// markup not found, no include::{specDir}paths/basic_pause/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_pause/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-parameters-before.adoc[opts=optional] + + +[#basic_pause-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_pause/operation-parameters-begin.adoc[opts=optional] + + +[#basic_pause-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#basic_pause-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-responses-before.adoc[opts=optional] + + +[#basic_pause-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_pause/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/basic_pause/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-security-before.adoc[opts=optional] + + +[#basic_pause-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_pause/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/basic_pause/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_pause/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}basic_pause/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}basic_pause/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_pause/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_pause/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-before.adoc[opts=optional] + + +[#basic_resume] += Resume a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_resume/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/(function}/resume +.... + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-description-before.adoc[opts=optional] + + +[#basic_resume-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_resume/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Resumes a paused function from its paused DCP checkpoint. +This is the preferred invocation. +-- + + +// markup not found, no include::{specDir}paths/basic_resume/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_resume/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-parameters-before.adoc[opts=optional] + + +[#basic_resume-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_resume/operation-parameters-begin.adoc[opts=optional] + + +[#basic_resume-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#basic_resume-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-responses-before.adoc[opts=optional] + + +[#basic_resume-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_resume/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/basic_resume/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-security-before.adoc[opts=optional] + + +[#basic_resume-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_resume/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/basic_resume/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_resume/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}basic_resume/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}basic_resume/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_resume/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_resume/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-before.adoc[opts=optional] + + +[#basic_undeploy] += Undeploy a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function}/undeploy +.... + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-description-before.adoc[opts=optional] + + +[#basic_undeploy-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Undeploys a function. +This is the preferred invocation. +-- + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-parameters-before.adoc[opts=optional] + + +[#basic_undeploy-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-parameters-begin.adoc[opts=optional] + + +[#basic_undeploy-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#basic_undeploy-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-responses-before.adoc[opts=optional] + + +[#basic_undeploy-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-security-before.adoc[opts=optional] + + +[#basic_undeploy-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}basic_undeploy/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}basic_undeploy/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/basic_undeploy/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Advanced] += Advanced +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-before.adoc[opts=optional] + + +[#adv_function_import] += Create or Import a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function} +.... + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-description-before.adoc[opts=optional] + + +[#adv_function_import-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Creates or imports a single function. +-- + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-description-end.adoc[opts=optional] + + +[#adv_function_import-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-parameters-before.adoc[opts=optional] + + +[#adv_function_import-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import/operation-parameters-begin.adoc[opts=optional] + + +[#adv_function_import-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_function_import-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + +[#adv_function_import-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A single function definition object, or an array containing a single function definition object. The function name in the definition object must match that given by the path parameter. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-responses-before.adoc[opts=optional] + + +[#adv_function_import-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-security-before.adoc[opts=optional] + + +[#adv_function_import-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_function_import/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_function_import/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_import/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-before.adoc[opts=optional] + + +[#adv_function_import_all] += Create or Import Multiple Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions +.... + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-description-before.adoc[opts=optional] + + +[#adv_function_import_all-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Creates or imports multiple functions. + +Note that if any function's `language_compatibility` field is missing, the value will be set to the highest version supported by the server, unlike [Import Multiple Functions](#adv_multiple_import). +-- + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-description-end.adoc[opts=optional] + + +[#adv_function_import_all-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-parameters-before.adoc[opts=optional] + + +[#adv_function_import_all-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-parameters-begin.adoc[opts=optional] + + + + + + +[#adv_function_import_all-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A single function definition object, or an array containing one or more function definition objects. Function names must be unique. When multiple functions have the same name, an error is reported. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-responses-before.adoc[opts=optional] + + +[#adv_function_import_all-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-security-before.adoc[opts=optional] + + +[#adv_function_import_all-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_function_import_all/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_function_import_all/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_import_all/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-before.adoc[opts=optional] + + +[#adv_function_view] += View a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/functions/{function} +.... + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-description-before.adoc[opts=optional] + + +[#adv_function_view-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Provides a listing of a complete function definition available in the cluster. +The function could be in any state: deployed, undeployed, or paused. +If saved to a file the function definition can be imported into the cluster or a different cluster. +However any changes to the function definition made to the file outside the UI are discouraged. +-- + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-description-end.adoc[opts=optional] + + + +[#adv_function_view-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-parameters-before.adoc[opts=optional] + + +[#adv_function_view-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view/operation-parameters-begin.adoc[opts=optional] + + +[#adv_function_view-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_function_view-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-responses-before.adoc[opts=optional] + + +[#adv_function_view-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns a single function definition object. +-- +a| <> + + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-security-before.adoc[opts=optional] + + +[#adv_function_view-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_function_view/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_function_view/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_view/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-before.adoc[opts=optional] + + +[#adv_function_view_all] += View Multiple Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/functions +.... + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-description-before.adoc[opts=optional] + + +[#adv_function_view_all-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Provides an array of definitions of all functions available in the cluster. +The functions may be in any state: deployed, undeployed, or paused. +If saved to a file the function definitions can be imported into the cluster or a different cluster. +However any changes to the function definition made to the file outside the UI are discouraged. + +If this API is run as a non-Administrator, the results are filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-description-end.adoc[opts=optional] + + + +[#adv_function_view_all-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-responses-before.adoc[opts=optional] + + +[#adv_function_view_all-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns an array containing one or more function definition objects. +-- +a| <> + array + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-security-before.adoc[opts=optional] + + +[#adv_function_view_all-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_function_view_all/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_function_view_all/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_view_all/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-before.adoc[opts=optional] + + +[#adv_function_zap] += Delete Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-begin.adoc[opts=optional] + + +.... +DELETE /api/v1/functions/{function} +.... + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-description-before.adoc[opts=optional] + + +[#adv_function_zap-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Deletes a specific function from the cluster. + +WARNING: Use this API with caution, as it is irreversible. +-- + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-parameters-before.adoc[opts=optional] + + +[#adv_function_zap-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-parameters-begin.adoc[opts=optional] + + +[#adv_function_zap-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_function_zap-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-responses-before.adoc[opts=optional] + + +[#adv_function_zap-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-security-before.adoc[opts=optional] + + +[#adv_function_zap-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_function_zap/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_function_zap/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_zap/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-before.adoc[opts=optional] + + +[#adv_function_zap_all] += Delete Multiple Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-begin.adoc[opts=optional] + + +.... +DELETE /api/v1/functions +.... + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-description-before.adoc[opts=optional] + + +[#adv_function_zap_all-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Deletes **all functions** from the cluster. +WARNING: Use this API with caution, as it is irreversible. + +If this API is run as a non-Administrator the deleted set will be filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-responses-before.adoc[opts=optional] + + +[#adv_function_zap_all-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-security-before.adoc[opts=optional] + + +[#adv_function_zap_all-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_function_zap_all/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_function_zap_all/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_function_zap_all/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-before.adoc[opts=optional] + + +[#adv_multiple_export] += Export Multiple Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/export +.... + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-description-before.adoc[opts=optional] + + +[#adv_multiple_export-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +This is a convenience method to export all function definitions. +Exported functions are always set to the undeployed state at the time of export, regardless of their state in the cluster. +If saved to a file the function definitions can be imported into the cluster or a different cluster. +However any changes to the function definition made to the file outside the UI are discouraged. + +If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-description-end.adoc[opts=optional] + + + +[#adv_multiple_export-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-responses-before.adoc[opts=optional] + + +[#adv_multiple_export-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns an array containing one or more function definition objects. +-- +a| <> + array + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-security-before.adoc[opts=optional] + + +[#adv_multiple_export-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_multiple_export/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_multiple_export/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_multiple_export/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-before.adoc[opts=optional] + + +[#adv_multiple_import] += Import Multiple Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/import +.... + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-description-before.adoc[opts=optional] + + +[#adv_multiple_import-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Imports multiple functions. + +Note that if any function's `language_compatibility` field is missing, the value will be set to 6.0.0, unlike [Create or Import Multiple Functions](#adv_function_import_all). +-- + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-description-end.adoc[opts=optional] + + +[#adv_multiple_import-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-parameters-before.adoc[opts=optional] + + +[#adv_multiple_import-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-parameters-begin.adoc[opts=optional] + + + + + + +[#adv_multiple_import-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A single function definition object, or an array containing one or more function definition objects. Function names must be unique. When multiple functions have the same name, an error is reported. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-responses-before.adoc[opts=optional] + + +[#adv_multiple_import-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-security-before.adoc[opts=optional] + + +[#adv_multiple_import-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_multiple_import/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_multiple_import/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_multiple_import/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-before.adoc[opts=optional] + + +[#adv_settings_get] += View Function Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/functions/{function}/settings +.... + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-description-before.adoc[opts=optional] + + +[#adv_settings_get-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Return or export the full settings for one eventing function in the cluster. +The settings can be subsequently imported. +However any changes to the function settings made to the file outside the UI are discouraged. +-- + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-description-end.adoc[opts=optional] + + + +[#adv_settings_get-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-parameters-before.adoc[opts=optional] + + +[#adv_settings_get-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-parameters-begin.adoc[opts=optional] + + +[#adv_settings_get-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_settings_get-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-responses-before.adoc[opts=optional] + + +[#adv_settings_get-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns an object showing settings for the specified function. +-- +a| <> + + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-security-before.adoc[opts=optional] + + +[#adv_settings_get-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_settings_get/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_settings_get/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_settings_get/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-before.adoc[opts=optional] + + +[#adv_settings_update] += Update Function Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function}/settings +.... + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-description-before.adoc[opts=optional] + + +[#adv_settings_update-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Updates an undeployed or paused function with the provided settings. +You can only alter settings when the function is paused or undeployed; attempting to adjust a deployed function will result in an error. +During an edit, settings provided are merged. +Unspecified attributes retain their prior values. + +Note that you must always specify `deployment_status` and `processing_status` when using this REST endpoint to update any option or set of options. +To get the current values of `deployment_status` and `processing_status`, see [View All Functions Status](#status_all) or [View Function Status](#status_function). + +By adjusting `deployment_status` and `processing_status` this command can also deploy or resume a function; however, it cannot pause or undeploy a function. +-- + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-description-end.adoc[opts=optional] + + +[#adv_settings_update-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-parameters-before.adoc[opts=optional] + + +[#adv_settings_update-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-parameters-begin.adoc[opts=optional] + + +[#adv_settings_update-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_settings_update-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + +[#adv_settings_update-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +An object providing settings for the specified function. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-responses-before.adoc[opts=optional] + + +[#adv_settings_update-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-security-before.adoc[opts=optional] + + +[#adv_settings_update-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_settings_update/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_settings_update/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_settings_update/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-before.adoc[opts=optional] + + +[#adv_structure_get] += View Function Config + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/functions/{function}/config +.... + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-description-before.adoc[opts=optional] + + +[#adv_structure_get-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Export or return the configuration of the source keyspace and the eventing storage (metadata) keyspace for the specified function. +The definition can be subsequently imported. +However any changes to the function definition made to the file outside the UI are discouraged. +-- + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-description-end.adoc[opts=optional] + + + +[#adv_structure_get-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-parameters-before.adoc[opts=optional] + + +[#adv_structure_get-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-parameters-begin.adoc[opts=optional] + + +[#adv_structure_get-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_structure_get-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-responses-before.adoc[opts=optional] + + +[#adv_structure_get-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns an object showing the configuration of the specified function. +-- +a| <> + + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-security-before.adoc[opts=optional] + + +[#adv_structure_get-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_structure_get/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_structure_get/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_structure_get/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-before.adoc[opts=optional] + + +[#adv_structure_update] += Update Function Config + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function}/config +.... + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-description-before.adoc[opts=optional] + + +[#adv_structure_update-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Import the configuration and alter the source keyspace and the eventing storage (metadata) keyspace for the specified function. +You can only change these values if a function is in the undeployed state and the two keyspaces exist. +-- + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-description-end.adoc[opts=optional] + + +[#adv_structure_update-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-parameters-before.adoc[opts=optional] + + +[#adv_structure_update-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-parameters-begin.adoc[opts=optional] + + +[#adv_structure_update-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_structure_update-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + +[#adv_structure_update-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +An object providing the configuration for the specified function. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-responses-before.adoc[opts=optional] + + +[#adv_structure_update-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-security-before.adoc[opts=optional] + + +[#adv_structure_update-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_structure_update/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_structure_update/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_structure_update/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-before.adoc[opts=optional] + + +[#adv_text_get] += View Function Code + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_get/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/functions/{function}/appcode +.... + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-description-before.adoc[opts=optional] + + +[#adv_text_get-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_get/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Export only the JavaScript code for the specified function. +Note that unlike [View a Function](#adv_function_view), the JavaScript is not escaped, and the code is runnable in other environments. +The JavaScript code can be subsequently imported. +However any changes to the function definition made to the file outside the UI are discouraged. +-- + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-description-end.adoc[opts=optional] + + + +[#adv_text_get-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-parameters-before.adoc[opts=optional] + + +[#adv_text_get-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_get/operation-parameters-begin.adoc[opts=optional] + + +[#adv_text_get-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_text_get-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-responses-before.adoc[opts=optional] + + +[#adv_text_get-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_get/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns a string showing the code for the specified function. +-- +a| String + + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-security-before.adoc[opts=optional] + + +[#adv_text_get-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_get/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_text_get/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_text_get/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_text_get/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-before.adoc[opts=optional] + + +[#adv_text_update] += Update Function Code + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_update/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/functions/{function}/appcode +.... + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-description-before.adoc[opts=optional] + + +[#adv_text_update-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_update/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Import only the JavaScript code for the specified function. +Note that unlike [Create or Import Function](#adv_function_import), the JavaScript is not escaped and could come from other environments. +It is highly recommended that you use the flag `--data-binary` or `--upload-file` when importing your JavaScript appcode fragments to avoid potential encoding issues due to string escaping. +-- + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-description-end.adoc[opts=optional] + + +[#adv_text_update-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-parameters-before.adoc[opts=optional] + + +[#adv_text_update-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_update/operation-parameters-begin.adoc[opts=optional] + + +[#adv_text_update-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#adv_text_update-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + +[#adv_text_update-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A string providing the code for the specified function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-responses-before.adoc[opts=optional] + + +[#adv_text_update-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_update/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-security-before.adoc[opts=optional] + + +[#adv_text_update-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/adv_text_update/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}adv_text_update/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}adv_text_update/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/adv_text_update/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-GlobalConfig] += Global Config +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/config_get/operation-before.adoc[opts=optional] + + +[#config_get] += List Global Config + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_get/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/config +.... + + + +// markup not found, no include::{specDir}paths/config_get/operation-description-before.adoc[opts=optional] + + +[#config_get-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_get/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Shows all global configuration settings. +There are currently just two settings: `enable_debugger` and `ram_quota`. +Both of these settings can also be adjusted via the UI. +-- + + +// markup not found, no include::{specDir}paths/config_get/operation-description-end.adoc[opts=optional] + + + +[#config_get-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/config_get/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_get/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/config_get/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_get/operation-responses-before.adoc[opts=optional] + + +[#config_get-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_get/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Returns an object showing the global configuration settings. +-- +a| <> + + +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/config_get/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/config_get/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_get/operation-security-before.adoc[opts=optional] + + +[#config_get-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_get/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/config_get/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/config_get/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}config_get/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}config_get/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_get/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/config_get/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/config_update/operation-before.adoc[opts=optional] + + +[#config_update] += Modify Global Config + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_update/operation-begin.adoc[opts=optional] + + +.... +POST /api/v1/config +.... + + + +// markup not found, no include::{specDir}paths/config_update/operation-description-before.adoc[opts=optional] + + +[#config_update-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_update/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Modify global configuration settings. +During an edit, settings provided are merged. +Unspecified attributes retain their prior values. +The response indicates whether the Eventing service must be restarted for the new changes to take effect. +-- + + +// markup not found, no include::{specDir}paths/config_update/operation-description-end.adoc[opts=optional] + + +[#config_update-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +include::{specDir}paths/config_update/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_update/operation-parameters-before.adoc[opts=optional] + + +[#config_update-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_update/operation-parameters-begin.adoc[opts=optional] + + + + + + +[#config_update-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +An object providing the global configuration settings. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/config_update/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/config_update/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_update/operation-responses-before.adoc[opts=optional] + + +[#config_update-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_update/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/config_update/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/config_update/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_update/operation-security-before.adoc[opts=optional] + + +[#config_update-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/config_update/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/config_update/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/config_update/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}config_update/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}config_update/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/config_update/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/config_update/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-List] += List +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/list_all/operation-before.adoc[opts=optional] + + +[#list_all] += List All Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_all/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/list/functions +.... + + + +// markup not found, no include::{specDir}paths/list_all/operation-description-before.adoc[opts=optional] + + +[#list_all-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_all/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns a list (array) of the names of all Eventing functions in the cluster. +The returned list can also be filtered — see [List Filtered Functions](#list_query). + +If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/list_all/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/list_all/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_all/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/list_all/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_all/operation-responses-before.adoc[opts=optional] + + +[#list_all-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_all/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/list_all/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/list_all/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_all/operation-security-before.adoc[opts=optional] + + +[#list_all-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_all/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/list_all/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/list_all/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}list_all/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}list_all/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_all/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/list_all/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/list_query/operation-before.adoc[opts=optional] + + +[#list_query] += List Filtered Functions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_query/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/list/functions/query +.... + + + +// markup not found, no include::{specDir}paths/list_query/operation-description-before.adoc[opts=optional] + + +[#list_query-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_query/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns a list (array) of the names of all Eventing functions in the cluster. +The returned list can be filtered by the following: + +- Deployed status : in this case, paused is considered deployed. +- Source bucket: the listen to keyspace. +- Function type: whether the function modifies its own listen to keyspace. + +If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/list_query/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/list_query/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_query/operation-parameters-before.adoc[opts=optional] + + +[#list_query-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_query/operation-parameters-begin.adoc[opts=optional] + + + +[#list_query-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *deployed* + +_optional_ +a¦ + + +[markdown] +-- +If `true`, returns the names of all deployed (or paused) functions. +If `false`, returns the names of all undeployed functions. +-- + +[%hardbreaks] +{blank} + +a¦ Boolean + + + +a¦ *source_bucket* + +_optional_ +a¦ + + +[markdown] +-- +The name of a bucket. +Returns the names of Eventing functions in the cluster that have a source keyspace under the specified bucket. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *function_type* + +_optional_ +a¦ + + +[markdown] +-- +The function type. + +- `sbm`: Returns the names of Eventing functions in the cluster that modify their own source keyspace. +- `notsbm`: Returns the names of Eventing functions in the cluster that do not modify their own source keyspace. +-- + +[%hardbreaks] +*Values:* `"sbm"`, `"notsbm"` +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/list_query/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/list_query/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_query/operation-responses-before.adoc[opts=optional] + + +[#list_query-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_query/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/list_query/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/list_query/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_query/operation-security-before.adoc[opts=optional] + + +[#list_query-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/list_query/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/list_query/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/list_query/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}list_query/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}list_query/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_query/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/list_query/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Logging] += Logging +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> + + + +// markup not found, no include::{specDir}paths/log_view/operation-before.adoc[opts=optional] + + +[#log_view] += Get Log for a Function + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/log_view/operation-begin.adoc[opts=optional] + + +.... +GET /getAppLog +.... + + + +// markup not found, no include::{specDir}paths/log_view/operation-description-before.adoc[opts=optional] + + +[#log_view-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/log_view/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the most recent application log messages for the specified function. +-- + + +// markup not found, no include::{specDir}paths/log_view/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/log_view/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/log_view/operation-parameters-before.adoc[opts=optional] + + +[#log_view-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/log_view/operation-parameters-begin.adoc[opts=optional] + + + +[#log_view-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *name* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *aggregate* + +_optional_ +a¦ + + +[markdown] +-- +If `false`, the API accesses a single Eventing node. +If `true`, the API accesses all Eventing nodes. +-- + +[%hardbreaks] +*Default:* `false` +{blank} + +a¦ Boolean + + + +a¦ *size* + +_optional_ +a¦ + + +[markdown] +-- +The approximate amount of logging information returned. +Note that when fetching from more than one Eventing node, the amount of logging information returned from each node is the `size` divided by the number of nodes. +-- + +[%hardbreaks] +*Default:* `40960` +{blank} + +a¦ Integer + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/log_view/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/log_view/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/log_view/operation-responses-before.adoc[opts=optional] + + +[#log_view-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/log_view/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/log_view/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/log_view/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/log_view/operation-security-before.adoc[opts=optional] + + +[#log_view-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/log_view/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/log_view/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/log_view/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}log_view/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}log_view/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/log_view/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/log_view/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Statistics] += Statistics +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/stats_all/operation-before.adoc[opts=optional] + + +[#stats_all] += Get All Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_all/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/stats +.... + + + +// markup not found, no include::{specDir}paths/stats_all/operation-description-before.adoc[opts=optional] + + +[#stats_all-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_all/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Retrieve all statistics for the node. + + +If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/stats_all/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_all/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_all/operation-parameters-before.adoc[opts=optional] + + +[#stats_all-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_all/operation-parameters-begin.adoc[opts=optional] + + + +[#stats_all-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *type* + +_optional_ +a¦ + + +[markdown] +-- +Including this parameter returns the full statistics set, inclusive of events processing, events remaining, execution, failure, latency, worker PIDs and sequence processed. + +Omitting this parameter excludes `dcp_event_backlog_per_vb`, `doc_timer_debug_stats`, `latency_stats`, `plasma_stats`, and `seqs_processed` from the response. +-- + +[%hardbreaks] +*Values:* `"full"` +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/stats_all/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/stats_all/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_all/operation-responses-before.adoc[opts=optional] + + +[#stats_all-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_all/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/stats_all/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/stats_all/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_all/operation-security-before.adoc[opts=optional] + + +[#stats_all-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_all/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/stats_all/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_all/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}stats_all/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}stats_all/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_all/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_all/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-before.adoc[opts=optional] + + +[#stats_execution] += Get Execution Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_execution/operation-begin.adoc[opts=optional] + + +.... +GET /getExecutionStats +.... + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-description-before.adoc[opts=optional] + + +[#stats_execution-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_execution/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Retrieve only execution statistics. +This returns the subset of statistics for the node. +-- + + +// markup not found, no include::{specDir}paths/stats_execution/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_execution/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-parameters-before.adoc[opts=optional] + + +[#stats_execution-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_execution/operation-parameters-begin.adoc[opts=optional] + + + +[#stats_execution-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *name* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-responses-before.adoc[opts=optional] + + +[#stats_execution-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_execution/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/stats_execution/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-security-before.adoc[opts=optional] + + +[#stats_execution-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_execution/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/stats_execution/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_execution/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}stats_execution/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}stats_execution/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_execution/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_execution/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-before.adoc[opts=optional] + + +[#stats_failure] += Get Failure Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_failure/operation-begin.adoc[opts=optional] + + +.... +GET /getFailureStats +.... + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-description-before.adoc[opts=optional] + + +[#stats_failure-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_failure/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Retrieve only failure statistics. +This returns the subset of statistics for the node. +-- + + +// markup not found, no include::{specDir}paths/stats_failure/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_failure/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-parameters-before.adoc[opts=optional] + + +[#stats_failure-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_failure/operation-parameters-begin.adoc[opts=optional] + + + +[#stats_failure-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *name* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-responses-before.adoc[opts=optional] + + +[#stats_failure-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_failure/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/stats_failure/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-security-before.adoc[opts=optional] + + +[#stats_failure-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_failure/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/stats_failure/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_failure/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}stats_failure/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}stats_failure/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_failure/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_failure/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-before.adoc[opts=optional] + + +[#stats_latency] += Get Latency Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_latency/operation-begin.adoc[opts=optional] + + +.... +GET /getLatencyStats +.... + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-description-before.adoc[opts=optional] + + +[#stats_latency-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_latency/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Retrieve only latency statistics. +This returns the subset of statistics for the node. +-- + + +// markup not found, no include::{specDir}paths/stats_latency/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_latency/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-parameters-before.adoc[opts=optional] + + +[#stats_latency-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_latency/operation-parameters-begin.adoc[opts=optional] + + + +[#stats_latency-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *name* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-responses-before.adoc[opts=optional] + + +[#stats_latency-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_latency/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/stats_latency/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-security-before.adoc[opts=optional] + + +[#stats_latency-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_latency/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/stats_latency/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_latency/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}stats_latency/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}stats_latency/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_latency/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_latency/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-before.adoc[opts=optional] + + +[#stats_reset] += Reset Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_reset/operation-begin.adoc[opts=optional] + + +.... +GET /resetStatsCounters +.... + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-description-before.adoc[opts=optional] + + +[#stats_reset-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_reset/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Resets statistics for the specified function. +-- + + +// markup not found, no include::{specDir}paths/stats_reset/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_reset/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-parameters-before.adoc[opts=optional] + + +[#stats_reset-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_reset/operation-parameters-begin.adoc[opts=optional] + + + +[#stats_reset-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *appName* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-responses-before.adoc[opts=optional] + + +[#stats_reset-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_reset/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/stats_reset/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-security-before.adoc[opts=optional] + + +[#stats_reset-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/stats_reset/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/stats_reset/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_reset/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}stats_reset/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}stats_reset/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/stats_reset/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/stats_reset/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Status] += Status +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/status_all/operation-before.adoc[opts=optional] + + +[#status_all] += View All Functions Status + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_all/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/status +.... + + + +// markup not found, no include::{specDir}paths/status_all/operation-description-before.adoc[opts=optional] + + +[#status_all-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_all/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns a list (array) of all eventing functions, showing their corresponding `composite_status`. +A function's status can have one of the following values: undeployed, deploying, deployed, undeploying, paused, and pausing. +Note that there is no value of resuming; when resuming a paused eventing function, the `composite_status` returns `deploying` until it reaches the deployed state. + +If this API is run as a non-Administrator, the results are filtered via RBAC to include only the function scopes the user has access to. +-- + + +// markup not found, no include::{specDir}paths/status_all/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/status_all/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_all/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/status_all/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_all/operation-responses-before.adoc[opts=optional] + + +[#status_all-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_all/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/status_all/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/status_all/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_all/operation-security-before.adoc[opts=optional] + + +[#status_all-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_all/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/status_all/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/status_all/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}status_all/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}status_all/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_all/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/status_all/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/status_function/operation-before.adoc[opts=optional] + + +[#status_function] += View Function Status + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_function/operation-begin.adoc[opts=optional] + + +.... +GET /api/v1/status/{function} +.... + + + +// markup not found, no include::{specDir}paths/status_function/operation-description-before.adoc[opts=optional] + + +[#status_function-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_function/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the specified function, showing its corresponding `composite_status`. +It can have one of the following values: undeployed, deploying, deployed, undeploying, paused, and pausing. +Note that there is no value of resuming; when resuming a paused eventing function, the `composite_status` returns `deploying` until it reaches the deployed state. +-- + + +// markup not found, no include::{specDir}paths/status_function/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/status_function/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_function/operation-parameters-before.adoc[opts=optional] + + +[#status_function-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_function/operation-parameters-begin.adoc[opts=optional] + + +[#status_function-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *function* + +_required_ +a¦ + + +[markdown] +-- +The name of a function. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#status_function-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/status_function/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/status_function/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_function/operation-responses-before.adoc[opts=optional] + + +[#status_function-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_function/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| +| 404 +a| [markdown] +-- +Failure. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/status_function/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/status_function/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_function/operation-security-before.adoc[opts=optional] + + +[#status_function-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/status_function/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/status_function/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/status_function/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}status_function/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}status_function/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/status_function/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/status_function/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 10 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +endif::[] + + + +include::{specDir}definitions/AddFunction/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#AddFunction] += Function Request + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/AddFunction/definition-begin.adoc[opts=optional] + + +.icon:bars[fw] Composite Schema +{blank} + +One of the following: + +* <> + + +* <> + array + + + +// markup not found, no include::{specDir}definitions/AddFunction/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/AddFunction/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/AddFunctions/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#AddFunctions] += Functions Request + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/AddFunctions/definition-begin.adoc[opts=optional] + + +.icon:bars[fw] Composite Schema +{blank} + +One of the following: + +* <> + + +* <> + array + + + +// markup not found, no include::{specDir}definitions/AddFunctions/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/AddFunctions/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#depcfg_schema] += Deployment Config + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/depcfg_schema/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::depcfg_schema[] + +ifdef::model-descriptions[] +//tag::desc-depcfg_schema[] +deployment configuration +//end::desc-depcfg_schema[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*buckets* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ <> + array + +a¦ +*curl* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ <> + array + +a¦ +*metadata_bucket* + +_required_ +a¦ + +[markdown] +-- +bucket to store eventing checkpoints and timers +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +a¦ +*metadata_scope* + +_optional_ +a¦ + +[markdown] +-- +scope to store eventing checkpoints and timers +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*metadata_collection* + +_optional_ +a¦ + +[markdown] +-- +collection to store eventing checkpoints and timers +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*source_bucket* + +_required_ +a¦ + +[markdown] +-- +bucket to listen to for document mutations +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +a¦ +*source_scope* + +_optional_ +a¦ + +[markdown] +-- +scope to listen to for document mutations +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*source_collection* + +_optional_ +a¦ + +[markdown] +-- +collection to listen to for document mutations +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*constants* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ <> + array + +|=== + +//end::depcfg_schema[] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/depcfg_schema/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema_constants_inner/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#depcfg_schema_constants_inner] += Deployment Constants + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/depcfg_schema_constants_inner/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::depcfg_schema_constants_inner[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*value* + +_required_ +a¦ + +[markdown] +-- +alias name of the constant binding +-- + +[%hardbreaks] +*Pattern:* `+++/^[a-zA-Z_$][a-zA-Z0-9_$]*$/+++` +*Minimum length:* `1` +*Maximum length:* `64` +{blank} +a¦ String + + +a¦ +*literal* + +_required_ +a¦ + +[markdown] +-- +literal value bound to the alias name +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +|=== + +//end::depcfg_schema_constants_inner[] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema_constants_inner/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/depcfg_schema_constants_inner/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema_buckets_inner/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#depcfg_schema_buckets_inner] += Deployment Keyspace + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/depcfg_schema_buckets_inner/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::depcfg_schema_buckets_inner[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*alias* + +_required_ +a¦ + +[markdown] +-- +symbolic name used in code to refer to this binding +-- + +[%hardbreaks] +*Pattern:* `+++/^[a-zA-Z_$][a-zA-Z0-9_$]*$/+++` +*Minimum length:* `1` +*Maximum length:* `64` +{blank} +a¦ String + + +a¦ +*bucket_name* + +_required_ +a¦ + +[markdown] +-- +name of the bucket this binding maps to +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +a¦ +*scope_name* + +_optional_ +a¦ + +[markdown] +-- +name of the scope this binding maps to +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*collection_name* + +_optional_ +a¦ + +[markdown] +-- +name of the collection this binding maps to +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*access* + +_required_ +a¦ + +[markdown] +-- +bucket access level (read or read+write) +-- + +[%hardbreaks] +*Values:* `"r"`, `"rw"` +{blank} +a¦ String + + +|=== + +//end::depcfg_schema_buckets_inner[] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema_buckets_inner/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/depcfg_schema_buckets_inner/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema_curl_inner/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#depcfg_schema_curl_inner] += Deployment URL + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/depcfg_schema_curl_inner/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::depcfg_schema_curl_inner[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*hostname* + +_required_ +a¦ + +[markdown] +-- +full URL (including any path) that this binding connects +-- + +[%hardbreaks] +*Pattern:* `+++/^https?:\/\//+++` +*Minimum length:* `1` +{blank} +a¦ URI (uri) + + +a¦ +*value* + +_required_ +a¦ + +[markdown] +-- +symbolic name used in code to refer to this binding +-- + +[%hardbreaks] +*Pattern:* `+++/^[a-zA-Z_$][a-zA-Z0-9_$]*$/+++` +*Minimum length:* `1` +*Maximum length:* `64` +{blank} +a¦ String + + +a¦ +*auth_type* + +_required_ +a¦ + +[markdown] +-- +http authentication method to use with this endpoint +-- + +[%hardbreaks] +*Values:* `"no-auth"`, `"basic"`, `"bearer"`, `"digest"` +{blank} +a¦ String + + +a¦ +*username* + +_optional_ +a¦ + +[markdown] +-- +username for http auth methods that use it +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*password* + +_optional_ +a¦ + +[markdown] +-- +password for http auth methods that use it +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*bearer_key* + +_optional_ +a¦ + +[markdown] +-- +bearer key for bearer auth +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*allow_cookies* + +_required_ +a¦ + +[markdown] +-- +allow cookies on the session +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*validate_ssl_certificate* + +_required_ +a¦ + +[markdown] +-- +validate remote server certificate using OS mechanisms +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +|=== + +//end::depcfg_schema_curl_inner[] + + + + +// markup not found, no include::{specDir}definitions/depcfg_schema_curl_inner/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/depcfg_schema_curl_inner/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/handler_schema/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#handler_schema] += Function Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/handler_schema/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::handler_schema[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*appcode* + +_required_ +a¦ + +[markdown] +-- +handler code +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +a¦ +*depcfg* + +_required_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-depcfg_schema, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*version* + +_required_ +a¦ + +[markdown] +-- +authoring tool. use 'external' if authored or edited outside eventing ui +-- + +[%hardbreaks] +*Pattern:* `+++/^evt-[5-7].[0-9]+.[0-9]+-[0-9]{4}-(ee|ce)$/+++` +{blank} +a¦ String + + +a¦ +*enforce_schema* + +_optional_ +a¦ + +[markdown] +-- +enforces stricter validation for all settings and configuration fields. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*handleruuid* + +_optional_ +a¦ + +[markdown] +-- +unique id of the the handler. generated by server +-- + +[%hardbreaks] +*Minimum:* `0` +{blank} +a¦ Integer + + +a¦ +*function_instance_id* + +_optional_ +a¦ + +[markdown] +-- +unique id of the deployment of the handler. generated by server +-- + +[%hardbreaks] +*Minimum length:* `0` +{blank} +a¦ String + + +a¦ +*appname* + +_required_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +*Pattern:* `+++/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/+++` +*Minimum length:* `1` +*Maximum length:* `100` +{blank} +a¦ String + + +a¦ +*settings* + +_required_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-settings_schema, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*function_scope* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-function_scope_schema, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::handler_schema[] + + + + +// markup not found, no include::{specDir}definitions/handler_schema/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/handler_schema/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/function_scope_schema/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#function_scope_schema] += Function Scope + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/function_scope_schema/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::function_scope_schema[] + +ifdef::model-descriptions[] +//tag::desc-function_scope_schema[] +function scope +//end::desc-function_scope_schema[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*bucket* + +_required_ +a¦ + +[markdown] +-- +bucket to which function belongs +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +a¦ +*scope* + +_required_ +a¦ + +[markdown] +-- +scope to which function belongs +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +|=== + +//end::function_scope_schema[] + + + + +// markup not found, no include::{specDir}definitions/function_scope_schema/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/function_scope_schema/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/settings_schema/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#settings_schema] += Function Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/settings_schema/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::settings_schema[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*cpp_worker_thread_count* + +_optional_ +a¦ + +[markdown] +-- +number of threads each worker utilizes +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*dcp_stream_boundary* + +_optional_ +a¦ + +[markdown] +-- +indicates where to start dcp stream from (beginning of time, present point) 'from_prior' is deprecated in 6.6.2 +-- + +[%hardbreaks] +*Values:* `"everything"`, `"from_now"` +{blank} +a¦ String + + +a¦ +*deployment_status* + +_optional_ +a¦ + +[markdown] +-- +indicates if the function is deployed. true=deployed, false=undeployed +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*description* + +_optional_ +a¦ + +[markdown] +-- +free form text for user to describe the handler. no functional role +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*execution_timeout* + +_optional_ +a¦ + +[markdown] +-- +maximum time the handler can run before it is forcefully terminated (in seconds) +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*cursor_checkpoint_timeout* + +_optional_ +a¦ + +[markdown] +-- +maximum time the to checkpoint writer can run before it is forcefully terminated (in seconds) +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*on_deploy_timeout* + +_optional_ +a¦ + +[markdown] +-- +maximum time the OnDeploy handler can run before it is terminated (in seconds) +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*language_compatibility* + +_optional_ +a¦ + +[markdown] +-- +eventing language version this handler assumes in terms of syntax and behavior +-- + +[%hardbreaks] +*Values:* `"6.6.2"`, `"6.0.0"`, `"6.5.0"`, `"7.2.0"` +{blank} +a¦ String + + +a¦ +*lcb_inst_capacity* + +_optional_ +a¦ + +[markdown] +-- +maximum number of libcouchbase connections that may be opened and pooled +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*lcb_retry_count* + +_optional_ +a¦ + +[markdown] +-- +number of retries of retriable libcouchbase failures. 0 keeps trying till execution_timeout +-- + +[%hardbreaks] +*Minimum:* `0` +{blank} +a¦ Integer + + +a¦ +*lcb_timeout* + +_optional_ +a¦ + +[markdown] +-- +maximum time the lcb command is waited until completion before we terminate the request(in seconds) +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*log_level* + +_optional_ +a¦ + +[markdown] +-- +level of detail in system logging +-- + +[%hardbreaks] +*Values:* `"INFO"`, `"ERROR"`, `"WARNING"`, `"DEBUG"`, `"TRACE"` +{blank} +a¦ String + + +a¦ +*n1ql_consistency* + +_optional_ +a¦ + +[markdown] +-- +consistency level used by n1ql statements in the handler +-- + +[%hardbreaks] +*Values:* `"none"`, `"request"` +{blank} +a¦ String + + +a¦ +*num_timer_partitions* + +_optional_ +a¦ + +[markdown] +-- +number of timer shards. defaults to number of vbuckets +-- + +[%hardbreaks] +*Values:* `1`, `2`, `4`, `8`, `16`, `32`, `64`, `128`, `256`, `512`, `1024` +{blank} +a¦ Integer + + +a¦ +*processing_status* + +_optional_ +a¦ + +[markdown] +-- +indicates if the function is running (i.e., not paused). true=running, false=paused +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*sock_batch_size* + +_optional_ +a¦ + +[markdown] +-- +batch size for messages from producer to consumer. normally, this must not be specified +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*tick_duration* + +_optional_ +a¦ + +[markdown] +-- +duration to log stats from this handler, in milliseconds +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*timer_context_size* + +_optional_ +a¦ + +[markdown] +-- +size limit of timer context object +-- + +[%hardbreaks] +*Minimum:* `20` +*Maximum:* `20971520` +{blank} +a¦ Integer + + +a¦ +*user_prefix* + +_optional_ +a¦ + +[markdown] +-- +key prefix for all data stored in metadata by this handler +-- + +[%hardbreaks] +*Minimum length:* `1` +{blank} +a¦ String + + +a¦ +*worker_count* + +_optional_ +a¦ + +[markdown] +-- +number of worker processes handler utilizes on each eventing node +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*n1ql_prepare_all* + +_optional_ +a¦ + +[markdown] +-- +automatically prepare all n1ql statements in the handler +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*handler_headers* + +_optional_ +a¦ + +[markdown] +-- +code to automatically prepend to top of handler code +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*handler_footers* + +_optional_ +a¦ + +[markdown] +-- +code to automatically append to bottom of handler code +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*enable_applog_rotation* + +_optional_ +a¦ + +[markdown] +-- +enable rotating this handlers log() message files +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*app_log_dir* + +_optional_ +a¦ + +[markdown] +-- +directory to write content of log() message files +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*app_log_max_size* + +_optional_ +a¦ + +[markdown] +-- +rotate logs when file grows to this size in bytes approximately +-- + +[%hardbreaks] +*Minimum:* `1024` +{blank} +a¦ Integer + + +a¦ +*app_log_max_files* + +_optional_ +a¦ + +[markdown] +-- +number of log() message files to retain when rotating +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*checkpoint_interval* + +_optional_ +a¦ + +[markdown] +-- +number of seconds before writing a progress checkpoint +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*bucket_cache_size* + +_optional_ +a¦ + +[markdown] +-- +maximum size in bytes the bucket cache can grow to +-- + +[%hardbreaks] +*Minimum:* `20971520` +{blank} +a¦ Integer + + +a¦ +*bucket_cache_age* + +_optional_ +a¦ + +[markdown] +-- +time in milliseconds after which a cached bucket object is considered stale +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*curl_max_allowed_resp_size* + +_optional_ +a¦ + +[markdown] +-- +maximum allowable curl call response in 'MegaBytes'. Setting the value to 0 lifts the upper limit off. This parameters affects v8 engine stability since it defines the maximum amount of heap space acquired by a curl call +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*allow_transaction_mutations* + +_optional_ +a¦ + +[markdown] +-- +allow staged transaction mutations +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*allow_sync_documents* + +_optional_ +a¦ + +[markdown] +-- +allow sync gateway mutations +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*cursor_aware* + +_optional_ +a¦ + +[markdown] +-- +syncgateway aware function +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*high_seq_check_interval* + +_optional_ +a¦ + +[markdown] +-- +number of milliseconds before checking for high seq number +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*max_unacked_bytes* + +_optional_ +a¦ + +[markdown] +-- +max MBs to wait to send more bytes to c++ side +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*max_unacked_count* + +_optional_ +a¦ + +[markdown] +-- +max number of messages on c++ side +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*message_flush_time* + +_optional_ +a¦ + +[markdown] +-- +number of milliseconds before sending message to c++ side +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*max_parallel_vb* + +_optional_ +a¦ + +[markdown] +-- +number of parallel vb request per cpp thread +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::settings_schema[] + + + + +// markup not found, no include::{specDir}definitions/settings_schema/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/settings_schema/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/UnivConfig/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#UnivConfig] += Global Config + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/UnivConfig/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::UnivConfig[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*ram_quota* + +_optional_ +a¦ + +[markdown] +-- +The memory allocation for the Eventing Service, per node. +-- + +[%hardbreaks] +*Default:* `256` +*Example:* `512` +{blank} +a¦ Integer + + +a¦ +*enable_debugger* + +_optional_ +a¦ + +[markdown] +-- +Enables the Eventing service debugger. +For details, see [Debugging and Diagnosability](/server/8.0/eventing/eventing-debugging-and-diagnosability.html). +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +|=== + +//end::UnivConfig[] + + + + +// markup not found, no include::{specDir}definitions/UnivConfig/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/UnivConfig/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Global/security-scheme-before.adoc[opts=optional] + + +[[security-global]] += Global + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Global/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +Global functions with a function scope of ``*.*`` can only be made or managed by users with the Full Admin or Eventing Full Admin role. +For global functions, you do not need to pass the `bucket` and `scope` query parameters to specify the function scope. +The credentials must be an administrator username and password. + +Note that this is the default function scope for all functions after an upgrade from a prior version. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Global/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Global/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Scoped/security-scheme-before.adoc[opts=optional] + + +[[security-scoped]] += Scoped + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Scoped/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +For scoped functions, you must pass the `bucket` and `scope` query parameters to specify the function scope. +The credentials are the username and password of any authorized user. + +You can quote the REST call on the command line to escape the `&` and `?` characters. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Scoped/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Scoped/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Unscoped/security-scheme-before.adoc[opts=optional] + + +[[security-unscoped]] += Unscoped + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Unscoped/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +Unscoped REST API calls do not require you to specify the function scope. +The action is fully determined by the username and password credentials passed to the REST call. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Unscoped/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Unscoped/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/eventing-rest-api/partials/definitions/AddFunction/definition-before.adoc b/docs/modules/eventing-rest-api/partials/definitions/AddFunction/definition-before.adoc new file mode 100644 index 00000000..bd4b8319 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/definitions/AddFunction/definition-before.adoc @@ -0,0 +1,4 @@ +[NOTE] +==== +Changes to the Eventing function definition files made outside of this REST API or the interactive UI are only supported if you adhere to the Eventing schemas described here. +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/header-attributes.adoc b/docs/modules/eventing-rest-api/partials/header-attributes.adoc new file mode 100644 index 00000000..690e987b --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: eventing:eventing-api.adoc +:page-edition: Enterprise Edition +:page-partial: +:!example-caption: diff --git a/docs/modules/eventing-rest-api/partials/overview/document-before.adoc b/docs/modules/eventing-rest-api/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/overview/document-end.adoc b/docs/modules/eventing-rest-api/partials/overview/document-end.adoc new file mode 100644 index 00000000..a30fdd90 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/overview/document-end.adoc @@ -0,0 +1,9 @@ +[discrete] += Examples on this page + +In the HTTP request examples: + +* `$HOST` is the host name or IP address of a node running the Eventing service. +* `$ADMIN` is the user name of an administrator -- see <>. +* `$USER` is the user name of any authorized user -- see <>. +* `$PASSWORD` is the password to connect to Couchbase Server. \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_function_import/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_function_import/http-request.adoc new file mode 100644 index 00000000..8eae594f --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_function_import/http-request.adoc @@ -0,0 +1,21 @@ += Example HTTP Requests + +.Import a global function +==== +.Curl request +[source,sh] +---- +curl -XPOST -d @./my_function.json \ + "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function" +---- +==== + +.Import a scoped function +==== +.Curl request +[source,sh] +---- +curl -XPOST -d @./my_function.json \ + "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_function_import_all/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_function_import_all/http-request.adoc new file mode 100644 index 00000000..cf57e1b4 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_function_import_all/http-request.adoc @@ -0,0 +1,11 @@ += Example HTTP Requests + +.Import multiple functions +==== +.Curl request +[source,sh] +---- +curl -XPOST -d @./array_of_functions.json \ + "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_function_view/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_function_view/http-request.adoc new file mode 100644 index 00000000..d2ffc02f --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_function_view/http-request.adoc @@ -0,0 +1,39 @@ += Example HTTP Requests + +.View a global function definition +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function" +---- +==== + +.View a scoped function definition +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function?bucket=bulk&scope=data" +---- +==== + +.Save a global function definition to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function" \ + -o my_function.json +---- +==== + +.Save a scoped function definition to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function?bucket=bulk&scope=data" \ + -o my_function.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_function_view_all/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_function_view_all/http-request.adoc new file mode 100644 index 00000000..481a1d17 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_function_view_all/http-request.adoc @@ -0,0 +1,20 @@ += Example HTTP Requests + +.View all function definitions +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions" +---- +==== + +.Save all function definitions to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions" \ + -o array_of_functions.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_function_zap/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_function_zap/http-request.adoc new file mode 100644 index 00000000..1ac865cb --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_function_zap/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Delete a global function +==== +.Curl request +[source,sh] +---- +curl -XDELETE "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function" +---- +==== + +.Delete a scoped function +==== +.Curl request +[source,sh] +---- +curl -XDELETE "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_function_zap_all/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_function_zap_all/http-request.adoc new file mode 100644 index 00000000..90adf782 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_function_zap_all/http-request.adoc @@ -0,0 +1,10 @@ += Example HTTP Request + +.Delete all functions +==== +.Curl request +[source,sh] +---- +curl -XDELETE "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_multiple_export/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_multiple_export/http-request.adoc new file mode 100644 index 00000000..1115682b --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_multiple_export/http-request.adoc @@ -0,0 +1,20 @@ += Example HTTP Requests + +.View all function definitions +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/export" +---- +==== + +.Save all function definitions to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/export" \ + -o array_of_functions.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_multiple_import/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_multiple_import/http-request.adoc new file mode 100644 index 00000000..f8c02946 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_multiple_import/http-request.adoc @@ -0,0 +1,11 @@ += Example HTTP Requests + +.Import multiple functions +==== +.Curl request +[source,sh] +---- +curl -XPOST -d @./array_of_functions.json \ + "http://$USER:$PASSWORD@$HOST:8096/api/v1/import" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_settings_get/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_settings_get/http-request.adoc new file mode 100644 index 00000000..c15b5b65 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_settings_get/http-request.adoc @@ -0,0 +1,39 @@ += Example HTTP Requests + +.View global function settings +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- +==== + +.View scoped function settings +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- +==== + +.Save global function settings to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" \ + -o my_function.json +---- +==== + +.Save scoped function settings to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" \ + -o my_function.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc new file mode 100644 index 00000000..72823de4 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc @@ -0,0 +1,159 @@ += Example HTTP Requests + +.Update global function settings +==== +This example updates the `worker_count` setting. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": false, + "processing_status": false, + "worker_count": 6 +}' "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- +==== + +.Update scoped function settings +==== +This example updates the `worker_count` setting. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": false, + "processing_status": false, + "worker_count": 6 +}' "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- +==== + +.Update undeployed global function settings +==== +This example updates the `app_log_max_files` and `app_log_max_size` settings. +The function is currently undeployed. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": false, + "processing_status": false, + "app_log_max_files": 5 + "app_log_max_size":10485760 +}' "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- +==== + +.Update undeployed scoped function settings +==== +This example updates the `app_log_max_files` and `app_log_max_size` settings. +The function is currently undeployed. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": false, + "processing_status": false, + "app_log_max_files": 5, + "app_log_max_size": 10485760 +}' "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- +==== + +.Update paused global function settings +==== +This example updates the `timer_context_size` setting. +The function is currently paused. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": false, + "timer_context_size": 2048 +}' "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- +==== + +.Update paused scoped function settings +==== +This example updates the `timer_context_size` setting. +The function is currently paused. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": false, + "timer_context_size": 2048 +}' "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- +==== + +.Update paused global function settings and resume +==== +This example updates the `worker_count` setting and resumes. +The function is currently paused. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": true, + "worker_count": 8 +}' "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- +==== + +.Update paused scoped function settings and resume +==== +This example updates the `worker_count` setting and resumes. +The function is currently paused. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": true, + "worker_count": 8 +}' "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- +==== + +.Deploy an undeployed global function -- deprecated +==== +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": true +}' "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- + +Deprecated. +See <> for the preferred invocation. +==== + +.Deploy an undeployed scoped function -- deprecated +==== +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": true +}' "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- + +Deprecated. +See <> for the preferred invocation. +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_structure_get/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_structure_get/http-request.adoc new file mode 100644 index 00000000..c906e7d9 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_structure_get/http-request.adoc @@ -0,0 +1,39 @@ += Example HTTP Requests + +.View global function config +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config" +---- +==== + +.View scoped function config +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config?bucket=bulk&scope=data" +---- +==== + +.Save global function config to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config" \ + -o my_function.json +---- +==== + +.Save scoped function config to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config?bucket=bulk&scope=data" \ + -o my_function.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_structure_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_structure_update/http-request.adoc new file mode 100644 index 00000000..d9efafca --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_structure_update/http-request.adoc @@ -0,0 +1,63 @@ += Example HTTP Requests + +.Update global function config +==== +This example alters the source and eventing storage keyspaces. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config" \ + -d '{ + "source_bucket": "bulk", + "source_scope": "orders", + "source_collection": "customer01", + "metadata_bucket": "rr100", + "metadata_scope": "eventing", + "metadata_collection": "metadata" +}' +---- +==== + +.Update scoped function config +==== +This example alters the source and eventing storage keyspaces. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config?bucket=bulk&scope=data"\ + -d '{ + "source_bucket": "bulk", + "source_scope": "orders", + "source_collection": "customer01", + "metadata_bucket": "rr100", + "metadata_scope": "eventing", + "metadata_collection": "metadata" +}' +---- +==== + +.Update global function config from file +==== +This example alters the source and eventing storage keyspaces from a file. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config" \ + -d @./my_function.json +---- +==== + +.Update scoped function config from file +==== +This example alters the source and eventing storage keyspaces from a file. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/config?bucket=bulk&scope=data" \ + -d @./my_function.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_text_get/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_text_get/http-request.adoc new file mode 100644 index 00000000..300dcdd2 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_text_get/http-request.adoc @@ -0,0 +1,39 @@ += Example HTTP Requests + +.View global function code +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/appcode" +---- +==== + +.View scoped function code +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/appcode?bucket=bulk&scope=data" +---- +==== + +.Save global function code to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/appcode" \ + -o my_function.json +---- +==== + +.Save scoped function code to file +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/appcode?bucket=bulk&scope=data" \ + -o my_function.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_text_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_text_update/http-request.adoc new file mode 100644 index 00000000..beee5e18 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/adv_text_update/http-request.adoc @@ -0,0 +1,71 @@ += Example HTTP Requests + +.Update global function code +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/appcode" \ + --data-binary 'function OnUpdate(doc, meta) { log("id",meta.id); }' +---- +==== + +.Update scoped function code +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/appcode?bucket=bulk&scope=data" \ + --data-binary 'function OnUpdate(doc, meta) { log("id",meta.id); }' +---- +==== + +.Update global function code from file +==== +This example uses the `--data-binary` option. +Do not use `-d`. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/import" \ + --data-binary @./my_function.json +---- +==== + +.Update scoped function code from file +==== +This example uses the `--data-binary` option. +Do not use `-d`. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/import?bucket=bulk&scope=data" \ + --data-binary @./my_function.json +---- +==== + +.Update global function code from file -- alternative +==== +This example uses the `--upload-file` option. + +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/import" \ + --upload-file ./my_function.json +---- +==== + +.Update scoped function code from file -- alternative +==== +This example uses the `--upload-file` option. + +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/import?bucket=bulk&scope=data" \ + --upload-file ./my_function.json +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/basic_deploy/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/basic_deploy/http-request.adoc new file mode 100644 index 00000000..a49aa113 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/basic_deploy/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Deploy a global function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/deploy" +---- +==== + +.Deploy a scoped function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/deploy?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/basic_pause/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/basic_pause/http-request.adoc new file mode 100644 index 00000000..2046bf1b --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/basic_pause/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Pause a global function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/pause" +---- +==== + +.Pause a scoped function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/pause?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/basic_resume/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/basic_resume/http-request.adoc new file mode 100644 index 00000000..0faebc43 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/basic_resume/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Resume a global function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/resume" +---- +==== + +.Resume a scoped function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/resume?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/basic_undeploy/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/basic_undeploy/http-request.adoc new file mode 100644 index 00000000..83cd66f1 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/basic_undeploy/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Undeploy a global function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/undeploy" +---- +==== + +.Undeploy a scoped function +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/undeploy?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc new file mode 100644 index 00000000..2fc22054 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc @@ -0,0 +1,10 @@ += Example HTTP Requests + +.View global configuration +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc new file mode 100644 index 00000000..9e5b603d --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc @@ -0,0 +1,45 @@ += Example HTTP Requests + +.Alter RAM quota +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" \ + -d '{"ram_quota": 512}' +---- +==== + +.Enable debugger +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" \ + -d '{"enable_debugger": true}' +---- +==== + +.Allow interbucket recursion +==== +This example disables the safety checks that prevent basic infinite recursive Eventing functions. + +.Curl request +[source,sh] +---- +curl -X POST -u $ADMIN:$PASSWORD "http://$HOST:8091/_p/event/api/v1/config" \ + -d '{"allow_interbucket_recursion": true}' +---- +==== + +.Disallow interbucket recursion +==== +This example restores the default setting, which applies some sanity checks to prevent basic infinite recursive Eventing functions. + +.Curl request +[source,sh] +---- +curl -X POST -u $ADMIN:$PASSWORD "http://$HOST:8091/_p/event/api/v1/config" + -d '{"allow_interbucket_recursion": false}' +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc b/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc new file mode 100644 index 00000000..caedb31e --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc @@ -0,0 +1,8 @@ +[NOTE] +.Interbucket Recursion +==== +If you need to turn off infinite recursion protection for Eventing functions, you can use an alternative REST API endpoint to enable interbucket recursion. +For details, see xref:eventing:troubleshooting-best-practices.adoc#cyclicredun[Troubleshooting and Best Practices]. + +Allowing interbucket recursion is highly discouraged unless you have an advanced use case and follow strict non-production coding and verification. +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/list_all/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/list_all/http-request.adoc new file mode 100644 index 00000000..ec867774 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/list_all/http-request.adoc @@ -0,0 +1,10 @@ += Example HTTP Requests + +.List all functions +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/list/functions" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/list_query/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/list_query/http-request.adoc new file mode 100644 index 00000000..ddde7608 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/list_query/http-request.adoc @@ -0,0 +1,30 @@ += Example HTTP Requests + +.List all deployed functions +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/list/functions/query?deployed=true" +---- + +If you had specified `deployed=false`, you would get all undeployed functions. +==== + +.List all functions with source keyspace in a specific bucket +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/list/functions/query?source_bucket=bulk" +---- +==== + +.List all functions that do not modify their source keyspace +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/list/functions/query?function_type=notsbm" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/log_view/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/log_view/http-request.adoc new file mode 100644 index 00000000..1449172d --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/log_view/http-request.adoc @@ -0,0 +1,59 @@ += Example HTTP Requests + +.View global function log from a single node +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/getAppLog?name=my_function" +---- +==== + +.View scoped function log from a single node +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/getAppLog?name=my_function&bucket=bulk&scope=data" +---- +==== + +.View global function log from all Eventing nodes +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/getAppLog?name=my_function&aggregate=true" +---- +==== + +.View scoped function log from all Eventing nodes +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/getAppLog?name=my_function&aggregate=true&bucket=bulk&scope=data" +---- +==== + +.View size-limited global function log +==== +This example fetches recent Application log info from all Eventing nodes, limited to 2048 bytes. + +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/getAppLog?name=my_function&aggregate=true&size=2048" +---- +==== + +.View size-limited scoped function log +==== +This example fetches recent Application log info from all Eventing nodes, limited to 2048 bytes. + +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/getAppLog?name=my_function&aggregate=true&size=2048&bucket=bulk&scope=data" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/stats_all/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/stats_all/http-request.adoc new file mode 100644 index 00000000..082da823 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/stats_all/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Get basic statistics +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/stats" +---- +==== + +.Get full statistics +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/stats?type=full" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/stats_execution/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/stats_execution/http-request.adoc new file mode 100644 index 00000000..5163df01 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/stats_execution/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.View execution statistics for global function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/getExecutionStats?name=my_function" +---- +==== + +.View execution statistics for scoped function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/getExecutionStats?name=my_function&bucket=bulk&scope=data" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/stats_failure/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/stats_failure/http-request.adoc new file mode 100644 index 00000000..ff9da0bf --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/stats_failure/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.View failure statistics for global function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/getFailureStats?name=my_function" +---- +==== + +.View failure statistics for scoped function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/getFailureStats?name=my_function&bucket=bulk&scope=data" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/stats_latency/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/stats_latency/http-request.adoc new file mode 100644 index 00000000..65fe5717 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/stats_latency/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.View latency statistics for global function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/getLatencyStats?name=my_function" +---- +==== + +.View latency statistics for scoped function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/getLatencyStats?name=my_function&bucket=bulk&scope=data" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/stats_reset/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/stats_reset/http-request.adoc new file mode 100644 index 00000000..8410846d --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/stats_reset/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.Reset statistics for global function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/resetStatsCounters?appName=my_function" +---- +==== + +.Reset statistics for scoped function +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/resetStatsCounters?appName=my_function&bucket=bulk&scope=data" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/status_all/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/status_all/http-request.adoc new file mode 100644 index 00000000..a755e5f5 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/status_all/http-request.adoc @@ -0,0 +1,10 @@ += Example HTTP Requests + +.View status of all functions +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/status" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/paths/status_function/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/status_function/http-request.adoc new file mode 100644 index 00000000..a5ade24e --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/paths/status_function/http-request.adoc @@ -0,0 +1,19 @@ += Example HTTP Requests + +.View global function status +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/status/my_function" +---- +==== + +.View scoped function status +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$USER:$PASSWORD@$HOST:8096/api/v1/status/my_function?bucket=bulk&scope=data" +---- +==== \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/security/document-begin.adoc b/docs/modules/eventing-rest-api/partials/security/document-begin.adoc new file mode 100644 index 00000000..52e27bc5 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Eventing REST APIs support HTTP basic authentication. +Credentials can be passed via HTTP headers. \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/security/document-end.adoc b/docs/modules/eventing-rest-api/partials/security/document-end.adoc new file mode 100644 index 00000000..bb718fc4 --- /dev/null +++ b/docs/modules/eventing-rest-api/partials/security/document-end.adoc @@ -0,0 +1 @@ +Refer to xref:eventing:eventing-rbac.adoc[] for more details. \ No newline at end of file diff --git a/docs/modules/index-rest-stats/pages/index.adoc b/docs/modules/index-rest-stats/pages/index.adoc index 44b88d0c..ce8688dc 100644 --- a/docs/modules/index-rest-stats/pages/index.adoc +++ b/docs/modules/index-rest-stats/pages/index.adoc @@ -58,7 +58,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -69,7 +69,7 @@ The host name or IP address of a node running the Index service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -80,7 +80,7 @@ The Index service REST port. Use `19102` for secure access. [%hardbreaks] *Values:* `9102`, `19102` -*Example:* `pass:c[9102]` +*Example:* `+++9102+++` // end |=== @@ -173,6 +173,12 @@ Returns statistics for an index. // markup not found, no include::{specDir}paths/get_index_stats/operation-description-end.adoc[opts=optional] + + +[#get_index_stats-produces] +.Produces +* application/json + :leveloffset: -1 @@ -195,13 +201,13 @@ Returns statistics for an index. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *keyspace* + +a¦ *keyspace* + _required_ -a| +a¦ [markdown] @@ -219,13 +225,13 @@ For example, `` `bucket.1`.scope.collection ``. [%hardbreaks] {blank} -a| String +a¦ String -a| *index* + +a¦ *index* + _required_ -a| +a¦ [markdown] @@ -236,7 +242,7 @@ The name of an index. [%hardbreaks] {blank} -a| String +a¦ String @@ -246,13 +252,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *pretty* + +a¦ *pretty* + _optional_ -a| +a¦ [markdown] @@ -264,13 +270,13 @@ Whether the output should be formatted with indentations and newlines. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *partition* + +a¦ *partition* + _optional_ -a| +a¦ [markdown] @@ -282,13 +288,13 @@ Whether statistics for index partitions should be included. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *redact* + +a¦ *redact* + _optional_ -a| +a¦ [markdown] @@ -301,13 +307,13 @@ Whether keyspace and index names should be redacted in the output. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *skipEmpty* + +a¦ *skipEmpty* + _optional_ -a| +a¦ [markdown] @@ -319,7 +325,7 @@ Whether empty, null, or zero statistics should be omitted from the output. *Default:* `false` {blank} -a| Boolean +a¦ Boolean @@ -339,12 +345,6 @@ include::{specDir}paths/get_index_stats/operation-parameters-end.adoc[opts=optio // markup not found, no include::{specDir}paths/get_index_stats/operation-parameters-after.adoc[opts=optional] -[#get_index_stats-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_index_stats/operation-responses-before.adoc[opts=optional] @@ -472,6 +472,12 @@ Returns statistics for all indexes within a bucket, scope, or collection. // markup not found, no include::{specDir}paths/get_keyspace_stats/operation-description-end.adoc[opts=optional] + + +[#get_keyspace_stats-produces] +.Produces +* application/json + :leveloffset: -1 @@ -494,13 +500,13 @@ Returns statistics for all indexes within a bucket, scope, or collection. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *keyspace* + +a¦ *keyspace* + _required_ -a| +a¦ [markdown] @@ -518,7 +524,7 @@ For example, `` `bucket.1`.scope.collection ``. [%hardbreaks] {blank} -a| String +a¦ String @@ -528,13 +534,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *pretty* + +a¦ *pretty* + _optional_ -a| +a¦ [markdown] @@ -546,13 +552,13 @@ Whether the output should be formatted with indentations and newlines. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *redact* + +a¦ *redact* + _optional_ -a| +a¦ [markdown] @@ -565,13 +571,13 @@ Whether keyspace and index names should be redacted in the output. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *skipEmpty* + +a¦ *skipEmpty* + _optional_ -a| +a¦ [markdown] @@ -583,7 +589,7 @@ Whether empty, null, or zero statistics should be omitted from the output. *Default:* `false` {blank} -a| Boolean +a¦ Boolean @@ -603,12 +609,6 @@ include::{specDir}paths/get_keyspace_stats/operation-parameters-end.adoc[opts=op // markup not found, no include::{specDir}paths/get_keyspace_stats/operation-parameters-after.adoc[opts=optional] -[#get_keyspace_stats-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_keyspace_stats/operation-responses-before.adoc[opts=optional] @@ -736,6 +736,12 @@ Returns statistics for an index node, and for all indexes on that node. // markup not found, no include::{specDir}paths/get_node_stats/operation-description-end.adoc[opts=optional] + + +[#get_node_stats-produces] +.Produces +* application/json + :leveloffset: -1 @@ -759,13 +765,13 @@ Returns statistics for an index node, and for all indexes on that node. .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *pretty* + +a¦ *pretty* + _optional_ -a| +a¦ [markdown] @@ -777,13 +783,13 @@ Whether the output should be formatted with indentations and newlines. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *redact* + +a¦ *redact* + _optional_ -a| +a¦ [markdown] @@ -796,13 +802,13 @@ Whether keyspace and index names should be redacted in the output. *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| *skipEmpty* + +a¦ *skipEmpty* + _optional_ -a| +a¦ [markdown] @@ -814,7 +820,7 @@ Whether empty, null, or zero statistics should be omitted from the output. *Default:* `false` {blank} -a| Boolean +a¦ Boolean @@ -834,12 +840,6 @@ a| Boolean // markup not found, no include::{specDir}paths/get_node_stats/operation-parameters-after.adoc[opts=optional] -[#get_node_stats-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_node_stats/operation-responses-before.adoc[opts=optional] @@ -1029,14 +1029,14 @@ endif::collapse-models[] //tag::NodeIdxNode[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *indexer* + _required_ -a| +a¦ [markdown] -- @@ -1045,7 +1045,7 @@ include::index.adoc[tag=desc-NodeIdxNodeIndexer, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -1090,14 +1090,14 @@ A nested object containing statistics for the current index node. //end::desc-NodeIdxNodeIndexer[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *indexer_state* + _optional_ -a| +a¦ [markdown] -- @@ -1106,15 +1106,15 @@ Current state of the Index service on this node. [%hardbreaks] *Values:* `"Active"`, `"Pause"`, `"Warmup"` -*Example:* `pass:c["Active"]` +*Example:* `+++"Active"+++` {blank} -a| String +a¦ String -a| +a¦ *memory_quota* + _optional_ -a| +a¦ [markdown] -- @@ -1126,13 +1126,13 @@ Memory quota assigned to the Index service on this node by user configuration (b *Maximum:* `1099511992567` *Example:* `536870912` {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *memory_total_storage* + _optional_ -a| +a¦ [markdown] -- @@ -1144,13 +1144,13 @@ This also accounts for memory fragmentation. [%hardbreaks] *Example:* `71794688` {blank} -a| Integer +a¦ Integer -a| +a¦ *memory_used* + _optional_ -a| +a¦ [markdown] -- @@ -1160,13 +1160,13 @@ Amount of memory used by the Index service on this node (bytes). [%hardbreaks] *Example:* `360192000` {blank} -a| Integer +a¦ Integer -a| +a¦ *total_indexer_gc_pause_ns* + _optional_ -a| +a¦ [markdown] -- @@ -1176,7 +1176,7 @@ The total time the indexer has spent in GC pause since last startup (ns). [%hardbreaks] *Example:* `309778455` {blank} -a| Integer +a¦ Integer |=== @@ -1253,14 +1253,14 @@ endif::collapse-models[] //tag::PartIdxIndexes[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -1269,7 +1269,7 @@ include::index.adoc[tag=desc-PartIdxPartitionsIndex, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -1309,14 +1309,14 @@ endif::collapse-models[] //tag::PartIdxPartitions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -1325,7 +1325,7 @@ include::index.adoc[tag=desc-PartIdxPartitionsIndex, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -1370,14 +1370,14 @@ A nested object containing statistics for an index or index partition. //end::desc-PartIdxPartitionsIndex[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *avg_array_length* + _optional_ -a| +a¦ [markdown] -- @@ -1388,13 +1388,13 @@ The average number of items indexed per document. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *avg_drain_rate* + _optional_ -a| +a¦ [markdown] -- @@ -1403,13 +1403,13 @@ Average number of items flushed from memory to disk storage per second. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *avg_item_size* + _optional_ -a| +a¦ [markdown] -- @@ -1418,13 +1418,13 @@ Average size of the keys. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *avg_scan_latency* + _optional_ -a| +a¦ [markdown] -- @@ -1433,13 +1433,13 @@ Average time to serve a scan request (nanoseconds). [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *cache_hit_percent* + _optional_ -a| +a¦ [markdown] -- @@ -1448,13 +1448,13 @@ Percentage of memory accesses that were served from the managed cache. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *cache_hits* + _optional_ -a| +a¦ [markdown] -- @@ -1463,13 +1463,13 @@ Accesses to this index data from RAM. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *cache_misses* + _optional_ -a| +a¦ [markdown] -- @@ -1478,13 +1478,13 @@ Accesses to this index data from disk. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *data_size* + _optional_ -a| +a¦ [markdown] -- @@ -1494,13 +1494,13 @@ The size of indexable data that is maintained for the index or partition (bytes) [%hardbreaks] *Example:* `95728` {blank} -a| Integer +a¦ Integer -a| +a¦ *disk_size* + _optional_ -a| +a¦ [markdown] -- @@ -1510,13 +1510,13 @@ Total disk file size consumed by the index or partition. [%hardbreaks] *Example:* `889054` {blank} -a| Integer +a¦ Integer -a| +a¦ *docid_count* + _optional_ -a| +a¦ [markdown] -- @@ -1527,13 +1527,13 @@ The number of documents currently indexed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *frag_percent* + _optional_ -a| +a¦ [markdown] -- @@ -1545,13 +1545,13 @@ TIP: At small index sizes of less than a hundred kB, the static overhead of the [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *initial_build_progress* + _optional_ -a| +a¦ [markdown] -- @@ -1565,13 +1565,13 @@ For an index partition, the value is listed as `0`. [%hardbreaks] *Example:* `100` {blank} -a| Integer +a¦ Integer -a| +a¦ *items_count* + _optional_ -a| +a¦ [markdown] -- @@ -1581,13 +1581,13 @@ The number of items currently indexed. [%hardbreaks] *Example:* `2155` {blank} -a| Integer +a¦ Integer -a| +a¦ *last_known_scan_time* + _optional_ -a| +a¦ [markdown] -- @@ -1600,13 +1600,13 @@ NOTE: This statistic is persisted to disk every 15 minutes, so it is preserved w [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *num_docs_indexed* + _optional_ -a| +a¦ [markdown] -- @@ -1615,13 +1615,13 @@ Number of documents indexed by the indexer since last startup. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_docs_pending* + _optional_ -a| +a¦ [markdown] -- @@ -1630,13 +1630,13 @@ Number of documents pending to be indexed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_docs_queued* + _optional_ -a| +a¦ [markdown] -- @@ -1645,13 +1645,13 @@ Number of documents queued to be indexed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_items_flushed* + _optional_ -a| +a¦ [markdown] -- @@ -1660,13 +1660,13 @@ Number of items flushed from memory to disk storage. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_pending_requests* + _optional_ -a| +a¦ [markdown] -- @@ -1675,13 +1675,13 @@ Number of requests received but not yet served by the indexer. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_requests* + _optional_ -a| +a¦ [markdown] -- @@ -1690,13 +1690,13 @@ Number of requests served by the indexer since last startup. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_rows_returned* + _optional_ -a| +a¦ [markdown] -- @@ -1705,13 +1705,13 @@ Total number of rows returned so far by the indexer. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_scan_errors* + _optional_ -a| +a¦ [markdown] -- @@ -1720,13 +1720,13 @@ Number of requests that failed due to errors other than timeout. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *num_scan_timeouts* + _optional_ -a| +a¦ [markdown] -- @@ -1735,13 +1735,13 @@ Number of requests that timed out, either waiting for snapshots or during scan i [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *recs_in_mem* + _optional_ -a| +a¦ [markdown] -- @@ -1754,13 +1754,13 @@ For memory-optimized index storage, this is the same as `items_count`. [%hardbreaks] *Example:* `2155` {blank} -a| Integer +a¦ Integer -a| +a¦ *recs_on_disk* + _optional_ -a| +a¦ [markdown] -- @@ -1770,13 +1770,13 @@ For memory-optimized index storage, this is `0`. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *resident_percent* + _optional_ -a| +a¦ [markdown] -- @@ -1786,13 +1786,13 @@ Percentage of the data held in memory. [%hardbreaks] *Example:* `100` {blank} -a| Integer +a¦ Integer -a| +a¦ *scan_bytes_read* + _optional_ -a| +a¦ [markdown] -- @@ -1801,13 +1801,13 @@ Number of bytes read by a scan since last startup. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *total_scan_duration* + _optional_ -a| +a¦ [markdown] -- @@ -1816,7 +1816,7 @@ Total time spent by the indexer in scanning rows since last startup (nanoseconds [%hardbreaks] {blank} -a| Integer +a¦ Integer |=== @@ -1930,3 +1930,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 274e763f..fc89904f 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Query service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Query service REST port. Use `18093` for secure access. [%hardbreaks] *Values:* `8093`, `18093` -*Example:* `pass:c[8093]` +*Example:* `+++8093+++` // end |=== @@ -182,6 +182,12 @@ Terminates the specified active query request. // markup not found, no include::{specDir}paths/delete_active_request/operation-description-end.adoc[opts=optional] + + +[#delete_active_request-produces] +.Produces +* application/json + :leveloffset: -1 @@ -204,13 +210,13 @@ Terminates the specified active query request. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *request* + +a¦ *request* + _required_ -a| +a¦ [markdown] @@ -223,7 +229,7 @@ This is the `requestID` that was assigned automatically when the statement was c [%hardbreaks] {blank} -a| String +a¦ String @@ -244,12 +250,6 @@ a| String // markup not found, no include::{specDir}paths/delete_active_request/operation-parameters-after.adoc[opts=optional] -[#delete_active_request-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/delete_active_request/operation-responses-before.adoc[opts=optional] @@ -381,6 +381,12 @@ Returns all active index requests. // markup not found, no include::{specDir}paths/get_active_indexes/operation-description-end.adoc[opts=optional] + + +[#get_active_indexes-produces] +.Produces +* application/json + :leveloffset: -1 @@ -398,12 +404,6 @@ Returns all active index requests. // markup not found, no include::{specDir}paths/get_active_indexes/operation-parameters-after.adoc[opts=optional] -[#get_active_indexes-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_active_indexes/operation-responses-before.adoc[opts=optional] @@ -526,6 +526,12 @@ Returns the specified active query request. // markup not found, no include::{specDir}paths/get_active_request/operation-description-end.adoc[opts=optional] + + +[#get_active_request-produces] +.Produces +* application/json + :leveloffset: -1 @@ -548,13 +554,13 @@ Returns the specified active query request. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *request* + +a¦ *request* + _required_ -a| +a¦ [markdown] @@ -567,7 +573,7 @@ This is the `requestID` that was assigned automatically when the statement was c [%hardbreaks] {blank} -a| String +a¦ String @@ -588,12 +594,6 @@ a| String // markup not found, no include::{specDir}paths/get_active_request/operation-parameters-after.adoc[opts=optional] -[#get_active_request-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_active_request/operation-responses-before.adoc[opts=optional] @@ -716,6 +716,12 @@ Returns all active query requests. // markup not found, no include::{specDir}paths/get_active_requests/operation-description-end.adoc[opts=optional] + + +[#get_active_requests-produces] +.Produces +* application/json + :leveloffset: -1 @@ -733,12 +739,6 @@ Returns all active query requests. // markup not found, no include::{specDir}paths/get_active_requests/operation-parameters-after.adoc[opts=optional] -[#get_active_requests-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_active_requests/operation-responses-before.adoc[opts=optional] @@ -886,6 +886,12 @@ Purges the specified completed request. // markup not found, no include::{specDir}paths/delete_completed_request/operation-description-end.adoc[opts=optional] + + +[#delete_completed_request-produces] +.Produces +* application/json + :leveloffset: -1 @@ -908,13 +914,13 @@ Purges the specified completed request. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *request* + +a¦ *request* + _required_ -a| +a¦ [markdown] @@ -927,7 +933,7 @@ This is the `requestID` that was assigned automatically when the statement was c [%hardbreaks] {blank} -a| String +a¦ String @@ -948,12 +954,6 @@ a| String // markup not found, no include::{specDir}paths/delete_completed_request/operation-parameters-after.adoc[opts=optional] -[#delete_completed_request-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/delete_completed_request/operation-responses-before.adoc[opts=optional] @@ -1085,6 +1085,12 @@ Returns all completed index requests. // markup not found, no include::{specDir}paths/get_completed_indexes/operation-description-end.adoc[opts=optional] + + +[#get_completed_indexes-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1102,12 +1108,6 @@ Returns all completed index requests. // markup not found, no include::{specDir}paths/get_completed_indexes/operation-parameters-after.adoc[opts=optional] -[#get_completed_indexes-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_completed_indexes/operation-responses-before.adoc[opts=optional] @@ -1230,6 +1230,12 @@ Returns the specified completed request. // markup not found, no include::{specDir}paths/get_completed_request/operation-description-end.adoc[opts=optional] + + +[#get_completed_request-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1252,13 +1258,13 @@ Returns the specified completed request. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *request* + +a¦ *request* + _required_ -a| +a¦ [markdown] @@ -1271,7 +1277,7 @@ This is the `requestID` that was assigned automatically when the statement was c [%hardbreaks] {blank} -a| String +a¦ String @@ -1292,12 +1298,6 @@ a| String // markup not found, no include::{specDir}paths/get_completed_request/operation-parameters-after.adoc[opts=optional] -[#get_completed_request-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_completed_request/operation-responses-before.adoc[opts=optional] @@ -1420,6 +1420,12 @@ Returns all completed requests. // markup not found, no include::{specDir}paths/get_completed_requests/operation-description-end.adoc[opts=optional] + + +[#get_completed_requests-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1437,12 +1443,6 @@ Returns all completed requests. // markup not found, no include::{specDir}paths/get_completed_requests/operation-parameters-after.adoc[opts=optional] -[#get_completed_requests-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_completed_requests/operation-responses-before.adoc[opts=optional] @@ -1590,6 +1590,12 @@ Returns information about the specified cluster. // markup not found, no include::{specDir}paths/get_cluster/operation-description-end.adoc[opts=optional] + + +[#get_cluster-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1612,13 +1618,13 @@ Returns information about the specified cluster. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *cluster* + +a¦ *cluster* + _required_ -a| +a¦ [markdown] @@ -1629,7 +1635,7 @@ The name of a cluster. [%hardbreaks] {blank} -a| String +a¦ String @@ -1650,12 +1656,6 @@ a| String // markup not found, no include::{specDir}paths/get_cluster/operation-parameters-after.adoc[opts=optional] -[#get_cluster-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_cluster/operation-responses-before.adoc[opts=optional] @@ -1777,6 +1777,12 @@ Returns information about all clusters. // markup not found, no include::{specDir}paths/get_clusters/operation-description-end.adoc[opts=optional] + + +[#get_clusters-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1794,12 +1800,6 @@ Returns information about all clusters. // markup not found, no include::{specDir}paths/get_clusters/operation-parameters-after.adoc[opts=optional] -[#get_clusters-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_clusters/operation-responses-before.adoc[opts=optional] @@ -1921,6 +1921,12 @@ Returns the configuration of the query service on the cluster. // markup not found, no include::{specDir}paths/get_config/operation-description-end.adoc[opts=optional] + + +[#get_config-produces] +.Produces +* application/json + :leveloffset: -1 @@ -1938,12 +1944,6 @@ Returns the configuration of the query service on the cluster. // markup not found, no include::{specDir}paths/get_config/operation-parameters-after.adoc[opts=optional] -[#get_config-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_config/operation-responses-before.adoc[opts=optional] @@ -2065,6 +2065,12 @@ Returns information about the specified node in the specified cluster. // markup not found, no include::{specDir}paths/get_node/operation-description-end.adoc[opts=optional] + + +[#get_node-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2087,13 +2093,13 @@ Returns information about the specified node in the specified cluster. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *cluster* + +a¦ *cluster* + _required_ -a| +a¦ [markdown] @@ -2104,13 +2110,13 @@ The name of a cluster. [%hardbreaks] {blank} -a| String +a¦ String -a| *node* + +a¦ *node* + _required_ -a| +a¦ [markdown] @@ -2121,7 +2127,7 @@ The name of a node. [%hardbreaks] {blank} -a| String +a¦ String @@ -2142,12 +2148,6 @@ a| String // markup not found, no include::{specDir}paths/get_node/operation-parameters-after.adoc[opts=optional] -[#get_node-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_node/operation-responses-before.adoc[opts=optional] @@ -2269,6 +2269,12 @@ Returns information about all nodes in the specified cluster. // markup not found, no include::{specDir}paths/get_nodes/operation-description-end.adoc[opts=optional] + + +[#get_nodes-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2291,13 +2297,13 @@ Returns information about all nodes in the specified cluster. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *cluster* + +a¦ *cluster* + _required_ -a| +a¦ [markdown] @@ -2308,7 +2314,7 @@ The name of a cluster. [%hardbreaks] {blank} -a| String +a¦ String @@ -2329,12 +2335,6 @@ a| String // markup not found, no include::{specDir}paths/get_nodes/operation-parameters-after.adoc[opts=optional] -[#get_nodes-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_nodes/operation-responses-before.adoc[opts=optional] @@ -2485,6 +2485,12 @@ A message is written to `query.log` whenever the garbage collector endpoint is i // markup not found, no include::{specDir}paths/get_gc/operation-description-end.adoc[opts=optional] + + +[#get_gc-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2502,12 +2508,6 @@ A message is written to `query.log` whenever the garbage collector endpoint is i // markup not found, no include::{specDir}paths/get_gc/operation-parameters-after.adoc[opts=optional] -[#get_gc-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_gc/operation-responses-before.adoc[opts=optional] @@ -2637,6 +2637,12 @@ Returns a minimal response, indicating that the service is running and reachable // markup not found, no include::{specDir}paths/get_ping/operation-description-end.adoc[opts=optional] + + +[#get_ping-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2654,12 +2660,6 @@ Returns a minimal response, indicating that the service is running and reachable // markup not found, no include::{specDir}paths/get_ping/operation-parameters-after.adoc[opts=optional] -[#get_ping-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_ping/operation-responses-before.adoc[opts=optional] @@ -2767,6 +2767,12 @@ A message is written to `query.log` whenever the garbage collector endpoint is i // markup not found, no include::{specDir}paths/post_gc/operation-description-end.adoc[opts=optional] + + +[#post_gc-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2784,12 +2790,6 @@ A message is written to `query.log` whenever the garbage collector endpoint is i // markup not found, no include::{specDir}paths/post_gc/operation-parameters-after.adoc[opts=optional] -[#post_gc-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/post_gc/operation-responses-before.adoc[opts=optional] @@ -2945,6 +2945,12 @@ Deletes the specified prepared statement. // markup not found, no include::{specDir}paths/delete_prepared/operation-description-end.adoc[opts=optional] + + +[#delete_prepared-produces] +.Produces +* application/json + :leveloffset: -1 @@ -2967,13 +2973,13 @@ Deletes the specified prepared statement. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -2986,7 +2992,7 @@ This may be a UUID that was assigned automatically, or a name that was user-spec [%hardbreaks] {blank} -a| String +a¦ String @@ -3007,12 +3013,6 @@ a| String // markup not found, no include::{specDir}paths/delete_prepared/operation-parameters-after.adoc[opts=optional] -[#delete_prepared-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/delete_prepared/operation-responses-before.adoc[opts=optional] @@ -3141,6 +3141,12 @@ Returns the specified prepared statement. // markup not found, no include::{specDir}paths/get_prepared/operation-description-end.adoc[opts=optional] + + +[#get_prepared-produces] +.Produces +* application/json + :leveloffset: -1 @@ -3163,13 +3169,13 @@ Returns the specified prepared statement. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *name* + +a¦ *name* + _required_ -a| +a¦ [markdown] @@ -3182,7 +3188,7 @@ This may be a UUID that was assigned automatically, or a name that was user-spec [%hardbreaks] {blank} -a| String +a¦ String @@ -3203,12 +3209,6 @@ a| String // markup not found, no include::{specDir}paths/get_prepared/operation-parameters-after.adoc[opts=optional] -[#get_prepared-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_prepared/operation-responses-before.adoc[opts=optional] @@ -3334,6 +3334,12 @@ Returns all prepared index statements. // markup not found, no include::{specDir}paths/get_prepared_indexes/operation-description-end.adoc[opts=optional] + + +[#get_prepared_indexes-produces] +.Produces +* application/json + :leveloffset: -1 @@ -3351,12 +3357,6 @@ Returns all prepared index statements. // markup not found, no include::{specDir}paths/get_prepared_indexes/operation-parameters-after.adoc[opts=optional] -[#get_prepared_indexes-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_prepared_indexes/operation-responses-before.adoc[opts=optional] @@ -3479,6 +3479,12 @@ Returns all prepared statements. // markup not found, no include::{specDir}paths/get_prepareds/operation-description-end.adoc[opts=optional] + + +[#get_prepareds-produces] +.Produces +* application/json + :leveloffset: -1 @@ -3496,12 +3502,6 @@ Returns all prepared statements. // markup not found, no include::{specDir}paths/get_prepareds/operation-parameters-after.adoc[opts=optional] -[#get_prepareds-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_prepareds/operation-responses-before.adoc[opts=optional] @@ -3647,6 +3647,12 @@ Returns node-level query settings. // markup not found, no include::{specDir}paths/get_settings/operation-description-end.adoc[opts=optional] + + +[#get_settings-produces] +.Produces +* application/json + :leveloffset: -1 @@ -3664,12 +3670,6 @@ include::{specDir}paths/get_settings/operation-description-after.adoc[opts=optio // markup not found, no include::{specDir}paths/get_settings/operation-parameters-after.adoc[opts=optional] -[#get_settings-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_settings/operation-responses-before.adoc[opts=optional] @@ -3792,6 +3792,16 @@ Updates node-level query settings. // markup not found, no include::{specDir}paths/post_settings/operation-description-end.adoc[opts=optional] + +[#post_settings-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#post_settings-produces] +.Produces +* application/json + :leveloffset: -1 @@ -3818,13 +3828,13 @@ include::{specDir}paths/post_settings/operation-description-after.adoc[opts=opti .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _optional_ -a| +a¦ [markdown] @@ -3835,7 +3845,7 @@ An object specifying node-level query settings. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -3852,19 +3862,8 @@ a| <> // markup not found, no include::{specDir}paths/post_settings/operation-parameters-after.adoc[opts=optional] -[#post_settings-produces] -= Produces -* application/json - -[#post_settings-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - - -// markup not found, no include::{specDir}paths/post_settings/operation-responses-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/post_settings/operation-responses-before.adoc[opts=optional] [#post_settings-responses] @@ -4009,6 +4008,12 @@ Currently unused. // markup not found, no include::{specDir}paths/get_debug_vars/operation-description-end.adoc[opts=optional] + + +[#get_debug_vars-produces] +.Produces +* text/html + :leveloffset: -1 @@ -4026,12 +4031,6 @@ Currently unused. // markup not found, no include::{specDir}paths/get_debug_vars/operation-parameters-after.adoc[opts=optional] -[#get_debug_vars-produces] -= Produces - -* text/html - - // markup not found, no include::{specDir}paths/get_debug_vars/operation-responses-before.adoc[opts=optional] @@ -4134,6 +4133,12 @@ Returns the specified statistic. // markup not found, no include::{specDir}paths/get_stat/operation-description-end.adoc[opts=optional] + + +[#get_stat-produces] +.Produces +* application/json + :leveloffset: -1 @@ -4156,13 +4161,13 @@ Returns the specified statistic. .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *stat* + +a¦ *stat* + _required_ -a| +a¦ [markdown] @@ -4177,7 +4182,7 @@ You cannot specify a metric. *Values:* `"active_requests"`, `"at_plus"`, `"audit_actions"`, `"audit_actions_failed"`, `"audit_requests_filtered"`, `"audit_requests_total"`, `"cancelled"`, `"deletes"`, `"errors"`, `"index_scans"`, `"inserts"`, `"invalid_requests"`, `"mutations"`, `"prepared"`, `"primary_scans"`, `"queued_requests"`, `"request_time"`, `"request_timer"`, `"requests"`, `"requests_1000ms"`, `"requests_250ms"`, `"requests_5000ms"`, `"requests_500ms"`, `"result_count"`, `"result_size"`, `"scan_plus"`, `"selects"`, `"service_time"`, `"unbounded"`, `"updates"`, `"warnings"` {blank} -a| String +a¦ String @@ -4198,12 +4203,6 @@ a| String // markup not found, no include::{specDir}paths/get_stat/operation-parameters-after.adoc[opts=optional] -[#get_stat-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_stat/operation-responses-before.adoc[opts=optional] @@ -4325,6 +4324,12 @@ Returns all statistics. // markup not found, no include::{specDir}paths/get_stats/operation-description-end.adoc[opts=optional] + + +[#get_stats-produces] +.Produces +* application/json + :leveloffset: -1 @@ -4342,12 +4347,6 @@ Returns all statistics. // markup not found, no include::{specDir}paths/get_stats/operation-parameters-after.adoc[opts=optional] -[#get_stats-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_stats/operation-responses-before.adoc[opts=optional] @@ -4471,6 +4470,12 @@ This information can be very useful to assess the current workload and performan // markup not found, no include::{specDir}paths/get_vitals/operation-description-end.adoc[opts=optional] + + +[#get_vitals-produces] +.Produces +* application/json + :leveloffset: -1 @@ -4488,12 +4493,6 @@ This information can be very useful to assess the current workload and performan // markup not found, no include::{specDir}paths/get_vitals/operation-parameters-after.adoc[opts=optional] -[#get_vitals-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_vitals/operation-responses-before.adoc[opts=optional] @@ -4649,14 +4648,14 @@ endif::collapse-models[] //tag::Clusters[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *name* + _optional_ -a| +a¦ [markdown] -- @@ -4665,13 +4664,13 @@ The name of the cluster. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *datastore* + _optional_ -a| +a¦ [markdown] -- @@ -4680,13 +4679,13 @@ The URL of the datastore. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *configstore* + _optional_ -a| +a¦ [markdown] -- @@ -4695,13 +4694,13 @@ The URL of the configstore. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *accountstore* + _optional_ -a| +a¦ [markdown] -- @@ -4710,13 +4709,13 @@ The URL of the accountstore. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *version* + _optional_ -a| +a¦ [markdown] -- @@ -4724,7 +4723,7 @@ a| [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -4764,14 +4763,14 @@ endif::collapse-models[] //tag::Garbage[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *freed* + _required_ -a| +a¦ [markdown] -- @@ -4780,13 +4779,13 @@ The amount of memory freed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *released* + _optional_ -a| +a¦ [markdown] -- @@ -4797,13 +4796,13 @@ The amount of memory released to the OS. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *status* + _required_ -a| +a¦ [markdown] -- @@ -4812,7 +4811,7 @@ The status of the garbage collector. [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -4856,21 +4855,21 @@ ifdef::model-descriptions[] A nested object that sets the parameters for the completed requests catalog. All completed requests that match these parameters are tracked in the completed requests catalog. -Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. +Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config //end::desc-Logging_Parameters[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *aborted* + _optional_ -a| +a¦ [markdown] -- @@ -4881,13 +4880,13 @@ If true, all requests that generate a panic are logged. *Default:* `null` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| +a¦ *client* + _optional_ -a| +a¦ [markdown] -- @@ -4897,16 +4896,16 @@ If specified, all completed requests from this IP address are logged. -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["172.1.2.3"]` +*Default:* `+++""+++` +*Example:* `+++"172.1.2.3"+++` {blank} -a| String +a¦ String -a| +a¦ *context* + _optional_ -a| +a¦ [markdown] -- @@ -4926,13 +4925,13 @@ Refer to the [request-level][client_context_id] `client_context_id` parameter fo [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *error* + _optional_ -a| +a¦ [markdown] -- @@ -4945,35 +4944,35 @@ If specified, all completed queries returning this error number are logged. *Default:* `null` *Example:* `12003` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *tag* + _optional_ -a| +a¦ [markdown] -- A unique string which tags a set of qualifiers. -Refer to [Configure the Completed Requests][sys-completed-config] for more information. +Refer to [Configure Completed Requests][sys-completed-config] for more information. [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["both_user_and_error"]` +*Default:* `+++""+++` +*Example:* `+++"both_user_and_error"+++` {blank} -a| String +a¦ String -a| +a¦ *threshold* + _optional_ -a| +a¦ [markdown] -- @@ -4988,13 +4987,13 @@ This is another way of specifying the [node-level](#completed-threshold) `comple *Default:* `1000` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *user* + _optional_ -a| +a¦ [markdown] -- @@ -5004,16 +5003,16 @@ If specified, all completed queries with this user name are logged. -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["marco"]` +*Default:* `+++""+++` +*Example:* `+++"marco"+++` {blank} -a| String +a¦ String -a| +a¦ *statement* + _optional_ -a| +a¦ [markdown] -- @@ -5023,16 +5022,16 @@ If specified, all completed queries where the pattern is found are logged. -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["%FIND USER%"]` +*Default:* `+++""+++` +*Example:* `+++"%FIND USER%"+++` {blank} -a| String +a¦ String -a| +a¦ *plan* + _optional_ -a| +a¦ [markdown] -- @@ -5041,7 +5040,7 @@ include::index.adoc[tag=desc-Logging_Parameters_Plan, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -5118,14 +5117,14 @@ endif::collapse-models[] //tag::Logging_Parameters_Plan_Pairs[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -5142,7 +5141,7 @@ For example, `[{"index": "ix1"}, {"index": "ix2"}]` specifies that if the query [%hardbreaks] {blank} -a| Any Type +a¦ Any Type |=== @@ -5182,14 +5181,14 @@ endif::collapse-models[] //tag::Metrics[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *count* + _optional_ -a| +a¦ [markdown] -- @@ -5198,13 +5197,13 @@ A single value that represents the current state. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *15m.rate* + _optional_ -a| +a¦ [markdown] -- @@ -5213,13 +5212,13 @@ a| [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *1m.rate* + _optional_ -a| +a¦ [markdown] -- @@ -5228,13 +5227,13 @@ a| [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *5m.rate* + _optional_ -a| +a¦ [markdown] -- @@ -5243,13 +5242,13 @@ a| [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *mean.rate* + _optional_ -a| +a¦ [markdown] -- @@ -5258,13 +5257,13 @@ Mean rate since the query service started. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *max* + _optional_ -a| +a¦ [markdown] -- @@ -5273,13 +5272,13 @@ The maximum value. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *mean* + _optional_ -a| +a¦ [markdown] -- @@ -5288,13 +5287,13 @@ The mean value. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *median* + _optional_ -a| +a¦ [markdown] -- @@ -5303,13 +5302,13 @@ The median value. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *min* + _optional_ -a| +a¦ [markdown] -- @@ -5318,13 +5317,13 @@ The minimum value. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *stddev* + _optional_ -a| +a¦ [markdown] -- @@ -5333,13 +5332,13 @@ The standard deviation. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *75%* + _optional_ -a| +a¦ [markdown] -- @@ -5348,13 +5347,13 @@ The 75th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *95%* + _optional_ -a| +a¦ [markdown] -- @@ -5363,13 +5362,13 @@ The 95th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *99%* + _optional_ -a| +a¦ [markdown] -- @@ -5378,13 +5377,13 @@ The 99th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *99.9%* + _optional_ -a| +a¦ [markdown] -- @@ -5393,7 +5392,7 @@ The 99.9th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal |=== @@ -5433,14 +5432,14 @@ endif::collapse-models[] //tag::Nodes[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *cluster* + _optional_ -a| +a¦ [markdown] -- @@ -5449,13 +5448,13 @@ The name of the cluster. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *name* + _optional_ -a| +a¦ [markdown] -- @@ -5464,13 +5463,13 @@ The URL of the node, including port number. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *queryEndpoint* + _optional_ -a| +a¦ [markdown] -- @@ -5479,13 +5478,13 @@ The HTTP URL of the query endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *adminEndpoint* + _optional_ -a| +a¦ [markdown] -- @@ -5494,13 +5493,13 @@ The HTTP URL of the admin endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *querySecure* + _optional_ -a| +a¦ [markdown] -- @@ -5509,13 +5508,13 @@ The HTTPS URL of the query endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *adminSecure* + _optional_ -a| +a¦ [markdown] -- @@ -5524,13 +5523,13 @@ The HTTPS URL of the admin endpoint. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *options* + _optional_ -a| +a¦ [markdown] -- @@ -5538,7 +5537,7 @@ a| [%hardbreaks] {blank} -a| String +a¦ String |=== @@ -5578,14 +5577,14 @@ endif::collapse-models[] //tag::Requests[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *clientContextID* + _optional_ -a| +a¦ [markdown] -- @@ -5603,13 +5602,13 @@ Refer to the [request-level][client_context_id] `client_context_id` parameter fo [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *cpuTime* + _optional_ -a| +a¦ [markdown] -- @@ -5620,15 +5619,15 @@ The total sum of [execTime][exec_time] across all operators. -- [%hardbreaks] -*Example:* `pass:c["90.734075ms"]` +*Example:* `+++"90.734075ms"+++` {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *elapsedTime* + _optional_ -a| +a¦ [markdown] -- @@ -5639,13 +5638,13 @@ It includes the time taken by the service to schedule the request. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *errorCount* + _optional_ -a| +a¦ [markdown] -- @@ -5654,13 +5653,13 @@ Total number of errors encountered while executing the query. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *ioTime* + _optional_ -a| +a¦ [markdown] -- @@ -5671,15 +5670,15 @@ The total sum of [servTime][serv_time] across all operators. -- [%hardbreaks] -*Example:* `pass:c["752.858519ms"]` +*Example:* `+++"752.858519ms"+++` {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *memoryQuota* + _optional_ -a| +a¦ [markdown] -- @@ -5690,13 +5689,13 @@ This property is only returned if a memory quota is set for the query. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *node* + _optional_ -a| +a¦ [markdown] -- @@ -5705,13 +5704,13 @@ IP address and port number of the node where the query is executed. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *phaseCounts* + _optional_ -a| +a¦ [markdown] -- @@ -5725,13 +5724,13 @@ Polling the active requests again may return different values. [%hardbreaks] *Example:* `{"fetch":16,"indexScan":187}` {blank} -a| Object +a¦ Object -a| +a¦ *phaseOperators* + _optional_ -a| +a¦ [markdown] -- @@ -5746,13 +5745,13 @@ A union select would have twice as many operator counts, one per each branch of [%hardbreaks] *Example:* `{"authorize":1,"fetch":1,"indexScan":2}` {blank} -a| Object +a¦ Object -a| +a¦ *phaseTimes* + _optional_ -a| +a¦ [markdown] -- @@ -5766,13 +5765,13 @@ Polling the active requests again may return different values. [%hardbreaks] *Example:* `{"authorize":"823.631µs","fetch":"656.873µs","indexScan":"29.146543ms","instantiate":"236.221µs","parse":"826.382µs","plan":"11.831101ms","run":"16.892181ms"}` {blank} -a| Object +a¦ Object -a| +a¦ *remoteAddr* + _optional_ -a| +a¦ [markdown] -- @@ -5781,13 +5780,13 @@ IP address and port number of the client application, from where the query is re [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *requestId* + _optional_ -a| +a¦ [markdown] -- @@ -5796,13 +5795,13 @@ Unique request ID internally generated for the query. [%hardbreaks] {blank} -a| UUID (uuid) +a¦ UUID (uuid) -a| +a¦ *requestTime* + _optional_ -a| +a¦ [markdown] -- @@ -5811,13 +5810,13 @@ Timestamp when the query is received. [%hardbreaks] {blank} -a| Date (date-time) +a¦ Date (date-time) -a| +a¦ *resultCount* + _optional_ -a| +a¦ [markdown] -- @@ -5826,13 +5825,13 @@ Total number of documents returned in the query result. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *resultSize* + _optional_ -a| +a¦ [markdown] -- @@ -5841,13 +5840,13 @@ Total number of bytes returned in the query result. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *scanConsistency* + _optional_ -a| +a¦ [markdown] -- @@ -5856,13 +5855,13 @@ The value of the query setting Scan Consistency used for the query. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *serviceTime* + _optional_ -a| +a¦ [markdown] -- @@ -5871,13 +5870,13 @@ Total amount of calendar time taken to complete the query. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *sessionMemory* + _optional_ -a| +a¦ [markdown] -- @@ -5893,13 +5892,13 @@ This metric is available only when `node-quota` and `node-quota-val-percent` are [%hardbreaks] {blank} -a| Integer (bytes) +a¦ Integer (bytes) -a| +a¦ *state* + _optional_ -a| +a¦ [markdown] -- @@ -5914,13 +5913,13 @@ To find requests that were successful, use this field in conjunction with the `e [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *statement* + _optional_ -a| +a¦ [markdown] -- @@ -5929,13 +5928,13 @@ The query statement being executed. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *useCBO* + _optional_ -a| +a¦ [markdown] -- @@ -5944,13 +5943,13 @@ Whether the cost-based optimizer is enabled for the query. [%hardbreaks] {blank} -a| Boolean +a¦ Boolean -a| +a¦ *usedMemory* + _optional_ -a| +a¦ [markdown] -- @@ -5961,13 +5960,13 @@ This property is only returned if a memory quota is set for the query. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *userAgent* + _optional_ -a| +a¦ [markdown] -- @@ -5976,13 +5975,13 @@ Name of the client application or program that issued the query. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *users* + _optional_ -a| +a¦ [markdown] -- @@ -5991,13 +5990,13 @@ Username with whose privileges the query is run. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *waitTime* + _optional_ -a| +a¦ [markdown] -- @@ -6008,15 +6007,15 @@ The total sum of [kernTime][kern_time] across all operators. -- [%hardbreaks] -*Example:* `pass:c["1.201307s"]` +*Example:* `+++"1.201307s"+++` {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *~analysis* + _optional_ -a| +a¦ [markdown] -- @@ -6028,7 +6027,7 @@ These phrases highlight notable aspects of the execution, such as high document [%hardbreaks] *Example:* `["High IO time","High primary scan document count"]` {blank} -a| String +a¦ String array |=== @@ -6068,14 +6067,14 @@ endif::collapse-models[] //tag::Settings[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| [#atrcollection-srv] +a¦ [#atrcollection-srv] *atrcollection* + _optional_ -a| +a¦ [markdown] -- @@ -6100,16 +6099,16 @@ If a request does not include this parameter, the node-level `atrcollection` set -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["default:`travel-sample`.transaction.test"]` +*Default:* `+++""+++` +*Example:* `+++"default:`travel-sample`.transaction.test"+++` {blank} -a| String +a¦ String -a| [#auto-prepare] +a¦ [#auto-prepare] *auto-prepare* + _optional_ -a| +a¦ [markdown] -- @@ -6125,13 +6124,13 @@ Refer to [Auto-Prepare][auto-prepare] for more information. *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#cleanupclientattempts] +a¦ [#cleanupclientattempts] *cleanupclientattempts* + _optional_ -a| +a¦ [markdown] -- @@ -6153,13 +6152,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#cleanuplostattempts] +a¦ [#cleanuplostattempts] *cleanuplostattempts* + _optional_ -a| +a¦ [markdown] -- @@ -6181,13 +6180,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#cleanupwindow] +a¦ [#cleanupwindow] *cleanupwindow* + _optional_ -a| +a¦ [markdown] -- @@ -6219,16 +6218,16 @@ When you change the cluster-level setting, the node-level setting is over-writte -- [%hardbreaks] -*Default:* `pass:c["60s"]` -*Example:* `pass:c["30s"]` +*Default:* `+++"60s"+++` +*Example:* `+++"30s"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#completed] +a¦ [#completed] *completed* + _optional_ -a| +a¦ [markdown] -- @@ -6237,13 +6236,13 @@ include::index.adoc[tag=desc-Logging_Parameters, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> -a| [#completed-limit] +a¦ [#completed-limit] *completed-limit* + _optional_ -a| +a¦ [markdown] -- @@ -6257,7 +6256,7 @@ As new completed requests are added, old ones are removed. Increase this when the completed request keyspace is not big enough to track the slow requests, such as when you want a larger sample of slow requests. -Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. +Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6271,13 +6270,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `4000` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#completed-max-plan-size] +a¦ [#completed-max-plan-size] *completed-max-plan-size* + _optional_ -a| [.status]##Couchbase Server 7.6## +a¦ [.status]##Couchbase Server 7.6## [markdown] -- @@ -6294,7 +6293,7 @@ Values larger than the maximum limit are silently treated as the maximum limit. Queries with plans larger than this are not logged. You must obtain execution plans for such queries via profiling or using the EXPLAIN statement. -Refer to [Configure the Completed Requests][sys-completed-config] for more information. +Refer to [Configure Completed Requests][sys-completed-config] for more information. The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6309,13 +6308,38 @@ When you change the cluster-level setting, the node-level setting is over-writte *Minimum:* `0` *Maximum:* `20840448` {blank} -a| Integer (int32) +a¦ Integer (int32) + + +a¦ [#completed-stream-size] +*completed-stream-size* + +_optional_ +a¦ + +[markdown] +-- +A file size in MiB. +When specified, completed requests are saved to the Couchbase Server `logs` directory. +Completed requests are saved to GZIP archives with the prefix `local_request_log`. +The value of this property determines the size of the data to retain, per node. + +Specify `0` (the default) to disable completed request streaming. + +Refer to [Stream Completed Requests][sys-history] for more information and examples. + +[sys-history]: /server/8.0/manage/monitor/monitoring-n1ql-query.html#sys-history + +-- + +[%hardbreaks] +{blank} +a¦ Integer (int32) -a| [#completed-threshold] +a¦ [#completed-threshold] *completed-threshold* + _optional_ -a| +a¦ [markdown] -- @@ -6330,7 +6354,7 @@ All completed queries lasting longer than this threshold are logged in the compl Specify `0` to track all requests, independent of duration. Specify any negative number to track none. -Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. +Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6344,13 +6368,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `1000` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#controls-srv] +a¦ [#controls-srv] *controls* + _optional_ -a| +a¦ [markdown] -- @@ -6376,13 +6400,13 @@ If a request does not include this parameter, the node-level `controls` setting *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#cpuprofile] +a¦ [#cpuprofile] *cpuprofile* + _optional_ -a| +a¦ [markdown] -- @@ -6397,16 +6421,16 @@ To stop `cpuprofile`, run with the empty setting of `""`. -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["/tmp/info.txt"]` +*Default:* `+++""+++` +*Example:* `+++"/tmp/info.txt"+++` {blank} -a| String +a¦ String -a| [#debug] +a¦ [#debug] *debug* + _optional_ -a| +a¦ [markdown] -- @@ -6420,13 +6444,13 @@ When set to `true`, extra logging is provided. *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#distribute] +a¦ [#distribute] *distribute* + _optional_ -a| +a¦ [markdown] -- @@ -6439,13 +6463,13 @@ The actual value of this field is ignored. [%hardbreaks] *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#functions-limit] +a¦ [#functions-limit] *functions-limit* + _optional_ -a| +a¦ [markdown] -- @@ -6456,13 +6480,13 @@ Maximum number of user-defined functions. *Default:* `16384` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#keep-alive-length] +a¦ [#keep-alive-length] *keep-alive-length* + _optional_ -a| +a¦ [markdown] -- @@ -6473,13 +6497,13 @@ Maximum size of buffered result. *Default:* `16384` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#loglevel] +a¦ [#loglevel] *loglevel* + _optional_ -a| +a¦ [markdown] -- @@ -6521,16 +6545,16 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] *Values:* `"DEBUG"`, `"TRACE"`, `"INFO"`, `"WARN"`, `"ERROR"`, `"SEVERE"`, `"NONE"` -*Default:* `pass:c["INFO"]` -*Example:* `pass:c["DEBUG"]` +*Default:* `+++"INFO"+++` +*Example:* `+++"DEBUG"+++` {blank} -a| String +a¦ String -a| [#max-index-api] +a¦ [#max-index-api] *max-index-api* + _optional_ -a| +a¦ [markdown] -- @@ -6541,13 +6565,13 @@ This setting is provided for technical support only. [%hardbreaks] {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#max-parallelism-srv] +a¦ [#max-parallelism-srv] *max-parallelism* + _optional_ -a| +a¦ [markdown] -- @@ -6586,13 +6610,13 @@ Refer to [Max Parallelism][max-parallelism] for more information. *Default:* `1` *Example:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#memory-quota-srv] +a¦ [#memory-quota-srv] *memory-quota* + _optional_ -a| +a¦ [markdown] -- @@ -6630,13 +6654,13 @@ If a request includes this parameter, it will be capped by the node-level `memor *Default:* `0` *Example:* `4` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#memprofile] +a¦ [#memprofile] *memprofile* + _optional_ -a| +a¦ [markdown] -- @@ -6649,16 +6673,16 @@ To stop `memprofile`, run with the empty setting of `""`. -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["/tmp/memory-usage.log"]` +*Default:* `+++""+++` +*Example:* `+++"/tmp/memory-usage.log"+++` {blank} -a| String +a¦ String -a| [#mutexprofile] +a¦ [#mutexprofile] *mutexprofile* + _optional_ -a| +a¦ [markdown] -- @@ -6670,13 +6694,13 @@ This setting is provided for technical support only. [%hardbreaks] *Default:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#n1ql-feat-ctrl] +a¦ [#n1ql-feat-ctrl] *n1ql-feat-ctrl* + _optional_ -a| +a¦ [markdown] -- @@ -6701,13 +6725,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `76` *Example:* `16460` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#node-quota] +a¦ [#node-quota] *node-quota* + _optional_ -a| [.status]##Couchbase Server 7.6## +a¦ [.status]##Couchbase Server 7.6## [markdown] -- @@ -6734,13 +6758,13 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] *Default:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#node-quota-val-percent] +a¦ [#node-quota-val-percent] *node-quota-val-percent* + _optional_ -a| [.status]##Couchbase Server 7.6## +a¦ [.status]##Couchbase Server 7.6## [markdown] -- @@ -6766,13 +6790,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Minimum:* `0` *Maximum:* `100` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#num-cpus] +a¦ [#num-cpus] *num-cpus* + _optional_ -a| [.status]##Couchbase Server 7.6## +a¦ [.status]##Couchbase Server 7.6## [markdown] -- @@ -6802,13 +6826,13 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] *Default:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#numatrs-srv] +a¦ [#numatrs-srv] *numatrs* + _optional_ -a| +a¦ [markdown] -- @@ -6834,13 +6858,13 @@ The minimum of that and the node-level `numatrs` setting is applied. [%hardbreaks] {blank} -a| String +a¦ String -a| [#pipeline-batch-srv] +a¦ [#pipeline-batch-srv] *pipeline-batch* + _optional_ -a| +a¦ [markdown] -- @@ -6867,13 +6891,13 @@ The minimum of that and the node-level `pipeline-batch` setting is applied. *Default:* `16` *Example:* `64` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#pipeline-cap-srv] +a¦ [#pipeline-cap-srv] *pipeline-cap* + _optional_ -a| +a¦ [markdown] -- @@ -6900,13 +6924,13 @@ The minimum of that and the node-level `pipeline-cap` setting is applied. *Default:* `512` *Example:* `1024` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#plus-servicers] +a¦ [#plus-servicers] *plus-servicers* + _optional_ -a| +a¦ [markdown] -- @@ -6918,13 +6942,13 @@ The default is 16 times the number of logical cores. [%hardbreaks] *Example:* `16` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#prepared-limit] +a¦ [#prepared-limit] *prepared-limit* + _optional_ -a| +a¦ [markdown] -- @@ -6947,13 +6971,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `16384` *Example:* `65536` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#pretty-srv] +a¦ [#pretty-srv] *pretty* + _optional_ -a| +a¦ [markdown] -- @@ -6975,13 +6999,13 @@ If a request does not include this parameter, the node-level setting is used, wh *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#profile-srv] +a¦ [#profile-srv] *profile* + _optional_ -a| +a¦ [markdown] -- @@ -7015,16 +7039,16 @@ If a request does not include this parameter, the node-level `profile` setting w [%hardbreaks] *Values:* `"off"`, `"phases"`, `"timings"` -*Default:* `pass:c["off"]` -*Example:* `pass:c["phases"]` +*Default:* `+++"off"+++` +*Example:* `+++"phases"+++` {blank} -a| String +a¦ String -a| [#request-size-cap] +a¦ [#request-size-cap] *request-size-cap* + _optional_ -a| +a¦ [markdown] -- @@ -7035,13 +7059,13 @@ Maximum size of a request. *Default:* `67108864` *Example:* `70000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#scan-cap-srv] +a¦ [#scan-cap-srv] *scan-cap* + _optional_ -a| +a¦ [markdown] -- @@ -7072,13 +7096,13 @@ The minimum of that and the node-level `scan-cap` setting is applied. *Default:* `512` *Example:* `1024` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#servicers] +a¦ [#servicers] *servicers* + _optional_ -a| +a¦ [markdown] -- @@ -7093,13 +7117,13 @@ Note that the overall node memory quota is this setting multiplied by the [node- *Default:* `32` *Example:* `8` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#timeout-srv] +a¦ [#timeout-srv] *timeout* + _optional_ -a| +a¦ [markdown] -- @@ -7132,13 +7156,13 @@ The minimum of that and the node-level `timeout` setting is applied. *Default:* `0` *Example:* `500000000` {blank} -a| Long (int64) +a¦ Long (int64) -a| [#txtimeout-srv] +a¦ [#txtimeout-srv] *txtimeout* + _optional_ -a| +a¦ [markdown] -- @@ -7175,13 +7199,13 @@ The minimum of that and the node-level `txtimeout` setting is applied. *Default:* `0` *Example:* `500000000` {blank} -a| Long (int64) +a¦ Long (int64) -a| [#use-cbo-srv] +a¦ [#use-cbo-srv] *use-cbo* + _optional_ -a| +a¦ [markdown] -- @@ -7208,13 +7232,13 @@ If a request does not include this parameter, the node-level setting is used, wh *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#use-replica-srv] +a¦ [#use-replica-srv] *use-replica* + _optional_ -a| [.status]##Couchbase Server 7.6## +a¦ [.status]##Couchbase Server 7.6## [markdown] -- @@ -7255,10 +7279,10 @@ If a query uses sequential scan and a data node becomes unavailable, the query m [%hardbreaks] *Values:* `"off"`, `"on"`, `"unset"` -*Default:* `pass:c["unset"]` -*Example:* `pass:c["on"]` +*Default:* `+++"unset"+++` +*Example:* `+++"on"+++` {blank} -a| String +a¦ String |=== @@ -7298,14 +7322,14 @@ endif::collapse-models[] //tag::Statements[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *encoded_plan* + _required_ -a| +a¦ [markdown] -- @@ -7314,13 +7338,13 @@ The full prepared statement in encoded format. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *featureControls* + _optional_ -a| +a¦ [markdown] -- @@ -7331,13 +7355,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *indexApiVersion* + _optional_ -a| +a¦ [markdown] -- @@ -7348,13 +7372,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *name* + _required_ -a| +a¦ [markdown] -- @@ -7365,13 +7389,13 @@ This may be a UUID that was assigned automatically, or a name that was user-spec [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *namespace* + _optional_ -a| +a¦ [markdown] -- @@ -7382,13 +7406,13 @@ Currently, only the `default` namespace is available. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *node* + _optional_ -a| +a¦ [markdown] -- @@ -7398,13 +7422,13 @@ The node on which the prepared statement is stored. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *statement* + _required_ -a| +a¦ [markdown] -- @@ -7413,13 +7437,13 @@ The text of the query. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *uses* + _required_ -a| +a¦ [markdown] -- @@ -7428,13 +7452,13 @@ The count of times the prepared statement has been executed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *avgElapsedTime* + _optional_ -a| +a¦ [markdown] -- @@ -7448,13 +7472,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *avgServiceTime* + _optional_ -a| +a¦ [markdown] -- @@ -7467,13 +7491,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *lastUse* + _optional_ -a| +a¦ [markdown] -- @@ -7485,13 +7509,13 @@ This property is only returned when the prepared statement has been executed. [%hardbreaks] {blank} -a| Date (date-time) +a¦ Date (date-time) -a| +a¦ *maxElapsedTime* + _optional_ -a| +a¦ [markdown] -- @@ -7505,13 +7529,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *maxServiceTime* + _optional_ -a| +a¦ [markdown] -- @@ -7524,13 +7548,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *minElapsedTime* + _optional_ -a| +a¦ [markdown] -- @@ -7544,13 +7568,13 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *minServiceTime* + _optional_ -a| +a¦ [markdown] -- @@ -7563,7 +7587,7 @@ It is only returned when retrieving a specific prepared statement, not when retr [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) |=== @@ -7603,14 +7627,14 @@ endif::collapse-models[] //tag::Statistics[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *active_requests.count* + _optional_ -a| +a¦ [markdown] -- @@ -7619,13 +7643,13 @@ Total number of active requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *at_plus.count* + _optional_ -a| +a¦ [markdown] -- @@ -7634,13 +7658,13 @@ Total number of query requests with `at_plus` index consistency. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *audit_actions.count* + _optional_ -a| +a¦ [markdown] -- @@ -7652,13 +7676,13 @@ Records in the output queue that have not yet been sent to the server are not co [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *audit_actions_failed.count* + _optional_ -a| +a¦ [markdown] -- @@ -7667,13 +7691,13 @@ The total number of audit records sent to the server that failed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *audit_requests_filtered.count* + _optional_ -a| +a¦ [markdown] -- @@ -7682,13 +7706,13 @@ The number of potentially auditable requests that cause no audit action to be ta [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *audit_requests_total.count* + _optional_ -a| +a¦ [markdown] -- @@ -7697,13 +7721,13 @@ The total number of potentially auditable requests sent to the query engine. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *cancelled.count* + _optional_ -a| +a¦ [markdown] -- @@ -7712,13 +7736,13 @@ Total number of cancelled requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *deletes.count* + _optional_ -a| +a¦ [markdown] -- @@ -7727,13 +7751,13 @@ Total number of DELETE operations. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *errors.count* + _optional_ -a| +a¦ [markdown] -- @@ -7742,13 +7766,13 @@ The total number of query errors returned so far. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *index_scans.count* + _optional_ -a| +a¦ [markdown] -- @@ -7757,13 +7781,13 @@ Total number of secondary index scans. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *inserts.count* + _optional_ -a| +a¦ [markdown] -- @@ -7772,13 +7796,13 @@ Total number of INSERT operations. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *invalid_requests.count* + _optional_ -a| +a¦ [markdown] -- @@ -7787,13 +7811,13 @@ Total number of requests for unsupported endpoints. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *mutations.count* + _optional_ -a| +a¦ [markdown] -- @@ -7802,13 +7826,13 @@ Total number of document mutations. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *prepared.count* + _optional_ -a| +a¦ [markdown] -- @@ -7817,13 +7841,13 @@ Total number of prepared statements executed. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *primary_scans.count* + _optional_ -a| +a¦ [markdown] -- @@ -7832,13 +7856,13 @@ Total number of primary index scans. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *queued_requests.count* + _optional_ -a| +a¦ [markdown] -- @@ -7847,13 +7871,13 @@ Total number of queued requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request_time.count* + _optional_ -a| +a¦ [markdown] -- @@ -7862,13 +7886,13 @@ Total end-to-end time to process all queries (ns). [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request_timer.15m.rate* + _optional_ -a| +a¦ [markdown] -- @@ -7879,13 +7903,13 @@ Number of query requests processed per second. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.1m.rate* + _optional_ -a| +a¦ [markdown] -- @@ -7896,13 +7920,13 @@ Number of query requests processed per second. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.5m.rate* + _optional_ -a| +a¦ [markdown] -- @@ -7913,13 +7937,13 @@ Number of query requests processed per second. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.75%* + _optional_ -a| +a¦ [markdown] -- @@ -7930,13 +7954,13 @@ The 75th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.95%* + _optional_ -a| +a¦ [markdown] -- @@ -7947,13 +7971,13 @@ The 95th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.99%* + _optional_ -a| +a¦ [markdown] -- @@ -7964,13 +7988,13 @@ The 99th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.99.9%* + _optional_ -a| +a¦ [markdown] -- @@ -7981,13 +8005,13 @@ The 99.9th percentile. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.count* + _optional_ -a| +a¦ [markdown] -- @@ -7996,13 +8020,13 @@ Total number of query requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request_timer.max* + _optional_ -a| +a¦ [markdown] -- @@ -8013,13 +8037,13 @@ The maximum value. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request_timer.mean* + _optional_ -a| +a¦ [markdown] -- @@ -8030,13 +8054,13 @@ The mean value. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.mean.rate* + _optional_ -a| +a¦ [markdown] -- @@ -8047,13 +8071,13 @@ Mean rate since the query service started. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.median* + _optional_ -a| +a¦ [markdown] -- @@ -8064,13 +8088,13 @@ The median value. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request_timer.min* + _optional_ -a| +a¦ [markdown] -- @@ -8081,13 +8105,13 @@ The minimum value. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request_timer.stddev* + _optional_ -a| +a¦ [markdown] -- @@ -8098,13 +8122,13 @@ The standard deviation. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *requests.count* + _optional_ -a| +a¦ [markdown] -- @@ -8113,13 +8137,13 @@ Total number of query requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *requests_1000ms.count* + _optional_ -a| +a¦ [markdown] -- @@ -8128,13 +8152,13 @@ Number of queries that take longer than 1000ms. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *requests_250ms.count* + _optional_ -a| +a¦ [markdown] -- @@ -8143,13 +8167,13 @@ Number of queries that take longer than 250ms. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *requests_5000ms.count* + _optional_ -a| +a¦ [markdown] -- @@ -8158,13 +8182,13 @@ Number of queries that take longer than 5000ms. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *requests_500ms.count* + _optional_ -a| +a¦ [markdown] -- @@ -8173,13 +8197,13 @@ Number of queries that take longer than 500ms. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *result_count.count* + _optional_ -a| +a¦ [markdown] -- @@ -8188,13 +8212,13 @@ Total number of results (documents) returned by the query engine. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *result_size.count* + _optional_ -a| +a¦ [markdown] -- @@ -8203,13 +8227,13 @@ Total size of data returned by the query engine (bytes). [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *scan_plus.count* + _optional_ -a| +a¦ [markdown] -- @@ -8218,13 +8242,13 @@ Total number of query requests with `request_plus` index consistency. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *selects.count* + _optional_ -a| +a¦ [markdown] -- @@ -8233,13 +8257,13 @@ Total number of SELECT requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *service_time.count* + _optional_ -a| +a¦ [markdown] -- @@ -8248,13 +8272,13 @@ Time to execute all queries (ns). [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *unbounded.count* + _optional_ -a| +a¦ [markdown] -- @@ -8263,13 +8287,13 @@ Total number of query requests with `not_bounded` index consistency. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *updates.count* + _optional_ -a| +a¦ [markdown] -- @@ -8278,13 +8302,13 @@ Total number of UPDATE requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *warnings.count* + _optional_ -a| +a¦ [markdown] -- @@ -8293,7 +8317,7 @@ The total number of query warnings returned so far. [%hardbreaks] {blank} -a| Integer +a¦ Integer |=== @@ -8333,14 +8357,14 @@ endif::collapse-models[] //tag::Vitals[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *bucket.IO.stats* + _optional_ -a| +a¦ [markdown] -- @@ -8349,13 +8373,13 @@ The number of reads and retries for each bucket. [%hardbreaks] {blank} -a| Object +a¦ Object -a| +a¦ *uptime* + _optional_ -a| +a¦ [markdown] -- @@ -8364,13 +8388,13 @@ The uptime of the query engine. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *local.time* + _optional_ -a| +a¦ [markdown] -- @@ -8379,13 +8403,13 @@ The local time of the query engine. [%hardbreaks] {blank} -a| Date (date-time) +a¦ Date (date-time) -a| +a¦ *version* + _optional_ -a| +a¦ [markdown] -- @@ -8394,13 +8418,13 @@ The version of the query engine. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *total.threads* + _optional_ -a| +a¦ [markdown] -- @@ -8409,13 +8433,13 @@ The number of active threads used by the query engine. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *cores* + _optional_ -a| +a¦ [markdown] -- @@ -8424,13 +8448,13 @@ The maximum number of logical cores available to the query engine. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *ffdc.total* + _optional_ -a| +a¦ [markdown] -- @@ -8439,13 +8463,13 @@ The total number of times FFDC has been invoked since the last restart. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *gc.num* + _optional_ -a| +a¦ [markdown] -- @@ -8454,13 +8478,13 @@ The target heap size of the next garbage collection cycle. [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *gc.pause.time* + _optional_ -a| +a¦ [markdown] -- @@ -8469,13 +8493,13 @@ The total time spent pausing for garbage collection since the query engine start [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *gc.pause.percent* + _optional_ -a| +a¦ [markdown] -- @@ -8484,13 +8508,13 @@ The percentage of time spent pausing for garbage collection since the last time [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *healthy* + _optional_ -a| +a¦ [markdown] -- @@ -8499,13 +8523,13 @@ False when either the unbounded or plus request queues are full; true otherwise. [%hardbreaks] {blank} -a| Boolean +a¦ Boolean -a| +a¦ *host.memory.free* + _optional_ -a| +a¦ [markdown] -- @@ -8514,13 +8538,13 @@ Amount of free memory on the host. [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *host.memory.quota* + _optional_ -a| +a¦ [markdown] -- @@ -8531,13 +8555,13 @@ This reflects the node-quota setting. [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *host.memory.total* + _optional_ -a| +a¦ [markdown] -- @@ -8546,13 +8570,13 @@ Total memory on the host. [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *host.memory.value_quota* + _optional_ -a| +a¦ [markdown] -- @@ -8561,13 +8585,13 @@ This the total document memory quota on the node. [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *load* + _optional_ -a| +a¦ [markdown] -- @@ -8576,13 +8600,13 @@ A calculation for how busy the server is. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *loadfactor* + _optional_ -a| +a¦ [markdown] -- @@ -8591,13 +8615,13 @@ The moving 15 minute average of the load calculation. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *memory.usage* + _optional_ -a| +a¦ [markdown] -- @@ -8608,13 +8632,13 @@ This increases as heap objects are allocated, and decreases as objects are freed [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *memory.total* + _optional_ -a| +a¦ [markdown] -- @@ -8625,13 +8649,13 @@ This increases as heap objects are allocated, but does not decrease when objects [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *memory.system* + _optional_ -a| +a¦ [markdown] -- @@ -8642,13 +8666,13 @@ This measures the virtual address space reserved by the query engine for heaps, [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *node* + _optional_ -a| +a¦ [markdown] -- @@ -8657,13 +8681,13 @@ The name or IP address and port of the node. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *node.allocated.values* + _optional_ -a| +a¦ [markdown] -- @@ -8674,13 +8698,13 @@ The total number of values allocated to contain documents or computations around [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *node.memory.usage* + _optional_ -a| +a¦ [markdown] -- @@ -8689,13 +8713,13 @@ The currently allocated document memory on the node. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *cpu.user.percent* + _optional_ -a| +a¦ [markdown] -- @@ -8706,13 +8730,13 @@ The percentage of time spent executing user code since the last time the statist [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *cpu.sys.percent* + _optional_ -a| +a¦ [markdown] -- @@ -8723,13 +8747,13 @@ The percentage of time spent executing system code since the last time the stati [%hardbreaks] {blank} -a| Long (int64) +a¦ Long (int64) -a| +a¦ *process.memory.usage* + _optional_ -a| +a¦ [markdown] -- @@ -8738,13 +8762,13 @@ Current process memory use. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *process.percore.cpupercent* + _optional_ -a| +a¦ [markdown] -- @@ -8753,13 +8777,13 @@ Average CPU usage per core. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *process.rss* + _optional_ -a| +a¦ [markdown] -- @@ -8768,13 +8792,13 @@ Process RSS (bytes) [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *process.service.usage* + _optional_ -a| +a¦ [markdown] -- @@ -8783,13 +8807,13 @@ The number of active servicers for the dominant workload — unbound queue s [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request.completed.count* + _optional_ -a| +a¦ [markdown] -- @@ -8798,13 +8822,13 @@ Total number of completed requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request.active.count* + _optional_ -a| +a¦ [markdown] -- @@ -8813,13 +8837,13 @@ Total number of active requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request.per.sec.1min* + _optional_ -a| +a¦ [markdown] -- @@ -8830,13 +8854,13 @@ Number of query requests processed per second. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request.per.sec.5min* + _optional_ -a| +a¦ [markdown] -- @@ -8847,13 +8871,13 @@ Number of query requests processed per second. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request.per.sec.15min* + _optional_ -a| +a¦ [markdown] -- @@ -8864,13 +8888,13 @@ Number of query requests processed per second. [%hardbreaks] {blank} -a| Big Decimal +a¦ Big Decimal -a| +a¦ *request.queued.count* + _optional_ -a| +a¦ [markdown] -- @@ -8879,13 +8903,13 @@ Number of queued requests. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request.quota.used.hwm* + _optional_ -a| +a¦ [markdown] -- @@ -8894,13 +8918,13 @@ High water mark for request quota use. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *request_time.mean* + _optional_ -a| +a¦ [markdown] -- @@ -8911,13 +8935,13 @@ The mean value. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *request_time.median* + _optional_ -a| +a¦ [markdown] -- @@ -8928,13 +8952,13 @@ The median value. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *request_time.80percentile* + _optional_ -a| +a¦ [markdown] -- @@ -8945,13 +8969,13 @@ The 80th percentile. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *request_time.95percentile* + _optional_ -a| +a¦ [markdown] -- @@ -8962,13 +8986,13 @@ The 95th percentile. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *request_time.99percentile* + _optional_ -a| +a¦ [markdown] -- @@ -8979,13 +9003,13 @@ The 99th percentile. [%hardbreaks] {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *request.prepared.percent* + _optional_ -a| +a¦ [markdown] -- @@ -8994,13 +9018,13 @@ Percentage of requests that are prepared statements. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *servicers.paused.count* + _optional_ -a| +a¦ [markdown] -- @@ -9011,13 +9035,13 @@ Number of servicers temporarily paused due to memory pressure. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *servicers.paused.total* + _optional_ -a| +a¦ [markdown] -- @@ -9028,13 +9052,13 @@ Number of times servicers have been temporarily paused. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *temp.hwm* + _optional_ -a| +a¦ [markdown] -- @@ -9045,13 +9069,13 @@ High water mark for temp space use directly by query. [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *temp.usage* + _optional_ -a| +a¦ [markdown] -- @@ -9062,7 +9086,7 @@ Current Query temp space use. [%hardbreaks] {blank} -a| Integer +a¦ Integer |=== @@ -9144,3 +9168,4 @@ include::{specDir}security/document-end.adoc[opts=optional] include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/n1ql-rest-functions/pages/index.adoc b/docs/modules/n1ql-rest-functions/pages/index.adoc index 7e953a7d..c7ea55bc 100644 --- a/docs/modules/n1ql-rest-functions/pages/index.adoc +++ b/docs/modules/n1ql-rest-functions/pages/index.adoc @@ -58,7 +58,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -69,7 +69,7 @@ The host name or IP address of a node running the Query service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -80,7 +80,7 @@ The Query service REST port. Use `18093` for secure access. [%hardbreaks] *Values:* `8093`, `18093` -*Example:* `pass:c[8093]` +*Example:* `+++8093+++` // end |=== @@ -178,6 +178,9 @@ For a scoped library, you must specify the bucket and scope. include::{specDir}paths/delete_library/operation-description-end.adoc[opts=optional] + + + :leveloffset: -1 @@ -200,13 +203,13 @@ include::{specDir}paths/delete_library/operation-description-end.adoc[opts=optio .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *library* + +a¦ *library* + _required_ -a| +a¦ [markdown] @@ -217,7 +220,7 @@ The name of a library. [%hardbreaks] {blank} -a| String +a¦ String @@ -227,13 +230,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *bucket* + +a¦ *bucket* + _optional_ -a| +a¦ [markdown] @@ -245,13 +248,13 @@ For scoped libraries only. The bucket in which the library is stored. [%hardbreaks] {blank} -a| String +a¦ String -a| *scope* + +a¦ *scope* + _optional_ -a| +a¦ [markdown] @@ -263,7 +266,7 @@ For scoped libraries only. The scope in which the library is stored. [%hardbreaks] {blank} -a| String +a¦ String @@ -284,8 +287,6 @@ include::{specDir}paths/delete_library/operation-parameters-end.adoc[opts=option - - // markup not found, no include::{specDir}paths/delete_library/operation-responses-before.adoc[opts=optional] @@ -421,6 +422,12 @@ By default, this operation returns all global libraries and functions, and all s // markup not found, no include::{specDir}paths/get_collection/operation-description-end.adoc[opts=optional] + + +[#get_collection-produces] +.Produces +* application/json + :leveloffset: -1 @@ -444,13 +451,13 @@ By default, this operation returns all global libraries and functions, and all s .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *bucket* + +a¦ *bucket* + _optional_ -a| +a¦ [markdown] @@ -462,13 +469,13 @@ For scoped libraries only. The bucket from which to fetch libraries. [%hardbreaks] {blank} -a| String +a¦ String -a| *scope* + +a¦ *scope* + _optional_ -a| +a¦ [markdown] @@ -480,7 +487,7 @@ For scoped libraries only. The scope from which to fetch libraries. [%hardbreaks] {blank} -a| String +a¦ String @@ -500,12 +507,6 @@ include::{specDir}paths/get_collection/operation-parameters-end.adoc[opts=option // markup not found, no include::{specDir}paths/get_collection/operation-parameters-after.adoc[opts=optional] -[#get_collection-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_collection/operation-responses-before.adoc[opts=optional] @@ -638,6 +639,12 @@ By default, this operation returns a global library. For a scoped library, you m // markup not found, no include::{specDir}paths/get_library/operation-description-end.adoc[opts=optional] + + +[#get_library-produces] +.Produces +* application/json + :leveloffset: -1 @@ -660,13 +667,13 @@ By default, this operation returns a global library. For a scoped library, you m .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *library* + +a¦ *library* + _required_ -a| +a¦ [markdown] @@ -677,7 +684,7 @@ The name of a library. [%hardbreaks] {blank} -a| String +a¦ String @@ -687,13 +694,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *bucket* + +a¦ *bucket* + _optional_ -a| +a¦ [markdown] @@ -705,13 +712,13 @@ For scoped libraries only. The bucket in which the library is stored. [%hardbreaks] {blank} -a| String +a¦ String -a| *scope* + +a¦ *scope* + _optional_ -a| +a¦ [markdown] @@ -723,7 +730,7 @@ For scoped libraries only. The scope in which the library is stored. [%hardbreaks] {blank} -a| String +a¦ String @@ -743,12 +750,6 @@ include::{specDir}paths/get_library/operation-parameters-end.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_library/operation-parameters-after.adoc[opts=optional] -[#get_library-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_library/operation-responses-before.adoc[opts=optional] @@ -887,6 +888,12 @@ By default, this operation creates or updates a global library. For a scoped lib include::{specDir}paths/post_library/operation-description-end.adoc[opts=optional] + +[#post_library-consumes] +.Consumes +* application/json + + :leveloffset: -1 @@ -909,13 +916,13 @@ include::{specDir}paths/post_library/operation-description-end.adoc[opts=optiona .Path Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *library* + +a¦ *library* + _required_ -a| +a¦ [markdown] @@ -926,7 +933,7 @@ The name of a library. [%hardbreaks] {blank} -a| String +a¦ String @@ -936,13 +943,13 @@ a| String .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *bucket* + +a¦ *bucket* + _optional_ -a| +a¦ [markdown] @@ -954,13 +961,13 @@ For scoped libraries only. The bucket in which the library is stored. [%hardbreaks] {blank} -a| String +a¦ String -a| *scope* + +a¦ *scope* + _optional_ -a| +a¦ [markdown] @@ -972,7 +979,7 @@ For scoped libraries only. The scope in which the library is stored. [%hardbreaks] {blank} -a| String +a¦ String @@ -984,13 +991,13 @@ a| String .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _required_ -a| +a¦ [markdown] @@ -1001,7 +1008,7 @@ The JavaScript code for all functions in the library. [%hardbreaks] {blank} -a| String +a¦ String @@ -1019,12 +1026,6 @@ include::{specDir}paths/post_library/operation-parameters-end.adoc[opts=optional -[#post_library-consumes] -= Consumes - -* application/json - - // markup not found, no include::{specDir}paths/post_library/operation-responses-before.adoc[opts=optional] @@ -1181,14 +1182,14 @@ endif::collapse-models[] //tag::Functions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ _additional + property_ -a| +a¦ [markdown] -- @@ -1199,9 +1200,9 @@ The name of the property is the name of the library. -- [%hardbreaks] -*Example:* `pass:c["function add(a, b) { return a + b; } function mul(a, b) { return a * b; }"]` +*Example:* `+++"function add(a, b) { return a + b; } function mul(a, b) { return a * b; }"+++` {blank} -a| String +a¦ String |=== @@ -1241,14 +1242,14 @@ endif::collapse-models[] //tag::Libraries[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *name* + _required_ -a| +a¦ [markdown] -- @@ -1256,15 +1257,15 @@ The name of a library. -- [%hardbreaks] -*Example:* `pass:c["math"]` +*Example:* `+++"math"+++` {blank} -a| String +a¦ String -a| +a¦ *bucket* + _required_ -a| +a¦ [markdown] -- @@ -1273,15 +1274,15 @@ For scoped libraries, the bucket in which the library is stored. For global libr -- [%hardbreaks] -*Example:* `pass:c["travel-sample"]` +*Example:* `+++"travel-sample"+++` {blank} -a| String +a¦ String -a| +a¦ *scope* + _required_ -a| +a¦ [markdown] -- @@ -1290,15 +1291,15 @@ For scoped libraries, the scope in which the library is stored. For global libra -- [%hardbreaks] -*Example:* `pass:c["inventory"]` +*Example:* `+++"inventory"+++` {blank} -a| String +a¦ String -a| +a¦ *code* + _required_ -a| +a¦ [markdown] -- @@ -1307,9 +1308,9 @@ The JavaScript code for all functions in the library. -- [%hardbreaks] -*Example:* `pass:c["function add(a, b) { return a + b; } function mul(a, b) { return a * b; }"]` +*Example:* `+++"function add(a, b) { return a + b; } function mul(a, b) { return a * b; }"+++` {blank} -a| String +a¦ String |=== @@ -1426,3 +1427,4 @@ include::{specDir}security/document-end.adoc[opts=optional] // markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index d6e7c4fa..49d82b26 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -59,7 +59,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -70,7 +70,7 @@ The host name or IP address of a node running the Query service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -81,7 +81,7 @@ The Query service REST port. Use `18093` for secure access. [%hardbreaks] *Values:* `8093`, `18093` -*Example:* `pass:c[8093]` +*Example:* `+++8093+++` // end |=== @@ -176,6 +176,12 @@ This endpoint is intended for situations where use of the `POST` method is restr // markup not found, no include::{specDir}paths/get_service/operation-description-end.adoc[opts=optional] + + +[#get_service-produces] +.Produces +* application/json + :leveloffset: -1 @@ -199,13 +205,13 @@ This endpoint is intended for situations where use of the `POST` method is restr .Query Parameters {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *body* + +a¦ *body* + _required_ -a| +a¦ [markdown] @@ -217,7 +223,7 @@ The format for URL-encoded parameters is consistent with the syntax for variable [%hardbreaks] {blank} -a| <> +a¦ <> @@ -237,12 +243,6 @@ a| <> // markup not found, no include::{specDir}paths/get_service/operation-parameters-after.adoc[opts=optional] -[#get_service-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_service/operation-responses-before.adoc[opts=optional] @@ -425,6 +425,16 @@ Enables you to execute a SQL++ statement. This method allows you to run queries // markup not found, no include::{specDir}paths/post_service/operation-description-end.adoc[opts=optional] + +[#post_service-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#post_service-produces] +.Produces +* application/json + :leveloffset: -1 @@ -451,13 +461,13 @@ include::{specDir}paths/post_service/operation-parameters-begin.adoc[opts=option .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _required_ -a| +a¦ [markdown] @@ -468,7 +478,7 @@ An object specifying one or more query parameters. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -485,17 +495,6 @@ a| <> // markup not found, no include::{specDir}paths/post_service/operation-parameters-after.adoc[opts=optional] -[#post_service-produces] -= Produces - -* application/json - -[#post_service-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_service/operation-responses-before.adoc[opts=optional] @@ -712,14 +711,14 @@ Errors and warnings have the following format. //end::desc-Conditions[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *code* + _required_ -a| +a¦ [markdown] -- @@ -729,13 +728,13 @@ A unique number that identifies the error or warning. The code ranges are partit [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *msg* + _required_ -a| +a¦ [markdown] -- @@ -745,13 +744,13 @@ A message describing the error or warning in detail. This property is always pre [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *name* + _optional_ -a| +a¦ [markdown] -- @@ -760,15 +759,15 @@ Unique name that has a 1:1 mapping to the code. Uniquely identifies the conditio -- [%hardbreaks] -*Example:* `pass:c["indexing.scan.io_failure"]` +*Example:* `+++"indexing.scan.io_failure"+++` {blank} -a| String +a¦ String -a| +a¦ *sev* + _optional_ -a| +a¦ [markdown] -- @@ -783,13 +782,13 @@ One of the following SQL++ severity levels, listed in order of severity: [%hardbreaks] {blank} -a| Integer +a¦ Integer -a| +a¦ *temp* + _optional_ -a| +a¦ [markdown] -- @@ -799,7 +798,7 @@ Indicates if the condition is transient — for example, the queue is full. [%hardbreaks] {blank} -a| Boolean +a¦ Boolean |=== @@ -845,14 +844,14 @@ An object containing runtime information provided along with the request. Presen //end::desc-Controls[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *scan_consistency* + _optional_ -a| +a¦ [markdown] -- @@ -861,13 +860,13 @@ The value of the query setting Scan Consistency used for the query. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *use_cbo* + _optional_ -a| +a¦ [markdown] -- @@ -876,13 +875,13 @@ Whether the cost-based optimizer was enabled for the query. [%hardbreaks] {blank} -a| Boolean +a¦ Boolean -a| +a¦ *memoryQuota* + _optional_ -a| +a¦ [markdown] -- @@ -892,13 +891,13 @@ The memory quota for the request, in MB. This property is only returned if a mem [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *stmtType* + _optional_ -a| +a¦ [markdown] -- @@ -906,9 +905,9 @@ The type of query statement. -- [%hardbreaks] -*Example:* `pass:c["SELECT"]` +*Example:* `+++"SELECT"+++` {blank} -a| String +a¦ String |=== @@ -956,14 +955,14 @@ The execution details for various phases involved in the query execution, such a //end::desc-Execution_Timings[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *#operator* + _required_ -a| +a¦ [markdown] -- @@ -971,15 +970,15 @@ Name of the operator. -- [%hardbreaks] -*Example:* `pass:c["Fetch"]` +*Example:* `+++"Fetch"+++` {blank} -a| String +a¦ String -a| +a¦ *#stats* + _required_ -a| +a¦ [markdown] -- @@ -988,13 +987,13 @@ include::index.adoc[tag=desc-Statistics, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> -a| +a¦ *~child* + _optional_ -a| +a¦ [markdown] -- @@ -1003,7 +1002,7 @@ Further nested operators, each with their own execution timings. [%hardbreaks] {blank} -a| Object +a¦ Object |=== @@ -1048,14 +1047,14 @@ An object containing metrics about the request. //end::desc-Metrics[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *elapsedTime* + _required_ -a| +a¦ [markdown] -- @@ -1064,13 +1063,13 @@ The total time taken for the request, that is the time from when the request was [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *executionTime* + _required_ -a| +a¦ [markdown] -- @@ -1079,13 +1078,13 @@ The time taken for the execution of the request, that is the time from when quer [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *resultCount* + _required_ -a| +a¦ [markdown] -- @@ -1094,13 +1093,13 @@ The total number of objects in the results. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *resultSize* + _required_ -a| +a¦ [markdown] -- @@ -1109,13 +1108,13 @@ The total number of bytes in the results. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *mutationCount* + _optional_ -a| +a¦ [markdown] -- @@ -1124,13 +1123,13 @@ The number of mutations that were made during the request. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *sortCount* + _optional_ -a| +a¦ [markdown] -- @@ -1142,13 +1141,13 @@ If a query includes ORDER BY, LIMIT, or OFFSET clauses, an application can use t [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *usedMemory* + _optional_ -a| +a¦ [markdown] -- @@ -1158,13 +1157,13 @@ The amount of document memory used to execute the request. This property is only [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *errorCount* + _optional_ -a| +a¦ [markdown] -- @@ -1173,13 +1172,13 @@ The number of errors that occurred during the request. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *warningCount* + _optional_ -a| +a¦ [markdown] -- @@ -1188,13 +1187,13 @@ The number of warnings that occurred during the request. [%hardbreaks] {blank} -a| Integer (unsigned) +a¦ Integer (unsigned) -a| +a¦ *sessionMemory* + _optional_ -a| +a¦ [markdown] -- @@ -1208,7 +1207,7 @@ This metric is available only when `node-quota` and `node-quota-val-percent` are [%hardbreaks] {blank} -a| Integer (bytes) +a¦ Integer (bytes) |=== @@ -1254,14 +1253,14 @@ An object containing monitoring and profiling information about the request. Pre //end::desc-Profile[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *requestTime* + _required_ -a| +a¦ [markdown] -- @@ -1270,13 +1269,13 @@ Timestamp when the query was received. [%hardbreaks] {blank} -a| Date (date-time) +a¦ Date (date-time) -a| +a¦ *servicingHost* + _required_ -a| +a¦ [markdown] -- @@ -1285,13 +1284,13 @@ IP address and port number of the node where the query was executed. [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *phaseCounts* + _required_ -a| +a¦ [markdown] -- @@ -1302,13 +1301,13 @@ Count of documents processed at selective phases involved in the query execution [%hardbreaks] *Example:* `{"fetch":16,"indexScan":187}` {blank} -a| Object +a¦ Object -a| +a¦ *phaseOperators* + _required_ -a| +a¦ [markdown] -- @@ -1325,13 +1324,13 @@ This is in essence the count of all the operators in the `executionTimings` obje [%hardbreaks] *Example:* `{"authorize":1,"fetch":1,"indexScan":2}` {blank} -a| Object +a¦ Object -a| +a¦ *phaseTimes* + _required_ -a| +a¦ [markdown] -- @@ -1342,13 +1341,13 @@ Cumulative execution times for various phases involved in the query execution, s [%hardbreaks] *Example:* `{"authorize":"823.631µs","fetch":"656.873µs","indexScan":"29.146543ms","instantiate":"236.221µs","parse":"826.382µs","plan":"11.831101ms","run":"16.892181ms"}` {blank} -a| Object +a¦ Object -a| +a¦ *executionTimings* + _optional_ -a| +a¦ [markdown] -- @@ -1357,13 +1356,13 @@ include::index.adoc[tag=desc-Execution_Timings, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> -a| +a¦ *ioTime* + _optional_ -a| +a¦ [markdown] -- @@ -1372,15 +1371,15 @@ The total sum of [servTime](#serv_time) across all operators. -- [%hardbreaks] -*Example:* `pass:c["752.858519ms"]` +*Example:* `+++"752.858519ms"+++` {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *waitTime* + _optional_ -a| +a¦ [markdown] -- @@ -1389,15 +1388,15 @@ The total sum of [kernTime](#kern_time) across all operators. -- [%hardbreaks] -*Example:* `pass:c["1.201307s"]` +*Example:* `+++"1.201307s"+++` {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *cpuTime* + _optional_ -a| +a¦ [markdown] -- @@ -1406,15 +1405,15 @@ The total sum of [execTime](#exec_time) across all operators. -- [%hardbreaks] -*Example:* `pass:c["90.734075ms"]` +*Example:* `+++"90.734075ms"+++` {blank} -a| String (duration) +a¦ String (duration) -a| +a¦ *~analysis* + _optional_ -a| +a¦ [markdown] -- @@ -1426,7 +1425,7 @@ These phrases highlight notable aspects of the execution, such as high document [%hardbreaks] *Example:* `["High IO time","High primary scan document count"]` {blank} -a| String +a¦ String array |=== @@ -1466,14 +1465,14 @@ endif::collapse-models[] //tag::Request[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| [#args] +a¦ [#args] *args* + _optional_ -a| +a¦ [markdown] -- @@ -1491,13 +1490,13 @@ Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for d [%hardbreaks] *Example:* `["LAX",6]` {blank} -a| Any Type +a¦ Any Type array -a| [#atrcollection_req] +a¦ [#atrcollection_req] *atrcollection* + _optional_ -a| +a¦ [markdown] -- @@ -1518,15 +1517,15 @@ If any part of the path contains a special character, that part of the path must -- [%hardbreaks] -*Example:* `pass:c["default:`travel-sample`.transaction.test"]` +*Example:* `+++"default:`travel-sample`.transaction.test"+++` {blank} -a| String +a¦ String -a| [#auto_execute] +a¦ [#auto_execute] *auto_execute* + _optional_ -a| +a¦ [markdown] -- @@ -1543,13 +1542,13 @@ Refer to [Auto-Execute][auto-execute] for more information. *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#client_context_id] +a¦ [#client_context_id] *client_context_id* + _optional_ -a| +a¦ [markdown] -- @@ -1563,13 +1562,13 @@ SQL++ is agnostic about the content of this parameter; it is just echoed in the [%hardbreaks] {blank} -a| String +a¦ String -a| [#compression] +a¦ [#compression] *compression* + _optional_ -a| +a¦ [markdown] -- @@ -1581,16 +1580,16 @@ Values are case-insensitive. [%hardbreaks] *Values:* `"ZIP"`, `"RLE"`, `"LZMA"`, `"LZO"`, `"NONE"` -*Default:* `pass:c["NONE"]` -*Example:* `pass:c["zip"]` +*Default:* `+++"NONE"+++` +*Example:* `+++"zip"+++` {blank} -a| String +a¦ String -a| [#controls_req] +a¦ [#controls_req] *controls* + _optional_ -a| +a¦ [markdown] -- @@ -1610,13 +1609,13 @@ If the request qualifies for caching, these values will also be cached in the `c [%hardbreaks] *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#durability_level] +a¦ [#durability_level] *durability_level* + _optional_ -a| +a¦ [markdown] -- @@ -1636,16 +1635,16 @@ Set the durability level to `"none"` or `""` to specify no durability. [%hardbreaks] *Values:* `""`, `"none"`, `"majority"`, `"majorityAndPersistActive"`, `"persistToMajority"` -*Default:* `pass:c["majority"]` -*Example:* `pass:c["none"]` +*Default:* `+++"majority"+++` +*Example:* `+++"none"+++` {blank} -a| String +a¦ String -a| [#encoded_plan] +a¦ [#encoded_plan] *encoded_plan* + _optional_ -a| +a¦ [markdown] -- @@ -1656,13 +1655,13 @@ It is included for compatibility with previous versions of Couchbase Server. [%hardbreaks] {blank} -a| String +a¦ String -a| [#encoding] +a¦ [#encoding] *encoding* + _optional_ -a| +a¦ [markdown] -- @@ -1673,15 +1672,15 @@ Only possible value is `UTF-8` and is case-insensitive. -- [%hardbreaks] -*Default:* `pass:c["UTF-8"]` +*Default:* `+++"UTF-8"+++` {blank} -a| String +a¦ String -a| [#format] +a¦ [#format] *format* + _optional_ -a| +a¦ [markdown] -- @@ -1693,16 +1692,16 @@ Values are case-insensitive. [%hardbreaks] *Values:* `"JSON"`, `"XML"`, `"CSV"`, `"TSV"` -*Default:* `pass:c["JSON"]` -*Example:* `pass:c["XML"]` +*Default:* `+++"JSON"+++` +*Example:* `+++"XML"+++` {blank} -a| String +a¦ String -a| [#kvtimeout] +a¦ [#kvtimeout] *kvtimeout* + _optional_ -a| +a¦ [markdown] -- @@ -1728,16 +1727,16 @@ When disabled, no timeout is applied and the KV operation runs for however long -- [%hardbreaks] -*Default:* `pass:c["2.5s"]` -*Example:* `pass:c["10ms"]` +*Default:* `+++"2.5s"+++` +*Example:* `+++"10ms"+++` {blank} -a| String +a¦ String -a| [#max_parallelism_req] +a¦ [#max_parallelism_req] *max_parallelism* + _optional_ -a| +a¦ [markdown] -- @@ -1756,13 +1755,13 @@ The default value is the same as the number of partitions of the index selected [%hardbreaks] *Example:* `3` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#memory_quota_req] +a¦ [#memory_quota_req] *memory_quota* + _optional_ -a| +a¦ [markdown] -- @@ -1790,13 +1789,13 @@ delta table and the transaction log (approximately). *Default:* `0` *Example:* `4` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#metrics] +a¦ [#metrics] *metrics* + _optional_ -a| +a¦ [markdown] -- @@ -1807,13 +1806,13 @@ Specifies that metrics should be returned with query results. *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#namespace] +a¦ [#namespace] *namespace* + _optional_ -a| +a¦ [markdown] -- @@ -1822,15 +1821,15 @@ Specifies the namespace to use. Currently, only the `default` namespace is avail -- [%hardbreaks] -*Example:* `pass:c["default"]` +*Example:* `+++"default"+++` {blank} -a| String +a¦ String -a| [#numatrs_req] +a¦ [#numatrs_req] *numatrs* + _optional_ -a| +a¦ [markdown] -- @@ -1851,13 +1850,13 @@ Must be a positive integer. *Default:* `1024` *Example:* `512` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#pipeline_batch_req] +a¦ [#pipeline_batch_req] *pipeline_batch* + _optional_ -a| +a¦ [markdown] -- @@ -1874,13 +1873,13 @@ Controls the number of items execution operators can batch for Fetch from the KV [%hardbreaks] *Example:* `64` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#pipeline_cap_req] +a¦ [#pipeline_cap_req] *pipeline_cap* + _optional_ -a| +a¦ [markdown] -- @@ -1897,13 +1896,13 @@ Maximum number of items each execution operator can buffer between various opera [%hardbreaks] *Example:* `1024` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#prepared] +a¦ [#prepared] *prepared* + _optional_ -a| +a¦ [markdown] -- @@ -1919,15 +1918,15 @@ If both `prepared` and `statement` are present and non-empty, an error is return -- [%hardbreaks] -*Example:* `pass:c["a1355198-2576-4e3d-af04-5acc77d8a681"]` +*Example:* `+++"a1355198-2576-4e3d-af04-5acc77d8a681"+++` {blank} -a| String +a¦ String -a| [#preserve_expiry] +a¦ [#preserve_expiry] *preserve_expiry* + _optional_ -a| +a¦ [markdown] -- @@ -1946,13 +1945,13 @@ Not supported for statements in a transaction. *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#pretty_req] +a¦ [#pretty_req] *pretty* + _optional_ -a| +a¦ [markdown] -- @@ -1968,13 +1967,13 @@ Specifies the query results returned in pretty format. [%hardbreaks] *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#profile_req] +a¦ [#profile_req] *profile* + _optional_ -a| +a¦ [markdown] -- @@ -2002,15 +2001,15 @@ If `profile` is not set as one of the above values, then the profile setting doe [%hardbreaks] *Values:* `"off"`, `"phases"`, `"timings"` -*Example:* `pass:c["phases"]` +*Example:* `+++"phases"+++` {blank} -a| String +a¦ String -a| [#query_context] +a¦ [#query_context] *query_context* + _optional_ -a| +a¦ [markdown] -- @@ -2023,16 +2022,16 @@ If the namespace name is omitted, the default namespace in the current session i -- [%hardbreaks] -*Default:* `pass:c["default:"]` -*Example:* `pass:c["default:travel-sample.inventory"]` +*Default:* `+++"default:"+++` +*Example:* `+++"default:travel-sample.inventory"+++` {blank} -a| String +a¦ String -a| [#readonly] +a¦ [#readonly] *readonly* + _optional_ -a| +a¦ [markdown] -- @@ -2055,13 +2054,13 @@ When using GET requests, it's best to set `readonly` to `true`. *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#scan_cap_req] +a¦ [#scan_cap_req] *scan_cap* + _optional_ -a| +a¦ [markdown] -- @@ -2082,13 +2081,13 @@ Smaller values reduce GC, while larger values reduce indexer backfill. [%hardbreaks] *Example:* `1024` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#scan_consistency] +a¦ [#scan_consistency] *scan_consistency* + _optional_ -a| +a¦ [markdown] -- @@ -2129,16 +2128,16 @@ Refer to [Transactional Scan Consistency][transactional-scan-consistency] for de [%hardbreaks] *Values:* `"not_bounded"`, `"at_plus"`, `"request_plus"`, `"statement_plus"` -*Default:* `pass:c["not_bounded"]` -*Example:* `pass:c["at_plus"]` +*Default:* `+++"not_bounded"+++` +*Example:* `+++"at_plus"+++` {blank} -a| String +a¦ String -a| [#scan_vector] +a¦ [#scan_vector] *scan_vector* + _optional_ -a| +a¦ [markdown] -- @@ -2165,13 +2164,13 @@ For queries referencing multiple keyspaces, use `scan_vectors`. [%hardbreaks] *Example:* `{"5":[5409393,"VB5ID"],"19":[47574574,"VB19ID"]}` {blank} -a| Object +a¦ Object -a| [#scan_vectors] +a¦ [#scan_vectors] *scan_vectors* + _optional_ -a| +a¦ [markdown] -- @@ -2186,13 +2185,13 @@ The scan vectors can be Full or Sparse. [%hardbreaks] {blank} -a| Object +a¦ Object -a| [#scan_wait] +a¦ [#scan_wait] *scan_wait* + _optional_ -a| +a¦ [markdown] -- @@ -2218,16 +2217,16 @@ Specify `0` or a negative integer to disable. -- [%hardbreaks] -*Default:* `pass:c[""]` -*Example:* `pass:c["30m"]` +*Default:* `+++""+++` +*Example:* `+++"30m"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#signature] +a¦ [#signature] *signature* + _optional_ -a| +a¦ [markdown] -- @@ -2238,13 +2237,13 @@ Include a header for the results schema in the response. *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#sort_projection] +a¦ [#sort_projection] *sort_projection* + _optional_ -a| +a¦ [markdown] -- @@ -2258,13 +2257,13 @@ If `false` (the default), statement projection terms are returned in the order s *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#statement] +a¦ [#statement] *statement* + _optional_ -a| +a¦ [markdown] -- @@ -2285,15 +2284,15 @@ This restriction does not apply when specifying the request parameters in JSON f -- [%hardbreaks] -*Example:* `pass:c["SELECT * FROM `travel-sample`.inventory.hotel LIMIT 1"]` +*Example:* `+++"SELECT * FROM `travel-sample`.inventory.hotel LIMIT 1"+++` {blank} -a| String +a¦ String -a| [#timeout_req] +a¦ [#timeout_req] *timeout* + _optional_ -a| +a¦ [markdown] -- @@ -2325,15 +2324,15 @@ The request inherits the remaining time of the transaction as timeout. -- [%hardbreaks] -*Example:* `pass:c["30m"]` +*Example:* `+++"30m"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#txdata] +a¦ [#txdata] *txdata* + _optional_ -a| +a¦ [markdown] -- @@ -2344,13 +2343,13 @@ For internal use only. [%hardbreaks] {blank} -a| Object +a¦ Object -a| [#txid] +a¦ [#txid] *txid* + _optional_ -a| +a¦ [markdown] -- @@ -2366,15 +2365,15 @@ The transaction must be active and non-expired. -- [%hardbreaks] -*Example:* `pass:c["d81d9b4a-b758-4f98-b007-87ba262d3a51"]` +*Example:* `+++"d81d9b4a-b758-4f98-b007-87ba262d3a51"+++` {blank} -a| UUID (UUID) +a¦ UUID (UUID) -a| [#tximplicit] +a¦ [#tximplicit] *tximplicit* + _optional_ -a| +a¦ [markdown] -- @@ -2392,13 +2391,13 @@ If the [txid](#txid) request-level parameter is set, the `tximplicit` parameter *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#txstmtnum] +a¦ [#txstmtnum] *txstmtnum* + _optional_ -a| +a¦ [markdown] -- @@ -2411,13 +2410,13 @@ If the transaction statement number is lower than the transaction statement numb [%hardbreaks] *Example:* `10` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#txtimeout_req] +a¦ [#txtimeout_req] *txtimeout* + _optional_ -a| +a¦ [markdown] -- @@ -2454,15 +2453,15 @@ The default is `"15s"` for cbq files or scripts, `"2m"` for interactive cbq sess -- [%hardbreaks] -*Example:* `pass:c["30m"]` +*Example:* `+++"30m"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#use_cbo_req] +a¦ [#use_cbo_req] *use_cbo* + _optional_ -a| +a¦ [markdown] -- @@ -2479,13 +2478,13 @@ Specifies whether the cost-based optimizer is enabled. [%hardbreaks] *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#use_fts] +a¦ [#use_fts] *use_fts* + _optional_ -a| +a¦ [markdown] -- @@ -2507,13 +2506,13 @@ Refer to [Flex Indexes][flex-indexes] for more information. *Default:* `false` *Example:* `true` {blank} -a| Boolean +a¦ Boolean -a| [#use_replica_req] +a¦ [#use_replica_req] *use_replica* + _optional_ -a| [.status]##Couchbase Server 7.6## +a¦ [.status]##Couchbase Server 7.6## [markdown] -- @@ -2545,16 +2544,16 @@ If a query uses sequential scan and a data node becomes unavailable, the query m [%hardbreaks] *Values:* `"off"`, `"on"`, `"unset"` -*Default:* `pass:c["unset"]` -*Example:* `pass:c["true"]` +*Default:* `+++"unset"+++` +*Example:* `+++"true"+++` {blank} -a| String +a¦ String -a| [#identifier] +a¦ [#identifier] _additional + property_ -a| +a¦ [markdown] -- @@ -2578,7 +2577,7 @@ Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for d [%hardbreaks] {blank} -a| Any Type +a¦ Any Type |=== @@ -2623,14 +2622,14 @@ The response body has the following structure. //end::desc-Response[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *requestID* + _optional_ -a| +a¦ [markdown] -- @@ -2639,13 +2638,13 @@ A unique identifier for the response. [%hardbreaks] {blank} -a| UUID (UUID) +a¦ UUID (UUID) -a| +a¦ *clientContextID* + _optional_ -a| +a¦ [markdown] -- @@ -2654,13 +2653,13 @@ The client context ID of the request, if one was supplied — see `client_co [%hardbreaks] {blank} -a| String +a¦ String -a| +a¦ *signature* + _optional_ -a| +a¦ [markdown] -- @@ -2671,13 +2670,13 @@ The schema of the results. Present only when the query completes successfully. [%hardbreaks] *Example:* `{"id":"json"}` {blank} -a| Object +a¦ Object -a| +a¦ *results* + _optional_ -a| +a¦ [markdown] -- @@ -2687,13 +2686,13 @@ An array of all the objects returned by the query. An object can be any JSON val [%hardbreaks] {blank} -a| Any Type +a¦ Any Type array -a| +a¦ *status* + _optional_ -a| +a¦ [markdown] -- @@ -2703,13 +2702,13 @@ The status of the request. [%hardbreaks] *Values:* `"success"`, `"running"`, `"errors"`, `"completed"`, `"stopped"`, `"timeout"`, `"fatal"` {blank} -a| String +a¦ String -a| +a¦ *errors* + _optional_ -a| +a¦ [markdown] -- @@ -2719,13 +2718,13 @@ An array of 0 or more error objects. If an error occurred during processing of t [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *warnings* + _optional_ -a| +a¦ [markdown] -- @@ -2735,13 +2734,13 @@ An array of 0 or more warning objects. If a warning occurred during processing o [%hardbreaks] {blank} -a| <> +a¦ <> array -a| +a¦ *metrics* + _optional_ -a| +a¦ [markdown] -- @@ -2750,13 +2749,13 @@ include::index.adoc[tag=desc-Metrics, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> -a| +a¦ *controls* + _optional_ -a| +a¦ [markdown] -- @@ -2765,13 +2764,13 @@ include::index.adoc[tag=desc-Controls, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> -a| +a¦ *profile* + _optional_ -a| +a¦ [markdown] -- @@ -2780,7 +2779,7 @@ include::index.adoc[tag=desc-Profile, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -2825,14 +2824,14 @@ Statistics collected for the operator. //end::desc-Statistics[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *#itemsIn* + _optional_ -a| +a¦ [markdown] -- @@ -2842,13 +2841,13 @@ Number of input documents to the operator. [%hardbreaks] *Example:* `187` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *#itemsOut* + _optional_ -a| +a¦ [markdown] -- @@ -2858,13 +2857,13 @@ Number of output documents after the operator processing. [%hardbreaks] *Example:* `16` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| +a¦ *#phaseSwitches* + _optional_ -a| +a¦ [markdown] -- @@ -2874,13 +2873,13 @@ Number of switches between executing, waiting for services, or waiting for the g [%hardbreaks] *Example:* `413` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#exec_time] +a¦ [#exec_time] *execTime* + _optional_ -a| +a¦ [markdown] -- @@ -2888,15 +2887,15 @@ Time spent executing the operator code inside SQL++ query engine. -- [%hardbreaks] -*Example:* `pass:c["128.434µs"]` +*Example:* `+++"128.434µs"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#kern_time] +a¦ [#kern_time] *kernTime* + _optional_ -a| +a¦ [markdown] -- @@ -2904,15 +2903,15 @@ Time spent waiting to be scheduled for CPU time. -- [%hardbreaks] -*Example:* `pass:c["15.027879ms"]` +*Example:* `+++"15.027879ms"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#serv_time] +a¦ [#serv_time] *servTime* + _optional_ -a| +a¦ [markdown] -- @@ -2925,9 +2924,9 @@ For fetch, it is time spent waiting on the KV store. -- [%hardbreaks] -*Example:* `pass:c["1.590934ms"]` +*Example:* `+++"1.590934ms"+++` {blank} -a| String (duration) +a¦ String (duration) |=== @@ -3009,3 +3008,4 @@ include::{specDir}security/document-end.adoc[opts=optional] include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index 33cf3a2f..8d58be83 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -58,7 +58,7 @@ The URL scheme. Use `https` for secure access. [%hardbreaks] *Values:* `http`, `https` -*Example:* `pass:c[http]` +*Example:* `+++http+++` // end a| *host* @@ -69,7 +69,7 @@ The host name or IP address of a node running the Query service. [%hardbreaks] -*Example:* `pass:c[localhost]` +*Example:* `+++localhost+++` // end a| *port* @@ -80,7 +80,7 @@ The Cluster administration REST port. Use `18091` for secure access. Note that [%hardbreaks] *Values:* `8091`, `18091` -*Example:* `pass:c[8091]` +*Example:* `+++8091+++` // end |=== @@ -174,6 +174,12 @@ Returns the cluster-level CURL access settings only. // markup not found, no include::{specDir}paths/get_access/operation-description-end.adoc[opts=optional] + + +[#get_access-produces] +.Produces +* application/json + :leveloffset: -1 @@ -191,12 +197,6 @@ Returns the cluster-level CURL access settings only. // markup not found, no include::{specDir}paths/get_access/operation-parameters-after.adoc[opts=optional] -[#get_access-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_access/operation-responses-before.adoc[opts=optional] @@ -318,6 +318,12 @@ Returns all cluster-level query settings, including the CURL access settings. // markup not found, no include::{specDir}paths/get_settings/operation-description-end.adoc[opts=optional] + + +[#get_settings-produces] +.Produces +* application/json + :leveloffset: -1 @@ -335,12 +341,6 @@ Returns all cluster-level query settings, including the CURL access settings. // markup not found, no include::{specDir}paths/get_settings/operation-parameters-after.adoc[opts=optional] -[#get_settings-produces] -= Produces - -* application/json - - // markup not found, no include::{specDir}paths/get_settings/operation-responses-before.adoc[opts=optional] @@ -462,6 +462,16 @@ Updates the cluster-level CURL access settings only. // markup not found, no include::{specDir}paths/post_access/operation-description-end.adoc[opts=optional] + +[#post_access-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#post_access-produces] +.Produces +* application/json + :leveloffset: -1 @@ -488,13 +498,13 @@ Updates the cluster-level CURL access settings only. .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _optional_ -a| +a¦ [markdown] @@ -505,7 +515,7 @@ An object determining which URLs may be accessed by the `CURL()` function. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -522,17 +532,6 @@ a| <> // markup not found, no include::{specDir}paths/post_access/operation-parameters-after.adoc[opts=optional] -[#post_access-produces] -= Produces - -* application/json - -[#post_access-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_access/operation-responses-before.adoc[opts=optional] @@ -662,6 +661,16 @@ Updates cluster-level query settings, including the CURL access settings. // markup not found, no include::{specDir}paths/post_settings/operation-description-end.adoc[opts=optional] + +[#post_settings-consumes] +.Consumes +* application/json +* application/x-www-form-urlencoded + +[#post_settings-produces] +.Produces +* application/json + :leveloffset: -1 @@ -688,13 +697,13 @@ Updates cluster-level query settings, including the CURL access settings. .Body Parameter {blank} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema -a| *Body* + +a¦ *Body* + _optional_ -a| +a¦ [markdown] @@ -705,7 +714,7 @@ An object specifying cluster-level query settings. [%hardbreaks] {blank} -a| <> +a¦ <> @@ -722,17 +731,6 @@ a| <> // markup not found, no include::{specDir}paths/post_settings/operation-parameters-after.adoc[opts=optional] -[#post_settings-produces] -= Produces - -* application/json - -[#post_settings-consumes] -= Consumes - -* application/json -* application/x-www-form-urlencoded - // markup not found, no include::{specDir}paths/post_settings/operation-responses-before.adoc[opts=optional] @@ -891,14 +889,14 @@ An object which determines which URLs may be accessed by the `CURL()` function. //end::desc-Access[] endif::model-descriptions[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| +a¦ *all_access* + _required_ -a| +a¦ [markdown] -- @@ -912,13 +910,13 @@ Setting this field to `true` enables access to all endpoints. [%hardbreaks] {blank} -a| Boolean +a¦ Boolean -a| +a¦ *allowed_urls* + _optional_ -a| +a¦ [markdown] -- @@ -935,13 +933,13 @@ Note that each URL must include the port, protocol, and all other components of [%hardbreaks] {blank} -a| String +a¦ String array -a| +a¦ *disallowed_urls* + _optional_ -a| +a¦ [markdown] -- @@ -957,7 +955,7 @@ Note that each URL must include the port, protocol, and all other components of [%hardbreaks] {blank} -a| String +a¦ String array |=== @@ -997,14 +995,14 @@ endif::collapse-models[] //tag::Settings[] -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema -a| [#queryCleanupClientAttempts] +a¦ [#queryCleanupClientAttempts] *queryCleanupClientAttempts* + _optional_ -a| +a¦ [markdown] -- @@ -1026,13 +1024,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#queryCleanupLostAttempts] +a¦ [#queryCleanupLostAttempts] *queryCleanupLostAttempts* + _optional_ -a| +a¦ [markdown] -- @@ -1054,13 +1052,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#queryCleanupWindow] +a¦ [#queryCleanupWindow] *queryCleanupWindow* + _optional_ -a| +a¦ [markdown] -- @@ -1092,16 +1090,16 @@ When you change the cluster-level setting, the node-level setting is over-writte -- [%hardbreaks] -*Default:* `pass:c["60s"]` -*Example:* `pass:c["30s"]` +*Default:* `+++"60s"+++` +*Example:* `+++"30s"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#queryCompletedLimit] +a¦ [#queryCompletedLimit] *queryCompletedLimit* + _optional_ -a| +a¦ [markdown] -- @@ -1129,13 +1127,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `4000` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryCompletedMaxPlanSize] +a¦ [#queryCompletedMaxPlanSize] *queryCompletedMaxPlanSize* + _optional_ -a| +a¦ [markdown] -- @@ -1167,13 +1165,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Minimum:* `0` *Maximum:* `20840448` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryCompletedThreshold] +a¦ [#queryCompletedThreshold] *queryCompletedThreshold* + _optional_ -a| +a¦ [markdown] -- @@ -1202,13 +1200,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `1000` *Example:* `7000` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryLogLevel] +a¦ [#queryLogLevel] *queryLogLevel* + _optional_ -a| +a¦ [markdown] -- @@ -1250,16 +1248,16 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] *Values:* `"DEBUG"`, `"TRACE"`, `"INFO"`, `"WARN"`, `"ERROR"`, `"SEVERE"`, `"NONE"` -*Default:* `pass:c["INFO"]` -*Example:* `pass:c["DEBUG"]` +*Default:* `+++"INFO"+++` +*Example:* `+++"DEBUG"+++` {blank} -a| String +a¦ String -a| [#queryMaxParallelism] +a¦ [#queryMaxParallelism] *queryMaxParallelism* + _optional_ -a| +a¦ [markdown] -- @@ -1298,13 +1296,13 @@ Refer to [Max Parallelism][max-parallelism] for more information. *Default:* `1` *Example:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryMemoryQuota] +a¦ [#queryMemoryQuota] *queryMemoryQuota* + _optional_ -a| +a¦ [markdown] -- @@ -1338,13 +1336,13 @@ If a request includes this parameter, it will be capped by the node-level `memor *Default:* `0` *Example:* `4` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryN1qlFeatCtrl] +a¦ [#queryN1qlFeatCtrl] *queryN1qlFeatCtrl* + _optional_ -a| +a¦ [markdown] -- @@ -1365,13 +1363,13 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryNodeQuota] +a¦ [#queryNodeQuota] *queryNodeQuota* + _optional_ -a| +a¦ [markdown] -- @@ -1398,13 +1396,13 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] *Default:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryNodeQuotaValPercent] +a¦ [#queryNodeQuotaValPercent] *queryNodeQuotaValPercent* + _optional_ -a| +a¦ [markdown] -- @@ -1430,13 +1428,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Minimum:* `0` *Maximum:* `100` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryNumAtrs] +a¦ [#queryNumAtrs] *queryNumAtrs* + _optional_ -a| +a¦ [markdown] -- @@ -1466,13 +1464,13 @@ If a request includes this parameter, it will be capped by the node-level `numat *Exclusive minimum:* `true` *Example:* `512` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryNumCpus] +a¦ [#queryNumCpus] *queryNumCpus* + _optional_ -a| +a¦ [markdown] -- @@ -1502,13 +1500,13 @@ When you change the cluster-level setting, the node-level setting is over-writte [%hardbreaks] *Default:* `0` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryPipelineBatch] +a¦ [#queryPipelineBatch] *queryPipelineBatch* + _optional_ -a| +a¦ [markdown] -- @@ -1535,13 +1533,13 @@ The minimum of that and the node-level `pipeline-batch` setting is applied. *Default:* `16` *Example:* `64` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryPipelineCap] +a¦ [#queryPipelineCap] *queryPipelineCap* + _optional_ -a| +a¦ [markdown] -- @@ -1568,13 +1566,13 @@ The minimum of that and the node-level `pipeline-cap` setting is applied. *Default:* `512` *Example:* `1024` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryPreparedLimit] +a¦ [#queryPreparedLimit] *queryPreparedLimit* + _optional_ -a| +a¦ [markdown] -- @@ -1597,13 +1595,13 @@ When you change the cluster-level setting, the node-level setting is over-writte *Default:* `16384` *Example:* `65536` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryScanCap] +a¦ [#queryScanCap] *queryScanCap* + _optional_ -a| +a¦ [markdown] -- @@ -1634,13 +1632,13 @@ The minimum of that and the node-level `scan-cap` setting is applied. *Default:* `512` *Example:* `1024` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryTimeout] +a¦ [#queryTimeout] *queryTimeout* + _optional_ -a| +a¦ [markdown] -- @@ -1673,13 +1671,13 @@ The minimum of that and the node-level `timeout` setting is applied. *Default:* `0` *Example:* `500000000` {blank} -a| Long (int64) +a¦ Long (int64) -a| [#queryTxTimeout] +a¦ [#queryTxTimeout] *queryTxTimeout* + _optional_ -a| +a¦ [markdown] -- @@ -1721,16 +1719,16 @@ If a request includes this parameter, it will be capped by the node-level `txtim -- [%hardbreaks] -*Default:* `pass:c["0ms"]` -*Example:* `pass:c["0.5s"]` +*Default:* `+++"0ms"+++` +*Example:* `+++"0.5s"+++` {blank} -a| String (duration) +a¦ String (duration) -a| [#queryTmpSpaceDir] +a¦ [#queryTmpSpaceDir] *queryTmpSpaceDir* + _optional_ -a| +a¦ [markdown] -- @@ -1744,15 +1742,15 @@ The default path is `var/lib/couchbase/tmp` within the Couchbase Server installa -- [%hardbreaks] -*Example:* `pass:c["/opt/couchbase/var/lib/couchbase/tmp"]` +*Example:* `+++"/opt/couchbase/var/lib/couchbase/tmp"+++` {blank} -a| String +a¦ String -a| [#queryTmpSpaceSize] +a¦ [#queryTmpSpaceSize] *queryTmpSpaceSize* + _optional_ -a| +a¦ [markdown] -- @@ -1769,13 +1767,13 @@ The maximum size is limited only by the available disk space. *Default:* `5120` *Example:* `2048` {blank} -a| Integer (int32) +a¦ Integer (int32) -a| [#queryUseCBO] +a¦ [#queryUseCBO] *queryUseCBO* + _optional_ -a| +a¦ [markdown] -- @@ -1802,13 +1800,13 @@ If a request does not include this parameter, the node-level setting is used, wh *Default:* `true` *Example:* `false` {blank} -a| Boolean +a¦ Boolean -a| [#queryUseReplica] +a¦ [#queryUseReplica] *queryUseReplica* + _optional_ -a| +a¦ [markdown] -- @@ -1849,16 +1847,16 @@ If a query uses sequential scan and a data node becomes unavailable, the query m [%hardbreaks] *Values:* `"off"`, `"on"`, `"unset"` -*Default:* `pass:c["unset"]` -*Example:* `pass:c["on"]` +*Default:* `+++"unset"+++` +*Example:* `+++"on"+++` {blank} -a| String +a¦ String -a| [#queryCurlWhitelist] +a¦ [#queryCurlWhitelist] *queryCurlWhitelist* + _optional_ -a| +a¦ [markdown] -- @@ -1867,7 +1865,7 @@ include::index.adoc[tag=desc-Access, opts=optional] [%hardbreaks] {blank} -a| <> +a¦ <> |=== @@ -1950,3 +1948,4 @@ include::{specDir}security/document-end.adoc[opts=optional] include::{specDir}security/document-after.adoc[opts=optional] + diff --git a/settings.gradle b/settings.gradle index 0783ca6c..1e580782 100644 --- a/settings.gradle +++ b/settings.gradle @@ -2,6 +2,7 @@ rootProject.name = 'cb-swagger' include 'admin', 'query-settings', 'query-service', + 'eventing', 'functions', 'indexes', 'analytics-admin', @@ -16,6 +17,8 @@ project(':query-settings').projectDir = new File (settingsDir, 'src/query-settin project(':query-settings').buildFileName = 'query-settings.gradle' project(':query-service').projectDir = new File (settingsDir, 'src/query-service') project(':query-service').buildFileName = 'query-service.gradle' +project(':eventing').projectDir = new File (settingsDir, 'src/eventing') +project(':eventing').buildFileName = 'eventing.gradle' project(':functions').projectDir = new File (settingsDir, 'src/functions') project(':functions').buildFileName = 'functions.gradle' project(':indexes').projectDir = new File (settingsDir, 'src/indexes') diff --git a/src/eventing/eventing.gradle b/src/eventing/eventing.gradle new file mode 100644 index 00000000..7d4d0f16 --- /dev/null +++ b/src/eventing/eventing.gradle @@ -0,0 +1,32 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/eventing.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/eventing-rest-api/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/eventing-rest-api/partials/", + snippetDir: "${rootDir}/docs/modules/eventing-rest-api/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true + modelNameMappings = [ + handler_schema: "Function Definition", + function_scope_schema: "Function Scope", + settings_schema: "Function Settings", + depcfg_schema: "Deployment Config", + depcfg_schema_buckets_inner: "Deployment Keyspace", + depcfg_schema_constants_inner: "Deployment Constants", + depcfg_schema_curl_inner: "Deployment URL" + ] +} \ No newline at end of file diff --git a/src/eventing/swagger/eventing.yaml b/src/eventing/swagger/eventing.yaml new file mode 100644 index 00000000..0a702e3d --- /dev/null +++ b/src/eventing/swagger/eventing.yaml @@ -0,0 +1,929 @@ +openapi: 3.0.3 +info: + title: Eventing REST API + version: '8.0' + description: |- + The Eventing REST API provides methods to work with and manipulate Couchbase Eventing functions. + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Eventing service. + port: + default: "8096" + description: |- + The Eventing service REST port. + Use `18096` for secure access. + enum: + - "8096" + - "18096" + +paths: + /api/v1/functions/{function}/deploy: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + post: + operationId: basic_deploy + summary: Deploy a Function + description: |- + Deploys an undeployed function. + This is the preferred invocation. + tags: + - activation + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + + /api/v1/functions/{function}/undeploy: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + post: + operationId: basic_undeploy + summary: Undeploy a Function + description: |- + Undeploys a function. + This is the preferred invocation. + tags: + - activation + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + + /api/v1/functions/{function}/pause: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + post: + operationId: basic_pause + summary: Pause a Function + description: |- + Pauses a function and creates a DCP checkpoint such that on a subsequent resume no mutations will be lost. + This is the preferred invocation. + tags: + - activation + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + + /api/v1/functions/(function}/resume: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + post: + operationId: basic_resume + summary: Resume a Function + description: |- + Resumes a paused function from its paused DCP checkpoint. + This is the preferred invocation. + tags: + - activation + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/functions/{function}: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + post: + operationId: adv_function_import + summary: Create or Import a Function + description: |- + Creates or imports a single function. + tags: + - advanced + requestBody: + required: true + description: |- + A single function definition object, or an array containing a single function definition object. + The function name in the definition object must match that given by the path parameter. + content: + application/json: + schema: + $ref: '#/components/schemas/AddFunction' + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + get: + operationId: adv_function_view + summary: View a Function + description: |- + Provides a listing of a complete function definition available in the cluster. + The function could be in any state: deployed, undeployed, or paused. + If saved to a file the function definition can be imported into the cluster or a different cluster. + However any changes to the function definition made to the file outside the UI are discouraged. + tags: + - advanced + security: + - Global: [] + - Scoped: [] + responses: + "200": + description: Returns a single function definition object. + content: + application/json: + schema: + $ref: "#/components/schemas/handler_schema" + "404": + $ref: '#/components/responses/Goof' + delete: + operationId: adv_function_zap + summary: Delete Function + description: |- + Deletes a specific function from the cluster. + + WARNING: Use this API with caution, as it is irreversible. + tags: + - advanced + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/functions: + post: + operationId: adv_function_import_all + summary: Create or Import Multiple Functions + description: |- + Creates or imports multiple functions. + + Note that if any function's `language_compatibility` field is missing, the value will be set to the highest version supported by the server, unlike [Import Multiple Functions](#adv_multiple_import). + tags: + - advanced + requestBody: + required: true + description: |- + A single function definition object, or an array containing one or more function definition objects. + + Function names must be unique. + When multiple functions have the same name, an error is reported. + content: + application/json: + schema: + $ref: '#/components/schemas/AddFunctions' + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + get: + operationId: adv_function_view_all + summary: View Multiple Functions + description: |- + Provides an array of definitions of all functions available in the cluster. + The functions may be in any state: deployed, undeployed, or paused. + If saved to a file the function definitions can be imported into the cluster or a different cluster. + However any changes to the function definition made to the file outside the UI are discouraged. + + If this API is run as a non-Administrator, the results are filtered via RBAC to include only the function scopes the user has access to. + tags: + - advanced + security: + - Unscoped: [] + responses: + "200": + description: Returns an array containing one or more function definition objects. + content: + application/json: + schema: + type: array + items: + $ref: "#/components/schemas/handler_schema" + "404": + $ref: '#/components/responses/Goof' + delete: + operationId: adv_function_zap_all + summary: Delete Multiple Functions + description: |- + Deletes **all functions** from the cluster. + WARNING: Use this API with caution, as it is irreversible. + + If this API is run as a non-Administrator the deleted set will be filtered via RBAC to include only the function scopes the user has access to. + tags: + - advanced + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/import: + post: + operationId: adv_multiple_import + summary: Import Multiple Functions + description: |- + Imports multiple functions. + + Note that if any function's `language_compatibility` field is missing, the value will be set to 6.0.0, unlike [Create or Import Multiple Functions](#adv_function_import_all). + tags: + - advanced + requestBody: + required: true + description: |- + A single function definition object, or an array containing one or more function definition objects. + + Function names must be unique. + When multiple functions have the same name, an error is reported. + content: + application/json: + schema: + $ref: '#/components/schemas/AddFunctions' + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/export: + get: + operationId: adv_multiple_export + summary: Export Multiple Functions + description: |- + This is a convenience method to export all function definitions. + Exported functions are always set to the undeployed state at the time of export, regardless of their state in the cluster. + If saved to a file the function definitions can be imported into the cluster or a different cluster. + However any changes to the function definition made to the file outside the UI are discouraged. + + If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. + tags: + - advanced + security: + - Unscoped: [] + responses: + "200": + description: Returns an array containing one or more function definition objects. + content: + application/json: + schema: + type: array + items: + $ref: "#/components/schemas/handler_schema" + "404": + $ref: '#/components/responses/Goof' + + /api/v1/functions/{function}/settings: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: adv_settings_get + summary: View Function Settings + description: |- + Return or export the full settings for one eventing function in the cluster. + The settings can be subsequently imported. + However any changes to the function settings made to the file outside the UI are discouraged. + tags: + - advanced + security: + - Global: [] + - Scoped: [] + responses: + "200": + description: Returns an object showing settings for the specified function. + content: + application/json: + schema: + $ref: "#/components/schemas/settings_schema" + "404": + $ref: '#/components/responses/Goof' + post: + operationId: adv_settings_update + summary: Update Function Settings + description: |- + Updates an undeployed or paused function with the provided settings. + You can only alter settings when the function is paused or undeployed; attempting to adjust a deployed function will result in an error. + During an edit, settings provided are merged. + Unspecified attributes retain their prior values. + + Note that you must always specify `deployment_status` and `processing_status` when using this REST endpoint to update any option or set of options. + To get the current values of `deployment_status` and `processing_status`, see [View All Functions Status](#status_all) or [View Function Status](#status_function). + + By adjusting `deployment_status` and `processing_status` this command can also deploy or resume a function; however, it cannot pause or undeploy a function. + tags: + - advanced + requestBody: + required: true + description: |- + An object providing settings for the specified function. + content: + application/json: + schema: + $ref: "#/components/schemas/settings_schema" + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/functions/{function}/config: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: adv_structure_get + summary: View Function Config + description: |- + Export or return the configuration of the source keyspace and the eventing storage (metadata) keyspace for the specified function. + The definition can be subsequently imported. + However any changes to the function definition made to the file outside the UI are discouraged. + tags: + - advanced + security: + - Global: [] + - Scoped: [] + responses: + "200": + description: Returns an object showing the configuration of the specified function. + content: + application/json: + schema: + $ref: '#/components/schemas/depcfg_schema' + + "404": + $ref: '#/components/responses/Goof' + post: + operationId: adv_structure_update + summary: Update Function Config + description: |- + Import the configuration and alter the source keyspace and the eventing storage (metadata) keyspace for the specified function. + You can only change these values if a function is in the undeployed state and the two keyspaces exist. + tags: + - advanced + requestBody: + required: true + description: |- + An object providing the configuration for the specified function. + content: + application/json: + schema: + $ref: '#/components/schemas/depcfg_schema' + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/functions/{function}/appcode: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: adv_text_get + summary: View Function Code + description: |- + Export only the JavaScript code for the specified function. + Note that unlike [View a Function](#adv_function_view), the JavaScript is not escaped, and the code is runnable in other environments. + The JavaScript code can be subsequently imported. + However any changes to the function definition made to the file outside the UI are discouraged. + tags: + - advanced + security: + - Global: [] + - Scoped: [] + responses: + "200": + description: Returns a string showing the code for the specified function. + content: + application/json: + schema: + $ref: "#/components/schemas/AppCode" + "404": + $ref: '#/components/responses/Goof' + post: + operationId: adv_text_update + summary: Update Function Code + description: |- + Import only the JavaScript code for the specified function. + Note that unlike [Create or Import Function](#adv_function_import), the JavaScript is not escaped and could come from other environments. + It is highly recommended that you use the flag `--data-binary` or `--upload-file` when importing your JavaScript appcode fragments to avoid potential encoding issues due to string escaping. + tags: + - advanced + requestBody: + required: true + description: A string providing the code for the specified function. + content: + application/json: + schema: + $ref: '#/components/schemas/AppCode' + + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/status: + get: + operationId: status_all + summary: View All Functions Status + description: |- + Returns a list (array) of all eventing functions, showing their corresponding `composite_status`. + A function's status can have one of the following values: undeployed, deploying, deployed, undeploying, paused, and pausing. + Note that there is no value of resuming; when resuming a paused eventing function, the `composite_status` returns `deploying` until it reaches the deployed state. + + If this API is run as a non-Administrator, the results are filtered via RBAC to include only the function scopes the user has access to. + tags: + - status + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/status/{function}: + parameters: + - $ref: "#/components/parameters/PathFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: status_function + summary: View Function Status + description: |- + Returns the specified function, showing its corresponding `composite_status`. + It can have one of the following values: undeployed, deploying, deployed, undeploying, paused, and pausing. + Note that there is no value of resuming; when resuming a paused eventing function, the `composite_status` returns `deploying` until it reaches the deployed state. + tags: + - status + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /getAppLog: + parameters: + - $ref: "#/components/parameters/QueryFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + - $ref: "#/components/parameters/QueryAggregate" + - $ref: "#/components/parameters/QuerySize" + get: + operationId: log_view + summary: Get Log for a Function + description: Returns the most recent application log messages for the specified function. + tags: + - logging + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/list/functions: + get: + operationId: list_all + summary: List All Functions + description: |- + Returns a list (array) of the names of all Eventing functions in the cluster. + The returned list can also be filtered — see [List Filtered Functions](#list_query). + + If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. + tags: + - list + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/list/functions/query: + get: + operationId: list_query + summary: List Filtered Functions + description: |- + Returns a list (array) of the names of all Eventing functions in the cluster. + The returned list can be filtered by the following: + + - Deployed status : in this case, paused is considered deployed. + - Source bucket: the listen to keyspace. + - Function type: whether the function modifies its own listen to keyspace. + + If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. + tags: + - list + parameters: + - name: deployed + schema: + type: boolean + default: false + in: query + required: false + description: |- + If `true`, returns the names of all deployed (or paused) functions. + If `false`, returns the names of all undeployed functions. + - name: source_bucket + schema: + type: string + in: query + required: false + description: |- + The name of a bucket. + Returns the names of Eventing functions in the cluster that have a source keyspace under the specified bucket. + - name: function_type + schema: + type: string + enum: + - sbm + - notsbm + in: query + required: false + description: |- + The function type. + + - `sbm`: Returns the names of Eventing functions in the cluster that modify their own source keyspace. + - `notsbm`: Returns the names of Eventing functions in the cluster that do not modify their own source keyspace. + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/config: + get: + operationId: config_get + summary: List Global Config + description: |- + Shows all global configuration settings. + There are currently just two settings: `enable_debugger` and `ram_quota`. + Both of these settings can also be adjusted via the UI. + tags: + - global config + security: + - Unscoped: [] + responses: + "200": + description: Returns an object showing the global configuration settings. + content: + application/json: + schema: + $ref: "#/components/schemas/UnivConfig" + "404": + $ref: '#/components/responses/Goof' + post: + operationId: config_update + summary: Modify Global Config + description: |- + Modify global configuration settings. + During an edit, settings provided are merged. + Unspecified attributes retain their prior values. + The response indicates whether the Eventing service must be restarted for the new changes to take effect. + tags: + - global config + requestBody: + required: true + description: An object providing the global configuration settings. + content: + application/json: + schema: + $ref: "#/components/schemas/UnivConfig" + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /api/v1/stats: + get: + operationId: stats_all + summary: Get All Statistics + description: |- + Retrieve all statistics for the node. + + + If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. + parameters: + - name: type + schema: + type: string + enum: + - full + in: query + required: false + description: |- + Including this parameter returns the full statistics set, inclusive of events processing, events remaining, execution, failure, latency, worker PIDs and sequence processed. + + Omitting this parameter excludes `dcp_event_backlog_per_vb`, `doc_timer_debug_stats`, `latency_stats`, `plasma_stats`, and `seqs_processed` from the response. + tags: + - statistics + security: + - Unscoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /getExecutionStats: + parameters: + - $ref: "#/components/parameters/QueryFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: stats_execution + summary: Get Execution Statistics + description: |- + Retrieve only execution statistics. + This returns the subset of statistics for the node. + tags: + - statistics + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /getLatencyStats: + parameters: + - $ref: "#/components/parameters/QueryFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: stats_latency + summary: Get Latency Statistics + description: |- + Retrieve only latency statistics. + This returns the subset of statistics for the node. + tags: + - statistics + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /getFailureStats: + parameters: + - $ref: "#/components/parameters/QueryFunction" + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + get: + operationId: stats_failure + summary: Get Failure Statistics + description: |- + Retrieve only failure statistics. + This returns the subset of statistics for the node. + tags: + - statistics + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + + /resetStatsCounters: + parameters: + - $ref: "#/components/parameters/QueryBucket" + - $ref: "#/components/parameters/QueryScope" + - name: appName + schema: + type: string + in: query + required: true + description: The name of a function. + get: + operationId: stats_reset + summary: Reset Statistics + description: Resets statistics for the specified function. + tags: + - statistics + security: + - Global: [] + - Scoped: [] + responses: + "200": + $ref: '#/components/responses/OK' + "404": + $ref: '#/components/responses/Goof' + +components: + parameters: + PathFunction: + name: function + schema: + type: string + in: path + required: true + description: The name of a function. + + QueryBucket: + name: bucket + schema: + type: string + in: query + required: false + description: |- + For scoped functions only. + The bucket to which the function belongs. + + QueryScope: + name: scope + schema: + type: string + in: query + required: false + description: |- + For scoped functions only. + The scope to which the function belongs. + + QueryFunction: + name: name + schema: + type: string + in: query + required: true + description: The name of a function. + + QueryAggregate: + name: aggregate + schema: + type: boolean + default: false + in: query + required: false + x-has-default: true + description: |- + If `false`, the API accesses a single Eventing node. + If `true`, the API accesses all Eventing nodes. + + QuerySize: + name: size + schema: + type: integer + default: 40960 + in: query + required: false + x-has-default: true + description: |- + The approximate amount of logging information returned. + Note that when fetching from more than one Eventing node, the amount of logging information returned from each node is the `size` divided by the number of nodes. + + schemas: + settings_schema: + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/settings_schema.json' + + depcfg_schema: + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/depcfg_schema.json' + + handler_schema: + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/handler_schema.json' + + AppCode: + type: string + example: function OnUpdate(doc, meta) { log("id",meta.id); } + x-has-example: true + + AddFunction: + title: Function Request + oneOf: + - $ref: "#/components/schemas/handler_schema" + - type: array + description: An array containing a single function definition object. + minItems: 1 + maxItems: 1 + items: + $ref: "#/components/schemas/handler_schema" + + AddFunctions: + title: Functions Request + oneOf: + - $ref: "#/components/schemas/handler_schema" + - type: array + description: An array containing one or more function definition objects. + minItems: 1 + items: + $ref: "#/components/schemas/handler_schema" + + UnivConfig: + title: Global Config + type: object + properties: + ram_quota: + type: integer + default: 256 + example: 512 + x-has-example: true + x-has-default: true + description: The memory allocation for the Eventing Service, per node. + enable_debugger: + type: boolean + default: false + x-has-default: true + description: |- + Enables the Eventing service debugger. + For details, see [Debugging and Diagnosability](/server/8.0/eventing/eventing-debugging-and-diagnosability.html). + + responses: + OK: + description: Success. + + Goof: + description: Failure. + + securitySchemes: + Global: + type: http + scheme: basic + description: |- + Global functions with a function scope of ``*.*`` can only be made or managed by users with the Full Admin or Eventing Full Admin role. + For global functions, you do not need to pass the `bucket` and `scope` query parameters to specify the function scope. + The credentials must be an administrator username and password. + + Note that this is the default function scope for all functions after an upgrade from a prior version. + + Scoped: + type: http + scheme: basic + description: |- + For scoped functions, you must pass the `bucket` and `scope` query parameters to specify the function scope. + The credentials are the username and password of any authorized user. + + You can quote the REST call on the command line to escape the `&` and `?` characters. + + Unscoped: + type: http + scheme: basic + description: |- + Unscoped REST API calls do not require you to specify the function scope. + The action is fully determined by the username and password credentials passed to the REST call. diff --git a/templates/index.mustache b/templates/index.mustache index 03b00b9d..46937009 100644 --- a/templates/index.mustache +++ b/templates/index.mustache @@ -74,7 +74,7 @@ a| [markdown] {{! enumerated values}} {{#enumValues}}{{#-first}}*Values:* {{/-first}}{{^-last}}`{{this}}`, {{/-last}}{{#-last}}`{{this}}`{{/-last}}{{/enumValues}} {{! example }} -{{#value}}*Example:* `pass:c[{{this}}]`{{/value}} +{{#value}}*Example:* `+++{{this}}+++`{{/value}} // end {{#-last}} @@ -198,6 +198,25 @@ CAUTION: This operation is deprecated, and will be removed in a future release. {{! include partials after operation description body }} {{#specinclude}}/paths/{{operationIdOriginal}}/operation-description-end.adoc{{/specinclude}} + +{{! *** OPERATION CONSUMES *** }} +{{#hasConsumes}} +[#{{operationIdOriginal}}-consumes] +.Consumes +{{#consumes}} +* {{{mediaType}}} +{{/consumes}} +{{/hasConsumes}} + +{{! *** OPERATION PRODUCES *** }} +{{#hasProduces}} +[#{{operationIdOriginal}}-produces] +.Produces +{{#produces}} +* {{{mediaType}}} +{{/produces}} +{{/hasProduces}} + :leveloffset: -1 {{! include partial after operation description }} @@ -230,26 +249,6 @@ CAUTION: This operation is deprecated, and will be removed in a future release. {{! include partials after the operation parameters }} {{#specinclude}}/paths/{{operationIdOriginal}}/operation-parameters-after.adoc{{/specinclude}} -{{! *** OPERATION PRODUCES *** }} -{{#hasProduces}} -[#{{operationIdOriginal}}-produces] -= Produces - -{{#produces}} -* {{{mediaType}}} -{{/produces}} -{{/hasProduces}} - -{{! *** OPERATION CONSUMES *** }} -{{#hasConsumes}} -[#{{operationIdOriginal}}-consumes] -= Consumes - -{{#consumes}} -* {{{mediaType}}} -{{/consumes}} -{{/hasConsumes}} - {{! *** OPERATION RESPONSES *** }} {{! include partial before operation responses }} {{#specinclude}}/paths/{{operationIdOriginal}}/operation-responses-before.adoc{{/specinclude}} @@ -458,3 +457,11 @@ __Key in__ : {{#isKeyInQuery}}query{{/isKeyInQuery}} {{#isKeyInHeader}}header{{/ {{! include partial after security }} {{#specinclude}}/security/document-after.adoc{{/specinclude}} + +{{! *** EXTERNAL DOCS *** }} +{{#externalDocs}} +[[see-also]] += See Also + +* link:{{url}}[{{description}}] +{{/externalDocs}} diff --git a/templates/model.mustache b/templates/model.mustache index c494d6ea..3f453e4d 100644 --- a/templates/model.mustache +++ b/templates/model.mustache @@ -13,29 +13,29 @@ ifdef::model-descriptions[] endif::model-descriptions[] {{/description}} -[cols="25,55,20"] +[cols="25,55,20",separator=¦] |=== -| Property | | Schema +¦ Property ¦ ¦ Schema {{#vars}} {{! DEFINITION NAME }} -a| {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}}{{/vendorExtensions}} +a¦ {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}}{{/vendorExtensions}} *{{baseName}}* + _{{#required}}required{{/required}}{{^required}}optional{{/required}}_ {{! DEFINITION DESCRIPTION }} -a| {{>property}} +a¦ {{>property}} {{! DEFINITION SCHEMA }} -a| {{>schemas}} +a¦ {{>schemas}} {{/vars}} {{#additionalProperties}} {{! ADDITIONAL PROPERTY NAME }} -a| {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}}{{/vendorExtensions}} +a¦ {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}}{{/vendorExtensions}} _additional + property_ {{! ADDITIONAL PROPERTY DESCRIPTION }} -a| {{>property}} +a¦ {{>property}} {{! ADDITIONAL PROPERTY SCHEMA }} -a| {{>schemas}} +a¦ {{>schemas}} {{/additionalProperties}} |=== diff --git a/templates/param.mustache b/templates/param.mustache index 9715261c..3e0a6319 100644 --- a/templates/param.mustache +++ b/templates/param.mustache @@ -1,6 +1,6 @@ -a| *{{#isBodyParam}}Body{{/isBodyParam}}{{^isBodyParam}}{{baseName}}{{/isBodyParam}}* + +a¦ *{{#isBodyParam}}Body{{/isBodyParam}}{{^isBodyParam}}{{baseName}}{{/isBodyParam}}* + _{{#required}}required{{/required}}{{^required}}optional{{/required}}_ -a| {{#vendorExtensions}} +a¦ {{#vendorExtensions}} {{#x-desc-edition}}[.edition]##{{this}}##{{/x-desc-edition}}{{#x-desc-status}}[.status]##{{this}}##{{/x-desc-status}} {{/vendorExtensions}} @@ -25,11 +25,11 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{/allowableValues}} {{! default value}} {{#vendorExtensions.x-has-default}} -*Default:* `{{#isString}}pass:c["{{/isString}}{{{defaultValue}}}{{#isString}}"]{{/isString}}` +*Default:* `{{#isString}}+++"{{/isString}}{{{defaultValue}}}{{#isString}}"+++{{/isString}}` {{/vendorExtensions.x-has-default}} {{! pattern}} {{#pattern}} -*Pattern:* `pass:c[{{{pattern}}}]` +*Pattern:* `+++{{{pattern}}}+++` {{/pattern}} {{! minimum value}} {{#minimum}} @@ -74,9 +74,9 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{! example -- deprecated}} {{#isBodyParam}} {{#vendorExtensions.x-has-example}} -*Example:* `{{#isString}}pass:c["{{/isString}}{{{example}}}{{#isString}}"]{{/isString}}` +*Example:* `{{#isString}}+++"{{/isString}}{{{example}}}{{#isString}}"+++{{/isString}}` {{/vendorExtensions.x-has-example}} {{/isBodyParam}} {blank} -a| {{>schemas}} +a¦ {{>schemas}} diff --git a/templates/params.mustache b/templates/params.mustache index 56aadcb7..5b75171e 100644 --- a/templates/params.mustache +++ b/templates/params.mustache @@ -16,9 +16,9 @@ {blank} {{/useTableTitles}} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema {{#pathParams}} {{>param}} @@ -36,9 +36,9 @@ {blank} {{/useTableTitles}} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema {{#queryParams}} {{>param}} @@ -56,9 +56,9 @@ {blank} {{/useTableTitles}} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema {{#headerParams}} {{>param}} @@ -76,9 +76,9 @@ {blank} {{/useTableTitles}} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema {{#formParams}} {{>param}} @@ -96,9 +96,9 @@ {blank} {{/useTableTitles}} -[cols="20,60,20"] +[cols="20,60,20",separator=¦] |=== -|Name| Description| Schema +¦ Name ¦ Description ¦ Schema {{#bodyParams}} {{>param}} diff --git a/templates/property.mustache b/templates/property.mustache index 38b0c935..f4f1cfa6 100644 --- a/templates/property.mustache +++ b/templates/property.mustache @@ -30,11 +30,11 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{/isEnum}} {{! default value}} {{#vendorExtensions.x-has-default}} -*Default:* `{{#isString}}pass:c["{{/isString}}{{{defaultValue}}}{{#isString}}"]{{/isString}}` +*Default:* `{{#isString}}+++"{{/isString}}{{{defaultValue}}}{{#isString}}"+++{{/isString}}` {{/vendorExtensions.x-has-default}} {{! pattern}} {{#pattern}} -*Pattern:* `pass:c[{{{pattern}}}]` +*Pattern:* `+++{{{pattern}}}+++` {{/pattern}} {{! minimum value}} {{#minimum}} @@ -78,6 +78,6 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{/uniqueItems}} {{! example -- deprecated}} {{#vendorExtensions.x-has-example}} -*Example:* `{{#isString}}pass:c["{{/isString}}{{{example}}}{{#isString}}"]{{/isString}}` +*Example:* `{{#isString}}+++"{{/isString}}{{{example}}}{{#isString}}"+++{{/isString}}` {{/vendorExtensions.x-has-example}} {blank} \ No newline at end of file From f2c891faabafd5337a5e7ddebff3ebc26b08df35 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Mon, 2 Dec 2024 13:48:03 +0000 Subject: [PATCH 05/25] DOC-12776: Downgrade eventing spec to 7.6.3 (#161) --- .../eventing-rest-api/pages/index.adoc | 152 ------------------ src/eventing/swagger/eventing.yaml | 6 +- 2 files changed, 3 insertions(+), 155 deletions(-) diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index 88590463..3bba2743 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -7846,38 +7846,6 @@ maximum time the handler can run before it is forcefully terminated (in seconds) a¦ Integer -a¦ -*cursor_checkpoint_timeout* + -_optional_ -a¦ - -[markdown] --- -maximum time the to checkpoint writer can run before it is forcefully terminated (in seconds) --- - -[%hardbreaks] -*Minimum:* `1` -{blank} -a¦ Integer - - -a¦ -*on_deploy_timeout* + -_optional_ -a¦ - -[markdown] --- -maximum time the OnDeploy handler can run before it is terminated (in seconds) --- - -[%hardbreaks] -*Minimum:* `1` -{blank} -a¦ Integer - - a¦ *language_compatibility* + _optional_ @@ -8255,126 +8223,6 @@ maximum allowable curl call response in 'MegaBytes'. Setting the value to 0 lift a¦ Integer -a¦ -*allow_transaction_mutations* + -_optional_ -a¦ - -[markdown] --- -allow staged transaction mutations --- - -[%hardbreaks] -{blank} -a¦ Boolean - - -a¦ -*allow_sync_documents* + -_optional_ -a¦ - -[markdown] --- -allow sync gateway mutations --- - -[%hardbreaks] -{blank} -a¦ Boolean - - -a¦ -*cursor_aware* + -_optional_ -a¦ - -[markdown] --- -syncgateway aware function --- - -[%hardbreaks] -{blank} -a¦ Boolean - - -a¦ -*high_seq_check_interval* + -_optional_ -a¦ - -[markdown] --- -number of milliseconds before checking for high seq number --- - -[%hardbreaks] -{blank} -a¦ Integer - - -a¦ -*max_unacked_bytes* + -_optional_ -a¦ - -[markdown] --- -max MBs to wait to send more bytes to c++ side --- - -[%hardbreaks] -{blank} -a¦ Integer - - -a¦ -*max_unacked_count* + -_optional_ -a¦ - -[markdown] --- -max number of messages on c++ side --- - -[%hardbreaks] -{blank} -a¦ Integer - - -a¦ -*message_flush_time* + -_optional_ -a¦ - -[markdown] --- -number of milliseconds before sending message to c++ side --- - -[%hardbreaks] -{blank} -a¦ Integer - - -a¦ -*max_parallel_vb* + -_optional_ -a¦ - -[markdown] --- -number of parallel vb request per cpp thread --- - -[%hardbreaks] -{blank} -a¦ Integer - - |=== //end::settings_schema[] diff --git a/src/eventing/swagger/eventing.yaml b/src/eventing/swagger/eventing.yaml index 0a702e3d..091b022f 100644 --- a/src/eventing/swagger/eventing.yaml +++ b/src/eventing/swagger/eventing.yaml @@ -841,13 +841,13 @@ components: schemas: settings_schema: - $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/settings_schema.json' + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/7.6.3/parser/settings_schema.json' depcfg_schema: - $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/depcfg_schema.json' + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/7.6.3/parser/depcfg_schema.json' handler_schema: - $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/handler_schema.json' + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/7.6.3/parser/handler_schema.json' AppCode: type: string From ce48be2bde3bc1437a6b167ee987575cbf39b47f Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Sun, 8 Dec 2024 00:34:58 +0000 Subject: [PATCH 06/25] DOC-12777: Update Eventing REST API with sync-gateway-aware options (#163) * Update eventing schemas to master * Add examples for Sync Gateway compatibility * Updates after review: add overlay for new settings * Updates after review: update Gradle to normalize spec and apply overlay * Updates after review: add cursor limit * Rebuild output documentation --- .../eventing-rest-api/pages/index.adoc | 189 +++++++++++++++++- .../adv_settings_update/http-request.adoc | 38 ++++ .../paths/config_update/http-request.adoc | 10 + src/eventing/eventing.gradle | 30 ++- src/eventing/swagger/eventing.yaml | 21 +- src/eventing/swagger/overlay.json | 27 +++ 6 files changed, 306 insertions(+), 9 deletions(-) create mode 100644 src/eventing/swagger/overlay.json diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index 3bba2743..56834674 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -4276,8 +4276,7 @@ GET /api/v1/config [markdown] -- Shows all global configuration settings. -There are currently just two settings: `enable_debugger` and `ram_quota`. -Both of these settings can also be adjusted via the UI. +Note that the `enable_debugger` and `ram_quota` settings can also be adjusted via the UI. -- @@ -7846,6 +7845,38 @@ maximum time the handler can run before it is forcefully terminated (in seconds) a¦ Integer +a¦ +*cursor_checkpoint_timeout* + +_optional_ +a¦ + +[markdown] +-- +The maximum time the checkpoint writer can run before it is forcefully terminated (in seconds). +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + +a¦ +*on_deploy_timeout* + +_optional_ +a¦ + +[markdown] +-- +maximum time the OnDeploy handler can run before it is terminated (in seconds) +-- + +[%hardbreaks] +*Minimum:* `1` +{blank} +a¦ Integer + + a¦ *language_compatibility* + _optional_ @@ -8223,6 +8254,138 @@ maximum allowable curl call response in 'MegaBytes'. Setting the value to 0 lift a¦ Integer +a¦ +*allow_transaction_mutations* + +_optional_ +a¦ + +[markdown] +-- +allow staged transaction mutations +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*allow_sync_documents* + +_optional_ +a¦ + +[markdown] +-- +Specifies whether the function allows Sync Gateway mutations. + +* By default, this setting is `true`, for compatibility with previous versions of Couchbase Server. + +* When this setting is `false`, the specified function skips all internal Sync Gateway documents, whose IDs are prefixed with `_sync`. +This enables the function to work with Sync Gateway. + +You must ensure that none of the documents which contain your own working data have IDs which are prefixed with `_sync`. +(Note that internal Sync Gateway attachment documents, whose IDs are prefixed with `_sync:att`, are still processed by the specified function.) +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*cursor_aware* + +_optional_ +a¦ + +[markdown] +-- +Specifies whether the function suppresses potential duplicate mutations caused by App Services or Sync Gateway book-keeping. + +Enabling this setting guarantees that the Eventing function will only trigger once for any given mutation received from App Services or Sync Gateway. + +Note that enabling this setting may have a noticeable impact on the performance of the Eventing function. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*high_seq_check_interval* + +_optional_ +a¦ + +[markdown] +-- +number of milliseconds before checking for high seq number +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*max_unacked_bytes* + +_optional_ +a¦ + +[markdown] +-- +max MBs to wait to send more bytes to c++ side +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*max_unacked_count* + +_optional_ +a¦ + +[markdown] +-- +max number of messages on c++ side +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*message_flush_time* + +_optional_ +a¦ + +[markdown] +-- +number of milliseconds before sending message to c++ side +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*max_parallel_vb* + +_optional_ +a¦ + +[markdown] +-- +number of parallel vb request per cpp thread +-- + +[%hardbreaks] +{blank} +a¦ Integer + + |=== //end::settings_schema[] @@ -8298,6 +8461,28 @@ For details, see [Debugging and Diagnosability](/server/8.0/eventing/eventing-de a¦ Boolean +a¦ +*cursor_limit* + +_optional_ +a¦ + +[markdown] +-- +The maximum number of cursor-aware Eventing functions that can coexist on a given source keyspace. (A cursor-aware Eventing function is one for which the `cursor_aware` setting is `true`.) + +Increasing this setting enables more cursor-aware Eventing functions to register and listen to any given collection. + +Decreasing this setting prevents further cursor-aware Eventing functions from being registered on any given collection; however, it doesn't unregister already registered cursor-aware Eventing functions. +-- + +[%hardbreaks] +*Default:* `5` +*Minimum:* `1` +*Maximum:* `20` +{blank} +a¦ Integer + + |=== //end::UnivConfig[] diff --git a/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc index 72823de4..a6eff959 100644 --- a/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc +++ b/docs/modules/eventing-rest-api/partials/paths/adv_settings_update/http-request.adoc @@ -128,6 +128,44 @@ curl -XPOST -d '{ ---- ==== +[#ex-sync-gateway-global] +.Enable Sync Gateway compatibility for a global function +==== +This example sets `allow_sync_documents` to `false`, to enable compatibility with Sync Gateway. +The function is currently paused. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": false, + "allow_sync_documents": false +}' "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings" +---- + +For details, see xref:sync-gateway::server-compatibility-eventing.adoc[]. +==== + +[#ex-sync-gateway-scoped] +.Enable Sync Gateway compatibility for a scoped function +==== +This example sets `allow_sync_documents` to `false`, to enable compatibility with Sync Gateway. +The function is currently paused. + +.Curl request +[source,sh] +---- +curl -XPOST -d '{ + "deployment_status": true, + "processing_status": false, + "allow_sync_documents": false +}' "http://$USER:$PASSWORD@$HOST:8096/api/v1/functions/my_function/settings?bucket=bulk&scope=data" +---- + +For details, see xref:sync-gateway::server-compatibility-eventing.adoc[]. +==== + .Deploy an undeployed global function -- deprecated ==== .Curl request diff --git a/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc index 9e5b603d..b81c303d 100644 --- a/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc +++ b/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc @@ -20,6 +20,16 @@ curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" \ ---- ==== +.Set cursor limit +==== +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" \ + -d '{"cursor_limit": 10}' +---- +==== + .Allow interbucket recursion ==== This example disables the safety checks that prevent basic infinite recursive Eventing functions. diff --git a/src/eventing/eventing.gradle b/src/eventing/eventing.gradle index 7d4d0f16..7485829a 100644 --- a/src/eventing/eventing.gradle +++ b/src/eventing/eventing.gradle @@ -1,8 +1,31 @@ +plugins { + id("io.datapith.jayOverlay").version("0.1.11") +} + +jayOverlay { + targetFile.set("${projectDir}/build/bundle/eventing.yaml") + overlayFile.set("${projectDir}/swagger/overlay.json") + outputDir.set("${projectDir}/build/overlay") +} + apply plugin: 'org.openapi.generator' +task bundleSpec(type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask) { + generatorName = "openapi-yaml" + inputSpec = file("swagger/eventing.yaml").getAbsolutePath().toString() + outputDir = "${projectDir}/build/bundle" + globalProperties = [ + generateAliasAsModel: "true" + ] + additionalProperties = [ + outputFile: "eventing.yaml", + ] + generateAliasAsModel = true +} + openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/eventing.yaml").getAbsolutePath().toString() + inputSpec = file("build/overlay/eventing.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/eventing-rest-api/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" @@ -29,4 +52,7 @@ openApiGenerate { depcfg_schema_constants_inner: "Deployment Constants", depcfg_schema_curl_inner: "Deployment URL" ] -} \ No newline at end of file +} + +tasks.applyOverlay.dependsOn(bundleSpec) +tasks.openApiGenerate.dependsOn(applyOverlay) diff --git a/src/eventing/swagger/eventing.yaml b/src/eventing/swagger/eventing.yaml index 091b022f..fcb34d32 100644 --- a/src/eventing/swagger/eventing.yaml +++ b/src/eventing/swagger/eventing.yaml @@ -615,8 +615,7 @@ paths: summary: List Global Config description: |- Shows all global configuration settings. - There are currently just two settings: `enable_debugger` and `ram_quota`. - Both of these settings can also be adjusted via the UI. + Note that the `enable_debugger` and `ram_quota` settings can also be adjusted via the UI. tags: - global config security: @@ -841,13 +840,13 @@ components: schemas: settings_schema: - $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/7.6.3/parser/settings_schema.json' + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/settings_schema.json' depcfg_schema: - $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/7.6.3/parser/depcfg_schema.json' + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/depcfg_schema.json' handler_schema: - $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/7.6.3/parser/handler_schema.json' + $ref: 'https://raw.githubusercontent.com/couchbase/eventing/refs/heads/master/parser/handler_schema.json' AppCode: type: string @@ -893,6 +892,18 @@ components: description: |- Enables the Eventing service debugger. For details, see [Debugging and Diagnosability](/server/8.0/eventing/eventing-debugging-and-diagnosability.html). + cursor_limit: + type: integer + default: 5 + maximum: 20 + minimum: 1 + x-has-default: true + description: |- + The maximum number of cursor-aware Eventing functions that can coexist on a given source keyspace. (A cursor-aware Eventing function is one for which the `cursor_aware` setting is `true`.) + + Increasing this setting enables more cursor-aware Eventing functions to register and listen to any given collection. + + Decreasing this setting prevents further cursor-aware Eventing functions from being registered on any given collection; however, it doesn't unregister already registered cursor-aware Eventing functions. responses: OK: diff --git a/src/eventing/swagger/overlay.json b/src/eventing/swagger/overlay.json new file mode 100644 index 00000000..0882e766 --- /dev/null +++ b/src/eventing/swagger/overlay.json @@ -0,0 +1,27 @@ +{ + "overlay": "1.0.0", + "info": { + "title": "Overlay for Eventing Settings Schema", + "version": 1.0 + }, + "actions": [ + { + "target": "components.schemas.settings_schema.properties.allow_sync_documents", + "update": { + "description": "Specifies whether the function allows Sync Gateway mutations.\n\n* By default, this setting is `true`, for compatibility with previous versions of Couchbase Server.\n\n* When this setting is `false`, the specified function skips all internal Sync Gateway documents, whose IDs are prefixed with `_sync`.\nThis enables the function to work with Sync Gateway.\n\nYou must ensure that none of the documents which contain your own working data have IDs which are prefixed with `_sync`.\n(Note that internal Sync Gateway attachment documents, whose IDs are prefixed with `_sync:att`, are still processed by the specified function.)" + } + }, + { + "target": "components.schemas.settings_schema.properties.cursor_aware", + "update": { + "description": "Specifies whether the function suppresses potential duplicate mutations caused by App Services or Sync Gateway book-keeping.\n\nEnabling this setting guarantees that the Eventing function will only trigger once for any given mutation received from App Services or Sync Gateway.\n\nNote that enabling this setting may have a noticeable impact on the performance of the Eventing function." + } + }, + { + "target": "components.schemas.settings_schema.properties.cursor_checkpoint_timeout", + "update": { + "description": "The maximum time the checkpoint writer can run before it is forcefully terminated (in seconds)." + } + } + ] +} \ No newline at end of file From d700adc61951a1e7212cd77c1e4a58a56958d28f Mon Sep 17 00:00:00 2001 From: Simon Dew Date: Tue, 19 Aug 2025 22:14:13 +0100 Subject: [PATCH 07/25] DOC-13120: Convert Search REST APIs to OpenAPI (#165) * Add Search Gradle files * Import Search specs * Add deprecation notice snippets * Add header attributes * Add CSS passthroughs * Add security partials * Externalize examples * Migrate examples from docs-server * Improve parameter descriptions and examples * Move nsstats for index into the Stats spec * Update description of partition APIs * Standardize API versions * Explain parameters in examples * Build output docs --- build.gradle | 6 + .../analytics-rest-admin/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- .../partials/security/document-end.adoc | 2 +- .../analytics-rest-config/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- .../partials/security/document-end.adoc | 2 +- .../analytics-rest-library/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- .../partials/security/document-end.adoc | 2 +- .../analytics-rest-links/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- .../partials/security/document-end.adoc | 2 +- .../analytics-rest-service/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- .../partials/security/document-end.adoc | 2 +- .../analytics-rest-settings/pages/index.adoc | 2 +- .../partials/security/document-begin.adoc | 2 +- .../partials/security/document-end.adoc | 2 +- .../eventing-rest-api/pages/index.adoc | 4 +- .../partials/overview/document-end.adoc | 2 +- .../partials/security/document-begin.adoc | 2 +- .../examples/get-partition.json | 18 + .../fts-rest-advanced/pages/index.adoc | 2029 +++++ .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 57 + .../paths/getPartition/http-response.adoc | 9 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../examples/d-api-index-name-200.json | 4 + .../examples/d-api-index-name-default.json | 5 + .../examples/d-api-scoped-index-name-200.json | 4 + .../d-api-scoped-index-name-default.json | 5 + .../fts-sample-index-def-response.json | 167 + ...sample-success-response-vector-search.json | 55 + .../examples/fts-sample-success-response.json | 261 + .../examples/g-api-index-name-count.json | 4 + .../examples/g-api-index-name.json | 43 + .../examples/g-api-index.json | 26 + .../examples/g-api-scoped-indexes.json | 118 + .../examples/g-api-scoped-status.json | 4 + ...g-api-stats-index-name-analyzeDoc-200.json | 118 + ...-api-stats-index-name-analyzeDoc-body.json | 4 + .../examples/g-api-stats-index-name.json | 159 + .../examples/g-api-stats.json | 41 + .../examples/p-api-index-name-200.json | 5 + .../examples/p-api-index-name-default.json | 5 + .../p-api-index-name-query-hybrid.json | 18 + .../p-api-index-name-query-options.json | 29 + .../p-api-index-name-query-regular.json | 12 + .../examples/p-api-pindex-lookup-200.json | 8 + .../examples/p-api-pindex-lookup-body.json | 3 + .../examples/p-api-scoped-index-name-200.json | 5 + .../p-api-scoped-index-name-default.json | 5 + .../examples/p-api-scoped-query-default.json | 49 + .../examples/response-200.json | 3 + .../fts-rest-indexing/pages/index.adoc | 8085 +++++++++++++++++ .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 57 + .../paths/d-api-index-name/http-response.adoc | 17 + .../operation-description-end.adoc | 2 + .../http-response.adoc | 17 + .../g-api-index-name-count/http-response.adoc | 9 + .../paths/g-api-index-name/http-response.adoc | 9 + .../operation-description-end.adoc | 2 + .../paths/g-api-index/http-response.adoc | 9 + .../operation-description-end.adoc | 2 + .../http-response.adoc | 9 + .../g-api-scoped-indexes/http-response.adoc | 9 + .../g-api-scoped-status/http-response.adoc | 9 + .../http-request.adoc | 9 + .../http-response.adoc | 15 + .../g-api-stats-index-name/http-response.adoc | 9 + .../paths/g-api-stats/http-response.adoc | 9 + .../http-response.adoc | 9 + .../operation-description-end.adoc | 2 + .../http-response.adoc | 9 + .../operation-description-end.adoc | 2 + .../http-response.adoc | 9 + .../operation-description-end.adoc | 2 + .../p-api-index-name-query/http-request.adoc | 31 + .../operation-description-end.adoc | 2 + .../operation-responses-after.adoc | 18 + .../paths/p-api-index-name/http-response.adoc | 17 + .../operation-description-end.adoc | 2 + .../p-api-pindex-lookup/http-request.adoc | 8 + .../p-api-pindex-lookup/http-response.adoc | 9 + .../http-response.adoc | 17 + .../http-response.adoc | 9 + .../http-response.adoc | 9 + .../p-api-scoped-query/http-response.adoc | 25 + .../http-response.adoc | 9 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../examples/file-xfer-200.json | 3 + .../examples/file-xfer-405.json | 4 + .../examples/file-xfer-disable.sh | 4 + .../examples/file-xfer-enable.sh | 4 + docs/modules/fts-rest-manage/pages/index.adoc | 581 ++ .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 57 + .../partials/overview/document-end.adoc | 8 + .../paths/put_options/http-request.adoc | 25 + .../paths/put_options/http-response.adoc | 17 + .../operation-description-end.adoc | 8 + .../partials/security/document-after.adoc | 7 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../examples/get-cluster-config.json | 93 + .../fts-rest-nodes/examples/get-logs.json | 4 + .../examples/get-runtime-info.json | 13 + docs/modules/fts-rest-nodes/pages/index.adoc | 4329 +++++++++ .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 86 + .../paths/getClusterConfig/http-response.adoc | 9 + .../partials/paths/getLogs/http-response.adoc | 9 + .../paths/getRuntimeInfo/http-response.adoc | 9 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../examples/api-query-all.json | 61 + .../fts-rest-query/examples/api-query-all.sh | 3 + .../examples/api-query-cancel.json | 4 + .../examples/api-query-cancel.sh | 3 + .../examples/api-query-filter.json | 26 + .../examples/api-query-filter.sh | 3 + .../examples/api-query-index.json | 39 + .../examples/api-query-index.sh | 3 + docs/modules/fts-rest-query/pages/index.adoc | 1539 ++++ .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 57 + .../partials/overview/document-end.adoc | 8 + .../paths/api-query-cancel/http-request.adoc | 11 + .../paths/api-query-cancel/http-response.adoc | 11 + .../paths/api-query-index/http-request.adoc | 12 + .../paths/api-query-index/http-response.adoc | 11 + .../paths/api-query/http-request.adoc | 23 + .../paths/api-query/http-response.adoc | 21 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../examples/g-api-nsstats-200.json | 164 + .../examples/g-api-nsstats-403.json | 6 + .../examples/g-api-nsstats-index-name.json | 57 + docs/modules/fts-rest-stats/pages/index.adoc | 2646 ++++++ .../partials/header-attributes.adoc | 4 + .../partials/overview/document-before.adoc | 57 + .../http-response.adoc | 9 + .../paths/g-api-nsstats/http-response.adoc | 21 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../modules/index-rest-stats/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- docs/modules/n1ql-rest-admin/pages/index.adoc | 8 +- .../n1ql-rest-functions/pages/index.adoc | 4 +- .../partials/security/document-begin.adoc | 2 +- docs/modules/n1ql-rest-query/pages/index.adoc | 12 +- .../n1ql-rest-settings/pages/index.adoc | 2 +- .../partials/security/document-begin.adoc | 2 +- settings.gradle | 20 +- src/admin/swagger/admin.yaml | 8 +- .../swagger/analytics-admin.yaml | 4 +- .../swagger/analytics-config.yaml | 4 +- .../swagger/analytics-library.yaml | 4 +- .../swagger/analytics-links.yaml | 4 +- .../swagger/analytics-service.yaml | 4 +- .../swagger/analytics-settings.yaml | 2 +- src/eventing/swagger/eventing.yaml | 4 +- src/functions/swagger/functions.yaml | 4 +- src/indexes/swagger/indexes.yaml | 4 +- src/query-service/swagger/query-service.yaml | 12 +- .../swagger/query-settings.yaml | 2 +- src/search-advanced/search-advanced.gradle | 23 + .../swagger/search-advanced.yaml | 235 + src/search-index/search-index.gradle | 23 + src/search-index/swagger/search-index.yaml | 1299 +++ src/search-manage/search-manage.gradle | 23 + src/search-manage/swagger/search-manage.yaml | 138 + src/search-nodes/search-nodes.gradle | 23 + src/search-nodes/swagger/search-nodes.yaml | 495 + src/search-query/search-query.gradle | 23 + src/search-query/swagger/search-query.yaml | 280 + src/search-stats/search-stats.gradle | 23 + src/search-stats/swagger/search-stats.yaml | 780 ++ 182 files changed, 25310 insertions(+), 74 deletions(-) create mode 100644 docs/modules/fts-rest-advanced/examples/get-partition.json create mode 100644 docs/modules/fts-rest-advanced/pages/index.adoc create mode 100644 docs/modules/fts-rest-advanced/partials/header-attributes.adoc create mode 100644 docs/modules/fts-rest-advanced/partials/overview/document-before.adoc create mode 100644 docs/modules/fts-rest-advanced/partials/paths/getPartition/http-response.adoc create mode 100644 docs/modules/fts-rest-advanced/partials/security/document-begin.adoc create mode 100644 docs/modules/fts-rest-advanced/partials/security/document-end.adoc create mode 100644 docs/modules/fts-rest-indexing/examples/d-api-index-name-200.json create mode 100644 docs/modules/fts-rest-indexing/examples/d-api-index-name-default.json create mode 100644 docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-200.json create mode 100644 docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-default.json create mode 100644 docs/modules/fts-rest-indexing/examples/fts-sample-index-def-response.json create mode 100644 docs/modules/fts-rest-indexing/examples/fts-sample-success-response-vector-search.json create mode 100644 docs/modules/fts-rest-indexing/examples/fts-sample-success-response.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-index-name-count.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-index-name.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-index.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-scoped-indexes.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-scoped-status.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-200.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-body.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-stats-index-name.json create mode 100644 docs/modules/fts-rest-indexing/examples/g-api-stats.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-index-name-200.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-index-name-default.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-index-name-query-hybrid.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-index-name-query-options.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-index-name-query-regular.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-200.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-body.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-200.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-default.json create mode 100644 docs/modules/fts-rest-indexing/examples/p-api-scoped-query-default.json create mode 100644 docs/modules/fts-rest-indexing/examples/response-200.json create mode 100644 docs/modules/fts-rest-indexing/pages/index.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/header-attributes.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/overview/document-before.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/d-api-scoped-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-index-name-count/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-index/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-index/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-indexes/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-status/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-request.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/g-api-stats/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/http-request.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-responses-after.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-request.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-ingestcontrol/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-planfreezecontrol/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-query/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-querycontrol/http-response.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/security/document-begin.adoc create mode 100644 docs/modules/fts-rest-indexing/partials/security/document-end.adoc create mode 100644 docs/modules/fts-rest-manage/examples/file-xfer-200.json create mode 100644 docs/modules/fts-rest-manage/examples/file-xfer-405.json create mode 100644 docs/modules/fts-rest-manage/examples/file-xfer-disable.sh create mode 100644 docs/modules/fts-rest-manage/examples/file-xfer-enable.sh create mode 100644 docs/modules/fts-rest-manage/pages/index.adoc create mode 100644 docs/modules/fts-rest-manage/partials/header-attributes.adoc create mode 100644 docs/modules/fts-rest-manage/partials/overview/document-before.adoc create mode 100644 docs/modules/fts-rest-manage/partials/overview/document-end.adoc create mode 100644 docs/modules/fts-rest-manage/partials/paths/put_options/http-request.adoc create mode 100644 docs/modules/fts-rest-manage/partials/paths/put_options/http-response.adoc create mode 100644 docs/modules/fts-rest-manage/partials/paths/put_options/operation-description-end.adoc create mode 100644 docs/modules/fts-rest-manage/partials/security/document-after.adoc create mode 100644 docs/modules/fts-rest-manage/partials/security/document-begin.adoc create mode 100644 docs/modules/fts-rest-manage/partials/security/document-end.adoc create mode 100644 docs/modules/fts-rest-nodes/examples/get-cluster-config.json create mode 100644 docs/modules/fts-rest-nodes/examples/get-logs.json create mode 100644 docs/modules/fts-rest-nodes/examples/get-runtime-info.json create mode 100644 docs/modules/fts-rest-nodes/pages/index.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/header-attributes.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/overview/document-before.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/paths/getClusterConfig/http-response.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/paths/getLogs/http-response.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/paths/getRuntimeInfo/http-response.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/security/document-begin.adoc create mode 100644 docs/modules/fts-rest-nodes/partials/security/document-end.adoc create mode 100644 docs/modules/fts-rest-query/examples/api-query-all.json create mode 100644 docs/modules/fts-rest-query/examples/api-query-all.sh create mode 100644 docs/modules/fts-rest-query/examples/api-query-cancel.json create mode 100644 docs/modules/fts-rest-query/examples/api-query-cancel.sh create mode 100644 docs/modules/fts-rest-query/examples/api-query-filter.json create mode 100644 docs/modules/fts-rest-query/examples/api-query-filter.sh create mode 100644 docs/modules/fts-rest-query/examples/api-query-index.json create mode 100644 docs/modules/fts-rest-query/examples/api-query-index.sh create mode 100644 docs/modules/fts-rest-query/pages/index.adoc create mode 100644 docs/modules/fts-rest-query/partials/header-attributes.adoc create mode 100644 docs/modules/fts-rest-query/partials/overview/document-before.adoc create mode 100644 docs/modules/fts-rest-query/partials/overview/document-end.adoc create mode 100644 docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-request.adoc create mode 100644 docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-response.adoc create mode 100644 docs/modules/fts-rest-query/partials/paths/api-query-index/http-request.adoc create mode 100644 docs/modules/fts-rest-query/partials/paths/api-query-index/http-response.adoc create mode 100644 docs/modules/fts-rest-query/partials/paths/api-query/http-request.adoc create mode 100644 docs/modules/fts-rest-query/partials/paths/api-query/http-response.adoc create mode 100644 docs/modules/fts-rest-query/partials/security/document-begin.adoc create mode 100644 docs/modules/fts-rest-query/partials/security/document-end.adoc create mode 100644 docs/modules/fts-rest-stats/examples/g-api-nsstats-200.json create mode 100644 docs/modules/fts-rest-stats/examples/g-api-nsstats-403.json create mode 100644 docs/modules/fts-rest-stats/examples/g-api-nsstats-index-name.json create mode 100644 docs/modules/fts-rest-stats/pages/index.adoc create mode 100644 docs/modules/fts-rest-stats/partials/header-attributes.adoc create mode 100644 docs/modules/fts-rest-stats/partials/overview/document-before.adoc create mode 100644 docs/modules/fts-rest-stats/partials/paths/g-api-nsstats-index-name/http-response.adoc create mode 100644 docs/modules/fts-rest-stats/partials/paths/g-api-nsstats/http-response.adoc create mode 100644 docs/modules/fts-rest-stats/partials/security/document-begin.adoc create mode 100644 docs/modules/fts-rest-stats/partials/security/document-end.adoc create mode 100644 src/search-advanced/search-advanced.gradle create mode 100644 src/search-advanced/swagger/search-advanced.yaml create mode 100644 src/search-index/search-index.gradle create mode 100644 src/search-index/swagger/search-index.yaml create mode 100644 src/search-manage/search-manage.gradle create mode 100644 src/search-manage/swagger/search-manage.yaml create mode 100644 src/search-nodes/search-nodes.gradle create mode 100644 src/search-nodes/swagger/search-nodes.yaml create mode 100644 src/search-query/search-query.gradle create mode 100644 src/search-query/swagger/search-query.yaml create mode 100644 src/search-stats/search-stats.gradle create mode 100644 src/search-stats/swagger/search-stats.yaml diff --git a/build.gradle b/build.gradle index a8e27363..c90f536b 100644 --- a/build.gradle +++ b/build.gradle @@ -29,6 +29,12 @@ defaultTasks 'admin:openApiGenerate', 'eventing:openApiGenerate', 'functions:openApiGenerate', 'indexes:openApiGenerate', + 'search-index:openApiGenerate', + 'search-nodes:openApiGenerate', + 'search-advanced:openApiGenerate', + 'search-stats:openApiGenerate', + 'search-query:openApiGenerate', + 'search-manage:openApiGenerate', 'analytics-admin:openApiGenerate', 'analytics-config:openApiGenerate', 'analytics-library:openApiGenerate', diff --git a/docs/modules/analytics-rest-admin/pages/index.adoc b/docs/modules/analytics-rest-admin/pages/index.adoc index 55cb5e0c..c4c050e6 100644 --- a/docs/modules/analytics-rest-admin/pages/index.adoc +++ b/docs/modules/analytics-rest-admin/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Analytics service. +The host name or IP address of a node running the Analytics Service. -- [%hardbreaks] @@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service. a| *port* a| [markdown] -- -The Analytics service REST port. Use `18095` for secure access. +The Analytics Service REST port. Use `18095` for secure access. -- [%hardbreaks] diff --git a/docs/modules/analytics-rest-admin/partials/security/document-begin.adoc b/docs/modules/analytics-rest-admin/partials/security/document-begin.adoc index 5df917db..7ec44140 100644 --- a/docs/modules/analytics-rest-admin/partials/security/document-begin.adoc +++ b/docs/modules/analytics-rest-admin/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Analytics Administration REST APIs support HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/analytics-rest-admin/partials/security/document-end.adoc b/docs/modules/analytics-rest-admin/partials/security/document-end.adoc index 8911b27a..5330f469 100644 --- a/docs/modules/analytics-rest-admin/partials/security/document-end.adoc +++ b/docs/modules/analytics-rest-admin/partials/security/document-end.adoc @@ -1 +1 @@ -Refer to xref:learn:security/roles.adoc[] for more details. \ No newline at end of file +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/analytics-rest-config/pages/index.adoc b/docs/modules/analytics-rest-config/pages/index.adoc index 897f0181..de8c3aca 100644 --- a/docs/modules/analytics-rest-config/pages/index.adoc +++ b/docs/modules/analytics-rest-config/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Analytics service. +The host name or IP address of a node running the Analytics Service. -- [%hardbreaks] @@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service. a| *port* a| [markdown] -- -The Analytics service REST port. Use `18095` for secure access. +The Analytics Service REST port. Use `18095` for secure access. -- [%hardbreaks] diff --git a/docs/modules/analytics-rest-config/partials/security/document-begin.adoc b/docs/modules/analytics-rest-config/partials/security/document-begin.adoc index ac4b0445..0942d209 100644 --- a/docs/modules/analytics-rest-config/partials/security/document-begin.adoc +++ b/docs/modules/analytics-rest-config/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Analytics Configuration REST API supports HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/analytics-rest-config/partials/security/document-end.adoc b/docs/modules/analytics-rest-config/partials/security/document-end.adoc index 8911b27a..5330f469 100644 --- a/docs/modules/analytics-rest-config/partials/security/document-end.adoc +++ b/docs/modules/analytics-rest-config/partials/security/document-end.adoc @@ -1 +1 @@ -Refer to xref:learn:security/roles.adoc[] for more details. \ No newline at end of file +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/analytics-rest-library/pages/index.adoc b/docs/modules/analytics-rest-library/pages/index.adoc index 4a098278..2d985f12 100644 --- a/docs/modules/analytics-rest-library/pages/index.adoc +++ b/docs/modules/analytics-rest-library/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Analytics service. +The host name or IP address of a node running the Analytics Service. -- [%hardbreaks] @@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service. a| *port* a| [markdown] -- -The Analytics service REST port. Use `18095` for secure access. +The Analytics Service REST port. Use `18095` for secure access. -- [%hardbreaks] diff --git a/docs/modules/analytics-rest-library/partials/security/document-begin.adoc b/docs/modules/analytics-rest-library/partials/security/document-begin.adoc index 83f1e8ef..dd8f818e 100644 --- a/docs/modules/analytics-rest-library/partials/security/document-begin.adoc +++ b/docs/modules/analytics-rest-library/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Analytics Library REST API supports HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/analytics-rest-library/partials/security/document-end.adoc b/docs/modules/analytics-rest-library/partials/security/document-end.adoc index 8911b27a..5330f469 100644 --- a/docs/modules/analytics-rest-library/partials/security/document-end.adoc +++ b/docs/modules/analytics-rest-library/partials/security/document-end.adoc @@ -1 +1 @@ -Refer to xref:learn:security/roles.adoc[] for more details. \ No newline at end of file +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/analytics-rest-links/pages/index.adoc b/docs/modules/analytics-rest-links/pages/index.adoc index 3cccae3a..a0977a0b 100644 --- a/docs/modules/analytics-rest-links/pages/index.adoc +++ b/docs/modules/analytics-rest-links/pages/index.adoc @@ -64,7 +64,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Analytics service. +The host name or IP address of a node running the Analytics Service. -- [%hardbreaks] @@ -75,7 +75,7 @@ The host name or IP address of a node running the Analytics service. a| *port* a| [markdown] -- -The Analytics service REST port. Use `18095` for secure access. +The Analytics Service REST port. Use `18095` for secure access. -- [%hardbreaks] diff --git a/docs/modules/analytics-rest-links/partials/security/document-begin.adoc b/docs/modules/analytics-rest-links/partials/security/document-begin.adoc index 9f28e161..3b730f23 100644 --- a/docs/modules/analytics-rest-links/partials/security/document-begin.adoc +++ b/docs/modules/analytics-rest-links/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Analytics Links REST API supports HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/analytics-rest-links/partials/security/document-end.adoc b/docs/modules/analytics-rest-links/partials/security/document-end.adoc index 8911b27a..5330f469 100644 --- a/docs/modules/analytics-rest-links/partials/security/document-end.adoc +++ b/docs/modules/analytics-rest-links/partials/security/document-end.adoc @@ -1 +1 @@ -Refer to xref:learn:security/roles.adoc[] for more details. \ No newline at end of file +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/analytics-rest-service/pages/index.adoc b/docs/modules/analytics-rest-service/pages/index.adoc index 30b33051..37db25d1 100644 --- a/docs/modules/analytics-rest-service/pages/index.adoc +++ b/docs/modules/analytics-rest-service/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Analytics service. +The host name or IP address of a node running the Analytics Service. -- [%hardbreaks] @@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service. a| *port* a| [markdown] -- -The Analytics service REST port. Use `18095` for secure access. +The Analytics Service REST port. Use `18095` for secure access. -- [%hardbreaks] diff --git a/docs/modules/analytics-rest-service/partials/security/document-begin.adoc b/docs/modules/analytics-rest-service/partials/security/document-begin.adoc index 69660b1b..fe93a428 100644 --- a/docs/modules/analytics-rest-service/partials/security/document-begin.adoc +++ b/docs/modules/analytics-rest-service/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Analytics Service REST API supports HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/analytics-rest-service/partials/security/document-end.adoc b/docs/modules/analytics-rest-service/partials/security/document-end.adoc index 8911b27a..5330f469 100644 --- a/docs/modules/analytics-rest-service/partials/security/document-end.adoc +++ b/docs/modules/analytics-rest-service/partials/security/document-end.adoc @@ -1 +1 @@ -Refer to xref:learn:security/roles.adoc[] for more details. \ No newline at end of file +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/analytics-rest-settings/pages/index.adoc b/docs/modules/analytics-rest-settings/pages/index.adoc index 18f3dc16..2ee7617b 100644 --- a/docs/modules/analytics-rest-settings/pages/index.adoc +++ b/docs/modules/analytics-rest-settings/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Analytics service. +The host name or IP address of a node running the Analytics Service. -- [%hardbreaks] diff --git a/docs/modules/analytics-rest-settings/partials/security/document-begin.adoc b/docs/modules/analytics-rest-settings/partials/security/document-begin.adoc index 0dc3c444..6961216f 100644 --- a/docs/modules/analytics-rest-settings/partials/security/document-begin.adoc +++ b/docs/modules/analytics-rest-settings/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Analytics Settings REST API supports HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/analytics-rest-settings/partials/security/document-end.adoc b/docs/modules/analytics-rest-settings/partials/security/document-end.adoc index 8911b27a..5330f469 100644 --- a/docs/modules/analytics-rest-settings/partials/security/document-end.adoc +++ b/docs/modules/analytics-rest-settings/partials/security/document-end.adoc @@ -1 +1 @@ -Refer to xref:learn:security/roles.adoc[] for more details. \ No newline at end of file +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index 56834674..4668773a 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -63,7 +63,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Eventing service. +The host name or IP address of a node running the Eventing Service. -- [%hardbreaks] @@ -74,7 +74,7 @@ The host name or IP address of a node running the Eventing service. a| *port* a| [markdown] -- -The Eventing service REST port. Use `18096` for secure access. +The Eventing Service REST port. Use `18096` for secure access. -- [%hardbreaks] diff --git a/docs/modules/eventing-rest-api/partials/overview/document-end.adoc b/docs/modules/eventing-rest-api/partials/overview/document-end.adoc index a30fdd90..eb90389b 100644 --- a/docs/modules/eventing-rest-api/partials/overview/document-end.adoc +++ b/docs/modules/eventing-rest-api/partials/overview/document-end.adoc @@ -3,7 +3,7 @@ In the HTTP request examples: -* `$HOST` is the host name or IP address of a node running the Eventing service. +* `$HOST` is the host name or IP address of a node running the Eventing Service. * `$ADMIN` is the user name of an administrator -- see <>. * `$USER` is the user name of any authorized user -- see <>. * `$PASSWORD` is the password to connect to Couchbase Server. \ No newline at end of file diff --git a/docs/modules/eventing-rest-api/partials/security/document-begin.adoc b/docs/modules/eventing-rest-api/partials/security/document-begin.adoc index 52e27bc5..c004fd5b 100644 --- a/docs/modules/eventing-rest-api/partials/security/document-begin.adoc +++ b/docs/modules/eventing-rest-api/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Eventing REST APIs support HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-advanced/examples/get-partition.json b/docs/modules/fts-rest-advanced/examples/get-partition.json new file mode 100644 index 00000000..0a8048ed --- /dev/null +++ b/docs/modules/fts-rest-advanced/examples/get-partition.json @@ -0,0 +1,18 @@ +{ + "pindexes": { + "myFirstIndex_6cc599ab7a85bf3b_0": { + "indexName": "myFirstIndex", + "indexParams": "", + "indexType": "blackhole", + "indexUUID": "6cc599ab7a85bf3b", + "name": "myFirstIndex_6cc599ab7a85bf3b_0", + "sourceName": "", + "sourceParams": "", + "sourcePartitions": "", + "sourceType": "nil", + "sourceUUID": "", + "uuid": "2d9ecb8b574a9f6a" + } + }, + "status": "ok" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-advanced/pages/index.adoc b/docs/modules/fts-rest-advanced/pages/index.adoc new file mode 100644 index 00000000..b16023d9 --- /dev/null +++ b/docs/modules/fts-rest-advanced/pages/index.adoc @@ -0,0 +1,2029 @@ += Couchbase Search Advanced API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Advanced Search REST APIs are provided by the Search service. +These APIs enable you to manage and query Search index partitions and to specify advanced settings. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Search Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Search Service REST port. Use `18094` for secure access. +-- + +[%hardbreaks] +*Values:* `8094`, `18094` +*Example:* `+++8094+++` +// end + +|=== + + +// markup not found, no include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 3 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +<> +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Definition] += Definition +:leveloffset: +1 + +ifeval::["Operations for Search index partition definition." != ""] +Operations for Search index partition definition. +endif::[] +ifeval::["Operations for Search index partition definition." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/getPartition/operation-before.adoc[opts=optional] + + +[#getPartition] += Get Index Partition Information + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartition/operation-begin.adoc[opts=optional] + + +.... +GET /api/pindex +.... + + + +// markup not found, no include::{specDir}paths/getPartition/operation-description-before.adoc[opts=optional] + + +[#getPartition-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartition/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Get information about a Search index partition. +-- + + +// markup not found, no include::{specDir}paths/getPartition/operation-description-end.adoc[opts=optional] + + + +[#getPartition-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartition/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartition/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getPartition/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartition/operation-responses-before.adoc[opts=optional] + + +[#getPartition-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartition/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the Search index partition information. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/getPartition/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getPartition/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartition/operation-security-before.adoc[opts=optional] + + +[#getPartition-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartition/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getPartition/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartition/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getPartition/http-request.adoc[opts=optional] + + +include::{snippetDir}getPartition/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartition/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartition/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-before.adoc[opts=optional] + + +[#getPartitionName] += Get Index Partition by Name + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionName/operation-begin.adoc[opts=optional] + + +.... +GET /api/pindex/{pindexName} +.... + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-description-before.adoc[opts=optional] + + +[#getPartitionName-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionName/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Get information about a specific Search index partition by name. +-- + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-parameters-before.adoc[opts=optional] + + +[#getPartitionName-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionName/operation-parameters-begin.adoc[opts=optional] + + +[#getPartitionName-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *pindexName* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index partition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-responses-before.adoc[opts=optional] + + +[#getPartitionName-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionName/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-security-before.adoc[opts=optional] + + +[#getPartitionName-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionName/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getPartitionName/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}getPartitionName/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartitionName/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Query] += Query +:leveloffset: +1 + +ifeval::["Operations for querying Search index partitions." != ""] +Operations for querying Search index partitions. +endif::[] +ifeval::["Operations for querying Search index partitions." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-before.adoc[opts=optional] + + +[#getPartitionCount] += Get Index Partition Document Count + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-begin.adoc[opts=optional] + + +.... +GET /api/pindex/{pindexName}/count +.... + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-description-before.adoc[opts=optional] + + +[#getPartitionCount-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Get the document count of a specific Search index partition. +-- + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-description-end.adoc[opts=optional] + + + +[#getPartitionCount-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-parameters-before.adoc[opts=optional] + + +[#getPartitionCount-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-parameters-begin.adoc[opts=optional] + + +[#getPartitionCount-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *pindexName* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index partition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-responses-before.adoc[opts=optional] + + +[#getPartitionCount-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-security-before.adoc[opts=optional] + + +[#getPartitionCount-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getPartitionCount/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}getPartitionCount/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getPartitionCount/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-before.adoc[opts=optional] + + +[#queryPartition] += Query Index Partition + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/queryPartition/operation-begin.adoc[opts=optional] + + +.... +POST /api/pindex/{pindexName}/query +.... + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-description-before.adoc[opts=optional] + + +[#queryPartition-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/queryPartition/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Execute a query against a specific Search index partition by name. +-- + + +// markup not found, no include::{specDir}paths/queryPartition/operation-description-end.adoc[opts=optional] + + +[#queryPartition-consumes] +.Consumes +* application/json + +[#queryPartition-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/queryPartition/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-parameters-before.adoc[opts=optional] + + +[#queryPartition-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/queryPartition/operation-parameters-begin.adoc[opts=optional] + + +[#queryPartition-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *pindexName* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index partition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + +[#queryPartition-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A JSON object to define the settings for your Search query. For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/queryPartition/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-responses-before.adoc[opts=optional] + + +[#queryPartition-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/queryPartition/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The response object has a status section that must be checked for every request. Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/queryPartition/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-security-before.adoc[opts=optional] + + +[#queryPartition-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/queryPartition/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/queryPartition/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/queryPartition/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}queryPartition/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}queryPartition/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/queryPartition/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/queryPartition/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Quota] += Quota +:leveloffset: +1 + +ifeval::["Operations for managing Search memory quota." != ""] +Operations for managing Search memory quota. +endif::[] +ifeval::["Operations for managing Search memory quota." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-before.adoc[opts=optional] + + +[#setFtsMemoryQuota] += Set Search Memory Quota + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-begin.adoc[opts=optional] + + +.... +POST /pools/default +.... + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-description-before.adoc[opts=optional] + + +[#setFtsMemoryQuota-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Sets the memory quota for the Search Service. +-- + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-description-end.adoc[opts=optional] + + +[#setFtsMemoryQuota-consumes] +.Consumes +* application/x-www-form-urlencoded + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-parameters-before.adoc[opts=optional] + + +[#setFtsMemoryQuota-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-parameters-begin.adoc[opts=optional] + + + + + +[#setFtsMemoryQuota-form] +.Form Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *ftsMemoryQuota* + +_optional_ +a¦ + + +[markdown] +-- +The memory quota for the Search service. +-- + +[%hardbreaks] +{blank} + +a¦ Integer + + + +|=== + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-responses-before.adoc[opts=optional] + + +[#setFtsMemoryQuota-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Memory quota set. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-security-before.adoc[opts=optional] + + +[#setFtsMemoryQuota-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}setFtsMemoryQuota/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}setFtsMemoryQuota/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 6 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +<> +<> +<> +<> +endif::[] + + + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DocumentCount] += Document Count + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DocumentCount[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*count* + +_optional_ +a¦ + +[markdown] +-- +The document count for the specified index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::DocumentCount[] + + + + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/indexPartition/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#indexPartition] += Index Partitions + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/indexPartition/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::indexPartition[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*pindexes* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-indexPartitionPIndex, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the request. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::indexPartition[] + + + + +// markup not found, no include::{specDir}definitions/indexPartition/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/indexPartition/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/indexPartitionPIndex/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#indexPartitionPIndex] += Index Partitions Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/indexPartitionPIndex/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::indexPartitionPIndex[] + +ifdef::model-descriptions[] +//tag::desc-indexPartitionPIndex[] +An object containing information about 1 or more Search index partitions. +//end::desc-indexPartitionPIndex[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-indexPartitionPIndexInner, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::indexPartitionPIndex[] + + + + +// markup not found, no include::{specDir}definitions/indexPartitionPIndex/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/indexPartitionPIndex/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/indexPartitionPIndexInner/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#indexPartitionPIndexInner] += Index Partition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/indexPartitionPIndexInner/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::indexPartitionPIndexInner[] + +ifdef::model-descriptions[] +//tag::desc-indexPartitionPIndexInner[] +An object containing information about a single Search index partition. +The name of the property is the name of the Search index partition. +//end::desc-indexPartitionPIndexInner[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexName* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexParams* + +_optional_ +a¦ + +[markdown] +-- +The Search index's type identifier, type mappings, and analyzers. +For more information, see [Params Object](../search/search-index-params.html#params). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*indexType* + +_optional_ +a¦ + +[markdown] +-- +The type of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*name* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceName* + +_optional_ +a¦ + +[markdown] +-- +The name of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceParams* + +_optional_ +a¦ + +[markdown] +-- +Advanced settings for Search index behavior. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*sourcePartitions* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceType* + +_optional_ +a¦ + +[markdown] +-- +The type of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::indexPartitionPIndexInner[] + + + + +// markup not found, no include::{specDir}definitions/indexPartitionPIndexInner/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/indexPartitionPIndexInner/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#QueryRequest] += Query Request + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::QueryRequest[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*query* + +_optional_ +a¦ + +[markdown] +-- +An object that contains the properties for one of the supported query types. +For more information, see [Query Object](../search/search-request-params.html#query-object). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*knn* + +_optional_ +a¦ + +[markdown] +-- +An array that contains objects that describe a Vector Search query. +For more information, see [Knn Objects](../search/search-request-params.html#knn-object). +-- + +[%hardbreaks] +{blank} +a¦ Object + array + +a¦ +*ctl* + +_optional_ +a¦ + +[markdown] +-- +An object that contains properties for query consistency. +For more information, see [Ctl Object](../search/search-request-params.html#ctl). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*size* + +_optional_ +a¦ + +[markdown] +-- +Set the total number of results to return for a single page of search results. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*from* + +_optional_ +a¦ + +[markdown] +-- +Set an offset value to change where pagination starts for search results. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*highlight* + +_optional_ +a¦ + +[markdown] +-- +Contains properties to control search result highlighting. +For more information, see [Highlight Objects](../search/search-request-params.html#highlight). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*fields* + +_optional_ +a¦ + +[markdown] +-- +An array of strings to specify each indexed field you want to return in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*facets* + +_optional_ +a¦ + +[markdown] +-- +Contains nested objects to define each facet you want to return with search results. +For more information, see [Facet Objects](../search/search-request-params.html#facet-name). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*explain* + +_optional_ +a¦ + +[markdown] +-- +Whether to create an explanation for a search result's score in search results. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*sort* + +_optional_ +a¦ + +[markdown] +-- +Contains an array of strings or JSON objects to set how to sort search results. +For more information, see [Sort Object](../search/search-request-params.html#sort). +-- + +[%hardbreaks] +{blank} +a¦ Any Type + array + +a¦ +*includeLocations* + +_optional_ +a¦ + +[markdown] +-- +Whether to return the position of each occurrence of a search term inside a document. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*score* + +_optional_ +a¦ + +[markdown] +-- +Whether to include document relevancy scoring in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*search_after* + +_optional_ +a¦ + +[markdown] +-- +Use to control pagination in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*search_before* + +_optional_ +a¦ + +[markdown] +-- +Use to control pagination in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*collections* + +_optional_ +a¦ + +[markdown] +-- +An array of strings that specify the collections where you want to run the query. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +|=== + +//end::QueryRequest[] + + + + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#QueryResponse] += Query Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::QueryResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*results* + +_optional_ +a¦ + +[markdown] +-- +The results of the Search query. +-- + +[%hardbreaks] +{blank} +a¦ Object + array + +|=== + +//end::QueryResponse[] + + + + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Manage/security-scheme-before.adoc[opts=optional] + + +[[security-manage]] += Manage + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Manage/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Admin** role, with FTS Manage permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Manage/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Manage/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Read/security-scheme-before.adoc[opts=optional] + + +[[security-read]] += Read + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Read/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Reader** or **Search Admin** role, with FTS Read permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Read/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Read/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Write/security-scheme-before.adoc[opts=optional] + + +[[security-write]] += Write + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Write/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Admin** role, with FTS Write permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Write/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Write/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/fts-rest-advanced/partials/header-attributes.adoc b/docs/modules/fts-rest-advanced/partials/header-attributes.adoc new file mode 100644 index 00000000..75e2b583 --- /dev/null +++ b/docs/modules/fts-rest-advanced/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: rest-api:rest-fts-advanced.adoc +:!example-caption: +:description: The Search Advanced REST APIs are provided by the Search Service. \ +These APIs enable you to manage and monitor advanced settings of your Search indexes. diff --git a/docs/modules/fts-rest-advanced/partials/overview/document-before.adoc b/docs/modules/fts-rest-advanced/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/fts-rest-advanced/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/fts-rest-advanced/partials/paths/getPartition/http-response.adoc b/docs/modules/fts-rest-advanced/partials/paths/getPartition/http-response.adoc new file mode 100644 index 00000000..a43e0469 --- /dev/null +++ b/docs/modules/fts-rest-advanced/partials/paths/getPartition/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$get-partition.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-advanced/partials/security/document-begin.adoc b/docs/modules/fts-rest-advanced/partials/security/document-begin.adoc new file mode 100644 index 00000000..753b6c55 --- /dev/null +++ b/docs/modules/fts-rest-advanced/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Search REST APIs support HTTP basic authentication. +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-advanced/partials/security/document-end.adoc b/docs/modules/fts-rest-advanced/partials/security/document-end.adoc new file mode 100644 index 00000000..5330f469 --- /dev/null +++ b/docs/modules/fts-rest-advanced/partials/security/document-end.adoc @@ -0,0 +1 @@ +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/d-api-index-name-200.json b/docs/modules/fts-rest-indexing/examples/d-api-index-name-200.json new file mode 100644 index 00000000..a6baa02d --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/d-api-index-name-200.json @@ -0,0 +1,4 @@ +{ + "status": "ok", + "uuid": "123294e5a4efbe39" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/d-api-index-name-default.json b/docs/modules/fts-rest-indexing/examples/d-api-index-name-default.json new file mode 100644 index 00000000..9a10b7f9 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/d-api-index-name-default.json @@ -0,0 +1,5 @@ +{ + "error": "rest_auth: preparePerms, err: index not found", + "request": "", + "status": "fail" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-200.json b/docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-200.json new file mode 100644 index 00000000..052dc44f --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-200.json @@ -0,0 +1,4 @@ +{ + "status": "ok", + "uuid": "687be6a2ad647c34" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-default.json b/docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-default.json new file mode 100644 index 00000000..9a10b7f9 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-default.json @@ -0,0 +1,5 @@ +{ + "error": "rest_auth: preparePerms, err: index not found", + "request": "", + "status": "fail" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/fts-sample-index-def-response.json b/docs/modules/fts-rest-indexing/examples/fts-sample-index-def-response.json new file mode 100644 index 00000000..c6960632 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/fts-sample-index-def-response.json @@ -0,0 +1,167 @@ +{ + "status": "ok", + "indexDef": { + "type": "fulltext-index", + "name": "color-test", + "uuid": "6ea521a918bd3837", + "sourceType": "gocbcore", + "sourceName": "vector-sample", + "sourceUUID": "614177a67bdfbd2823c5f9c3e62f5991", + "planParams": { + "maxPartitionsPerPIndex": 1024, + "indexPartitions": 1 + }, + "params": { + "doc_config": { + "docid_prefix_delim": "", + "docid_regexp": "", + "mode": "scope.collection.type_field", + "type_field": "type" + }, + "mapping": { + "analysis": {}, + "default_analyzer": "standard", + "default_datetime_parser": "dateTimeOptional", + "default_field": "_all", + "default_mapping": { + "dynamic": false, + "enabled": false + }, + "default_type": "_default", + "docvalues_dynamic": false, + "index_dynamic": false, + "store_dynamic": false, + "type_field": "_type", + "types": { + "color.rgb": { + "dynamic": false, + "enabled": true, + "properties": { + "color": { + "dynamic": false, + "enabled": true, + "fields": [ + { + "analyzer": "en", + "docvalues": true, + "include_in_all": true, + "include_term_vectors": true, + "index": true, + "name": "color", + "store": true, + "type": "text" + } + ] + }, + "colorvect_dot": { + "dynamic": false, + "enabled": true, + "fields": [ + { + "dims": 3, + "index": true, + "name": "colorvect_dot", + "similarity": "dot_product", + "type": "vector", + "vector_index_optimized_for": "recall" + } + ] + } + } + } + } + }, + "store": { + "indexType": "scorch", + "segmentVersion": 16 + } + }, + "sourceParams": {} + }, + "planPIndexes": [ + { + "name": "vector-sample.color.color-test_6ea521a918bd3837_4c1c5584", + "uuid": "1543820346544e08", + "indexType": "fulltext-index", + "indexName": "vector-sample.color.color-test", + "indexUUID": "6ea521a918bd3837", + "sourceType": "gocbcore", + "sourceName": "vector-sample", + "sourceUUID": "614177a67bdfbd2823c5f9c3e62f5991", + "sourcePartitions": "0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255,256,257,258,259,260,261,262,263,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317,318,319,320,321,322,323,324,325,326,327,328,329,330,331,332,333,334,335,336,337,338,339,340,341,342,343,344,345,346,347,348,349,350,351,352,353,354,355,356,357,358,359,360,361,362,363,364,365,366,367,368,369,370,371,372,373,374,375,376,377,378,379,380,381,382,383,384,385,386,387,388,389,390,391,392,393,394,395,396,397,398,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,419,420,421,422,423,424,425,426,427,428,429,430,431,432,433,434,435,436,437,438,439,440,441,442,443,444,445,446,447,448,449,450,451,452,453,454,455,456,457,458,459,460,461,462,463,464,465,466,467,468,469,470,471,472,473,474,475,476,477,478,479,480,481,482,483,484,485,486,487,488,489,490,491,492,493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510,511,512,513,514,515,516,517,518,519,520,521,522,523,524,525,526,527,528,529,530,531,532,533,534,535,536,537,538,539,540,541,542,543,544,545,546,547,548,549,550,551,552,553,554,555,556,557,558,559,560,561,562,563,564,565,566,567,568,569,570,571,572,573,574,575,576,577,578,579,580,581,582,583,584,585,586,587,588,589,590,591,592,593,594,595,596,597,598,599,600,601,602,603,604,605,606,607,608,609,610,611,612,613,614,615,616,617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,635,636,637,638,639,640,641,642,643,644,645,646,647,648,649,650,651,652,653,654,655,656,657,658,659,660,661,662,663,664,665,666,667,668,669,670,671,672,673,674,675,676,677,678,679,680,681,682,683,684,685,686,687,688,689,690,691,692,693,694,695,696,697,698,699,700,701,702,703,704,705,706,707,708,709,710,711,712,713,714,715,716,717,718,719,720,721,722,723,724,725,726,727,728,729,730,731,732,733,734,735,736,737,738,739,740,741,742,743,744,745,746,747,748,749,750,751,752,753,754,755,756,757,758,759,760,761,762,763,764,765,766,767,768,769,770,771,772,773,774,775,776,777,778,779,780,781,782,783,784,785,786,787,788,789,790,791,792,793,794,795,796,797,798,799,800,801,802,803,804,805,806,807,808,809,810,811,812,813,814,815,816,817,818,819,820,821,822,823,824,825,826,827,828,829,830,831,832,833,834,835,836,837,838,839,840,841,842,843,844,845,846,847,848,849,850,851,852,853,854,855,856,857,858,859,860,861,862,863,864,865,866,867,868,869,870,871,872,873,874,875,876,877,878,879,880,881,882,883,884,885,886,887,888,889,890,891,892,893,894,895,896,897,898,899,900,901,902,903,904,905,906,907,908,909,910,911,912,913,914,915,916,917,918,919,920,921,922,923,924,925,926,927,928,929,930,931,932,933,934,935,936,937,938,939,940,941,942,943,944,945,946,947,948,949,950,951,952,953,954,955,956,957,958,959,960,961,962,963,964,965,966,967,968,969,970,971,972,973,974,975,976,977,978,979,980,981,982,983,984,985,986,987,988,989,990,991,992,993,994,995,996,997,998,999,1000,1001,1002,1003,1004,1005,1006,1007,1008,1009,1010,1011,1012,1013,1014,1015,1016,1017,1018,1019,1020,1021,1022,1023", + "nodes": { + "b7d460b7d4145482ac132dfa23727c5c": { + "canRead": true, + "canWrite": true, + "priority": 0 + } + }, + "indexParams": { + "doc_config": { + "docid_prefix_delim": "", + "docid_regexp": "", + "mode": "scope.collection.type_field", + "type_field": "type" + }, + "mapping": { + "analysis": {}, + "default_analyzer": "standard", + "default_datetime_parser": "dateTimeOptional", + "default_field": "_all", + "default_mapping": { + "dynamic": false, + "enabled": false + }, + "default_type": "_default", + "docvalues_dynamic": false, + "index_dynamic": false, + "store_dynamic": false, + "type_field": "_type", + "types": { + "color.rgb": { + "dynamic": false, + "enabled": true, + "properties": { + "color": { + "dynamic": false, + "enabled": true, + "fields": [ + { + "analyzer": "en", + "docvalues": true, + "include_in_all": true, + "include_term_vectors": true, + "index": true, + "name": "color", + "store": true, + "type": "text" + } + ] + }, + "colorvect_dot": { + "dynamic": false, + "enabled": true, + "fields": [ + { + "dims": 3, + "index": true, + "name": "colorvect_dot", + "similarity": "dot_product", + "type": "vector", + "vector_index_optimized_for": "recall" + } + ] + } + } + } + } + }, + "store": { + "indexType": "scorch", + "segmentVersion": 16 + } + } + } + ], + "warnings": [] +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/fts-sample-success-response-vector-search.json b/docs/modules/fts-rest-indexing/examples/fts-sample-success-response-vector-search.json new file mode 100644 index 00000000..5b6f2205 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/fts-sample-success-response-vector-search.json @@ -0,0 +1,55 @@ +{ + "status": { + "total": 1, + "failed": 0, + "successful": 1 + }, + "request": { + "fields": [ + "*" + ], + "query": { + "match_none": "" + }, + "knn": [ + { + "k": 2, + "field": "colorvect_dot", + "vector": [ + 0.707106781186548, + 0, + 0.707106781186548 + ] + } + ] + }, + "hits": [ + { + "index": "vector-sample.color.color-test_4d6a4a2f00f48fa2_4c1c5584", + "id": "#FF00FF", + "score": 0.9999999403953552, + "sort": [ + "_score" + ], + "fields": { + "color": "magenta / fuchsia" + } + }, + { + "index": "vector-sample.color.color-test_4d6a4a2f00f48fa2_4c1c5584", + "id": "#B000B0", + "score": 0.9999999403953552, + "sort": [ + "_score" + ], + "fields": { + "color": "dark lavender" + } + } + ], + "total_hits": 2, + "cost": 0, + "max_score": 0.9999999403953552, + "took": 4608572, + "facets": null +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/fts-sample-success-response.json b/docs/modules/fts-rest-indexing/examples/fts-sample-success-response.json new file mode 100644 index 00000000..63d06acc --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/fts-sample-success-response.json @@ -0,0 +1,261 @@ +{ + "status": { + "total": 1, + "failed": 0, + "successful": 1 + }, + "request": { + "query": { + "conjuncts": [ + { + "match": "location", + "field": "reviews.content", + "prefix_length": 0, + "fuzziness": 0, + "operator": "or" + }, + { + "match_phrase": "nice view", + "field": "reviews.content" + } + ] + }, + "size": 10, + "from": 0, + "highlight": { + "style": "html", + "fields": [ + "reviews.content" + ] + }, + "fields": null, + "facets": null, + "explain": true, + "sort": [ + "reviews.Ratings.Cleanliness", + { + "by": "field", + "field": "reviews.Ratings.Cleanliness", + "type": "number" + }, + "-_score", + "-_id" + ], + "includeLocations": false, + "score": "none", + "search_after": null, + "search_before": null + }, + "hits": [ + { + "index": "travel-sample.inventory.travel-test_53373d2948c55e82_4c1c5584", + "id": "hotel_7388", + "score": 0, + "explanation": { + "value": 0, + "message": "sum of:", + "children": [ + { + "value": 0, + "message": "product of:", + "children": [ + { + "value": 0, + "message": "sum of:", + "children": [ + { + "value": 0, + "message": "weight(reviews.content:location^1.000000 in \u0000\u0000\u0000\u0000\u0000\u0000\u0003\n), product of:", + "children": [ + { + "value": 0.5320504947307548, + "message": "queryWeight(reviews.content:location^1.000000), product of:", + "children": [ + { + "value": 1, + "message": "boost" + }, + { + "value": 1.4291903588638628, + "message": "idf(docFreq=596, maxDocs=917)" + }, + { + "value": 0.3722740581273647, + "message": "queryNorm" + } + ] + }, + { + "value": 0, + "message": "fieldWeight(reviews.content:location in \u0000\u0000\u0000\u0000\u0000\u0000\u0003\n), product of:", + "children": [ + { + "value": 0, + "message": "tf(termFreq(reviews.content:location)=0" + }, + { + "value": 0, + "message": "fieldNorm(field=reviews.content, doc=\u0000\u0000\u0000\u0000\u0000\u0000\u0003\n)" + }, + { + "value": 1.4291903588638628, + "message": "idf(docFreq=596, maxDocs=917)" + } + ] + } + ] + } + ] + }, + { + "value": 1, + "message": "coord(1/1)" + } + ] + }, + { + "value": 0, + "message": "sum of:", + "children": [ + { + "value": 0, + "message": "weight(reviews.content:view^1.000000 in \u0000\u0000\u0000\u0000\u0000\u0000\u0003\n), product of:", + "children": [ + { + "value": 0.6867550119496617, + "message": "queryWeight(reviews.content:view^1.000000), product of:", + "children": [ + { + "value": 1, + "message": "boost" + }, + { + "value": 1.8447565629585312, + "message": "idf(docFreq=393, maxDocs=917)" + }, + { + "value": 0.3722740581273647, + "message": "queryNorm" + } + ] + }, + { + "value": 0, + "message": "fieldWeight(reviews.content:view in \u0000\u0000\u0000\u0000\u0000\u0000\u0003\n), product of:", + "children": [ + { + "value": 0, + "message": "tf(termFreq(reviews.content:view)=0" + }, + { + "value": 0, + "message": "fieldNorm(field=reviews.content, doc=\u0000\u0000\u0000\u0000\u0000\u0000\u0003\n)" + }, + { + "value": 1.8447565629585312, + "message": "idf(docFreq=393, maxDocs=917)" + } + ] + } + ] + }, + { + "value": 0, + "message": "weight(reviews.content:nice^1.000000 in \u0000\u0000\u0000\u0000\u0000\u0000\u0003\n), product of:", + "children": [ + { + "value": 0.4952674273751292, + "message": "queryWeight(reviews.content:nice^1.000000), product of:", + "children": [ + { + "value": 1, + "message": "boost" + }, + { + "value": 1.3303839377539577, + "message": "idf(docFreq=658, maxDocs=917)" + }, + { + "value": 0.3722740581273647, + "message": "queryNorm" + } + ] + }, + { + "value": 0, + "message": "fieldWeight(reviews.content:nice in \u0000\u0000\u0000\u0000\u0000\u0000\u0003\n), product of:", + "children": [ + { + "value": 0, + "message": "tf(termFreq(reviews.content:nice)=0" + }, + { + "value": 0, + "message": "fieldNorm(field=reviews.content, doc=\u0000\u0000\u0000\u0000\u0000\u0000\u0003\n)" + }, + { + "value": 1.3303839377539577, + "message": "idf(docFreq=658, maxDocs=917)" + } + ] + } + ] + } + ] + } + ] + }, + "locations": { + "reviews.content": { + "location": [ + { + "pos": 312, + "start": 1641, + "end": 1649, + "array_positions": [ + 4 + ] + } + ], + "nice": [ + { + "pos": 165, + "start": 840, + "end": 844, + "array_positions": [ + 2 + ] + } + ], + "view": [ + { + "pos": 166, + "start": 845, + "end": 849, + "array_positions": [ + 2 + ] + } + ] + } + }, + "fragments": { + "reviews.content": [ + "…at\u0026#39;s her name checked us in, very friendly and knowlegeable of the area. I would stay here again get area and right at the street car stop. nice resturants in walking distance. \u003cmark\u003enice\u003c/mark\u003e \u003cmark\u003eview\u003c/mark\u003e of the city o…" + ] + }, + "sort": [ + "􏿿􏿿􏿿", + "􏿿􏿿􏿿", + "_score", + "hotel_7388" + ] + }, + "..." + ], + "total_hits": 27, + "cost": 108906, + "max_score": 0, + "took": 14964461, + "facets": null +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-index-name-count.json b/docs/modules/fts-rest-indexing/examples/g-api-index-name-count.json new file mode 100644 index 00000000..566913b7 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-index-name-count.json @@ -0,0 +1,4 @@ +{ + "status": "ok", + "count": 285 +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-index-name.json b/docs/modules/fts-rest-indexing/examples/g-api-index-name.json new file mode 100644 index 00000000..c6aa52c9 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-index-name.json @@ -0,0 +1,43 @@ +{ + "indexDef": { + "name": "myFirstIndex", + "params": "", + "planParams": { + "hierarchyRules": null, + "maxPartitionsPerPIndex": 0, + "nodePlanParams": null, + "numReplicas": 0, + "planFrozen": false + }, + "sourceName": "", + "sourceParams": "", + "source": "nil", + "sourceUUID": "", + "type": "fulltext-index", + "uuid": "6cc599ab7a85bf3b" + }, + "planPIndexes": [ + { + "indexName": "myFirstIndex", + "indexParams": "", + "indexType": "bleve", + "indexUUID": "6cc599ab7a85bf3b", + "name": "myFirstIndex_6cc599ab7a85bf3b_0", + "nodes": { + "78fc2ffac2fd9401": { + "canRead": true, + "canWrite": true, + "priority": 0 + } + }, + "sourceName": "", + "sourceParams": "", + "sourcePartitions": "", + "sourceType": "nil", + "sourceUUID": "", + "uuid": "64bed6e2edf354c3" + } + ], + "status": "ok", + "warnings": [] +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-index.json b/docs/modules/fts-rest-indexing/examples/g-api-index.json new file mode 100644 index 00000000..fc2cdcbd --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-index.json @@ -0,0 +1,26 @@ +{ + "indexDefs": { + "implVersion": "4.0.0", + "indexDefs": { + "myFirstIndex": { + "name": "myFirstIndex", + "params": "", + "planParams": { + "hierarchyRules": null, + "maxPartitionsPerPIndex": 0, + "nodePlanParams": null, + "numReplicas": 0, + "planFrozen": false + }, + "sourceName": "", + "sourceParams": "", + "sourceType": "nil", + "sourceUUID": "", + "type": "fulltext-index", + "uuid": "6cc599ab7a85bf3b" + } + }, + "uuid": "6cc599ab7a85bf3b" + }, + "status": "ok" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-scoped-indexes.json b/docs/modules/fts-rest-indexing/examples/g-api-scoped-indexes.json new file mode 100644 index 00000000..49cb6e53 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-scoped-indexes.json @@ -0,0 +1,118 @@ +{ + "status": "ok", + "indexDefs": { + "uuid": "23cf9530131858b8", + "indexDefs": { + "travel-sample.inventory.travel-hotel": { + "type": "fulltext-index", + "name": "travel-hotel", + "uuid": "a04a16f178846bc4", + "sourceType": "gocbcore", + "sourceName": "travel-sample", + "sourceUUID": "8f866261438f8b0d415a437552f3ae99", + "planParams": { + "maxPartitionsPerPIndex": 1024, + "indexPartitions": 1 + }, + "params": { + "doc_config": { + "docid_prefix_delim": "", + "docid_regexp": "", + "mode": "scope.collection.type_field", + "type_field": "type" + }, + "mapping": { + "analysis": {}, + "default_analyzer": "standard", + "default_datetime_parser": "dateTimeOptional", + "default_field": "_all", + "default_mapping": { + "dynamic": true, + "enabled": false + }, + "default_type": "_default", + "docvalues_dynamic": false, + "index_dynamic": true, + "store_dynamic": false, + "type_field": "_type", + "types": { + "inventory.hotel": { + "dynamic": false, + "enabled": true, + "properties": { + "reviews": { + "dynamic": false, + "enabled": true, + "properties": { + "content": { + "dynamic": false, + "enabled": true, + "fields": [ + { + "docvalues": true, + "include_in_all": true, + "include_term_vectors": true, + "index": true, + "name": "content", + "store": true, + "type": "text" + } + ] + } + } + } + } + } + } + }, + "store": { + "indexType": "scorch", + "segmentVersion": 15 + } + }, + "sourceParams": {} + }, + "travel-sample.inventory.travel-test": { + "type": "fulltext-index", + "name": "travel-test", + "uuid": "766ddce5d41a3b41", + "sourceType": "gocbcore", + "sourceName": "travel-sample", + "sourceUUID": "8f866261438f8b0d415a437552f3ae99", + "planParams": { + "maxPartitionsPerPIndex": 1024, + "indexPartitions": 1 + }, + "params": { + "doc_config": { + "docid_prefix_delim": "", + "docid_regexp": "", + "mode": "scope.collection.type_field", + "type_field": "type" + }, + "mapping": { + "analysis": {}, + "default_analyzer": "standard", + "default_datetime_parser": "dateTimeOptional", + "default_field": "_all", + "default_mapping": { + "dynamic": true, + "enabled": true + }, + "default_type": "_default", + "docvalues_dynamic": false, + "index_dynamic": true, + "store_dynamic": false, + "type_field": "_type" + }, + "store": { + "indexType": "scorch", + "segmentVersion": 15 + } + }, + "sourceParams": {} + } + }, + "implVersion": "5.7.0" + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-scoped-status.json b/docs/modules/fts-rest-indexing/examples/g-api-scoped-status.json new file mode 100644 index 00000000..a02fe919 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-scoped-status.json @@ -0,0 +1,4 @@ +{ + "status": "ok", + "indexStatus": "Ready" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-200.json b/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-200.json new file mode 100644 index 00000000..43b9686f --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-200.json @@ -0,0 +1,118 @@ +{ + "status": "ok", + "analyzed": [ + { + "couchbase blr": { + "Term": "Y291Y2hiYXNlIGJscg==", + "Locations": [ + { + "Field": "title", + "ArrayPositions": [], + "Start": 0, + "End": 13, + "Position": 1 + } + ] + } + }, + { + "he": { + "Term": "aGU=", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 0, + "End": 5, + "Position": 1 + } + ] + }, + "hel": { + "Term": "aGVs", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 0, + "End": 5, + "Position": 1 + } + ] + }, + "hell": { + "Term": "aGVsbA==", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 0, + "End": 5, + "Position": 1 + } + ] + }, + "hello": { + "Term": "aGVsbG8=", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 0, + "End": 5, + "Position": 1 + } + ] + }, + "wo": { + "Term": "d28=", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 6, + "End": 11, + "Position": 2 + } + ] + }, + "wor": { + "Term": "d29y", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 6, + "End": 11, + "Position": 2 + } + ] + }, + "worl": { + "Term": "d29ybA==", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 6, + "End": 11, + "Position": 2 + } + ] + }, + "world": { + "Term": "d29ybGQ=", + "Locations": [ + { + "Field": "name", + "ArrayPositions": [], + "Start": 6, + "End": 11, + "Position": 2 + } + ] + } + }, + null + ] +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-body.json b/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-body.json new file mode 100644 index 00000000..af6fff72 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-body.json @@ -0,0 +1,4 @@ +{ + "name": "hello world", + "title": "couchbase blr" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name.json b/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name.json new file mode 100644 index 00000000..b8bb7efb --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-stats-index-name.json @@ -0,0 +1,159 @@ +{ + "feeds": {}, + "pindexes": { + "travel-sample.inventory.travel-test_3858c70e4d4d8df9_4c1c5584": { + "pindexStoreStats": { + "TimerBatchStore": { + "count": 0, + "min": 0, + "max": 0, + "mean": 0.00, + "stddev": 0.00, + "percentiles": { + "99%": 0.00, + "99.9%": 0.00, + "median": 0.00, + "75%": 0.00, + "95%": 0.00 + }, + "rates": { + "mean": 0.00, + "1-min": 0.00, + "5-min": 0.00, + "15-min": 0.00 + } + }, + "Errors": [] + }, + "bleveIndexStats": { + "index": { + "CurFilesIneligibleForRemoval": 0, + "CurOnDiskBytes": 34007668, + "CurOnDiskFiles": 4, + "CurRootEpoch": 0, + "LastMergedEpoch": 44, + "LastPersistedEpoch": 44, + "MaxBatchIntroTime": 0, + "MaxFileMergeZapIntroductionTime": 0, + "MaxFileMergeZapTime": 0, + "MaxMemMergeZapTime": 0, + "TotAnalysisTime": 0, + "TotBatchIntroTime": 0, + "TotBatches": 0, + "TotBatchesEmpty": 0, + "TotBytesReadAtQueryTime": 294892, + "TotBytesWrittenAtIndexTime": 0, + "TotDeletes": 0, + "TotEventTriggerCompleted": 2, + "TotEventTriggerStarted": 2, + "TotFileMergeForceOpsCompleted": 0, + "TotFileMergeForceOpsStarted": 0, + "TotFileMergeIntroductions": 0, + "TotFileMergeIntroductionsDone": 0, + "TotFileMergeIntroductionsObsoleted": 0, + "TotFileMergeIntroductionsSkipped": 0, + "TotFileMergeLoopBeg": 2, + "TotFileMergeLoopEnd": 1, + "TotFileMergeLoopErr": 0, + "TotFileMergePlan": 1, + "TotFileMergePlanErr": 0, + "TotFileMergePlanNone": 1, + "TotFileMergePlanOk": 0, + "TotFileMergePlanTasks": 0, + "TotFileMergePlanTasksDone": 0, + "TotFileMergePlanTasksErr": 0, + "TotFileMergePlanTasksSegments": 0, + "TotFileMergePlanTasksSegmentsEmpty": 0, + "TotFileMergeSegments": 0, + "TotFileMergeSegmentsEmpty": 0, + "TotFileMergeWrittenBytes": 0, + "TotFileMergeZapBeg": 0, + "TotFileMergeZapEnd": 0, + "TotFileMergeZapIntroductionTime": 0, + "TotFileMergeZapTime": 0, + "TotFileSegmentsAtRoot": 1, + "TotIndexTime": 0, + "TotIndexedPlainTextBytes": 0, + "TotIntroduceLoop": 3, + "TotIntroduceMergeBeg": 0, + "TotIntroduceMergeEnd": 0, + "TotIntroducePersistBeg": 0, + "TotIntroducePersistEnd": 0, + "TotIntroduceRevertBeg": 0, + "TotIntroduceRevertEnd": 0, + "TotIntroduceSegmentBeg": 0, + "TotIntroduceSegmentEnd": 0, + "TotIntroducedItems": 0, + "TotIntroducedSegmentsBatch": 0, + "TotIntroducedSegmentsMerge": 0, + "TotItemsToPersist": 0, + "TotMemMergeBeg": 0, + "TotMemMergeDone": 0, + "TotMemMergeErr": 0, + "TotMemMergeSegments": 0, + "TotMemMergeZapBeg": 0, + "TotMemMergeZapEnd": 0, + "TotMemMergeZapTime": 0, + "TotMemorySegmentsAtRoot": 0, + "TotOnErrors": 0, + "TotPersistLoopBeg": 2, + "TotPersistLoopEnd": 1, + "TotPersistLoopErr": 0, + "TotPersistLoopProgress": 0, + "TotPersistLoopWait": 2, + "TotPersistLoopWaitNotified": 0, + "TotPersistedItems": 0, + "TotPersistedSegments": 0, + "TotPersisterMergerNapBreak": 1, + "TotPersisterNapPauseCompleted": 1, + "TotPersisterSlowMergerPause": 0, + "TotPersisterSlowMergerResume": 0, + "TotSnapshotsRemovedFromMetaStore": 0, + "TotTermSearchersFinished": 13, + "TotTermSearchersStarted": 13, + "TotUpdates": 0, + "analysis_time": 0, + "batches": 0, + "deletes": 0, + "errors": 0, + "index_time": 0, + "num_bytes_read_at_query_time": 294892, + "num_bytes_used_disk": 34007668, + "num_bytes_used_disk_by_root": 15644303, + "num_bytes_used_disk_by_root_reclaimable": 0, + "num_bytes_written_at_index_time": 0, + "num_files_on_disk": 4, + "num_items_introduced": 0, + "num_items_persisted": 0, + "num_persister_nap_merger_break": 1, + "num_persister_nap_pause_completed": 1, + "num_plain_text_bytes_indexed": 0, + "num_recs_to_persist": 0, + "num_root_filesegments": 1, + "num_root_memorysegments": 0, + "term_searchers_finished": 13, + "term_searchers_started": 13, + "total_compaction_written_bytes": 0, + "updates": 0 + }, + "search_time": 40353204, + "searches": 1 + }, + "basic": { + "DocCount": 917 + }, + "partitions": {}, + "copyPartitionStats": { + "TotCopyPartitionStart": 0, + "TotCopyPartitionFinished": 0, + "TotCopyPartitionTimeInMs": 0, + "TotCopyPartitionFailed": 0, + "TotCopyPartitionRetries": 0, + "TotCopyPartitionErrors": 0, + "TotCopyPartitionSkipped": 0, + "TotCopyPartitionCancelled": 0, + "TotCopyPartitionOnHttp2": 0 + } + } + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/g-api-stats.json b/docs/modules/fts-rest-indexing/examples/g-api-stats.json new file mode 100644 index 00000000..0fd37071 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/g-api-stats.json @@ -0,0 +1,41 @@ +{ + "feeds": { + "myFirstIndex_6cc599ab7a85bf3b": {} + }, + "manager": { + "TotCreateIndex": 1, + "TotCreateIndexOk": 1, + "TotDeleteIndex": 0, + "TotDeleteIndexOk": 0, + "TotIndexControl": 0, + "TotIndexControlOk": 0, + "TotJanitorClosePIndex": 0, + "TotJanitorKick": 2, + "TotJanitorKickErr": 0, + "TotJanitorKickOk": 2, + "TotJanitorKickStart": 2, + "TotJanitorNOOP": 0, + "TotJanitorNOOPOk": 0, + "TotJanitorRemovePIndex": 0, + "TotJanitorSubscriptionEvent": 0, + "TotJanitorUnknownErr": 0, + "TotKick": 0, + "TotPlannerKick": 2, + "TotPlannerKickChanged": 1, + "TotPlannerKickErr": 0, + "TotPlannerKickOk": 2, + "TotPlannerKickStart": 2, + "TotPlannerNOOP": 0, + "TotPlannerNOOPOk": 0, + "TotPlannerSubscriptionEvent": 0, + "TotPlannerUnknownErr": 0, + "TotSaveNodeDef": 2, + "TotSaveNodeDefGetErr": 0, + "TotSaveNodeDefOk": 2, + "TotSaveNodeDefSame": 0, + "TotSaveNodeDefSetErr": 0 + }, + "pindexes": { + "myFirstIndex_6cc599ab7a85bf3b_0": null + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-index-name-200.json b/docs/modules/fts-rest-indexing/examples/p-api-index-name-200.json new file mode 100644 index 00000000..203dee2d --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-index-name-200.json @@ -0,0 +1,5 @@ +{ + "status": "ok", + "name": "travel-test", + "uuid": "565ca041af3baf9d" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-index-name-default.json b/docs/modules/fts-rest-indexing/examples/p-api-index-name-default.json new file mode 100644 index 00000000..3df88f58 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-index-name-default.json @@ -0,0 +1,5 @@ +{ + "error": "rest_create_index: index type is required, indexName: travel-test", + "request": "", + "status": "fail" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-hybrid.json b/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-hybrid.json new file mode 100644 index 00000000..6a484c1b --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-hybrid.json @@ -0,0 +1,18 @@ +{ + "fields": ["*"], + "query": { + "min": 70, + "max": 80, + "inclusive_min": false, + "inclusive_max": true, + "field": "brightness" + }, + "knn": [ + { + "k": 10, + "field": "colorvect_dot", + "vector": [ 0.707106781186548, 0, 0.707106781186548 ] + } + ], + "size": 10 +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-options.json b/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-options.json new file mode 100644 index 00000000..6804db50 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-options.json @@ -0,0 +1,29 @@ +{ + "ctl": { + "timeout": 10000, + "consistency": { + "level": "at_plus", + "vectors": { + "customerIndex": { + "0": 123, + "1/a0b1c2": 234 + } + } + } + }, + "query": { + "query": "alice smith", + "boost": 1 + }, + "size": 10, + "from": 20, + "highlight": { + "style": null, + "fields": null + }, + "fields": [ + "*" + ], + "facets": null, + "explain": true +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-regular.json b/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-regular.json new file mode 100644 index 00000000..63931d17 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-index-name-query-regular.json @@ -0,0 +1,12 @@ +{ + "query": { + "query": "a sample query", + "boost": 1 + }, + "size": 10, + "from": 0, + "highlight": null, + "fields": null, + "facets": null, + "explain": false +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-200.json b/docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-200.json new file mode 100644 index 00000000..3a1acdf1 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-200.json @@ -0,0 +1,8 @@ +{ + "status": "ok", + "pindexes": { + "travel-sample.inventory.travel-test": { + "id": "travel-sample.inventory.travel-test_123294e5a4efbe39_4c1c5584" + } + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-body.json b/docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-body.json new file mode 100644 index 00000000..35a07516 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-body.json @@ -0,0 +1,3 @@ +{ + "docID": "hotel_5848" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-200.json b/docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-200.json new file mode 100644 index 00000000..9885ab48 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-200.json @@ -0,0 +1,5 @@ +{ + "status": "ok", + "name": "travel-sample.inventory.travel-test", + "uuid": "654cb62baebf2d26" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-default.json b/docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-default.json new file mode 100644 index 00000000..2ede4758 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-default.json @@ -0,0 +1,5 @@ +{ + "error": "rest_create_index: index type is required, indexName: travel-test", + "request": {}, + "status": "fail" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/p-api-scoped-query-default.json b/docs/modules/fts-rest-indexing/examples/p-api-scoped-query-default.json new file mode 100644 index 00000000..98bd2539 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/p-api-scoped-query-default.json @@ -0,0 +1,49 @@ +{ + "error": "rest_index: Query, indexName: travel-sample.inventory.travel-test, err: bleve: QueryBleve parsing searchRequest, err: unknown query type", + "request": { + "collections": [ + "hotel" + ], + "ctl": { + "consistency": { + "level": "at_plus", + "results": "complete", + "vectors": { + "searchIndexName": { + "607/205096593892159": 2, + "640/298739127912798": 4 + } + } + }, + "timeout": 10000 + }, + "explain": true, + "from": 0, + "highlight": { + "fields": [ + "reviews.content" + ], + "style": "html" + }, + "includeLocations": false, + "limit": 10, + "offset": 0, + "query": {}, + "score": "none", + "size": 10, + "sort": [ + "reviews.Ratings.Cleanliness", + { + "by": "field", + "desc": false, + "field": "reviews.Ratings.Cleanliness", + "missing": "last", + "mode": "default", + "type": "number" + }, + "-_score", + "-_id" + ] + }, + "status": "fail" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/examples/response-200.json b/docs/modules/fts-rest-indexing/examples/response-200.json new file mode 100644 index 00000000..b523aff9 --- /dev/null +++ b/docs/modules/fts-rest-indexing/examples/response-200.json @@ -0,0 +1,3 @@ +{ + "status": "ok" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/pages/index.adoc b/docs/modules/fts-rest-indexing/pages/index.adoc new file mode 100644 index 00000000..275779a7 --- /dev/null +++ b/docs/modules/fts-rest-indexing/pages/index.adoc @@ -0,0 +1,8085 @@ += Couchbase Search Index Management and Monitoring API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Search Indexing REST API is provided by the Search service. +This API enables you to manage and monitor your Search indexes. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Search Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Search Service REST port. Use `18094` for secure access. +-- + +[%hardbreaks] +*Values:* `8094`, `18094` +*Example:* `+++8094+++` +// end + +|=== + + +// markup not found, no include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 4 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +<> +<> +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Definitions] += Definitions +:leveloffset: +1 + +ifeval::["Use the following APIs to retrieve Search index definitions, create new Search indexes, or delete an existing Search index." != ""] +Use the following APIs to retrieve Search index definitions, create new Search indexes, or delete an existing Search index. +endif::[] +ifeval::["Use the following APIs to retrieve Search index definitions, create new Search indexes, or delete an existing Search index." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-before.adoc[opts=optional] + + +[#d-api-index-name] += Delete Index Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-begin.adoc[opts=optional] + + +.... +DELETE /api/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-description-before.adoc[opts=optional] + + +[#d-api-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Deletes the Search index definition specified in the endpoint URL. +-- + + +include::{specDir}paths/d-api-index-name/operation-description-end.adoc[opts=optional] + + + +[#d-api-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-parameters-before.adoc[opts=optional] + + +[#d-api-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#d-api-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-responses-before.adoc[opts=optional] + + +[#d-api-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + +| 0 +a| [markdown] +-- +The Search Service returns a non-200 HTTP error code when a request fails. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-security-before.adoc[opts=optional] + + +[#d-api-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}d-api-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}d-api-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/d-api-index-name/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-before.adoc[opts=optional] + + +[#d-api-scoped-index-name] += Delete Index Definition (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-begin.adoc[opts=optional] + + +.... +DELETE /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-description-before.adoc[opts=optional] + + +[#d-api-scoped-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Delete the Search index definition from the bucket and scope specified in the endpoint URL. +Unlike [Delete Index Definition](#d-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +-- + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-description-end.adoc[opts=optional] + + + +[#d-api-scoped-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-parameters-before.adoc[opts=optional] + + +[#d-api-scoped-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#d-api-scoped-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-responses-before.adoc[opts=optional] + + +[#d-api-scoped-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object indicating the status of the operation. +-- +a| <> + + +| 0 +a| [markdown] +-- +The Search Service returns a non-200 HTTP error code when a request fails. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-security-before.adoc[opts=optional] + + +[#d-api-scoped-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}d-api-scoped-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}d-api-scoped-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-before.adoc[opts=optional] + + +[#g-api-index] += Get All Search Index Definitions + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index/operation-begin.adoc[opts=optional] + + +.... +GET /api/index +.... + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-description-before.adoc[opts=optional] + + +[#g-api-index-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns all Search index definitions from the bucket where you have read permissions, as a JSON object. +-- + + +include::{specDir}paths/g-api-index/operation-description-end.adoc[opts=optional] + + + +[#g-api-index-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-responses-before.adoc[opts=optional] + + +[#g-api-index-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing all Search index definitions. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-index/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-security-before.adoc[opts=optional] + + +[#g-api-index-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-index/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-index/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-index/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-before.adoc[opts=optional] + + +[#g-api-index-name] += Get Index Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-begin.adoc[opts=optional] + + +.... +GET /api/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-description-before.adoc[opts=optional] + + +[#g-api-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the definition of the Search index specified in the endpoint URL as a JSON object. +-- + + +include::{specDir}paths/g-api-index-name/operation-description-end.adoc[opts=optional] + + + +[#g-api-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-parameters-before.adoc[opts=optional] + + +[#g-api-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-responses-before.adoc[opts=optional] + + +[#g-api-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the Search index definition. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-security-before.adoc[opts=optional] + + +[#g-api-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index-name/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-before.adoc[opts=optional] + + +[#g-api-scoped-index] += Get All Search Index Definitions (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-begin.adoc[opts=optional] + + +.... +GET /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index +.... + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-description-before.adoc[opts=optional] + + +[#g-api-scoped-index-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns all Search index definitions inside the bucket and scope specified in the endpoint URL as a JSON object. +-- + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-description-end.adoc[opts=optional] + + + +[#g-api-scoped-index-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-parameters-before.adoc[opts=optional] + + +[#g-api-scoped-index-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-scoped-index-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-responses-before.adoc[opts=optional] + + +[#g-api-scoped-index-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing all Search index definitions. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-security-before.adoc[opts=optional] + + +[#g-api-scoped-index-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-scoped-index/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}g-api-scoped-index/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-index/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-before.adoc[opts=optional] + + +[#g-api-scoped-index-name] += Get Index Definition (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-begin.adoc[opts=optional] + + +.... +GET /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-description-before.adoc[opts=optional] + + +[#g-api-scoped-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the Search index definition for the Search index specified in the endpoint URL as a JSON object. +Unlike [Get Index Definition](#g-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +-- + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-description-end.adoc[opts=optional] + + + +[#g-api-scoped-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-parameters-before.adoc[opts=optional] + + +[#g-api-scoped-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-scoped-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-responses-before.adoc[opts=optional] + + +[#g-api-scoped-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the Search index definition. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-security-before.adoc[opts=optional] + + +[#g-api-scoped-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-scoped-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-scoped-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-before.adoc[opts=optional] + + +[#p-api-index-name] += Create or Update an Index Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-begin.adoc[opts=optional] + + +.... +PUT /api/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-description-before.adoc[opts=optional] + + +[#p-api-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. +If the Search index already exists, this endpoint updates the Search index definition. +-- + + +include::{specDir}paths/p-api-index-name/operation-description-end.adoc[opts=optional] + + +[#p-api-index-name-consumes] +.Consumes +* application/json + +[#p-api-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-parameters-before.adoc[opts=optional] + + +[#p-api-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + +[#p-api-index-name-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +The full Search index definition. For a detailed list of all parameters for the request body, see [Search Index JSON Properties](../search/search-index-params.html). +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-responses-before.adoc[opts=optional] + + +[#p-api-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object indicating the status of the operation. +-- +a| <> + + +| 0 +a| [markdown] +-- +The Search Service returns a non-200 HTTP error code when a request fails. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-security-before.adoc[opts=optional] + + +[#p-api-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-index-name/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-before.adoc[opts=optional] + + +[#p-api-scoped-index-name] += Create or Update an Index Definition (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-begin.adoc[opts=optional] + + +.... +PUT /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-description-before.adoc[opts=optional] + + +[#p-api-scoped-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. +If the Search index already exists, this endpoint updates the Search index definition. +Unlike [Create or Update an Index Definition](#p-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +-- + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-description-end.adoc[opts=optional] + + +[#p-api-scoped-index-name-consumes] +.Consumes +* application/json + +[#p-api-scoped-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-parameters-before.adoc[opts=optional] + + +[#p-api-scoped-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-scoped-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +|=== + + + + +[#p-api-scoped-index-name-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +The full Search index definition. For a detailed list of all parameters for the request body, see [Search Index JSON Properties](../search/search-index-params.html). +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-responses-before.adoc[opts=optional] + + +[#p-api-scoped-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object indicating the status of the operation. +-- +a| <> + + +| 0 +a| [markdown] +-- +The Search Service returns a non-200 HTTP error code when a request fails. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-security-before.adoc[opts=optional] + + +[#p-api-scoped-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-scoped-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-scoped-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Management] += Management +:leveloffset: +1 + +ifeval::["Use the following endpoints to manage index controls, such as document ingestion, partition assignment, and queries." != ""] +Use the following endpoints to manage index controls, such as document ingestion, partition assignment, and queries. +endif::[] +ifeval::["Use the following endpoints to manage index controls, such as document ingestion, partition assignment, and queries." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-before.adoc[opts=optional] + + +[#p-api-idx-name-ingestcontrol] += Set Index Ingestion Control + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-begin.adoc[opts=optional] + + +.... +POST /api/index/{INDEX_NAME}/ingestControl/{OP} +.... + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-description-before.adoc[opts=optional] + + +[#p-api-idx-name-ingestcontrol-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. +While paused, the Search index does not load any new document mutations. +-- + + +include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-description-end.adoc[opts=optional] + + + +[#p-api-idx-name-ingestcontrol-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-parameters-before.adoc[opts=optional] + + +[#p-api-idx-name-ingestcontrol-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-idx-name-ingestcontrol-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *OP* + +_required_ +a¦ + + +[markdown] +-- +To pause ingestion and maintenance, set `{OP}` to `pause`. +To resume ingestion and maintenance on a paused index, set `{OP}` to `resume`. +-- + +[%hardbreaks] +*Values:* `"pause"`, `"resume"` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-responses-before.adoc[opts=optional] + + +[#p-api-idx-name-ingestcontrol-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-security-before.adoc[opts=optional] + + +[#p-api-idx-name-ingestcontrol-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-idx-name-ingestcontrol/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-idx-name-ingestcontrol/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-before.adoc[opts=optional] + + +[#p-api-idx-name-planfreezecontrol] += Freeze Index Partition Assignment + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-begin.adoc[opts=optional] + + +.... +POST /api/index/{INDEX_NAME}/planFreezeControl/{OP} +.... + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-description-before.adoc[opts=optional] + + +[#p-api-idx-name-planfreezecontrol-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. +While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. +-- + + +include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-description-end.adoc[opts=optional] + + + +[#p-api-idx-name-planfreezecontrol-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-parameters-before.adoc[opts=optional] + + +[#p-api-idx-name-planfreezecontrol-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-idx-name-planfreezecontrol-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *OP* + +_required_ +a¦ + + +[markdown] +-- +To freeze partition assignment, set `{OP}` to `freeze`. +To unfreeze partition assignment on a frozen index, set `{OP}` to `unfreeze`. +-- + +[%hardbreaks] +*Values:* `"freeze"`, `"unfreeze"` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-responses-before.adoc[opts=optional] + + +[#p-api-idx-name-planfreezecontrol-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-security-before.adoc[opts=optional] + + +[#p-api-idx-name-planfreezecontrol-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-idx-name-planfreezecontrol/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-idx-name-planfreezecontrol/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-before.adoc[opts=optional] + + +[#p-api-idx-name-querycontrol] += Stop Queries on an Index + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-begin.adoc[opts=optional] + + +.... +POST /api/index/{INDEX_NAME}/queryControl/{OP} +.... + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-description-before.adoc[opts=optional] + + +[#p-api-idx-name-querycontrol-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +For the Search index specified in the endpoint URL, disallow or allow queries. +While queries are disallowed, users see an error that the Search index's partitions could not be reached. +-- + + +include::{specDir}paths/p-api-idx-name-querycontrol/operation-description-end.adoc[opts=optional] + + + +[#p-api-idx-name-querycontrol-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-parameters-before.adoc[opts=optional] + + +[#p-api-idx-name-querycontrol-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-idx-name-querycontrol-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *OP* + +_required_ +a¦ + + +[markdown] +-- +To allow queries against a Search index, set `{OP}` to `allow`. +To block queries against a Search index, set `{OP}` to `disallow`. +-- + +[%hardbreaks] +*Values:* `"allow"`, `"disallow"` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-responses-before.adoc[opts=optional] + + +[#p-api-idx-name-querycontrol-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-security-before.adoc[opts=optional] + + +[#p-api-idx-name-querycontrol-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-idx-name-querycontrol/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-idx-name-querycontrol/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-before.adoc[opts=optional] + + +[#p-api-scoped-ingestcontrol] += Set Index Ingestion Control (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-begin.adoc[opts=optional] + + +.... +POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/ingestControl/{OP} +.... + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-description-before.adoc[opts=optional] + + +[#p-api-scoped-ingestcontrol-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. +While paused, the Search index does not load any new document mutations. +Unlike [Set Index Ingestion Control](#p-api-idx-name-ingestcontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +-- + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-description-end.adoc[opts=optional] + + + +[#p-api-scoped-ingestcontrol-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-parameters-before.adoc[opts=optional] + + +[#p-api-scoped-ingestcontrol-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-scoped-ingestcontrol-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +a¦ *OP* + +_required_ +a¦ + + +[markdown] +-- +To pause ingestion and maintenance, set `{OP}` to `pause`. +To resume ingestion and maintenance on a paused index, set `{OP}` to `resume`. +-- + +[%hardbreaks] +*Values:* `"pause"`, `"resume"` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-responses-before.adoc[opts=optional] + + +[#p-api-scoped-ingestcontrol-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-security-before.adoc[opts=optional] + + +[#p-api-scoped-ingestcontrol-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-scoped-ingestcontrol/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-scoped-ingestcontrol/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-before.adoc[opts=optional] + + +[#p-api-scoped-planfreezecontrol] += Freeze Index Partition Assignment (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-begin.adoc[opts=optional] + + +.... +POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/planFreezeControl/{OP} +.... + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-description-before.adoc[opts=optional] + + +[#p-api-scoped-planfreezecontrol-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. +While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. +Unlike [Freeze Index Partition Assignment](#p-api-idx-name-planfreezecontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +-- + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-description-end.adoc[opts=optional] + + + +[#p-api-scoped-planfreezecontrol-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-parameters-before.adoc[opts=optional] + + +[#p-api-scoped-planfreezecontrol-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-scoped-planfreezecontrol-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +a¦ *OP* + +_required_ +a¦ + + +[markdown] +-- +To freeze partition assignment, set `{OP}` to `freeze`. +To unfreeze partition assignment on a frozen index, set `{OP}` to `unfreeze`. +-- + +[%hardbreaks] +*Values:* `"freeze"`, `"unfreeze"` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-responses-before.adoc[opts=optional] + + +[#p-api-scoped-planfreezecontrol-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-security-before.adoc[opts=optional] + + +[#p-api-scoped-planfreezecontrol-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-scoped-planfreezecontrol/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-scoped-planfreezecontrol/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-before.adoc[opts=optional] + + +[#p-api-scoped-querycontrol] += Stop Queries on an Index (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-begin.adoc[opts=optional] + + +.... +POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/queryControl/{OP} +.... + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-description-before.adoc[opts=optional] + + +[#p-api-scoped-querycontrol-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +For the Search index specified in the endpoint URL, disallow or allow queries. +While queries are disallowed, users see an error that the Search index's partitions could not be reached. +Unlike [Stop Queries on an Index](#p-api-idx-name-querycontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +-- + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-description-end.adoc[opts=optional] + + + +[#p-api-scoped-querycontrol-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-parameters-before.adoc[opts=optional] + + +[#p-api-scoped-querycontrol-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-scoped-querycontrol-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +a¦ *OP* + +_required_ +a¦ + + +[markdown] +-- +To allow queries against a Search index, set `{OP}` to `allow`. +To block queries against a Search index, set `{OP}` to `disallow`. +-- + +[%hardbreaks] +*Values:* `"allow"`, `"disallow"` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-responses-before.adoc[opts=optional] + + +[#p-api-scoped-querycontrol-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-security-before.adoc[opts=optional] + + +[#p-api-scoped-querycontrol-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-scoped-querycontrol/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-scoped-querycontrol/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Monitoring] += Monitoring +:leveloffset: +1 + +ifeval::["Use the following endpoints to get statistics about Search indexes for monitoring and debugging." != ""] +Use the following endpoints to get statistics about Search indexes for monitoring and debugging. +endif::[] +ifeval::["Use the following endpoints to get statistics about Search indexes for monitoring and debugging." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-before.adoc[opts=optional] + + +[#g-api-scoped-status] += Get Index Status (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-begin.adoc[opts=optional] + + +.... +GET /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/status +.... + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-description-before.adoc[opts=optional] + + +[#g-api-scoped-status-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the status of the Search index specified in the endpoint URL, including whether all index partitions are created and ready to use. + +-- + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-description-end.adoc[opts=optional] + + + +[#g-api-scoped-status-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-parameters-before.adoc[opts=optional] + + +[#g-api-scoped-status-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-scoped-status-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-responses-before.adoc[opts=optional] + + +[#g-api-scoped-status-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-security-before.adoc[opts=optional] + + +[#g-api-scoped-status-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-scoped-status/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-scoped-status/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-scoped-status/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-before.adoc[opts=optional] + + +[#g-api-stats] += Get Indexing and Data Metrics for All Indexes + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats/operation-begin.adoc[opts=optional] + + +.... +GET /api/stats +.... + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-description-before.adoc[opts=optional] + + +[#g-api-stats-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns indexing and data-related metrics, timings, counters, and detailed partition information for all Search indexes, from the node running the Search Service. + +This endpoint returns statistics provided by the Search service. +For additional statistics, see [Get Query, Mutation, and Partition Statistics for the Search Service](../fts-rest-stats/index.html#g-api-nsstats). +-- + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-description-end.adoc[opts=optional] + + + +[#g-api-stats-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-responses-before.adoc[opts=optional] + + +[#g-api-stats-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing indexing and data metrics. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-security-before.adoc[opts=optional] + + +[#g-api-stats-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-stats/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-stats/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-before.adoc[opts=optional] + + +[#g-api-stats-index-name] += Get Indexing and Data Metrics for an Index + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-begin.adoc[opts=optional] + + +.... +GET /api/stats/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-description-before.adoc[opts=optional] + + +[#g-api-stats-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns indexing and data-related metrics, timings, counters, and detailed partition information for the Search index specified in the endpoint URL. + +This endpoint returns statistics provided by the Search service. +For additional statistics, see [Get Query, Mutation, and Partition Statistics for an Index](../fts-rest-stats/index.html#g-api-nsstats-index-name). +-- + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-description-end.adoc[opts=optional] + + + +[#g-api-stats-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-parameters-before.adoc[opts=optional] + + +[#g-api-stats-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-stats-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-responses-before.adoc[opts=optional] + + +[#g-api-stats-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing statistics for the specified Search index. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-security-before.adoc[opts=optional] + + +[#g-api-stats-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-stats-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-stats-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-before.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc] += Analyze Document + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-begin.adoc[opts=optional] + + +.... +POST /api/index/{INDEX_NAME}/analyzeDoc +.... + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-description-before.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Use the Search index specified in the endpoint URL to analyze a document from the request body. + +-- + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-description-end.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc-consumes] +.Consumes +* application/json + +[#g-api-stats-index-name-analyzeDoc-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-parameters-before.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + +[#g-api-stats-index-name-analyzeDoc-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +Add any valid JSON document to the request body. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-responses-before.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the analysis of the provided document. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-security-before.adoc[opts=optional] + + +[#g-api-stats-index-name-analyzeDoc-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}g-api-stats-index-name-analyzeDoc/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-stats-index-name-analyzeDoc/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Querying] += Querying +:leveloffset: +1 + +ifeval::["Use the following endpoints to query the contents of a Search index." != ""] +Use the following endpoints to query the contents of a Search index. +endif::[] +ifeval::["Use the following endpoints to query the contents of a Search index." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-before.adoc[opts=optional] + + +[#g-api-index-name-count] += Get Document Count for an Index + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-begin.adoc[opts=optional] + + +.... +GET /api/index/{INDEX_NAME}/count +.... + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-description-before.adoc[opts=optional] + + +[#g-api-index-name-count-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the number of documents indexed in the specified Search index. + +-- + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-description-end.adoc[opts=optional] + + + +[#g-api-index-name-count-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-parameters-before.adoc[opts=optional] + + +[#g-api-index-name-count-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-index-name-count-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-responses-before.adoc[opts=optional] + + +[#g-api-index-name-count-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-security-before.adoc[opts=optional] + + +[#g-api-index-name-count-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-index-name-count/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-index-name-count/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-index-name-count/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-before.adoc[opts=optional] + + +[#p-api-index-name-query] += Query a Search Index + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-begin.adoc[opts=optional] + + +.... +POST /api/index/{INDEX_NAME}/query +.... + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-description-before.adoc[opts=optional] + + +[#p-api-index-name-query-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. +The endpoint returns a JSON object as a response. + +-- + + +include::{specDir}paths/p-api-index-name-query/operation-description-end.adoc[opts=optional] + + +[#p-api-index-name-query-consumes] +.Consumes +* application/json + +[#p-api-index-name-query-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-parameters-before.adoc[opts=optional] + + +[#p-api-index-name-query-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-index-name-query-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + +[#p-api-index-name-query-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A JSON object to define the settings for your Search query. For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-responses-before.adoc[opts=optional] + + +[#p-api-index-name-query-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The response object has a status section that must be checked for every request. Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +include::{specDir}paths/p-api-index-name-query/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-security-before.adoc[opts=optional] + + +[#p-api-index-name-query-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}p-api-index-name-query/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}p-api-index-name-query/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-index-name-query/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-before.adoc[opts=optional] + + +[#p-api-pindex-lookup] += Look Up the Index Partition for a Document (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-begin.adoc[opts=optional] + + +.... +POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/pindexLookup +.... + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-description-before.adoc[opts=optional] + + +[#p-api-pindex-lookup-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Send a document ID in the request body and return the Search index partition ID where the document is stored. +The endpoint returns a JSON object as a response. + +-- + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-description-end.adoc[opts=optional] + + +[#p-api-pindex-lookup-consumes] +.Consumes +* application/json + +[#p-api-pindex-lookup-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-parameters-before.adoc[opts=optional] + + +[#p-api-pindex-lookup-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-pindex-lookup-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +|=== + + + + +[#p-api-pindex-lookup-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A valid JSON object that contains the docID property, with a value that matches the document ID for a document in the Search index. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-responses-before.adoc[opts=optional] + + +[#p-api-pindex-lookup-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns a response that includes the status `ok`. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-security-before.adoc[opts=optional] + + +[#p-api-pindex-lookup-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}p-api-pindex-lookup/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-pindex-lookup/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-before.adoc[opts=optional] + + +[#p-api-scoped-query] += Query a Search Index (Scoped) + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-begin.adoc[opts=optional] + + +.... +POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/query +.... + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-description-before.adoc[opts=optional] + + +[#p-api-scoped-query-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. +The endpoint returns a JSON object as a response. +Unlike [Query a Search Index](#p-api-index-name-query), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + +-- + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-description-end.adoc[opts=optional] + + +[#p-api-scoped-query-consumes] +.Consumes +* application/json + +[#p-api-scoped-query-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-parameters-before.adoc[opts=optional] + + +[#p-api-scoped-query-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-parameters-begin.adoc[opts=optional] + + +[#p-api-scoped-query-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *BUCKET_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the bucket containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *SCOPE_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the scope containing the Search index definition. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +-- + +[%hardbreaks] +*Pattern:* `+++/^[A-Za-z][0-9A-Za-z_\\-]*$/+++` +{blank} + +a¦ String + + + +|=== + + + + +[#p-api-scoped-query-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +A JSON object to define the settings for your Search query. For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-responses-before.adoc[opts=optional] + + +[#p-api-scoped-query-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The response object has a status section that must be checked for every request. Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. +-- +a| <> + + +| 0 +a| [markdown] +-- +The Search Service returns a non-200 HTTP error code when a request fails. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-security-before.adoc[opts=optional] + + +[#p-api-scoped-query-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}p-api-scoped-query/http-request.adoc[opts=optional] + + +include::{snippetDir}p-api-scoped-query/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/p-api-scoped-query/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 27 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +endif::[] + + + +// markup not found, no include::{specDir}definitions/DeleteIndexResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DeleteIndexResponse] += Delete Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DeleteIndexResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DeleteIndexResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::DeleteIndexResponse[] + + + + +// markup not found, no include::{specDir}definitions/DeleteIndexResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DeleteIndexResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysis/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DocumentAnalysis] += Document Analysis + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysis/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DocumentAnalysis[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*analyzed* + +_optional_ +a¦ + +[markdown] +-- +An array of objects containing the analysis of the document. +-- + +[%hardbreaks] +{blank} +a¦ <> + array + +|=== + +//end::DocumentAnalysis[] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysis/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysis/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItem/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DocumentAnalysisItem] += Analysis Item + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItem/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DocumentAnalysisItem[] + +ifdef::model-descriptions[] +//tag::desc-DocumentAnalysisItem[] +An object containing 1 or more search terms or tokens from the analyzed document. +//end::desc-DocumentAnalysisItem[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-DocumentAnalysisItemToken, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::DocumentAnalysisItem[] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItem/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItem/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemToken/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DocumentAnalysisItemToken] += Analysis Token + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemToken/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DocumentAnalysisItemToken[] + +ifdef::model-descriptions[] +//tag::desc-DocumentAnalysisItemToken[] +An object containing the analysis of a single search term or token from the analyzed document. +The name of the property is the search term or token. +//end::desc-DocumentAnalysisItemToken[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*Term* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*Locations* + +_optional_ +a¦ + +[markdown] +-- +An array of objects describing the locations of the search term or token in the document. +-- + +[%hardbreaks] +{blank} +a¦ <> + array + +|=== + +//end::DocumentAnalysisItemToken[] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemToken/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemToken/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemTokenLocation/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DocumentAnalysisItemTokenLocation] += Analysis Token Location + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemTokenLocation/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DocumentAnalysisItemTokenLocation[] + +ifdef::model-descriptions[] +//tag::desc-DocumentAnalysisItemTokenLocation[] +An object describing the location of a single instance of the search term or token in the analyzed document. +//end::desc-DocumentAnalysisItemTokenLocation[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*Field* + +_optional_ +a¦ + +[markdown] +-- +The field in the document where the token was found. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*ArrayPositions* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Any Type + array + +a¦ +*Start* + +_optional_ +a¦ + +[markdown] +-- +The starting point of the token in the field. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*End* + +_optional_ +a¦ + +[markdown] +-- +The ending point of the token in the field. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*Position* + +_optional_ +a¦ + +[markdown] +-- +The position of the token in the field. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::DocumentAnalysisItemTokenLocation[] + + + + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemTokenLocation/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DocumentAnalysisItemTokenLocation/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#DocumentCount] += Document Count + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::DocumentCount[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*count* + +_optional_ +a¦ + +[markdown] +-- +The document count for the specified index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::DocumentCount[] + + + + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/DocumentCount/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponse] += Index Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexDef* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-IndexDefinition, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*planPIndexes* + +_optional_ +a¦ + +[markdown] +-- +An array of objects, each containing information about a single Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ <> + array + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*warnings* + +_optional_ +a¦ + +[markdown] +-- +An array of warnings. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +|=== + +//end::GetIndexResponse[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePIndex] += Plan Partition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePIndex[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePIndex[] +An object containing information about a single Search index partition. +//end::desc-GetIndexResponsePIndex[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexName* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexParams* + +_optional_ +a¦ + +[markdown] +-- +The Search index's type identifier, type mappings, and analyzers. +For more information, see [Params Object](../search/search-index-params.html#params). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*indexType* + +_optional_ +a¦ + +[markdown] +-- +The type of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*name* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*nodes* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*sourceName* + +_optional_ +a¦ + +[markdown] +-- +The name of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceParams* + +_optional_ +a¦ + +[markdown] +-- +Advanced settings for Search index behavior. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*sourcePartitions* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceType* + +_optional_ +a¦ + +[markdown] +-- +The type of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::GetIndexResponsePIndex[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePIndexNodesWrapper] += Partition Nodes Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePIndexNodesWrapper[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePIndexNodesWrapper[] +An object containing information about 1 or more Search index partition nodes. +//end::desc-GetIndexResponsePIndexNodesWrapper[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapperNode, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::GetIndexResponsePIndexNodesWrapper[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePIndexNodesWrapperNode] += Partition Node + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePIndexNodesWrapperNode[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePIndexNodesWrapperNode[] +An object containing information about a single Search index partition node. +The name of the property is the node UUID. +//end::desc-GetIndexResponsePIndexNodesWrapperNode[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*canRead* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*canWrite* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*priority* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::GetIndexResponsePIndexNodesWrapperNode[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexesResponse] += Indexes Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexesResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexDefs* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexesResponseIndexes, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::GetIndexesResponse[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexes/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexesResponseIndexes] += Index Definitions + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexes/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexesResponseIndexes[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexesResponseIndexes[] +An object containing Search index definitions and related information. +//end::desc-GetIndexesResponseIndexes[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*implVersion* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexDefs* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexesResponseIndexesWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::GetIndexesResponseIndexes[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexes/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexes/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexesResponseIndexesWrapper] += Index Definitions Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexesResponseIndexesWrapper[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexesResponseIndexesWrapper[] +An object containing 1 or more Search index definitions. +//end::desc-GetIndexesResponseIndexesWrapper[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-IndexDefinition, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::GetIndexesResponseIndexesWrapper[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#IndexDefinition] += Index Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::IndexDefinition[] + +ifdef::model-descriptions[] +//tag::desc-IndexDefinition[] +The full Search index definition. +For a detailed list of all parameters, see [Search Index JSON Properties](../search/search-index-params.html). +//end::desc-IndexDefinition[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*name* + +_required_ +a¦ + +[markdown] +-- +The name of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*type* + +_required_ +a¦ + +[markdown] +-- +The type of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceName* + +_required_ +a¦ + +[markdown] +-- +The name of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceParams* + +_optional_ +a¦ + +[markdown] +-- +Advanced settings for Search index behavior. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*sourceType* + +_required_ +a¦ + +[markdown] +-- +The type of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*params* + +_required_ +a¦ + +[markdown] +-- +The Search index's type identifier, type mappings, and analyzers. +For more information, see [Params Object](../search/search-index-params.html#params). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*planParams* + +_required_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-IndexDefinitionPlanParams, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*prevIndexUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the previous index. +Intended for clients that want to check that they are not overwriting the Search index definition updates of concurrent clients. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::IndexDefinition[] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#IndexDefinitionPlanParams] += Plan Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::IndexDefinitionPlanParams[] + +ifdef::model-descriptions[] +//tag::desc-IndexDefinitionPlanParams[] +The Search index's partitioning and replication settings. +For more information, see [Plan Params Object](../search/search-index-params.html#planParams). +//end::desc-IndexDefinitionPlanParams[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*hierarchyRules* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*maxPartitionsPerPIndex* + +_optional_ +a¦ + +[markdown] +-- +This setting is deprecated. +Use `indexPartitions` instead. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*indexPartitions* + +_optional_ +a¦ + +[markdown] +-- +The number of partitions to split the Search index into, across the nodes you have available in your database with the Search Service enabled. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*nodePlanParams* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*numReplicas* + +_optional_ +a¦ + +[markdown] +-- +The number of replicas the Search Service creates for the Search index to ensure high availability. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*planFrozen* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +|=== + +//end::IndexDefinitionPlanParams[] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/LookupRequest/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#LookupRequest] += Lookup Request + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/LookupRequest/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::LookupRequest[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*docID* + +_optional_ +a¦ + +[markdown] +-- +The document ID to look up in the Search index. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::LookupRequest[] + + + + +// markup not found, no include::{specDir}definitions/LookupRequest/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/LookupRequest/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/LookupResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#LookupResponse] += Lookup Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/LookupResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::LookupResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*pindexes* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-LookupResponsePartitions, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::LookupResponse[] + + + + +// markup not found, no include::{specDir}definitions/LookupResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/LookupResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/LookupResponsePartitions/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#LookupResponsePartitions] += Lookup Partition Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/LookupResponsePartitions/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::LookupResponsePartitions[] + +ifdef::model-descriptions[] +//tag::desc-LookupResponsePartitions[] +An object containing information about 1 or more Search index partitions. +//end::desc-LookupResponsePartitions[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-LookupResponsePartitionsID, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::LookupResponsePartitions[] + + + + +// markup not found, no include::{specDir}definitions/LookupResponsePartitions/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/LookupResponsePartitions/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/LookupResponsePartitionsID/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#LookupResponsePartitionsID] += Lookup Partition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/LookupResponsePartitionsID/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::LookupResponsePartitionsID[] + +ifdef::model-descriptions[] +//tag::desc-LookupResponsePartitionsID[] +An object containing information about a single Search index partition. +The name of the property is the Search index partition name. +//end::desc-LookupResponsePartitionsID[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*id* + +_optional_ +a¦ + +[markdown] +-- +The Search index partition ID. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::LookupResponsePartitionsID[] + + + + +// markup not found, no include::{specDir}definitions/LookupResponsePartitionsID/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/LookupResponsePartitionsID/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/MgmtResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#MgmtResponse] += Management Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/MgmtResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::MgmtResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::MgmtResponse[] + + + + +// markup not found, no include::{specDir}definitions/MgmtResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/MgmtResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/PutIndexResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#PutIndexResponse] += Create or Update Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/PutIndexResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::PutIndexResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*name* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::PutIndexResponse[] + + + + +// markup not found, no include::{specDir}definitions/PutIndexResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/PutIndexResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#QueryRequest] += Query Request + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::QueryRequest[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*query* + +_optional_ +a¦ + +[markdown] +-- +An object that contains the properties for one of the supported query types. +For more information, see [Query Object](../search/search-request-params.html#query-object). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*knn* + +_optional_ +a¦ + +[markdown] +-- +An array that contains objects that describe a Vector Search query. +For more information, see [Knn Objects](../search/search-request-params.html#knn-object). +-- + +[%hardbreaks] +{blank} +a¦ Object + array + +a¦ +*ctl* + +_optional_ +a¦ + +[markdown] +-- +An object that contains properties for query consistency. +For more information, see [Ctl Object](../search/search-request-params.html#ctl). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*size* + +_optional_ +a¦ + +[markdown] +-- +Set the total number of results to return for a single page of search results. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*from* + +_optional_ +a¦ + +[markdown] +-- +Set an offset value to change where pagination starts for search results. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*highlight* + +_optional_ +a¦ + +[markdown] +-- +Contains properties to control search result highlighting. +For more information, see [Highlight Objects](../search/search-request-params.html#highlight). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*fields* + +_optional_ +a¦ + +[markdown] +-- +An array of strings to specify each indexed field you want to return in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*facets* + +_optional_ +a¦ + +[markdown] +-- +Contains nested objects to define each facet you want to return with search results. +For more information, see [Facet Objects](../search/search-request-params.html#facet-name). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*explain* + +_optional_ +a¦ + +[markdown] +-- +Whether to create an explanation for a search result's score in search results. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*sort* + +_optional_ +a¦ + +[markdown] +-- +Contains an array of strings or JSON objects to set how to sort search results. +For more information, see [Sort Object](../search/search-request-params.html#sort). +-- + +[%hardbreaks] +{blank} +a¦ Any Type + array + +a¦ +*includeLocations* + +_optional_ +a¦ + +[markdown] +-- +Whether to return the position of each occurrence of a search term inside a document. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*score* + +_optional_ +a¦ + +[markdown] +-- +Whether to include document relevancy scoring in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*search_after* + +_optional_ +a¦ + +[markdown] +-- +Use to control pagination in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*search_before* + +_optional_ +a¦ + +[markdown] +-- +Use to control pagination in search results. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +a¦ +*collections* + +_optional_ +a¦ + +[markdown] +-- +An array of strings that specify the collections where you want to run the query. +-- + +[%hardbreaks] +{blank} +a¦ String + array + +|=== + +//end::QueryRequest[] + + + + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/QueryRequest/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#QueryResponse] += Query Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::QueryResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*results* + +_optional_ +a¦ + +[markdown] +-- +The results of the Search query. +-- + +[%hardbreaks] +{blank} +a¦ Object + array + +|=== + +//end::QueryResponse[] + + + + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/QueryResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/StatsIndexResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#StatsIndexResponse] += Index Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/StatsIndexResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::StatsIndexResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*feeds* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*pindexes* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Object + + +|=== + +//end::StatsIndexResponse[] + + + + +// markup not found, no include::{specDir}definitions/StatsIndexResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/StatsIndexResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/StatsNodeResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#StatsNodeResponse] += Node Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/StatsNodeResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::StatsNodeResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*feeds* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*manager* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-StatsNodeResponseMgr, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*pindexes* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Object + + +|=== + +//end::StatsNodeResponse[] + + + + +// markup not found, no include::{specDir}definitions/StatsNodeResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/StatsNodeResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/StatsNodeResponseMgr/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#StatsNodeResponseMgr] += Manager Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/StatsNodeResponseMgr/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::StatsNodeResponseMgr[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*TotCreateIndex* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotDeleteIndex* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotUpdateIndex* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchIntro* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchIntroFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchUpdate* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchUpdateFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchDelete* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchDeleteFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBatchGet* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestStart* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestStop* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestRemove* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestUpdate* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestUpdateFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestIntro* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestIntroFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestBatch* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestBatchFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestDelete* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestDeleteFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestClose* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotBleveDestCloseFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotQuery* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*TotQueryFail* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::StatsNodeResponseMgr[] + + + + +// markup not found, no include::{specDir}definitions/StatsNodeResponseMgr/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/StatsNodeResponseMgr/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/StatusResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#StatusResponse] += Status Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/StatusResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::StatusResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexStatus* + +_optional_ +a¦ + +[markdown] +-- +The status of the Search index. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::StatusResponse[] + + + + +// markup not found, no include::{specDir}definitions/StatusResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/StatusResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Manage/security-scheme-before.adoc[opts=optional] + + +[[security-manage]] += Manage + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Manage/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!manage` permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Manage/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Manage/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Statistics/security-scheme-before.adoc[opts=optional] + + +[[security-statistics]] += Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Statistics/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].stats!read` permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Statistics/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Statistics/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Read/security-scheme-before.adoc[opts=optional] + + +[[security-read]] += Read + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Read/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Reader** or **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!read` permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Read/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Read/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Write/security-scheme-before.adoc[opts=optional] + + +[[security-write]] += Write + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Write/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!write` permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Write/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Write/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/fts-rest-indexing/partials/header-attributes.adoc b/docs/modules/fts-rest-indexing/partials/header-attributes.adoc new file mode 100644 index 00000000..460f9988 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: rest-api:rest-fts-indexing.adoc +:!example-caption: +:description: The Search Indexing REST API is provided by the Search Service. \ +This API enables you to manage and monitor your Search indexes. diff --git a/docs/modules/fts-rest-indexing/partials/overview/document-before.adoc b/docs/modules/fts-rest-indexing/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/http-response.adoc new file mode 100644 index 00000000..08be0a1b --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/http-response.adoc @@ -0,0 +1,17 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$d-api-index-name-200.json[] +---- +==== + +==== +.Failure Response +[source,json] +---- +include::example$d-api-index-name-default.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/operation-description-end.adoc new file mode 100644 index 00000000..271a4840 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/d-api-index-name/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/d-api-scoped-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/d-api-scoped-index-name/http-response.adoc new file mode 100644 index 00000000..f759ea82 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/d-api-scoped-index-name/http-response.adoc @@ -0,0 +1,17 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$d-api-scoped-index-name-200.json[] +---- +==== + +==== +.Failure Response +[source,json] +---- +include::example$d-api-scoped-index-name-default.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name-count/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name-count/http-response.adoc new file mode 100644 index 00000000..cd70782e --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name-count/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-index-name-count.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/http-response.adoc new file mode 100644 index 00000000..709a3e8d --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-index-name.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/operation-description-end.adoc new file mode 100644 index 00000000..fa9c62f0 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-index-name/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-index/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-index/http-response.adoc new file mode 100644 index 00000000..33a36899 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-index/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-index.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-index/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-index/operation-description-end.adoc new file mode 100644 index 00000000..6552a579 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-index/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-index-name/http-response.adoc new file mode 100644 index 00000000..4a1bb595 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-index-name/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Sample Response for a Vector Search index +[source,json] +---- +include::example$fts-sample-index-def-response.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-indexes/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-indexes/http-response.adoc new file mode 100644 index 00000000..72895fe8 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-indexes/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-scoped-indexes.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-status/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-status/http-response.adoc new file mode 100644 index 00000000..95f9ad34 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-scoped-status/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-scoped-status.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-request.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-request.adoc new file mode 100644 index 00000000..87b5caad --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-request.adoc @@ -0,0 +1,9 @@ += Example Request Body + +[#ex-g-api-stats-index-name-analyzeDoc] +==== +[source,json] +---- +include::example$g-api-stats-index-name-analyzeDoc-body.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-response.adoc new file mode 100644 index 00000000..d431e728 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name-analyzeDoc/http-response.adoc @@ -0,0 +1,15 @@ += Example HTTP Response + +The following example shows the result of analyzing the document from the <> using a Search index with the following settings: + +* A `keyword` analyzer for the `title` field. + +* An `ngram` token filter with a `min` of 2 and a `max` of 5 for the `name` field. + +==== +.Response 200 +[source,json] +---- +include::example$g-api-stats-index-name-analyzeDoc-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name/http-response.adoc new file mode 100644 index 00000000..0e51e503 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats-index-name/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-stats-index-name.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/g-api-stats/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats/http-response.adoc new file mode 100644 index 00000000..5036eb30 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/g-api-stats/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-stats.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/http-response.adoc new file mode 100644 index 00000000..4991e439 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$response-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/operation-description-end.adoc new file mode 100644 index 00000000..b12f5c5e --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-ingestcontrol/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/http-response.adoc new file mode 100644 index 00000000..4991e439 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$response-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/operation-description-end.adoc new file mode 100644 index 00000000..3340e661 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-planfreezecontrol/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/http-response.adoc new file mode 100644 index 00000000..4991e439 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$response-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/operation-description-end.adoc new file mode 100644 index 00000000..ed59ae59 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-idx-name-querycontrol/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/http-request.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/http-request.adoc new file mode 100644 index 00000000..dbe0d26c --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/http-request.adoc @@ -0,0 +1,31 @@ += Example Request Body + +The following request body searches for the text a sample query in the documents included in the Search index. + +==== +[source,json] +---- +include::example$p-api-index-name-query-regular.json[] +---- +==== + +The following request body uses from/size for results paging, uses `ctl` for a timeout and the `"at_plus"` consistency level. +On consistency, the index must have incorporated at least mutation sequence-number 123 for partition (vbucket) 0 and mutation sequence-number 234 for partition (vbucket) 1, where vbucket 1 should have a `vbucketUUID` of `a0b1c2`. + +==== +[source,json] +---- +include::example$p-api-index-name-query-options.json[] +---- +==== + +The following hybrid search request body searches for a specified normalized color vector in `colorvect_dot`, but uses regular query parameters to limit the `brightness` value of the returned color to the range of `70-80`: + +==== +[source,json] +---- +include::example$p-api-index-name-query-hybrid.json[] +---- +==== + +For more information about vector searches, see xref:vector-search:vector-search.adoc[]. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-description-end.adoc new file mode 100644 index 00000000..28b483f1 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-responses-after.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-responses-after.adoc new file mode 100644 index 00000000..dd79656d --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name-query/operation-responses-after.adoc @@ -0,0 +1,18 @@ += Consistency and Timeouts + +A query can specify a timeout value, a consistency requirement, or both. +This section explains how this affects the query behavior and how to handle the resulting query return values. + +* Logical first phase consistency wait -- if timeout in this period, get 416 error with message saying request could not be satisfied. + +* If consistency wait times out with 416, return value to client will indicate the sequence number range processed so the client will have an idea how far the processing got and has the option of retrying more intelligently. + +* In phase 2, you have the normal pindex timeout. +This will start whenever the first phase completes. +At this point, request will return 200 HTTP response code unless there is an internal server error. + +* Client must check response status, which will return any errors or timeouts for each pindex. +If the response includes the number of errors, and the client can determine whether they need the complete results or can continue as long as enough pindexes return to give a reasonable user experience. +Note that the query return status will be 200 even if all pindexes return errors so it's critical to check the response status and code accordingly. + +* If client sets timeout very low, e.g. 1ms, you may receive a 200 error with all timeouts instead of a consistency wait timeout. diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/http-response.adoc new file mode 100644 index 00000000..1dcc20a8 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/http-response.adoc @@ -0,0 +1,17 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$p-api-index-name-200.json[] +---- +==== + +==== +.Failure Response +[source,json] +---- +include::example$p-api-index-name-default.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/operation-description-end.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/operation-description-end.adoc new file mode 100644 index 00000000..861b84bd --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-index-name/operation-description-end.adoc @@ -0,0 +1,2 @@ +NOTE: This endpoint is for legacy Search indexes and may be deprecated in a future release. +Use <> instead. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-request.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-request.adoc new file mode 100644 index 00000000..3269fa47 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-request.adoc @@ -0,0 +1,8 @@ += Example Request Body + +==== +[source,json] +---- +include::example$p-api-pindex-lookup-body.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-response.adoc new file mode 100644 index 00000000..f64ec8fd --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-pindex-lookup/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$p-api-pindex-lookup-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-index-name/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-index-name/http-response.adoc new file mode 100644 index 00000000..b99e49aa --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-index-name/http-response.adoc @@ -0,0 +1,17 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$p-api-scoped-index-name-200.json[] +---- +==== + +==== +.Failure Response +[source,json] +---- +include::example$p-api-scoped-index-name-default.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-ingestcontrol/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-ingestcontrol/http-response.adoc new file mode 100644 index 00000000..4991e439 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-ingestcontrol/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$response-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-planfreezecontrol/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-planfreezecontrol/http-response.adoc new file mode 100644 index 00000000..4991e439 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-planfreezecontrol/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$response-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-query/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-query/http-response.adoc new file mode 100644 index 00000000..a7d72313 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-query/http-response.adoc @@ -0,0 +1,25 @@ += Example HTTP Response + +==== +.Failure Response +[source,json] +---- +include::example$p-api-scoped-query-default.json[] +---- +==== + +==== +.Success Response for a Regular Query +[source,json] +---- +include::example$fts-sample-success-response.json[] +---- +==== + +==== +.Success Response for a Hybrid Query +[source,json] +---- +include::example$fts-sample-success-response-vector-search.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-querycontrol/http-response.adoc b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-querycontrol/http-response.adoc new file mode 100644 index 00000000..4991e439 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/paths/p-api-scoped-querycontrol/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$response-200.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/security/document-begin.adoc b/docs/modules/fts-rest-indexing/partials/security/document-begin.adoc new file mode 100644 index 00000000..753b6c55 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Search REST APIs support HTTP basic authentication. +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-indexing/partials/security/document-end.adoc b/docs/modules/fts-rest-indexing/partials/security/document-end.adoc new file mode 100644 index 00000000..5330f469 --- /dev/null +++ b/docs/modules/fts-rest-indexing/partials/security/document-end.adoc @@ -0,0 +1 @@ +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/examples/file-xfer-200.json b/docs/modules/fts-rest-manage/examples/file-xfer-200.json new file mode 100644 index 00000000..b523aff9 --- /dev/null +++ b/docs/modules/fts-rest-manage/examples/file-xfer-200.json @@ -0,0 +1,3 @@ +{ + "status": "ok" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/examples/file-xfer-405.json b/docs/modules/fts-rest-manage/examples/file-xfer-405.json new file mode 100644 index 00000000..6b2eef44 --- /dev/null +++ b/docs/modules/fts-rest-manage/examples/file-xfer-405.json @@ -0,0 +1,4 @@ +{ + "error": "Method not allowed for endpoint", + "status": "fail" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/examples/file-xfer-disable.sh b/docs/modules/fts-rest-manage/examples/file-xfer-disable.sh new file mode 100644 index 00000000..634b8132 --- /dev/null +++ b/docs/modules/fts-rest-manage/examples/file-xfer-disable.sh @@ -0,0 +1,4 @@ +curl -X PUT http://$HOST:8094/api/managerOptions \ +-u $USER:$PASSWORD \ +-H "Content-type:application/json" \ +-d '{"disableFileTransferRebalance": "true" }' \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/examples/file-xfer-enable.sh b/docs/modules/fts-rest-manage/examples/file-xfer-enable.sh new file mode 100644 index 00000000..027d4064 --- /dev/null +++ b/docs/modules/fts-rest-manage/examples/file-xfer-enable.sh @@ -0,0 +1,4 @@ +curl -X PUT http://$HOST:8094/api/managerOptions \ +-u $USER:$PASSWORD \ +-H "Content-type:application/json" \ +-d '{"disableFileTransferRebalance": "false" }' \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/pages/index.adoc b/docs/modules/fts-rest-manage/pages/index.adoc new file mode 100644 index 00000000..1232730f --- /dev/null +++ b/docs/modules/fts-rest-manage/pages/index.adoc @@ -0,0 +1,581 @@ += Search Manager Options REST API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Search Manager Options REST API is provided by the Search service. +This API enables you to set Search manager options; in particular, to configure rebalance based on file transfer. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Search Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Search Service REST port. Use `18094` for secure access. +-- + +[%hardbreaks] +*Values:* `8094`, `18094` +*Example:* `+++8094+++` +// end + +|=== + + +include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 1 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Default] += Default +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> + + + +// markup not found, no include::{specDir}paths/put_options/operation-before.adoc[opts=optional] + + +[#put_options] += Modify Search Manager Options + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/put_options/operation-begin.adoc[opts=optional] + + +.... +PUT /api/managerOptions +.... + + + +// markup not found, no include::{specDir}paths/put_options/operation-description-before.adoc[opts=optional] + + +[#put_options-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/put_options/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Sets Search manager options. +Note that only one setting is available: `disableFileTransferRebalance`. +-- + + +include::{specDir}paths/put_options/operation-description-end.adoc[opts=optional] + + +[#put_options-consumes] +.Consumes +* application/json + +[#put_options-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/put_options/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/put_options/operation-parameters-before.adoc[opts=optional] + + +[#put_options-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/put_options/operation-parameters-begin.adoc[opts=optional] + + + + + + +[#put_options-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_optional_ +a¦ + + +[markdown] +-- +An object specifying Search manager options. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/put_options/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/put_options/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/put_options/operation-responses-before.adoc[opts=optional] + + +[#put_options-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/put_options/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The operation was successful. +-- +a| <> + + +| 401 +a| [markdown] +-- +Failure to authenticate. The user name or password may be incorrect. +-- +a| <> + + +| 404 +a| [markdown] +-- +Object not found. The URL may be incorrectly specified. +-- +a| <> + + +| 405 +a| [markdown] +-- +Method not allowed. The method may be incorrectly specified. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/put_options/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/put_options/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/put_options/operation-security-before.adoc[opts=optional] + + +[#put_options-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/put_options/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/put_options/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/put_options/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}put_options/http-request.adoc[opts=optional] + + +include::{snippetDir}put_options/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/put_options/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/put_options/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 2 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +endif::[] + + + +// markup not found, no include::{specDir}definitions/Options/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#Options] += Options + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/Options/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::Options[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*disableFileTransferRebalance* + +_optional_ +a¦ + +[markdown] +-- +If the value is `false` (the default), new Search Service partitions are created during rebalance by means of partition file transfer. + +If the value is `true`, partitions are created by means of partition build, from scratch, over DCP connections from the Data Service. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +|=== + +//end::Options[] + + + + +// markup not found, no include::{specDir}definitions/Options/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/Options/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/Response/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#Response] += Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/Response/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::Response[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_required_ +a¦ + +[markdown] +-- +The status of the operation. + +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*error* + +_optional_ +a¦ + +[markdown] +-- +The error message, if the operation was not successful. + +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::Response[] + + + + +// markup not found, no include::{specDir}definitions/Response/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/Response/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Default/security-scheme-before.adoc[opts=optional] + + +[[security-default]] += Default + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Default/security-scheme-begin.adoc[opts=optional] + + + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Default/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Default/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/fts-rest-manage/partials/header-attributes.adoc b/docs/modules/fts-rest-manage/partials/header-attributes.adoc new file mode 100644 index 00000000..1685880b --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: rest-api:rest-fts-partition-file-transfer.adoc +:!example-caption: +:description: The Search Manager Options REST API is provided by the Search Service. \ +This API enables you to set cluster-level Search settings; in particular, to configure rebalance based on file transfer. diff --git a/docs/modules/fts-rest-manage/partials/overview/document-before.adoc b/docs/modules/fts-rest-manage/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/partials/overview/document-end.adoc b/docs/modules/fts-rest-manage/partials/overview/document-end.adoc new file mode 100644 index 00000000..cf347cd1 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/overview/document-end.adoc @@ -0,0 +1,8 @@ +[discrete] += Examples on this page + +In the HTTP request examples: + +* `$HOST` is the host name or IP address of a node running the Search Service. +* `$USER` is the user name of an authorized user -- see <>. +* `$PASSWORD` is the password to connect to Couchbase Server. \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/partials/paths/put_options/http-request.adoc b/docs/modules/fts-rest-manage/partials/paths/put_options/http-request.adoc new file mode 100644 index 00000000..fc9ddab4 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/paths/put_options/http-request.adoc @@ -0,0 +1,25 @@ += Example HTTP Request + +The following example disables the creation of new partitions by means of file transfer. + +==== +.Curl request +[source,sh] +---- +include::example$file-xfer-disable.sh[] +---- +==== + +From this point, Search Service index partitions are built on the new nodes assigned to them during rebalance. + +The following example re-enables the creation of new partitions by means of file transfer: + +==== +.Curl request +[source,sh] +---- +include::example$file-xfer-enable.sh[] +---- +==== + +From this point, Search Service index partitions are again created by file transfer, on the new nodes assigned to them during rebalance. \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/partials/paths/put_options/http-response.adoc b/docs/modules/fts-rest-manage/partials/paths/put_options/http-response.adoc new file mode 100644 index 00000000..dc975839 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/paths/put_options/http-response.adoc @@ -0,0 +1,17 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$file-xfer-200.json[] +---- +==== + +==== +.Response 405 +[source,json] +---- +include::example$file-xfer-405.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/partials/paths/put_options/operation-description-end.adoc b/docs/modules/fts-rest-manage/partials/paths/put_options/operation-description-end.adoc new file mode 100644 index 00000000..50f79d94 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/paths/put_options/operation-description-end.adoc @@ -0,0 +1,8 @@ +The Search Service automatically partitions its indexes across all Search nodes in the cluster, ensuring optimal distribution, following rebalance. + +To achieve this, in versions of Couchbase Server prior to 7.1, by default, partitions needing to be newly created were entirely built, on their newly assigned nodes. +In 7.1+, by default, new partitions are created by the transfer of partition files from old nodes to new nodes: this significantly enhances performance. +This is an Enterprise-only feature, which requires all Search Service nodes either to be running 7.1 or later; or to be running 7.0.2, with the feature explicitly switched on by means of this endpoint. +Note that users of 7.1+ can explicitly switch the feature off by means of this endpoint; in which case partition build is used to establish new partitions, rather than file transfer. + +During file transfer, should an unresolvable error occur, file transfer is automatically abandoned, and partition build is used instead. diff --git a/docs/modules/fts-rest-manage/partials/security/document-after.adoc b/docs/modules/fts-rest-manage/partials/security/document-after.adoc new file mode 100644 index 00000000..1a1deca2 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/security/document-after.adoc @@ -0,0 +1,7 @@ += See Also + +* An overview of rebalance for all services is provided at xref:learn:clusters-and-availability/rebalance.adoc[Rebalance]. + +* An overview of the REST API for the Search Service is provided at xref:rest-api:rest-fts.adoc[Search API]. + +* An architectural summary of the Search Service is provided at xref:learn:services-and-indexes/services/search-service.adoc#search-service-architecture[Search Service Architecture]. \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/partials/security/document-begin.adoc b/docs/modules/fts-rest-manage/partials/security/document-begin.adoc new file mode 100644 index 00000000..753b6c55 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Search REST APIs support HTTP basic authentication. +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-manage/partials/security/document-end.adoc b/docs/modules/fts-rest-manage/partials/security/document-end.adoc new file mode 100644 index 00000000..5330f469 --- /dev/null +++ b/docs/modules/fts-rest-manage/partials/security/document-end.adoc @@ -0,0 +1 @@ +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/examples/get-cluster-config.json b/docs/modules/fts-rest-nodes/examples/get-cluster-config.json new file mode 100644 index 00000000..f9dc868a --- /dev/null +++ b/docs/modules/fts-rest-nodes/examples/get-cluster-config.json @@ -0,0 +1,93 @@ +{ + "indexDefs": { + "implVersion": "4.0.0", + "indexDefs": { + "myFirstIndex": { + "name": "myFirstIndex", + "params": "", + "planParams": { + "hierarchyRules": null, + "maxPartitionsPerPIndex": 0, + "nodePlanParams": null, + "numReplicas": 0, + "planFrozen": false + }, + "sourceName": "", + "sourceParams": "", + "sourceType": "nil", + "sourceUUID": "", + "type": "blackhole", + "uuid": "6cc599ab7a85bf3b" + } + }, + "uuid": "6cc599ab7a85bf3b" + }, + "indexDefsCAS": 3, + "indexDefsErr": null, + "nodeDefsKnown": { + "implVersion": "4.0.0", + "nodeDefs": { + "78fc2ffac2fd9401": { + "container": "", + "extras": "", + "hostPort": "0.0.0.0:8094", + "implVersion": "4.0.0", + "tags": null, + "uuid": "78fc2ffac2fd9401", + "weight": 1 + } + }, + "uuid": "2f0d18fb750b2d4a" + }, + "nodeDefsKnownCAS": 1, + "nodeDefsKnownErr": null, + "nodeDefsWanted": { + "implVersion": "4.0.0", + "nodeDefs": { + "78fc2ffac2fd9401": { + "container": "", + "extras": "", + "hostPort": "0.0.0.0:8094", + "implVersion": "4.0.0", + "tags": null, + "uuid": "78fc2ffac2fd9401", + "weight": 1 + } + }, + "uuid": "72d6750878551451" + }, + "nodeDefsWantedCAS": 2, + "nodeDefsWantedErr": null, + "planPIndexes": { + "implVersion": "4.0.0", + "planPIndexes": { + "myFirstIndex_6cc599ab7a85bf3b_0": { + "indexName": "myFirstIndex", + "indexParams": "", + "indexType": "blackhole", + "indexUUID": "6cc599ab7a85bf3b", + "name": "myFirstIndex_6cc599ab7a85bf3b_0", + "nodes": { + "78fc2ffac2fd9401": { + "canRead": true, + "canWrite": true, + "priority": 0 + } + }, + "sourceName": "", + "sourceParams": "", + "sourcePartitions": "", + "sourceType": "nil", + "sourceUUID": "", + "uuid": "64bed6e2edf354c3" + } + }, + "uuid": "6327debf817a5ec7", + "warnings": { + "myFirstIndex": [] + } + }, + "planPIndexesCAS": 5, + "planPIndexesErr": null, + "status": "ok" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/examples/get-logs.json b/docs/modules/fts-rest-nodes/examples/get-logs.json new file mode 100644 index 00000000..88a3c95b --- /dev/null +++ b/docs/modules/fts-rest-nodes/examples/get-logs.json @@ -0,0 +1,4 @@ +{ + "events": [], + "messages": [] +} \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/examples/get-runtime-info.json b/docs/modules/fts-rest-nodes/examples/get-runtime-info.json new file mode 100644 index 00000000..0a33f3ee --- /dev/null +++ b/docs/modules/fts-rest-nodes/examples/get-runtime-info.json @@ -0,0 +1,13 @@ +{ + "arch": "amd64", + "go": { + "GOMAXPROCS": 1, + "GOROOT": "/usr/local/go", + "compiler": "gc", + "version": "go1.4" + }, + "numCPU": 8, + "os": "darwin", + "versionData": "4.0.0", + "versionMain": "v0.3.1" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/pages/index.adoc b/docs/modules/fts-rest-nodes/pages/index.adoc new file mode 100644 index 00000000..b341bfbc --- /dev/null +++ b/docs/modules/fts-rest-nodes/pages/index.adoc @@ -0,0 +1,4329 @@ += Couchbase Search Node API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Search Node Configuration REST API is provided by the Search service. +This API enables you to manage and monitor your Search nodes. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Search Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Search Service REST port. Use `18094` for secure access. +-- + +[%hardbreaks] +*Values:* `8094`, `18094` +*Example:* `+++8094+++` +// end + +|=== + + +// markup not found, no include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 4 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +<> +<> +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Configuration] += Configuration +:leveloffset: +1 + +ifeval::["Operations for node configuration." != ""] +Operations for node configuration. +endif::[] +ifeval::["Operations for node configuration." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-before.adoc[opts=optional] + + +[#getClusterConfig] += Get Cluster Configuration + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-begin.adoc[opts=optional] + + +.... +GET /api/cfg +.... + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-description-before.adoc[opts=optional] + + +[#getClusterConfig-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the node's current view of the cluster's configuration as JSON. +-- + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-description-end.adoc[opts=optional] + + + +[#getClusterConfig-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-responses-before.adoc[opts=optional] + + +[#getClusterConfig-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's configuration. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-security-before.adoc[opts=optional] + + +[#getClusterConfig-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getClusterConfig/http-request.adoc[opts=optional] + + +include::{snippetDir}getClusterConfig/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getClusterConfig/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/managerKick/operation-before.adoc[opts=optional] + + +[#managerKick] += Replan Resource Assignments + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerKick/operation-begin.adoc[opts=optional] + + +.... +POST /api/managerKick +.... + + + +// markup not found, no include::{specDir}paths/managerKick/operation-description-before.adoc[opts=optional] + + +[#managerKick-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerKick/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Forces the node to replan resource assignments, (by running the planner, if enabled) and update its runtime state to reflect the latest plan (by running the janitor, if enabled). +-- + + +// markup not found, no include::{specDir}paths/managerKick/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/managerKick/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerKick/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/managerKick/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerKick/operation-responses-before.adoc[opts=optional] + + +[#managerKick-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerKick/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/managerKick/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/managerKick/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerKick/operation-security-before.adoc[opts=optional] + + +[#managerKick-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerKick/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/managerKick/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/managerKick/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}managerKick/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}managerKick/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerKick/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/managerKick/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-before.adoc[opts=optional] + + +[#managerMeta] += Get Node Capabilities + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerMeta/operation-begin.adoc[opts=optional] + + +.... +GET /api/managerMeta +.... + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-description-before.adoc[opts=optional] + + +[#managerMeta-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerMeta/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns information on the node's capabilities, including available indexing and storage options as JSON. +This operation is intended to help management tools and web UIs to be more dynamically metadata driven. +-- + + +// markup not found, no include::{specDir}paths/managerMeta/operation-description-end.adoc[opts=optional] + + + +[#managerMeta-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/managerMeta/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-responses-before.adoc[opts=optional] + + +[#managerMeta-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerMeta/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's capabilities. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/managerMeta/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-security-before.adoc[opts=optional] + + +[#managerMeta-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/managerMeta/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/managerMeta/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/managerMeta/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}managerMeta/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}managerMeta/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/managerMeta/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/managerMeta/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-before.adoc[opts=optional] + + +[#refreshClusterConfig] += Refresh Node Configuration + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-begin.adoc[opts=optional] + + +.... +POST /api/cfgRefresh +.... + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-description-before.adoc[opts=optional] + + +[#refreshClusterConfig-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Requests the node to refresh its configuration from the configuration provider. +-- + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-responses-before.adoc[opts=optional] + + +[#refreshClusterConfig-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-security-before.adoc[opts=optional] + + +[#refreshClusterConfig-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}refreshClusterConfig/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}refreshClusterConfig/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/refreshClusterConfig/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Diagnostics] += Diagnostics +:leveloffset: +1 + +ifeval::["Operations for node diagnostics." != ""] +Operations for node diagnostics. +endif::[] +ifeval::["Operations for node diagnostics." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-before.adoc[opts=optional] + + +[#captureCpuProfile] += Capture CPU Profiling Information + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-begin.adoc[opts=optional] + + +.... +POST /api/runtime/profile/cpu +.... + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-description-before.adoc[opts=optional] + + +[#captureCpuProfile-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Requests the node to capture local CPU usage profiling information. +-- + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-responses-before.adoc[opts=optional] + + +[#captureCpuProfile-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-security-before.adoc[opts=optional] + + +[#captureCpuProfile-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}captureCpuProfile/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}captureCpuProfile/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/captureCpuProfile/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-before.adoc[opts=optional] + + +[#captureMemoryProfile] += Capture Memory Profiling Information + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-begin.adoc[opts=optional] + + +.... +POST /api/runtime/profile/memory +.... + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-description-before.adoc[opts=optional] + + +[#captureMemoryProfile-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Requests the node to capture local memory usage profiling information. +-- + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-responses-before.adoc[opts=optional] + + +[#captureMemoryProfile-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-security-before.adoc[opts=optional] + + +[#captureMemoryProfile-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}captureMemoryProfile/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}captureMemoryProfile/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/captureMemoryProfile/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-before.adoc[opts=optional] + + +[#getDiagnostics] += Get Diagnostics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-begin.adoc[opts=optional] + + +.... +GET /api/diag +.... + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-description-before.adoc[opts=optional] + + +[#getDiagnostics-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns the full set of diagnostic information from the node as JSON. +The response is the union of the responses from the node's other REST API diagnostic and monitoring endpoints. + +For example, for a 3 node cluster, you could capture diagnostics for each node with something like: + +```shell +curl http://cbft-01:8094/api/diag > cbft-01.json +curl http://cbft-02:8094/api/diag > cbft-02.json +curl http://cbft-03:8094/api/diag > cbft-03.json +``` + +The response JSON object can be quite large, 100s of KB or much more. + +The motivation for this operation is to simplify working with the Couchbase community, forums, technical support, and other engineers, by making data capture from each Search node a single step. +-- + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-description-end.adoc[opts=optional] + + + +[#getDiagnostics-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-responses-before.adoc[opts=optional] + + +[#getDiagnostics-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's diagnostics. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-security-before.adoc[opts=optional] + + +[#getDiagnostics-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getDiagnostics/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}getDiagnostics/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getDiagnostics/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/getLogs/operation-before.adoc[opts=optional] + + +[#getLogs] += Get Node Logs + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getLogs/operation-begin.adoc[opts=optional] + + +.... +GET /api/log +.... + + + +// markup not found, no include::{specDir}paths/getLogs/operation-description-before.adoc[opts=optional] + + +[#getLogs-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getLogs/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns recent log messages and key events for the node as JSON. +-- + + +// markup not found, no include::{specDir}paths/getLogs/operation-description-end.adoc[opts=optional] + + + +[#getLogs-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getLogs/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getLogs/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getLogs/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getLogs/operation-responses-before.adoc[opts=optional] + + +[#getLogs-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getLogs/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's logs. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/getLogs/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getLogs/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getLogs/operation-security-before.adoc[opts=optional] + + +[#getLogs-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getLogs/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getLogs/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getLogs/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getLogs/http-request.adoc[opts=optional] + + +include::{snippetDir}getLogs/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getLogs/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getLogs/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-before.adoc[opts=optional] + + +[#getRuntimeArgs] += Get Node Runtime Arguments + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-begin.adoc[opts=optional] + + +.... +GET /api/runtime/args +.... + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-description-before.adoc[opts=optional] + + +[#getRuntimeArgs-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns information on the node's command-line, parameters, environment variables, and OS process values as JSON. +-- + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-description-end.adoc[opts=optional] + + + +[#getRuntimeArgs-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-responses-before.adoc[opts=optional] + + +[#getRuntimeArgs-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's runtime arguments. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-security-before.adoc[opts=optional] + + +[#getRuntimeArgs-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getRuntimeArgs/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}getRuntimeArgs/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeArgs/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-before.adoc[opts=optional] + + +[#getRuntimeInfo] += Get Node Runtime Information + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-begin.adoc[opts=optional] + + +.... +GET /api/runtime +.... + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-description-before.adoc[opts=optional] + + +[#getRuntimeInfo-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns information on the node's software, such as version strings and slow-changing runtime settings, as JSON. +-- + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-description-end.adoc[opts=optional] + + + +[#getRuntimeInfo-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-responses-before.adoc[opts=optional] + + +[#getRuntimeInfo-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's runtime information. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-security-before.adoc[opts=optional] + + +[#getRuntimeInfo-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getRuntimeInfo/http-request.adoc[opts=optional] + + +include::{snippetDir}getRuntimeInfo/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeInfo/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Management] += Management +:leveloffset: +1 + +ifeval::["Operations for node management." != ""] +Operations for node management. +endif::[] +ifeval::["Operations for node management." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> + + + +// markup not found, no include::{specDir}paths/performGC/operation-before.adoc[opts=optional] + + +[#performGC] += Perform Garbage Collection + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/performGC/operation-begin.adoc[opts=optional] + + +.... +POST /api/runtime/gc +.... + + + +// markup not found, no include::{specDir}paths/performGC/operation-description-before.adoc[opts=optional] + + +[#performGC-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/performGC/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Requests the node to perform a garbage collection. +-- + + +// markup not found, no include::{specDir}paths/performGC/operation-description-end.adoc[opts=optional] + + + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/performGC/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/performGC/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/performGC/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/performGC/operation-responses-before.adoc[opts=optional] + + +[#performGC-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/performGC/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/performGC/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/performGC/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/performGC/operation-security-before.adoc[opts=optional] + + +[#performGC-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/performGC/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/performGC/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/performGC/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}performGC/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}performGC/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/performGC/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/performGC/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Monitoring] += Monitoring +:leveloffset: +1 + +ifeval::["Operations for node monitoring." != ""] +Operations for node monitoring. +endif::[] +ifeval::["Operations for node monitoring." == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-before.adoc[opts=optional] + + +[#getMemoryStats] += Get Memory Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-begin.adoc[opts=optional] + + +.... +GET /api/runtime/statsMem +.... + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-description-before.adoc[opts=optional] + + +[#getMemoryStats-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns information on the node's low-level garbage collection and memory-related runtime stats as JSON. +-- + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-description-end.adoc[opts=optional] + + + +[#getMemoryStats-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-responses-before.adoc[opts=optional] + + +[#getMemoryStats-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's memory statistics. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-security-before.adoc[opts=optional] + + +[#getMemoryStats-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getMemoryStats/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}getMemoryStats/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getMemoryStats/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-before.adoc[opts=optional] + + +[#getRuntimeStats] += Get Runtime Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-begin.adoc[opts=optional] + + +.... +GET /api/runtime/stats +.... + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-description-before.adoc[opts=optional] + + +[#getRuntimeStats-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns information on the node's low-level runtime stats as JSON. +-- + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-description-end.adoc[opts=optional] + + + +[#getRuntimeStats-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-responses-before.adoc[opts=optional] + + +[#getRuntimeStats-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A JSON object containing the node's low-level runtime statistics. +-- +a| Object + + + +|=== + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-security-before.adoc[opts=optional] + + +[#getRuntimeStats-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}getRuntimeStats/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}getRuntimeStats/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/getRuntimeStats/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 19 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +<> +endif::[] + + + +// markup not found, no include::{specDir}definitions/clusterConfig/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfig] += Cluster Configuration + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfig/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfig[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexDefs* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigIndexes, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*indexDefsCAS* + +_optional_ +a¦ + +[markdown] +-- +Search index definition concurrency (compare and swap) value. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*indexDefsErr* + +_optional_ +a¦ + +[markdown] +-- +Search index definition error. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*nodeDefsKnown* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigNodesKnown, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*nodeDefsKnownCAS* + +_optional_ +a¦ + +[markdown] +-- +Known node definition concurrency (compare and swap) value. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*nodeDefsKnownErr* + +_optional_ +a¦ + +[markdown] +-- +Known node definition error. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*nodeDefsWanted* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigNodesWanted, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*nodeDefsWantedCAS* + +_optional_ +a¦ + +[markdown] +-- +Wanted node definition concurrency (compare and swap) value. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*nodeDefsWantedErr* + +_optional_ +a¦ + +[markdown] +-- +Wanted node definition error. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*planPIndexes* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigPlan, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*planPIndexesCAS* + +_optional_ +a¦ + +[markdown] +-- +Search index partition concurrency (compare and swap) value. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*planPIndexesErr* + +_optional_ +a¦ + +[markdown] +-- +Search index partition error. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the operation. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::clusterConfig[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfig/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfig/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigIndexes/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigIndexes] += Index Definitions + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigIndexes/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigIndexes[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigIndexes[] +An object containing Search index definitions and related information. +//end::desc-clusterConfigIndexes[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*implVersion* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexDefs* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexesResponseIndexesWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::clusterConfigIndexes[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigIndexes/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigIndexes/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesKnown/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigNodesKnown] += Known Nodes + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesKnown/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigNodesKnown[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigNodesKnown[] +An object containing known node definitions and related information. +//end::desc-clusterConfigNodesKnown[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*implVersion* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*nodeDefs* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigNodesWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::clusterConfigNodesKnown[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesKnown/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesKnown/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWanted/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigNodesWanted] += Wanted Nodes + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWanted/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigNodesWanted[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigNodesWanted[] +An object containing wanted node definitions and related information. +//end::desc-clusterConfigNodesWanted[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*implVersion* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*nodeDefs* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigNodesWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::clusterConfigNodesWanted[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWanted/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWanted/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapper/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigNodesWrapper] += Node Definitions Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapper/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigNodesWrapper[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigNodesWrapper[] +An object containing the definitions of 1 or more nodes. +//end::desc-clusterConfigNodesWrapper[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigNodesWrapperNode, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::clusterConfigNodesWrapper[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapper/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapper/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapperNode/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigNodesWrapperNode] += Node Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapperNode/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigNodesWrapperNode[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigNodesWrapperNode[] +An object containing the definition of a single node. +The name of the property is the UUID of the node. +//end::desc-clusterConfigNodesWrapperNode[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*container* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*extras* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*hostPort* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*implVersion* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*tags* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*weight* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::clusterConfigNodesWrapperNode[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapperNode/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigNodesWrapperNode/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigPlan/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigPlan] += Plan Partitions + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigPlan/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigPlan[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigPlan[] +An object containing Search index partitions and related information. +//end::desc-clusterConfigPlan[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*implVersion* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*planPIndexes* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterConfigPlanWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*warnings* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePlanWrng, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::clusterConfigPlan[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigPlan/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigPlan/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigPlanWrapper/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterConfigPlanWrapper] += Plan Partitions Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterConfigPlanWrapper/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterConfigPlanWrapper[] + +ifdef::model-descriptions[] +//tag::desc-clusterConfigPlanWrapper[] +An object containing information about 1 or more Search index partitions. +//end::desc-clusterConfigPlanWrapper[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePIndex, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::clusterConfigPlanWrapper[] + + + + +// markup not found, no include::{specDir}definitions/clusterConfigPlanWrapper/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterConfigPlanWrapper/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePIndex] += Plan Partition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePIndex[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePIndex[] +An object containing information about a single Search index partition. +//end::desc-GetIndexResponsePIndex[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexName* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexParams* + +_optional_ +a¦ + +[markdown] +-- +The Search index's type identifier, type mappings, and analyzers. +For more information, see [Params Object](../search/search-index-params.html#params). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*indexType* + +_optional_ +a¦ + +[markdown] +-- +The type of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*name* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*nodes* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapper, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*sourceName* + +_optional_ +a¦ + +[markdown] +-- +The name of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceParams* + +_optional_ +a¦ + +[markdown] +-- +Advanced settings for Search index behavior. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*sourcePartitions* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceType* + +_optional_ +a¦ + +[markdown] +-- +The type of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index partition. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::GetIndexResponsePIndex[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndex/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePIndexNodesWrapper] += Partition Nodes Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePIndexNodesWrapper[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePIndexNodesWrapper[] +An object containing information about 1 or more Search index partition nodes. +//end::desc-GetIndexResponsePIndexNodesWrapper[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapperNode, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::GetIndexResponsePIndexNodesWrapper[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapper/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePIndexNodesWrapperNode] += Partition Node + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePIndexNodesWrapperNode[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePIndexNodesWrapperNode[] +An object containing information about a single Search index partition node. +The name of the property is the node UUID. +//end::desc-GetIndexResponsePIndexNodesWrapperNode[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*canRead* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*canWrite* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +a¦ +*priority* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::GetIndexResponsePIndexNodesWrapperNode[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePIndexNodesWrapperNode/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrng/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePlanWrng] += Plan Warnings Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrng/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexResponsePlanWrng[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexResponsePlanWrng[] +An object containing 0, 1, or more nested objects, each containing warnings that apply to a Search index. +//end::desc-GetIndexResponsePlanWrng[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-GetIndexResponsePlanWrngIndex, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::GetIndexResponsePlanWrng[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrng/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrng/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrngIndex/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexResponsePlanWrngIndex] += Plan Warnings + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrngIndex/definition-begin.adoc[opts=optional] + + +.icon:brackets[fw] Array +{blank} + + + +[markdown] +-- +An array of warnings. +The name of the property is the name of the Search index. +-- + +[%hardbreaks] +{blank} + +.Schema +String + + array + + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrngIndex/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexResponsePlanWrngIndex/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#GetIndexesResponseIndexesWrapper] += Index Definitions Wrapper + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::GetIndexesResponseIndexesWrapper[] + +ifdef::model-descriptions[] +//tag::desc-GetIndexesResponseIndexesWrapper[] +An object containing 1 or more Search index definitions. +//end::desc-GetIndexesResponseIndexesWrapper[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-IndexDefinition, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::GetIndexesResponseIndexesWrapper[] + + + + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/GetIndexesResponseIndexesWrapper/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#IndexDefinition] += Index Definition + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::IndexDefinition[] + +ifdef::model-descriptions[] +//tag::desc-IndexDefinition[] +The full Search index definition. +For a detailed list of all parameters, see [Search Index JSON Properties](../search/search-index-params.html). +//end::desc-IndexDefinition[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*name* + +_required_ +a¦ + +[markdown] +-- +The name of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*type* + +_required_ +a¦ + +[markdown] +-- +The type of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceName* + +_required_ +a¦ + +[markdown] +-- +The name of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*sourceParams* + +_optional_ +a¦ + +[markdown] +-- +Advanced settings for Search index behavior. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*sourceType* + +_required_ +a¦ + +[markdown] +-- +The type of the bucket where the Search index is stored. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*params* + +_required_ +a¦ + +[markdown] +-- +The Search index's type identifier, type mappings, and analyzers. +For more information, see [Params Object](../search/search-index-params.html#params). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*planParams* + +_required_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-IndexDefinitionPlanParams, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*prevIndexUUID* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the previous index. +Intended for clients that want to check that they are not overwriting the Search index definition updates of concurrent clients. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +The UUID of the Search index. +For more information, see [Initial Settings](../search/search-index-params.html#initial). +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::IndexDefinition[] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/IndexDefinition/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#IndexDefinitionPlanParams] += Plan Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::IndexDefinitionPlanParams[] + +ifdef::model-descriptions[] +//tag::desc-IndexDefinitionPlanParams[] +The Search index's partitioning and replication settings. +For more information, see [Plan Params Object](../search/search-index-params.html#planParams). +//end::desc-IndexDefinitionPlanParams[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*hierarchyRules* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*maxPartitionsPerPIndex* + +_optional_ +a¦ + +[markdown] +-- +This setting is deprecated. +Use `indexPartitions` instead. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*indexPartitions* + +_optional_ +a¦ + +[markdown] +-- +The number of partitions to split the Search index into, across the nodes you have available in your database with the Search Service enabled. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*nodePlanParams* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*numReplicas* + +_optional_ +a¦ + +[markdown] +-- +The number of replicas the Search Service creates for the Search index to ensure high availability. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*planFrozen* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + +|=== + +//end::IndexDefinitionPlanParams[] + + + + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/IndexDefinitionPlanParams/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/logInfo/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#logInfo] += Log Messages + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/logInfo/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::logInfo[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*events* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Object + array + +a¦ +*messages* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Object + array + +|=== + +//end::logInfo[] + + + + +// markup not found, no include::{specDir}definitions/logInfo/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/logInfo/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/runtimeInfo/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#runtimeInfo] += Runtime Information + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/runtimeInfo/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::runtimeInfo[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*arch* + +_optional_ +a¦ + +[markdown] +-- +The architecture of the node. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*go* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-runtimeInfoGo, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*numCPU* + +_optional_ +a¦ + +[markdown] +-- +The number of CPUs on the node. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*os* + +_optional_ +a¦ + +[markdown] +-- +The operating system of the node. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*versionData* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*versionMain* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::runtimeInfo[] + + + + +// markup not found, no include::{specDir}definitions/runtimeInfo/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/runtimeInfo/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/runtimeInfoGo/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#runtimeInfoGo] += Go Runtime Information + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/runtimeInfoGo/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::runtimeInfoGo[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*GOMAXPROCS* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*GOROOT* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*compiler* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*version* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::runtimeInfoGo[] + + + + +// markup not found, no include::{specDir}definitions/runtimeInfoGo/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/runtimeInfoGo/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/manageCluster/security-scheme-before.adoc[opts=optional] + + +[[security-manageCluster]] += Manage Cluster + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/manageCluster/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Full Admin** or **Cluster Admin** role, with permissions to manage the cluster. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/manageCluster/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/manageCluster/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/readClusterSettings/security-scheme-before.adoc[opts=optional] + + +[[security-readClusterSettings]] += Read Cluster Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/readClusterSettings/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Full Admin** or **Cluster Admin** role, with permission to read cluster settings. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/readClusterSettings/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/readClusterSettings/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/readClusterLogs/security-scheme-before.adoc[opts=optional] + + +[[security-readClusterLogs]] += Read Cluster Logs + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/readClusterLogs/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Full Admin** or **Cluster Admin** role, with permission to read cluster logs. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/readClusterLogs/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/readClusterLogs/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/writeClusterSettings/security-scheme-before.adoc[opts=optional] + + +[[security-writeClusterSettings]] += Write Cluster Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/writeClusterSettings/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Full Admin** or **Cluster Admin** role, with permission to write cluster settings. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/writeClusterSettings/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/writeClusterSettings/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/fts-rest-nodes/partials/header-attributes.adoc b/docs/modules/fts-rest-nodes/partials/header-attributes.adoc new file mode 100644 index 00000000..be21eb97 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: rest-api:rest-fts-node.adoc +:!example-caption: +:description: The Search Node Configuration REST API is provided by the Search Service. \ +This API enables you to manage and monitor your Search nodes. diff --git a/docs/modules/fts-rest-nodes/partials/overview/document-before.adoc b/docs/modules/fts-rest-nodes/partials/overview/document-before.adoc new file mode 100644 index 00000000..42c96154 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/overview/document-before.adoc @@ -0,0 +1,86 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/partials/paths/getClusterConfig/http-response.adoc b/docs/modules/fts-rest-nodes/partials/paths/getClusterConfig/http-response.adoc new file mode 100644 index 00000000..0b8f4088 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/paths/getClusterConfig/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$get-cluster-config.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/partials/paths/getLogs/http-response.adoc b/docs/modules/fts-rest-nodes/partials/paths/getLogs/http-response.adoc new file mode 100644 index 00000000..c5c42008 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/paths/getLogs/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$get-logs.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/partials/paths/getRuntimeInfo/http-response.adoc b/docs/modules/fts-rest-nodes/partials/paths/getRuntimeInfo/http-response.adoc new file mode 100644 index 00000000..6e854227 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/paths/getRuntimeInfo/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$get-runtime-info.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/partials/security/document-begin.adoc b/docs/modules/fts-rest-nodes/partials/security/document-begin.adoc new file mode 100644 index 00000000..753b6c55 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Search REST APIs support HTTP basic authentication. +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-nodes/partials/security/document-end.adoc b/docs/modules/fts-rest-nodes/partials/security/document-end.adoc new file mode 100644 index 00000000..5330f469 --- /dev/null +++ b/docs/modules/fts-rest-nodes/partials/security/document-end.adoc @@ -0,0 +1 @@ +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-all.json b/docs/modules/fts-rest-query/examples/api-query-all.json new file mode 100644 index 00000000..9fc70cce --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-all.json @@ -0,0 +1,61 @@ +{ + "status": "ok", + "stats": { + "total": 3, + "successful": 3 + }, + "totalActiveQueryCount": 4, + "filteredActiveQueries": { + "queryCount": 4, + "queryMap": { + "b91d75480470f979f65f04e8f20a1f7b-17": { + "QueryContext": { + "query": { + "query": "good restaurants in france" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex1" + }, + "executionTime": "2.144802122s" + }, + "b91d75480470f979f65f04e8f20a1f7b-18": { + "QueryContext": { + "query": { + "query": "decent hotel with a pool in italy" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex2" + }, + "executionTime": "2.144712787s" + }, + "b91d75480470f979f65f04e8f20a1f7b-19": { + "QueryContext": { + "query": { + "query": "germany" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex2" + }, + "executionTime": "2.143957727s" + }, + "f76b2d51397feee28c1e757ed426ef93-3": { + "QueryContext": { + "query": { + "query": "mexican food in england" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex1" + }, + "executionTime": "2.14286421s" + } + } + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-all.sh b/docs/modules/fts-rest-query/examples/api-query-all.sh new file mode 100644 index 00000000..b63ac1f0 --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-all.sh @@ -0,0 +1,3 @@ +curl -XGET -H "Content-Type: application/json" \ + -u $USER:$PASSWORD \ + "http://$HOST:8094/api/query" \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-cancel.json b/docs/modules/fts-rest-query/examples/api-query-cancel.json new file mode 100644 index 00000000..2c8bc1af --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-cancel.json @@ -0,0 +1,4 @@ +{ + "status": "ok", + "msg": "query with ID '24' on node 'b91d75480470f979f65f04e8f20a1f7b' was aborted!" +} \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-cancel.sh b/docs/modules/fts-rest-query/examples/api-query-cancel.sh new file mode 100644 index 00000000..d9e60060 --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-cancel.sh @@ -0,0 +1,3 @@ +curl -X POST -H "Content-Type: application/json" -u $USER:$PASSWORD \ + "http://$HOST:8094/api/query/24/cancel" -d \ + '{ "uuid": "b91d75480470f979f65f04e8f20a1f7b" }' \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-filter.json b/docs/modules/fts-rest-query/examples/api-query-filter.json new file mode 100644 index 00000000..df72b7af --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-filter.json @@ -0,0 +1,26 @@ +{ + "status": "ok", + "stats": { + "total": 3, + "successful": 3 + }, + "totalActiveQueryCount": 3, + "filteredActiveQueries": { + "longerThan": "7s", + "queryCount": 1, + "queryMap": { + "b91d75480470f979f65f04e8f20a1f7b-21": { + "QueryContext": { + "query": { + "query": "decent hotel with a pool in italy" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex1" + }, + "executionTime": "10.541956741s" + } + } + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-filter.sh b/docs/modules/fts-rest-query/examples/api-query-filter.sh new file mode 100644 index 00000000..8f9ac8b6 --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-filter.sh @@ -0,0 +1,3 @@ +curl -XGET -H "Content-Type: application/json" \ + -u $USER:$PASSWORD \ + "http://$HOST:8094/api/query?longerThan=7s" \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-index.json b/docs/modules/fts-rest-query/examples/api-query-index.json new file mode 100644 index 00000000..2b1e8abe --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-index.json @@ -0,0 +1,39 @@ +{ + "status": "ok", + "stats": { + "total": 3, + "successful": 3 + }, + "totalActiveQueryCount": 4, + "filteredActiveQueries": { + "indexName": "DemoIndex1", + "longerThan": "1ms", + "queryCount": 2, + "queryMap": { + "b91d75480470f979f65f04e8f20a1f7b-16": { + "QueryContext": { + "query": { + "query": "good restaurants in france" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex1" + }, + "executionTime": "1.059754811s" + }, + "f76b2d51397feee28c1e757ed426ef93-2": { + "QueryContext": { + "query": { + "query": "mexican food in england" + }, + "size": 10, + "from": 0, + "timeout": 120000, + "index": "DemoIndex1" + }, + "executionTime": "1.058247896s" + } + } + } +} \ No newline at end of file diff --git a/docs/modules/fts-rest-query/examples/api-query-index.sh b/docs/modules/fts-rest-query/examples/api-query-index.sh new file mode 100644 index 00000000..d02f65cb --- /dev/null +++ b/docs/modules/fts-rest-query/examples/api-query-index.sh @@ -0,0 +1,3 @@ +curl -XGET -H "Content-Type: application/json" \ +-u $USER:$PASSWORD \ +"http://$HOST:8094/api/query/index/DemoIndex1?longerThan=1ms" \ No newline at end of file diff --git a/docs/modules/fts-rest-query/pages/index.adoc b/docs/modules/fts-rest-query/pages/index.adoc new file mode 100644 index 00000000..9f8f15c0 --- /dev/null +++ b/docs/modules/fts-rest-query/pages/index.adoc @@ -0,0 +1,1539 @@ += Couchbase Search Active Queries REST API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Search Active Queries REST API is provided by the Search service. +This API enables you to get information about active Search queries. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Search Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Search Service REST port. Use `18094` for secure access. +-- + +[%hardbreaks] +*Values:* `8094`, `18094` +*Example:* `+++8094+++` +// end + +|=== + + +include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 1 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Default] += Default +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> +<> + + + +// markup not found, no include::{specDir}paths/api-query/operation-before.adoc[opts=optional] + + +[#api-query] += View Active Node Queries + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query/operation-begin.adoc[opts=optional] + + +.... +GET /api/query +.... + + + +// markup not found, no include::{specDir}paths/api-query/operation-description-before.adoc[opts=optional] + + +[#api-query-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Gets the details of all the active queries in any Search node in a cluster. +-- + + +// markup not found, no include::{specDir}paths/api-query/operation-description-end.adoc[opts=optional] + + + +[#api-query-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query/operation-parameters-before.adoc[opts=optional] + + +[#api-query-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query/operation-parameters-begin.adoc[opts=optional] + + + +[#api-query-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *longerThan* + +_optional_ +a¦ + + +[markdown] +-- +Filters the queries running beyond the given span of time. + +The duration string is a signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as `20s`, `-1.5h` or `2h45m`. +Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. +-- + +[%hardbreaks] +{blank} + +a¦ String (duration) + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/api-query/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/api-query/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query/operation-responses-before.adoc[opts=optional] + + +[#api-query-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A list of all active Search queries across all nodes in the cluster. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/api-query/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/api-query/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query/operation-security-before.adoc[opts=optional] + + +[#api-query-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/api-query/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}api-query/http-request.adoc[opts=optional] + + +include::{snippetDir}api-query/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-before.adoc[opts=optional] + + +[#api-query-cancel] += Cancel Active Queries + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-begin.adoc[opts=optional] + + +.... +POST /api/query/{queryID}/cancel +.... + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-description-before.adoc[opts=optional] + + +[#api-query-cancel-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Allows the user to cancel an active query that's running longer than expected. +Use the View Active Index Queries API or the View Active Node Queries API to get the parameters `queryID` and `uuid`, which are used to identify and cancel the query. +-- + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-description-end.adoc[opts=optional] + + +[#api-query-cancel-consumes] +.Consumes +* application/json + +[#api-query-cancel-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-parameters-before.adoc[opts=optional] + + +[#api-query-cancel-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-parameters-begin.adoc[opts=optional] + + +[#api-query-cancel-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *queryID* + +_required_ +a¦ + + +[markdown] +-- +The ID of the active query. +This ID is used to identify the query that you want to cancel. +-- + +[%hardbreaks] +{blank} + +a¦ Integer + + + +|=== + + + + +[#api-query-cancel-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_optional_ +a¦ + + +[markdown] +-- +The body contains the UUID of the node where the query is running. This is optional and allows cancellation of queries on specific nodes. +-- + +[%hardbreaks] +{blank} + +a¦ <> + + + +|=== + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-responses-before.adoc[opts=optional] + + +[#api-query-cancel-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The query was successfully canceled. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-security-before.adoc[opts=optional] + + +[#api-query-cancel-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}api-query-cancel/http-request.adoc[opts=optional] + + +include::{snippetDir}api-query-cancel/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query-cancel/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-before.adoc[opts=optional] + + +[#api-query-index] += View Active Index Queries + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-index/operation-begin.adoc[opts=optional] + + +.... +GET /api/query/index/{indexName} +.... + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-description-before.adoc[opts=optional] + + +[#api-query-index-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-index/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Gets the details of all the active queries for any given Search index in the system. +-- + + +// markup not found, no include::{specDir}paths/api-query-index/operation-description-end.adoc[opts=optional] + + + +[#api-query-index-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query-index/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-parameters-before.adoc[opts=optional] + + +[#api-query-index-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-index/operation-parameters-begin.adoc[opts=optional] + + +[#api-query-index-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *indexName* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + +[#api-query-index-query] +.Query Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *longerThan* + +_optional_ +a¦ + + +[markdown] +-- +Filters the queries running beyond the given span of time. + +The duration string is a signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as `20s`, `-1.5h` or `2h45m`. +Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. +-- + +[%hardbreaks] +{blank} + +a¦ String (duration) + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-responses-before.adoc[opts=optional] + + +[#api-query-index-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-index/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +A list of active queries for the specified Search index. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/api-query-index/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-security-before.adoc[opts=optional] + + +[#api-query-index-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/api-query-index/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/api-query-index/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query-index/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}api-query-index/http-request.adoc[opts=optional] + + +include::{snippetDir}api-query-index/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/api-query-index/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/api-query-index/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 8 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +<> +<> +<> +<> +<> +<> +endif::[] + + + +// markup not found, no include::{specDir}definitions/ActiveResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#ActiveResponse] += Active Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/ActiveResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::ActiveResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the request. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*stats* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ActiveResponseStats, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*totalActiveQueryCount* + +_optional_ +a¦ + +[markdown] +-- +The total number of active queries. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*filteredActiveQueries* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ActiveResponseFilter, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::ActiveResponse[] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/ActiveResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilter/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#ActiveResponseFilter] += Filtered Active Queries + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilter/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::ActiveResponseFilter[] + +ifdef::model-descriptions[] +//tag::desc-ActiveResponseFilter[] +An object containing details of the filtered active queries. +//end::desc-ActiveResponseFilter[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexName* + +_optional_ +a¦ + +[markdown] +-- +The name of the Search index. +Only included if viewing active queries for a specific index. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*longerThan* + +_optional_ +a¦ + +[markdown] +-- +The duration used to filter the active queries. +Only included if the `longerThan` query parameter is used. +-- + +[%hardbreaks] +{blank} +a¦ String (duration) + + +a¦ +*queryCount* + +_optional_ +a¦ + +[markdown] +-- +The number of filtered active queries. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*queryMap* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ActiveResponseFilterMap, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::ActiveResponseFilter[] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilter/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilter/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMap/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#ActiveResponseFilterMap] += Query Map + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMap/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::ActiveResponseFilterMap[] + +ifdef::model-descriptions[] +//tag::desc-ActiveResponseFilterMap[] +Contains 1 or more nested objects, each containing the details of a single active query. +//end::desc-ActiveResponseFilterMap[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +_additional + +property_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ActiveResponseFilterMapItem, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +|=== + +//end::ActiveResponseFilterMap[] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMap/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMap/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItem/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#ActiveResponseFilterMapItem] += Query Map Item + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItem/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::ActiveResponseFilterMapItem[] + +ifdef::model-descriptions[] +//tag::desc-ActiveResponseFilterMapItem[] +The details of a single active query. +The name of the property is the UUID of the node on which the query is running, and the ID of the query on that node, separated by a hyphen. +//end::desc-ActiveResponseFilterMapItem[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*QueryContext* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ActiveResponseFilterMapItemContext, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ <> + + +a¦ +*executionTime* + +_optional_ +a¦ + +[markdown] +-- +The time taken to execute the query. +-- + +[%hardbreaks] +{blank} +a¦ String (duration) + + +|=== + +//end::ActiveResponseFilterMapItem[] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItem/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItem/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItemContext/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#ActiveResponseFilterMapItemContext] += Query Context + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItemContext/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::ActiveResponseFilterMapItemContext[] + +ifdef::model-descriptions[] +//tag::desc-ActiveResponseFilterMapItemContext[] +The query context. +//end::desc-ActiveResponseFilterMapItemContext[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*query* + +_optional_ +a¦ + +[markdown] +-- +An object containing the Search query. +For more information, see [Search Request JSON Properties](../search/search-request-params.html). +-- + +[%hardbreaks] +{blank} +a¦ Object + + +a¦ +*size* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +*Example:* `10` +{blank} +a¦ Integer + + +a¦ +*from* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +*Example:* `0` +{blank} +a¦ Integer + + +a¦ +*timeout* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +*Example:* `120000` +{blank} +a¦ Integer + + +a¦ +*index* + +_optional_ +a¦ + +[markdown] +-- +The name of a Search index. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::ActiveResponseFilterMapItemContext[] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItemContext/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/ActiveResponseFilterMapItemContext/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseStats/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#ActiveResponseStats] += Stats + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/ActiveResponseStats/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::ActiveResponseStats[] + +ifdef::model-descriptions[] +//tag::desc-ActiveResponseStats[] +An object containing request statistics. +//end::desc-ActiveResponseStats[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*total* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +*Example:* `3` +{blank} +a¦ Integer + + +a¦ +*successful* + +_optional_ +a¦ + +[markdown] +-- +-- + +[%hardbreaks] +*Example:* `3` +{blank} +a¦ Integer + + +|=== + +//end::ActiveResponseStats[] + + + + +// markup not found, no include::{specDir}definitions/ActiveResponseStats/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/ActiveResponseStats/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/CancelRequest/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#CancelRequest] += Cancellation Request + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/CancelRequest/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::CancelRequest[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*uuid* + +_optional_ +a¦ + +[markdown] +-- +Represents the active query's coordinator node's UUID, where the query will be canceled. +This parameter allows the user to cancel a query anywhere in the system by specifying its coordinator node's UUID. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::CancelRequest[] + + + + +// markup not found, no include::{specDir}definitions/CancelRequest/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/CancelRequest/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/CancelResponse/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#CancelResponse] += Cancellation Response + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/CancelResponse/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::CancelResponse[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*status* + +_optional_ +a¦ + +[markdown] +-- +The status of the request. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*msg* + +_optional_ +a¦ + +[markdown] +-- +The response message, giving details of the node UUID and query ID. +-- + +[%hardbreaks] +{blank} +a¦ String + + +|=== + +//end::CancelResponse[] + + + + +// markup not found, no include::{specDir}definitions/CancelResponse/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/CancelResponse/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Default/security-scheme-before.adoc[opts=optional] + + +[[security-default]] += Default + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Default/security-scheme-begin.adoc[opts=optional] + + + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Default/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Default/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/fts-rest-query/partials/header-attributes.adoc b/docs/modules/fts-rest-query/partials/header-attributes.adoc new file mode 100644 index 00000000..b33e3ffa --- /dev/null +++ b/docs/modules/fts-rest-query/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: rest-api:rest-fts-query.adoc +:!example-caption: +:description: The Search Active Queries REST API is provided by the Search Service. \ +This API enables you to get information about active Search queries. diff --git a/docs/modules/fts-rest-query/partials/overview/document-before.adoc b/docs/modules/fts-rest-query/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/overview/document-end.adoc b/docs/modules/fts-rest-query/partials/overview/document-end.adoc new file mode 100644 index 00000000..cf347cd1 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/overview/document-end.adoc @@ -0,0 +1,8 @@ +[discrete] += Examples on this page + +In the HTTP request examples: + +* `$HOST` is the host name or IP address of a node running the Search Service. +* `$USER` is the user name of an authorized user -- see <>. +* `$PASSWORD` is the password to connect to Couchbase Server. \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-request.adoc b/docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-request.adoc new file mode 100644 index 00000000..835d863d --- /dev/null +++ b/docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-request.adoc @@ -0,0 +1,11 @@ += Example HTTP Request + +Request 4: Cancel a long running query with query ID `24` whose coordinator node has a uuid `b91d75480470f979f65f04e8f20a1f7b`. + +==== +.Curl request +[source,sh] +---- +include::example$api-query-cancel.sh[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-response.adoc b/docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-response.adoc new file mode 100644 index 00000000..825a2b3a --- /dev/null +++ b/docs/modules/fts-rest-query/partials/paths/api-query-cancel/http-response.adoc @@ -0,0 +1,11 @@ += Example HTTP Response + +Result of <>. + +==== +.Response 200 +[source,json] +---- +include::example$api-query-cancel.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/paths/api-query-index/http-request.adoc b/docs/modules/fts-rest-query/partials/paths/api-query-index/http-request.adoc new file mode 100644 index 00000000..b71727b0 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/paths/api-query-index/http-request.adoc @@ -0,0 +1,12 @@ += Example HTTP Request + +Request 1: Find queries on the index `DemoIndex1` that have been running for longer than 1 ms. + +[#request-1] +==== +.Curl request +[source,sh] +---- +include::example$api-query-index.sh[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/paths/api-query-index/http-response.adoc b/docs/modules/fts-rest-query/partials/paths/api-query-index/http-response.adoc new file mode 100644 index 00000000..fcd01344 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/paths/api-query-index/http-response.adoc @@ -0,0 +1,11 @@ += Example HTTP Response + +Result of <>. + +==== +.Response 200 +[source,json] +---- +include::example$api-query-index.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/paths/api-query/http-request.adoc b/docs/modules/fts-rest-query/partials/paths/api-query/http-request.adoc new file mode 100644 index 00000000..e1e1f956 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/paths/api-query/http-request.adoc @@ -0,0 +1,23 @@ += Example HTTP Request + +Request 2: Find all active queries across the Search cluster. + +[#request-2] +==== +.Curl request +[source,sh] +---- +include::example$api-query-all.sh[] +---- +==== + +Request 3: Find all queries across the cluster that have been running for longer than 7s. + +[#request-3] +==== +.Curl request +[source,sh] +---- +include::example$api-query-filter.sh[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/paths/api-query/http-response.adoc b/docs/modules/fts-rest-query/partials/paths/api-query/http-response.adoc new file mode 100644 index 00000000..dbad3452 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/paths/api-query/http-response.adoc @@ -0,0 +1,21 @@ += Example HTTP Response + +Result of <>. + +==== +.Response 200 +[source,json] +---- +include::example$api-query-all.json[] +---- +==== + +Result of <>. + +==== +.Response 200 +[source,json] +---- +include::example$api-query-filter.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/security/document-begin.adoc b/docs/modules/fts-rest-query/partials/security/document-begin.adoc new file mode 100644 index 00000000..753b6c55 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Search REST APIs support HTTP basic authentication. +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-query/partials/security/document-end.adoc b/docs/modules/fts-rest-query/partials/security/document-end.adoc new file mode 100644 index 00000000..5330f469 --- /dev/null +++ b/docs/modules/fts-rest-query/partials/security/document-end.adoc @@ -0,0 +1 @@ +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/examples/g-api-nsstats-200.json b/docs/modules/fts-rest-stats/examples/g-api-nsstats-200.json new file mode 100644 index 00000000..34b2a157 --- /dev/null +++ b/docs/modules/fts-rest-stats/examples/g-api-nsstats-200.json @@ -0,0 +1,164 @@ +{ + "avg_queries_latency": 9.38084, + "batch_bytes_added": 1065776, + "batch_bytes_removed": 1065776, + "curr_batches_blocked_by_herder": 0, + "num_batches_introduced": 20, + "num_bytes_ram_quota": 440320000, + "num_bytes_used_disk": 38324504, + "num_bytes_used_ram": 250174920, + "num_bytes_used_ram_c": 2354288, + "num_files_on_disk": 6, + "num_gocbcore_dcp_agents": 2, + "num_gocbcore_stats_agents": 4, + "num_knn_search_requests": 7, + "pct_cpu_gc": 0.0000521150454206345, + "pct_used_ram": 56.81661518895349, + "tot_batches_flushed_on_maxops": 8, + "tot_batches_flushed_on_timer": 12, + "tot_batches_merged": 2028, + "tot_batches_new": 20, + "tot_bleve_dest_closed": 0, + "tot_bleve_dest_opened": 2, + "tot_grpc_listeners_closed": 0, + "tot_grpc_listeners_opened": 1, + "tot_grpc_queryreject_on_memquota": 0, + "tot_grpcs_listeners_closed": 0, + "tot_grpcs_listeners_opened": 1, + "tot_http_limitlisteners_closed": 0, + "tot_http_limitlisteners_opened": 1, + "tot_https_limitlisteners_closed": 0, + "tot_https_limitlisteners_opened": 2, + "tot_queryreject_on_memquota": 0, + "tot_remote_grpc": 0, + "tot_remote_grpc_ssl": 0, + "tot_remote_grpc_tls": 0, + "tot_remote_http": 0, + "tot_remote_http2": 0, + "tot_remote_http_ssl": 0, + "tot_rollback_full": 0, + "tot_rollback_partial": 0, + "total_bytes_query_results": 62573, + "total_create_index_bad_request_error": 0, + "total_create_index_internal_server_error": 0, + "total_create_index_request": 1, + "total_create_index_request_ok": 1, + "total_delete_index_bad_request_error": 0, + "total_delete_index_internal_server_error": 0, + "total_delete_index_request": 0, + "total_delete_index_request_ok": 0, + "total_gc": 412, + "total_internal_queries": 0, + "total_queries": 8, + "total_queries_bad_request_error": 1, + "total_queries_consistency_error": 0, + "total_queries_error": 1, + "total_queries_max_result_window_exceeded_error": 0, + "total_queries_partial_results_error": 0, + "total_queries_rejected_by_herder": 0, + "total_queries_search_in_context_error": 0, + "total_queries_slow": 0, + "total_queries_timeout": 0, + "total_queries_validation_error": 0, + "total_request_time": 81994975, + "travel-sample:travel-sample.inventory.travel-test:avg_grpc_internal_queries_latency": 0, + "travel-sample:travel-sample.inventory.travel-test:avg_grpc_queries_latency": 0, + "travel-sample:travel-sample.inventory.travel-test:avg_internal_queries_latency": 0, + "travel-sample:travel-sample.inventory.travel-test:avg_queries_latency": 0, + "travel-sample:travel-sample.inventory.travel-test:doc_count": 917, + "travel-sample:travel-sample.inventory.travel-test:last_access_time": "2024-08-13T18:54:00.844+00:00", + "travel-sample:travel-sample.inventory.travel-test:num_bytes_read_at_query_time": 0, + "travel-sample:travel-sample.inventory.travel-test:num_bytes_used_disk": 36279386, + "travel-sample:travel-sample.inventory.travel-test:num_bytes_used_disk_by_root": 17119280, + "travel-sample:travel-sample.inventory.travel-test:num_bytes_used_disk_by_root_reclaimable": 0, + "travel-sample:travel-sample.inventory.travel-test:num_bytes_written_at_index_time": 0, + "travel-sample:travel-sample.inventory.travel-test:num_file_merge_ops": 0, + "travel-sample:travel-sample.inventory.travel-test:num_files_on_disk": 4, + "travel-sample:travel-sample.inventory.travel-test:num_mem_merge_ops": 0, + "travel-sample:travel-sample.inventory.travel-test:num_mutations_to_index": 0, + "travel-sample:travel-sample.inventory.travel-test:num_persister_nap_merger_break": 1, + "travel-sample:travel-sample.inventory.travel-test:num_persister_nap_pause_completed": 1, + "travel-sample:travel-sample.inventory.travel-test:num_pindexes_actual": 1, + "travel-sample:travel-sample.inventory.travel-test:num_pindexes_target": 1, + "travel-sample:travel-sample.inventory.travel-test:num_recs_to_persist": 0, + "travel-sample:travel-sample.inventory.travel-test:num_root_filesegments": 1, + "travel-sample:travel-sample.inventory.travel-test:num_root_memorysegments": 0, + "travel-sample:travel-sample.inventory.travel-test:timer_batch_store_count": 0, + "travel-sample:travel-sample.inventory.travel-test:timer_data_delete_count": 0, + "travel-sample:travel-sample.inventory.travel-test:timer_data_update_count": 0, + "travel-sample:travel-sample.inventory.travel-test:timer_opaque_get_count": 2048, + "travel-sample:travel-sample.inventory.travel-test:timer_opaque_set_count": 1024, + "travel-sample:travel-sample.inventory.travel-test:timer_rollback_count": 0, + "travel-sample:travel-sample.inventory.travel-test:timer_snapshot_start_count": 96, + "travel-sample:travel-sample.inventory.travel-test:tot_seq_received": 87974, + "travel-sample:travel-sample.inventory.travel-test:total_bytes_indexed": 8523422, + "travel-sample:travel-sample.inventory.travel-test:total_bytes_query_results": 126174, + "travel-sample:travel-sample.inventory.travel-test:total_compaction_written_bytes": 15644740, + "travel-sample:travel-sample.inventory.travel-test:total_grpc_internal_queries": 0, + "travel-sample:travel-sample.inventory.travel-test:total_grpc_queries": 0, + "travel-sample:travel-sample.inventory.travel-test:total_grpc_queries_error": 0, + "travel-sample:travel-sample.inventory.travel-test:total_grpc_queries_slow": 0, + "travel-sample:travel-sample.inventory.travel-test:total_grpc_queries_timeout": 0, + "travel-sample:travel-sample.inventory.travel-test:total_grpc_request_time": 0, + "travel-sample:travel-sample.inventory.travel-test:total_internal_queries": 0, + "travel-sample:travel-sample.inventory.travel-test:total_knn_searches": 0, + "travel-sample:travel-sample.inventory.travel-test:total_queries": 0, + "travel-sample:travel-sample.inventory.travel-test:total_queries_error": 0, + "travel-sample:travel-sample.inventory.travel-test:total_queries_slow": 0, + "travel-sample:travel-sample.inventory.travel-test:total_queries_timeout": 0, + "travel-sample:travel-sample.inventory.travel-test:total_request_time": 96821165, + "travel-sample:travel-sample.inventory.travel-test:total_term_searchers": 22, + "travel-sample:travel-sample.inventory.travel-test:total_term_searchers_finished": 22, + "vector-sample:vector-sample.color.color-test:avg_grpc_internal_queries_latency": 0, + "vector-sample:vector-sample.color.color-test:avg_grpc_queries_latency": 0, + "vector-sample:vector-sample.color.color-test:avg_internal_queries_latency": 0, + "vector-sample:vector-sample.color.color-test:avg_queries_latency": 9.38084, + "vector-sample:vector-sample.color.color-test:doc_count": 153, + "vector-sample:vector-sample.color.color-test:field:colorvect_l2:num_vectors": 153, + "vector-sample:vector-sample.color.color-test:field:embedding_vector_dot:num_vectors": 153, + "vector-sample:vector-sample.color.color-test:last_access_time": "2024-04-30T15:58:55.073+00:00", + "vector-sample:vector-sample.color.color-test:num_bytes_read_at_query_time": 14780, + "vector-sample:vector-sample.color.color-test:num_bytes_used_disk": 2045118, + "vector-sample:vector-sample.color.color-test:num_bytes_used_disk_by_root": 996542, + "vector-sample:vector-sample.color.color-test:num_bytes_used_disk_by_root_reclaimable": 0, + "vector-sample:vector-sample.color.color-test:num_bytes_written_at_index_time": 1003945, + "vector-sample:vector-sample.color.color-test:num_file_merge_ops": 0, + "vector-sample:vector-sample.color.color-test:num_files_on_disk": 2, + "vector-sample:vector-sample.color.color-test:num_mem_merge_ops": 1, + "vector-sample:vector-sample.color.color-test:num_mutations_to_index": 0, + "vector-sample:vector-sample.color.color-test:num_persister_nap_merger_break": 2, + "vector-sample:vector-sample.color.color-test:num_persister_nap_pause_completed": 2, + "vector-sample:vector-sample.color.color-test:num_pindexes_actual": 1, + "vector-sample:vector-sample.color.color-test:num_pindexes_target": 1, + "vector-sample:vector-sample.color.color-test:num_recs_to_persist": 0, + "vector-sample:vector-sample.color.color-test:num_root_filesegments": 1, + "vector-sample:vector-sample.color.color-test:num_root_memorysegments": 0, + "vector-sample:vector-sample.color.color-test:timer_batch_store_count": 0, + "vector-sample:vector-sample.color.color-test:timer_data_delete_count": 0, + "vector-sample:vector-sample.color.color-test:timer_data_update_count": 153, + "vector-sample:vector-sample.color.color-test:timer_opaque_get_count": 2048, + "vector-sample:vector-sample.color.color-test:timer_opaque_set_count": 2048, + "vector-sample:vector-sample.color.color-test:timer_rollback_count": 0, + "vector-sample:vector-sample.color.color-test:timer_snapshot_start_count": 141, + "vector-sample:vector-sample.color.color-test:tot_seq_received": 5273, + "vector-sample:vector-sample.color.color-test:total_bytes_indexed": 945671, + "vector-sample:vector-sample.color.color-test:total_bytes_query_results": 62573, + "vector-sample:vector-sample.color.color-test:total_compaction_written_bytes": 996542, + "vector-sample:vector-sample.color.color-test:total_compactions": 0, + "vector-sample:vector-sample.color.color-test:total_grpc_internal_queries": 0, + "vector-sample:vector-sample.color.color-test:total_grpc_queries": 0, + "vector-sample:vector-sample.color.color-test:total_grpc_queries_error": 0, + "vector-sample:vector-sample.color.color-test:total_grpc_queries_slow": 0, + "vector-sample:vector-sample.color.color-test:total_grpc_queries_timeout": 0, + "vector-sample:vector-sample.color.color-test:total_grpc_request_time": 0, + "vector-sample:vector-sample.color.color-test:total_internal_queries": 0, + "vector-sample:vector-sample.color.color-test:total_knn_searches": 7, + "vector-sample:vector-sample.color.color-test:total_queries": 8, + "vector-sample:vector-sample.color.color-test:total_queries_error": 1, + "vector-sample:vector-sample.color.color-test:total_queries_slow": 0, + "vector-sample:vector-sample.color.color-test:total_queries_timeout": 0, + "vector-sample:vector-sample.color.color-test:total_request_time": 81994975, + "vector-sample:vector-sample.color.color-test:total_term_searchers": 80, + "vector-sample:vector-sample.color.color-test:total_term_searchers_finished": 80, + "vector-sample:vector-sample.color.color-test:total_vectors": 306 +} \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/examples/g-api-nsstats-403.json b/docs/modules/fts-rest-stats/examples/g-api-nsstats-403.json new file mode 100644 index 00000000..49bdc218 --- /dev/null +++ b/docs/modules/fts-rest-stats/examples/g-api-nsstats-403.json @@ -0,0 +1,6 @@ +{ + "message": "Forbidden. User needs one of the following permissions", + "permissions": [ + "cluster.fts!read" + ] +} \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/examples/g-api-nsstats-index-name.json b/docs/modules/fts-rest-stats/examples/g-api-nsstats-index-name.json new file mode 100644 index 00000000..76a81a84 --- /dev/null +++ b/docs/modules/fts-rest-stats/examples/g-api-nsstats-index-name.json @@ -0,0 +1,57 @@ +{ + "avg_grpc_internal_queries_latency": 0, + "avg_grpc_queries_latency": 0, + "avg_internal_queries_latency": 0, + "avg_queries_latency": 1.523718, + "batch_merge_count": 0, + "doc_count": 15000, + "iterator_next_count": 0, + "iterator_seek_count": 0, + "last_access_time": "2023-09-20T03:05:55.440-07:00", + "num_bytes_live_data": 0, + "num_bytes_read_at_query_time": 4638582, + "num_bytes_used_disk": 28062406, + "num_bytes_used_disk_by_root": 23651161, + "num_bytes_used_disk_by_root_reclaimable": 0, + "num_bytes_written_at_index_time": 21208735, + "num_files_on_disk": 6, + "num_mutations_to_index": 0, + "num_persister_nap_merger_break": 40, + "num_persister_nap_pause_completed": 7, + "num_pindexes_actual": 1, + "num_pindexes_target": 1, + "num_recs_to_persist": 0, + "num_root_filesegments": 4, + "num_root_memorysegments": 0, + "reader_get_count": 0, + "reader_multi_get_count": 0, + "reader_prefix_iterator_count": 0, + "reader_range_iterator_count": 0, + "timer_batch_store_count": 0, + "timer_data_delete_count": 0, + "timer_data_update_count": 15000, + "timer_opaque_get_count": 2048, + "timer_opaque_set_count": 2048, + "timer_rollback_count": 0, + "timer_snapshot_start_count": 1024, + "tot_seq_received": 19096, + "total_bytes_indexed": 4866486, + "total_bytes_query_results": 1798, + "total_compaction_written_bytes": 87917849, + "total_compactions": 0, + "total_grpc_internal_queries": 0, + "total_grpc_queries": 0, + "total_grpc_queries_error": 0, + "total_grpc_queries_slow": 0, + "total_grpc_queries_timeout": 0, + "total_grpc_request_time": 0, + "total_internal_queries": 0, + "total_queries": 4, + "total_queries_error": 1, + "total_queries_slow": 0, + "total_queries_timeout": 0, + "total_request_time": 6276461, + "total_term_searchers": 7, + "total_term_searchers_finished": 7, + "writer_execute_batch_count": 0 +} \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/pages/index.adoc b/docs/modules/fts-rest-stats/pages/index.adoc new file mode 100644 index 00000000..1f530718 --- /dev/null +++ b/docs/modules/fts-rest-stats/pages/index.adoc @@ -0,0 +1,2646 @@ += Couchbase Search Statistics API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbase/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Search Statistics REST API is provided by the Search service. +This API enables you to get statistics for the Search Service and your Search indexes. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Search Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Search Service REST port. Use `18094` for secure access. +-- + +[%hardbreaks] +*Values:* `8094`, `18094` +*Example:* `+++8094+++` +// end + +|=== + + +// markup not found, no include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 1 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +<> +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Default] += Default +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +<> +<> + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-before.adoc[opts=optional] + + +[#g-api-nsstats] += Get Query, Mutation, and Partition Statistics for the Search Service + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-begin.adoc[opts=optional] + + +.... +GET /api/nsstats +.... + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-description-before.adoc[opts=optional] + + +[#g-api-nsstats-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Gets query, mutation, document, partition, and compaction statistics for the Search Service and any Search indexes. + +This endpoint returns statistics provided by the Cluster Manager. +For additional statistics, including detailed partition information, see [Get Indexing and Data Metrics for All Indexes](../fts-rest-indexing/index.html#g-api-stats). +-- + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-description-end.adoc[opts=optional] + + + +[#g-api-nsstats-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-responses-before.adoc[opts=optional] + + +[#g-api-nsstats-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns statistics from the `nsstats` endpoint for the entire cluster, and for each Search index. For each Search index, the names of the statistics are prefixed with the bucket name and index name, in the form `BUCKET:INDEX:statistic_name`. +-- +a| <> + + +| 400 +a| [markdown] +-- +Object not found. The URI may be malformed. +-- +a| +| 401 +a| [markdown] +-- +Unauthorized. Failure to authenticate. +-- +a| +| 403 +a| [markdown] +-- +Forbidden. The user authenticates but does not have the appropriate permissions. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-security-before.adoc[opts=optional] + + +[#g-api-nsstats-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-nsstats/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-nsstats/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-nsstats/operation-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-before.adoc[opts=optional] + + +[#g-api-nsstats-index-name] += Get Query, Mutation, and Partition Statistics for an Index + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-begin.adoc[opts=optional] + + +.... +GET /api/nsstats/index/{INDEX_NAME} +.... + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-description-before.adoc[opts=optional] + + +[#g-api-nsstats-index-name-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Gets query, mutation, document, partition, and compaction statistics for the Search index specified in the endpoint URL. + +This endpoint returns statistics provided by the Cluster Manager. +For additional statistics, including detailed partition information, see [Get Indexing and Data Metrics for an Index](../fts-rest-indexing/index.html#g-api-stats-index-name). +-- + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-description-end.adoc[opts=optional] + + + +[#g-api-nsstats-index-name-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-parameters-before.adoc[opts=optional] + + +[#g-api-nsstats-index-name-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-parameters-begin.adoc[opts=optional] + + +[#g-api-nsstats-index-name-path] +.Path Parameters +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *INDEX_NAME* + +_required_ +a¦ + + +[markdown] +-- +The name of the Search index definition. +You must use the fully qualified name for the index, which includes the bucket and scope. + +To view the full, scoped name for an index for use with this endpoint: + +1. Go to the **Search** tab in the Couchbase Server Web Console. +2. Point to the **Index Name** for an index. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +|=== + + + + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-responses-before.adoc[opts=optional] + + +[#g-api-nsstats-index-name-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +The Search Service returns statistics from the `nsstats` endpoint for the specified index. Note that for a single index, the names of the statistics are not prefixed with the bucket name or index name. +-- +a| <> + + + +|=== + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-security-before.adoc[opts=optional] + + +[#g-api-nsstats-index-name-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| <> + +|=== + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-security-after.adoc[opts=optional] + + + +// markup not found, no include::{snippetDir}g-api-nsstats-index-name/http-request.adoc[opts=optional] + + +include::{snippetDir}g-api-nsstats-index-name/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-after.adoc[opts=optional] + + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + +:count-models: 3 + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +<> +<> +<> +endif::[] + + + +// markup not found, no include::{specDir}definitions/allStats/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#allStats] += Service Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/allStats/definition-begin.adoc[opts=optional] + + +.icon:bars[fw] Composite Schema +{blank} + +All of the following: + +* <> + + +* <> + + + + +// markup not found, no include::{specDir}definitions/allStats/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/allStats/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/clusterStats/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#clusterStats] += Cluster Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/clusterStats/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::clusterStats[] + +ifdef::model-descriptions[] +//tag::desc-clusterStats[] +Statistics for the entire cluster. +//end::desc-clusterStats[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*avg_queries_latency* + +_optional_ +a¦ + +[markdown] +-- +The average latency of all Search queries run on the cluster, in milliseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*batch_bytes_added* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes in batches that have not yet been added to the Search index. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*batch_bytes_removed* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes in batches that have been added to the Search index. + +Use together with `batch_bytes_added` to understand when indexing operations complete. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*curr_batches_blocked_by_herder* + +_optional_ +a¦ + +[markdown] +-- +The difference between the number of batches that have been indexed (`batch_bytes_removed`) and batches that have not yet been indexed (`batch_bytes_added`). + +The Search Service blocks batch indexing until there is sufficient memory available on a node. + +This statistic appears on the Server Web Console dashboard as **DCP Batches Blocked**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_batches_introduced* + +_optional_ +a¦ + +[markdown] +-- +The total number of batches introduced as part of indexing operations. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_bytes_ram_quota* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes set as the maximum usable memory for the Search Service on the cluster. + +This statistic appears on the Server Web Console dashboard as **RAM Quota for Search**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_bytes_used_disk* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes used on disk by Search indexes in the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_bytes_used_ram* + +_optional_ +a¦ + +[markdown] +-- +The number of bytes used in memory by the Search Service. + +This statistic appears on the Server Web Console dashboard as **RAM Used by Search**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_bytes_used_ram_c* + +_optional_ +a¦ + +[markdown] +-- +The number of bytes used in memory by the Search Service's C language processes. + +This amount is included as part of the total number of bytes used in memory, given by the `num_bytes_used_ram` statistic. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_files_on_disk* + +_optional_ +a¦ + +[markdown] +-- +The total number of files on disk for all Search indexes. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_gocbcore_dcp_agents* + +_optional_ +a¦ + +[markdown] +-- +The total number of Go SDK DCP agents used by the Search Service to establish DCP communication with the Data Service. + +The number of Go SDK DCP agents should be less than or equal to the number of Search index partitions on a node. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_gocbcore_stats_agents* + +_optional_ +a¦ + +[markdown] +-- +The total number of Go SDK agent pairs, used to retrieve statistics from the Data Service, that are present on a node. + +Typically, the Search Service uses one agent pair for each bucket on a node. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*num_knn_search_requests* + +_optional_ +a¦ + +[markdown] +-- +The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector-search/vector-search.html) requests made across all Search indexes in the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*pct_cpu_gc* + +_optional_ +a¦ + +[markdown] +-- +The percentage of CPU time spent by a Search index in garbage collection. +Garbage collection involves cleanup actions like removing unnecessary index entries. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*pct_used_ram* + +_optional_ +a¦ + +[markdown] +-- +The percentage of the available RAM quota used by the Search Service. + +This statistic appears on the Server Web Console dashboard as **Pct RAM Used by Search**. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*tot_batches_flushed_on_maxops* + +_optional_ +a¦ + +[markdown] +-- +The total number of batches executed due to the batch size being greater than the maximum number of operations per batch. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +A batch is executed when it's flushed to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_batches_flushed_on_timer* + +_optional_ +a¦ + +[markdown] +-- +The total number of batches executed at regular intervals. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_batches_merged* + +_optional_ +a¦ + +[markdown] +-- +The number of batches that have been merged together before being sent to the disk write queue. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +A batch is executed when it's flushed to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_batches_new* + +_optional_ +a¦ + +[markdown] +-- +The number of new batches that have been freshly introduced into the system. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_bleve_dest_closed* + +_optional_ +a¦ + +[markdown] +-- +The total number of times a Search index partition closed to new Search requests. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_bleve_dest_opened* + +_optional_ +a¦ + +[markdown] +-- +The total number of times Search index partitions were created or reopened for new Search requests, or for ingesting data coming in from DCP. + +Opening a Search index partition creates a file lock for concurrent access requests. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_grpc_listeners_closed* + +_optional_ +a¦ + +[markdown] +-- +The total number of gRPC listeners closed. + +gRPC listeners handle incoming connection requests to the Search Service. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_grpc_listeners_opened* + +_optional_ +a¦ + +[markdown] +-- +The total number of gRPC listeners opened. + +gRPC listeners handle incoming connection requests to the Search Service. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_grpc_queryreject_on_memquota* + +_optional_ +a¦ + +[markdown] +-- +The total number of gRPC queries rejected because of the available memory quota for the Search Service being less than the estimated memory required for merging search results from all partitions. + +For more information about how to set the Search Service's quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_grpcs_listeners_closed* + +_optional_ +a¦ + +[markdown] +-- +The total number of gRPC SSL listeners closed. + +gRPC SSL listeners handle incoming SSL connection requests to the Search Service. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_grpcs_listeners_opened* + +_optional_ +a¦ + +[markdown] +-- +The total number of gRPC SSL listeners opened. + +gRPC SSL listeners handle incoming SSL connection requests to the Search Service. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_http_limitlisteners_closed* + +_optional_ +a¦ + +[markdown] +-- +The total number of HTTP limit listeners closed. + +HTTP limit listeners manage limits on incoming HTTP requests to the Search Service. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_http_limitlisteners_opened* + +_optional_ +a¦ + +[markdown] +-- +The total number of HTTP limit listeners opened. + +HTTP limit listeners manage limits on incoming HTTP requests to the Search Service. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_https_limitlisteners_closed* + +_optional_ +a¦ + +[markdown] +-- +The total number of HTTPS limit listeners closed. + +HTTPS limit listeners manage limits on incoming HTTPS requests to the Search Service. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_https_limitlisteners_opened* + +_optional_ +a¦ + +[markdown] +-- +The total number of HTTPS limit listeners opened. + +HTTPS limit listeners manage limits on incoming HTTPS requests to the Search Service. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_queryreject_on_memquota* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries rejected because of the available memory quota for the Search Service being less than the estimated memory required for merging search results from all partitions. + +For more information about how to set the Search Service's quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_remote_grpc* + +_optional_ +a¦ + +[markdown] +-- +The total number of remote gRPC requests made to the Search Service. + +A request is remote if it comes from a different node in the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_remote_grpc_ssl* + +_optional_ +a¦ + +[markdown] +-- +The total number of gRPC scatter-gather requests made to the Search Service over SSL. + +A request is remote if it comes from a different node in the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_remote_grpc_tls* + +_optional_ +a¦ + +[markdown] +-- +This metric is deprecated. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_remote_http* + +_optional_ +a¦ + +[markdown] +-- +The total number of remote HTTP requests made to the Search Service. + +A request is remote if it comes from a different node in the cluster. + +Remote HTTP requests are deprecated. +Use gRPC requests, instead. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_remote_http2* + +_optional_ +a¦ + +[markdown] +-- +The total number of remote HTTPS requests made to the Search Service. + +A request is remote if it comes from a different node in the cluster. + +Remote HTTP requests are deprecated. +Use gRPC requests, instead. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_remote_http_ssl* + +_optional_ +a¦ + +[markdown] +-- +The total number of remote HTTP SSL requests made to the Search Service. + +A request is remote if it comes from a different node in the cluster. + +Remote HTTP requests are deprecated. +Use gRPC requests, instead. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_rollback_full* + +_optional_ +a¦ + +[markdown] +-- +The total number of full rollbacks that occurred on a Search index partition. + +The Search Service only maintains a small number of index snapshots at one time. + +If the Search Service loses connection to the Data Service, the Search Service compares rollback sequence numbers when the connection is re-established. +If the Search Service's index snapshots are too far ahead of the Data Service's rollback sequence number, the Search Service performs a full rollback operation on documents in the index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*tot_rollback_partial* + +_optional_ +a¦ + +[markdown] +-- +The total number of partial rollbacks that occurred on a Search index partition. + +The Search Service only maintains a small number of index snapshots at one time. + +If the Search Service loses connection to the Data Service, the Search Service compares rollback sequence numbers when the connection is re-established. +If the Search Service's index snapshots are too far ahead of the Data Service's rollback sequence number, the Search Service performs a partial rollback operation on documents in the index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_bytes_query_results* + +_optional_ +a¦ + +[markdown] +-- +The size of all results returned for Search queries. +This includes the size of all JSON sent. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_create_index_bad_request_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of bad request errors returned for requests to create new Search indexes on the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_create_index_internal_server_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of internal server errors returned for requests to create new Search indexes on the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_create_index_request* + +_optional_ +a¦ + +[markdown] +-- +The total number of requests received by the Search Service for creating new Search indexes. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_create_index_request_ok* + +_optional_ +a¦ + +[markdown] +-- +The total number of requests received by the Search Service for creating new Search indexes that were successful. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_delete_index_bad_request_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of bad request errors returned for requests to delete Search indexes on the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_delete_index_internal_server_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of internal server errors returned for requests to delete Search indexes on the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_delete_index_request* + +_optional_ +a¦ + +[markdown] +-- +The total number of requests received by the Search Service to delete Search indexes. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_delete_index_request_ok* + +_optional_ +a¦ + +[markdown] +-- +The total number of requests received by the Search Service to delete Search indexes that were successful. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_gc* + +_optional_ +a¦ + +[markdown] +-- +The total number of garbage collection events triggered by the Search Service. + +Garbage collection events include removing unnecessary index entries. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_internal_queries* + +_optional_ +a¦ + +[markdown] +-- +The number of internal queries from the coordinating node for a Search query to other nodes running the Search Service. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. +The coordinating node applies filters to the results from all Search index partitions and returns the final result set. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries per second across all Search indexes in the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_bad_request_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of bad request errors returned for Search queries on the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_consistency_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that encountered consistency errors on the cluster. + +For more information about consistency in Search queries, see [Search Request JSON Properties](https://docs.couchbase.com/server/8.0/search/search-request-params.html#ctl). +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that encountered an error on the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_max_result_window_exceeded_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that exceeded the [bleveMaxResultWindow](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-bleveMaxResultWindow.html) setting. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_partial_results_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that could only return partial results. + +A Search query can return partial results if it times out before all partitions can respond. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_rejected_by_herder* + +_optional_ +a¦ + +[markdown] +-- +The total number of queries rejected by the Search Service when the memory used approaches or exceeds the quota set for a query. + +For more information about how to set the Search Service's memory quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). + +This statistic appears on the Server Web Console dashboard as **Rejected Queries**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_search_in_context_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that returned an error when running through the `SearchInContext` API. + +These errors are typically internal server errors. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_slow* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that were added to the slow query log. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_timeout* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries that timed out. + +You can set the timeout for a query with the [ctl object](https://docs.couchbase.com/server/8.0/search/search-request-params.html#ctl). +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_queries_validation_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of queries that encountered a validation error, when the query request included a `validate` property in the `ctl` object. + +For more information, see the [validate property](https://docs.couchbase.com/server/8.0/search/search-request-params.html#validate). +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*total_request_time* + +_optional_ +a¦ + +[markdown] +-- +The total time, in nanoseconds, spent processing Search queries across the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::clusterStats[] + + + + +// markup not found, no include::{specDir}definitions/clusterStats/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/clusterStats/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/indexStats/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#indexStats] += Index Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/indexStats/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::indexStats[] + +ifdef::model-descriptions[] +//tag::desc-indexStats[] +Statistics for a single Search index. +//end::desc-indexStats[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*BUCKET:INDEX:avg_grpc_internal_queries_latency* + +_optional_ +a¦ + +[markdown] +-- +The average time taken for a Search query's scatter-gather requests between the coordinator and other nodes running the Search Service. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +The coordinator is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:avg_grpc_queries_latency* + +_optional_ +a¦ + +[markdown] +-- +The average time taken for each Search query that uses gRPC, in milliseconds for the given Search index. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:avg_internal_queries_latency* + +_optional_ +a¦ + +[markdown] +-- +The average latency, in milliseconds, for inter-node queries for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:avg_queries_latency* + +_optional_ +a¦ + +[markdown] +-- +The average latency, in milliseconds, for all Search queries on the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Query Latency**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:doc_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of documents in the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Docs**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:last_access_time* + +_optional_ +a¦ + +[markdown] +-- +The last date and time that a query ran against the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Date (date-time) + + +a¦ +*BUCKET:INDEX:num_bytes_read_at_query_time* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes read by all queries against the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_bytes_used_disk* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes used on disk by the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Disk Size**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_bytes_used_disk_by_root* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes used on disk by the root segment of the given Search index. + +The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. +Segments are stale when they're replaced by a new merged segment created by the merger. +Stale segments are deleted when they're not used by any new queries. + +The `num_bytes_used_disk_by_root` value will be less than the `num_bytes_used_disk` value. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_bytes_used_disk_by_root_reclaimable* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes used on disk by the latest root index segment snapshot, which can potentially be reclaimed by a file merge operation. + +The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. +Segments are stale when they're replaced by a new merged segment created by the merger. +Stale segments are deleted when they're not used by any new queries. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_bytes_written_at_index_time* + +_optional_ +a¦ + +[markdown] +-- +The total cumulative number of bytes written to disk as part of introducing segments, or files. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_file_merge_ops* + +_optional_ +a¦ + +[markdown] +-- +The number of merge operations completed by the merger routine, over persisted files. + +Each Search index partition has a merger and a persister. + +The persister reads in-memory segments from the disk write queue and flushes them to disk. +The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. +The persister and merger interact to continuously flush and merge new in-memory segments to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_files_on_disk* + +_optional_ +a¦ + +[markdown] +-- +The total number of files on disk for the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Disk Files**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_mem_merge_ops* + +_optional_ +a¦ + +[markdown] +-- +The number of merge operations completed by the merger routine, over in-memory segments. + +Each Search index partition has a merger and a persister. + +The persister reads in-memory segments from the disk write queue and flushes them to disk. +The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. +The persister and merger interact to continuously flush and merge new in-memory segments to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_mutations_to_index* + +_optional_ +a¦ + +[markdown] +-- +The DCP sequence numbers of changes that have not yet been indexed for the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Mutations Remaining**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_persister_nap_merger_break* + +_optional_ +a¦ + +[markdown] +-- +The number of times the persister was interrupted by the merger during a nap period. + +Each Search index partition has a merger and a persister. + +The persister reads in-memory segments from the disk write queue and flushes them to disk. +The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. +The persister and merger interact to continuously flush and merge new in-memory segments to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_persister_nap_pause_completed* + +_optional_ +a¦ + +[markdown] +-- +The number of times the persister completed its configured nap period before flushing content to disk, without being interrupted by the merger. + +Each Search index partition has a merger and a persister. + +The persister reads in-memory segments from the disk write queue and flushes them to disk. +The merger consolidates the flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. +The persister and merger interact to continuously flush and merge new in-memory segments to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_pindexes_actual* + +_optional_ +a¦ + +[markdown] +-- +The total number of partitions currently in the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Partitions**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_pindexes_target* + +_optional_ +a¦ + +[markdown] +-- +The total number of planned or expected partitions for the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Partitions Expected**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_recs_to_persist* + +_optional_ +a¦ + +[markdown] +-- +The total number of entries, including terms, records, and dictionary rows, that have not yet been persisted to disk. + +This statistic appears on the Server Web Console dashboard as **Search Records to Persist**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_root_filesegments* + +_optional_ +a¦ + +[markdown] +-- +The total number of file segments in the root segment. + +The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. + +This statistic appears on the Server Web Console dashboard as **Search Disk Segments**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:num_root_memorysegments* + +_optional_ +a¦ + +[markdown] +-- +The total number of memory segments in the root segment. + +The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. + +This statistic appears on the Server Web Console dashboard as **Search Memory Segments**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_batch_store_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of times batches were executed against the given Search index. + +Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. +A batch is executed when it's flushed to disk. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_data_delete_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of delete operations received from DCP for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_data_update_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of create or update operations received from DCP for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_opaque_get_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of times the DCP consumer had to retrieve stored metadata to aid in reconnection for the given Search index. + +If the DCP connection closes, the Search Service can use this stored metadata to resume from the last stable point. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_opaque_set_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of times the DCP consumer updated stored metadata, based on changes to Snapshot markers or the failover log, for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_rollback_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of DCP Rollback messages received for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:timer_snapshot_start_count* + +_optional_ +a¦ + +[markdown] +-- +The total number of DCP Snapshot markers received for the given Search index. + +Snapshots contain a representation of document mutations on either a write queue or in storage. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:tot_seq_received* + +_optional_ +a¦ + +[markdown] +-- +This metric is no longer used and will soon be deprecated. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_bytes_indexed* + +_optional_ +a¦ + +[markdown] +-- +The rate, in bytes per second, of content indexed in the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Index Rate**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_bytes_query_results* + +_optional_ +a¦ + +[markdown] +-- +The size of results returned for Search queries on the given Search index. +This includes the size of all JSON sent. + +This statistic appears on the Server Web Console dashboard as **Search Result Rate**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_compaction_written_bytes* + +_optional_ +a¦ + +[markdown] +-- +The total number of bytes written to disk as a result of compaction operations on the given Search index. + +This statistic appears on the Server Web Console dashboard as **Search Compaction Rate**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_grpc_internal_queries* + +_optional_ +a¦ + +[markdown] +-- +The total number of internal gRPC requests from the coordinating node for a Search query to other nodes running the Search Service, for the given Search index. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. +The coordinating node applies filters to the results from all Search index partitions and returns the final result set. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_grpc_queries* + +_optional_ +a¦ + +[markdown] +-- +The total number of queries, using gRPC for streaming, for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_grpc_queries_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of queries that resulted in an error that used gRPC for streaming on the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_grpc_queries_slow* + +_optional_ +a¦ + +[markdown] +-- +The total number of queries added to the slow query log that used gRPC for streaming on the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_grpc_queries_timeout* + +_optional_ +a¦ + +[markdown] +-- +The total number of queries that timed out that used gRPC for streaming on the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_grpc_request_time* + +_optional_ +a¦ + +[markdown] +-- +The total time, in nanoseconds, for internal scatter-gather requests. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. +The coordinating node applies filters to the results from all Search index partitions and returns the final result set. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_internal_queries* + +_optional_ +a¦ + +[markdown] +-- +The number of internal queries from the coordinating node for a Search query to other nodes running the Search Service, for the given Search index. + +The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. +The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. +The coordinating node applies filters to the results from all Search index partitions and returns the final result set. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_knn_searches* + +_optional_ +a¦ + +[markdown] +-- +The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector-search/vector-search.html) requests made to the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_queries* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries per second on the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_queries_error* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries on the given Search index that resulted in an error. + +This statistic appears on the Server Web Console dashboard as **Search Query Error Rate**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_queries_slow* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries on the given Search index in the slow query log. + +Slow queries are any queries that take longer than 5 seconds to run. + +This statistic appears on the Server Web Console dashboard as **Search Slow Queries**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_queries_timeout* + +_optional_ +a¦ + +[markdown] +-- +The total number of Search queries on the given Search index that timed out. + +This statistic appears on the Server Web Console dashboard as **Search Query Timeout Rate**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_request_time* + +_optional_ +a¦ + +[markdown] +-- +The total time, in nanoseconds, spent processing Search query requests for the given Search index. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_term_searchers* + +_optional_ +a¦ + +[markdown] +-- +The total number of term searchers for the given Search index. + +Every Search query requires 1 or more term searchers. +More complex Search queries typically require more term searchers. + +Use this statistic to approximate how complex a query is. + +This statistic appears on the Server Web Console dashboard as **Term Searchers Start Rate**. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_term_searchers_finished* + +_optional_ +a¦ + +[markdown] +-- +The total number of term searchers on the given Search index that have finished serving a Search query. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +a¦ +*BUCKET:INDEX:total_vectors* + +_optional_ +a¦ + +[markdown] +-- +The total number of vectors inside the given Search index, across all indexed fields. + +If there are no vectors inside the Search index, the REST API does not return this statistic. +-- + +[%hardbreaks] +{blank} +a¦ Integer + + +|=== + +//end::indexStats[] + + + + +// markup not found, no include::{specDir}definitions/indexStats/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/indexStats/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Admin/security-scheme-before.adoc[opts=optional] + + +[[security-admin]] += Admin + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Admin/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Full Admin**, **Cluster Admin**, or **Bucket Admin** role, with FTS Read permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Admin/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Admin/security-scheme-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Statistics/security-scheme-before.adoc[opts=optional] + + +[[security-statistics]] += Statistics + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Statistics/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +You must have the **Search Admin** role, with Stats Read permissions on the required bucket. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Statistics/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Statistics/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/fts-rest-stats/partials/header-attributes.adoc b/docs/modules/fts-rest-stats/partials/header-attributes.adoc new file mode 100644 index 00000000..1b4ed83e --- /dev/null +++ b/docs/modules/fts-rest-stats/partials/header-attributes.adoc @@ -0,0 +1,4 @@ +:page-aliases: rest-api:rest-fts-statistics.adoc +:!example-caption: +:description: The Search Statistics REST API is provided by the Search Service. \ +This API enables you to get statistics for the Search Service and your Search indexes. diff --git a/docs/modules/fts-rest-stats/partials/overview/document-before.adoc b/docs/modules/fts-rest-stats/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/fts-rest-stats/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/partials/paths/g-api-nsstats-index-name/http-response.adoc b/docs/modules/fts-rest-stats/partials/paths/g-api-nsstats-index-name/http-response.adoc new file mode 100644 index 00000000..acbf5dff --- /dev/null +++ b/docs/modules/fts-rest-stats/partials/paths/g-api-nsstats-index-name/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$g-api-nsstats-index-name.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/partials/paths/g-api-nsstats/http-response.adoc b/docs/modules/fts-rest-stats/partials/paths/g-api-nsstats/http-response.adoc new file mode 100644 index 00000000..24f10fe2 --- /dev/null +++ b/docs/modules/fts-rest-stats/partials/paths/g-api-nsstats/http-response.adoc @@ -0,0 +1,21 @@ += Example HTTP Response + +A successful response returns an object like the following, which contains statistics on 2 indexes, `travel-sample-index` and `color-test`. + +==== +.Response 200 +[source,json] +---- +include::example$g-api-nsstats-200.json[] +---- +==== + +If a user authenticates but does not have the appropriate permissions, the API returns a `403 Forbidden` response with an object similar to the following. + +==== +.Response 403 +[source,json] +---- +include::example$g-api-nsstats-403.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/partials/security/document-begin.adoc b/docs/modules/fts-rest-stats/partials/security/document-begin.adoc new file mode 100644 index 00000000..753b6c55 --- /dev/null +++ b/docs/modules/fts-rest-stats/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Search REST APIs support HTTP basic authentication. +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/docs/modules/fts-rest-stats/partials/security/document-end.adoc b/docs/modules/fts-rest-stats/partials/security/document-end.adoc new file mode 100644 index 00000000..5330f469 --- /dev/null +++ b/docs/modules/fts-rest-stats/partials/security/document-end.adoc @@ -0,0 +1 @@ +For more information, see xref:learn:security/roles.adoc[]. \ No newline at end of file diff --git a/docs/modules/index-rest-stats/pages/index.adoc b/docs/modules/index-rest-stats/pages/index.adoc index ce8688dc..b29c1eac 100644 --- a/docs/modules/index-rest-stats/pages/index.adoc +++ b/docs/modules/index-rest-stats/pages/index.adoc @@ -64,7 +64,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Index service. +The host name or IP address of a node running the Index Service. -- [%hardbreaks] @@ -75,7 +75,7 @@ The host name or IP address of a node running the Index service. a| *port* a| [markdown] -- -The Index service REST port. Use `19102` for secure access. +The Index Service REST port. Use `19102` for secure access. -- [%hardbreaks] diff --git a/docs/modules/index-rest-stats/partials/security/document-begin.adoc b/docs/modules/index-rest-stats/partials/security/document-begin.adoc index 4a4c488e..1efdc4ec 100644 --- a/docs/modules/index-rest-stats/partials/security/document-begin.adoc +++ b/docs/modules/index-rest-stats/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Index Statistics API supports admin credentials. -Credentials can be passed via HTTP headers (HTTP basic authentication). \ No newline at end of file +Pass your credentials through HTTP headers (HTTP basic authentication). \ No newline at end of file diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index fc89904f..29286292 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Query service. +The host name or IP address of a node running the Query Service. -- [%hardbreaks] @@ -76,7 +76,7 @@ The host name or IP address of a node running the Query service. a| *port* a| [markdown] -- -The Query service REST port. Use `18093` for secure access. +The Query Service REST port. Use `18093` for secure access. -- [%hardbreaks] @@ -9063,7 +9063,7 @@ a¦ [markdown] -- High water mark for temp space use directly by query. -(Doesn't include use by the GSI and FTS clients.) +(Doesn't include use by the GSI and Search clients.) -- @@ -9080,7 +9080,7 @@ a¦ [markdown] -- Current Query temp space use. -(Doesn't include use by the GSI and FTS clients.) +(Doesn't include use by the GSI and Search clients.) -- diff --git a/docs/modules/n1ql-rest-functions/pages/index.adoc b/docs/modules/n1ql-rest-functions/pages/index.adoc index c7ea55bc..7c9eb187 100644 --- a/docs/modules/n1ql-rest-functions/pages/index.adoc +++ b/docs/modules/n1ql-rest-functions/pages/index.adoc @@ -64,7 +64,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Query service. +The host name or IP address of a node running the Query Service. -- [%hardbreaks] @@ -75,7 +75,7 @@ The host name or IP address of a node running the Query service. a| *port* a| [markdown] -- -The Query service REST port. Use `18093` for secure access. +The Query Service REST port. Use `18093` for secure access. -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-functions/partials/security/document-begin.adoc b/docs/modules/n1ql-rest-functions/partials/security/document-begin.adoc index ac6095d8..fca442a4 100644 --- a/docs/modules/n1ql-rest-functions/partials/security/document-begin.adoc +++ b/docs/modules/n1ql-rest-functions/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Functions API supports admin credentials. -Credentials can be passed via HTTP headers (HTTP basic authentication). \ No newline at end of file +Pass your credentials through HTTP headers (HTTP basic authentication). \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 49d82b26..3d0ac451 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Query service. +The host name or IP address of a node running the Query Service. -- [%hardbreaks] @@ -76,7 +76,7 @@ The host name or IP address of a node running the Query service. a| *port* a| [markdown] -- -The Query service REST port. Use `18093` for secure access. +The Query Service REST port. Use `18093` for secure access. -- [%hardbreaks] @@ -2488,13 +2488,13 @@ a¦ [markdown] -- -Specifies that the query should use a full-text index. +Specifies that the query should use a Search index. If the query contains a `USING FTS` hint, that takes priority over this parameter. -If the query does not contain a `USING FTS` hint, and this parameter is set to true, all full-text indexes are considered for the query. -If a qualified full-text index is available, it is selected for the query. -If none of the available full-text indexes are qualified, the available GSI indexes are considered instead. +If the query does not contain a `USING FTS` hint, and this parameter is set to true, all Search indexes are considered for the query. +If a qualified Search index is available, it is selected for the query. +If none of the available Search indexes are qualified, the available GSI indexes are considered instead. Refer to [Flex Indexes][flex-indexes] for more information. diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index 8d58be83..f3797b99 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -64,7 +64,7 @@ The URL scheme. Use `https` for secure access. a| *host* a| [markdown] -- -The host name or IP address of a node running the Query service. +The host name or IP address of a node running the Query Service. -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-settings/partials/security/document-begin.adoc b/docs/modules/n1ql-rest-settings/partials/security/document-begin.adoc index 00904b2f..28aa1905 100644 --- a/docs/modules/n1ql-rest-settings/partials/security/document-begin.adoc +++ b/docs/modules/n1ql-rest-settings/partials/security/document-begin.adoc @@ -1,2 +1,2 @@ The Query Settings REST API supports HTTP basic authentication. -Credentials can be passed via HTTP headers. \ No newline at end of file +Pass your credentials through HTTP headers. \ No newline at end of file diff --git a/settings.gradle b/settings.gradle index 1e580782..988eb4c9 100644 --- a/settings.gradle +++ b/settings.gradle @@ -10,7 +10,13 @@ include 'admin', 'analytics-library', 'analytics-links', 'analytics-service', - 'analytics-settings' + 'analytics-settings', + 'search-index', + 'search-nodes', + 'search-advanced', + 'search-stats', + 'search-query', + 'search-manage' project(':admin').projectDir = new File (settingsDir, 'src/admin') project(':admin').buildFileName = 'admin.gradle' project(':query-settings').projectDir = new File (settingsDir, 'src/query-settings') @@ -35,3 +41,15 @@ project(':analytics-links').projectDir = new File (settingsDir, 'src/analytics-l project(':analytics-links').buildFileName = 'analytics-links.gradle' project(':analytics-library').projectDir = new File (settingsDir, 'src/analytics-library') project(':analytics-library').buildFileName = 'analytics-library.gradle' +project(':search-index').projectDir = new File (settingsDir, 'src/search-index') +project(':search-index').buildFileName = 'search-index.gradle' +project(':search-nodes').projectDir = new File (settingsDir, 'src/search-nodes') +project(':search-nodes').buildFileName = 'search-nodes.gradle' +project(':search-advanced').projectDir = new File (settingsDir, 'src/search-advanced') +project(':search-advanced').buildFileName = 'search-advanced.gradle' +project(':search-stats').projectDir = new File (settingsDir, 'src/search-stats') +project(':search-stats').buildFileName = 'search-stats.gradle' +project(':search-query').projectDir = new File (settingsDir, 'src/search-query') +project(':search-query').buildFileName = 'search-query.gradle' +project(':search-manage').projectDir = new File (settingsDir, 'src/search-manage') +project(':search-manage').buildFileName = 'search-manage.gradle' diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index 61e92791..87b9cbde 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Query service. + description: The host name or IP address of a node running the Query Service. port: default: "8093" description: |- - The Query service REST port. + The Query Service REST port. Use `18093` for secure access. enum: - "8093" @@ -1119,12 +1119,12 @@ components: type: integer description: | High water mark for temp space use directly by query. - (Doesn't include use by the GSI and FTS clients.) + (Doesn't include use by the GSI and Search clients.) temp.usage: type: integer description: | Current Query temp space use. - (Doesn't include use by the GSI and FTS clients.) + (Doesn't include use by the GSI and Search clients.) Statistics: type: object diff --git a/src/analytics-admin/swagger/analytics-admin.yaml b/src/analytics-admin/swagger/analytics-admin.yaml index 214508e8..5fe8dd37 100644 --- a/src/analytics-admin/swagger/analytics-admin.yaml +++ b/src/analytics-admin/swagger/analytics-admin.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Analytics service. + description: The host name or IP address of a node running the Analytics Service. port: default: "8095" description: |- - The Analytics service REST port. + The Analytics Service REST port. Use `18095` for secure access. enum: - "8095" diff --git a/src/analytics-config/swagger/analytics-config.yaml b/src/analytics-config/swagger/analytics-config.yaml index 4091adc9..2202b939 100644 --- a/src/analytics-config/swagger/analytics-config.yaml +++ b/src/analytics-config/swagger/analytics-config.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Analytics service. + description: The host name or IP address of a node running the Analytics Service. port: default: "8095" description: |- - The Analytics service REST port. + The Analytics Service REST port. Use `18095` for secure access. enum: - "8095" diff --git a/src/analytics-library/swagger/analytics-library.yaml b/src/analytics-library/swagger/analytics-library.yaml index e5dbe660..e1d0a431 100644 --- a/src/analytics-library/swagger/analytics-library.yaml +++ b/src/analytics-library/swagger/analytics-library.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Analytics service. + description: The host name or IP address of a node running the Analytics Service. port: default: "8095" description: |- - The Analytics service REST port. + The Analytics Service REST port. Use `18095` for secure access. enum: - "8095" diff --git a/src/analytics-links/swagger/analytics-links.yaml b/src/analytics-links/swagger/analytics-links.yaml index 77181f67..9e601a1c 100644 --- a/src/analytics-links/swagger/analytics-links.yaml +++ b/src/analytics-links/swagger/analytics-links.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Analytics service. + description: The host name or IP address of a node running the Analytics Service. port: default: "8095" description: |- - The Analytics service REST port. + The Analytics Service REST port. Use `18095` for secure access. enum: - "8095" diff --git a/src/analytics-service/swagger/analytics-service.yaml b/src/analytics-service/swagger/analytics-service.yaml index 0be29cca..1ea30df8 100644 --- a/src/analytics-service/swagger/analytics-service.yaml +++ b/src/analytics-service/swagger/analytics-service.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Analytics service. + description: The host name or IP address of a node running the Analytics Service. port: default: "8095" description: |- - The Analytics service REST port. + The Analytics Service REST port. Use `18095` for secure access. enum: - "8095" diff --git a/src/analytics-settings/swagger/analytics-settings.yaml b/src/analytics-settings/swagger/analytics-settings.yaml index b1d2b812..7e66fcb1 100644 --- a/src/analytics-settings/swagger/analytics-settings.yaml +++ b/src/analytics-settings/swagger/analytics-settings.yaml @@ -20,7 +20,7 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Analytics service. + description: The host name or IP address of a node running the Analytics Service. port: default: "8091" description: |- diff --git a/src/eventing/swagger/eventing.yaml b/src/eventing/swagger/eventing.yaml index fcb34d32..78a0796a 100644 --- a/src/eventing/swagger/eventing.yaml +++ b/src/eventing/swagger/eventing.yaml @@ -19,11 +19,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Eventing service. + description: The host name or IP address of a node running the Eventing Service. port: default: "8096" description: |- - The Eventing service REST port. + The Eventing Service REST port. Use `18096` for secure access. enum: - "8096" diff --git a/src/functions/swagger/functions.yaml b/src/functions/swagger/functions.yaml index 3ecf94d4..5f4cac26 100644 --- a/src/functions/swagger/functions.yaml +++ b/src/functions/swagger/functions.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Query service. + description: The host name or IP address of a node running the Query Service. port: default: "8093" description: |- - The Query service REST port. + The Query Service REST port. Use `18093` for secure access. enum: - "8093" diff --git a/src/indexes/swagger/indexes.yaml b/src/indexes/swagger/indexes.yaml index 679d860f..497776de 100644 --- a/src/indexes/swagger/indexes.yaml +++ b/src/indexes/swagger/indexes.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Index service. + description: The host name or IP address of a node running the Index Service. port: default: "9102" description: |- - The Index service REST port. + The Index Service REST port. Use `19102` for secure access. enum: - "9102" diff --git a/src/query-service/swagger/query-service.yaml b/src/query-service/swagger/query-service.yaml index 76012f96..4ea5ef8a 100644 --- a/src/query-service/swagger/query-service.yaml +++ b/src/query-service/swagger/query-service.yaml @@ -20,11 +20,11 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Query service. + description: The host name or IP address of a node running the Query Service. port: default: "8093" description: |- - The Query service REST port. + The Query Service REST port. Use `18093` for secure access. enum: - "8093" @@ -957,13 +957,13 @@ components: type: boolean x-desc-name: use_fts description: | - Specifies that the query should use a full-text index. + Specifies that the query should use a Search index. If the query contains a `USING FTS` hint, that takes priority over this parameter. - If the query does not contain a `USING FTS` hint, and this parameter is set to true, all full-text indexes are considered for the query. - If a qualified full-text index is available, it is selected for the query. - If none of the available full-text indexes are qualified, the available GSI indexes are considered instead. + If the query does not contain a `USING FTS` hint, and this parameter is set to true, all Search indexes are considered for the query. + If a qualified Search index is available, it is selected for the query. + If none of the available Search indexes are qualified, the available GSI indexes are considered instead. Refer to [Flex Indexes][flex-indexes] for more information. diff --git a/src/query-settings/swagger/query-settings.yaml b/src/query-settings/swagger/query-settings.yaml index 3f956831..70e71061 100644 --- a/src/query-settings/swagger/query-settings.yaml +++ b/src/query-settings/swagger/query-settings.yaml @@ -20,7 +20,7 @@ servers: - https host: default: localhost - description: The host name or IP address of a node running the Query service. + description: The host name or IP address of a node running the Query Service. port: default: "8091" description: |- diff --git a/src/search-advanced/search-advanced.gradle b/src/search-advanced/search-advanced.gradle new file mode 100644 index 00000000..04cc53cd --- /dev/null +++ b/src/search-advanced/search-advanced.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/search-advanced.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/fts-rest-advanced/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/fts-rest-advanced/partials/", + snippetDir: "${rootDir}/docs/modules/fts-rest-advanced/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/src/search-advanced/swagger/search-advanced.yaml b/src/search-advanced/swagger/search-advanced.yaml new file mode 100644 index 00000000..26c1629a --- /dev/null +++ b/src/search-advanced/swagger/search-advanced.yaml @@ -0,0 +1,235 @@ +openapi: 3.0.3 +info: + title: Couchbase Search Advanced API + description: |- + The Advanced Search REST APIs are provided by the Search service. + These APIs enable you to manage and query Search index partitions and to specify advanced settings. + version: '8.0' + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Search Service. + port: + default: "8094" + description: |- + The Search Service REST port. + Use `18094` for secure access. + enum: + - "8094" + - "18094" + +tags: + - name: Definition + x-displayName: Index Partition Definition + description: Operations for Search index partition definition. + - name: Query + x-displayName: Index Partition Querying + description: Operations for querying Search index partitions. + - name: Quota + x-displayName: Search Memory Quota + description: Operations for managing Search memory quota. + +paths: + /api/pindex: + get: + operationId: getPartition + summary: Get Index Partition Information + description: Get information about a Search index partition. + tags: + - Definition + responses: + '200': + description: A JSON object containing the Search index partition information. + content: + application/json: + schema: + $ref: '#/components/schemas/indexPartition' + example: + $ref: '../../../docs/modules/fts-rest-advanced/examples/get-partition.json' + security: + - Read: [] + + /api/pindex/{pindexName}: + get: + operationId: getPartitionName + summary: Get Index Partition by Name + description: Get information about a specific Search index partition by name. + tags: + - Definition + parameters: + - name: pindexName + in: path + required: true + schema: + type: string + description: The name of the Search index partition. + responses: + '200': + description: Success + security: + - Read: [] + + /api/pindex/{pindexName}/count: + get: + operationId: getPartitionCount + summary: Get Index Partition Document Count + description: Get the document count of a specific Search index partition. + tags: + - Query + parameters: + - name: pindexName + in: path + required: true + schema: + type: string + description: The name of the Search index partition. + responses: + '200': + description: The Search Service returns a response that includes the status `ok`. + content: + application/json: + schema: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/DocumentCount' + security: + - Read: [] + + /api/pindex/{pindexName}/query: + post: + operationId: queryPartition + summary: Query Index Partition + description: Execute a query against a specific Search index partition by name. + tags: + - Query + parameters: + - name: pindexName + in: path + required: true + schema: + type: string + description: The name of the Search index partition. + requestBody: + required: true + description: |- + A JSON object to define the settings for your Search query. + For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). + content: + application/json: + schema: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/QueryRequest' + responses: + '200': + description: |- + The response object has a status section that must be checked for every request. + Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. + content: + application/json: + schema: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/QueryResponse' + security: + - Write: [] + + /pools/default: + post: + operationId: setFtsMemoryQuota + summary: Set Search Memory Quota + description: Sets the memory quota for the Search Service. + tags: + - Quota + requestBody: + required: true + content: + application/x-www-form-urlencoded: + schema: + type: object + properties: + ftsMemoryQuota: + type: integer + description: The memory quota for the Search service. + example: 512 + x-has-example: true + responses: + '200': + description: Memory quota set. + security: + - Manage: [] + +components: + schemas: + indexPartition: + type: object + title: Index Partitions + properties: + pindexes: + $ref: '#/components/schemas/indexPartitionPIndex' + status: + description: The status of the request. + type: string + + indexPartitionPIndex: + type: object + title: Index Partitions Wrapper + description: An object containing information about 1 or more Search index partitions. + additionalProperties: + x-additionalPropertiesName: Partition Name + $ref: '#/components/schemas/indexPartitionPIndexInner' + + indexPartitionPIndexInner: + type: object + title: Index Partition + description: |- + An object containing information about a single Search index partition. + The name of the property is the name of the Search index partition. + properties: + indexName: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexName' + indexParams: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexParams' + indexType: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexType' + indexUUID: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexUUID' + name: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonPIndexName' + sourceName: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceName' + sourceParams: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceParams' + sourcePartitions: + type: string + sourceType: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceType' + sourceUUID: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceUUID' + uuid: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonPIndexUUID' + + securitySchemes: + Manage: + type: http + scheme: basic + description: |- + You must have the **Search Admin** role, with FTS Manage permissions on the required bucket. + + Read: + type: http + scheme: basic + description: |- + You must have the **Search Reader** or **Search Admin** role, with FTS Read permissions on the required bucket. + + Write: + type: http + scheme: basic + description: |- + You must have the **Search Admin** role, with FTS Write permissions on the required bucket. diff --git a/src/search-index/search-index.gradle b/src/search-index/search-index.gradle new file mode 100644 index 00000000..7e40eff1 --- /dev/null +++ b/src/search-index/search-index.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/search-index.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/fts-rest-indexing/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/fts-rest-indexing/partials/", + snippetDir: "${rootDir}/docs/modules/fts-rest-indexing/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/src/search-index/swagger/search-index.yaml b/src/search-index/swagger/search-index.yaml new file mode 100644 index 00000000..5b4a472a --- /dev/null +++ b/src/search-index/swagger/search-index.yaml @@ -0,0 +1,1299 @@ +openapi: 3.0.3 +info: + title: Couchbase Search Index Management and Monitoring API + description: |- + The Search Indexing REST API is provided by the Search service. + This API enables you to manage and monitor your Search indexes. + version: '8.0' + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Search Service. + port: + default: "8094" + description: |- + The Search Service REST port. + Use `18094` for secure access. + enum: + - "8094" + - "18094" + +tags: + - name: Definitions + x-displayName: Search Index Definitions + description: Use the following APIs to retrieve Search index definitions, create new Search indexes, or delete an existing Search index. + - name: Management + x-displayName: Index Management + description: Use the following endpoints to manage index controls, such as document ingestion, partition assignment, and queries. + - name: Monitoring + x-displayName: Index Monitoring and Debugging + description: Use the following endpoints to get statistics about Search indexes for monitoring and debugging. + - name: Querying + x-displayName: Index Querying + description: Use the following endpoints to query the contents of a Search index. + +paths: + /api/index: + get: + operationId: g-api-index + summary: Get All Search Index Definitions + description: Returns all Search index definitions from the bucket where you have read permissions, as a JSON object. + tags: + - Definitions + responses: + '200': + description: A JSON object containing all Search index definitions. + content: + application/json: + schema: + $ref: '#/components/schemas/GetIndexesResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-index.json' + security: + - Read: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index: + get: + operationId: g-api-scoped-index + summary: Get All Search Index Definitions (Scoped) + description: Returns all Search index definitions inside the bucket and scope specified in the endpoint URL as a JSON object. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + responses: + '200': + description: A JSON object containing all Search index definitions. + content: + application/json: + schema: + $ref: '#/components/schemas/GetIndexesResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-scoped-indexes.json' + security: + - Read: [] + + /api/index/{INDEX_NAME}: + get: + operationId: g-api-index-name + summary: Get Index Definition + description: Returns the definition of the Search index specified in the endpoint URL as a JSON object. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathIndexFull" + responses: + '200': + description: A JSON object containing the Search index definition. + content: + application/json: + schema: + $ref: '#/components/schemas/GetIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-index-name.json' + security: + - Read: [] + + delete: + operationId: d-api-index-name + summary: Delete Index Definition + description: Deletes the Search index definition specified in the endpoint URL. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathIndexFull" + responses: + '200': + description: The Search Service returns a response that includes the status `ok`. + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-index-name-200.json' + default: + description: The Search Service returns a non-200 HTTP error code when a request fails. + content: + application/json: + schema: + type: object + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-index-name-default.json' + security: + - Write: [] + + put: + operationId: p-api-index-name + summary: Create or Update an Index Definition + description: |- + If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. + If the Search index already exists, this endpoint updates the Search index definition. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathIndexFull" + requestBody: + required: true + description: |- + The full Search index definition. + For a detailed list of all parameters for the request body, see [Search Index JSON Properties](../search/search-index-params.html). + content: + application/json: + schema: + $ref: '#/components/schemas/IndexDefinition' + responses: + '200': + description: A JSON object indicating the status of the operation. + content: + application/json: + schema: + $ref: '#/components/schemas/PutIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-200.json' + default: + description: The Search Service returns a non-200 HTTP error code when a request fails. + content: + application/json: + schema: + type: object + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-default.json' + security: + - Write: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}: + get: + operationId: g-api-scoped-index-name + summary: Get Index Definition (Scoped) + description: |- + Returns the Search index definition for the Search index specified in the endpoint URL as a JSON object. + Unlike [Get Index Definition](#g-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + responses: + '200': + description: A JSON object containing the Search index definition. + content: + application/json: + schema: + $ref: '#/components/schemas/GetIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/fts-sample-index-def-response.json' + security: + - Read: [] + + put: + operationId: p-api-scoped-index-name + summary: Create or Update an Index Definition (Scoped) + description: |- + If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. + If the Search index already exists, this endpoint updates the Search index definition. + Unlike [Create or Update an Index Definition](#p-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + requestBody: + required: true + description: |- + The full Search index definition. + For a detailed list of all parameters for the request body, see [Search Index JSON Properties](../search/search-index-params.html). + content: + application/json: + schema: + $ref: '#/components/schemas/IndexDefinition' + responses: + '200': + description: A JSON object indicating the status of the operation. + content: + application/json: + schema: + $ref: '#/components/schemas/PutIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-200.json' + default: + description: The Search Service returns a non-200 HTTP error code when a request fails. + content: + application/json: + schema: + type: object + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-default.json' + security: + - Write: [] + + delete: + operationId: d-api-scoped-index-name + summary: Delete Index Definition (Scoped) + description: |- + Delete the Search index definition from the bucket and scope specified in the endpoint URL. + Unlike [Delete Index Definition](#d-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Definitions + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + responses: + '200': + description: A JSON object indicating the status of the operation. + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-200.json' + default: + description: The Search Service returns a non-200 HTTP error code when a request fails. + content: + application/json: + schema: + type: object + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-default.json' + security: + - Write: [] + + /api/index/{INDEX_NAME}/ingestControl/{OP}: + post: + operationId: p-api-idx-name-ingestcontrol + summary: Set Index Ingestion Control + description: |- + For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. + While paused, the Search index does not load any new document mutations. + tags: + - Management + parameters: + - $ref: "#/components/parameters/PathIndexFull" + - $ref: "#/components/parameters/PathOpIngest" + responses: + '200': + $ref: "#/components/responses/OK" + security: + - Manage: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/ingestControl/{OP}: + post: + operationId: p-api-scoped-ingestcontrol + summary: Set Index Ingestion Control (Scoped) + description: |- + For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. + While paused, the Search index does not load any new document mutations. + Unlike [Set Index Ingestion Control](#p-api-idx-name-ingestcontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Management + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + - $ref: "#/components/parameters/PathOpIngest" + responses: + '200': + $ref: "#/components/responses/OK" + security: + - Manage: [] + + /api/index/{INDEX_NAME}/planFreezeControl/{OP}: + post: + operationId: p-api-idx-name-planfreezecontrol + summary: Freeze Index Partition Assignment + description: |- + For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. + While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. + tags: + - Management + parameters: + - $ref: "#/components/parameters/PathIndexFull" + - $ref: "#/components/parameters/PathOpPartition" + responses: + '200': + $ref: "#/components/responses/OK" + security: + - Manage: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/planFreezeControl/{OP}: + post: + operationId: p-api-scoped-planfreezecontrol + summary: Freeze Index Partition Assignment (Scoped) + description: |- + For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. + While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. + Unlike [Freeze Index Partition Assignment](#p-api-idx-name-planfreezecontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Management + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + - $ref: "#/components/parameters/PathOpPartition" + responses: + '200': + $ref: "#/components/responses/OK" + security: + - Manage: [] + + /api/index/{INDEX_NAME}/queryControl/{OP}: + post: + operationId: p-api-idx-name-querycontrol + summary: Stop Queries on an Index + description: |- + For the Search index specified in the endpoint URL, disallow or allow queries. + While queries are disallowed, users see an error that the Search index's partitions could not be reached. + tags: + - Management + parameters: + - $ref: "#/components/parameters/PathIndexFull" + - $ref: "#/components/parameters/PathOpQuery" + responses: + '200': + $ref: "#/components/responses/OK" + security: + - Manage: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/queryControl/{OP}: + post: + operationId: p-api-scoped-querycontrol + summary: Stop Queries on an Index (Scoped) + description: |- + For the Search index specified in the endpoint URL, disallow or allow queries. + While queries are disallowed, users see an error that the Search index's partitions could not be reached. + Unlike [Stop Queries on an Index](#p-api-idx-name-querycontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Management + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + - $ref: "#/components/parameters/PathOpQuery" + responses: + '200': + $ref: "#/components/responses/OK" + security: + - Manage: [] + + /api/stats: + get: + operationId: g-api-stats + summary: Get Indexing and Data Metrics for All Indexes + description: |- + Returns indexing and data-related metrics, timings, counters, and detailed partition information for all Search indexes, from the node running the Search Service. + + This endpoint returns statistics provided by the Search service. + For additional statistics, see [Get Query, Mutation, and Partition Statistics for the Search Service](../fts-rest-stats/index.html#g-api-nsstats). + tags: + - Monitoring + responses: + '200': + description: A JSON object containing indexing and data metrics. + content: + application/json: + schema: + $ref: '#/components/schemas/StatsNodeResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats.json' + security: + - Statistics: [] + + /api/stats/index/{INDEX_NAME}: + get: + operationId: g-api-stats-index-name + summary: Get Indexing and Data Metrics for an Index + description: |- + Returns indexing and data-related metrics, timings, counters, and detailed partition information for the Search index specified in the endpoint URL. + + This endpoint returns statistics provided by the Search service. + For additional statistics, see [Get Query, Mutation, and Partition Statistics for an Index](../fts-rest-stats/index.html#g-api-nsstats-index-name). + tags: + - Monitoring + parameters: + - $ref: "#/components/parameters/PathIndexFull" + responses: + '200': + description: A JSON object containing statistics for the specified Search index. + content: + application/json: + schema: + $ref: '#/components/schemas/StatsIndexResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats-index-name.json' + security: + - Statistics: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/status: + get: + operationId: g-api-scoped-status + summary: Get Index Status (Scoped) + description: | + Returns the status of the Search index specified in the endpoint URL, including whether all index partitions are created and ready to use. + tags: + - Monitoring + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + responses: + '200': + description: The Search Service returns a response that includes the status `ok`. + content: + application/json: + schema: + $ref: '#/components/schemas/StatusResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-scoped-status.json' + security: + - Read: [] + + /api/index/{INDEX_NAME}/analyzeDoc: + post: + operationId: g-api-stats-index-name-analyzeDoc + summary: Analyze Document + description: | + Use the Search index specified in the endpoint URL to analyze a document from the request body. + tags: + - Monitoring + parameters: + - $ref: "#/components/parameters/PathIndexFull" + requestBody: + required: true + description: Add any valid JSON document to the request body. + content: + application/json: + schema: + type: object + title: Request Body + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-body.json' + responses: + '200': + description: A JSON object containing the analysis of the provided document. + content: + application/json: + schema: + $ref: '#/components/schemas/DocumentAnalysis' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-200.json' + security: + - Read: [] + + /api/index/{INDEX_NAME}/count: + get: + operationId: g-api-index-name-count + summary: Get Document Count for an Index + description: | + Returns the number of documents indexed in the specified Search index. + tags: + - Querying + parameters: + - $ref: "#/components/parameters/PathIndexFull" + responses: + '200': + description: The Search Service returns a response that includes the status `ok`. + content: + application/json: + schema: + $ref: '#/components/schemas/DocumentCount' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-index-name-count.json' + security: + - Statistics: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/pindexLookup: + post: + operationId: p-api-pindex-lookup + summary: Look Up the Index Partition for a Document (Scoped) + description: | + Send a document ID in the request body and return the Search index partition ID where the document is stored. + The endpoint returns a JSON object as a response. + tags: + - Querying + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + requestBody: + required: true + description: A valid JSON object that contains the docID property, with a value that matches the document ID for a document in the Search index. + content: + application/json: + schema: + $ref: '#/components/schemas/LookupRequest' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-body.json' + responses: + '200': + description: The Search Service returns a response that includes the status `ok`. + content: + application/json: + schema: + $ref: '#/components/schemas/LookupResponse' + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-200.json' + security: + - Manage: [] + + /api/index/{INDEX_NAME}/query: + post: + operationId: p-api-index-name-query + summary: Query a Search Index + description: | + Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. + The endpoint returns a JSON object as a response. + tags: + - Querying + parameters: + - $ref: "#/components/parameters/PathIndexFull" + requestBody: + required: true + description: |- + A JSON object to define the settings for your Search query. + For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). + content: + application/json: + schema: + $ref: '#/components/schemas/QueryRequest' + examples: + regular: + summary: Regular Query + value: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-query-regular.json' + options: + summary: Query with Options + value: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-query-options.json' + hybrid: + summary: Hybrid Query + value: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-query-hybrid.json' + responses: + '200': + description: |- + The response object has a status section that must be checked for every request. + Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. + content: + application/json: + schema: + $ref: '#/components/schemas/QueryResponse' + security: + - Manage: [] + + /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/query: + post: + operationId: p-api-scoped-query + summary: Query a Search Index (Scoped) + description: | + Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. + The endpoint returns a JSON object as a response. + Unlike [Query a Search Index](#p-api-index-name-query), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. + tags: + - Querying + parameters: + - $ref: "#/components/parameters/PathBucket" + - $ref: "#/components/parameters/PathScope" + - $ref: "#/components/parameters/PathIndex" + requestBody: + required: true + description: |- + A JSON object to define the settings for your Search query. + For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). + content: + application/json: + schema: + $ref: '#/components/schemas/QueryRequest' + responses: + '200': + description: |- + The response object has a status section that must be checked for every request. + Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. + content: + application/json: + schema: + $ref: '#/components/schemas/QueryResponse' + examples: + regular: + summary: Success Response for a Regular Query + value: + $ref: '../../../docs/modules/fts-rest-indexing/examples/fts-sample-success-response.json' + hybrid: + summary: Success Response for a Hybrid Query + value: + $ref: '../../../docs/modules/fts-rest-indexing/examples/fts-sample-success-response-vector-search.json' + default: + description: The Search Service returns a non-200 HTTP error code when a request fails. + content: + application/json: + example: + $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-scoped-query-default.json' + security: + - Manage: [] + +components: + parameters: + PathBucket: + name: BUCKET_NAME + in: path + required: true + schema: + type: string + description: The name of the bucket containing the Search index definition. + + PathScope: + name: SCOPE_NAME + in: path + required: true + schema: + type: string + description: The name of the scope containing the Search index definition. + + PathIndex: + name: INDEX_NAME + in: path + required: true + schema: + type: string + pattern: '^[A-Za-z][0-9A-Za-z_\-]*$' + description: The name of the Search index definition. + + PathIndexFull: + name: INDEX_NAME + in: path + required: true + schema: + type: string + description: |- + The name of the Search index definition. + You must use the fully qualified name for the index, which includes the bucket and scope. + + To view the full, scoped name for an index for use with this endpoint: + + 1. Go to the **Search** tab in the Couchbase Server Web Console. + 2. Point to the **Index Name** for an index. + + PathOpIngest: + name: OP + in: path + required: true + schema: + type: string + enum: + - pause + - resume + description: |- + To pause ingestion and maintenance, set `{OP}` to `pause`. + To resume ingestion and maintenance on a paused index, set `{OP}` to `resume`. + + PathOpPartition: + name: OP + in: path + required: true + schema: + type: string + enum: + - freeze + - unfreeze + description: |- + To freeze partition assignment, set `{OP}` to `freeze`. + To unfreeze partition assignment on a frozen index, set `{OP}` to `unfreeze`. + + PathOpQuery: + name: OP + in: path + required: true + schema: + type: string + enum: + - allow + - disallow + description: |- + To allow queries against a Search index, set `{OP}` to `allow`. + To block queries against a Search index, set `{OP}` to `disallow`. + + responses: + OK: + description: The Search Service returns a response that includes the status `ok`. + content: + application/json: + schema: + $ref: "#/components/schemas/MgmtResponse" + example: + $ref: "../../../docs/modules/fts-rest-indexing/examples/response-200.json" + + schemas: + DeleteIndexResponse: + type: object + title: Delete Response + properties: + status: + $ref: "#/components/schemas/CommonStatus" + uuid: + $ref: "#/components/schemas/CommonIndexUUID" + + GetIndexesResponse: + type: object + title: Indexes Response + properties: + indexDefs: + $ref: '#/components/schemas/GetIndexesResponseIndexes' + status: + $ref: "#/components/schemas/CommonStatus" + + GetIndexesResponseIndexes: + title: Index Definitions + type: object + description: An object containing Search index definitions and related information. + properties: + implVersion: + type: string + indexDefs: + $ref: '#/components/schemas/GetIndexesResponseIndexesWrapper' + uuid: + type: string + + GetIndexesResponseIndexesWrapper: + title: Index Definitions Wrapper + type: object + description: An object containing 1 or more Search index definitions. + additionalProperties: + x-additionalPropertiesName: Index Name + $ref: '#/components/schemas/IndexDefinition' + + GetIndexResponse: + type: object + title: Index Response + properties: + indexDef: + $ref: '#/components/schemas/IndexDefinition' + planPIndexes: + type: array + description: An array of objects, each containing information about a single Search index partition. + items: + $ref: '#/components/schemas/GetIndexResponsePIndex' + status: + $ref: "#/components/schemas/CommonStatus" + warnings: + type: array + description: An array of warnings. + items: + type: string + + GetIndexResponsePIndex: + type: object + title: Plan Partition + description: An object containing information about a single Search index partition. + properties: + indexName: + $ref: '#/components/schemas/CommonIndexName' + indexParams: + $ref: '#/components/schemas/CommonIndexParams' + indexType: + $ref: '#/components/schemas/CommonIndexType' + indexUUID: + $ref: '#/components/schemas/CommonIndexUUID' + name: + $ref: '#/components/schemas/CommonPIndexName' + nodes: + $ref: '#/components/schemas/GetIndexResponsePIndexNodesWrapper' + sourceName: + $ref: '#/components/schemas/CommonSourceName' + sourceParams: + $ref: '#/components/schemas/CommonSourceParams' + sourcePartitions: + type: string + sourceType: + $ref: '#/components/schemas/CommonSourceType' + sourceUUID: + $ref: '#/components/schemas/CommonSourceUUID' + uuid: + $ref: '#/components/schemas/CommonPIndexUUID' + + GetIndexResponsePIndexNodesWrapper: + type: object + title: Partition Nodes Wrapper + description: An object containing information about 1 or more Search index partition nodes. + additionalProperties: + x-additionalPropertiesName: Node UUID + $ref: '#/components/schemas/GetIndexResponsePIndexNodesWrapperNode' + + GetIndexResponsePIndexNodesWrapperNode: + type: object + title: Partition Node + description: |- + An object containing information about a single Search index partition node. + The name of the property is the node UUID. + properties: + canRead: + type: boolean + canWrite: + type: boolean + priority: + type: integer + + StatsNodeResponse: + type: object + title: Node Statistics + properties: + feeds: + type: object + manager: + $ref: "#/components/schemas/StatsNodeResponseMgr" + pindexes: + type: object + + StatsNodeResponseMgr: + type: object + title: Manager Statistics + properties: + TotCreateIndex: + type: integer + TotDeleteIndex: + type: integer + TotUpdateIndex: + type: integer + TotBatchIntro: + type: integer + TotBatchIntroFail: + type: integer + TotBatchUpdate: + type: integer + TotBatchUpdateFail: + type: integer + TotBatchDelete: + type: integer + TotBatchDeleteFail: + type: integer + TotBatchGet: + type: integer + TotBleveDestStart: + type: integer + TotBleveDestStop: + type: integer + TotBleveDestRemove: + type: integer + TotBleveDestUpdate: + type: integer + TotBleveDestUpdateFail: + type: integer + TotBleveDestIntro: + type: integer + TotBleveDestIntroFail: + type: integer + TotBleveDestBatch: + type: integer + TotBleveDestBatchFail: + type: integer + TotBleveDestDelete: + type: integer + TotBleveDestDeleteFail: + type: integer + TotBleveDestClose: + type: integer + TotBleveDestCloseFail: + type: integer + TotQuery: + type: integer + TotQueryFail: + type: integer + + StatsIndexResponse: + type: object + title: Index Statistics + properties: + feeds: + type: object + pindexes: + type: object + + LookupRequest: + type: object + title: Lookup Request + properties: + docID: + type: string + description: The document ID to look up in the Search index. + + LookupResponse: + type: object + title: Lookup Response + properties: + status: + $ref: "#/components/schemas/CommonStatus" + pindexes: + $ref: "#/components/schemas/LookupResponsePartitions" + + LookupResponsePartitions: + type: object + title: Lookup Partition Wrapper + description: An object containing information about 1 or more Search index partitions. + additionalProperties: + x-additionalPropertiesName: Partition Name + $ref: "#/components/schemas/LookupResponsePartitionsID" + + LookupResponsePartitionsID: + type: object + title: Lookup Partition + description: |- + An object containing information about a single Search index partition. + The name of the property is the Search index partition name. + properties: + id: + type: string + description: The Search index partition ID. + + PutIndexResponse: + type: object + title: Create or Update Response + properties: + status: + $ref: "#/components/schemas/CommonStatus" + name: + $ref: "#/components/schemas/CommonIndexName" + uuid: + $ref: "#/components/schemas/CommonIndexUUID" + + DocumentAnalysis: + type: object + title: Document Analysis + properties: + status: + $ref: "#/components/schemas/CommonStatus" + analyzed: + type: array + description: An array of objects containing the analysis of the document. + items: + $ref: "#/components/schemas/DocumentAnalysisItem" + + DocumentAnalysisItem: + type: object + title: Analysis Item + description: An object containing 1 or more search terms or tokens from the analyzed document. + additionalProperties: + x-additionalPropertiesName: Search Token + $ref: "#/components/schemas/DocumentAnalysisItemToken" + + DocumentAnalysisItemToken: + type: object + title: Analysis Token + description: |- + An object containing the analysis of a single search term or token from the analyzed document. + The name of the property is the search term or token. + properties: + Term: + type: string + Locations: + type: array + description: An array of objects describing the locations of the search term or token in the document. + items: + $ref: "#/components/schemas/DocumentAnalysisItemTokenLocation" + + DocumentAnalysisItemTokenLocation: + type: object + title: Analysis Token Location + description: An object describing the location of a single instance of the search term or token in the analyzed document. + properties: + Field: + type: string + description: The field in the document where the token was found. + ArrayPositions: + type: array + items: {} + Start: + type: integer + description: The starting point of the token in the field. + End: + type: integer + description: The ending point of the token in the field. + Position: + type: integer + description: The position of the token in the field. + + DocumentCount: + type: object + title: Document Count + properties: + status: + $ref: "#/components/schemas/CommonStatus" + count: + type: integer + description: The document count for the specified index. + + IndexDefinition: + type: object + title: Index Definition + description: |- + The full Search index definition. + For a detailed list of all parameters, see [Search Index JSON Properties](../search/search-index-params.html). + properties: + name: + $ref: "#/components/schemas/CommonIndexName" + type: + $ref: "#/components/schemas/CommonIndexType" + sourceName: + $ref: '#/components/schemas/CommonSourceName' + sourceUUID: + $ref: '#/components/schemas/CommonSourceUUID' + sourceParams: + $ref: "#/components/schemas/CommonSourceParams" + sourceType: + $ref: '#/components/schemas/CommonSourceType' + params: + $ref: '#/components/schemas/CommonIndexParams' + planParams: + $ref: '#/components/schemas/IndexDefinitionPlanParams' + prevIndexUUID: + type: string + writeOnly: true + description: |- + The UUID of the previous index. + Intended for clients that want to check that they are not overwriting the Search index definition updates of concurrent clients. + uuid: + $ref: '#/components/schemas/CommonIndexUUID' + required: + - name + - type + - sourceName + - sourceType + - params + - planParams + + IndexDefinitionPlanParams: + title: Plan Parameters + type: object + description: |- + The Search index's partitioning and replication settings. + For more information, see [Plan Params Object](../search/search-index-params.html#planParams). + properties: + hierarchyRules: + type: string + nullable: true + maxPartitionsPerPIndex: + type: integer + description: |- + This setting is deprecated. + Use `indexPartitions` instead. + indexPartitions: + type: integer + description: The number of partitions to split the Search index into, across the nodes you have available in your database with the Search Service enabled. + nodePlanParams: + type: string + nullable: true + numReplicas: + type: integer + description: The number of replicas the Search Service creates for the Search index to ensure high availability. + planFrozen: + type: boolean + + QueryRequest: + type: object + title: Query Request + properties: + query: + type: object + description: |- + An object that contains the properties for one of the supported query types. + For more information, see [Query Object](../search/search-request-params.html#query-object). + knn: + type: array + description: |- + An array that contains objects that describe a Vector Search query. + For more information, see [Knn Objects](../search/search-request-params.html#knn-object). + items: + type: object + ctl: + type: object + description: |- + An object that contains properties for query consistency. + For more information, see [Ctl Object](../search/search-request-params.html#ctl). + size: + type: integer + description: Set the total number of results to return for a single page of search results. + from: + type: integer + description: Set an offset value to change where pagination starts for search results. + highlight: + type: object + description: |- + Contains properties to control search result highlighting. + For more information, see [Highlight Objects](../search/search-request-params.html#highlight). + fields: + type: array + description: An array of strings to specify each indexed field you want to return in search results. + items: + type: string + facets: + type: object + description: |- + Contains nested objects to define each facet you want to return with search results. + For more information, see [Facet Objects](../search/search-request-params.html#facet-name). + explain: + type: boolean + description: Whether to create an explanation for a search result's score in search results. + sort: + type: array + description: |- + Contains an array of strings or JSON objects to set how to sort search results. + For more information, see [Sort Object](../search/search-request-params.html#sort). + items: {} + includeLocations: + type: boolean + description: Whether to return the position of each occurrence of a search term inside a document. + score: + type: string + description: Whether to include document relevancy scoring in search results. + search_after: + type: array + description: Use to control pagination in search results. + items: + type: string + search_before: + type: array + description: Use to control pagination in search results. + items: + type: string + collections: + type: array + description: An array of strings that specify the collections where you want to run the query. + items: + type: string + + QueryResponse: + type: object + title: Query Response + properties: + status: + $ref: "#/components/schemas/CommonStatus" + results: + type: array + description: The results of the Search query. + items: + type: object + + MgmtResponse: + type: object + title: Management Response + properties: + status: + $ref: "#/components/schemas/CommonStatus" + + StatusResponse: + type: object + title: Status Response + properties: + status: + $ref: "#/components/schemas/CommonStatus" + indexStatus: + type: string + description: The status of the Search index. + + CommonStatus: + type: string + title: Status + description: The status of the operation. + + CommonIndexName: + type: string + title: Index Name + description: |- + The name of the Search index. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonIndexParams: + type: object + title: Index Parameters + description: |- + The Search index's type identifier, type mappings, and analyzers. + For more information, see [Params Object](../search/search-index-params.html#params). + + CommonIndexType: + type: string + title: Index Type + description: |- + The type of the Search index. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonIndexUUID: + type: string + title: Index UUID + description: |- + The UUID of the Search index. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonSourceName: + type: string + title: Source Name + description: |- + The name of the bucket where the Search index is stored. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonSourceParams: + type: object + title: Source Parameters + description: |- + Advanced settings for Search index behavior. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonSourceType: + type: string + title: Source Type + description: |- + The type of the bucket where the Search index is stored. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonSourceUUID: + type: string + title: Source UUID + description: |- + The UUID of the bucket where the Search index is stored. + For more information, see [Initial Settings](../search/search-index-params.html#initial). + + CommonPIndexName: + type: string + title: Partition Name + description: The name of the Search index partition. + + CommonPIndexUUID: + type: string + title: Partition UUID + description: The UUID of the Search index partition. + + securitySchemes: + Manage: + type: http + scheme: basic + description: |- + You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!manage` permissions on the required bucket. + + Statistics: + type: http + scheme: basic + description: |- + You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].stats!read` permissions on the required bucket. + + Read: + type: http + scheme: basic + description: |- + You must have the **Search Reader** or **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!read` permissions on the required bucket. + + Write: + type: http + scheme: basic + description: |- + You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!write` permissions on the required bucket. diff --git a/src/search-manage/search-manage.gradle b/src/search-manage/search-manage.gradle new file mode 100644 index 00000000..d9cffca3 --- /dev/null +++ b/src/search-manage/search-manage.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/search-manage.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/fts-rest-manage/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/fts-rest-manage/partials/", + snippetDir: "${rootDir}/docs/modules/fts-rest-manage/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/src/search-manage/swagger/search-manage.yaml b/src/search-manage/swagger/search-manage.yaml new file mode 100644 index 00000000..9a5255a9 --- /dev/null +++ b/src/search-manage/swagger/search-manage.yaml @@ -0,0 +1,138 @@ +openapi: 3.0.3 +info: + title: Search Manager Options REST API + version: '8.0' + description: |- + The Search Manager Options REST API is provided by the Search service. + This API enables you to set Search manager options; in particular, to configure rebalance based on file transfer. + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Search Service. + port: + default: "8094" + description: |- + The Search Service REST port. + Use `18094` for secure access. + enum: + - "8094" + - "18094" + +paths: + /api/managerOptions: + put: + operationId: put_options + summary: Modify Search Manager Options + description: |- + Sets Search manager options. + Note that only one setting is available: `disableFileTransferRebalance`. + requestBody: + description: An object specifying Search manager options. + content: + application/json: + schema: + $ref: "#/components/schemas/Options" + security: + - Default: [] + responses: + "200": + $ref: '#/components/responses/OK' + "401": + $ref: '#/components/responses/Unauthorized' + "404": + $ref: '#/components/responses/NotFound' + "405": + $ref: '#/components/responses/NotAllowed' + x-codeSamples: + - lang: curl + label: Disable + source: + $ref: '../../../docs/modules/fts-rest-manage/examples/file-xfer-disable.sh' + - lang: curl + label: Re-enable + source: + $ref: '../../../docs/modules/fts-rest-manage/examples/file-xfer-enable.sh' + +components: + schemas: + Options: + type: object + properties: + disableFileTransferRebalance: + type: boolean + description: |- + If the value is `false` (the default), new Search Service partitions are created during rebalance by means of partition file transfer. + + If the value is `true`, partitions are created by means of partition build, from scratch, over DCP connections from the Data Service. + default: false + x-has-default: true + + Response: + type: object + required: + - status + properties: + status: + type: string + description: > + The status of the operation. + error: + type: string + description: > + The error message, if the operation was not successful. + + responses: + OK: + description: The operation was successful. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + example: + $ref: "../../../docs/modules/fts-rest-manage/examples/file-xfer-200.json" + + NotFound: + description: > + Object not found. + The URL may be incorrectly specified. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + + NotAllowed: + description: > + Method not allowed. + The method may be incorrectly specified. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + example: + $ref: "../../../docs/modules/fts-rest-manage/examples/file-xfer-405.json" + + Unauthorized: + description: > + Failure to authenticate. + The user name or password may be incorrect. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + + securitySchemes: + Default: + type: http + scheme: basic diff --git a/src/search-nodes/search-nodes.gradle b/src/search-nodes/search-nodes.gradle new file mode 100644 index 00000000..a80cdc0e --- /dev/null +++ b/src/search-nodes/search-nodes.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/search-nodes.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/fts-rest-nodes/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/fts-rest-nodes/partials/", + snippetDir: "${rootDir}/docs/modules/fts-rest-nodes/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/src/search-nodes/swagger/search-nodes.yaml b/src/search-nodes/swagger/search-nodes.yaml new file mode 100644 index 00000000..dc1468be --- /dev/null +++ b/src/search-nodes/swagger/search-nodes.yaml @@ -0,0 +1,495 @@ +openapi: 3.0.3 +info: + title: Couchbase Search Node API + description: |- + The Search Node Configuration REST API is provided by the Search service. + This API enables you to manage and monitor your Search nodes. + version: '8.0' + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Search Service. + port: + default: "8094" + description: |- + The Search Service REST port. + Use `18094` for secure access. + enum: + - "8094" + - "18094" + +tags: + - name: configuration + x-displayName: Node Configuration + description: Operations for node configuration. + - name: diagnostics + x-displayName: Node Diagnostics + description: Operations for node diagnostics. + - name: management + x-displayName: Node Management + description: Operations for node management. + - name: monitoring + x-displayName: Node Monitoring + description: Operations for node monitoring. + +paths: + /api/cfg: + get: + operationId: getClusterConfig + summary: Get Cluster Configuration + description: Returns the node's current view of the cluster's configuration as JSON. + tags: + - configuration + responses: + '200': + description: A JSON object containing the node's configuration. + content: + application/json: + schema: + $ref: '#/components/schemas/clusterConfig' + example: + $ref: '../../../docs/modules/fts-rest-nodes/examples/get-cluster-config.json' + security: + - readClusterSettings: [] + + /api/cfgRefresh: + post: + operationId: refreshClusterConfig + summary: Refresh Node Configuration + description: Requests the node to refresh its configuration from the configuration provider. + tags: + - configuration + responses: + '200': + $ref: '#/components/responses/OK' + security: + - writeClusterSettings: [] + + /api/managerKick: + post: + operationId: managerKick + summary: Replan Resource Assignments + description: Forces the node to replan resource assignments, (by running the planner, if enabled) and update its runtime state to reflect the latest plan (by running the janitor, if enabled). + tags: + - configuration + responses: + '200': + $ref: '#/components/responses/OK' + security: + - writeClusterSettings: [] + + /api/managerMeta: + get: + operationId: managerMeta + summary: Get Node Capabilities + description: |- + Returns information on the node's capabilities, including available indexing and storage options as JSON. + This operation is intended to help management tools and web UIs to be more dynamically metadata driven. + tags: + - configuration + responses: + '200': + description: A JSON object containing the node's capabilities. + content: + application/json: + schema: + type: object + security: + - writeClusterSettings: [] + + /api/diag: + get: + operationId: getDiagnostics + summary: Get Diagnostics + description: |- + Returns the full set of diagnostic information from the node as JSON. + The response is the union of the responses from the node's other REST API diagnostic and monitoring endpoints. + + For example, for a 3 node cluster, you could capture diagnostics for each node with something like: + + ```shell + curl http://cbft-01:8094/api/diag > cbft-01.json + curl http://cbft-02:8094/api/diag > cbft-02.json + curl http://cbft-03:8094/api/diag > cbft-03.json + ``` + + The response JSON object can be quite large, 100s of KB or much more. + + The motivation for this operation is to simplify working with the Couchbase community, forums, technical support, and other engineers, by making data capture from each Search node a single step. + tags: + - diagnostics + responses: + '200': + description: A JSON object containing the node's diagnostics. + content: + application/json: + schema: + type: object + security: + - readClusterLogs: [] + + /api/log: + get: + operationId: getLogs + summary: Get Node Logs + description: Returns recent log messages and key events for the node as JSON. + tags: + - diagnostics + responses: + '200': + description: A JSON object containing the node's logs. + content: + application/json: + schema: + $ref: '#/components/schemas/logInfo' + example: + $ref: '../../../docs/modules/fts-rest-nodes/examples/get-logs.json' + security: + - readClusterLogs: [] + + /api/runtime: + get: + operationId: getRuntimeInfo + summary: Get Node Runtime Information + description: Returns information on the node's software, such as version strings and slow-changing runtime settings, as JSON. + tags: + - diagnostics + responses: + '200': + description: A JSON object containing the node's runtime information. + content: + application/json: + schema: + $ref: '#/components/schemas/runtimeInfo' + example: + $ref: '../../../docs/modules/fts-rest-nodes/examples/get-runtime-info.json' + security: + - readClusterSettings: [] + + /api/runtime/args: + get: + operationId: getRuntimeArgs + summary: Get Node Runtime Arguments + description: Returns information on the node's command-line, parameters, environment variables, and OS process values as JSON. + tags: + - diagnostics + responses: + '200': + description: A JSON object containing the node's runtime arguments. + content: + application/json: + schema: + type: object + security: + - readClusterSettings: [] + + /api/runtime/profile/cpu: + post: + operationId: captureCpuProfile + summary: Capture CPU Profiling Information + description: Requests the node to capture local CPU usage profiling information. + tags: + - diagnostics + responses: + '200': + $ref: '#/components/responses/OK' + security: + - manageCluster: [] + + /api/runtime/profile/memory: + post: + operationId: captureMemoryProfile + summary: Capture Memory Profiling Information + description: Requests the node to capture local memory usage profiling information. + tags: + - diagnostics + responses: + '200': + $ref: '#/components/responses/OK' + security: + - manageCluster: [] + + /api/runtime/gc: + post: + operationId: performGC + summary: Perform Garbage Collection + description: Requests the node to perform a garbage collection. + tags: + - management + responses: + '200': + $ref: '#/components/responses/OK' + security: + - manageCluster: [] + + /api/runtime/stats: + get: + operationId: getRuntimeStats + summary: Get Runtime Statistics + description: Returns information on the node's low-level runtime stats as JSON. + tags: + - monitoring + responses: + '200': + description: A JSON object containing the node's low-level runtime statistics. + content: + application/json: + schema: + type: object + security: + - manageCluster: [] + + /api/runtime/statsMem: + get: + operationId: getMemoryStats + summary: Get Memory Statistics + description: Returns information on the node's low-level garbage collection and memory-related runtime stats as JSON. + tags: + - monitoring + responses: + '200': + description: A JSON object containing the node's memory statistics. + content: + application/json: + schema: + type: object + security: + - manageCluster: [] + +components: + responses: + OK: + description: Success. + + schemas: + clusterConfig: + title: Cluster Configuration + type: object + properties: + indexDefs: + $ref: '#/components/schemas/clusterConfigIndexes' + indexDefsCAS: + type: integer + description: Search index definition concurrency (compare and swap) value. + indexDefsErr: + type: string + description: Search index definition error. + nullable: true + nodeDefsKnown: + $ref: '#/components/schemas/clusterConfigNodesKnown' + nodeDefsKnownCAS: + type: integer + description: Known node definition concurrency (compare and swap) value. + nodeDefsKnownErr: + type: string + description: Known node definition error. + nullable: true + nodeDefsWanted: + $ref: '#/components/schemas/clusterConfigNodesWanted' + nodeDefsWantedCAS: + type: integer + description: Wanted node definition concurrency (compare and swap) value. + nodeDefsWantedErr: + type: string + description: Wanted node definition error. + nullable: true + planPIndexes: + $ref: '#/components/schemas/clusterConfigPlan' + planPIndexesCAS: + type: integer + description: Search index partition concurrency (compare and swap) value. + planPIndexesErr: + type: string + description: Search index partition error. + nullable: true + status: + type: string + description: The status of the operation. + + clusterConfigIndexes: + title: Index Definitions + type: object + description: An object containing Search index definitions and related information. + properties: + implVersion: + type: string + indexDefs: + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/GetIndexesResponseIndexesWrapper' + + clusterConfigNodesKnown: + title: Known Nodes + type: object + description: An object containing known node definitions and related information. + properties: + implVersion: + type: string + nodeDefs: + $ref: '#/components/schemas/clusterConfigNodesWrapper' + uuid: + type: string + + clusterConfigNodesWanted: + title: Wanted Nodes + type: object + description: An object containing wanted node definitions and related information. + properties: + implVersion: + type: string + nodeDefs: + $ref: '#/components/schemas/clusterConfigNodesWrapper' + uuid: + type: string + + clusterConfigNodesWrapper: + title: Node Definitions Wrapper + type: object + description: An object containing the definitions of 1 or more nodes. + additionalProperties: + x-additionalPropertiesName: Node UUID + $ref: '#/components/schemas/clusterConfigNodesWrapperNode' + + clusterConfigNodesWrapperNode: + title: Node Definition + type: object + description: |- + An object containing the definition of a single node. + The name of the property is the UUID of the node. + properties: + container: + type: string + extras: + type: string + hostPort: + type: string + implVersion: + type: string + tags: + type: string + nullable: true + uuid: + type: string + weight: + type: integer + + clusterConfigPlan: + type: object + title: Plan Partitions + description: An object containing Search index partitions and related information. + properties: + implVersion: + type: string + planPIndexes: + $ref: '#/components/schemas/clusterConfigPlanWrapper' + uuid: + type: string + warnings: + $ref: '#/components/schemas/GetIndexResponsePlanWrng' + + clusterConfigPlanWrapper: + type: object + title: Plan Partitions Wrapper + description: An object containing information about 1 or more Search index partitions. + additionalProperties: + x-additionalPropertiesName: Partition Name + $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/GetIndexResponsePIndex' + + GetIndexResponsePlanWrng: + type: object + title: Plan Warnings Wrapper + description: |- + An object containing 0, 1, or more nested objects, each containing warnings that apply to a Search index. + additionalProperties: + x-additionalPropertiesName: Index Name + $ref: '#/components/schemas/GetIndexResponsePlanWrngIndex' + + GetIndexResponsePlanWrngIndex: + type: array + title: Plan Warnings + description: |- + An array of warnings. + The name of the property is the name of the Search index. + items: + type: string + + runtimeInfo: + title: Runtime Information + type: object + properties: + arch: + type: string + description: The architecture of the node. + go: + $ref: '#/components/schemas/runtimeInfoGo' + numCPU: + type: integer + description: The number of CPUs on the node. + os: + type: string + description: The operating system of the node. + versionData: + type: string + versionMain: + type: string + + runtimeInfoGo: + type: object + title: Go Runtime Information + properties: + GOMAXPROCS: + type: integer + GOROOT: + type: string + compiler: + type: string + version: + type: string + + logInfo: + type: object + title: Log Messages + properties: + events: + type: array + items: + type: object + messages: + type: array + items: + type: object + + securitySchemes: + manageCluster: + type: http + scheme: basic + description: |- + You must have the **Full Admin** or **Cluster Admin** role, with permissions to manage the cluster. + + readClusterSettings: + type: http + scheme: basic + description: |- + You must have the **Full Admin** or **Cluster Admin** role, with permission to read cluster settings. + + readClusterLogs: + type: http + scheme: basic + description: |- + You must have the **Full Admin** or **Cluster Admin** role, with permission to read cluster logs. + + writeClusterSettings: + type: http + scheme: basic + description: |- + You must have the **Full Admin** or **Cluster Admin** role, with permission to write cluster settings. diff --git a/src/search-query/search-query.gradle b/src/search-query/search-query.gradle new file mode 100644 index 00000000..e35b1c46 --- /dev/null +++ b/src/search-query/search-query.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/search-query.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/fts-rest-query/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/fts-rest-query/partials/", + snippetDir: "${rootDir}/docs/modules/fts-rest-query/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/src/search-query/swagger/search-query.yaml b/src/search-query/swagger/search-query.yaml new file mode 100644 index 00000000..89fce693 --- /dev/null +++ b/src/search-query/swagger/search-query.yaml @@ -0,0 +1,280 @@ +openapi: 3.0.3 +info: + title: Couchbase Search Active Queries REST API + description: |- + The Search Active Queries REST API is provided by the Search service. + This API enables you to get information about active Search queries. + version: '8.0' + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Search Service. + port: + default: "8094" + description: |- + The Search Service REST port. + Use `18094` for secure access. + enum: + - "8094" + - "18094" + +paths: + /api/query/index/{indexName}: + get: + operationId: api-query-index + summary: View Active Index Queries + description: |- + Gets the details of all the active queries for any given Search index in the system. + parameters: + - $ref: '#/components/parameters/pathIndexName' + - $ref: '#/components/parameters/queryLongerThan' + x-codeSamples: + - lang: curl + label: Request 1 + source: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-index.sh' + security: + - Default: [] + responses: + "200": + description: A list of active queries for the specified Search index. + content: + application/json: + schema: + $ref: '#/components/schemas/ActiveResponse' + example: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-index.json' + + /api/query: + get: + operationId: api-query + summary: View Active Node Queries + description: Gets the details of all the active queries in any Search node in a cluster. + parameters: + - $ref: '#/components/parameters/queryLongerThan' + x-codeSamples: + - lang: curl + label: Request 2 + source: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-all.sh' + - lang: curl + label: Request 3 + source: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-filter.sh' + security: + - Default: [] + responses: + "200": + description: A list of all active Search queries across all nodes in the cluster. + content: + application/json: + schema: + $ref: '#/components/schemas/ActiveResponse' + examples: + request2: + summary: Result of request 2 + value: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-all.json' + request3: + summary: Result of request 3 + value: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-filter.json' + + /api/query/{queryID}/cancel: + post: + operationId: api-query-cancel + summary: Cancel Active Queries + description: |- + Allows the user to cancel an active query that's running longer than expected. + Use the View Active Index Queries API or the View Active Node Queries API to get the parameters `queryID` and `uuid`, which are used to identify and cancel the query. + parameters: + - $ref: '#/components/parameters/pathQueryId' + requestBody: + description: |- + The body contains the UUID of the node where the query is running. + This is optional and allows cancellation of queries on specific nodes. + required: false + content: + application/json: + schema: + $ref: '#/components/schemas/CancelRequest' + example: + uuid: "b91d75480470f979f65f04e8f20a1f7b" + x-codeSamples: + - lang: curl + label: Request 4 + source: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-cancel.sh' + security: + - Default: [] + responses: + "200": + description: The query was successfully canceled. + content: + application/json: + schema: + $ref: '#/components/schemas/CancelResponse' + example: + $ref: '../../../docs/modules/fts-rest-query/examples/api-query-cancel.json' + +components: + parameters: + pathIndexName: + name: indexName + in: path + required: true + description: The name of the Search index. + schema: + type: string + pathQueryId: + name: queryID + in: path + required: true + description: |- + The ID of the active query. + This ID is used to identify the query that you want to cancel. + schema: + type: integer + queryLongerThan: + name: longerThan + in: query + required: false + description: |- + Filters the queries running beyond the given span of time. + + The duration string is a signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as `20s`, `-1.5h` or `2h45m`. + Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. + schema: + type: string + format: duration + + schemas: + ActiveResponse: + type: object + title: Active Response + properties: + status: + type: string + description: The status of the request. + stats: + $ref: '#/components/schemas/ActiveResponseStats' + totalActiveQueryCount: + type: integer + description: The total number of active queries. + filteredActiveQueries: + $ref: '#/components/schemas/ActiveResponseFilter' + ActiveResponseStats: + type: object + title: Stats + description: An object containing request statistics. + properties: + total: + type: integer + example: 3 + x-has-example: true + successful: + type: integer + example: 3 + x-has-example: true + ActiveResponseFilter: + type: object + title: Filtered Active Queries + description: An object containing details of the filtered active queries. + properties: + indexName: + type: string + description: |- + The name of the Search index. + Only included if viewing active queries for a specific index. + longerThan: + type: string + format: duration + description: |- + The duration used to filter the active queries. + Only included if the `longerThan` query parameter is used. + queryCount: + type: integer + description: The number of filtered active queries. + queryMap: + $ref: '#/components/schemas/ActiveResponseFilterMap' + ActiveResponseFilterMap: + type: object + title: Query Map + description: Contains 1 or more nested objects, each containing the details of a single active query. + additionalProperties: + x-additionalPropertiesName: Node UUID - Query ID + $ref: '#/components/schemas/ActiveResponseFilterMapItem' + ActiveResponseFilterMapItem: + type: object + title: Query Map Item + description: |- + The details of a single active query. + The name of the property is the UUID of the node on which the query is running, and the ID of the query on that node, separated by a hyphen. + properties: + QueryContext: + $ref: '#/components/schemas/ActiveResponseFilterMapItemContext' + executionTime: + type: string + format: duration + description: The time taken to execute the query. + ActiveResponseFilterMapItemContext: + type: object + title: Query Context + description: The query context. + properties: + query: + type: object + description: |- + An object containing the Search query. + For more information, see [Search Request JSON Properties](../search/search-request-params.html). + size: + type: integer + example: 10 + x-has-example: true + from: + type: integer + example: 0 + x-has-example: true + timeout: + type: integer + example: 120000 + x-has-example: true + index: + type: string + description: The name of a Search index. + CancelRequest: + type: object + title: Cancellation Request + properties: + uuid: + type: string + description: |- + Represents the active query's coordinator node's UUID, where the query will be canceled. + This parameter allows the user to cancel a query anywhere in the system by specifying its coordinator node's UUID. + CancelResponse: + type: object + title: Cancellation Response + properties: + status: + type: string + description: The status of the request. + msg: + type: string + description: The response message, giving details of the node UUID and query ID. + + securitySchemes: + Default: + type: http + scheme: basic \ No newline at end of file diff --git a/src/search-stats/search-stats.gradle b/src/search-stats/search-stats.gradle new file mode 100644 index 00000000..7b704891 --- /dev/null +++ b/src/search-stats/search-stats.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("swagger/search-stats.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/fts-rest-stats/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbase" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/fts-rest-stats/partials/", + snippetDir: "${rootDir}/docs/modules/fts-rest-stats/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/src/search-stats/swagger/search-stats.yaml b/src/search-stats/swagger/search-stats.yaml new file mode 100644 index 00000000..2312ac67 --- /dev/null +++ b/src/search-stats/swagger/search-stats.yaml @@ -0,0 +1,780 @@ +openapi: 3.0.3 +info: + title: Couchbase Search Statistics API + description: |- + The Search Statistics REST API is provided by the Search service. + This API enables you to get statistics for the Search Service and your Search indexes. + version: '8.0' + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Search Service. + port: + default: "8094" + description: |- + The Search Service REST port. + Use `18094` for secure access. + enum: + - "8094" + - "18094" + +paths: + /api/nsstats: + get: + summary: Get Query, Mutation, and Partition Statistics for the Search Service + description: |- + Gets query, mutation, document, partition, and compaction statistics for the Search Service and any Search indexes. + + This endpoint returns statistics provided by the Cluster Manager. + For additional statistics, including detailed partition information, see [Get Indexing and Data Metrics for All Indexes](../fts-rest-indexing/index.html#g-api-stats). + operationId: g-api-nsstats + responses: + '200': + description: |- + The Search Service returns statistics from the `nsstats` endpoint for the entire cluster, and for each Search index. + + For each Search index, the names of the statistics are prefixed with the bucket name and index name, in the form `BUCKET:INDEX:statistic_name`. + content: + application/json: + schema: + $ref: '#/components/schemas/allStats' + example: + $ref: '../../../docs/modules/fts-rest-stats/examples/g-api-nsstats-200.json' + '400': + description: |- + Object not found. + The URI may be malformed. + '401': + description: |- + Unauthorized. + Failure to authenticate. + '403': + description: |- + Forbidden. + The user authenticates but does not have the appropriate permissions. + content: + application/json: + example: + $ref: '../../../docs/modules/fts-rest-stats/examples/g-api-nsstats-403.json' + security: + - Admin: [] + + /api/nsstats/index/{INDEX_NAME}: + get: + operationId: g-api-nsstats-index-name + summary: Get Query, Mutation, and Partition Statistics for an Index + description: |- + Gets query, mutation, document, partition, and compaction statistics for the Search index specified in the endpoint URL. + + This endpoint returns statistics provided by the Cluster Manager. + For additional statistics, including detailed partition information, see [Get Indexing and Data Metrics for an Index](../fts-rest-indexing/index.html#g-api-stats-index-name). + parameters: + - name: INDEX_NAME + in: path + required: true + schema: + type: string + description: |- + The name of the Search index definition. + You must use the fully qualified name for the index, which includes the bucket and scope. + + To view the full, scoped name for an index for use with this endpoint: + + 1. Go to the **Search** tab in the Couchbase Server Web Console. + 2. Point to the **Index Name** for an index. + responses: + '200': + description: |- + The Search Service returns statistics from the `nsstats` endpoint for the specified index. + + Note that for a single index, the names of the statistics are not prefixed with the bucket name or index name. + content: + application/json: + schema: + $ref: '#/components/schemas/indexStats' + example: + $ref: '../../../docs/modules/fts-rest-stats/examples/g-api-nsstats-index-name.json' + security: + - Statistics: [] + +components: + schemas: + allStats: + title: Service Statistics + allOf: + - $ref: '#/components/schemas/clusterStats' + - $ref: '#/components/schemas/indexStats' + + clusterStats: + type: object + title: Cluster Statistics + description: Statistics for the entire cluster. + properties: + avg_queries_latency: + type: number + description: The average latency of all Search queries run on the cluster, in milliseconds. + batch_bytes_added: + type: integer + description: |- + The total number of bytes in batches that have not yet been added to the Search index. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + batch_bytes_removed: + type: integer + description: |- + The total number of bytes in batches that have been added to the Search index. + + Use together with `batch_bytes_added` to understand when indexing operations complete. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + curr_batches_blocked_by_herder: + type: integer + description: |- + The difference between the number of batches that have been indexed (`batch_bytes_removed`) and batches that have not yet been indexed (`batch_bytes_added`). + + The Search Service blocks batch indexing until there is sufficient memory available on a node. + + This statistic appears on the Server Web Console dashboard as **DCP Batches Blocked**. + num_batches_introduced: + type: integer + description: |- + The total number of batches introduced as part of indexing operations. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + num_bytes_ram_quota: + type: integer + description: |- + The total number of bytes set as the maximum usable memory for the Search Service on the cluster. + + This statistic appears on the Server Web Console dashboard as **RAM Quota for Search**. + num_bytes_used_disk: + type: integer + description: The total number of bytes used on disk by Search indexes in the cluster. + num_bytes_used_ram: + type: integer + description: |- + The number of bytes used in memory by the Search Service. + + This statistic appears on the Server Web Console dashboard as **RAM Used by Search**. + num_bytes_used_ram_c: + type: integer + description: |- + The number of bytes used in memory by the Search Service's C language processes. + + This amount is included as part of the total number of bytes used in memory, given by the `num_bytes_used_ram` statistic. + num_files_on_disk: + type: integer + description: The total number of files on disk for all Search indexes. + num_gocbcore_dcp_agents: + type: integer + description: |- + The total number of Go SDK DCP agents used by the Search Service to establish DCP communication with the Data Service. + + The number of Go SDK DCP agents should be less than or equal to the number of Search index partitions on a node. + num_gocbcore_stats_agents: + type: integer + description: |- + The total number of Go SDK agent pairs, used to retrieve statistics from the Data Service, that are present on a node. + + Typically, the Search Service uses one agent pair for each bucket on a node. + num_knn_search_requests: + type: integer + description: The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector-search/vector-search.html) requests made across all Search indexes in the cluster. + pct_cpu_gc: + type: number + description: |- + The percentage of CPU time spent by a Search index in garbage collection. + Garbage collection involves cleanup actions like removing unnecessary index entries. + pct_used_ram: + type: number + description: |- + The percentage of the available RAM quota used by the Search Service. + + This statistic appears on the Server Web Console dashboard as **Pct RAM Used by Search**. + tot_batches_flushed_on_maxops: + type: integer + description: |- + The total number of batches executed due to the batch size being greater than the maximum number of operations per batch. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + A batch is executed when it's flushed to disk. + tot_batches_flushed_on_timer: + type: integer + description: The total number of batches executed at regular intervals. + tot_batches_merged: + type: integer + description: |- + The number of batches that have been merged together before being sent to the disk write queue. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + A batch is executed when it's flushed to disk. + tot_batches_new: + type: integer + description: |- + The number of new batches that have been freshly introduced into the system. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + tot_bleve_dest_closed: + type: integer + description: The total number of times a Search index partition closed to new Search requests. + tot_bleve_dest_opened: + type: integer + description: |- + The total number of times Search index partitions were created or reopened for new Search requests, or for ingesting data coming in from DCP. + + Opening a Search index partition creates a file lock for concurrent access requests. + tot_grpc_listeners_closed: + type: integer + description: |- + The total number of gRPC listeners closed. + + gRPC listeners handle incoming connection requests to the Search Service. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + tot_grpc_listeners_opened: + type: integer + description: |- + The total number of gRPC listeners opened. + + gRPC listeners handle incoming connection requests to the Search Service. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + tot_grpc_queryreject_on_memquota: + type: integer + description: |- + The total number of gRPC queries rejected because of the available memory quota for the Search Service being less than the estimated memory required for merging search results from all partitions. + + For more information about how to set the Search Service's quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + tot_grpcs_listeners_closed: + type: integer + description: |- + The total number of gRPC SSL listeners closed. + + gRPC SSL listeners handle incoming SSL connection requests to the Search Service. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + tot_grpcs_listeners_opened: + type: integer + description: |- + The total number of gRPC SSL listeners opened. + + gRPC SSL listeners handle incoming SSL connection requests to the Search Service. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + tot_http_limitlisteners_closed: + type: integer + description: |- + The total number of HTTP limit listeners closed. + + HTTP limit listeners manage limits on incoming HTTP requests to the Search Service. + tot_http_limitlisteners_opened: + type: integer + description: |- + The total number of HTTP limit listeners opened. + + HTTP limit listeners manage limits on incoming HTTP requests to the Search Service. + tot_https_limitlisteners_closed: + type: integer + description: |- + The total number of HTTPS limit listeners closed. + + HTTPS limit listeners manage limits on incoming HTTPS requests to the Search Service. + tot_https_limitlisteners_opened: + type: integer + description: |- + The total number of HTTPS limit listeners opened. + + HTTPS limit listeners manage limits on incoming HTTPS requests to the Search Service. + tot_queryreject_on_memquota: + type: integer + description: |- + The total number of Search queries rejected because of the available memory quota for the Search Service being less than the estimated memory required for merging search results from all partitions. + + For more information about how to set the Search Service's quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). + tot_remote_grpc: + type: integer + description: |- + The total number of remote gRPC requests made to the Search Service. + + A request is remote if it comes from a different node in the cluster. + tot_remote_grpc_ssl: + type: integer + description: |- + The total number of gRPC scatter-gather requests made to the Search Service over SSL. + + A request is remote if it comes from a different node in the cluster. + tot_remote_grpc_tls: + type: integer + description: This metric is deprecated. + tot_remote_http: + type: integer + description: |- + The total number of remote HTTP requests made to the Search Service. + + A request is remote if it comes from a different node in the cluster. + + Remote HTTP requests are deprecated. + Use gRPC requests, instead. + tot_remote_http2: + type: integer + description: |- + The total number of remote HTTPS requests made to the Search Service. + + A request is remote if it comes from a different node in the cluster. + + Remote HTTP requests are deprecated. + Use gRPC requests, instead. + tot_remote_http_ssl: + type: integer + description: |- + The total number of remote HTTP SSL requests made to the Search Service. + + A request is remote if it comes from a different node in the cluster. + + Remote HTTP requests are deprecated. + Use gRPC requests, instead. + tot_rollback_full: + type: integer + description: |- + The total number of full rollbacks that occurred on a Search index partition. + + The Search Service only maintains a small number of index snapshots at one time. + + If the Search Service loses connection to the Data Service, the Search Service compares rollback sequence numbers when the connection is re-established. + If the Search Service's index snapshots are too far ahead of the Data Service's rollback sequence number, the Search Service performs a full rollback operation on documents in the index. + tot_rollback_partial: + type: integer + description: |- + The total number of partial rollbacks that occurred on a Search index partition. + + The Search Service only maintains a small number of index snapshots at one time. + + If the Search Service loses connection to the Data Service, the Search Service compares rollback sequence numbers when the connection is re-established. + If the Search Service's index snapshots are too far ahead of the Data Service's rollback sequence number, the Search Service performs a partial rollback operation on documents in the index. + total_bytes_query_results: + type: integer + description: |- + The size of all results returned for Search queries. + This includes the size of all JSON sent. + total_create_index_bad_request_error: + type: integer + description: The total number of bad request errors returned for requests to create new Search indexes on the cluster. + total_create_index_internal_server_error: + type: integer + description: The total number of internal server errors returned for requests to create new Search indexes on the cluster. + total_create_index_request: + type: integer + description: The total number of requests received by the Search Service for creating new Search indexes. + total_create_index_request_ok: + type: integer + description: The total number of requests received by the Search Service for creating new Search indexes that were successful. + total_delete_index_bad_request_error: + type: integer + description: The total number of bad request errors returned for requests to delete Search indexes on the cluster. + total_delete_index_internal_server_error: + type: integer + description: The total number of internal server errors returned for requests to delete Search indexes on the cluster. + total_delete_index_request: + type: integer + description: The total number of requests received by the Search Service to delete Search indexes. + total_delete_index_request_ok: + type: integer + description: The total number of requests received by the Search Service to delete Search indexes that were successful. + total_gc: + type: integer + description: |- + The total number of garbage collection events triggered by the Search Service. + + Garbage collection events include removing unnecessary index entries. + total_internal_queries: + type: integer + description: |- + The number of internal queries from the coordinating node for a Search query to other nodes running the Search Service. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. + The coordinating node applies filters to the results from all Search index partitions and returns the final result set. + total_queries: + type: integer + description: The total number of Search queries per second across all Search indexes in the cluster. + total_queries_bad_request_error: + type: integer + description: The total number of bad request errors returned for Search queries on the cluster. + total_queries_consistency_error: + type: integer + description: |- + The total number of Search queries that encountered consistency errors on the cluster. + + For more information about consistency in Search queries, see [Search Request JSON Properties](https://docs.couchbase.com/server/8.0/search/search-request-params.html#ctl). + total_queries_error: + type: integer + description: The total number of Search queries that encountered an error on the cluster. + total_queries_max_result_window_exceeded_error: + type: integer + description: The total number of Search queries that exceeded the [bleveMaxResultWindow](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-bleveMaxResultWindow.html) setting. + total_queries_partial_results_error: + type: integer + description: |- + The total number of Search queries that could only return partial results. + + A Search query can return partial results if it times out before all partitions can respond. + total_queries_rejected_by_herder: + type: integer + description: |- + The total number of queries rejected by the Search Service when the memory used approaches or exceeds the quota set for a query. + + For more information about how to set the Search Service's memory quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). + + This statistic appears on the Server Web Console dashboard as **Rejected Queries**. + total_queries_search_in_context_error: + type: integer + description: |- + The total number of Search queries that returned an error when running through the `SearchInContext` API. + + These errors are typically internal server errors. + total_queries_slow: + type: integer + description: |- + The total number of Search queries that were added to the slow query log. + total_queries_timeout: + type: integer + description: |- + The total number of Search queries that timed out. + + You can set the timeout for a query with the [ctl object](https://docs.couchbase.com/server/8.0/search/search-request-params.html#ctl). + total_queries_validation_error: + type: integer + description: |- + The total number of queries that encountered a validation error, when the query request included a `validate` property in the `ctl` object. + + For more information, see the [validate property](https://docs.couchbase.com/server/8.0/search/search-request-params.html#validate). + total_request_time: + type: integer + description: |- + The total time, in nanoseconds, spent processing Search queries across the cluster. + + indexStats: + type: object + title: Index Statistics + description: Statistics for a single Search index. + # patternProperties: + # '(.*:.*:)?avg_grpc_internal_queries_latency': + properties: + BUCKET:INDEX:avg_grpc_internal_queries_latency: + type: integer + description: |- + The average time taken for a Search query's scatter-gather requests between the coordinator and other nodes running the Search Service. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + The coordinator is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. + BUCKET:INDEX:avg_grpc_queries_latency: + type: integer + description: |- + The average time taken for each Search query that uses gRPC, in milliseconds for the given Search index. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + BUCKET:INDEX:avg_internal_queries_latency: + type: integer + description: The average latency, in milliseconds, for inter-node queries for the given Search index. + BUCKET:INDEX:avg_queries_latency: + type: integer + description: |- + The average latency, in milliseconds, for all Search queries on the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Query Latency**. + BUCKET:INDEX:doc_count: + type: integer + description: |- + The total number of documents in the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Docs**. + BUCKET:INDEX:last_access_time: + type: string + format: date-time + description: The last date and time that a query ran against the given Search index. + BUCKET:INDEX:num_bytes_read_at_query_time: + type: integer + description: |- + The total number of bytes read by all queries against the given Search index. + BUCKET:INDEX:num_bytes_used_disk: + type: integer + description: |- + The total number of bytes used on disk by the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Disk Size**. + BUCKET:INDEX:num_bytes_used_disk_by_root: + type: integer + description: |- + The total number of bytes used on disk by the root segment of the given Search index. + + The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. + Segments are stale when they're replaced by a new merged segment created by the merger. + Stale segments are deleted when they're not used by any new queries. + + The `num_bytes_used_disk_by_root` value will be less than the `num_bytes_used_disk` value. + BUCKET:INDEX:num_bytes_used_disk_by_root_reclaimable: + type: integer + description: |- + The total number of bytes used on disk by the latest root index segment snapshot, which can potentially be reclaimed by a file merge operation. + + The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. + Segments are stale when they're replaced by a new merged segment created by the merger. + Stale segments are deleted when they're not used by any new queries. + BUCKET:INDEX:num_bytes_written_at_index_time: + type: integer + description: |- + The total cumulative number of bytes written to disk as part of introducing segments, or files. + + BUCKET:INDEX:num_file_merge_ops: + type: integer + description: |- + The number of merge operations completed by the merger routine, over persisted files. + + Each Search index partition has a merger and a persister. + + The persister reads in-memory segments from the disk write queue and flushes them to disk. + The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. + The persister and merger interact to continuously flush and merge new in-memory segments to disk. + BUCKET:INDEX:num_files_on_disk: + type: integer + description: |- + The total number of files on disk for the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Disk Files**. + BUCKET:INDEX:num_mem_merge_ops: + type: integer + description: |- + The number of merge operations completed by the merger routine, over in-memory segments. + + Each Search index partition has a merger and a persister. + + The persister reads in-memory segments from the disk write queue and flushes them to disk. + The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. + The persister and merger interact to continuously flush and merge new in-memory segments to disk. + BUCKET:INDEX:num_mutations_to_index: + type: integer + description: |- + The DCP sequence numbers of changes that have not yet been indexed for the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Mutations Remaining**. + BUCKET:INDEX:num_persister_nap_merger_break: + type: integer + description: |- + The number of times the persister was interrupted by the merger during a nap period. + + Each Search index partition has a merger and a persister. + + The persister reads in-memory segments from the disk write queue and flushes them to disk. + The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. + The persister and merger interact to continuously flush and merge new in-memory segments to disk. + BUCKET:INDEX:num_persister_nap_pause_completed: + type: integer + description: |- + The number of times the persister completed its configured nap period before flushing content to disk, without being interrupted by the merger. + + Each Search index partition has a merger and a persister. + + The persister reads in-memory segments from the disk write queue and flushes them to disk. + The merger consolidates the flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. + The persister and merger interact to continuously flush and merge new in-memory segments to disk. + BUCKET:INDEX:num_pindexes_actual: + type: integer + description: |- + The total number of partitions currently in the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Partitions**. + BUCKET:INDEX:num_pindexes_target: + type: integer + description: |- + The total number of planned or expected partitions for the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Partitions Expected**. + BUCKET:INDEX:num_recs_to_persist: + type: integer + description: |- + The total number of entries, including terms, records, and dictionary rows, that have not yet been persisted to disk. + + This statistic appears on the Server Web Console dashboard as **Search Records to Persist**. + BUCKET:INDEX:num_root_filesegments: + type: integer + description: |- + The total number of file segments in the root segment. + + The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. + + This statistic appears on the Server Web Console dashboard as **Search Disk Segments**. + BUCKET:INDEX:num_root_memorysegments: + type: integer + description: |- + The total number of memory segments in the root segment. + + The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. + + This statistic appears on the Server Web Console dashboard as **Search Memory Segments**. + BUCKET:INDEX:timer_batch_store_count: + type: integer + description: |- + The total number of times batches were executed against the given Search index. + + Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. + A batch is executed when it's flushed to disk. + BUCKET:INDEX:timer_data_delete_count: + type: integer + description: The total number of delete operations received from DCP for the given Search index. + BUCKET:INDEX:timer_data_update_count: + type: integer + description: The total number of create or update operations received from DCP for the given Search index. + BUCKET:INDEX:timer_opaque_get_count: + type: integer + description: |- + The total number of times the DCP consumer had to retrieve stored metadata to aid in reconnection for the given Search index. + + If the DCP connection closes, the Search Service can use this stored metadata to resume from the last stable point. + BUCKET:INDEX:timer_opaque_set_count: + type: integer + description: The total number of times the DCP consumer updated stored metadata, based on changes to Snapshot markers or the failover log, for the given Search index. + BUCKET:INDEX:timer_rollback_count: + type: integer + description: The total number of DCP Rollback messages received for the given Search index. + BUCKET:INDEX:timer_snapshot_start_count: + type: integer + description: |- + The total number of DCP Snapshot markers received for the given Search index. + + Snapshots contain a representation of document mutations on either a write queue or in storage. + BUCKET:INDEX:tot_seq_received: + type: integer + description: |- + This metric is no longer used and will soon be deprecated. + BUCKET:INDEX:total_bytes_indexed: + type: integer + description: |- + The rate, in bytes per second, of content indexed in the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Index Rate**. + BUCKET:INDEX:total_bytes_query_results: + type: integer + description: |- + The size of results returned for Search queries on the given Search index. + This includes the size of all JSON sent. + + This statistic appears on the Server Web Console dashboard as **Search Result Rate**. + BUCKET:INDEX:total_compaction_written_bytes: + type: integer + description: |- + The total number of bytes written to disk as a result of compaction operations on the given Search index. + + This statistic appears on the Server Web Console dashboard as **Search Compaction Rate**. + BUCKET:INDEX:total_grpc_internal_queries: + type: integer + description: |- + The total number of internal gRPC requests from the coordinating node for a Search query to other nodes running the Search Service, for the given Search index. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. + The coordinating node applies filters to the results from all Search index partitions and returns the final result set. + BUCKET:INDEX:total_grpc_queries: + type: integer + description: The total number of queries, using gRPC for streaming, for the given Search index. + BUCKET:INDEX:total_grpc_queries_error: + type: integer + description: The total number of queries that resulted in an error that used gRPC for streaming on the given Search index. + BUCKET:INDEX:total_grpc_queries_slow: + type: integer + description: The total number of queries added to the slow query log that used gRPC for streaming on the given Search index. + BUCKET:INDEX:total_grpc_queries_timeout: + type: integer + description: The total number of queries that timed out that used gRPC for streaming on the given Search index. + BUCKET:INDEX:total_grpc_request_time: + type: integer + description: |- + The total time, in nanoseconds, for internal scatter-gather requests. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. + The coordinating node applies filters to the results from all Search index partitions and returns the final result set. + BUCKET:INDEX:total_internal_queries: + type: integer + description: |- + The number of internal queries from the coordinating node for a Search query to other nodes running the Search Service, for the given Search index. + + The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. + The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. + The coordinating node applies filters to the results from all Search index partitions and returns the final result set. + BUCKET:INDEX:total_knn_searches: + type: integer + description: |- + The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector-search/vector-search.html) requests made to the given Search index. + BUCKET:INDEX:total_queries: + type: integer + description: The total number of Search queries per second on the given Search index. + BUCKET:INDEX:total_queries_error: + type: integer + description: |- + The total number of Search queries on the given Search index that resulted in an error. + + This statistic appears on the Server Web Console dashboard as **Search Query Error Rate**. + BUCKET:INDEX:total_queries_slow: + type: integer + description: |- + The total number of Search queries on the given Search index in the slow query log. + + Slow queries are any queries that take longer than 5 seconds to run. + + This statistic appears on the Server Web Console dashboard as **Search Slow Queries**. + BUCKET:INDEX:total_queries_timeout: + type: integer + description: |- + The total number of Search queries on the given Search index that timed out. + + This statistic appears on the Server Web Console dashboard as **Search Query Timeout Rate**. + BUCKET:INDEX:total_request_time: + type: integer + description: The total time, in nanoseconds, spent processing Search query requests for the given Search index. + BUCKET:INDEX:total_term_searchers: + type: integer + description: |- + The total number of term searchers for the given Search index. + + Every Search query requires 1 or more term searchers. + More complex Search queries typically require more term searchers. + + Use this statistic to approximate how complex a query is. + + This statistic appears on the Server Web Console dashboard as **Term Searchers Start Rate**. + BUCKET:INDEX:total_term_searchers_finished: + type: integer + description: The total number of term searchers on the given Search index that have finished serving a Search query. + BUCKET:INDEX:total_vectors: + type: integer + description: |- + The total number of vectors inside the given Search index, across all indexed fields. + + If there are no vectors inside the Search index, the REST API does not return this statistic. + + securitySchemes: + Admin: + type: http + scheme: basic + description: |- + You must have the **Full Admin**, **Cluster Admin**, or **Bucket Admin** role, with FTS Read permissions on the required bucket. + + Statistics: + type: http + scheme: basic + description: |- + You must have the **Search Admin** role, with Stats Read permissions on the required bucket. From 57b4bab997e5435ce600ff5c670342d7763931f1 Mon Sep 17 00:00:00 2001 From: Simon Dew Date: Tue, 19 Aug 2025 22:17:06 +0100 Subject: [PATCH 08/25] DOC-11928: Update open source license on developer doc repos (#166) * Add BSL license * Update LICENSE file --- LICENSE | 11 ++-- licenses/BSL-Couchbase.txt | 104 +++++++++++++++++++++++++++++++++++++ 2 files changed, 110 insertions(+), 5 deletions(-) create mode 100644 licenses/BSL-Couchbase.txt diff --git a/LICENSE b/LICENSE index d1ba878a..8d8ca809 100644 --- a/LICENSE +++ b/LICENSE @@ -1,10 +1,11 @@ -Couchbase Developer REST API Documentation © 2024 by Couchbase Inc. +Couchbase Developer REST API Documentation © 2025 by Couchbase Inc. -Files within the top-level src directory are not currently licensed. +Files within the top-level `src` directory are licensed under the Business Source License 1.1 (BSL). +For details, see the BSL-Couchbase.txt file in the top-level `licenses` directory. -Files within the top-level docs directory are licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. -For details, see the CC-BY-NC-SA-4.0.txt file in the top-level licenses directory, or the Creative Commons CC BY-NC-SA 4.0 license page at https://creativecommons.org/licenses/by-nc-sa/4.0/. +Files within the top-level `docs` directory are licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. +For details, see the CC-BY-NC-SA-4.0.txt file in the top-level `licenses` directory, or the Creative Commons CC BY-NC-SA 4.0 license page at https://creativecommons.org/licenses/by-nc-sa/4.0/. All other files are derivative works, based on the OpenAPI Generator Gradle Plugin. These files are licensed under the Apache License, Version 2.0, and have been modified by Couchbase Inc. -For details, see the APL2.txt file in the top-level licenses directory, or the OpenAPI Generator repository at https://github.com/OpenAPITools/openapi-generator. \ No newline at end of file +For details, see the APL2.txt file in the top-level `licenses` directory, or the OpenAPI Generator repository at https://github.com/OpenAPITools/openapi-generator. \ No newline at end of file diff --git a/licenses/BSL-Couchbase.txt b/licenses/BSL-Couchbase.txt new file mode 100644 index 00000000..69d1b389 --- /dev/null +++ b/licenses/BSL-Couchbase.txt @@ -0,0 +1,104 @@ +COUCHBASE BUSINESS SOURCE LICENSE AGREEMENT + +Business Source License 1.1 +Licensor: Couchbase, Inc. +Licensed Work: Couchbase Server Version 8.0 +The Licensed Work is © 2021-Present Couchbase, Inc. + +Additional Use Grant: You may make production use of the Licensed Work, provided +you comply with the following conditions: + +(i) You may not prepare a derivative work based upon the Licensed Work and +distribute or otherwise offer such derivative work, whether on a standalone +basis or in combination with other products, applications, or services +(including in any "as-a-service" offering, such as, by way of example, a +software-as-a-service, database-as-a-service, or infrastructure-as-a-service +offering, or any other offering based on a cloud computing or other type of +hosted distribution model (collectively, "Hosted Offerings")), for a fee or +otherwise on a commercial or other for-profit basis. + +(ii) You may not link the Licensed Work to, or otherwise include the Licensed +Work in or with, any product, application, or service (including in any Hosted +Offering) that is distributed or otherwise offered, whether on a standalone +basis or in combination with other products, applications, or services for a fee +or otherwise on a commercial or other for-profit basis. Condition (ii) shall not +limit the generality of condition (i) above. + + +Change Date: March 1, 2029 + +Change License: Apache License, Version 2.0 + + +Notice + +The Business Source License (this document, or the "License") is not an Open +Source license. However, the Licensed Work will eventually be made available +under an Open Source License, as stated in this License. License text copyright +© 2017 MariaDB Corporation Ab, All Rights Reserved. "Business Source License" is +a trademark of MariaDB Corporation Ab. + +Terms + +The Licensor hereby grants You the right to copy, modify, create derivative +works, redistribute, and make non-production use of the Licensed Work. The +Licensor may make an Additional Use Grant, above, permitting limited production +use. + +Effective on the Change Date, or the fourth anniversary of the first publicly +available distribution of a specific version of the Licensed Work under this +License, whichever comes first, the Licensor hereby grants you rights under the +terms of the Change License, and the rights granted in the paragraph above +terminate. + +If your use of the Licensed Work does not comply with the requirements currently +in effect as described in this License, you must purchase a commercial license +from the Licensor, its affiliated entities, or authorized resellers, or you must +refrain from using the Licensed Work. + +All copies of the original and modified Licensed Work, and derivative works of +the Licensed Work, are subject to this License. This License applies separately +for each version of the Licensed Work and the Change Date may vary for each +version of the Licensed Work released by Licensor. + +You must conspicuously display this License on each original or modified copy of +the Licensed Work. If you receive the Licensed Work in original or modified form +from a third party, the terms and conditions set forth in this License apply to +your use of that work. + +Any use of the Licensed Work in violation of this License will automatically +terminate your rights under this License for the current and all other versions +of the Licensed Work. + +This License does not grant you any right in any trademark or logo of Licensor +or its affiliates (provided that you may use a trademark or logo of Licensor as +expressly required by this License). + +TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN +"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS +OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE. + +MariaDB hereby grants you permission to use this License's text to license your +works, and to refer to it using the trademark "Business Source License", as long +as you comply with the Covenants of Licensor below. + +Covenants of Licensor + +In consideration of the right to use this License's text and the "Business +Source License" name and trademark, Licensor covenants to MariaDB, and to all +other recipients of the licensed work to be provided by Licensor: + +1. To specify as the Change License the GPL Version 2.0 or any later version, or +a license that is compatible with GPL Version 2.0 or a later version, where +"compatible" means that software provided under the Change License can be +included in a program with software provided under GPL Version 2.0 or a later +version. Licensor may specify additional Change Licenses without limitation. + +2. To either: (a) specify an additional grant of rights to use that does not +impose any additional restriction on the right granted in this License, as the +Additional Use Grant; or (b) insert the text "None". + +3. To specify a Change Date. + +4. Not to modify this License in any other way. From 6c31741fd31e97d9596ceef2276a69f06743c1e3 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Sat, 7 Jun 2025 00:08:54 +0100 Subject: [PATCH 09/25] DOC-13298: Migrate Search REST APIs to dev repo (#169) * Remove search specs * Update search Gradle build scripts * Move search Gradle build scripts to docs * Consolidate build and test actions --- .github/workflows/build.yml | 31 - .github/workflows/test.yml | 12 + .../fts-rest-advanced}/search-advanced.gradle | 2 +- .../fts-rest-indexing}/search-index.gradle | 2 +- .../fts-rest-manage}/search-manage.gradle | 2 +- .../fts-rest-nodes}/search-nodes.gradle | 2 +- .../fts-rest-query}/search-query.gradle | 2 +- .../fts-rest-stats}/search-stats.gradle | 2 +- settings.gradle | 12 +- .../swagger/search-advanced.yaml | 235 --- src/search-index/swagger/search-index.yaml | 1299 ----------------- src/search-manage/swagger/search-manage.yaml | 138 -- src/search-nodes/swagger/search-nodes.yaml | 495 ------- src/search-query/swagger/search-query.yaml | 280 ---- src/search-stats/swagger/search-stats.yaml | 780 ---------- 15 files changed, 24 insertions(+), 3270 deletions(-) delete mode 100644 .github/workflows/build.yml rename {src/search-advanced => docs/modules/fts-rest-advanced}/search-advanced.gradle (85%) rename {src/search-index => docs/modules/fts-rest-indexing}/search-index.gradle (86%) rename {src/search-manage => docs/modules/fts-rest-manage}/search-manage.gradle (86%) rename {src/search-nodes => docs/modules/fts-rest-nodes}/search-nodes.gradle (86%) rename {src/search-query => docs/modules/fts-rest-query}/search-query.gradle (86%) rename {src/search-stats => docs/modules/fts-rest-stats}/search-stats.gradle (86%) delete mode 100644 src/search-advanced/swagger/search-advanced.yaml delete mode 100644 src/search-index/swagger/search-index.yaml delete mode 100644 src/search-manage/swagger/search-manage.yaml delete mode 100644 src/search-nodes/swagger/search-nodes.yaml delete mode 100644 src/search-query/swagger/search-query.yaml delete mode 100644 src/search-stats/swagger/search-stats.yaml diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml deleted file mode 100644 index 2a60b1c0..00000000 --- a/.github/workflows/build.yml +++ /dev/null @@ -1,31 +0,0 @@ -# This workflow will build a Java project with Gradle -# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-gradle - -name: Gradle CI - -on: - push: - branches: [ capella ] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 11 - uses: actions/setup-java@v1 - with: - java-version: '11' - - name: Grant execute permission for gradlew - run: chmod +x gradlew - - name: Build with Gradle - run: ./gradlew --rerun-tasks - - name: Push output - run: | - git config user.name github-actions - git config user.email github-actions@github.com - git add . - git commit -m "Build output documentation" || echo "No changes to push" - git push diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 9df05676..b9c8c4ed 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -1,3 +1,6 @@ +# This workflow will build a Java project with Gradle +# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-gradle + name: Gradle CI on: @@ -11,6 +14,8 @@ jobs: steps: - uses: actions/checkout@v2 + with: + ref: ${{ github.event.pull_request.head.ref }} - name: Set up JDK 11 uses: actions/setup-java@v1 with: @@ -19,3 +24,10 @@ jobs: run: chmod +x gradlew - name: Build with Gradle run: ./gradlew --rerun-tasks + - name: Push output + run: | + git config user.name github-actions + git config user.email github-actions@github.com + git add . + git commit -m "Build output documentation" || echo "No changes to push" + git push diff --git a/src/search-advanced/search-advanced.gradle b/docs/modules/fts-rest-advanced/search-advanced.gradle similarity index 85% rename from src/search-advanced/search-advanced.gradle rename to docs/modules/fts-rest-advanced/search-advanced.gradle index 04cc53cd..afb35f5f 100644 --- a/src/search-advanced/search-advanced.gradle +++ b/docs/modules/fts-rest-advanced/search-advanced.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/search-advanced.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/advanced/advanced.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-advanced/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/search-index/search-index.gradle b/docs/modules/fts-rest-indexing/search-index.gradle similarity index 86% rename from src/search-index/search-index.gradle rename to docs/modules/fts-rest-indexing/search-index.gradle index 7e40eff1..6e9523df 100644 --- a/src/search-index/search-index.gradle +++ b/docs/modules/fts-rest-indexing/search-index.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/search-index.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/index/index.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-indexing/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/search-manage/search-manage.gradle b/docs/modules/fts-rest-manage/search-manage.gradle similarity index 86% rename from src/search-manage/search-manage.gradle rename to docs/modules/fts-rest-manage/search-manage.gradle index d9cffca3..57b4d642 100644 --- a/src/search-manage/search-manage.gradle +++ b/docs/modules/fts-rest-manage/search-manage.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/search-manage.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/manage/manage.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-manage/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/search-nodes/search-nodes.gradle b/docs/modules/fts-rest-nodes/search-nodes.gradle similarity index 86% rename from src/search-nodes/search-nodes.gradle rename to docs/modules/fts-rest-nodes/search-nodes.gradle index a80cdc0e..8152998d 100644 --- a/src/search-nodes/search-nodes.gradle +++ b/docs/modules/fts-rest-nodes/search-nodes.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/search-nodes.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/nodes/nodes.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-nodes/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/search-query/search-query.gradle b/docs/modules/fts-rest-query/search-query.gradle similarity index 86% rename from src/search-query/search-query.gradle rename to docs/modules/fts-rest-query/search-query.gradle index e35b1c46..9f25bcff 100644 --- a/src/search-query/search-query.gradle +++ b/docs/modules/fts-rest-query/search-query.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/search-query.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/query/query.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-query/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/search-stats/search-stats.gradle b/docs/modules/fts-rest-stats/search-stats.gradle similarity index 86% rename from src/search-stats/search-stats.gradle rename to docs/modules/fts-rest-stats/search-stats.gradle index 7b704891..6b3f03d6 100644 --- a/src/search-stats/search-stats.gradle +++ b/docs/modules/fts-rest-stats/search-stats.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/search-stats.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/stats/stats.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-stats/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/settings.gradle b/settings.gradle index 988eb4c9..db32b25d 100644 --- a/settings.gradle +++ b/settings.gradle @@ -41,15 +41,15 @@ project(':analytics-links').projectDir = new File (settingsDir, 'src/analytics-l project(':analytics-links').buildFileName = 'analytics-links.gradle' project(':analytics-library').projectDir = new File (settingsDir, 'src/analytics-library') project(':analytics-library').buildFileName = 'analytics-library.gradle' -project(':search-index').projectDir = new File (settingsDir, 'src/search-index') +project(':search-index').projectDir = new File (settingsDir, 'docs/modules/fts-rest-indexing') project(':search-index').buildFileName = 'search-index.gradle' -project(':search-nodes').projectDir = new File (settingsDir, 'src/search-nodes') +project(':search-nodes').projectDir = new File (settingsDir, 'docs/modules/fts-rest-nodes') project(':search-nodes').buildFileName = 'search-nodes.gradle' -project(':search-advanced').projectDir = new File (settingsDir, 'src/search-advanced') +project(':search-advanced').projectDir = new File (settingsDir, 'docs/modules/fts-rest-advanced') project(':search-advanced').buildFileName = 'search-advanced.gradle' -project(':search-stats').projectDir = new File (settingsDir, 'src/search-stats') +project(':search-stats').projectDir = new File (settingsDir, 'docs/modules/fts-rest-stats') project(':search-stats').buildFileName = 'search-stats.gradle' -project(':search-query').projectDir = new File (settingsDir, 'src/search-query') +project(':search-query').projectDir = new File (settingsDir, 'docs/modules/fts-rest-query') project(':search-query').buildFileName = 'search-query.gradle' -project(':search-manage').projectDir = new File (settingsDir, 'src/search-manage') +project(':search-manage').projectDir = new File (settingsDir, 'docs/modules/fts-rest-manage') project(':search-manage').buildFileName = 'search-manage.gradle' diff --git a/src/search-advanced/swagger/search-advanced.yaml b/src/search-advanced/swagger/search-advanced.yaml deleted file mode 100644 index 26c1629a..00000000 --- a/src/search-advanced/swagger/search-advanced.yaml +++ /dev/null @@ -1,235 +0,0 @@ -openapi: 3.0.3 -info: - title: Couchbase Search Advanced API - description: |- - The Advanced Search REST APIs are provided by the Search service. - These APIs enable you to manage and query Search index partitions and to specify advanced settings. - version: '8.0' - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Search Service. - port: - default: "8094" - description: |- - The Search Service REST port. - Use `18094` for secure access. - enum: - - "8094" - - "18094" - -tags: - - name: Definition - x-displayName: Index Partition Definition - description: Operations for Search index partition definition. - - name: Query - x-displayName: Index Partition Querying - description: Operations for querying Search index partitions. - - name: Quota - x-displayName: Search Memory Quota - description: Operations for managing Search memory quota. - -paths: - /api/pindex: - get: - operationId: getPartition - summary: Get Index Partition Information - description: Get information about a Search index partition. - tags: - - Definition - responses: - '200': - description: A JSON object containing the Search index partition information. - content: - application/json: - schema: - $ref: '#/components/schemas/indexPartition' - example: - $ref: '../../../docs/modules/fts-rest-advanced/examples/get-partition.json' - security: - - Read: [] - - /api/pindex/{pindexName}: - get: - operationId: getPartitionName - summary: Get Index Partition by Name - description: Get information about a specific Search index partition by name. - tags: - - Definition - parameters: - - name: pindexName - in: path - required: true - schema: - type: string - description: The name of the Search index partition. - responses: - '200': - description: Success - security: - - Read: [] - - /api/pindex/{pindexName}/count: - get: - operationId: getPartitionCount - summary: Get Index Partition Document Count - description: Get the document count of a specific Search index partition. - tags: - - Query - parameters: - - name: pindexName - in: path - required: true - schema: - type: string - description: The name of the Search index partition. - responses: - '200': - description: The Search Service returns a response that includes the status `ok`. - content: - application/json: - schema: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/DocumentCount' - security: - - Read: [] - - /api/pindex/{pindexName}/query: - post: - operationId: queryPartition - summary: Query Index Partition - description: Execute a query against a specific Search index partition by name. - tags: - - Query - parameters: - - name: pindexName - in: path - required: true - schema: - type: string - description: The name of the Search index partition. - requestBody: - required: true - description: |- - A JSON object to define the settings for your Search query. - For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). - content: - application/json: - schema: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/QueryRequest' - responses: - '200': - description: |- - The response object has a status section that must be checked for every request. - Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. - content: - application/json: - schema: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/QueryResponse' - security: - - Write: [] - - /pools/default: - post: - operationId: setFtsMemoryQuota - summary: Set Search Memory Quota - description: Sets the memory quota for the Search Service. - tags: - - Quota - requestBody: - required: true - content: - application/x-www-form-urlencoded: - schema: - type: object - properties: - ftsMemoryQuota: - type: integer - description: The memory quota for the Search service. - example: 512 - x-has-example: true - responses: - '200': - description: Memory quota set. - security: - - Manage: [] - -components: - schemas: - indexPartition: - type: object - title: Index Partitions - properties: - pindexes: - $ref: '#/components/schemas/indexPartitionPIndex' - status: - description: The status of the request. - type: string - - indexPartitionPIndex: - type: object - title: Index Partitions Wrapper - description: An object containing information about 1 or more Search index partitions. - additionalProperties: - x-additionalPropertiesName: Partition Name - $ref: '#/components/schemas/indexPartitionPIndexInner' - - indexPartitionPIndexInner: - type: object - title: Index Partition - description: |- - An object containing information about a single Search index partition. - The name of the property is the name of the Search index partition. - properties: - indexName: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexName' - indexParams: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexParams' - indexType: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexType' - indexUUID: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonIndexUUID' - name: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonPIndexName' - sourceName: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceName' - sourceParams: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceParams' - sourcePartitions: - type: string - sourceType: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceType' - sourceUUID: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonSourceUUID' - uuid: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/CommonPIndexUUID' - - securitySchemes: - Manage: - type: http - scheme: basic - description: |- - You must have the **Search Admin** role, with FTS Manage permissions on the required bucket. - - Read: - type: http - scheme: basic - description: |- - You must have the **Search Reader** or **Search Admin** role, with FTS Read permissions on the required bucket. - - Write: - type: http - scheme: basic - description: |- - You must have the **Search Admin** role, with FTS Write permissions on the required bucket. diff --git a/src/search-index/swagger/search-index.yaml b/src/search-index/swagger/search-index.yaml deleted file mode 100644 index 5b4a472a..00000000 --- a/src/search-index/swagger/search-index.yaml +++ /dev/null @@ -1,1299 +0,0 @@ -openapi: 3.0.3 -info: - title: Couchbase Search Index Management and Monitoring API - description: |- - The Search Indexing REST API is provided by the Search service. - This API enables you to manage and monitor your Search indexes. - version: '8.0' - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Search Service. - port: - default: "8094" - description: |- - The Search Service REST port. - Use `18094` for secure access. - enum: - - "8094" - - "18094" - -tags: - - name: Definitions - x-displayName: Search Index Definitions - description: Use the following APIs to retrieve Search index definitions, create new Search indexes, or delete an existing Search index. - - name: Management - x-displayName: Index Management - description: Use the following endpoints to manage index controls, such as document ingestion, partition assignment, and queries. - - name: Monitoring - x-displayName: Index Monitoring and Debugging - description: Use the following endpoints to get statistics about Search indexes for monitoring and debugging. - - name: Querying - x-displayName: Index Querying - description: Use the following endpoints to query the contents of a Search index. - -paths: - /api/index: - get: - operationId: g-api-index - summary: Get All Search Index Definitions - description: Returns all Search index definitions from the bucket where you have read permissions, as a JSON object. - tags: - - Definitions - responses: - '200': - description: A JSON object containing all Search index definitions. - content: - application/json: - schema: - $ref: '#/components/schemas/GetIndexesResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-index.json' - security: - - Read: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index: - get: - operationId: g-api-scoped-index - summary: Get All Search Index Definitions (Scoped) - description: Returns all Search index definitions inside the bucket and scope specified in the endpoint URL as a JSON object. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - responses: - '200': - description: A JSON object containing all Search index definitions. - content: - application/json: - schema: - $ref: '#/components/schemas/GetIndexesResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-scoped-indexes.json' - security: - - Read: [] - - /api/index/{INDEX_NAME}: - get: - operationId: g-api-index-name - summary: Get Index Definition - description: Returns the definition of the Search index specified in the endpoint URL as a JSON object. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathIndexFull" - responses: - '200': - description: A JSON object containing the Search index definition. - content: - application/json: - schema: - $ref: '#/components/schemas/GetIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-index-name.json' - security: - - Read: [] - - delete: - operationId: d-api-index-name - summary: Delete Index Definition - description: Deletes the Search index definition specified in the endpoint URL. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathIndexFull" - responses: - '200': - description: The Search Service returns a response that includes the status `ok`. - content: - application/json: - schema: - $ref: '#/components/schemas/DeleteIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-index-name-200.json' - default: - description: The Search Service returns a non-200 HTTP error code when a request fails. - content: - application/json: - schema: - type: object - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-index-name-default.json' - security: - - Write: [] - - put: - operationId: p-api-index-name - summary: Create or Update an Index Definition - description: |- - If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. - If the Search index already exists, this endpoint updates the Search index definition. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathIndexFull" - requestBody: - required: true - description: |- - The full Search index definition. - For a detailed list of all parameters for the request body, see [Search Index JSON Properties](../search/search-index-params.html). - content: - application/json: - schema: - $ref: '#/components/schemas/IndexDefinition' - responses: - '200': - description: A JSON object indicating the status of the operation. - content: - application/json: - schema: - $ref: '#/components/schemas/PutIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-200.json' - default: - description: The Search Service returns a non-200 HTTP error code when a request fails. - content: - application/json: - schema: - type: object - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-default.json' - security: - - Write: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}: - get: - operationId: g-api-scoped-index-name - summary: Get Index Definition (Scoped) - description: |- - Returns the Search index definition for the Search index specified in the endpoint URL as a JSON object. - Unlike [Get Index Definition](#g-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - responses: - '200': - description: A JSON object containing the Search index definition. - content: - application/json: - schema: - $ref: '#/components/schemas/GetIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/fts-sample-index-def-response.json' - security: - - Read: [] - - put: - operationId: p-api-scoped-index-name - summary: Create or Update an Index Definition (Scoped) - description: |- - If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. - If the Search index already exists, this endpoint updates the Search index definition. - Unlike [Create or Update an Index Definition](#p-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - requestBody: - required: true - description: |- - The full Search index definition. - For a detailed list of all parameters for the request body, see [Search Index JSON Properties](../search/search-index-params.html). - content: - application/json: - schema: - $ref: '#/components/schemas/IndexDefinition' - responses: - '200': - description: A JSON object indicating the status of the operation. - content: - application/json: - schema: - $ref: '#/components/schemas/PutIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-200.json' - default: - description: The Search Service returns a non-200 HTTP error code when a request fails. - content: - application/json: - schema: - type: object - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-scoped-index-name-default.json' - security: - - Write: [] - - delete: - operationId: d-api-scoped-index-name - summary: Delete Index Definition (Scoped) - description: |- - Delete the Search index definition from the bucket and scope specified in the endpoint URL. - Unlike [Delete Index Definition](#d-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Definitions - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - responses: - '200': - description: A JSON object indicating the status of the operation. - content: - application/json: - schema: - $ref: '#/components/schemas/DeleteIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-200.json' - default: - description: The Search Service returns a non-200 HTTP error code when a request fails. - content: - application/json: - schema: - type: object - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/d-api-scoped-index-name-default.json' - security: - - Write: [] - - /api/index/{INDEX_NAME}/ingestControl/{OP}: - post: - operationId: p-api-idx-name-ingestcontrol - summary: Set Index Ingestion Control - description: |- - For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. - While paused, the Search index does not load any new document mutations. - tags: - - Management - parameters: - - $ref: "#/components/parameters/PathIndexFull" - - $ref: "#/components/parameters/PathOpIngest" - responses: - '200': - $ref: "#/components/responses/OK" - security: - - Manage: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/ingestControl/{OP}: - post: - operationId: p-api-scoped-ingestcontrol - summary: Set Index Ingestion Control (Scoped) - description: |- - For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. - While paused, the Search index does not load any new document mutations. - Unlike [Set Index Ingestion Control](#p-api-idx-name-ingestcontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Management - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - - $ref: "#/components/parameters/PathOpIngest" - responses: - '200': - $ref: "#/components/responses/OK" - security: - - Manage: [] - - /api/index/{INDEX_NAME}/planFreezeControl/{OP}: - post: - operationId: p-api-idx-name-planfreezecontrol - summary: Freeze Index Partition Assignment - description: |- - For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. - While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. - tags: - - Management - parameters: - - $ref: "#/components/parameters/PathIndexFull" - - $ref: "#/components/parameters/PathOpPartition" - responses: - '200': - $ref: "#/components/responses/OK" - security: - - Manage: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/planFreezeControl/{OP}: - post: - operationId: p-api-scoped-planfreezecontrol - summary: Freeze Index Partition Assignment (Scoped) - description: |- - For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. - While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. - Unlike [Freeze Index Partition Assignment](#p-api-idx-name-planfreezecontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Management - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - - $ref: "#/components/parameters/PathOpPartition" - responses: - '200': - $ref: "#/components/responses/OK" - security: - - Manage: [] - - /api/index/{INDEX_NAME}/queryControl/{OP}: - post: - operationId: p-api-idx-name-querycontrol - summary: Stop Queries on an Index - description: |- - For the Search index specified in the endpoint URL, disallow or allow queries. - While queries are disallowed, users see an error that the Search index's partitions could not be reached. - tags: - - Management - parameters: - - $ref: "#/components/parameters/PathIndexFull" - - $ref: "#/components/parameters/PathOpQuery" - responses: - '200': - $ref: "#/components/responses/OK" - security: - - Manage: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/queryControl/{OP}: - post: - operationId: p-api-scoped-querycontrol - summary: Stop Queries on an Index (Scoped) - description: |- - For the Search index specified in the endpoint URL, disallow or allow queries. - While queries are disallowed, users see an error that the Search index's partitions could not be reached. - Unlike [Stop Queries on an Index](#p-api-idx-name-querycontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Management - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - - $ref: "#/components/parameters/PathOpQuery" - responses: - '200': - $ref: "#/components/responses/OK" - security: - - Manage: [] - - /api/stats: - get: - operationId: g-api-stats - summary: Get Indexing and Data Metrics for All Indexes - description: |- - Returns indexing and data-related metrics, timings, counters, and detailed partition information for all Search indexes, from the node running the Search Service. - - This endpoint returns statistics provided by the Search service. - For additional statistics, see [Get Query, Mutation, and Partition Statistics for the Search Service](../fts-rest-stats/index.html#g-api-nsstats). - tags: - - Monitoring - responses: - '200': - description: A JSON object containing indexing and data metrics. - content: - application/json: - schema: - $ref: '#/components/schemas/StatsNodeResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats.json' - security: - - Statistics: [] - - /api/stats/index/{INDEX_NAME}: - get: - operationId: g-api-stats-index-name - summary: Get Indexing and Data Metrics for an Index - description: |- - Returns indexing and data-related metrics, timings, counters, and detailed partition information for the Search index specified in the endpoint URL. - - This endpoint returns statistics provided by the Search service. - For additional statistics, see [Get Query, Mutation, and Partition Statistics for an Index](../fts-rest-stats/index.html#g-api-nsstats-index-name). - tags: - - Monitoring - parameters: - - $ref: "#/components/parameters/PathIndexFull" - responses: - '200': - description: A JSON object containing statistics for the specified Search index. - content: - application/json: - schema: - $ref: '#/components/schemas/StatsIndexResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats-index-name.json' - security: - - Statistics: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/status: - get: - operationId: g-api-scoped-status - summary: Get Index Status (Scoped) - description: | - Returns the status of the Search index specified in the endpoint URL, including whether all index partitions are created and ready to use. - tags: - - Monitoring - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - responses: - '200': - description: The Search Service returns a response that includes the status `ok`. - content: - application/json: - schema: - $ref: '#/components/schemas/StatusResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-scoped-status.json' - security: - - Read: [] - - /api/index/{INDEX_NAME}/analyzeDoc: - post: - operationId: g-api-stats-index-name-analyzeDoc - summary: Analyze Document - description: | - Use the Search index specified in the endpoint URL to analyze a document from the request body. - tags: - - Monitoring - parameters: - - $ref: "#/components/parameters/PathIndexFull" - requestBody: - required: true - description: Add any valid JSON document to the request body. - content: - application/json: - schema: - type: object - title: Request Body - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-body.json' - responses: - '200': - description: A JSON object containing the analysis of the provided document. - content: - application/json: - schema: - $ref: '#/components/schemas/DocumentAnalysis' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-stats-index-name-analyzeDoc-200.json' - security: - - Read: [] - - /api/index/{INDEX_NAME}/count: - get: - operationId: g-api-index-name-count - summary: Get Document Count for an Index - description: | - Returns the number of documents indexed in the specified Search index. - tags: - - Querying - parameters: - - $ref: "#/components/parameters/PathIndexFull" - responses: - '200': - description: The Search Service returns a response that includes the status `ok`. - content: - application/json: - schema: - $ref: '#/components/schemas/DocumentCount' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/g-api-index-name-count.json' - security: - - Statistics: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/pindexLookup: - post: - operationId: p-api-pindex-lookup - summary: Look Up the Index Partition for a Document (Scoped) - description: | - Send a document ID in the request body and return the Search index partition ID where the document is stored. - The endpoint returns a JSON object as a response. - tags: - - Querying - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - requestBody: - required: true - description: A valid JSON object that contains the docID property, with a value that matches the document ID for a document in the Search index. - content: - application/json: - schema: - $ref: '#/components/schemas/LookupRequest' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-body.json' - responses: - '200': - description: The Search Service returns a response that includes the status `ok`. - content: - application/json: - schema: - $ref: '#/components/schemas/LookupResponse' - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-pindex-lookup-200.json' - security: - - Manage: [] - - /api/index/{INDEX_NAME}/query: - post: - operationId: p-api-index-name-query - summary: Query a Search Index - description: | - Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. - The endpoint returns a JSON object as a response. - tags: - - Querying - parameters: - - $ref: "#/components/parameters/PathIndexFull" - requestBody: - required: true - description: |- - A JSON object to define the settings for your Search query. - For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). - content: - application/json: - schema: - $ref: '#/components/schemas/QueryRequest' - examples: - regular: - summary: Regular Query - value: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-query-regular.json' - options: - summary: Query with Options - value: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-query-options.json' - hybrid: - summary: Hybrid Query - value: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-index-name-query-hybrid.json' - responses: - '200': - description: |- - The response object has a status section that must be checked for every request. - Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. - content: - application/json: - schema: - $ref: '#/components/schemas/QueryResponse' - security: - - Manage: [] - - /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/query: - post: - operationId: p-api-scoped-query - summary: Query a Search Index (Scoped) - description: | - Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. - The endpoint returns a JSON object as a response. - Unlike [Query a Search Index](#p-api-index-name-query), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. - tags: - - Querying - parameters: - - $ref: "#/components/parameters/PathBucket" - - $ref: "#/components/parameters/PathScope" - - $ref: "#/components/parameters/PathIndex" - requestBody: - required: true - description: |- - A JSON object to define the settings for your Search query. - For more information about how to create a Search query JSON object, see [Search Request JSON Properties](../search/search-request-params.html). - content: - application/json: - schema: - $ref: '#/components/schemas/QueryRequest' - responses: - '200': - description: |- - The response object has a status section that must be checked for every request. - Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. - content: - application/json: - schema: - $ref: '#/components/schemas/QueryResponse' - examples: - regular: - summary: Success Response for a Regular Query - value: - $ref: '../../../docs/modules/fts-rest-indexing/examples/fts-sample-success-response.json' - hybrid: - summary: Success Response for a Hybrid Query - value: - $ref: '../../../docs/modules/fts-rest-indexing/examples/fts-sample-success-response-vector-search.json' - default: - description: The Search Service returns a non-200 HTTP error code when a request fails. - content: - application/json: - example: - $ref: '../../../docs/modules/fts-rest-indexing/examples/p-api-scoped-query-default.json' - security: - - Manage: [] - -components: - parameters: - PathBucket: - name: BUCKET_NAME - in: path - required: true - schema: - type: string - description: The name of the bucket containing the Search index definition. - - PathScope: - name: SCOPE_NAME - in: path - required: true - schema: - type: string - description: The name of the scope containing the Search index definition. - - PathIndex: - name: INDEX_NAME - in: path - required: true - schema: - type: string - pattern: '^[A-Za-z][0-9A-Za-z_\-]*$' - description: The name of the Search index definition. - - PathIndexFull: - name: INDEX_NAME - in: path - required: true - schema: - type: string - description: |- - The name of the Search index definition. - You must use the fully qualified name for the index, which includes the bucket and scope. - - To view the full, scoped name for an index for use with this endpoint: - - 1. Go to the **Search** tab in the Couchbase Server Web Console. - 2. Point to the **Index Name** for an index. - - PathOpIngest: - name: OP - in: path - required: true - schema: - type: string - enum: - - pause - - resume - description: |- - To pause ingestion and maintenance, set `{OP}` to `pause`. - To resume ingestion and maintenance on a paused index, set `{OP}` to `resume`. - - PathOpPartition: - name: OP - in: path - required: true - schema: - type: string - enum: - - freeze - - unfreeze - description: |- - To freeze partition assignment, set `{OP}` to `freeze`. - To unfreeze partition assignment on a frozen index, set `{OP}` to `unfreeze`. - - PathOpQuery: - name: OP - in: path - required: true - schema: - type: string - enum: - - allow - - disallow - description: |- - To allow queries against a Search index, set `{OP}` to `allow`. - To block queries against a Search index, set `{OP}` to `disallow`. - - responses: - OK: - description: The Search Service returns a response that includes the status `ok`. - content: - application/json: - schema: - $ref: "#/components/schemas/MgmtResponse" - example: - $ref: "../../../docs/modules/fts-rest-indexing/examples/response-200.json" - - schemas: - DeleteIndexResponse: - type: object - title: Delete Response - properties: - status: - $ref: "#/components/schemas/CommonStatus" - uuid: - $ref: "#/components/schemas/CommonIndexUUID" - - GetIndexesResponse: - type: object - title: Indexes Response - properties: - indexDefs: - $ref: '#/components/schemas/GetIndexesResponseIndexes' - status: - $ref: "#/components/schemas/CommonStatus" - - GetIndexesResponseIndexes: - title: Index Definitions - type: object - description: An object containing Search index definitions and related information. - properties: - implVersion: - type: string - indexDefs: - $ref: '#/components/schemas/GetIndexesResponseIndexesWrapper' - uuid: - type: string - - GetIndexesResponseIndexesWrapper: - title: Index Definitions Wrapper - type: object - description: An object containing 1 or more Search index definitions. - additionalProperties: - x-additionalPropertiesName: Index Name - $ref: '#/components/schemas/IndexDefinition' - - GetIndexResponse: - type: object - title: Index Response - properties: - indexDef: - $ref: '#/components/schemas/IndexDefinition' - planPIndexes: - type: array - description: An array of objects, each containing information about a single Search index partition. - items: - $ref: '#/components/schemas/GetIndexResponsePIndex' - status: - $ref: "#/components/schemas/CommonStatus" - warnings: - type: array - description: An array of warnings. - items: - type: string - - GetIndexResponsePIndex: - type: object - title: Plan Partition - description: An object containing information about a single Search index partition. - properties: - indexName: - $ref: '#/components/schemas/CommonIndexName' - indexParams: - $ref: '#/components/schemas/CommonIndexParams' - indexType: - $ref: '#/components/schemas/CommonIndexType' - indexUUID: - $ref: '#/components/schemas/CommonIndexUUID' - name: - $ref: '#/components/schemas/CommonPIndexName' - nodes: - $ref: '#/components/schemas/GetIndexResponsePIndexNodesWrapper' - sourceName: - $ref: '#/components/schemas/CommonSourceName' - sourceParams: - $ref: '#/components/schemas/CommonSourceParams' - sourcePartitions: - type: string - sourceType: - $ref: '#/components/schemas/CommonSourceType' - sourceUUID: - $ref: '#/components/schemas/CommonSourceUUID' - uuid: - $ref: '#/components/schemas/CommonPIndexUUID' - - GetIndexResponsePIndexNodesWrapper: - type: object - title: Partition Nodes Wrapper - description: An object containing information about 1 or more Search index partition nodes. - additionalProperties: - x-additionalPropertiesName: Node UUID - $ref: '#/components/schemas/GetIndexResponsePIndexNodesWrapperNode' - - GetIndexResponsePIndexNodesWrapperNode: - type: object - title: Partition Node - description: |- - An object containing information about a single Search index partition node. - The name of the property is the node UUID. - properties: - canRead: - type: boolean - canWrite: - type: boolean - priority: - type: integer - - StatsNodeResponse: - type: object - title: Node Statistics - properties: - feeds: - type: object - manager: - $ref: "#/components/schemas/StatsNodeResponseMgr" - pindexes: - type: object - - StatsNodeResponseMgr: - type: object - title: Manager Statistics - properties: - TotCreateIndex: - type: integer - TotDeleteIndex: - type: integer - TotUpdateIndex: - type: integer - TotBatchIntro: - type: integer - TotBatchIntroFail: - type: integer - TotBatchUpdate: - type: integer - TotBatchUpdateFail: - type: integer - TotBatchDelete: - type: integer - TotBatchDeleteFail: - type: integer - TotBatchGet: - type: integer - TotBleveDestStart: - type: integer - TotBleveDestStop: - type: integer - TotBleveDestRemove: - type: integer - TotBleveDestUpdate: - type: integer - TotBleveDestUpdateFail: - type: integer - TotBleveDestIntro: - type: integer - TotBleveDestIntroFail: - type: integer - TotBleveDestBatch: - type: integer - TotBleveDestBatchFail: - type: integer - TotBleveDestDelete: - type: integer - TotBleveDestDeleteFail: - type: integer - TotBleveDestClose: - type: integer - TotBleveDestCloseFail: - type: integer - TotQuery: - type: integer - TotQueryFail: - type: integer - - StatsIndexResponse: - type: object - title: Index Statistics - properties: - feeds: - type: object - pindexes: - type: object - - LookupRequest: - type: object - title: Lookup Request - properties: - docID: - type: string - description: The document ID to look up in the Search index. - - LookupResponse: - type: object - title: Lookup Response - properties: - status: - $ref: "#/components/schemas/CommonStatus" - pindexes: - $ref: "#/components/schemas/LookupResponsePartitions" - - LookupResponsePartitions: - type: object - title: Lookup Partition Wrapper - description: An object containing information about 1 or more Search index partitions. - additionalProperties: - x-additionalPropertiesName: Partition Name - $ref: "#/components/schemas/LookupResponsePartitionsID" - - LookupResponsePartitionsID: - type: object - title: Lookup Partition - description: |- - An object containing information about a single Search index partition. - The name of the property is the Search index partition name. - properties: - id: - type: string - description: The Search index partition ID. - - PutIndexResponse: - type: object - title: Create or Update Response - properties: - status: - $ref: "#/components/schemas/CommonStatus" - name: - $ref: "#/components/schemas/CommonIndexName" - uuid: - $ref: "#/components/schemas/CommonIndexUUID" - - DocumentAnalysis: - type: object - title: Document Analysis - properties: - status: - $ref: "#/components/schemas/CommonStatus" - analyzed: - type: array - description: An array of objects containing the analysis of the document. - items: - $ref: "#/components/schemas/DocumentAnalysisItem" - - DocumentAnalysisItem: - type: object - title: Analysis Item - description: An object containing 1 or more search terms or tokens from the analyzed document. - additionalProperties: - x-additionalPropertiesName: Search Token - $ref: "#/components/schemas/DocumentAnalysisItemToken" - - DocumentAnalysisItemToken: - type: object - title: Analysis Token - description: |- - An object containing the analysis of a single search term or token from the analyzed document. - The name of the property is the search term or token. - properties: - Term: - type: string - Locations: - type: array - description: An array of objects describing the locations of the search term or token in the document. - items: - $ref: "#/components/schemas/DocumentAnalysisItemTokenLocation" - - DocumentAnalysisItemTokenLocation: - type: object - title: Analysis Token Location - description: An object describing the location of a single instance of the search term or token in the analyzed document. - properties: - Field: - type: string - description: The field in the document where the token was found. - ArrayPositions: - type: array - items: {} - Start: - type: integer - description: The starting point of the token in the field. - End: - type: integer - description: The ending point of the token in the field. - Position: - type: integer - description: The position of the token in the field. - - DocumentCount: - type: object - title: Document Count - properties: - status: - $ref: "#/components/schemas/CommonStatus" - count: - type: integer - description: The document count for the specified index. - - IndexDefinition: - type: object - title: Index Definition - description: |- - The full Search index definition. - For a detailed list of all parameters, see [Search Index JSON Properties](../search/search-index-params.html). - properties: - name: - $ref: "#/components/schemas/CommonIndexName" - type: - $ref: "#/components/schemas/CommonIndexType" - sourceName: - $ref: '#/components/schemas/CommonSourceName' - sourceUUID: - $ref: '#/components/schemas/CommonSourceUUID' - sourceParams: - $ref: "#/components/schemas/CommonSourceParams" - sourceType: - $ref: '#/components/schemas/CommonSourceType' - params: - $ref: '#/components/schemas/CommonIndexParams' - planParams: - $ref: '#/components/schemas/IndexDefinitionPlanParams' - prevIndexUUID: - type: string - writeOnly: true - description: |- - The UUID of the previous index. - Intended for clients that want to check that they are not overwriting the Search index definition updates of concurrent clients. - uuid: - $ref: '#/components/schemas/CommonIndexUUID' - required: - - name - - type - - sourceName - - sourceType - - params - - planParams - - IndexDefinitionPlanParams: - title: Plan Parameters - type: object - description: |- - The Search index's partitioning and replication settings. - For more information, see [Plan Params Object](../search/search-index-params.html#planParams). - properties: - hierarchyRules: - type: string - nullable: true - maxPartitionsPerPIndex: - type: integer - description: |- - This setting is deprecated. - Use `indexPartitions` instead. - indexPartitions: - type: integer - description: The number of partitions to split the Search index into, across the nodes you have available in your database with the Search Service enabled. - nodePlanParams: - type: string - nullable: true - numReplicas: - type: integer - description: The number of replicas the Search Service creates for the Search index to ensure high availability. - planFrozen: - type: boolean - - QueryRequest: - type: object - title: Query Request - properties: - query: - type: object - description: |- - An object that contains the properties for one of the supported query types. - For more information, see [Query Object](../search/search-request-params.html#query-object). - knn: - type: array - description: |- - An array that contains objects that describe a Vector Search query. - For more information, see [Knn Objects](../search/search-request-params.html#knn-object). - items: - type: object - ctl: - type: object - description: |- - An object that contains properties for query consistency. - For more information, see [Ctl Object](../search/search-request-params.html#ctl). - size: - type: integer - description: Set the total number of results to return for a single page of search results. - from: - type: integer - description: Set an offset value to change where pagination starts for search results. - highlight: - type: object - description: |- - Contains properties to control search result highlighting. - For more information, see [Highlight Objects](../search/search-request-params.html#highlight). - fields: - type: array - description: An array of strings to specify each indexed field you want to return in search results. - items: - type: string - facets: - type: object - description: |- - Contains nested objects to define each facet you want to return with search results. - For more information, see [Facet Objects](../search/search-request-params.html#facet-name). - explain: - type: boolean - description: Whether to create an explanation for a search result's score in search results. - sort: - type: array - description: |- - Contains an array of strings or JSON objects to set how to sort search results. - For more information, see [Sort Object](../search/search-request-params.html#sort). - items: {} - includeLocations: - type: boolean - description: Whether to return the position of each occurrence of a search term inside a document. - score: - type: string - description: Whether to include document relevancy scoring in search results. - search_after: - type: array - description: Use to control pagination in search results. - items: - type: string - search_before: - type: array - description: Use to control pagination in search results. - items: - type: string - collections: - type: array - description: An array of strings that specify the collections where you want to run the query. - items: - type: string - - QueryResponse: - type: object - title: Query Response - properties: - status: - $ref: "#/components/schemas/CommonStatus" - results: - type: array - description: The results of the Search query. - items: - type: object - - MgmtResponse: - type: object - title: Management Response - properties: - status: - $ref: "#/components/schemas/CommonStatus" - - StatusResponse: - type: object - title: Status Response - properties: - status: - $ref: "#/components/schemas/CommonStatus" - indexStatus: - type: string - description: The status of the Search index. - - CommonStatus: - type: string - title: Status - description: The status of the operation. - - CommonIndexName: - type: string - title: Index Name - description: |- - The name of the Search index. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonIndexParams: - type: object - title: Index Parameters - description: |- - The Search index's type identifier, type mappings, and analyzers. - For more information, see [Params Object](../search/search-index-params.html#params). - - CommonIndexType: - type: string - title: Index Type - description: |- - The type of the Search index. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonIndexUUID: - type: string - title: Index UUID - description: |- - The UUID of the Search index. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonSourceName: - type: string - title: Source Name - description: |- - The name of the bucket where the Search index is stored. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonSourceParams: - type: object - title: Source Parameters - description: |- - Advanced settings for Search index behavior. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonSourceType: - type: string - title: Source Type - description: |- - The type of the bucket where the Search index is stored. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonSourceUUID: - type: string - title: Source UUID - description: |- - The UUID of the bucket where the Search index is stored. - For more information, see [Initial Settings](../search/search-index-params.html#initial). - - CommonPIndexName: - type: string - title: Partition Name - description: The name of the Search index partition. - - CommonPIndexUUID: - type: string - title: Partition UUID - description: The UUID of the Search index partition. - - securitySchemes: - Manage: - type: http - scheme: basic - description: |- - You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!manage` permissions on the required bucket. - - Statistics: - type: http - scheme: basic - description: |- - You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].stats!read` permissions on the required bucket. - - Read: - type: http - scheme: basic - description: |- - You must have the **Search Reader** or **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!read` permissions on the required bucket. - - Write: - type: http - scheme: basic - description: |- - You must have the **Search Admin** role, with `cluster.bucket[$BUCKET_NAME].fts!write` permissions on the required bucket. diff --git a/src/search-manage/swagger/search-manage.yaml b/src/search-manage/swagger/search-manage.yaml deleted file mode 100644 index 9a5255a9..00000000 --- a/src/search-manage/swagger/search-manage.yaml +++ /dev/null @@ -1,138 +0,0 @@ -openapi: 3.0.3 -info: - title: Search Manager Options REST API - version: '8.0' - description: |- - The Search Manager Options REST API is provided by the Search service. - This API enables you to set Search manager options; in particular, to configure rebalance based on file transfer. - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Search Service. - port: - default: "8094" - description: |- - The Search Service REST port. - Use `18094` for secure access. - enum: - - "8094" - - "18094" - -paths: - /api/managerOptions: - put: - operationId: put_options - summary: Modify Search Manager Options - description: |- - Sets Search manager options. - Note that only one setting is available: `disableFileTransferRebalance`. - requestBody: - description: An object specifying Search manager options. - content: - application/json: - schema: - $ref: "#/components/schemas/Options" - security: - - Default: [] - responses: - "200": - $ref: '#/components/responses/OK' - "401": - $ref: '#/components/responses/Unauthorized' - "404": - $ref: '#/components/responses/NotFound' - "405": - $ref: '#/components/responses/NotAllowed' - x-codeSamples: - - lang: curl - label: Disable - source: - $ref: '../../../docs/modules/fts-rest-manage/examples/file-xfer-disable.sh' - - lang: curl - label: Re-enable - source: - $ref: '../../../docs/modules/fts-rest-manage/examples/file-xfer-enable.sh' - -components: - schemas: - Options: - type: object - properties: - disableFileTransferRebalance: - type: boolean - description: |- - If the value is `false` (the default), new Search Service partitions are created during rebalance by means of partition file transfer. - - If the value is `true`, partitions are created by means of partition build, from scratch, over DCP connections from the Data Service. - default: false - x-has-default: true - - Response: - type: object - required: - - status - properties: - status: - type: string - description: > - The status of the operation. - error: - type: string - description: > - The error message, if the operation was not successful. - - responses: - OK: - description: The operation was successful. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - example: - $ref: "../../../docs/modules/fts-rest-manage/examples/file-xfer-200.json" - - NotFound: - description: > - Object not found. - The URL may be incorrectly specified. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - - NotAllowed: - description: > - Method not allowed. - The method may be incorrectly specified. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - example: - $ref: "../../../docs/modules/fts-rest-manage/examples/file-xfer-405.json" - - Unauthorized: - description: > - Failure to authenticate. - The user name or password may be incorrect. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - - securitySchemes: - Default: - type: http - scheme: basic diff --git a/src/search-nodes/swagger/search-nodes.yaml b/src/search-nodes/swagger/search-nodes.yaml deleted file mode 100644 index dc1468be..00000000 --- a/src/search-nodes/swagger/search-nodes.yaml +++ /dev/null @@ -1,495 +0,0 @@ -openapi: 3.0.3 -info: - title: Couchbase Search Node API - description: |- - The Search Node Configuration REST API is provided by the Search service. - This API enables you to manage and monitor your Search nodes. - version: '8.0' - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Search Service. - port: - default: "8094" - description: |- - The Search Service REST port. - Use `18094` for secure access. - enum: - - "8094" - - "18094" - -tags: - - name: configuration - x-displayName: Node Configuration - description: Operations for node configuration. - - name: diagnostics - x-displayName: Node Diagnostics - description: Operations for node diagnostics. - - name: management - x-displayName: Node Management - description: Operations for node management. - - name: monitoring - x-displayName: Node Monitoring - description: Operations for node monitoring. - -paths: - /api/cfg: - get: - operationId: getClusterConfig - summary: Get Cluster Configuration - description: Returns the node's current view of the cluster's configuration as JSON. - tags: - - configuration - responses: - '200': - description: A JSON object containing the node's configuration. - content: - application/json: - schema: - $ref: '#/components/schemas/clusterConfig' - example: - $ref: '../../../docs/modules/fts-rest-nodes/examples/get-cluster-config.json' - security: - - readClusterSettings: [] - - /api/cfgRefresh: - post: - operationId: refreshClusterConfig - summary: Refresh Node Configuration - description: Requests the node to refresh its configuration from the configuration provider. - tags: - - configuration - responses: - '200': - $ref: '#/components/responses/OK' - security: - - writeClusterSettings: [] - - /api/managerKick: - post: - operationId: managerKick - summary: Replan Resource Assignments - description: Forces the node to replan resource assignments, (by running the planner, if enabled) and update its runtime state to reflect the latest plan (by running the janitor, if enabled). - tags: - - configuration - responses: - '200': - $ref: '#/components/responses/OK' - security: - - writeClusterSettings: [] - - /api/managerMeta: - get: - operationId: managerMeta - summary: Get Node Capabilities - description: |- - Returns information on the node's capabilities, including available indexing and storage options as JSON. - This operation is intended to help management tools and web UIs to be more dynamically metadata driven. - tags: - - configuration - responses: - '200': - description: A JSON object containing the node's capabilities. - content: - application/json: - schema: - type: object - security: - - writeClusterSettings: [] - - /api/diag: - get: - operationId: getDiagnostics - summary: Get Diagnostics - description: |- - Returns the full set of diagnostic information from the node as JSON. - The response is the union of the responses from the node's other REST API diagnostic and monitoring endpoints. - - For example, for a 3 node cluster, you could capture diagnostics for each node with something like: - - ```shell - curl http://cbft-01:8094/api/diag > cbft-01.json - curl http://cbft-02:8094/api/diag > cbft-02.json - curl http://cbft-03:8094/api/diag > cbft-03.json - ``` - - The response JSON object can be quite large, 100s of KB or much more. - - The motivation for this operation is to simplify working with the Couchbase community, forums, technical support, and other engineers, by making data capture from each Search node a single step. - tags: - - diagnostics - responses: - '200': - description: A JSON object containing the node's diagnostics. - content: - application/json: - schema: - type: object - security: - - readClusterLogs: [] - - /api/log: - get: - operationId: getLogs - summary: Get Node Logs - description: Returns recent log messages and key events for the node as JSON. - tags: - - diagnostics - responses: - '200': - description: A JSON object containing the node's logs. - content: - application/json: - schema: - $ref: '#/components/schemas/logInfo' - example: - $ref: '../../../docs/modules/fts-rest-nodes/examples/get-logs.json' - security: - - readClusterLogs: [] - - /api/runtime: - get: - operationId: getRuntimeInfo - summary: Get Node Runtime Information - description: Returns information on the node's software, such as version strings and slow-changing runtime settings, as JSON. - tags: - - diagnostics - responses: - '200': - description: A JSON object containing the node's runtime information. - content: - application/json: - schema: - $ref: '#/components/schemas/runtimeInfo' - example: - $ref: '../../../docs/modules/fts-rest-nodes/examples/get-runtime-info.json' - security: - - readClusterSettings: [] - - /api/runtime/args: - get: - operationId: getRuntimeArgs - summary: Get Node Runtime Arguments - description: Returns information on the node's command-line, parameters, environment variables, and OS process values as JSON. - tags: - - diagnostics - responses: - '200': - description: A JSON object containing the node's runtime arguments. - content: - application/json: - schema: - type: object - security: - - readClusterSettings: [] - - /api/runtime/profile/cpu: - post: - operationId: captureCpuProfile - summary: Capture CPU Profiling Information - description: Requests the node to capture local CPU usage profiling information. - tags: - - diagnostics - responses: - '200': - $ref: '#/components/responses/OK' - security: - - manageCluster: [] - - /api/runtime/profile/memory: - post: - operationId: captureMemoryProfile - summary: Capture Memory Profiling Information - description: Requests the node to capture local memory usage profiling information. - tags: - - diagnostics - responses: - '200': - $ref: '#/components/responses/OK' - security: - - manageCluster: [] - - /api/runtime/gc: - post: - operationId: performGC - summary: Perform Garbage Collection - description: Requests the node to perform a garbage collection. - tags: - - management - responses: - '200': - $ref: '#/components/responses/OK' - security: - - manageCluster: [] - - /api/runtime/stats: - get: - operationId: getRuntimeStats - summary: Get Runtime Statistics - description: Returns information on the node's low-level runtime stats as JSON. - tags: - - monitoring - responses: - '200': - description: A JSON object containing the node's low-level runtime statistics. - content: - application/json: - schema: - type: object - security: - - manageCluster: [] - - /api/runtime/statsMem: - get: - operationId: getMemoryStats - summary: Get Memory Statistics - description: Returns information on the node's low-level garbage collection and memory-related runtime stats as JSON. - tags: - - monitoring - responses: - '200': - description: A JSON object containing the node's memory statistics. - content: - application/json: - schema: - type: object - security: - - manageCluster: [] - -components: - responses: - OK: - description: Success. - - schemas: - clusterConfig: - title: Cluster Configuration - type: object - properties: - indexDefs: - $ref: '#/components/schemas/clusterConfigIndexes' - indexDefsCAS: - type: integer - description: Search index definition concurrency (compare and swap) value. - indexDefsErr: - type: string - description: Search index definition error. - nullable: true - nodeDefsKnown: - $ref: '#/components/schemas/clusterConfigNodesKnown' - nodeDefsKnownCAS: - type: integer - description: Known node definition concurrency (compare and swap) value. - nodeDefsKnownErr: - type: string - description: Known node definition error. - nullable: true - nodeDefsWanted: - $ref: '#/components/schemas/clusterConfigNodesWanted' - nodeDefsWantedCAS: - type: integer - description: Wanted node definition concurrency (compare and swap) value. - nodeDefsWantedErr: - type: string - description: Wanted node definition error. - nullable: true - planPIndexes: - $ref: '#/components/schemas/clusterConfigPlan' - planPIndexesCAS: - type: integer - description: Search index partition concurrency (compare and swap) value. - planPIndexesErr: - type: string - description: Search index partition error. - nullable: true - status: - type: string - description: The status of the operation. - - clusterConfigIndexes: - title: Index Definitions - type: object - description: An object containing Search index definitions and related information. - properties: - implVersion: - type: string - indexDefs: - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/GetIndexesResponseIndexesWrapper' - - clusterConfigNodesKnown: - title: Known Nodes - type: object - description: An object containing known node definitions and related information. - properties: - implVersion: - type: string - nodeDefs: - $ref: '#/components/schemas/clusterConfigNodesWrapper' - uuid: - type: string - - clusterConfigNodesWanted: - title: Wanted Nodes - type: object - description: An object containing wanted node definitions and related information. - properties: - implVersion: - type: string - nodeDefs: - $ref: '#/components/schemas/clusterConfigNodesWrapper' - uuid: - type: string - - clusterConfigNodesWrapper: - title: Node Definitions Wrapper - type: object - description: An object containing the definitions of 1 or more nodes. - additionalProperties: - x-additionalPropertiesName: Node UUID - $ref: '#/components/schemas/clusterConfigNodesWrapperNode' - - clusterConfigNodesWrapperNode: - title: Node Definition - type: object - description: |- - An object containing the definition of a single node. - The name of the property is the UUID of the node. - properties: - container: - type: string - extras: - type: string - hostPort: - type: string - implVersion: - type: string - tags: - type: string - nullable: true - uuid: - type: string - weight: - type: integer - - clusterConfigPlan: - type: object - title: Plan Partitions - description: An object containing Search index partitions and related information. - properties: - implVersion: - type: string - planPIndexes: - $ref: '#/components/schemas/clusterConfigPlanWrapper' - uuid: - type: string - warnings: - $ref: '#/components/schemas/GetIndexResponsePlanWrng' - - clusterConfigPlanWrapper: - type: object - title: Plan Partitions Wrapper - description: An object containing information about 1 or more Search index partitions. - additionalProperties: - x-additionalPropertiesName: Partition Name - $ref: '../../search-index/swagger/search-index.yaml#/components/schemas/GetIndexResponsePIndex' - - GetIndexResponsePlanWrng: - type: object - title: Plan Warnings Wrapper - description: |- - An object containing 0, 1, or more nested objects, each containing warnings that apply to a Search index. - additionalProperties: - x-additionalPropertiesName: Index Name - $ref: '#/components/schemas/GetIndexResponsePlanWrngIndex' - - GetIndexResponsePlanWrngIndex: - type: array - title: Plan Warnings - description: |- - An array of warnings. - The name of the property is the name of the Search index. - items: - type: string - - runtimeInfo: - title: Runtime Information - type: object - properties: - arch: - type: string - description: The architecture of the node. - go: - $ref: '#/components/schemas/runtimeInfoGo' - numCPU: - type: integer - description: The number of CPUs on the node. - os: - type: string - description: The operating system of the node. - versionData: - type: string - versionMain: - type: string - - runtimeInfoGo: - type: object - title: Go Runtime Information - properties: - GOMAXPROCS: - type: integer - GOROOT: - type: string - compiler: - type: string - version: - type: string - - logInfo: - type: object - title: Log Messages - properties: - events: - type: array - items: - type: object - messages: - type: array - items: - type: object - - securitySchemes: - manageCluster: - type: http - scheme: basic - description: |- - You must have the **Full Admin** or **Cluster Admin** role, with permissions to manage the cluster. - - readClusterSettings: - type: http - scheme: basic - description: |- - You must have the **Full Admin** or **Cluster Admin** role, with permission to read cluster settings. - - readClusterLogs: - type: http - scheme: basic - description: |- - You must have the **Full Admin** or **Cluster Admin** role, with permission to read cluster logs. - - writeClusterSettings: - type: http - scheme: basic - description: |- - You must have the **Full Admin** or **Cluster Admin** role, with permission to write cluster settings. diff --git a/src/search-query/swagger/search-query.yaml b/src/search-query/swagger/search-query.yaml deleted file mode 100644 index 89fce693..00000000 --- a/src/search-query/swagger/search-query.yaml +++ /dev/null @@ -1,280 +0,0 @@ -openapi: 3.0.3 -info: - title: Couchbase Search Active Queries REST API - description: |- - The Search Active Queries REST API is provided by the Search service. - This API enables you to get information about active Search queries. - version: '8.0' - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Search Service. - port: - default: "8094" - description: |- - The Search Service REST port. - Use `18094` for secure access. - enum: - - "8094" - - "18094" - -paths: - /api/query/index/{indexName}: - get: - operationId: api-query-index - summary: View Active Index Queries - description: |- - Gets the details of all the active queries for any given Search index in the system. - parameters: - - $ref: '#/components/parameters/pathIndexName' - - $ref: '#/components/parameters/queryLongerThan' - x-codeSamples: - - lang: curl - label: Request 1 - source: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-index.sh' - security: - - Default: [] - responses: - "200": - description: A list of active queries for the specified Search index. - content: - application/json: - schema: - $ref: '#/components/schemas/ActiveResponse' - example: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-index.json' - - /api/query: - get: - operationId: api-query - summary: View Active Node Queries - description: Gets the details of all the active queries in any Search node in a cluster. - parameters: - - $ref: '#/components/parameters/queryLongerThan' - x-codeSamples: - - lang: curl - label: Request 2 - source: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-all.sh' - - lang: curl - label: Request 3 - source: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-filter.sh' - security: - - Default: [] - responses: - "200": - description: A list of all active Search queries across all nodes in the cluster. - content: - application/json: - schema: - $ref: '#/components/schemas/ActiveResponse' - examples: - request2: - summary: Result of request 2 - value: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-all.json' - request3: - summary: Result of request 3 - value: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-filter.json' - - /api/query/{queryID}/cancel: - post: - operationId: api-query-cancel - summary: Cancel Active Queries - description: |- - Allows the user to cancel an active query that's running longer than expected. - Use the View Active Index Queries API or the View Active Node Queries API to get the parameters `queryID` and `uuid`, which are used to identify and cancel the query. - parameters: - - $ref: '#/components/parameters/pathQueryId' - requestBody: - description: |- - The body contains the UUID of the node where the query is running. - This is optional and allows cancellation of queries on specific nodes. - required: false - content: - application/json: - schema: - $ref: '#/components/schemas/CancelRequest' - example: - uuid: "b91d75480470f979f65f04e8f20a1f7b" - x-codeSamples: - - lang: curl - label: Request 4 - source: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-cancel.sh' - security: - - Default: [] - responses: - "200": - description: The query was successfully canceled. - content: - application/json: - schema: - $ref: '#/components/schemas/CancelResponse' - example: - $ref: '../../../docs/modules/fts-rest-query/examples/api-query-cancel.json' - -components: - parameters: - pathIndexName: - name: indexName - in: path - required: true - description: The name of the Search index. - schema: - type: string - pathQueryId: - name: queryID - in: path - required: true - description: |- - The ID of the active query. - This ID is used to identify the query that you want to cancel. - schema: - type: integer - queryLongerThan: - name: longerThan - in: query - required: false - description: |- - Filters the queries running beyond the given span of time. - - The duration string is a signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as `20s`, `-1.5h` or `2h45m`. - Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. - schema: - type: string - format: duration - - schemas: - ActiveResponse: - type: object - title: Active Response - properties: - status: - type: string - description: The status of the request. - stats: - $ref: '#/components/schemas/ActiveResponseStats' - totalActiveQueryCount: - type: integer - description: The total number of active queries. - filteredActiveQueries: - $ref: '#/components/schemas/ActiveResponseFilter' - ActiveResponseStats: - type: object - title: Stats - description: An object containing request statistics. - properties: - total: - type: integer - example: 3 - x-has-example: true - successful: - type: integer - example: 3 - x-has-example: true - ActiveResponseFilter: - type: object - title: Filtered Active Queries - description: An object containing details of the filtered active queries. - properties: - indexName: - type: string - description: |- - The name of the Search index. - Only included if viewing active queries for a specific index. - longerThan: - type: string - format: duration - description: |- - The duration used to filter the active queries. - Only included if the `longerThan` query parameter is used. - queryCount: - type: integer - description: The number of filtered active queries. - queryMap: - $ref: '#/components/schemas/ActiveResponseFilterMap' - ActiveResponseFilterMap: - type: object - title: Query Map - description: Contains 1 or more nested objects, each containing the details of a single active query. - additionalProperties: - x-additionalPropertiesName: Node UUID - Query ID - $ref: '#/components/schemas/ActiveResponseFilterMapItem' - ActiveResponseFilterMapItem: - type: object - title: Query Map Item - description: |- - The details of a single active query. - The name of the property is the UUID of the node on which the query is running, and the ID of the query on that node, separated by a hyphen. - properties: - QueryContext: - $ref: '#/components/schemas/ActiveResponseFilterMapItemContext' - executionTime: - type: string - format: duration - description: The time taken to execute the query. - ActiveResponseFilterMapItemContext: - type: object - title: Query Context - description: The query context. - properties: - query: - type: object - description: |- - An object containing the Search query. - For more information, see [Search Request JSON Properties](../search/search-request-params.html). - size: - type: integer - example: 10 - x-has-example: true - from: - type: integer - example: 0 - x-has-example: true - timeout: - type: integer - example: 120000 - x-has-example: true - index: - type: string - description: The name of a Search index. - CancelRequest: - type: object - title: Cancellation Request - properties: - uuid: - type: string - description: |- - Represents the active query's coordinator node's UUID, where the query will be canceled. - This parameter allows the user to cancel a query anywhere in the system by specifying its coordinator node's UUID. - CancelResponse: - type: object - title: Cancellation Response - properties: - status: - type: string - description: The status of the request. - msg: - type: string - description: The response message, giving details of the node UUID and query ID. - - securitySchemes: - Default: - type: http - scheme: basic \ No newline at end of file diff --git a/src/search-stats/swagger/search-stats.yaml b/src/search-stats/swagger/search-stats.yaml deleted file mode 100644 index 2312ac67..00000000 --- a/src/search-stats/swagger/search-stats.yaml +++ /dev/null @@ -1,780 +0,0 @@ -openapi: 3.0.3 -info: - title: Couchbase Search Statistics API - description: |- - The Search Statistics REST API is provided by the Search service. - This API enables you to get statistics for the Search Service and your Search indexes. - version: '8.0' - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Search Service. - port: - default: "8094" - description: |- - The Search Service REST port. - Use `18094` for secure access. - enum: - - "8094" - - "18094" - -paths: - /api/nsstats: - get: - summary: Get Query, Mutation, and Partition Statistics for the Search Service - description: |- - Gets query, mutation, document, partition, and compaction statistics for the Search Service and any Search indexes. - - This endpoint returns statistics provided by the Cluster Manager. - For additional statistics, including detailed partition information, see [Get Indexing and Data Metrics for All Indexes](../fts-rest-indexing/index.html#g-api-stats). - operationId: g-api-nsstats - responses: - '200': - description: |- - The Search Service returns statistics from the `nsstats` endpoint for the entire cluster, and for each Search index. - - For each Search index, the names of the statistics are prefixed with the bucket name and index name, in the form `BUCKET:INDEX:statistic_name`. - content: - application/json: - schema: - $ref: '#/components/schemas/allStats' - example: - $ref: '../../../docs/modules/fts-rest-stats/examples/g-api-nsstats-200.json' - '400': - description: |- - Object not found. - The URI may be malformed. - '401': - description: |- - Unauthorized. - Failure to authenticate. - '403': - description: |- - Forbidden. - The user authenticates but does not have the appropriate permissions. - content: - application/json: - example: - $ref: '../../../docs/modules/fts-rest-stats/examples/g-api-nsstats-403.json' - security: - - Admin: [] - - /api/nsstats/index/{INDEX_NAME}: - get: - operationId: g-api-nsstats-index-name - summary: Get Query, Mutation, and Partition Statistics for an Index - description: |- - Gets query, mutation, document, partition, and compaction statistics for the Search index specified in the endpoint URL. - - This endpoint returns statistics provided by the Cluster Manager. - For additional statistics, including detailed partition information, see [Get Indexing and Data Metrics for an Index](../fts-rest-indexing/index.html#g-api-stats-index-name). - parameters: - - name: INDEX_NAME - in: path - required: true - schema: - type: string - description: |- - The name of the Search index definition. - You must use the fully qualified name for the index, which includes the bucket and scope. - - To view the full, scoped name for an index for use with this endpoint: - - 1. Go to the **Search** tab in the Couchbase Server Web Console. - 2. Point to the **Index Name** for an index. - responses: - '200': - description: |- - The Search Service returns statistics from the `nsstats` endpoint for the specified index. - - Note that for a single index, the names of the statistics are not prefixed with the bucket name or index name. - content: - application/json: - schema: - $ref: '#/components/schemas/indexStats' - example: - $ref: '../../../docs/modules/fts-rest-stats/examples/g-api-nsstats-index-name.json' - security: - - Statistics: [] - -components: - schemas: - allStats: - title: Service Statistics - allOf: - - $ref: '#/components/schemas/clusterStats' - - $ref: '#/components/schemas/indexStats' - - clusterStats: - type: object - title: Cluster Statistics - description: Statistics for the entire cluster. - properties: - avg_queries_latency: - type: number - description: The average latency of all Search queries run on the cluster, in milliseconds. - batch_bytes_added: - type: integer - description: |- - The total number of bytes in batches that have not yet been added to the Search index. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - batch_bytes_removed: - type: integer - description: |- - The total number of bytes in batches that have been added to the Search index. - - Use together with `batch_bytes_added` to understand when indexing operations complete. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - curr_batches_blocked_by_herder: - type: integer - description: |- - The difference between the number of batches that have been indexed (`batch_bytes_removed`) and batches that have not yet been indexed (`batch_bytes_added`). - - The Search Service blocks batch indexing until there is sufficient memory available on a node. - - This statistic appears on the Server Web Console dashboard as **DCP Batches Blocked**. - num_batches_introduced: - type: integer - description: |- - The total number of batches introduced as part of indexing operations. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - num_bytes_ram_quota: - type: integer - description: |- - The total number of bytes set as the maximum usable memory for the Search Service on the cluster. - - This statistic appears on the Server Web Console dashboard as **RAM Quota for Search**. - num_bytes_used_disk: - type: integer - description: The total number of bytes used on disk by Search indexes in the cluster. - num_bytes_used_ram: - type: integer - description: |- - The number of bytes used in memory by the Search Service. - - This statistic appears on the Server Web Console dashboard as **RAM Used by Search**. - num_bytes_used_ram_c: - type: integer - description: |- - The number of bytes used in memory by the Search Service's C language processes. - - This amount is included as part of the total number of bytes used in memory, given by the `num_bytes_used_ram` statistic. - num_files_on_disk: - type: integer - description: The total number of files on disk for all Search indexes. - num_gocbcore_dcp_agents: - type: integer - description: |- - The total number of Go SDK DCP agents used by the Search Service to establish DCP communication with the Data Service. - - The number of Go SDK DCP agents should be less than or equal to the number of Search index partitions on a node. - num_gocbcore_stats_agents: - type: integer - description: |- - The total number of Go SDK agent pairs, used to retrieve statistics from the Data Service, that are present on a node. - - Typically, the Search Service uses one agent pair for each bucket on a node. - num_knn_search_requests: - type: integer - description: The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector-search/vector-search.html) requests made across all Search indexes in the cluster. - pct_cpu_gc: - type: number - description: |- - The percentage of CPU time spent by a Search index in garbage collection. - Garbage collection involves cleanup actions like removing unnecessary index entries. - pct_used_ram: - type: number - description: |- - The percentage of the available RAM quota used by the Search Service. - - This statistic appears on the Server Web Console dashboard as **Pct RAM Used by Search**. - tot_batches_flushed_on_maxops: - type: integer - description: |- - The total number of batches executed due to the batch size being greater than the maximum number of operations per batch. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - A batch is executed when it's flushed to disk. - tot_batches_flushed_on_timer: - type: integer - description: The total number of batches executed at regular intervals. - tot_batches_merged: - type: integer - description: |- - The number of batches that have been merged together before being sent to the disk write queue. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - A batch is executed when it's flushed to disk. - tot_batches_new: - type: integer - description: |- - The number of new batches that have been freshly introduced into the system. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - tot_bleve_dest_closed: - type: integer - description: The total number of times a Search index partition closed to new Search requests. - tot_bleve_dest_opened: - type: integer - description: |- - The total number of times Search index partitions were created or reopened for new Search requests, or for ingesting data coming in from DCP. - - Opening a Search index partition creates a file lock for concurrent access requests. - tot_grpc_listeners_closed: - type: integer - description: |- - The total number of gRPC listeners closed. - - gRPC listeners handle incoming connection requests to the Search Service. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - tot_grpc_listeners_opened: - type: integer - description: |- - The total number of gRPC listeners opened. - - gRPC listeners handle incoming connection requests to the Search Service. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - tot_grpc_queryreject_on_memquota: - type: integer - description: |- - The total number of gRPC queries rejected because of the available memory quota for the Search Service being less than the estimated memory required for merging search results from all partitions. - - For more information about how to set the Search Service's quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - tot_grpcs_listeners_closed: - type: integer - description: |- - The total number of gRPC SSL listeners closed. - - gRPC SSL listeners handle incoming SSL connection requests to the Search Service. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - tot_grpcs_listeners_opened: - type: integer - description: |- - The total number of gRPC SSL listeners opened. - - gRPC SSL listeners handle incoming SSL connection requests to the Search Service. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - tot_http_limitlisteners_closed: - type: integer - description: |- - The total number of HTTP limit listeners closed. - - HTTP limit listeners manage limits on incoming HTTP requests to the Search Service. - tot_http_limitlisteners_opened: - type: integer - description: |- - The total number of HTTP limit listeners opened. - - HTTP limit listeners manage limits on incoming HTTP requests to the Search Service. - tot_https_limitlisteners_closed: - type: integer - description: |- - The total number of HTTPS limit listeners closed. - - HTTPS limit listeners manage limits on incoming HTTPS requests to the Search Service. - tot_https_limitlisteners_opened: - type: integer - description: |- - The total number of HTTPS limit listeners opened. - - HTTPS limit listeners manage limits on incoming HTTPS requests to the Search Service. - tot_queryreject_on_memquota: - type: integer - description: |- - The total number of Search queries rejected because of the available memory quota for the Search Service being less than the estimated memory required for merging search results from all partitions. - - For more information about how to set the Search Service's quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). - tot_remote_grpc: - type: integer - description: |- - The total number of remote gRPC requests made to the Search Service. - - A request is remote if it comes from a different node in the cluster. - tot_remote_grpc_ssl: - type: integer - description: |- - The total number of gRPC scatter-gather requests made to the Search Service over SSL. - - A request is remote if it comes from a different node in the cluster. - tot_remote_grpc_tls: - type: integer - description: This metric is deprecated. - tot_remote_http: - type: integer - description: |- - The total number of remote HTTP requests made to the Search Service. - - A request is remote if it comes from a different node in the cluster. - - Remote HTTP requests are deprecated. - Use gRPC requests, instead. - tot_remote_http2: - type: integer - description: |- - The total number of remote HTTPS requests made to the Search Service. - - A request is remote if it comes from a different node in the cluster. - - Remote HTTP requests are deprecated. - Use gRPC requests, instead. - tot_remote_http_ssl: - type: integer - description: |- - The total number of remote HTTP SSL requests made to the Search Service. - - A request is remote if it comes from a different node in the cluster. - - Remote HTTP requests are deprecated. - Use gRPC requests, instead. - tot_rollback_full: - type: integer - description: |- - The total number of full rollbacks that occurred on a Search index partition. - - The Search Service only maintains a small number of index snapshots at one time. - - If the Search Service loses connection to the Data Service, the Search Service compares rollback sequence numbers when the connection is re-established. - If the Search Service's index snapshots are too far ahead of the Data Service's rollback sequence number, the Search Service performs a full rollback operation on documents in the index. - tot_rollback_partial: - type: integer - description: |- - The total number of partial rollbacks that occurred on a Search index partition. - - The Search Service only maintains a small number of index snapshots at one time. - - If the Search Service loses connection to the Data Service, the Search Service compares rollback sequence numbers when the connection is re-established. - If the Search Service's index snapshots are too far ahead of the Data Service's rollback sequence number, the Search Service performs a partial rollback operation on documents in the index. - total_bytes_query_results: - type: integer - description: |- - The size of all results returned for Search queries. - This includes the size of all JSON sent. - total_create_index_bad_request_error: - type: integer - description: The total number of bad request errors returned for requests to create new Search indexes on the cluster. - total_create_index_internal_server_error: - type: integer - description: The total number of internal server errors returned for requests to create new Search indexes on the cluster. - total_create_index_request: - type: integer - description: The total number of requests received by the Search Service for creating new Search indexes. - total_create_index_request_ok: - type: integer - description: The total number of requests received by the Search Service for creating new Search indexes that were successful. - total_delete_index_bad_request_error: - type: integer - description: The total number of bad request errors returned for requests to delete Search indexes on the cluster. - total_delete_index_internal_server_error: - type: integer - description: The total number of internal server errors returned for requests to delete Search indexes on the cluster. - total_delete_index_request: - type: integer - description: The total number of requests received by the Search Service to delete Search indexes. - total_delete_index_request_ok: - type: integer - description: The total number of requests received by the Search Service to delete Search indexes that were successful. - total_gc: - type: integer - description: |- - The total number of garbage collection events triggered by the Search Service. - - Garbage collection events include removing unnecessary index entries. - total_internal_queries: - type: integer - description: |- - The number of internal queries from the coordinating node for a Search query to other nodes running the Search Service. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. - The coordinating node applies filters to the results from all Search index partitions and returns the final result set. - total_queries: - type: integer - description: The total number of Search queries per second across all Search indexes in the cluster. - total_queries_bad_request_error: - type: integer - description: The total number of bad request errors returned for Search queries on the cluster. - total_queries_consistency_error: - type: integer - description: |- - The total number of Search queries that encountered consistency errors on the cluster. - - For more information about consistency in Search queries, see [Search Request JSON Properties](https://docs.couchbase.com/server/8.0/search/search-request-params.html#ctl). - total_queries_error: - type: integer - description: The total number of Search queries that encountered an error on the cluster. - total_queries_max_result_window_exceeded_error: - type: integer - description: The total number of Search queries that exceeded the [bleveMaxResultWindow](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-bleveMaxResultWindow.html) setting. - total_queries_partial_results_error: - type: integer - description: |- - The total number of Search queries that could only return partial results. - - A Search query can return partial results if it times out before all partitions can respond. - total_queries_rejected_by_herder: - type: integer - description: |- - The total number of queries rejected by the Search Service when the memory used approaches or exceeds the quota set for a query. - - For more information about how to set the Search Service's memory quota, see [ftsMemoryQuota](https://docs.couchbase.com/server/8.0/fts/fts-advanced-settings-ftsMemoryQuota.html). - - This statistic appears on the Server Web Console dashboard as **Rejected Queries**. - total_queries_search_in_context_error: - type: integer - description: |- - The total number of Search queries that returned an error when running through the `SearchInContext` API. - - These errors are typically internal server errors. - total_queries_slow: - type: integer - description: |- - The total number of Search queries that were added to the slow query log. - total_queries_timeout: - type: integer - description: |- - The total number of Search queries that timed out. - - You can set the timeout for a query with the [ctl object](https://docs.couchbase.com/server/8.0/search/search-request-params.html#ctl). - total_queries_validation_error: - type: integer - description: |- - The total number of queries that encountered a validation error, when the query request included a `validate` property in the `ctl` object. - - For more information, see the [validate property](https://docs.couchbase.com/server/8.0/search/search-request-params.html#validate). - total_request_time: - type: integer - description: |- - The total time, in nanoseconds, spent processing Search queries across the cluster. - - indexStats: - type: object - title: Index Statistics - description: Statistics for a single Search index. - # patternProperties: - # '(.*:.*:)?avg_grpc_internal_queries_latency': - properties: - BUCKET:INDEX:avg_grpc_internal_queries_latency: - type: integer - description: |- - The average time taken for a Search query's scatter-gather requests between the coordinator and other nodes running the Search Service. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - The coordinator is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. - BUCKET:INDEX:avg_grpc_queries_latency: - type: integer - description: |- - The average time taken for each Search query that uses gRPC, in milliseconds for the given Search index. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - BUCKET:INDEX:avg_internal_queries_latency: - type: integer - description: The average latency, in milliseconds, for inter-node queries for the given Search index. - BUCKET:INDEX:avg_queries_latency: - type: integer - description: |- - The average latency, in milliseconds, for all Search queries on the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Query Latency**. - BUCKET:INDEX:doc_count: - type: integer - description: |- - The total number of documents in the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Docs**. - BUCKET:INDEX:last_access_time: - type: string - format: date-time - description: The last date and time that a query ran against the given Search index. - BUCKET:INDEX:num_bytes_read_at_query_time: - type: integer - description: |- - The total number of bytes read by all queries against the given Search index. - BUCKET:INDEX:num_bytes_used_disk: - type: integer - description: |- - The total number of bytes used on disk by the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Disk Size**. - BUCKET:INDEX:num_bytes_used_disk_by_root: - type: integer - description: |- - The total number of bytes used on disk by the root segment of the given Search index. - - The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. - Segments are stale when they're replaced by a new merged segment created by the merger. - Stale segments are deleted when they're not used by any new queries. - - The `num_bytes_used_disk_by_root` value will be less than the `num_bytes_used_disk` value. - BUCKET:INDEX:num_bytes_used_disk_by_root_reclaimable: - type: integer - description: |- - The total number of bytes used on disk by the latest root index segment snapshot, which can potentially be reclaimed by a file merge operation. - - The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. - Segments are stale when they're replaced by a new merged segment created by the merger. - Stale segments are deleted when they're not used by any new queries. - BUCKET:INDEX:num_bytes_written_at_index_time: - type: integer - description: |- - The total cumulative number of bytes written to disk as part of introducing segments, or files. - - BUCKET:INDEX:num_file_merge_ops: - type: integer - description: |- - The number of merge operations completed by the merger routine, over persisted files. - - Each Search index partition has a merger and a persister. - - The persister reads in-memory segments from the disk write queue and flushes them to disk. - The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. - The persister and merger interact to continuously flush and merge new in-memory segments to disk. - BUCKET:INDEX:num_files_on_disk: - type: integer - description: |- - The total number of files on disk for the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Disk Files**. - BUCKET:INDEX:num_mem_merge_ops: - type: integer - description: |- - The number of merge operations completed by the merger routine, over in-memory segments. - - Each Search index partition has a merger and a persister. - - The persister reads in-memory segments from the disk write queue and flushes them to disk. - The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. - The persister and merger interact to continuously flush and merge new in-memory segments to disk. - BUCKET:INDEX:num_mutations_to_index: - type: integer - description: |- - The DCP sequence numbers of changes that have not yet been indexed for the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Mutations Remaining**. - BUCKET:INDEX:num_persister_nap_merger_break: - type: integer - description: |- - The number of times the persister was interrupted by the merger during a nap period. - - Each Search index partition has a merger and a persister. - - The persister reads in-memory segments from the disk write queue and flushes them to disk. - The merger consolidates flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. - The persister and merger interact to continuously flush and merge new in-memory segments to disk. - BUCKET:INDEX:num_persister_nap_pause_completed: - type: integer - description: |- - The number of times the persister completed its configured nap period before flushing content to disk, without being interrupted by the merger. - - Each Search index partition has a merger and a persister. - - The persister reads in-memory segments from the disk write queue and flushes them to disk. - The merger consolidates the flushed files from the persister and flushes the consolidated result to disk through the persister, while purging the smaller, older files. - The persister and merger interact to continuously flush and merge new in-memory segments to disk. - BUCKET:INDEX:num_pindexes_actual: - type: integer - description: |- - The total number of partitions currently in the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Partitions**. - BUCKET:INDEX:num_pindexes_target: - type: integer - description: |- - The total number of planned or expected partitions for the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Partitions Expected**. - BUCKET:INDEX:num_recs_to_persist: - type: integer - description: |- - The total number of entries, including terms, records, and dictionary rows, that have not yet been persisted to disk. - - This statistic appears on the Server Web Console dashboard as **Search Records to Persist**. - BUCKET:INDEX:num_root_filesegments: - type: integer - description: |- - The total number of file segments in the root segment. - - The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. - - This statistic appears on the Server Web Console dashboard as **Search Disk Segments**. - BUCKET:INDEX:num_root_memorysegments: - type: integer - description: |- - The total number of memory segments in the root segment. - - The root segment includes all data for the Search index, excluding any segments that might be stale and will be removed by the persister or merger. - - This statistic appears on the Server Web Console dashboard as **Search Memory Segments**. - BUCKET:INDEX:timer_batch_store_count: - type: integer - description: |- - The total number of times batches were executed against the given Search index. - - Batches are a data structure in the Search Service, used for processing data coming in from DCP and the Data Service to the documents in a Search index. - A batch is executed when it's flushed to disk. - BUCKET:INDEX:timer_data_delete_count: - type: integer - description: The total number of delete operations received from DCP for the given Search index. - BUCKET:INDEX:timer_data_update_count: - type: integer - description: The total number of create or update operations received from DCP for the given Search index. - BUCKET:INDEX:timer_opaque_get_count: - type: integer - description: |- - The total number of times the DCP consumer had to retrieve stored metadata to aid in reconnection for the given Search index. - - If the DCP connection closes, the Search Service can use this stored metadata to resume from the last stable point. - BUCKET:INDEX:timer_opaque_set_count: - type: integer - description: The total number of times the DCP consumer updated stored metadata, based on changes to Snapshot markers or the failover log, for the given Search index. - BUCKET:INDEX:timer_rollback_count: - type: integer - description: The total number of DCP Rollback messages received for the given Search index. - BUCKET:INDEX:timer_snapshot_start_count: - type: integer - description: |- - The total number of DCP Snapshot markers received for the given Search index. - - Snapshots contain a representation of document mutations on either a write queue or in storage. - BUCKET:INDEX:tot_seq_received: - type: integer - description: |- - This metric is no longer used and will soon be deprecated. - BUCKET:INDEX:total_bytes_indexed: - type: integer - description: |- - The rate, in bytes per second, of content indexed in the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Index Rate**. - BUCKET:INDEX:total_bytes_query_results: - type: integer - description: |- - The size of results returned for Search queries on the given Search index. - This includes the size of all JSON sent. - - This statistic appears on the Server Web Console dashboard as **Search Result Rate**. - BUCKET:INDEX:total_compaction_written_bytes: - type: integer - description: |- - The total number of bytes written to disk as a result of compaction operations on the given Search index. - - This statistic appears on the Server Web Console dashboard as **Search Compaction Rate**. - BUCKET:INDEX:total_grpc_internal_queries: - type: integer - description: |- - The total number of internal gRPC requests from the coordinating node for a Search query to other nodes running the Search Service, for the given Search index. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. - The coordinating node applies filters to the results from all Search index partitions and returns the final result set. - BUCKET:INDEX:total_grpc_queries: - type: integer - description: The total number of queries, using gRPC for streaming, for the given Search index. - BUCKET:INDEX:total_grpc_queries_error: - type: integer - description: The total number of queries that resulted in an error that used gRPC for streaming on the given Search index. - BUCKET:INDEX:total_grpc_queries_slow: - type: integer - description: The total number of queries added to the slow query log that used gRPC for streaming on the given Search index. - BUCKET:INDEX:total_grpc_queries_timeout: - type: integer - description: The total number of queries that timed out that used gRPC for streaming on the given Search index. - BUCKET:INDEX:total_grpc_request_time: - type: integer - description: |- - The total time, in nanoseconds, for internal scatter-gather requests. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. - The coordinating node applies filters to the results from all Search index partitions and returns the final result set. - BUCKET:INDEX:total_internal_queries: - type: integer - description: |- - The number of internal queries from the coordinating node for a Search query to other nodes running the Search Service, for the given Search index. - - The Search Service uses gRPC to manage scatter-gather operations across nodes when there are multiple nodes running the Search Service in a cluster. - The coordinating node is the Search node that receives the Search request and scatters it to all other Search index partitions on other nodes. - The coordinating node applies filters to the results from all Search index partitions and returns the final result set. - BUCKET:INDEX:total_knn_searches: - type: integer - description: |- - The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector-search/vector-search.html) requests made to the given Search index. - BUCKET:INDEX:total_queries: - type: integer - description: The total number of Search queries per second on the given Search index. - BUCKET:INDEX:total_queries_error: - type: integer - description: |- - The total number of Search queries on the given Search index that resulted in an error. - - This statistic appears on the Server Web Console dashboard as **Search Query Error Rate**. - BUCKET:INDEX:total_queries_slow: - type: integer - description: |- - The total number of Search queries on the given Search index in the slow query log. - - Slow queries are any queries that take longer than 5 seconds to run. - - This statistic appears on the Server Web Console dashboard as **Search Slow Queries**. - BUCKET:INDEX:total_queries_timeout: - type: integer - description: |- - The total number of Search queries on the given Search index that timed out. - - This statistic appears on the Server Web Console dashboard as **Search Query Timeout Rate**. - BUCKET:INDEX:total_request_time: - type: integer - description: The total time, in nanoseconds, spent processing Search query requests for the given Search index. - BUCKET:INDEX:total_term_searchers: - type: integer - description: |- - The total number of term searchers for the given Search index. - - Every Search query requires 1 or more term searchers. - More complex Search queries typically require more term searchers. - - Use this statistic to approximate how complex a query is. - - This statistic appears on the Server Web Console dashboard as **Term Searchers Start Rate**. - BUCKET:INDEX:total_term_searchers_finished: - type: integer - description: The total number of term searchers on the given Search index that have finished serving a Search query. - BUCKET:INDEX:total_vectors: - type: integer - description: |- - The total number of vectors inside the given Search index, across all indexed fields. - - If there are no vectors inside the Search index, the REST API does not return this statistic. - - securitySchemes: - Admin: - type: http - scheme: basic - description: |- - You must have the **Full Admin**, **Cluster Admin**, or **Bucket Admin** role, with FTS Read permissions on the required bucket. - - Statistics: - type: http - scheme: basic - description: |- - You must have the **Search Admin** role, with Stats Read permissions on the required bucket. From cfd4b37acfdef1eda5ff07809d4c306d29e52360 Mon Sep 17 00:00:00 2001 From: rakhi-prathap Date: Thu, 12 Jun 2025 09:26:00 +0530 Subject: [PATCH 10/25] Add errors qualifier to logging parameters (#170) --- docs/modules/n1ql-rest-admin/pages/index.adoc | 21 ++++++++++++++++++- src/admin/swagger/admin.yaml | 14 ++++++++++--- 2 files changed, 31 insertions(+), 4 deletions(-) diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 29286292..6dc7f6c1 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -5016,7 +5016,7 @@ a¦ [markdown] -- -A LIKE search pattern to match against the query text. +A LIKE search pattern to match against the query text. If specified, all completed queries where the pattern is found are logged. -- @@ -5043,6 +5043,25 @@ include::index.adoc[tag=desc-Logging_Parameters_Plan, opts=optional] a¦ <> +a¦ +*errors* + +_optional_ +a¦ + +[markdown] +-- +The number of errors. +If specified, all completed queries that return at least this many errors are logged. +Queries with fewer errors are not logged. + +-- + +[%hardbreaks] +*Example:* `5` +{blank} +a¦ Integer (int32) + + |=== //end::Logging_Parameters[] diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index 87b9cbde..3c2e6a7f 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -1525,18 +1525,26 @@ components: description: | A user name, as given in the request credentials. If specified, all completed queries with this user name are logged. - statement: + statement: type: string default: "" example: "%FIND USER%" x-has-default: true x-has-example: true description: | - A LIKE search pattern to match against the query text. + A LIKE search pattern to match against the query text. If specified, all completed queries where the pattern is found are logged. plan: $ref: "#/components/schemas/Logging_Parameters_Plan" - + errors: + type: integer + format: int32 + example: 5 + x-has-example: true + description: | + The number of errors. + If specified, all completed queries that return at least this many errors are logged. + Queries with fewer errors are not logged. completed-limit: type: integer format: int32 From b644fdabb0dc6a635ed42dce74a89bff039c7014 Mon Sep 17 00:00:00 2001 From: Simon Dew Date: Wed, 10 Sep 2025 11:27:32 +0100 Subject: [PATCH 11/25] DOC-13246: Backporting template updates to cb-swagger (#171) * Backporting template updates to cb-swagger * Build output documentation * Fix GitHub action --------- Co-authored-by: tech-comm-team-couchbase --- .github/workflows/test.yml | 4 +- .../analytics-rest-admin/pages/index.adoc | 126 +++--- .../analytics-rest-config/pages/index.adoc | 54 ++- .../analytics-rest-library/pages/index.adoc | 42 +- .../analytics-rest-links/pages/index.adoc | 178 +++++---- .../analytics-rest-service/pages/index.adoc | 106 +++--- .../analytics-rest-settings/pages/index.adoc | 26 +- .../eventing-rest-api/pages/index.adoc | 358 ++++++++++++------ .../fts-rest-advanced/pages/index.adoc | 72 ++-- .../fts-rest-advanced/search-advanced.gradle | 2 +- .../fts-rest-indexing/pages/index.adoc | 338 +++++++++++------ .../fts-rest-indexing/search-index.gradle | 2 +- docs/modules/fts-rest-manage/pages/index.adoc | 26 +- .../fts-rest-manage/search-manage.gradle | 2 +- docs/modules/fts-rest-nodes/pages/index.adoc | 192 ++++++---- .../fts-rest-nodes/search-nodes.gradle | 2 +- docs/modules/fts-rest-query/pages/index.adoc | 62 +-- .../fts-rest-query/search-query.gradle | 2 +- docs/modules/fts-rest-stats/pages/index.adoc | 34 +- .../fts-rest-stats/search-stats.gradle | 2 +- .../modules/index-rest-stats/pages/index.adoc | 64 ++-- docs/modules/n1ql-rest-admin/pages/index.adoc | 290 +++++++++----- .../n1ql-rest-functions/pages/index.adoc | 52 ++- docs/modules/n1ql-rest-query/pages/index.adoc | 58 +-- .../n1ql-rest-settings/pages/index.adoc | 54 ++- src/admin/admin.gradle | 2 +- src/analytics-admin/analytics-admin.gradle | 2 +- src/analytics-config/analytics-config.gradle | 2 +- .../analytics-library.gradle | 2 +- src/analytics-links/analytics-links.gradle | 2 +- .../analytics-service.gradle | 2 +- .../analytics-settings.gradle | 2 +- src/eventing/eventing.gradle | 2 +- src/functions/functions.gradle | 2 +- src/indexes/indexes.gradle | 2 +- src/query-service/query-service.gradle | 2 +- src/query-settings/query-settings.gradle | 2 +- templates/index.mustache | 10 +- templates/model.mustache | 2 +- templates/models.mustache | 2 +- templates/schema.mustache | 6 +- 41 files changed, 1388 insertions(+), 804 deletions(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index b9c8c4ed..eef1d0c8 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -26,8 +26,8 @@ jobs: run: ./gradlew --rerun-tasks - name: Push output run: | - git config user.name github-actions - git config user.email github-actions@github.com + git config user.name tech-comm-team-couchbase + git config user.email tech-comm-team@couchbase.com git add . git commit -m "Build output documentation" || echo "No changes to push" git push diff --git a/docs/modules/analytics-rest-admin/pages/index.adoc b/docs/modules/analytics-rest-admin/pages/index.adoc index c4c050e6..133f3b21 100644 --- a/docs/modules/analytics-rest-admin/pages/index.adoc +++ b/docs/modules/analytics-rest-admin/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,7 +114,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -132,16 +132,18 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> +xref:cancel_request[] +xref:cluster_status[] +xref:completed_requests[] +xref:ingestion_status[] +xref:monitor_node[] +xref:restart_cluster[] +xref:restart_node[] +xref:return_active_requests[] +//tag::cancel_request[] + // markup not found, no include::{specDir}paths/cancel_request/operation-before.adoc[opts=optional] @@ -320,7 +322,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -349,6 +351,10 @@ include::{snippetDir}cancel_request/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/cancel_request/operation-after.adoc[opts=optional] +//end::cancel_request[] + + +//tag::cluster_status[] // markup not found, no include::{specDir}paths/cluster_status/operation-before.adoc[opts=optional] @@ -431,7 +437,7 @@ a| [markdown] -- Success. Returns an object giving the current status of the Analytics Service. -- -a| <> +a| xref:Status[] | 401 @@ -478,7 +484,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-clusterReadPoolsRead[] |=== @@ -507,6 +513,10 @@ include::{snippetDir}cluster_status/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/cluster_status/operation-after.adoc[opts=optional] +//end::cluster_status[] + + +//tag::completed_requests[] // markup not found, no include::{specDir}paths/completed_requests/operation-before.adoc[opts=optional] @@ -589,7 +599,7 @@ a| [markdown] -- Success. Returns a list of all completed analytic requests. -- -a| <> +a| xref:Request[] array | 401 @@ -636,7 +646,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -665,6 +675,10 @@ include::{snippetDir}completed_requests/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/completed_requests/operation-after.adoc[opts=optional] +//end::completed_requests[] + + +//tag::ingestion_status[] // markup not found, no include::{specDir}paths/ingestion_status/operation-before.adoc[opts=optional] @@ -747,7 +761,7 @@ a| [markdown] -- Success. Returns an object giving the ingestion status of each Analytics collection. -- -a| <> +a| xref:Ingestion[] | 401 @@ -794,7 +808,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -823,6 +837,10 @@ include::{snippetDir}ingestion_status/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/ingestion_status/operation-after.adoc[opts=optional] +//end::ingestion_status[] + + +//tag::monitor_node[] // markup not found, no include::{specDir}paths/monitor_node/operation-before.adoc[opts=optional] @@ -909,7 +927,7 @@ a| [markdown] -- Success. Returns an object giving the number of pending mutations for each Analytics collection. -- -a| <> +a| xref:Mutations[] | 401 @@ -956,7 +974,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -985,6 +1003,10 @@ include::{snippetDir}monitor_node/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/monitor_node/operation-after.adoc[opts=optional] +//end::monitor_node[] + + +//tag::restart_cluster[] // markup not found, no include::{specDir}paths/restart_cluster/operation-before.adoc[opts=optional] @@ -1114,7 +1136,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -1143,6 +1165,10 @@ include::{snippetDir}restart_cluster/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/restart_cluster/operation-after.adoc[opts=optional] +//end::restart_cluster[] + + +//tag::restart_node[] // markup not found, no include::{specDir}paths/restart_node/operation-before.adoc[opts=optional] @@ -1272,7 +1298,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -1301,6 +1327,10 @@ include::{snippetDir}restart_node/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/restart_node/operation-after.adoc[opts=optional] +//end::restart_node[] + + +//tag::return_active_requests[] // markup not found, no include::{specDir}paths/return_active_requests/operation-before.adoc[opts=optional] @@ -1383,7 +1413,7 @@ a| [markdown] -- Success. Returns an array id details on the running requests. -- -a| <> +a| xref:Request[] array | 401 @@ -1430,7 +1460,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -1459,6 +1489,8 @@ include::{snippetDir}return_active_requests/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/return_active_requests/operation-after.adoc[opts=optional] +//end::return_active_requests[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1495,20 +1527,20 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:Ingestion[] +xref:IngestionLink[] +xref:IngestionLinkState[] +xref:IngestionLinkStateScope[] +xref:IngestionLinkStateScopeColl[] +xref:Mutations[] +xref:MutationsColl[] +xref:Request[] +xref:Status[] +xref:StatusNodes[] +xref:StatusPartitions[] +xref:StatusTopology[] +xref:StatusTopologyState[] +xref:StatusTopologyStateReplicas[] endif::[] @@ -1554,7 +1586,7 @@ An array of objects, each giving information about a single linked Analytics sco [%hardbreaks] {blank} -a¦ <> +a¦ xref:IngestionLink[] array |=== @@ -1662,7 +1694,7 @@ Analytics collections which have the same ingestion state within this Analytics [%hardbreaks] {blank} -a¦ <> +a¦ xref:IngestionLinkState[] array |=== @@ -1805,7 +1837,7 @@ An array of objects, each one giving information about a single Analytics scope. [%hardbreaks] {blank} -a¦ <> +a¦ xref:IngestionLinkStateScope[] array |=== @@ -1877,7 +1909,7 @@ An array of objects, each one giving information about a single Analytics collec [%hardbreaks] {blank} -a¦ <> +a¦ xref:IngestionLinkStateScopeColl[] array |=== @@ -1995,7 +2027,7 @@ include::index.adoc[tag=desc-MutationsColl, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:MutationsColl[] |=== @@ -2652,7 +2684,7 @@ An array of objects, each giving information about one Analytics node. [%hardbreaks] {blank} -a¦ <> +a¦ xref:StatusNodes[] array a¦ @@ -2667,7 +2699,7 @@ An array of objects, each giving information about one Analytics partition. [%hardbreaks] {blank} -a¦ <> +a¦ xref:StatusPartitions[] array a¦ @@ -2682,7 +2714,7 @@ include::index.adoc[tag=desc-StatusTopology, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:StatusTopology[] |=== @@ -3097,7 +3129,7 @@ An array of objects, each giving information about the state of one Analytics pa [%hardbreaks] {blank} -a¦ <> +a¦ xref:StatusTopologyState[] array |=== @@ -3201,7 +3233,7 @@ An array of objects, each giving information about the state of one Analytics re [%hardbreaks] {blank} -a¦ <> +a¦ xref:StatusTopologyStateReplicas[] array |=== diff --git a/docs/modules/analytics-rest-config/pages/index.adoc b/docs/modules/analytics-rest-config/pages/index.adoc index de8c3aca..973b43be 100644 --- a/docs/modules/analytics-rest-config/pages/index.adoc +++ b/docs/modules/analytics-rest-config/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,7 +114,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -132,12 +132,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:get_node[] +xref:get_service[] +xref:put_node[] +xref:put_service[] +//tag::get_node[] + // markup not found, no include::{specDir}paths/get_node/operation-before.adoc[opts=optional] @@ -219,7 +221,7 @@ a| [markdown] -- Success. Returns an object listing the configurable node-level parameters and their current values. -- -a| <> +a| xref:Node[] | 401 @@ -260,7 +262,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -289,6 +291,10 @@ include::{snippetDir}get_node/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_node/operation-after.adoc[opts=optional] +//end::get_node[] + + +//tag::get_service[] // markup not found, no include::{specDir}paths/get_service/operation-before.adoc[opts=optional] @@ -371,7 +377,7 @@ a| [markdown] -- Success. Returns an object listing the configurable service-level parameters and their current values. -- -a| <> +a| xref:Service[] | 401 @@ -412,7 +418,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -441,6 +447,10 @@ include::{snippetDir}get_service/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_service/operation-after.adoc[opts=optional] +//end::get_service[] + + +//tag::put_node[] // markup not found, no include::{specDir}paths/put_node/operation-before.adoc[opts=optional] @@ -539,7 +549,7 @@ An object specifying one or more of the configurable node-level parameters on th [%hardbreaks] {blank} -a¦ <> +a¦ xref:Node[] @@ -583,7 +593,7 @@ a| [markdown] -- Bad request. Unknown parameter or incorrect value. -- -a| <> +a| xref:Errors[] | 401 @@ -624,7 +634,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -653,6 +663,10 @@ include::{snippetDir}put_node/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/put_node/operation-after.adoc[opts=optional] +//end::put_node[] + + +//tag::put_service[] // markup not found, no include::{specDir}paths/put_service/operation-before.adoc[opts=optional] @@ -749,7 +763,7 @@ An object specifying one or more of the configurable service-level parameters. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Service[] @@ -793,7 +807,7 @@ a| [markdown] -- Bad request. Unknown parameter or incorrect value. -- -a| <> +a| xref:Errors[] | 401 @@ -834,7 +848,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -863,6 +877,8 @@ include::{snippetDir}put_service/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/put_service/operation-after.adoc[opts=optional] +//end::put_service[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -899,9 +915,9 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> +xref:Errors[] +xref:Node[] +xref:Service[] endif::[] diff --git a/docs/modules/analytics-rest-library/pages/index.adoc b/docs/modules/analytics-rest-library/pages/index.adoc index 2d985f12..d6dac74d 100644 --- a/docs/modules/analytics-rest-library/pages/index.adoc +++ b/docs/modules/analytics-rest-library/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,7 +114,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -132,11 +132,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> +xref:delete_library[] +xref:get_collection[] +xref:post_library[] +//tag::delete_library[] + // markup not found, no include::{specDir}paths/delete_library/operation-before.adoc[opts=optional] @@ -295,7 +297,7 @@ a| [markdown] -- Internal server error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Errors[] @@ -328,7 +330,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-fullAdmin[] |=== @@ -357,6 +359,10 @@ include::{snippetDir}delete_library/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/delete_library/operation-after.adoc[opts=optional] +//end::delete_library[] + + +//tag::get_collection[] // markup not found, no include::{specDir}paths/get_collection/operation-before.adoc[opts=optional] @@ -439,7 +445,7 @@ a| [markdown] -- Success. Returns an array of objects, each of which contains information about a single library. -- -a| <> +a| xref:Libraries[] array | 404 @@ -453,7 +459,7 @@ a| [markdown] -- Internal server error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Errors[] @@ -486,7 +492,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsAdmin[] |=== @@ -515,6 +521,10 @@ include::{snippetDir}get_collection/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_collection/operation-after.adoc[opts=optional] +//end::get_collection[] + + +//tag::post_library[] // markup not found, no include::{specDir}paths/post_library/operation-before.adoc[opts=optional] @@ -716,7 +726,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Errors[] | 500 @@ -724,7 +734,7 @@ a| [markdown] -- Internal server error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Errors[] @@ -757,7 +767,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-fullAdmin[] |=== @@ -786,6 +796,8 @@ include::{snippetDir}post_library/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_library/operation-after.adoc[opts=optional] +//end::post_library[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -822,8 +834,8 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> +xref:Errors[] +xref:Libraries[] endif::[] diff --git a/docs/modules/analytics-rest-links/pages/index.adoc b/docs/modules/analytics-rest-links/pages/index.adoc index a0977a0b..633d7286 100644 --- a/docs/modules/analytics-rest-links/pages/index.adoc +++ b/docs/modules/analytics-rest-links/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -113,9 +113,9 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> -<> -<> +xref:tag-LegacyMethods[] +xref:tag-MultipleLinks[] +xref:tag-SingleLinks[] endif::[] @@ -133,11 +133,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> +xref:delete_alt[] +xref:post_alt[] +xref:put_alt[] +//tag::delete_alt[] + // markup not found, no include::{specDir}paths/delete_alt/operation-before.adoc[opts=optional] @@ -290,7 +292,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -298,7 +300,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -331,7 +333,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -360,6 +362,10 @@ a| <> // markup not found, no include::{specDir}paths/delete_alt/operation-after.adoc[opts=optional] +//end::delete_alt[] + + +//tag::post_alt[] // markup not found, no include::{specDir}paths/post_alt/operation-before.adoc[opts=optional] @@ -924,7 +930,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -932,7 +938,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -965,7 +971,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -994,6 +1000,10 @@ a| <> // markup not found, no include::{specDir}paths/post_alt/operation-after.adoc[opts=optional] +//end::post_alt[] + + +//tag::put_alt[] // markup not found, no include::{specDir}paths/put_alt/operation-before.adoc[opts=optional] @@ -1559,7 +1569,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -1567,7 +1577,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -1600,7 +1610,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -1629,6 +1639,8 @@ a| <> // markup not found, no include::{specDir}paths/put_alt/operation-after.adoc[opts=optional] +//end::put_alt[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1649,9 +1661,11 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:get_all[] +xref:get_scope[] + +//tag::get_all[] // markup not found, no include::{specDir}paths/get_all/operation-before.adoc[opts=optional] @@ -1821,7 +1835,7 @@ a| [markdown] -- Success. Returns an array of objects, each of which contains information about a link. -- -a| <> +a| xref:ResponseAll[] array | 400 @@ -1829,7 +1843,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -1837,7 +1851,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -1870,7 +1884,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -1899,6 +1913,10 @@ include::{snippetDir}get_all/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_all/operation-after.adoc[opts=optional] +//end::get_all[] + + +//tag::get_scope[] // markup not found, no include::{specDir}paths/get_scope/operation-before.adoc[opts=optional] @@ -2055,7 +2073,7 @@ a| [markdown] -- Success. Returns an array of objects, each of which contains information about a link. -- -a| <> +a| xref:ResponseAll[] array | 400 @@ -2063,7 +2081,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -2071,7 +2089,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -2104,7 +2122,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -2133,6 +2151,8 @@ include::{snippetDir}get_scope/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_scope/operation-after.adoc[opts=optional] +//end::get_scope[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -2153,11 +2173,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:delete_link[] +xref:get_link[] +xref:post_link[] +xref:put_link[] + +//tag::delete_link[] // markup not found, no include::{specDir}paths/delete_link/operation-before.adoc[opts=optional] @@ -2310,7 +2332,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -2318,7 +2340,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -2351,7 +2373,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -2380,6 +2402,10 @@ include::{snippetDir}delete_link/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/delete_link/operation-after.adoc[opts=optional] +//end::delete_link[] + + +//tag::get_link[] // markup not found, no include::{specDir}paths/get_link/operation-before.adoc[opts=optional] @@ -2553,7 +2579,7 @@ a| [markdown] -- Success. Returns an array of objects, each of which contains information about a link. -- -a| <> +a| xref:ResponseAll[] array | 400 @@ -2561,7 +2587,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -2569,7 +2595,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -2602,7 +2628,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -2631,6 +2657,10 @@ include::{snippetDir}get_link/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_link/operation-after.adoc[opts=optional] +//end::get_link[] + + +//tag::post_link[] // markup not found, no include::{specDir}paths/post_link/operation-before.adoc[opts=optional] @@ -3206,7 +3236,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -3214,7 +3244,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -3247,7 +3277,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -3276,6 +3306,10 @@ include::{snippetDir}post_link/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_link/operation-after.adoc[opts=optional] +//end::post_link[] + + +//tag::put_link[] // markup not found, no include::{specDir}paths/put_link/operation-before.adoc[opts=optional] @@ -3852,7 +3886,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Wrong[] | 500 @@ -3860,7 +3894,7 @@ a| [markdown] -- Internal Server Error. Incorrect path or port number, incorrect credentials, badly formatted parameters, or missing arguments. -- -a| <> +a| xref:Wrong[] @@ -3893,7 +3927,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManage[] |=== @@ -3922,6 +3956,8 @@ include::{snippetDir}put_link/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/put_link/operation-after.adoc[opts=optional] +//end::put_link[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -3959,23 +3995,23 @@ ifdef::collapse-models[] endif::collapse-models[] [%hardbreaks] ifdef::enum-definitions[] -<> +xref:CommonType[] endif::enum-definitions[] ifdef::enum-definitions[] -<> +xref:CommonTypeEdit[] endif::enum-definitions[] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:ResponseAll[] +xref:ResponseAzureBlob[] +xref:ResponseAzureBlobSpecific[] +xref:ResponseCouchbase[] +xref:ResponseCouchbaseSpecific[] +xref:ResponseCouchbaseSpecificNode[] +xref:ResponseCouchbaseSpecificNodeServices[] +xref:ResponseGCS[] +xref:ResponseGCSSpecific[] +xref:ResponseS3[] +xref:ResponseS3Specific[] +xref:Wrong[] endif::[] ifdef::enum-definitions[] @@ -4119,19 +4155,19 @@ This schema has alternative properties, depending on the value of *type*: a| `azureblob` a| These properties are returned for Azure Blob links. -a| <> +a| xref:ResponseAzureBlob[] a| `couchbase` a| These properties are returned for remote Couchbase links. -a| <> +a| xref:ResponseCouchbase[] a| `gcs` a| These properties are returned for Google Cloud Storage links. -a| <> +a| xref:ResponseGCS[] a| `s3` a| These properties are returned for S3 links. -a| <> +a| xref:ResponseS3[] |=== @@ -4165,10 +4201,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:ResponseAll[] -* <> +* xref:ResponseAzureBlobSpecific[] @@ -4412,10 +4448,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:ResponseAll[] -* <> +* xref:ResponseCouchbaseSpecific[] @@ -4599,7 +4635,7 @@ An array of objects, each of which contains information about a node in the targ [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponseCouchbaseSpecificNode[] array a¦ @@ -4737,7 +4773,7 @@ include::index.adoc[tag=desc-ResponseCouchbaseSpecificNodeServices, opts=optiona [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponseCouchbaseSpecificNodeServices[] |=== @@ -4918,10 +4954,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:ResponseAll[] -* <> +* xref:ResponseGCSSpecific[] @@ -5048,10 +5084,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:ResponseAll[] -* <> +* xref:ResponseS3Specific[] diff --git a/docs/modules/analytics-rest-service/pages/index.adoc b/docs/modules/analytics-rest-service/pages/index.adoc index 37db25d1..fac5cae2 100644 --- a/docs/modules/analytics-rest-service/pages/index.adoc +++ b/docs/modules/analytics-rest-service/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,7 +114,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -132,12 +132,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:get_query[] +xref:get_service[] +xref:post_query[] +xref:post_service[] +//tag::get_query[] + // markup not found, no include::{specDir}paths/get_query/operation-before.adoc[opts=optional] @@ -221,7 +223,7 @@ Specify the parameters in the query URL in URL-encoded format. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Parameters[] @@ -262,7 +264,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Responses[] | 400 @@ -270,7 +272,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Responses[] | 401 @@ -278,7 +280,7 @@ a| [markdown] -- Unauthorized. The user name or password may be incorrect. -- -a| <> +a| xref:Responses[] @@ -311,7 +313,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -340,6 +342,10 @@ a| <> // markup not found, no include::{specDir}paths/get_query/operation-after.adoc[opts=optional] +//end::get_query[] + + +//tag::get_service[] // markup not found, no include::{specDir}paths/get_service/operation-before.adoc[opts=optional] @@ -427,7 +433,7 @@ Specify the parameters in the query URL in URL-encoded format. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Parameters[] @@ -468,7 +474,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Responses[] | 400 @@ -476,7 +482,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Responses[] | 401 @@ -484,7 +490,7 @@ a| [markdown] -- Unauthorized. The user name or password may be incorrect. -- -a| <> +a| xref:Responses[] @@ -517,7 +523,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -546,6 +552,10 @@ include::{snippetDir}get_service/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_service/operation-after.adoc[opts=optional] +//end::get_service[] + + +//tag::post_query[] // markup not found, no include::{specDir}paths/post_query/operation-before.adoc[opts=optional] @@ -637,7 +647,7 @@ An object specifying one or more query parameters. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Parameters[] @@ -675,7 +685,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Responses[] | 400 @@ -683,7 +693,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Responses[] | 401 @@ -691,7 +701,7 @@ a| [markdown] -- Unauthorized. The user name or password may be incorrect. -- -a| <> +a| xref:Responses[] @@ -734,6 +744,10 @@ a| <> // markup not found, no include::{specDir}paths/post_query/operation-after.adoc[opts=optional] +//end::post_query[] + + +//tag::post_service[] // markup not found, no include::{specDir}paths/post_service/operation-before.adoc[opts=optional] @@ -826,7 +840,7 @@ An object specifying one or more query parameters. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Parameters[] @@ -864,7 +878,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Responses[] | 400 @@ -872,7 +886,7 @@ a| [markdown] -- Bad request. A parameter has an incorrect value. -- -a| <> +a| xref:Responses[] | 401 @@ -880,7 +894,7 @@ a| [markdown] -- Unauthorized. The user name or password may be incorrect. -- -a| <> +a| xref:Responses[] @@ -913,7 +927,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-analyticsManageAnalyticsSelect[] |=== @@ -942,6 +956,8 @@ include::{snippetDir}post_service/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_service/operation-after.adoc[opts=optional] +//end::post_service[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -978,17 +994,17 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:Parameters[] +xref:ParametersCommon[] +xref:ParametersLocal[] +xref:Responses[] +xref:ResponsesCommon[] +xref:ResponsesCommonErrors[] +xref:ResponsesCommonWarnings[] +xref:ResponsesCommonYardsticks[] +xref:ResponsesLocal[] +xref:ResponsesLocalPlans[] +xref:ResponsesLocalYardsticks[] endif::[] @@ -1012,10 +1028,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:ParametersCommon[] -* <> +* xref:ParametersLocal[] @@ -1426,10 +1442,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:ResponsesCommon[] -* <> +* xref:ResponsesLocal[] @@ -1566,7 +1582,7 @@ An array of error objects. Present only if 1 or more errors are returned during [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponsesCommonErrors[] array a¦ @@ -1593,7 +1609,7 @@ By default, no warnings are returned, even if warnings have occurred during proc [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponsesCommonWarnings[] array a¦ @@ -1608,7 +1624,7 @@ include::index.adoc[tag=desc-ResponsesCommonYardsticks, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponsesCommonYardsticks[] |=== @@ -1945,7 +1961,7 @@ include::index.adoc[tag=desc-ResponsesLocalPlans, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponsesLocalPlans[] a¦ @@ -1960,7 +1976,7 @@ include::index.adoc[tag=desc-ResponsesLocalYardsticks, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ResponsesLocalYardsticks[] |=== diff --git a/docs/modules/analytics-rest-settings/pages/index.adoc b/docs/modules/analytics-rest-settings/pages/index.adoc index 2ee7617b..73619dfc 100644 --- a/docs/modules/analytics-rest-settings/pages/index.adoc +++ b/docs/modules/analytics-rest-settings/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,7 +114,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -132,10 +132,12 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:get_settings[] +xref:post_settings[] +//tag::get_settings[] + // markup not found, no include::{specDir}paths/get_settings/operation-before.adoc[opts=optional] @@ -218,7 +220,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Settings[] | 401 @@ -259,7 +261,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-clusterReadPoolsRead[] |=== @@ -288,6 +290,10 @@ include::{snippetDir}get_settings/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_settings/operation-after.adoc[opts=optional] +//end::get_settings[] + + +//tag::post_settings[] // markup not found, no include::{specDir}paths/post_settings/operation-before.adoc[opts=optional] @@ -419,7 +425,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Settings[] | 400 @@ -468,7 +474,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-clusterReadPoolsRead[] |=== @@ -497,6 +503,8 @@ include::{snippetDir}post_settings/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_settings/operation-after.adoc[opts=optional] +//end::post_settings[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -533,7 +541,7 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> +xref:Settings[] endif::[] diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index 4668773a..e400f11d 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -112,13 +112,13 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> +xref:tag-Activation[] +xref:tag-Advanced[] +xref:tag-GlobalConfig[] +xref:tag-List[] +xref:tag-Logging[] +xref:tag-Statistics[] +xref:tag-Status[] endif::[] @@ -136,12 +136,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:basic_deploy[] +xref:basic_pause[] +xref:basic_resume[] +xref:basic_undeploy[] +//tag::basic_deploy[] + // markup not found, no include::{specDir}paths/basic_deploy/operation-before.adoc[opts=optional] @@ -340,9 +342,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -371,6 +373,10 @@ include::{snippetDir}basic_deploy/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/basic_deploy/operation-after.adoc[opts=optional] +//end::basic_deploy[] + + +//tag::basic_pause[] // markup not found, no include::{specDir}paths/basic_pause/operation-before.adoc[opts=optional] @@ -570,9 +576,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -601,6 +607,10 @@ include::{snippetDir}basic_pause/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/basic_pause/operation-after.adoc[opts=optional] +//end::basic_pause[] + + +//tag::basic_resume[] // markup not found, no include::{specDir}paths/basic_resume/operation-before.adoc[opts=optional] @@ -806,9 +816,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -837,6 +847,10 @@ include::{snippetDir}basic_resume/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/basic_resume/operation-after.adoc[opts=optional] +//end::basic_resume[] + + +//tag::basic_undeploy[] // markup not found, no include::{specDir}paths/basic_undeploy/operation-before.adoc[opts=optional] @@ -1036,9 +1050,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -1067,6 +1081,8 @@ include::{snippetDir}basic_undeploy/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/basic_undeploy/operation-after.adoc[opts=optional] +//end::basic_undeploy[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1087,22 +1103,24 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:adv_function_import[] +xref:adv_function_import_all[] +xref:adv_function_view[] +xref:adv_function_view_all[] +xref:adv_function_zap[] +xref:adv_function_zap_all[] +xref:adv_multiple_export[] +xref:adv_multiple_import[] +xref:adv_settings_get[] +xref:adv_settings_update[] +xref:adv_structure_get[] +xref:adv_structure_update[] +xref:adv_text_get[] +xref:adv_text_update[] +//tag::adv_function_import[] + // markup not found, no include::{specDir}paths/adv_function_import/operation-before.adoc[opts=optional] @@ -1260,7 +1278,7 @@ A single function definition object, or an array containing a single function de [%hardbreaks] {blank} -a¦ <> +a¦ xref:AddFunction[] @@ -1335,9 +1353,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -1366,6 +1384,10 @@ include::{snippetDir}adv_function_import/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_function_import/operation-after.adoc[opts=optional] +//end::adv_function_import[] + + +//tag::adv_function_import_all[] // markup not found, no include::{specDir}paths/adv_function_import_all/operation-before.adoc[opts=optional] @@ -1455,7 +1477,7 @@ A single function definition object, or an array containing one or more function [%hardbreaks] {blank} -a¦ <> +a¦ xref:AddFunctions[] @@ -1530,7 +1552,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -1559,6 +1581,10 @@ include::{snippetDir}adv_function_import_all/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_function_import_all/operation-after.adoc[opts=optional] +//end::adv_function_import_all[] + + +//tag::adv_function_view[] // markup not found, no include::{specDir}paths/adv_function_view/operation-before.adoc[opts=optional] @@ -1732,7 +1758,7 @@ a| [markdown] -- Returns a single function definition object. -- -a| <> +a| xref:handler_schema[] | 404 @@ -1771,9 +1797,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -1802,6 +1828,10 @@ include::{snippetDir}adv_function_view/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_function_view/operation-after.adoc[opts=optional] +//end::adv_function_view[] + + +//tag::adv_function_view_all[] // markup not found, no include::{specDir}paths/adv_function_view_all/operation-before.adoc[opts=optional] @@ -1889,7 +1919,7 @@ a| [markdown] -- Returns an array containing one or more function definition objects. -- -a| <> +a| xref:handler_schema[] array | 404 @@ -1928,7 +1958,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -1957,6 +1987,10 @@ include::{snippetDir}adv_function_view_all/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_function_view_all/operation-after.adoc[opts=optional] +//end::adv_function_view_all[] + + +//tag::adv_function_zap[] // markup not found, no include::{specDir}paths/adv_function_zap/operation-before.adoc[opts=optional] @@ -2163,9 +2197,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -2194,6 +2228,10 @@ include::{snippetDir}adv_function_zap/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_function_zap/operation-after.adoc[opts=optional] +//end::adv_function_zap[] + + +//tag::adv_function_zap_all[] // markup not found, no include::{specDir}paths/adv_function_zap_all/operation-before.adoc[opts=optional] @@ -2313,7 +2351,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -2342,6 +2380,10 @@ include::{snippetDir}adv_function_zap_all/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_function_zap_all/operation-after.adoc[opts=optional] +//end::adv_function_zap_all[] + + +//tag::adv_multiple_export[] // markup not found, no include::{specDir}paths/adv_multiple_export/operation-before.adoc[opts=optional] @@ -2429,7 +2471,7 @@ a| [markdown] -- Returns an array containing one or more function definition objects. -- -a| <> +a| xref:handler_schema[] array | 404 @@ -2468,7 +2510,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -2497,6 +2539,10 @@ include::{snippetDir}adv_multiple_export/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_multiple_export/operation-after.adoc[opts=optional] +//end::adv_multiple_export[] + + +//tag::adv_multiple_import[] // markup not found, no include::{specDir}paths/adv_multiple_import/operation-before.adoc[opts=optional] @@ -2586,7 +2632,7 @@ A single function definition object, or an array containing one or more function [%hardbreaks] {blank} -a¦ <> +a¦ xref:AddFunctions[] @@ -2661,7 +2707,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -2690,6 +2736,10 @@ include::{snippetDir}adv_multiple_import/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_multiple_import/operation-after.adoc[opts=optional] +//end::adv_multiple_import[] + + +//tag::adv_settings_get[] // markup not found, no include::{specDir}paths/adv_settings_get/operation-before.adoc[opts=optional] @@ -2862,7 +2912,7 @@ a| [markdown] -- Returns an object showing settings for the specified function. -- -a| <> +a| xref:settings_schema[] | 404 @@ -2901,9 +2951,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -2932,6 +2982,10 @@ include::{snippetDir}adv_settings_get/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_settings_get/operation-after.adoc[opts=optional] +//end::adv_settings_get[] + + +//tag::adv_settings_update[] // markup not found, no include::{specDir}paths/adv_settings_update/operation-before.adoc[opts=optional] @@ -3098,7 +3152,7 @@ An object providing settings for the specified function. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Function Settings[] @@ -3173,9 +3227,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -3204,6 +3258,10 @@ include::{snippetDir}adv_settings_update/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_settings_update/operation-after.adoc[opts=optional] +//end::adv_settings_update[] + + +//tag::adv_structure_get[] // markup not found, no include::{specDir}paths/adv_structure_get/operation-before.adoc[opts=optional] @@ -3376,7 +3434,7 @@ a| [markdown] -- Returns an object showing the configuration of the specified function. -- -a| <> +a| xref:depcfg_schema[] | 404 @@ -3415,9 +3473,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -3446,6 +3504,10 @@ include::{snippetDir}adv_structure_get/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_structure_get/operation-after.adoc[opts=optional] +//end::adv_structure_get[] + + +//tag::adv_structure_update[] // markup not found, no include::{specDir}paths/adv_structure_update/operation-before.adoc[opts=optional] @@ -3605,7 +3667,7 @@ An object providing the configuration for the specified function. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Deployment Config[] @@ -3680,9 +3742,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -3711,6 +3773,10 @@ include::{snippetDir}adv_structure_update/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_structure_update/operation-after.adoc[opts=optional] +//end::adv_structure_update[] + + +//tag::adv_text_get[] // markup not found, no include::{specDir}paths/adv_text_get/operation-before.adoc[opts=optional] @@ -3923,9 +3989,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -3954,6 +4020,10 @@ include::{snippetDir}adv_text_get/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_text_get/operation-after.adoc[opts=optional] +//end::adv_text_get[] + + +//tag::adv_text_update[] // markup not found, no include::{specDir}paths/adv_text_update/operation-before.adoc[opts=optional] @@ -4189,9 +4259,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -4220,6 +4290,8 @@ include::{snippetDir}adv_text_update/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/adv_text_update/operation-after.adoc[opts=optional] +//end::adv_text_update[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -4240,10 +4312,12 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:config_get[] +xref:config_update[] +//tag::config_get[] + // markup not found, no include::{specDir}paths/config_get/operation-before.adoc[opts=optional] @@ -4326,7 +4400,7 @@ a| [markdown] -- Returns an object showing the global configuration settings. -- -a| <> +a| xref:UnivConfig[] | 404 @@ -4365,7 +4439,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -4394,6 +4468,10 @@ include::{snippetDir}config_get/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/config_get/operation-after.adoc[opts=optional] +//end::config_get[] + + +//tag::config_update[] // markup not found, no include::{specDir}paths/config_update/operation-before.adoc[opts=optional] @@ -4484,7 +4562,7 @@ An object providing the global configuration settings. [%hardbreaks] {blank} -a¦ <> +a¦ xref:UnivConfig[] @@ -4559,7 +4637,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -4588,6 +4666,8 @@ include::{snippetDir}config_update/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/config_update/operation-after.adoc[opts=optional] +//end::config_update[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -4608,10 +4688,12 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:list_all[] +xref:list_query[] +//tag::list_all[] + // markup not found, no include::{specDir}paths/list_all/operation-before.adoc[opts=optional] @@ -4730,7 +4812,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -4759,6 +4841,10 @@ include::{snippetDir}list_all/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/list_all/operation-after.adoc[opts=optional] +//end::list_all[] + + +//tag::list_query[] // markup not found, no include::{specDir}paths/list_query/operation-before.adoc[opts=optional] @@ -4965,7 +5051,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -4994,6 +5080,8 @@ include::{snippetDir}list_query/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/list_query/operation-after.adoc[opts=optional] +//end::list_query[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -5014,8 +5102,10 @@ endif::[] endif::[] [%hardbreaks] -<> +xref:log_view[] + +//tag::log_view[] // markup not found, no include::{specDir}paths/log_view/operation-before.adoc[opts=optional] @@ -5249,9 +5339,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -5280,6 +5370,8 @@ include::{snippetDir}log_view/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/log_view/operation-after.adoc[opts=optional] +//end::log_view[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -5300,12 +5392,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> +xref:stats_all[] +xref:stats_execution[] +xref:stats_failure[] +xref:stats_latency[] +xref:stats_reset[] + +//tag::stats_all[] // markup not found, no include::{specDir}paths/stats_all/operation-before.adoc[opts=optional] @@ -5471,7 +5565,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -5500,6 +5594,10 @@ include::{snippetDir}stats_all/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/stats_all/operation-after.adoc[opts=optional] +//end::stats_all[] + + +//tag::stats_execution[] // markup not found, no include::{specDir}paths/stats_execution/operation-before.adoc[opts=optional] @@ -5696,9 +5794,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -5727,6 +5825,10 @@ include::{snippetDir}stats_execution/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/stats_execution/operation-after.adoc[opts=optional] +//end::stats_execution[] + + +//tag::stats_failure[] // markup not found, no include::{specDir}paths/stats_failure/operation-before.adoc[opts=optional] @@ -5923,9 +6025,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -5954,6 +6056,10 @@ include::{snippetDir}stats_failure/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/stats_failure/operation-after.adoc[opts=optional] +//end::stats_failure[] + + +//tag::stats_latency[] // markup not found, no include::{specDir}paths/stats_latency/operation-before.adoc[opts=optional] @@ -6150,9 +6256,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -6181,6 +6287,10 @@ include::{snippetDir}stats_latency/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/stats_latency/operation-after.adoc[opts=optional] +//end::stats_latency[] + + +//tag::stats_reset[] // markup not found, no include::{specDir}paths/stats_reset/operation-before.adoc[opts=optional] @@ -6376,9 +6486,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -6407,6 +6517,8 @@ include::{snippetDir}stats_reset/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/stats_reset/operation-after.adoc[opts=optional] +//end::stats_reset[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -6427,9 +6539,11 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:status_all[] +xref:status_function[] + +//tag::status_all[] // markup not found, no include::{specDir}paths/status_all/operation-before.adoc[opts=optional] @@ -6550,7 +6664,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-unscoped[] |=== @@ -6579,6 +6693,10 @@ include::{snippetDir}status_all/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/status_all/operation-after.adoc[opts=optional] +//end::status_all[] + + +//tag::status_function[] // markup not found, no include::{specDir}paths/status_function/operation-before.adoc[opts=optional] @@ -6785,9 +6903,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scoped[] | http (basic) -| <> +| xref:security-global[] |=== @@ -6816,6 +6934,8 @@ include::{snippetDir}status_function/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/status_function/operation-after.adoc[opts=optional] +//end::status_function[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -6852,16 +6972,16 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:AddFunction[] +xref:AddFunctions[] +xref:depcfg_schema[] +xref:depcfg_schema_constants_inner[] +xref:depcfg_schema_buckets_inner[] +xref:depcfg_schema_curl_inner[] +xref:handler_schema[] +xref:function_scope_schema[] +xref:settings_schema[] +xref:UnivConfig[] endif::[] @@ -6885,10 +7005,10 @@ endif::collapse-models[] One of the following: -* <> +* xref:handler_schema[] -* <> +* xref:handler_schema[] array @@ -6922,10 +7042,10 @@ endif::collapse-models[] One of the following: -* <> +* xref:handler_schema[] -* <> +* xref:handler_schema[] array @@ -6980,7 +7100,7 @@ a¦ [%hardbreaks] {blank} -a¦ <> +a¦ xref:depcfg_schema_buckets_inner[] array a¦ @@ -6994,7 +7114,7 @@ a¦ [%hardbreaks] {blank} -a¦ <> +a¦ xref:depcfg_schema_curl_inner[] array a¦ @@ -7100,7 +7220,7 @@ a¦ [%hardbreaks] {blank} -a¦ <> +a¦ xref:depcfg_schema_constants_inner[] array |=== @@ -7535,7 +7655,7 @@ include::index.adoc[tag=desc-depcfg_schema, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:depcfg_schema[] a¦ @@ -7630,7 +7750,7 @@ include::index.adoc[tag=desc-settings_schema, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:settings_schema[] a¦ @@ -7645,7 +7765,7 @@ include::index.adoc[tag=desc-function_scope_schema, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:function_scope_schema[] |=== diff --git a/docs/modules/fts-rest-advanced/pages/index.adoc b/docs/modules/fts-rest-advanced/pages/index.adoc index b16023d9..83d62476 100644 --- a/docs/modules/fts-rest-advanced/pages/index.adoc +++ b/docs/modules/fts-rest-advanced/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/cbft :leveloffset: 1 @@ -113,9 +113,9 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> -<> -<> +xref:tag-Definition[] +xref:tag-Query[] +xref:tag-Quota[] endif::[] @@ -133,10 +133,12 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:getPartition[] +xref:getPartitionName[] +//tag::getPartition[] + // markup not found, no include::{specDir}paths/getPartition/operation-before.adoc[opts=optional] @@ -218,7 +220,7 @@ a| [markdown] -- A JSON object containing the Search index partition information. -- -a| <> +a| xref:indexPartition[] @@ -251,7 +253,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -280,6 +282,10 @@ include::{snippetDir}getPartition/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/getPartition/operation-after.adoc[opts=optional] +//end::getPartition[] + + +//tag::getPartitionName[] // markup not found, no include::{specDir}paths/getPartitionName/operation-before.adoc[opts=optional] @@ -433,7 +439,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -462,6 +468,8 @@ a| // markup not found, no include::{specDir}paths/getPartitionName/operation-after.adoc[opts=optional] +//end::getPartitionName[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -482,9 +490,11 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:getPartitionCount[] +xref:queryPartition[] + +//tag::getPartitionCount[] // markup not found, no include::{specDir}paths/getPartitionCount/operation-before.adoc[opts=optional] @@ -610,7 +620,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:DocumentCount[] @@ -643,7 +653,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -672,6 +682,10 @@ a| <> // markup not found, no include::{specDir}paths/getPartitionCount/operation-after.adoc[opts=optional] +//end::getPartitionCount[] + + +//tag::queryPartition[] // markup not found, no include::{specDir}paths/queryPartition/operation-before.adoc[opts=optional] @@ -788,7 +802,7 @@ A JSON object to define the settings for your Search query. For more information [%hardbreaks] {blank} -a¦ <> +a¦ xref:QueryRequest[] @@ -826,7 +840,7 @@ a| [markdown] -- The response object has a status section that must be checked for every request. Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. -- -a| <> +a| xref:QueryResponse[] @@ -859,7 +873,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-write[] |=== @@ -888,6 +902,8 @@ a| <> // markup not found, no include::{specDir}paths/queryPartition/operation-after.adoc[opts=optional] +//end::queryPartition[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -908,9 +924,11 @@ endif::[] endif::[] [%hardbreaks] -<> +xref:setFtsMemoryQuota[] +//tag::setFtsMemoryQuota[] + // markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-before.adoc[opts=optional] @@ -1066,7 +1084,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -1095,6 +1113,8 @@ a| // markup not found, no include::{specDir}paths/setFtsMemoryQuota/operation-after.adoc[opts=optional] +//end::setFtsMemoryQuota[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1131,12 +1151,12 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> +xref:DocumentCount[] +xref:indexPartition[] +xref:indexPartitionPIndex[] +xref:indexPartitionPIndexInner[] +xref:QueryRequest[] +xref:QueryResponse[] endif::[] @@ -1248,7 +1268,7 @@ include::index.adoc[tag=desc-indexPartitionPIndex, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:indexPartitionPIndex[] a¦ @@ -1324,7 +1344,7 @@ include::index.adoc[tag=desc-indexPartitionPIndexInner, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:indexPartitionPIndexInner[] |=== diff --git a/docs/modules/fts-rest-advanced/search-advanced.gradle b/docs/modules/fts-rest-advanced/search-advanced.gradle index afb35f5f..9a71a90f 100644 --- a/docs/modules/fts-rest-advanced/search-advanced.gradle +++ b/docs/modules/fts-rest-advanced/search-advanced.gradle @@ -5,7 +5,7 @@ openApiGenerate { remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/advanced/advanced.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-advanced/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" + gitRepoId = "cbft" gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/fts-rest-advanced/partials/", diff --git a/docs/modules/fts-rest-indexing/pages/index.adoc b/docs/modules/fts-rest-indexing/pages/index.adoc index 275779a7..fa187672 100644 --- a/docs/modules/fts-rest-indexing/pages/index.adoc +++ b/docs/modules/fts-rest-indexing/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/cbft :leveloffset: 1 @@ -113,10 +113,10 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> -<> -<> -<> +xref:tag-Definitions[] +xref:tag-Management[] +xref:tag-Monitoring[] +xref:tag-Querying[] endif::[] @@ -134,16 +134,18 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> +xref:d-api-index-name[] +xref:d-api-scoped-index-name[] +xref:g-api-index[] +xref:g-api-index-name[] +xref:g-api-scoped-index[] +xref:g-api-scoped-index-name[] +xref:p-api-index-name[] +xref:p-api-scoped-index-name[] +//tag::d-api-index-name[] + // markup not found, no include::{specDir}paths/d-api-index-name/operation-before.adoc[opts=optional] @@ -274,7 +276,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:DeleteIndexResponse[] | 0 @@ -315,7 +317,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-write[] |=== @@ -344,6 +346,10 @@ include::{snippetDir}d-api-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/d-api-index-name/operation-after.adoc[opts=optional] +//end::d-api-index-name[] + + +//tag::d-api-scoped-index-name[] // markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-before.adoc[opts=optional] @@ -377,7 +383,7 @@ DELETE /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME} [markdown] -- Delete the Search index definition from the bucket and scope specified in the endpoint URL. -Unlike [Delete Index Definition](#d-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -505,7 +511,7 @@ a| [markdown] -- A JSON object indicating the status of the operation. -- -a| <> +a| xref:DeleteIndexResponse[] | 0 @@ -546,7 +552,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-write[] |=== @@ -575,6 +581,10 @@ include::{snippetDir}d-api-scoped-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/d-api-scoped-index-name/operation-after.adoc[opts=optional] +//end::d-api-scoped-index-name[] + + +//tag::g-api-index[] // markup not found, no include::{specDir}paths/g-api-index/operation-before.adoc[opts=optional] @@ -657,7 +667,7 @@ a| [markdown] -- A JSON object containing all Search index definitions. -- -a| <> +a| xref:GetIndexesResponse[] @@ -690,7 +700,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -719,6 +729,10 @@ include::{snippetDir}g-api-index/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-index/operation-after.adoc[opts=optional] +//end::g-api-index[] + + +//tag::g-api-index-name[] // markup not found, no include::{specDir}paths/g-api-index-name/operation-before.adoc[opts=optional] @@ -850,7 +864,7 @@ a| [markdown] -- A JSON object containing the Search index definition. -- -a| <> +a| xref:GetIndexResponse[] @@ -883,7 +897,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -912,6 +926,10 @@ include::{snippetDir}g-api-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-index-name/operation-after.adoc[opts=optional] +//end::g-api-index-name[] + + +//tag::g-api-scoped-index[] // markup not found, no include::{specDir}paths/g-api-scoped-index/operation-before.adoc[opts=optional] @@ -1054,7 +1072,7 @@ a| [markdown] -- A JSON object containing all Search index definitions. -- -a| <> +a| xref:GetIndexesResponse[] @@ -1087,7 +1105,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -1116,6 +1134,10 @@ a| <> // markup not found, no include::{specDir}paths/g-api-scoped-index/operation-after.adoc[opts=optional] +//end::g-api-scoped-index[] + + +//tag::g-api-scoped-index-name[] // markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-before.adoc[opts=optional] @@ -1149,7 +1171,7 @@ GET /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME} [markdown] -- Returns the Search index definition for the Search index specified in the endpoint URL as a JSON object. -Unlike [Get Index Definition](#g-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -1277,7 +1299,7 @@ a| [markdown] -- A JSON object containing the Search index definition. -- -a| <> +a| xref:GetIndexResponse[] @@ -1310,7 +1332,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -1339,6 +1361,10 @@ include::{snippetDir}g-api-scoped-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-scoped-index-name/operation-after.adoc[opts=optional] +//end::g-api-scoped-index-name[] + + +//tag::p-api-index-name[] // markup not found, no include::{specDir}paths/p-api-index-name/operation-before.adoc[opts=optional] @@ -1462,7 +1488,7 @@ The full Search index definition. For a detailed list of all parameters for the [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinition[] @@ -1500,7 +1526,7 @@ a| [markdown] -- A JSON object indicating the status of the operation. -- -a| <> +a| xref:PutIndexResponse[] | 0 @@ -1541,7 +1567,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-write[] |=== @@ -1570,6 +1596,10 @@ include::{snippetDir}p-api-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/p-api-index-name/operation-after.adoc[opts=optional] +//end::p-api-index-name[] + + +//tag::p-api-scoped-index-name[] // markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-before.adoc[opts=optional] @@ -1604,7 +1634,7 @@ PUT /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME} -- If the Search index in the endpoint URL does not exist, this endpoint uses a JSON object in the request body to create a new index. If the Search index already exists, this endpoint updates the Search index definition. -Unlike [Create or Update an Index Definition](#p-api-index-name), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -1723,7 +1753,7 @@ The full Search index definition. For a detailed list of all parameters for the [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinition[] @@ -1761,7 +1791,7 @@ a| [markdown] -- A JSON object indicating the status of the operation. -- -a| <> +a| xref:PutIndexResponse[] | 0 @@ -1802,7 +1832,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-write[] |=== @@ -1831,6 +1861,8 @@ include::{snippetDir}p-api-scoped-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/p-api-scoped-index-name/operation-after.adoc[opts=optional] +//end::p-api-scoped-index-name[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1851,13 +1883,15 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> -<> +xref:p-api-idx-name-ingestcontrol[] +xref:p-api-idx-name-planfreezecontrol[] +xref:p-api-idx-name-querycontrol[] +xref:p-api-scoped-ingestcontrol[] +xref:p-api-scoped-planfreezecontrol[] +xref:p-api-scoped-querycontrol[] + +//tag::p-api-idx-name-ingestcontrol[] // markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-before.adoc[opts=optional] @@ -2009,7 +2043,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:MgmtResponse[] @@ -2042,7 +2076,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -2071,6 +2105,10 @@ include::{snippetDir}p-api-idx-name-ingestcontrol/http-response.adoc[opts=option // markup not found, no include::{specDir}paths/p-api-idx-name-ingestcontrol/operation-after.adoc[opts=optional] +//end::p-api-idx-name-ingestcontrol[] + + +//tag::p-api-idx-name-planfreezecontrol[] // markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-before.adoc[opts=optional] @@ -2222,7 +2260,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:MgmtResponse[] @@ -2255,7 +2293,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -2284,6 +2322,10 @@ include::{snippetDir}p-api-idx-name-planfreezecontrol/http-response.adoc[opts=op // markup not found, no include::{specDir}paths/p-api-idx-name-planfreezecontrol/operation-after.adoc[opts=optional] +//end::p-api-idx-name-planfreezecontrol[] + + +//tag::p-api-idx-name-querycontrol[] // markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-before.adoc[opts=optional] @@ -2435,7 +2477,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:MgmtResponse[] @@ -2468,7 +2510,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -2497,6 +2539,10 @@ include::{snippetDir}p-api-idx-name-querycontrol/http-response.adoc[opts=optiona // markup not found, no include::{specDir}paths/p-api-idx-name-querycontrol/operation-after.adoc[opts=optional] +//end::p-api-idx-name-querycontrol[] + + +//tag::p-api-scoped-ingestcontrol[] // markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-before.adoc[opts=optional] @@ -2531,7 +2577,7 @@ POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/ingestContr -- For the Search index specified in the endpoint URL, pause or resume index updates and maintenance. While paused, the Search index does not load any new document mutations. -Unlike [Set Index Ingestion Control](#p-api-idx-name-ingestcontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -2678,7 +2724,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:MgmtResponse[] @@ -2711,7 +2757,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -2740,6 +2786,10 @@ include::{snippetDir}p-api-scoped-ingestcontrol/http-response.adoc[opts=optional // markup not found, no include::{specDir}paths/p-api-scoped-ingestcontrol/operation-after.adoc[opts=optional] +//end::p-api-scoped-ingestcontrol[] + + +//tag::p-api-scoped-planfreezecontrol[] // markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-before.adoc[opts=optional] @@ -2774,7 +2824,7 @@ POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/planFreezeC -- For the Search index specified in the endpoint URL, freeze or unfreeze the assignment of index partitions to nodes. While frozen, the Search index stops assigning partitions during index rebalancing and index definition updates. -Unlike [Freeze Index Partition Assignment](#p-api-idx-name-planfreezecontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -2921,7 +2971,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:MgmtResponse[] @@ -2954,7 +3004,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -2983,6 +3033,10 @@ include::{snippetDir}p-api-scoped-planfreezecontrol/http-response.adoc[opts=opti // markup not found, no include::{specDir}paths/p-api-scoped-planfreezecontrol/operation-after.adoc[opts=optional] +//end::p-api-scoped-planfreezecontrol[] + + +//tag::p-api-scoped-querycontrol[] // markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-before.adoc[opts=optional] @@ -3017,7 +3071,7 @@ POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/queryContro -- For the Search index specified in the endpoint URL, disallow or allow queries. While queries are disallowed, users see an error that the Search index's partitions could not be reached. -Unlike [Stop Queries on an Index](#p-api-idx-name-querycontrol), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -3164,7 +3218,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:MgmtResponse[] @@ -3197,7 +3251,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -3226,6 +3280,8 @@ include::{snippetDir}p-api-scoped-querycontrol/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/p-api-scoped-querycontrol/operation-after.adoc[opts=optional] +//end::p-api-scoped-querycontrol[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -3246,12 +3302,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:g-api-scoped-status[] +xref:g-api-stats[] +xref:g-api-stats-index-name[] +xref:g-api-stats-index-name-analyzeDoc[] +//tag::g-api-scoped-status[] + // markup not found, no include::{specDir}paths/g-api-scoped-status/operation-before.adoc[opts=optional] @@ -3412,7 +3470,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:StatusResponse[] @@ -3445,7 +3503,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -3474,6 +3532,10 @@ include::{snippetDir}g-api-scoped-status/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-scoped-status/operation-after.adoc[opts=optional] +//end::g-api-scoped-status[] + + +//tag::g-api-stats[] // markup not found, no include::{specDir}paths/g-api-stats/operation-before.adoc[opts=optional] @@ -3559,7 +3621,7 @@ a| [markdown] -- A JSON object containing indexing and data metrics. -- -a| <> +a| xref:StatsNodeResponse[] @@ -3592,7 +3654,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-statistics[] |=== @@ -3621,6 +3683,10 @@ include::{snippetDir}g-api-stats/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-stats/operation-after.adoc[opts=optional] +//end::g-api-stats[] + + +//tag::g-api-stats-index-name[] // markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-before.adoc[opts=optional] @@ -3755,7 +3821,7 @@ a| [markdown] -- A JSON object containing statistics for the specified Search index. -- -a| <> +a| xref:StatsIndexResponse[] @@ -3788,7 +3854,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-statistics[] |=== @@ -3817,6 +3883,10 @@ include::{snippetDir}g-api-stats-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-stats-index-name/operation-after.adoc[opts=optional] +//end::g-api-stats-index-name[] + + +//tag::g-api-stats-index-name-analyzeDoc[] // markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-before.adoc[opts=optional] @@ -3940,7 +4010,7 @@ Add any valid JSON document to the request body. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Object[] @@ -3978,7 +4048,7 @@ a| [markdown] -- A JSON object containing the analysis of the provided document. -- -a| <> +a| xref:DocumentAnalysis[] @@ -4011,7 +4081,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-read[] |=== @@ -4040,6 +4110,8 @@ include::{snippetDir}g-api-stats-index-name-analyzeDoc/http-response.adoc[opts=o // markup not found, no include::{specDir}paths/g-api-stats-index-name-analyzeDoc/operation-after.adoc[opts=optional] +//end::g-api-stats-index-name-analyzeDoc[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -4060,12 +4132,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:g-api-index-name-count[] +xref:p-api-index-name-query[] +xref:p-api-pindex-lookup[] +xref:p-api-scoped-query[] +//tag::g-api-index-name-count[] + // markup not found, no include::{specDir}paths/g-api-index-name-count/operation-before.adoc[opts=optional] @@ -4197,7 +4271,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:DocumentCount[] @@ -4230,7 +4304,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-statistics[] |=== @@ -4259,6 +4333,10 @@ include::{snippetDir}g-api-index-name-count/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-index-name-count/operation-after.adoc[opts=optional] +//end::g-api-index-name-count[] + + +//tag::p-api-index-name-query[] // markup not found, no include::{specDir}paths/p-api-index-name-query/operation-before.adoc[opts=optional] @@ -4383,7 +4461,7 @@ A JSON object to define the settings for your Search query. For more information [%hardbreaks] {blank} -a¦ <> +a¦ xref:QueryRequest[] @@ -4421,7 +4499,7 @@ a| [markdown] -- The response object has a status section that must be checked for every request. Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. -- -a| <> +a| xref:QueryResponse[] @@ -4454,7 +4532,7 @@ include::{specDir}paths/p-api-index-name-query/operation-responses-after.adoc[op | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -4483,6 +4561,10 @@ include::{snippetDir}p-api-index-name-query/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/p-api-index-name-query/operation-after.adoc[opts=optional] +//end::p-api-index-name-query[] + + +//tag::p-api-pindex-lookup[] // markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-before.adoc[opts=optional] @@ -4636,7 +4718,7 @@ A valid JSON object that contains the docID property, with a value that matches [%hardbreaks] {blank} -a¦ <> +a¦ xref:LookupRequest[] @@ -4674,7 +4756,7 @@ a| [markdown] -- The Search Service returns a response that includes the status `ok`. -- -a| <> +a| xref:LookupResponse[] @@ -4707,7 +4789,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -4736,6 +4818,10 @@ include::{snippetDir}p-api-pindex-lookup/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/p-api-pindex-lookup/operation-after.adoc[opts=optional] +//end::p-api-pindex-lookup[] + + +//tag::p-api-scoped-query[] // markup not found, no include::{specDir}paths/p-api-scoped-query/operation-before.adoc[opts=optional] @@ -4770,7 +4856,7 @@ POST /api/bucket/{BUCKET_NAME}/scope/{SCOPE_NAME}/index/{INDEX_NAME}/query -- Run a query formatted as a JSON object against the Search index definition specified in the endpoint URL. The endpoint returns a JSON object as a response. -Unlike [Query a Search Index](#p-api-index-name-query), this endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. +This endpoint is scoped and does not require a fully qualified `{INDEX_NAME}` value. -- @@ -4890,7 +4976,7 @@ A JSON object to define the settings for your Search query. For more information [%hardbreaks] {blank} -a¦ <> +a¦ xref:QueryRequest[] @@ -4928,7 +5014,7 @@ a| [markdown] -- The response object has a status section that must be checked for every request. Under nearly all circumstances, the query response will be HTTP 200 even though individual index shards (partitions) may encounter a timeout or return an error. -- -a| <> +a| xref:QueryResponse[] | 0 @@ -4967,7 +5053,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-manage[] |=== @@ -4996,6 +5082,8 @@ include::{snippetDir}p-api-scoped-query/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/p-api-scoped-query/operation-after.adoc[opts=optional] +//end::p-api-scoped-query[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -5032,33 +5120,33 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:DeleteIndexResponse[] +xref:DocumentAnalysis[] +xref:DocumentAnalysisItem[] +xref:DocumentAnalysisItemToken[] +xref:DocumentAnalysisItemTokenLocation[] +xref:DocumentCount[] +xref:GetIndexResponse[] +xref:GetIndexResponsePIndex[] +xref:GetIndexResponsePIndexNodesWrapper[] +xref:GetIndexResponsePIndexNodesWrapperNode[] +xref:GetIndexesResponse[] +xref:GetIndexesResponseIndexes[] +xref:GetIndexesResponseIndexesWrapper[] +xref:IndexDefinition[] +xref:IndexDefinitionPlanParams[] +xref:LookupRequest[] +xref:LookupResponse[] +xref:LookupResponsePartitions[] +xref:LookupResponsePartitionsID[] +xref:MgmtResponse[] +xref:PutIndexResponse[] +xref:QueryRequest[] +xref:QueryResponse[] +xref:StatsIndexResponse[] +xref:StatsNodeResponse[] +xref:StatsNodeResponseMgr[] +xref:StatusResponse[] endif::[] @@ -5186,7 +5274,7 @@ An array of objects containing the analysis of the document. [%hardbreaks] {blank} -a¦ <> +a¦ xref:DocumentAnalysisItem[] array |=== @@ -5247,7 +5335,7 @@ include::index.adoc[tag=desc-DocumentAnalysisItemToken, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:DocumentAnalysisItemToken[] |=== @@ -5323,7 +5411,7 @@ An array of objects describing the locations of the search term or token in the [%hardbreaks] {blank} -a¦ <> +a¦ xref:DocumentAnalysisItemTokenLocation[] array |=== @@ -5570,7 +5658,7 @@ include::index.adoc[tag=desc-IndexDefinition, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinition[] a¦ @@ -5585,7 +5673,7 @@ An array of objects, each containing information about a single Search index par [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePIndex[] array a¦ @@ -5755,7 +5843,7 @@ include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePIndexNodesWrapper[] a¦ @@ -5909,7 +5997,7 @@ include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapperNode, opts=option [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePIndexNodesWrapperNode[] |=== @@ -6054,7 +6142,7 @@ include::index.adoc[tag=desc-GetIndexesResponseIndexes, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexesResponseIndexes[] a¦ @@ -6144,7 +6232,7 @@ include::index.adoc[tag=desc-GetIndexesResponseIndexesWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexesResponseIndexesWrapper[] a¦ @@ -6219,7 +6307,7 @@ include::index.adoc[tag=desc-IndexDefinition, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinition[] |=== @@ -6393,7 +6481,7 @@ include::index.adoc[tag=desc-IndexDefinitionPlanParams, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinitionPlanParams[] a¦ @@ -6687,7 +6775,7 @@ include::index.adoc[tag=desc-LookupResponsePartitions, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:LookupResponsePartitions[] |=== @@ -6748,7 +6836,7 @@ include::index.adoc[tag=desc-LookupResponsePartitionsID, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:LookupResponsePartitionsID[] |=== @@ -7436,7 +7524,7 @@ include::index.adoc[tag=desc-StatsNodeResponseMgr, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:StatsNodeResponseMgr[] a¦ diff --git a/docs/modules/fts-rest-indexing/search-index.gradle b/docs/modules/fts-rest-indexing/search-index.gradle index 6e9523df..787c91d2 100644 --- a/docs/modules/fts-rest-indexing/search-index.gradle +++ b/docs/modules/fts-rest-indexing/search-index.gradle @@ -5,7 +5,7 @@ openApiGenerate { remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/index/index.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-indexing/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" + gitRepoId = "cbft" gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/fts-rest-indexing/partials/", diff --git a/docs/modules/fts-rest-manage/pages/index.adoc b/docs/modules/fts-rest-manage/pages/index.adoc index 1232730f..938b06c4 100644 --- a/docs/modules/fts-rest-manage/pages/index.adoc +++ b/docs/modules/fts-rest-manage/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/cbft :leveloffset: 1 @@ -113,7 +113,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -131,9 +131,11 @@ endif::[] endif::[] [%hardbreaks] -<> +xref:put_options[] +//tag::put_options[] + // markup not found, no include::{specDir}paths/put_options/operation-before.adoc[opts=optional] @@ -224,7 +226,7 @@ An object specifying Search manager options. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Options[] @@ -262,7 +264,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Response[] | 401 @@ -270,7 +272,7 @@ a| [markdown] -- Failure to authenticate. The user name or password may be incorrect. -- -a| <> +a| xref:Response[] | 404 @@ -278,7 +280,7 @@ a| [markdown] -- Object not found. The URL may be incorrectly specified. -- -a| <> +a| xref:Response[] | 405 @@ -286,7 +288,7 @@ a| [markdown] -- Method not allowed. The method may be incorrectly specified. -- -a| <> +a| xref:Response[] @@ -319,7 +321,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -348,6 +350,8 @@ include::{snippetDir}put_options/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/put_options/operation-after.adoc[opts=optional] +//end::put_options[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -384,8 +388,8 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> +xref:Options[] +xref:Response[] endif::[] diff --git a/docs/modules/fts-rest-manage/search-manage.gradle b/docs/modules/fts-rest-manage/search-manage.gradle index 57b4d642..1aa16e38 100644 --- a/docs/modules/fts-rest-manage/search-manage.gradle +++ b/docs/modules/fts-rest-manage/search-manage.gradle @@ -5,7 +5,7 @@ openApiGenerate { remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/manage/manage.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-manage/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" + gitRepoId = "cbft" gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/fts-rest-manage/partials/", diff --git a/docs/modules/fts-rest-nodes/pages/index.adoc b/docs/modules/fts-rest-nodes/pages/index.adoc index b341bfbc..14317177 100644 --- a/docs/modules/fts-rest-nodes/pages/index.adoc +++ b/docs/modules/fts-rest-nodes/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/cbft :leveloffset: 1 @@ -113,10 +113,10 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> -<> -<> -<> +xref:tag-Configuration[] +xref:tag-Diagnostics[] +xref:tag-Management[] +xref:tag-Monitoring[] endif::[] @@ -134,12 +134,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:getClusterConfig[] +xref:managerKick[] +xref:managerMeta[] +xref:refreshClusterConfig[] +//tag::getClusterConfig[] + // markup not found, no include::{specDir}paths/getClusterConfig/operation-before.adoc[opts=optional] @@ -221,7 +223,7 @@ a| [markdown] -- A JSON object containing the node's configuration. -- -a| <> +a| xref:clusterConfig[] @@ -254,7 +256,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-readClusterSettings[] |=== @@ -283,6 +285,10 @@ include::{snippetDir}getClusterConfig/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/getClusterConfig/operation-after.adoc[opts=optional] +//end::getClusterConfig[] + + +//tag::managerKick[] // markup not found, no include::{specDir}paths/managerKick/operation-before.adoc[opts=optional] @@ -393,7 +399,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-writeClusterSettings[] |=== @@ -422,6 +428,10 @@ a| // markup not found, no include::{specDir}paths/managerKick/operation-after.adoc[opts=optional] +//end::managerKick[] + + +//tag::managerMeta[] // markup not found, no include::{specDir}paths/managerMeta/operation-before.adoc[opts=optional] @@ -538,7 +548,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-writeClusterSettings[] |=== @@ -567,6 +577,10 @@ a| Object // markup not found, no include::{specDir}paths/managerMeta/operation-after.adoc[opts=optional] +//end::managerMeta[] + + +//tag::refreshClusterConfig[] // markup not found, no include::{specDir}paths/refreshClusterConfig/operation-before.adoc[opts=optional] @@ -677,7 +691,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-writeClusterSettings[] |=== @@ -706,6 +720,8 @@ a| // markup not found, no include::{specDir}paths/refreshClusterConfig/operation-after.adoc[opts=optional] +//end::refreshClusterConfig[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -726,13 +742,15 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> -<> +xref:captureCpuProfile[] +xref:captureMemoryProfile[] +xref:getDiagnostics[] +xref:getLogs[] +xref:getRuntimeArgs[] +xref:getRuntimeInfo[] + +//tag::captureCpuProfile[] // markup not found, no include::{specDir}paths/captureCpuProfile/operation-before.adoc[opts=optional] @@ -843,7 +861,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-manageCluster[] |=== @@ -872,6 +890,10 @@ a| // markup not found, no include::{specDir}paths/captureCpuProfile/operation-after.adoc[opts=optional] +//end::captureCpuProfile[] + + +//tag::captureMemoryProfile[] // markup not found, no include::{specDir}paths/captureMemoryProfile/operation-before.adoc[opts=optional] @@ -982,7 +1004,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-manageCluster[] |=== @@ -1011,6 +1033,10 @@ a| // markup not found, no include::{specDir}paths/captureMemoryProfile/operation-after.adoc[opts=optional] +//end::captureMemoryProfile[] + + +//tag::getDiagnostics[] // markup not found, no include::{specDir}paths/getDiagnostics/operation-before.adoc[opts=optional] @@ -1139,7 +1165,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-readClusterLogs[] |=== @@ -1168,6 +1194,10 @@ a| Object // markup not found, no include::{specDir}paths/getDiagnostics/operation-after.adoc[opts=optional] +//end::getDiagnostics[] + + +//tag::getLogs[] // markup not found, no include::{specDir}paths/getLogs/operation-before.adoc[opts=optional] @@ -1250,7 +1280,7 @@ a| [markdown] -- A JSON object containing the node's logs. -- -a| <> +a| xref:logInfo[] @@ -1283,7 +1313,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-readClusterLogs[] |=== @@ -1312,6 +1342,10 @@ include::{snippetDir}getLogs/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/getLogs/operation-after.adoc[opts=optional] +//end::getLogs[] + + +//tag::getRuntimeArgs[] // markup not found, no include::{specDir}paths/getRuntimeArgs/operation-before.adoc[opts=optional] @@ -1427,7 +1461,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-readClusterSettings[] |=== @@ -1456,6 +1490,10 @@ a| Object // markup not found, no include::{specDir}paths/getRuntimeArgs/operation-after.adoc[opts=optional] +//end::getRuntimeArgs[] + + +//tag::getRuntimeInfo[] // markup not found, no include::{specDir}paths/getRuntimeInfo/operation-before.adoc[opts=optional] @@ -1538,7 +1576,7 @@ a| [markdown] -- A JSON object containing the node's runtime information. -- -a| <> +a| xref:runtimeInfo[] @@ -1571,7 +1609,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-readClusterSettings[] |=== @@ -1600,6 +1638,8 @@ include::{snippetDir}getRuntimeInfo/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/getRuntimeInfo/operation-after.adoc[opts=optional] +//end::getRuntimeInfo[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1620,9 +1660,11 @@ endif::[] endif::[] [%hardbreaks] -<> +xref:performGC[] +//tag::performGC[] + // markup not found, no include::{specDir}paths/performGC/operation-before.adoc[opts=optional] @@ -1732,7 +1774,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-manageCluster[] |=== @@ -1761,6 +1803,8 @@ a| // markup not found, no include::{specDir}paths/performGC/operation-after.adoc[opts=optional] +//end::performGC[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1781,9 +1825,11 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:getMemoryStats[] +xref:getRuntimeStats[] + +//tag::getMemoryStats[] // markup not found, no include::{specDir}paths/getMemoryStats/operation-before.adoc[opts=optional] @@ -1899,7 +1945,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-manageCluster[] |=== @@ -1928,6 +1974,10 @@ a| Object // markup not found, no include::{specDir}paths/getMemoryStats/operation-after.adoc[opts=optional] +//end::getMemoryStats[] + + +//tag::getRuntimeStats[] // markup not found, no include::{specDir}paths/getRuntimeStats/operation-before.adoc[opts=optional] @@ -2043,7 +2093,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-manageCluster[] |=== @@ -2072,6 +2122,8 @@ a| Object // markup not found, no include::{specDir}paths/getRuntimeStats/operation-after.adoc[opts=optional] +//end::getRuntimeStats[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -2108,25 +2160,25 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:clusterConfig[] +xref:clusterConfigIndexes[] +xref:clusterConfigNodesKnown[] +xref:clusterConfigNodesWanted[] +xref:clusterConfigNodesWrapper[] +xref:clusterConfigNodesWrapperNode[] +xref:clusterConfigPlan[] +xref:clusterConfigPlanWrapper[] +xref:GetIndexResponsePIndex[] +xref:GetIndexResponsePIndexNodesWrapper[] +xref:GetIndexResponsePIndexNodesWrapperNode[] +xref:GetIndexResponsePlanWrng[] +xref:GetIndexResponsePlanWrngIndex[] +xref:GetIndexesResponseIndexesWrapper[] +xref:IndexDefinition[] +xref:IndexDefinitionPlanParams[] +xref:logInfo[] +xref:runtimeInfo[] +xref:runtimeInfoGo[] endif::[] @@ -2167,7 +2219,7 @@ include::index.adoc[tag=desc-clusterConfigIndexes, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigIndexes[] a¦ @@ -2212,7 +2264,7 @@ include::index.adoc[tag=desc-clusterConfigNodesKnown, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigNodesKnown[] a¦ @@ -2257,7 +2309,7 @@ include::index.adoc[tag=desc-clusterConfigNodesWanted, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigNodesWanted[] a¦ @@ -2302,7 +2354,7 @@ include::index.adoc[tag=desc-clusterConfigPlan, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigPlan[] a¦ @@ -2422,7 +2474,7 @@ include::index.adoc[tag=desc-GetIndexesResponseIndexesWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexesResponseIndexesWrapper[] |=== @@ -2497,7 +2549,7 @@ include::index.adoc[tag=desc-clusterConfigNodesWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigNodesWrapper[] a¦ @@ -2586,7 +2638,7 @@ include::index.adoc[tag=desc-clusterConfigNodesWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigNodesWrapper[] a¦ @@ -2661,7 +2713,7 @@ include::index.adoc[tag=desc-clusterConfigNodesWrapperNode, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigNodesWrapperNode[] |=== @@ -2881,7 +2933,7 @@ include::index.adoc[tag=desc-clusterConfigPlanWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:clusterConfigPlanWrapper[] a¦ @@ -2910,7 +2962,7 @@ include::index.adoc[tag=desc-GetIndexResponsePlanWrng, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePlanWrng[] |=== @@ -2971,7 +3023,7 @@ include::index.adoc[tag=desc-GetIndexResponsePIndex, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePIndex[] |=== @@ -3111,7 +3163,7 @@ include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapper, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePIndexNodesWrapper[] a¦ @@ -3265,7 +3317,7 @@ include::index.adoc[tag=desc-GetIndexResponsePIndexNodesWrapperNode, opts=option [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePIndexNodesWrapperNode[] |=== @@ -3415,7 +3467,7 @@ include::index.adoc[tag=desc-GetIndexResponsePlanWrngIndex, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:GetIndexResponsePlanWrngIndex[] |=== @@ -3520,7 +3572,7 @@ include::index.adoc[tag=desc-IndexDefinition, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinition[] |=== @@ -3694,7 +3746,7 @@ include::index.adoc[tag=desc-IndexDefinitionPlanParams, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:IndexDefinitionPlanParams[] a¦ @@ -4001,7 +4053,7 @@ include::index.adoc[tag=desc-runtimeInfoGo, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:runtimeInfoGo[] a¦ diff --git a/docs/modules/fts-rest-nodes/search-nodes.gradle b/docs/modules/fts-rest-nodes/search-nodes.gradle index 8152998d..ea78bcfb 100644 --- a/docs/modules/fts-rest-nodes/search-nodes.gradle +++ b/docs/modules/fts-rest-nodes/search-nodes.gradle @@ -5,7 +5,7 @@ openApiGenerate { remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/nodes/nodes.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-nodes/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" + gitRepoId = "cbft" gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/fts-rest-nodes/partials/", diff --git a/docs/modules/fts-rest-query/pages/index.adoc b/docs/modules/fts-rest-query/pages/index.adoc index 9f8f15c0..37a2d5a7 100644 --- a/docs/modules/fts-rest-query/pages/index.adoc +++ b/docs/modules/fts-rest-query/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/cbft :leveloffset: 1 @@ -113,7 +113,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -131,11 +131,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> +xref:api-query[] +xref:api-query-cancel[] +xref:api-query-index[] +//tag::api-query[] + // markup not found, no include::{specDir}paths/api-query/operation-before.adoc[opts=optional] @@ -263,7 +265,7 @@ a| [markdown] -- A list of all active Search queries across all nodes in the cluster. -- -a| <> +a| xref:ActiveResponse[] @@ -296,7 +298,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -325,6 +327,10 @@ include::{snippetDir}api-query/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/api-query/operation-after.adoc[opts=optional] +//end::api-query[] + + +//tag::api-query-cancel[] // markup not found, no include::{specDir}paths/api-query-cancel/operation-before.adoc[opts=optional] @@ -443,7 +449,7 @@ The body contains the UUID of the node where the query is running. This is optio [%hardbreaks] {blank} -a¦ <> +a¦ xref:CancelRequest[] @@ -481,7 +487,7 @@ a| [markdown] -- The query was successfully canceled. -- -a| <> +a| xref:CancelResponse[] @@ -514,7 +520,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -543,6 +549,10 @@ include::{snippetDir}api-query-cancel/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/api-query-cancel/operation-after.adoc[opts=optional] +//end::api-query-cancel[] + + +//tag::api-query-index[] // markup not found, no include::{specDir}paths/api-query-index/operation-before.adoc[opts=optional] @@ -697,7 +707,7 @@ a| [markdown] -- A list of active queries for the specified Search index. -- -a| <> +a| xref:ActiveResponse[] @@ -730,7 +740,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -759,6 +769,8 @@ include::{snippetDir}api-query-index/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/api-query-index/operation-after.adoc[opts=optional] +//end::api-query-index[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -795,14 +807,14 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> +xref:ActiveResponse[] +xref:ActiveResponseFilter[] +xref:ActiveResponseFilterMap[] +xref:ActiveResponseFilterMapItem[] +xref:ActiveResponseFilterMapItemContext[] +xref:ActiveResponseStats[] +xref:CancelRequest[] +xref:CancelResponse[] endif::[] @@ -858,7 +870,7 @@ include::index.adoc[tag=desc-ActiveResponseStats, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ActiveResponseStats[] a¦ @@ -888,7 +900,7 @@ include::index.adoc[tag=desc-ActiveResponseFilter, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ActiveResponseFilter[] |=== @@ -996,7 +1008,7 @@ include::index.adoc[tag=desc-ActiveResponseFilterMap, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ActiveResponseFilterMap[] |=== @@ -1057,7 +1069,7 @@ include::index.adoc[tag=desc-ActiveResponseFilterMapItem, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ActiveResponseFilterMapItem[] |=== @@ -1119,7 +1131,7 @@ include::index.adoc[tag=desc-ActiveResponseFilterMapItemContext, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:ActiveResponseFilterMapItemContext[] a¦ diff --git a/docs/modules/fts-rest-query/search-query.gradle b/docs/modules/fts-rest-query/search-query.gradle index 9f25bcff..81bfe663 100644 --- a/docs/modules/fts-rest-query/search-query.gradle +++ b/docs/modules/fts-rest-query/search-query.gradle @@ -5,7 +5,7 @@ openApiGenerate { remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/query/query.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-query/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" + gitRepoId = "cbft" gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/fts-rest-query/partials/", diff --git a/docs/modules/fts-rest-stats/pages/index.adoc b/docs/modules/fts-rest-stats/pages/index.adoc index 1f530718..de3c867d 100644 --- a/docs/modules/fts-rest-stats/pages/index.adoc +++ b/docs/modules/fts-rest-stats/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/cbft :leveloffset: 1 @@ -113,7 +113,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -131,10 +131,12 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:g-api-nsstats[] +xref:g-api-nsstats-index-name[] +//tag::g-api-nsstats[] + // markup not found, no include::{specDir}paths/g-api-nsstats/operation-before.adoc[opts=optional] @@ -219,7 +221,7 @@ a| [markdown] -- The Search Service returns statistics from the `nsstats` endpoint for the entire cluster, and for each Search index. For each Search index, the names of the statistics are prefixed with the bucket name and index name, in the form `BUCKET:INDEX:statistic_name`. -- -a| <> +a| xref:allStats[] | 400 @@ -270,7 +272,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-admin[] |=== @@ -299,6 +301,10 @@ include::{snippetDir}g-api-nsstats/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-nsstats/operation-after.adoc[opts=optional] +//end::g-api-nsstats[] + + +//tag::g-api-nsstats-index-name[] // markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-before.adoc[opts=optional] @@ -433,7 +439,7 @@ a| [markdown] -- The Search Service returns statistics from the `nsstats` endpoint for the specified index. Note that for a single index, the names of the statistics are not prefixed with the bucket name or index name. -- -a| <> +a| xref:indexStats[] @@ -466,7 +472,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-statistics[] |=== @@ -495,6 +501,8 @@ include::{snippetDir}g-api-nsstats-index-name/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/g-api-nsstats-index-name/operation-after.adoc[opts=optional] +//end::g-api-nsstats-index-name[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -531,9 +539,9 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> +xref:allStats[] +xref:clusterStats[] +xref:indexStats[] endif::[] @@ -557,10 +565,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:clusterStats[] -* <> +* xref:indexStats[] diff --git a/docs/modules/fts-rest-stats/search-stats.gradle b/docs/modules/fts-rest-stats/search-stats.gradle index 6b3f03d6..1eea07f4 100644 --- a/docs/modules/fts-rest-stats/search-stats.gradle +++ b/docs/modules/fts-rest-stats/search-stats.gradle @@ -5,7 +5,7 @@ openApiGenerate { remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/stats/stats.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-stats/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" + gitRepoId = "cbft" gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/fts-rest-stats/partials/", diff --git a/docs/modules/index-rest-stats/pages/index.adoc b/docs/modules/index-rest-stats/pages/index.adoc index b29c1eac..21760917 100644 --- a/docs/modules/index-rest-stats/pages/index.adoc +++ b/docs/modules/index-rest-stats/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -113,7 +113,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -131,11 +131,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> +xref:get_index_stats[] +xref:get_keyspace_stats[] +xref:get_node_stats[] +//tag::get_index_stats[] + // markup not found, no include::{specDir}paths/get_index_stats/operation-before.adoc[opts=optional] @@ -366,7 +368,7 @@ a| [markdown] -- Success. Returns an object containing one nested `:` object. If the [partition](#get_index_stats-parameters) query parameter was set to `true`, the returned object also contains one or more `Partition-` objects — one for each index partition found on the specified node. -- -a| <> +a| xref:PartIdx[] | 404 @@ -405,7 +407,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-indexStatistics[] |=== @@ -434,6 +436,10 @@ include::{snippetDir}get_index_stats/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_index_stats/operation-after.adoc[opts=optional] +//end::get_index_stats[] + + +//tag::get_keyspace_stats[] // markup not found, no include::{specDir}paths/get_keyspace_stats/operation-before.adoc[opts=optional] @@ -630,7 +636,7 @@ a| [markdown] -- Success. Returns an object containing one or more nested `:` objects — one for each index found within the specified bucket, scope, or collection. -- -a| <> +a| xref:PartIdxIndexes[] | 404 @@ -669,7 +675,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-indexStatistics[] |=== @@ -698,6 +704,10 @@ include::{snippetDir}get_keyspace_stats/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_keyspace_stats/operation-after.adoc[opts=optional] +//end::get_keyspace_stats[] + + +//tag::get_node_stats[] // markup not found, no include::{specDir}paths/get_node_stats/operation-before.adoc[opts=optional] @@ -861,7 +871,7 @@ a| [markdown] -- Success. Returns an object containing a nested `indexer` object, and usually one or more nested `:` objects — one for each index found on the specified node. -- -a| <> +a| xref:NodeIdx[] @@ -894,9 +904,9 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-indexStatistics[] | http (basic) -| <> +| xref:security-nodeStatistics[] |=== @@ -925,6 +935,8 @@ include::{snippetDir}get_node_stats/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_node_stats/operation-after.adoc[opts=optional] +//end::get_node_stats[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -961,13 +973,13 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> +xref:NodeIdx[] +xref:NodeIdxNode[] +xref:NodeIdxNodeIndexer[] +xref:PartIdx[] +xref:PartIdxIndexes[] +xref:PartIdxPartitions[] +xref:PartIdxPartitionsIndex[] endif::[] @@ -991,10 +1003,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:NodeIdxNode[] -* <> +* xref:PartIdxIndexes[] @@ -1045,7 +1057,7 @@ include::index.adoc[tag=desc-NodeIdxNodeIndexer, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:NodeIdxNodeIndexer[] |=== @@ -1215,10 +1227,10 @@ endif::collapse-models[] All of the following: -* <> +* xref:PartIdxIndexes[] -* <> +* xref:PartIdxPartitions[] @@ -1269,7 +1281,7 @@ include::index.adoc[tag=desc-PartIdxPartitionsIndex, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:PartIdxPartitionsIndex[] |=== @@ -1325,7 +1337,7 @@ include::index.adoc[tag=desc-PartIdxPartitionsIndex, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:PartIdxPartitionsIndex[] |=== diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 6dc7f6c1..8bf08aaa 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,13 +114,13 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> +xref:tag-ActiveRequests[] +xref:tag-CompletedRequests[] +xref:tag-Configuration[] +xref:tag-Default[] +xref:tag-PreparedStatements[] +xref:tag-Settings[] +xref:tag-Statistics[] endif::[] @@ -138,12 +138,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:delete_active_request[] +xref:get_active_indexes[] +xref:get_active_request[] +xref:get_active_requests[] +//tag::delete_active_request[] + // markup not found, no include::{specDir}paths/delete_active_request/operation-before.adoc[opts=optional] @@ -310,7 +312,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -339,6 +341,10 @@ include::{snippetDir}delete_active_request/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/delete_active_request/operation-after.adoc[opts=optional] +//end::delete_active_request[] + + +//tag::get_active_indexes[] // markup not found, no include::{specDir}paths/get_active_indexes/operation-before.adoc[opts=optional] @@ -458,7 +464,7 @@ a| String | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -487,6 +493,10 @@ a| String // markup not found, no include::{specDir}paths/get_active_indexes/operation-after.adoc[opts=optional] +//end::get_active_indexes[] + + +//tag::get_active_request[] // markup not found, no include::{specDir}paths/get_active_request/operation-before.adoc[opts=optional] @@ -615,7 +625,7 @@ a| [markdown] -- An object containing information about the specified active request. -- -a| <> +a| xref:Requests[] @@ -648,7 +658,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -677,6 +687,10 @@ include::{snippetDir}get_active_request/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_active_request/operation-after.adoc[opts=optional] +//end::get_active_request[] + + +//tag::get_active_requests[] // markup not found, no include::{specDir}paths/get_active_requests/operation-before.adoc[opts=optional] @@ -760,7 +774,7 @@ a| [markdown] -- An array of objects, each of which contains information about one active request. -- -a| <> +a| xref:Requests[] array @@ -793,7 +807,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -822,6 +836,8 @@ include::{snippetDir}get_active_requests/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_active_requests/operation-after.adoc[opts=optional] +//end::get_active_requests[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -842,11 +858,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:delete_completed_request[] +xref:get_completed_indexes[] +xref:get_completed_request[] +xref:get_completed_requests[] + +//tag::delete_completed_request[] // markup not found, no include::{specDir}paths/delete_completed_request/operation-before.adoc[opts=optional] @@ -1014,7 +1032,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -1043,6 +1061,10 @@ include::{snippetDir}delete_completed_request/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/delete_completed_request/operation-after.adoc[opts=optional] +//end::delete_completed_request[] + + +//tag::get_completed_indexes[] // markup not found, no include::{specDir}paths/get_completed_indexes/operation-before.adoc[opts=optional] @@ -1162,7 +1184,7 @@ a| String | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -1191,6 +1213,10 @@ a| String // markup not found, no include::{specDir}paths/get_completed_indexes/operation-after.adoc[opts=optional] +//end::get_completed_indexes[] + + +//tag::get_completed_request[] // markup not found, no include::{specDir}paths/get_completed_request/operation-before.adoc[opts=optional] @@ -1319,7 +1345,7 @@ a| [markdown] -- An object containing information about the specified completed request. -- -a| <> +a| xref:Requests[] @@ -1352,7 +1378,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -1381,6 +1407,10 @@ include::{snippetDir}get_completed_request/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_completed_request/operation-after.adoc[opts=optional] +//end::get_completed_request[] + + +//tag::get_completed_requests[] // markup not found, no include::{specDir}paths/get_completed_requests/operation-before.adoc[opts=optional] @@ -1464,7 +1494,7 @@ a| [markdown] -- An array of objects, each of which contains information about one completed request. -- -a| <> +a| xref:Requests[] array @@ -1497,7 +1527,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -1526,6 +1556,8 @@ include::{snippetDir}get_completed_requests/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_completed_requests/operation-after.adoc[opts=optional] +//end::get_completed_requests[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1546,12 +1578,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> -<> +xref:get_cluster[] +xref:get_clusters[] +xref:get_config[] +xref:get_node[] +xref:get_nodes[] + +//tag::get_cluster[] // markup not found, no include::{specDir}paths/get_cluster/operation-before.adoc[opts=optional] @@ -1677,7 +1711,7 @@ a| [markdown] -- An object giving information about the specified cluster. -- -a| <> +a| xref:Clusters[] @@ -1710,7 +1744,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -1739,6 +1773,10 @@ a| <> // markup not found, no include::{specDir}paths/get_cluster/operation-after.adoc[opts=optional] +//end::get_cluster[] + + +//tag::get_clusters[] // markup not found, no include::{specDir}paths/get_clusters/operation-before.adoc[opts=optional] @@ -1821,7 +1859,7 @@ a| [markdown] -- An array of objects, each of which gives information about one cluster. -- -a| <> +a| xref:Clusters[] array @@ -1854,7 +1892,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -1883,6 +1921,10 @@ a| <> // markup not found, no include::{specDir}paths/get_clusters/operation-after.adoc[opts=optional] +//end::get_clusters[] + + +//tag::get_config[] // markup not found, no include::{specDir}paths/get_config/operation-before.adoc[opts=optional] @@ -1965,7 +2007,7 @@ a| [markdown] -- An object giving information about the specified node. -- -a| <> +a| xref:Nodes[] @@ -1998,7 +2040,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -2027,6 +2069,10 @@ a| <> // markup not found, no include::{specDir}paths/get_config/operation-after.adoc[opts=optional] +//end::get_config[] + + +//tag::get_node[] // markup not found, no include::{specDir}paths/get_node/operation-before.adoc[opts=optional] @@ -2169,7 +2215,7 @@ a| [markdown] -- An object giving information about the specified node. -- -a| <> +a| xref:Nodes[] @@ -2202,7 +2248,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -2231,6 +2277,10 @@ a| <> // markup not found, no include::{specDir}paths/get_node/operation-after.adoc[opts=optional] +//end::get_node[] + + +//tag::get_nodes[] // markup not found, no include::{specDir}paths/get_nodes/operation-before.adoc[opts=optional] @@ -2356,7 +2406,7 @@ a| [markdown] -- An array of objects, each of which gives information about one node. -- -a| <> +a| xref:Nodes[] array @@ -2389,7 +2439,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -2418,6 +2468,8 @@ a| <> // markup not found, no include::{specDir}paths/get_nodes/operation-after.adoc[opts=optional] +//end::get_nodes[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -2438,11 +2490,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> +xref:get_gc[] +xref:get_ping[] +xref:post_gc[] +//tag::get_gc[] + // markup not found, no include::{specDir}paths/get_gc/operation-before.adoc[opts=optional] @@ -2529,7 +2583,7 @@ a| [markdown] -- Indicates that the garbage collector was invoked. -- -a| <> +a| xref:Garbage[] | 401 @@ -2570,7 +2624,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -2599,6 +2653,10 @@ include::{snippetDir}get_gc/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_gc/operation-after.adoc[opts=optional] +//end::get_gc[] + + +//tag::get_ping[] // markup not found, no include::{specDir}paths/get_ping/operation-before.adoc[opts=optional] @@ -2724,6 +2782,10 @@ include::{snippetDir}get_ping/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_ping/operation-after.adoc[opts=optional] +//end::get_ping[] + + +//tag::post_gc[] // markup not found, no include::{specDir}paths/post_gc/operation-before.adoc[opts=optional] @@ -2811,7 +2873,7 @@ a| [markdown] -- Indicates that the garbage collector was invoked. -- -a| <> +a| xref:Garbage[] | 401 @@ -2852,7 +2914,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -2881,6 +2943,8 @@ include::{snippetDir}post_gc/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_gc/operation-after.adoc[opts=optional] +//end::post_gc[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -2901,11 +2965,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:delete_prepared[] +xref:get_prepared[] +xref:get_prepared_indexes[] +xref:get_prepareds[] + +//tag::delete_prepared[] // markup not found, no include::{specDir}paths/delete_prepared/operation-before.adoc[opts=optional] @@ -3073,7 +3139,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -3102,6 +3168,10 @@ include::{snippetDir}delete_prepared/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/delete_prepared/operation-after.adoc[opts=optional] +//end::delete_prepared[] + + +//tag::get_prepared[] // markup not found, no include::{specDir}paths/get_prepared/operation-before.adoc[opts=optional] @@ -3230,7 +3300,7 @@ a| [markdown] -- An object containing information about the specified prepared statement. -- -a| <> +a| xref:Statements[] @@ -3263,7 +3333,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -3292,6 +3362,10 @@ include::{snippetDir}get_prepared/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_prepared/operation-after.adoc[opts=optional] +//end::get_prepared[] + + +//tag::get_prepared_indexes[] // markup not found, no include::{specDir}paths/get_prepared_indexes/operation-before.adoc[opts=optional] @@ -3411,7 +3485,7 @@ a| String | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -3440,6 +3514,10 @@ a| String // markup not found, no include::{specDir}paths/get_prepared_indexes/operation-after.adoc[opts=optional] +//end::get_prepared_indexes[] + + +//tag::get_prepareds[] // markup not found, no include::{specDir}paths/get_prepareds/operation-before.adoc[opts=optional] @@ -3523,7 +3601,7 @@ a| [markdown] -- An array of objects, each of which contains information about one prepared statement. -- -a| <> +a| xref:Statements[] array @@ -3556,7 +3634,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -3585,6 +3663,8 @@ include::{snippetDir}get_prepareds/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_prepareds/operation-after.adoc[opts=optional] +//end::get_prepareds[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -3605,9 +3685,11 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:get_settings[] +xref:post_settings[] + +//tag::get_settings[] // markup not found, no include::{specDir}paths/get_settings/operation-before.adoc[opts=optional] @@ -3691,7 +3773,7 @@ a| [markdown] -- An object giving node-level query settings. -- -a| <> +a| xref:Settings[] @@ -3724,7 +3806,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -3753,6 +3835,10 @@ a| <> // markup not found, no include::{specDir}paths/get_settings/operation-after.adoc[opts=optional] +//end::get_settings[] + + +//tag::post_settings[] // markup not found, no include::{specDir}paths/post_settings/operation-before.adoc[opts=optional] @@ -3845,7 +3931,7 @@ An object specifying node-level query settings. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Settings[] @@ -3883,7 +3969,7 @@ a| [markdown] -- An object giving node-level query settings, including the latest changes. -- -a| <> +a| xref:Settings[] @@ -3916,7 +4002,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -3945,6 +4031,8 @@ a| <> // markup not found, no include::{specDir}paths/post_settings/operation-after.adoc[opts=optional] +//end::post_settings[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -3965,11 +4053,13 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:get_debug_vars[] +xref:get_stat[] +xref:get_stats[] +xref:get_vitals[] + +//tag::get_debug_vars[] // markup not found, no include::{specDir}paths/get_debug_vars/operation-before.adoc[opts=optional] @@ -4095,6 +4185,10 @@ include::{snippetDir}get_debug_vars/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_debug_vars/operation-after.adoc[opts=optional] +//end::get_debug_vars[] + + +//tag::get_stat[] // markup not found, no include::{specDir}paths/get_stat/operation-before.adoc[opts=optional] @@ -4224,7 +4318,7 @@ a| [markdown] -- An object containing all metrics for the specified statistic. Each statistic has a different set of metrics. -- -a| <> +a| xref:Metrics[] @@ -4257,7 +4351,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -4286,6 +4380,10 @@ a| <> // markup not found, no include::{specDir}paths/get_stat/operation-after.adoc[opts=optional] +//end::get_stat[] + + +//tag::get_stats[] // markup not found, no include::{specDir}paths/get_stats/operation-before.adoc[opts=optional] @@ -4368,7 +4466,7 @@ a| [markdown] -- An object containing all statistics. Each statistic consists of a top-level statistic name and a metric name. Each statistic has a different set of metrics. -- -a| <> +a| xref:Statistics[] @@ -4401,7 +4499,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -4430,6 +4528,10 @@ a| <> // markup not found, no include::{specDir}paths/get_stats/operation-after.adoc[opts=optional] +//end::get_stats[] + + +//tag::get_vitals[] // markup not found, no include::{specDir}paths/get_vitals/operation-before.adoc[opts=optional] @@ -4514,7 +4616,7 @@ a| [markdown] -- An object containing all vital statistics. -- -a| <> +a| xref:Vitals[] @@ -4547,7 +4649,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -4576,6 +4678,8 @@ include::{snippetDir}get_vitals/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_vitals/operation-after.adoc[opts=optional] +//end::get_vitals[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -4612,18 +4716,18 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> -<> +xref:Clusters[] +xref:Garbage[] +xref:Logging_Parameters[] +xref:Logging_Parameters_Plan[] +xref:Logging_Parameters_Plan_Pairs[] +xref:Metrics[] +xref:Nodes[] +xref:Requests[] +xref:Settings[] +xref:Statements[] +xref:Statistics[] +xref:Vitals[] endif::[] @@ -5040,7 +5144,7 @@ include::index.adoc[tag=desc-Logging_Parameters_Plan, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Logging_Parameters_Plan[] a¦ @@ -5098,10 +5202,10 @@ endif::collapse-models[] One of the following: -* <> +* xref:Logging_Parameters_Plan_Pairs[] -* <> +* xref:Logging_Parameters_Plan_Pairs[] array @@ -6255,7 +6359,7 @@ include::index.adoc[tag=desc-Logging_Parameters, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Logging_Parameters[] a¦ [#completed-limit] diff --git a/docs/modules/n1ql-rest-functions/pages/index.adoc b/docs/modules/n1ql-rest-functions/pages/index.adoc index 7c9eb187..f7ddd5b7 100644 --- a/docs/modules/n1ql-rest-functions/pages/index.adoc +++ b/docs/modules/n1ql-rest-functions/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -113,7 +113,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -131,12 +131,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:delete_library[] +xref:get_collection[] +xref:get_library[] +xref:post_library[] +//tag::delete_library[] + // markup not found, no include::{specDir}paths/delete_library/operation-before.adoc[opts=optional] @@ -350,9 +352,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scope[] | http (basic) -| <> +| xref:security-global[] |=== @@ -381,6 +383,10 @@ include::{snippetDir}delete_library/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/delete_library/operation-after.adoc[opts=optional] +//end::delete_library[] + + +//tag::get_collection[] // markup not found, no include::{specDir}paths/get_collection/operation-before.adoc[opts=optional] @@ -528,7 +534,7 @@ a| [markdown] -- An array of objects, each giving information about a single library. -- -a| <> +a| xref:Libraries[] array | 400 @@ -567,9 +573,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scope[] | http (basic) -| <> +| xref:security-global[] |=== @@ -598,6 +604,10 @@ include::{snippetDir}get_collection/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_collection/operation-after.adoc[opts=optional] +//end::get_collection[] + + +//tag::get_library[] // markup not found, no include::{specDir}paths/get_library/operation-before.adoc[opts=optional] @@ -771,7 +781,7 @@ a| [markdown] -- An object with a single property, giving information about the specified library. -- -a| <> +a| xref:Functions[] | 400 @@ -816,9 +826,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scope[] | http (basic) -| <> +| xref:security-global[] |=== @@ -847,6 +857,10 @@ include::{snippetDir}get_library/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_library/operation-after.adoc[opts=optional] +//end::get_library[] + + +//tag::post_library[] // markup not found, no include::{specDir}paths/post_library/operation-before.adoc[opts=optional] @@ -1089,9 +1103,9 @@ a| | Type | Name | http (basic) -| <> +| xref:security-scope[] | http (basic) -| <> +| xref:security-global[] |=== @@ -1120,6 +1134,8 @@ include::{snippetDir}post_library/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_library/operation-after.adoc[opts=optional] +//end::post_library[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -1156,8 +1172,8 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> +xref:Functions[] +xref:Libraries[] endif::[] diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 3d0ac451..585b9325 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -114,7 +114,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -132,10 +132,12 @@ endif::[] endif::[] [%hardbreaks] -<> -<> +xref:get_service[] +xref:post_service[] +//tag::get_service[] + // markup not found, no include::{specDir}paths/get_service/operation-before.adoc[opts=optional] @@ -223,7 +225,7 @@ The format for URL-encoded parameters is consistent with the syntax for variable [%hardbreaks] {blank} -a¦ <> +a¦ xref:Request[] @@ -264,7 +266,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Response[] | 400 @@ -357,7 +359,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-header[] |=== @@ -386,6 +388,10 @@ include::{snippetDir}get_service/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_service/operation-after.adoc[opts=optional] +//end::get_service[] + + +//tag::post_service[] // markup not found, no include::{specDir}paths/post_service/operation-before.adoc[opts=optional] @@ -478,7 +484,7 @@ An object specifying one or more query parameters. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Request[] @@ -516,7 +522,7 @@ a| [markdown] -- The operation was successful. -- -a| <> +a| xref:Response[] | 400 @@ -609,7 +615,7 @@ a| | Type | Name | http (basic) -| <> +| xref:security-header[] |=== @@ -638,6 +644,8 @@ include::{snippetDir}post_service/http-request.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_service/operation-after.adoc[opts=optional] +//end::post_service[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -674,14 +682,14 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> -<> -<> -<> -<> -<> -<> +xref:Conditions[] +xref:Controls[] +xref:Execution_Timings[] +xref:Metrics[] +xref:Profile[] +xref:Request[] +xref:Response[] +xref:Statistics[] endif::[] @@ -987,7 +995,7 @@ include::index.adoc[tag=desc-Statistics, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Statistics[] a¦ @@ -1356,7 +1364,7 @@ include::index.adoc[tag=desc-Execution_Timings, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Execution_Timings[] a¦ @@ -2718,7 +2726,7 @@ An array of 0 or more error objects. If an error occurred during processing of t [%hardbreaks] {blank} -a¦ <> +a¦ xref:Conditions[] array a¦ @@ -2734,7 +2742,7 @@ An array of 0 or more warning objects. If a warning occurred during processing o [%hardbreaks] {blank} -a¦ <> +a¦ xref:Conditions[] array a¦ @@ -2749,7 +2757,7 @@ include::index.adoc[tag=desc-Metrics, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Metrics[] a¦ @@ -2764,7 +2772,7 @@ include::index.adoc[tag=desc-Controls, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Controls[] a¦ @@ -2779,7 +2787,7 @@ include::index.adoc[tag=desc-Profile, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Profile[] |=== diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index f3797b99..d5f34eaa 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbase/cb-swagger +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger :leveloffset: 1 @@ -113,7 +113,7 @@ ifeval::[{count-apis} > 1] The operations are grouped in the following categories. [%hardbreaks] -<> +xref:tag-Default[] endif::[] @@ -131,12 +131,14 @@ endif::[] endif::[] [%hardbreaks] -<> -<> -<> -<> +xref:get_access[] +xref:get_settings[] +xref:post_access[] +xref:post_settings[] +//tag::get_access[] + // markup not found, no include::{specDir}paths/get_access/operation-before.adoc[opts=optional] @@ -218,7 +220,7 @@ a| [markdown] -- An object determining which URLs may be accessed by the `CURL()` function. -- -a| <> +a| xref:Access[] @@ -251,7 +253,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -280,6 +282,10 @@ include::{snippetDir}get_access/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_access/operation-after.adoc[opts=optional] +//end::get_access[] + + +//tag::get_settings[] // markup not found, no include::{specDir}paths/get_settings/operation-before.adoc[opts=optional] @@ -362,7 +368,7 @@ a| [markdown] -- An object giving cluster-level query settings. -- -a| <> +a| xref:Settings[] @@ -395,7 +401,7 @@ a| <> | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -424,6 +430,10 @@ include::{snippetDir}get_settings/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/get_settings/operation-after.adoc[opts=optional] +//end::get_settings[] + + +//tag::post_access[] // markup not found, no include::{specDir}paths/post_access/operation-before.adoc[opts=optional] @@ -515,7 +525,7 @@ An object determining which URLs may be accessed by the `CURL()` function. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Access[] @@ -553,7 +563,7 @@ a| [markdown] -- An object determining which URLs may be accessed by the `CURL()` function, including the latest changes. -- -a| <> +a| xref:Access[] | 400 @@ -594,7 +604,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -623,6 +633,10 @@ include::{snippetDir}post_access/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_access/operation-after.adoc[opts=optional] +//end::post_access[] + + +//tag::post_settings[] // markup not found, no include::{specDir}paths/post_settings/operation-before.adoc[opts=optional] @@ -714,7 +728,7 @@ An object specifying cluster-level query settings. [%hardbreaks] {blank} -a¦ <> +a¦ xref:Settings[] @@ -752,7 +766,7 @@ a| [markdown] -- An object giving cluster-level query settings, including the latest changes. -- -a| <> +a| xref:Settings[] | 400 @@ -793,7 +807,7 @@ a| Object | Type | Name | http (basic) -| <> +| xref:security-default[] |=== @@ -822,6 +836,8 @@ include::{snippetDir}post_settings/http-response.adoc[opts=optional] // markup not found, no include::{specDir}paths/post_settings/operation-after.adoc[opts=optional] +//end::post_settings[] + ifeval::[{count-apis} > 1] :leveloffset: -1 @@ -858,8 +874,8 @@ ifdef::collapse-models[] [.two-columns] endif::collapse-models[] [%hardbreaks] -<> -<> +xref:Access[] +xref:Settings[] endif::[] @@ -1865,7 +1881,7 @@ include::index.adoc[tag=desc-Access, opts=optional] [%hardbreaks] {blank} -a¦ <> +a¦ xref:Access[] |=== diff --git a/src/admin/admin.gradle b/src/admin/admin.gradle index e124e252..33bca101 100644 --- a/src/admin/admin.gradle +++ b/src/admin/admin.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/n1ql-rest-admin/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-admin/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-admin/partials/paths/", diff --git a/src/analytics-admin/analytics-admin.gradle b/src/analytics-admin/analytics-admin.gradle index 84a3d4b5..73791c03 100644 --- a/src/analytics-admin/analytics-admin.gradle +++ b/src/analytics-admin/analytics-admin.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/analytics-rest-admin/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/analytics-rest-admin/partials/", snippetDir: "${rootDir}/docs/modules/analytics-rest-admin/partials/paths/", diff --git a/src/analytics-config/analytics-config.gradle b/src/analytics-config/analytics-config.gradle index 8a0d47e5..6c8a56d9 100644 --- a/src/analytics-config/analytics-config.gradle +++ b/src/analytics-config/analytics-config.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/analytics-rest-config/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/analytics-rest-config/partials/", snippetDir: "${rootDir}/docs/modules/analytics-rest-config/partials/paths/", diff --git a/src/analytics-library/analytics-library.gradle b/src/analytics-library/analytics-library.gradle index e5404bc7..d6d715db 100644 --- a/src/analytics-library/analytics-library.gradle +++ b/src/analytics-library/analytics-library.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/analytics-rest-library/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/analytics-rest-library/partials/", snippetDir: "${rootDir}/docs/modules/analytics-rest-library/partials/paths/", diff --git a/src/analytics-links/analytics-links.gradle b/src/analytics-links/analytics-links.gradle index 47f7ba3e..38fd331a 100644 --- a/src/analytics-links/analytics-links.gradle +++ b/src/analytics-links/analytics-links.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/analytics-rest-links/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/analytics-rest-links/partials/", snippetDir: "${rootDir}/docs/modules/analytics-rest-links/partials/paths/", diff --git a/src/analytics-service/analytics-service.gradle b/src/analytics-service/analytics-service.gradle index 2ad5a3ac..49e3ed15 100644 --- a/src/analytics-service/analytics-service.gradle +++ b/src/analytics-service/analytics-service.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/analytics-rest-service/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/analytics-rest-service/partials/", snippetDir: "${rootDir}/docs/modules/analytics-rest-service/partials/paths/", diff --git a/src/analytics-settings/analytics-settings.gradle b/src/analytics-settings/analytics-settings.gradle index 338f827a..fcec26c5 100644 --- a/src/analytics-settings/analytics-settings.gradle +++ b/src/analytics-settings/analytics-settings.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/analytics-rest-settings/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/analytics-rest-settings/partials/", snippetDir: "${rootDir}/docs/modules/analytics-rest-settings/partials/paths/", diff --git a/src/eventing/eventing.gradle b/src/eventing/eventing.gradle index 7485829a..a543d27f 100644 --- a/src/eventing/eventing.gradle +++ b/src/eventing/eventing.gradle @@ -29,7 +29,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/eventing-rest-api/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/eventing-rest-api/partials/", snippetDir: "${rootDir}/docs/modules/eventing-rest-api/partials/paths/", diff --git a/src/functions/functions.gradle b/src/functions/functions.gradle index 29ed41c8..05055b6d 100644 --- a/src/functions/functions.gradle +++ b/src/functions/functions.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/n1ql-rest-functions/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-functions/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-functions/partials/paths/", diff --git a/src/indexes/indexes.gradle b/src/indexes/indexes.gradle index 308f2481..9b64006a 100644 --- a/src/indexes/indexes.gradle +++ b/src/indexes/indexes.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/index-rest-stats/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/index-rest-stats/partials/", snippetDir: "${rootDir}/docs/modules/index-rest-stats/partials/paths/", diff --git a/src/query-service/query-service.gradle b/src/query-service/query-service.gradle index 79acb27c..585e8a1c 100644 --- a/src/query-service/query-service.gradle +++ b/src/query-service/query-service.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/n1ql-rest-query/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-query/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-query/partials/paths/", diff --git a/src/query-settings/query-settings.gradle b/src/query-settings/query-settings.gradle index 2bcf8ac5..14e42f8d 100644 --- a/src/query-settings/query-settings.gradle +++ b/src/query-settings/query-settings.gradle @@ -6,7 +6,7 @@ openApiGenerate { outputDir = "${rootDir}/docs/modules/n1ql-rest-settings/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" - gitUserId = "couchbase" + gitUserId = "couchbaselabs" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-settings/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-settings/partials/paths/", diff --git a/templates/index.mustache b/templates/index.mustache index 46937009..50122d05 100644 --- a/templates/index.mustache +++ b/templates/index.mustache @@ -118,7 +118,7 @@ The operations are grouped in the following categories. [%hardbreaks] {{#apiInfo}} {{#apis}} -<> +xref:tag-{{baseName}}[] {{/apis}} {{/apiInfo}} endif::[] @@ -145,12 +145,14 @@ endif::[] {{! Table of contents for operations }} [%hardbreaks] {{#operation}} -<<{{operationIdOriginal}}>> +xref:{{operationIdOriginal}}[] {{/operation}} {{! Operation body }} {{#operation}} +//tag::{{operationIdOriginal}}[] + {{! include partial before operation }} {{#specinclude}}/paths/{{operationIdOriginal}}/operation-before.adoc{{/specinclude}} @@ -334,7 +336,7 @@ a| {{#returnProperty}}{{>schemas}}{{/returnProperty}} {{! Iterate through operation security }} {{#authMethods}} | {{type}}{{#scheme}} ({{scheme}}){{/scheme}} -| <> +| xref:security-{{#lambda.camelcase}}{{name}}{{/lambda.camelcase}}[] {{/authMethods}} {{! If there is operation security: table footer }} @@ -364,6 +366,8 @@ a| {{#returnProperty}}{{>schemas}}{{/returnProperty}} {{! include partials after the operation }} {{#specinclude}}/paths/{{operationIdOriginal}}/operation-after.adoc{{/specinclude}} +//end::{{operationIdOriginal}}[] + {{/operation}} {{/operations}} diff --git a/templates/model.mustache b/templates/model.mustache index 3f453e4d..847d5c67 100644 --- a/templates/model.mustache +++ b/templates/model.mustache @@ -54,7 +54,7 @@ This schema has alternative properties, depending on the value of *{{discriminat a| `{{mappingName}}` a| {{{model.unescapedDescription}}} -a| <<{{modelName}}>> +a| xref:{{modelName}}[] {{/mappedModels}} |=== {{/discriminator}} diff --git a/templates/models.mustache b/templates/models.mustache index e7de79fa..b2e76b4d 100644 --- a/templates/models.mustache +++ b/templates/models.mustache @@ -32,7 +32,7 @@ endif::collapse-models[] {{#isEnum}} ifdef::enum-definitions[] {{/isEnum}} -<<{{name}}>> +xref:{{name}}[] {{#isEnum}} endif::enum-definitions[] {{/isEnum}} diff --git a/templates/schema.mustache b/templates/schema.mustache index 862d8123..c1c83eab 100644 --- a/templates/schema.mustache +++ b/templates/schema.mustache @@ -1,18 +1,18 @@ {{! If this has a reference, create a link to that object; }} {{#ref}} -<<{{dataType}}>> +xref:{{dataType}}[] {{/ref}} {{! ... if it has no reference, then: }} {{^ref}} {{! ... if it's a model, create a link to that object; }} {{#isModel}} -<<{{dataType}}>> +xref:{{dataType}}[] {{/isModel}} {{! ... if it's not a model, then: }} {{^isModel}} {{! ... if it's a map, create a link to that object; }} {{#isMap}} -<<{{dataType}}>> +xref:{{dataType}}[] {{/isMap}} {{! ... if it isn't a map, then: }} {{^isMap}} From ef340f90f95b2bf373f72dca3e870e7db6f6f913 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Wed, 9 Jul 2025 22:35:17 +0100 Subject: [PATCH 12/25] AV-102698: Add passthroughs to Data API documentation (#172) * Add query examples * Update Base URLs and credentials * Add additional property name * Minor nits * Build output documentation --------- Co-authored-by: tech-comm-team-couchbase --- .../n1ql-rest-query/examples/exformdata.sh | 3 + .../n1ql-rest-query/examples/exn1qlerror.json | 18 ++++++ .../n1ql-rest-query/examples/exnamed.json | 25 ++++++++ .../n1ql-rest-query/examples/exnamed.sh | 5 ++ .../n1ql-rest-query/examples/exnotfound.json | 18 ++++++ .../n1ql-rest-query/examples/exnumbered.json | 25 ++++++++ .../n1ql-rest-query/examples/exnumbered.sh | 5 ++ .../examples/expositional.json | 25 ++++++++ .../n1ql-rest-query/examples/expositional.sh | 5 ++ .../n1ql-rest-query/examples/exreadonly.sh | 2 + .../examples/exrequesterror.json | 18 ++++++ .../examples/exserviceerror.json | 19 +++++++ .../examples/exsuccessful.json | 19 +++++++ .../n1ql-rest-query/examples/exsuccessful.sh | 4 ++ .../n1ql-rest-query/examples/exwildcard.json | 22 +++++++ .../n1ql-rest-query/examples/exwildcard.sh | 6 ++ docs/modules/n1ql-rest-query/pages/index.adoc | 28 ++++++--- src/query-service/swagger/query-service.yaml | 57 ++++++++++++++++++- 18 files changed, 293 insertions(+), 11 deletions(-) create mode 100644 docs/modules/n1ql-rest-query/examples/exformdata.sh create mode 100644 docs/modules/n1ql-rest-query/examples/exn1qlerror.json create mode 100644 docs/modules/n1ql-rest-query/examples/exnamed.json create mode 100644 docs/modules/n1ql-rest-query/examples/exnamed.sh create mode 100644 docs/modules/n1ql-rest-query/examples/exnotfound.json create mode 100644 docs/modules/n1ql-rest-query/examples/exnumbered.json create mode 100644 docs/modules/n1ql-rest-query/examples/exnumbered.sh create mode 100644 docs/modules/n1ql-rest-query/examples/expositional.json create mode 100644 docs/modules/n1ql-rest-query/examples/expositional.sh create mode 100644 docs/modules/n1ql-rest-query/examples/exreadonly.sh create mode 100644 docs/modules/n1ql-rest-query/examples/exrequesterror.json create mode 100644 docs/modules/n1ql-rest-query/examples/exserviceerror.json create mode 100644 docs/modules/n1ql-rest-query/examples/exsuccessful.json create mode 100644 docs/modules/n1ql-rest-query/examples/exsuccessful.sh create mode 100644 docs/modules/n1ql-rest-query/examples/exwildcard.json create mode 100644 docs/modules/n1ql-rest-query/examples/exwildcard.sh diff --git a/docs/modules/n1ql-rest-query/examples/exformdata.sh b/docs/modules/n1ql-rest-query/examples/exformdata.sh new file mode 100644 index 00000000..d850e646 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exformdata.sh @@ -0,0 +1,3 @@ +curl -v $BASEURL/_p/query/query/service \ + -d 'statement=SELECT name FROM `travel-sample`.inventory.hotel LIMIT 1' \ + -u $USER:$PASSWORD \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exn1qlerror.json b/docs/modules/n1ql-rest-query/examples/exn1qlerror.json new file mode 100644 index 00000000..fe4d4b6e --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exn1qlerror.json @@ -0,0 +1,18 @@ +{ + "requestID": "27087759-07af-431d-a3d7-29080f870e56", + "errors": [ + { + "code": 3000, + "msg": "syntax error - line 1, column 7, near 'SLECT', at: name" + } + ], + "status": "fatal", + "metrics": { + "elapsedTime": "1.478631ms", + "executionTime": "1.393274ms", + "resultCount": 0, + "resultSize": 0, + "serviceLoad": 12, + "errorCount": 1 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exnamed.json b/docs/modules/n1ql-rest-query/examples/exnamed.json new file mode 100644 index 00000000..0389aef5 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exnamed.json @@ -0,0 +1,25 @@ +{ + "requestID": "81aceab8-7f7a-4d00-b741-00385740329a", + "signature": { + "airline": "json" + }, + "results": [ + { + "airline": "B6" + }, + { + "airline": "EK" + }, + { + "airline": "SV" + } + ], + "status": "success", + "metrics": { + "elapsedTime": "72.886709ms", + "executionTime": "72.765333ms", + "resultCount": 3, + "resultSize": 48, + "serviceLoad": 12 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exnamed.sh b/docs/modules/n1ql-rest-query/examples/exnamed.sh new file mode 100644 index 00000000..35527eb3 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exnamed.sh @@ -0,0 +1,5 @@ +curl -v $BASEURL/_p/query/query/service \ + -d 'statement=SELECT airline FROM `travel-sample`.inventory.route + WHERE sourceairport = $aval AND distance > $dval + & $aval="LAX" & $dval=13000' \ + -u $USER:$PASSWORD \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exnotfound.json b/docs/modules/n1ql-rest-query/examples/exnotfound.json new file mode 100644 index 00000000..882dd6f3 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exnotfound.json @@ -0,0 +1,18 @@ +{ + "requestID": "d30b805f-6c1e-44ec-9aec-35ff711a6e88", + "errors": [ + { + "code": 12003, + "msg": "Keyspace not found in CB datastore: default:travel-sample.inventory.motel" + } + ], + "status": "fatal", + "metrics": { + "elapsedTime": "3.096786ms", + "executionTime": "2.468282ms", + "resultCount": 0, + "resultSize": 0, + "serviceLoad": 12, + "errorCount": 1 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exnumbered.json b/docs/modules/n1ql-rest-query/examples/exnumbered.json new file mode 100644 index 00000000..3cb9994e --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exnumbered.json @@ -0,0 +1,25 @@ +{ + "requestID": "6e242629-ebf5-4a58-8db4-62d94974519f", + "signature": { + "airline": "json" + }, + "results": [ + { + "airline": "B6" + }, + { + "airline": "EK" + }, + { + "airline": "SV" + } + ], + "status": "success", + "metrics": { + "elapsedTime": "86.962678ms", + "executionTime": "84.35715ms", + "resultCount": 3, + "resultSize": 48, + "serviceLoad": 12 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exnumbered.sh b/docs/modules/n1ql-rest-query/examples/exnumbered.sh new file mode 100644 index 00000000..c9888c99 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exnumbered.sh @@ -0,0 +1,5 @@ +curl -v $BASEURL/_p/query/query/service \ + -d 'statement=SELECT airline FROM `travel-sample`.inventory.route + WHERE sourceairport = $1 AND distance > $2 + & args=["LAX", 13000]' \ + -u $USER:$PASSWORD \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/expositional.json b/docs/modules/n1ql-rest-query/examples/expositional.json new file mode 100644 index 00000000..fc48bf3d --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/expositional.json @@ -0,0 +1,25 @@ +{ + "requestID": "6d77dc41-3cab-4e00-9c54-f60fcc2e0fab", + "signature": { + "airline": "json" + }, + "results": [ + { + "airline": "B6" + }, + { + "airline": "EK" + }, + { + "airline": "SV" + } + ], + "status": "success", + "metrics": { + "elapsedTime": "86.226474ms", + "executionTime": "86.072996ms", + "resultCount": 3, + "resultSize": 48, + "serviceLoad": 12 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/expositional.sh b/docs/modules/n1ql-rest-query/examples/expositional.sh new file mode 100644 index 00000000..4c73f573 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/expositional.sh @@ -0,0 +1,5 @@ +curl -v $BASEURL/_p/query/query/service \ + -d 'statement=SELECT airline FROM `travel-sample`.inventory.route + WHERE sourceairport = ? AND distance > ? + & args=["LAX", 13000]' \ + -u $USER:$PASSWORD \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exreadonly.sh b/docs/modules/n1ql-rest-query/examples/exreadonly.sh new file mode 100644 index 00000000..445658bf --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exreadonly.sh @@ -0,0 +1,2 @@ +curl -v $BASEURL/_p/query/query/service?statement=SELECT%20name%20FROM%20%60travel-sample%60.inventory.hotel%20LIMIT%201%3B \ + -u $USER:$PASSWORD \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exrequesterror.json b/docs/modules/n1ql-rest-query/examples/exrequesterror.json new file mode 100644 index 00000000..86072621 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exrequesterror.json @@ -0,0 +1,18 @@ +{ + "requestID": "424c0a6d-b851-4feb-892c-0d9a106f2e13", + "errors": [ + { + "code": 1050, + "msg": "No statement or prepared value" + } + ], + "status": "fatal", + "metrics": { + "elapsedTime": "1.124637ms", + "executionTime": "1.094663ms", + "resultCount": 0, + "resultSize": 0, + "serviceLoad": 0, + "errorCount": 1 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exserviceerror.json b/docs/modules/n1ql-rest-query/examples/exserviceerror.json new file mode 100644 index 00000000..3048677a --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exserviceerror.json @@ -0,0 +1,19 @@ +{ + "requestID": "5c0a6a81-2fc8-4a33-a035-ed7fb1512710", + "errors": [ + { + "code": "", + "msg": "Request queue full" + } + ], + "status": "errors", + "metrics": { + "elapsedTime": "134.7944us", + "executionTime": "130.5518us", + "resultCount": 0, + "resultSize": 0, + "mutationCount": 0, + "errorCount": 1, + "warningCount": 0 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exsuccessful.json b/docs/modules/n1ql-rest-query/examples/exsuccessful.json new file mode 100644 index 00000000..d48a72aa --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exsuccessful.json @@ -0,0 +1,19 @@ +{ + "requestID": "615e0b26-dd61-4a1a-bda9-22333193b982", + "signature": { + "name": "json" + }, + "results": [ + { + "name": "Medway Youth Hostel" + } + ], + "status": "success", + "metrics": { + "elapsedTime": "5.232754ms", + "executionTime": "5.160022ms", + "resultCount": 1, + "resultSize": 30, + "serviceLoad": 12 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exsuccessful.sh b/docs/modules/n1ql-rest-query/examples/exsuccessful.sh new file mode 100644 index 00000000..35fc5cd1 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exsuccessful.sh @@ -0,0 +1,4 @@ +curl -v $BASEURL/_p/query/query/service \ + -H 'Content-Type: application/json' \ + -d '{ "statement": "SELECT name FROM `travel-sample`.inventory.hotel LIMIT 1;" }' \ + -u $USER:$PASSWORD \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exwildcard.json b/docs/modules/n1ql-rest-query/examples/exwildcard.json new file mode 100644 index 00000000..49f72659 --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exwildcard.json @@ -0,0 +1,22 @@ +{ + "requestID": "716f5e7b-557a-44a6-a372-9a98611c5b5e", + "signature": { + "id": "json" + }, + "results": [ + { + "id": "hotel_10025" + }, + { + "id": "hotel_10026" + } + ], + "status": "success", + "metrics": { + "elapsedTime": "64.11756ms", + "executionTime": "63.993854ms", + "resultCount": 2, + "resultSize": 40, + "serviceLoad": 12 + } +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/examples/exwildcard.sh b/docs/modules/n1ql-rest-query/examples/exwildcard.sh new file mode 100644 index 00000000..669c1f0c --- /dev/null +++ b/docs/modules/n1ql-rest-query/examples/exwildcard.sh @@ -0,0 +1,6 @@ +curl -v $BASEURL/_p/query/query/service \ + -u $USER:$PASSWORD \ + -d 'statement=SELECT meta().id + FROM `travel-sample`.inventory.hotel + WHERE meta().id LIKE $pattern + & $pattern="hotel_1002%25"' \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 585b9325..b9fd342f 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -272,9 +272,11 @@ a| xref:Response[] | 400 a| [markdown] -- -Bad Request. The request cannot be processed for one of the following reasons: the statement contains a SQL++ syntax error; the request has a missing or unrecognized HTTP parameter; the request is badly formatted — for example, the request body contains a JSON syntax error. +Bad Request. The request cannot be processed for one of the following reasons: the statement contains a SQL++ syntax error; the request has a missing or unrecognized HTTP parameter; the request is badly formatted — for example, the request body contains a JSON syntax error. -- -a| +a| <> + + | 401 a| [markdown] -- @@ -292,7 +294,9 @@ a| [markdown] -- Not found. The statement in the request references an invalid namespace or keyspace. -- -a| +a| <> + + | 405 a| [markdown] -- @@ -328,7 +332,9 @@ a| [markdown] -- Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. -- -a| +a| <> + + |=== @@ -528,9 +534,11 @@ a| xref:Response[] | 400 a| [markdown] -- -Bad Request. The request cannot be processed for one of the following reasons: the statement contains a SQL++ syntax error; the request has a missing or unrecognized HTTP parameter; the request is badly formatted — for example, the request body contains a JSON syntax error. +Bad Request. The request cannot be processed for one of the following reasons: the statement contains a SQL++ syntax error; the request has a missing or unrecognized HTTP parameter; the request is badly formatted — for example, the request body contains a JSON syntax error. -- -a| +a| <> + + | 401 a| [markdown] -- @@ -548,7 +556,9 @@ a| [markdown] -- Not found. The statement in the request references an invalid namespace or keyspace. -- -a| +a| <> + + | 405 a| [markdown] -- @@ -584,7 +594,9 @@ a| [markdown] -- Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. -- -a| +a| <> + + |=== diff --git a/src/query-service/swagger/query-service.yaml b/src/query-service/swagger/query-service.yaml index 4ea5ef8a..879386a5 100644 --- a/src/query-service/swagger/query-service.yaml +++ b/src/query-service/swagger/query-service.yaml @@ -48,6 +48,27 @@ paths: application/x-www-form-urlencoded: schema: $ref: "#/components/schemas/Request" + x-codeSamples: + - lang: Shell + label: JSON + source: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exsuccessful.sh' + - lang: Shell + label: Form Data + source: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exformdata.sh' + - lang: Shell + label: Named Parameters + source: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exnamed.sh' + - lang: Shell + label: Numbered Parameters + source: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exnumbered.sh' + - lang: Shell + label: Unnumbered Parameters + source: + $ref: '../../../docs/modules/n1ql-rest-query/examples/expositional.sh' security: - Header: [] # - Parameter: [] @@ -95,6 +116,11 @@ paths: The format for URL-encoded parameters is consistent with the syntax for variables according to RFC 6570. schema: $ref: "#/components/schemas/Request" + x-codeSamples: + - lang: Shell + label: Read-Only + source: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exreadonly.sh' security: - Header: [] # - Parameter: [] @@ -138,17 +164,29 @@ components: application/json: schema: $ref: "#/components/schemas/Response" + example: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exsuccessful.json' BadRequest: description: |- Bad Request. The request cannot be processed for one of the following reasons: - the statement contains a SQL++ syntax error; - the request has a missing or unrecognized HTTP parameter; - the request is badly formatted — for example, the request body contains a JSON syntax error. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + examples: + n1qlerror: + summary: SQL++ Error + value: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exn1qlerror.json' + requesterror: + summary: Request Error + value: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exrequesterror.json' Unauthorized: description: > @@ -165,6 +203,12 @@ components: description: > Not found. The statement in the request references an invalid namespace or keyspace. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + example: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exnotfound.json' MethodNotAllowed: description: > @@ -196,6 +240,12 @@ components: description: > Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. + content: + application/json: + schema: + $ref: "#/components/schemas/Response" + example: + $ref: '../../../docs/modules/n1ql-rest-query/examples/exserviceerror.json' schemas: Request: @@ -1014,6 +1064,7 @@ components: [queryUseReplica]: #queryUseReplica additionalProperties: x-desc-name: identifier + x-additionalPropertiesName: $identifier description: | Supplies the value for a named parameter in the statement. Applicable if the statement or prepared statement contains 1 or more named parameters. From 1e9a1e84b5c261b0e9fac63d54ae4f6ca40a3a3e Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Thu, 10 Jul 2025 00:36:30 +0100 Subject: [PATCH 13/25] DOC-13299: Migrate Query REST APIs to dev repo (#173) * DOC-13239: queryN1QLFeatCtrl misspelled * DOC-13167: node-quote and queryNodeQuota * DOC-12171: servicers and memory quota * DOC-10897: POST and GET /query/service * Build output documentation * Attempting to fix workflow --------- Co-authored-by: tech-comm-team-couchbase --- .github/workflows/test.yml | 2 + docs/modules/n1ql-rest-admin/pages/index.adoc | 20 +-- docs/modules/n1ql-rest-query/pages/index.adoc | 116 +++++++++--------- .../n1ql-rest-settings/pages/index.adoc | 15 ++- src/admin/swagger/admin.yaml | 20 +-- src/query-service/swagger/query-service.yaml | 61 +++++---- .../swagger/query-settings.yaml | 15 ++- 7 files changed, 137 insertions(+), 112 deletions(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index eef1d0c8..f8bd4eba 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -6,6 +6,8 @@ name: Gradle CI on: pull_request: branches: [ capella ] + merge_group: + types: [checks_requested] jobs: test: diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 8bf08aaa..e79bab7b 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -6750,7 +6750,6 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies the maximum amount of memory a request may use on this node, in MB. -Note that the overall node memory quota is this setting multiplied by the [node-level](#servicers) `servicers` setting. Specify `0` (the default value) to disable. When disabled, there is no quota. @@ -6828,7 +6827,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] -[queryN1qlFeatCtrl]: #queryN1qlFeatCtrl +[queryN1QLFeatCtrl]: #queryN1QLFeatCtrl endif::alt-markdown-links[] @@ -6837,10 +6836,10 @@ This setting is provided for technical support only. The value may be an integer. On databases running Couchbase Server 7.6 or later, it may also be a string representing a hexadecimal number. -The [cluster-level][queryN1qlFeatCtrl] `queryN1qlFeatCtrl` setting specifies this property for the whole cluster. +The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[queryN1qlFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1qlFeatCtrl +[queryN1QLFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1QLFeatCtrl -- @@ -6865,11 +6864,18 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] This property is available in databases running Couchbase Server 7.6.0 and later. -Sets the soft memory limit for this node, in MB. +Sets the soft memory limit for the Query service on this node, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. -When set to `0` (the default), there is no soft memory limit. +When set to `0` (the default), the Query service sets a default soft memory limit for the node. +To do this, the Query service calculates the difference between the total system RAM and 90% of the total system RAM: + +`Total System RAM - (0.9 * Total System RAM)` + +- If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. + +- If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. The [cluster-level][queryNodeQuota] `queryNodeQuota` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -7232,8 +7238,6 @@ a¦ The number of service threads for the query. The default is 4 times the number of cores on the query node. -Note that the overall node memory quota is this setting multiplied by the [node-level](#memory-quota-srv) `memory-quota` setting. - -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index b9fd342f..d12ee28a 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -169,10 +169,10 @@ GET /query/service [markdown] -- -Enables you to execute a SQL++ statement. This method allows you to run queries and modifying statements, and specify query parameters. It does not allow you to run modifying statements. +Enables you to execute a SQL++ statement. +This method allows you to run SELECT queries, and specify query parameters. This endpoint is intended for situations where use of the `POST` method is restricted. - -- @@ -274,65 +274,65 @@ a| [markdown] -- Bad Request. The request cannot be processed for one of the following reasons: the statement contains a SQL++ syntax error; the request has a missing or unrecognized HTTP parameter; the request is badly formatted — for example, the request body contains a JSON syntax error. -- -a| <> +a| xref:Response[] | 401 a| [markdown] -- -Unauthorized. The credentials provided with the request are missing or invalid. +Unauthorized. The credentials provided with the request are missing or invalid. -- a| | 403 a| [markdown] -- -Forbidden. There is a read-only violation. Either there was an attempt to create or update in a GET request or a POST request where `readonly` is set, or the client does not have the authorization to modify an object (index, keyspace or namespace) in the statement. +Forbidden. There is a read-only violation. Either there was an attempt to create or update in a GET request or a POST request where `readonly` is set, or the client does not have the authorization to modify an object (index, keyspace or namespace) in the statement. -- a| | 404 a| [markdown] -- -Not found. The statement in the request references an invalid namespace or keyspace. +Not found. The statement in the request references an invalid namespace or keyspace. -- -a| <> +a| xref:Response[] | 405 a| [markdown] -- -Method not allowed. The statement in the request references an invalid namespace or keyspace. +Method not allowed. The statement in the request references an invalid namespace or keyspace. -- a| | 409 a| [markdown] -- -Conflict. There is an attempt to create an object (keyspace or index) that already exists. +Conflict. There is an attempt to create an object (keyspace or index) that already exists. -- a| | 410 a| [markdown] -- -Gone. The server is shutting down gracefully. Previously made requests are being completed, but no new requests are being accepted. +Gone. The server is shutting down gracefully. Previously made requests are being completed, but no new requests are being accepted. -- a| | 413 a| [markdown] -- -Payload too large. The query is too large for the Query Service to process. +Payload too large. The query is too large for the Query Service to process. -- a| | 500 a| [markdown] -- -Internal server error. There was an unforeseen problem processing the request. +Internal server error. There was an unforeseen problem processing the request. -- a| | 503 a| [markdown] -- -Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. +Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. -- -a| <> +a| xref:Response[] @@ -430,8 +430,8 @@ POST /query/service [markdown] -- -Enables you to execute a SQL++ statement. This method allows you to run queries and modifying statements, and specify query parameters. - +Enables you to execute a SQL++ statement. +This method allows you to run SELECT queries and other DML statements, and specify query parameters. -- @@ -536,65 +536,65 @@ a| [markdown] -- Bad Request. The request cannot be processed for one of the following reasons: the statement contains a SQL++ syntax error; the request has a missing or unrecognized HTTP parameter; the request is badly formatted — for example, the request body contains a JSON syntax error. -- -a| <> +a| xref:Response[] | 401 a| [markdown] -- -Unauthorized. The credentials provided with the request are missing or invalid. +Unauthorized. The credentials provided with the request are missing or invalid. -- a| | 403 a| [markdown] -- -Forbidden. There is a read-only violation. Either there was an attempt to create or update in a GET request or a POST request where `readonly` is set, or the client does not have the authorization to modify an object (index, keyspace or namespace) in the statement. +Forbidden. There is a read-only violation. Either there was an attempt to create or update in a GET request or a POST request where `readonly` is set, or the client does not have the authorization to modify an object (index, keyspace or namespace) in the statement. -- a| | 404 a| [markdown] -- -Not found. The statement in the request references an invalid namespace or keyspace. +Not found. The statement in the request references an invalid namespace or keyspace. -- -a| <> +a| xref:Response[] | 405 a| [markdown] -- -Method not allowed. The statement in the request references an invalid namespace or keyspace. +Method not allowed. The statement in the request references an invalid namespace or keyspace. -- a| | 409 a| [markdown] -- -Conflict. There is an attempt to create an object (keyspace or index) that already exists. +Conflict. There is an attempt to create an object (keyspace or index) that already exists. -- a| | 410 a| [markdown] -- -Gone. The server is shutting down gracefully. Previously made requests are being completed, but no new requests are being accepted. +Gone. The server is shutting down gracefully. Previously made requests are being completed, but no new requests are being accepted. -- a| | 413 a| [markdown] -- -Payload too large. The query is too large for the Query Service to process. +Payload too large. The query is too large for the Query Service to process. -- a| | 500 a| [markdown] -- -Internal server error. There was an unforeseen problem processing the request. +Internal server error. There was an unforeseen problem processing the request. -- a| | 503 a| [markdown] -- -Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. +Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. -- -a| <> +a| xref:Response[] @@ -742,8 +742,10 @@ a¦ [markdown] -- -A unique number that identifies the error or warning. The code ranges are partitioned by component. The codes can also include parts that indicate severity and transience. This property is always present in every condition returned in the Query REST API or captured in a log. - +A unique number that identifies the error or warning. +The code ranges are partitioned by component. +The codes can also include parts that indicate severity and transience. +This property is always present in every condition returned in the Query REST API or captured in a log. -- [%hardbreaks] @@ -758,8 +760,8 @@ a¦ [markdown] -- -A message describing the error or warning in detail. This property is always present in every condition returned in the Query REST API or captured in a log. - +A message describing the error or warning in detail. +This property is always present in every condition returned in the Query REST API or captured in a log. -- [%hardbreaks] @@ -774,8 +776,10 @@ a¦ [markdown] -- -Unique name that has a 1:1 mapping to the code. Uniquely identifies the condition. This property is helpful for pattern matching and can have meaning, making it more memorable than the code. The name should be fully qualified. - +Unique name that has a 1:1 mapping to the code. +Uniquely identifies the condition. +This property is helpful for pattern matching and can have meaning, making it more memorable than the code. +The name should be fully qualified. -- [%hardbreaks] @@ -812,8 +816,8 @@ a¦ [markdown] -- -Indicates if the condition is transient — for example, the queue is full. If the value is `false`, it tells clients and users that a retry without modification produces the same condition. - +Indicates if the condition is transient — for example, the queue is full. +If the value is `false`, it tells clients and users that a retry without modification produces the same condition. -- [%hardbreaks] @@ -859,8 +863,8 @@ endif::collapse-models[] ifdef::model-descriptions[] //tag::desc-Controls[] -An object containing runtime information provided along with the request. Present only if `controls` was set to true in the [Request Parameters](#Request). - +An object containing runtime information provided along with the request. +Present only if `controls` was set to true in the [Request Parameters](#Request). //end::desc-Controls[] endif::model-descriptions[] @@ -905,8 +909,8 @@ a¦ [markdown] -- -The memory quota for the request, in MB. This property is only returned if a memory quota was set for the query. - +The memory quota for the request, in MB. +This property is only returned if a memory quota was set for the query. -- [%hardbreaks] @@ -1153,10 +1157,10 @@ a¦ [markdown] -- -The number of objects that were sorted. Present only if the request includes `ORDER BY`. +The number of objects that were sorted. +Present only if the request includes `ORDER BY`. If a query includes ORDER BY, LIMIT, or OFFSET clauses, an application can use the `sortCount` value to give the overall number of results in a message such as `"page 1 of N"`. - -- [%hardbreaks] @@ -1171,8 +1175,8 @@ a¦ [markdown] -- -The amount of document memory used to execute the request. This property is only returned if a memory quota was set for the query. - +The amount of document memory used to execute the request. +This property is only returned if a memory quota was set for the query. -- [%hardbreaks] @@ -1268,8 +1272,8 @@ endif::collapse-models[] ifdef::model-descriptions[] //tag::desc-Profile[] -An object containing monitoring and profiling information about the request. Present only if `profile` was set to `"phases"` or `"timings"` in the [Request Parameters](#Request). - +An object containing monitoring and profiling information about the request. +Present only if `profile` was set to `"phases"` or `"timings"` in the [Request Parameters](#Request). //end::desc-Profile[] endif::model-descriptions[] @@ -1836,8 +1840,8 @@ a¦ [markdown] -- -Specifies the namespace to use. Currently, only the `default` namespace is available. - +Specifies the namespace to use. +Currently, only the `default` namespace is available. -- [%hardbreaks] @@ -2683,8 +2687,8 @@ a¦ [markdown] -- -The schema of the results. Present only when the query completes successfully. - +The schema of the results. +Present only when the query completes successfully. -- [%hardbreaks] @@ -2700,8 +2704,8 @@ a¦ [markdown] -- -An array of all the objects returned by the query. An object can be any JSON value. - +An array of all the objects returned by the query. +An object can be any JSON value. -- [%hardbreaks] @@ -2732,8 +2736,8 @@ a¦ [markdown] -- -An array of 0 or more error objects. If an error occurred during processing of the request, it will be represented by an error object in this list. - +An array of 0 or more error objects. +If an error occurred during processing of the request, it will be represented by an error object in this list. -- [%hardbreaks] @@ -2748,8 +2752,8 @@ a¦ [markdown] -- -An array of 0 or more warning objects. If a warning occurred during processing of the request, it is represented by a warning object in this list. - +An array of 0 or more warning objects. +If a warning occurred during processing of the request, it is represented by a warning object in this list. -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index d5f34eaa..9858a25d 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -1355,8 +1355,8 @@ If a request includes this parameter, it will be capped by the node-level `memor a¦ Integer (int32) -a¦ [#queryN1qlFeatCtrl] -*queryN1qlFeatCtrl* + +a¦ [#queryN1QLFeatCtrl] +*queryN1QLFeatCtrl* + _optional_ a¦ @@ -1396,11 +1396,18 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] This property is available in databases running Couchbase Server 7.6.0 and later. -Sets the soft memory limit for every Query node in the cluster, in MB. +Sets the soft memory limit for the Query service on every Query node in the cluster, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. -When set to `0` (the default), there is no soft memory limit. +When set to `0` (the default), the Query service sets a default soft memory limit for every node. +To do this, the Query service calculates the difference between the total system RAM and 90% of the total system RAM: + +`Total System RAM - (0.9 * Total System RAM)` + +- If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. + +- If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. The [node-level][node-quota] `node-quota` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index 3c2e6a7f..2fe84e7b 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -1798,7 +1798,6 @@ components: x-desc-name: memory-quota-srv description: | Specifies the maximum amount of memory a request may use on this node, in MB. - Note that the overall node memory quota is this setting multiplied by the [node-level](#servicers) `servicers` setting. Specify `0` (the default value) to disable. When disabled, there is no quota. @@ -1859,12 +1858,12 @@ components: The value may be an integer. On databases running Couchbase Server 7.6 or later, it may also be a string representing a hexadecimal number. - The [cluster-level][queryN1qlFeatCtrl] `queryN1qlFeatCtrl` setting specifies this property for the whole cluster. + The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [queryN1qlFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1qlFeatCtrl + [queryN1QLFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1QLFeatCtrl x-desc-refs: | - [queryN1qlFeatCtrl]: #queryN1qlFeatCtrl + [queryN1QLFeatCtrl]: #queryN1QLFeatCtrl node-quota: type: integer format: int32 @@ -1875,11 +1874,18 @@ components: description: | This property is available in databases running Couchbase Server 7.6.0 and later. - Sets the soft memory limit for this node, in MB. + Sets the soft memory limit for the Query service on this node, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. - When set to `0` (the default), there is no soft memory limit. + When set to `0` (the default), the Query service sets a default soft memory limit for the node. + To do this, the Query service calculates the difference between the total system RAM and 90% of the total system RAM: + + `Total System RAM - (0.9 * Total System RAM)` + + - If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. + + - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. The [cluster-level][queryNodeQuota] `queryNodeQuota` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -2115,8 +2121,6 @@ components: description: | The number of service threads for the query. The default is 4 times the number of cores on the query node. - - Note that the overall node memory quota is this setting multiplied by the [node-level](#memory-quota-srv) `memory-quota` setting. timeout: type: integer format: int64 diff --git a/src/query-service/swagger/query-service.yaml b/src/query-service/swagger/query-service.yaml index 879386a5..82fc1fd7 100644 --- a/src/query-service/swagger/query-service.yaml +++ b/src/query-service/swagger/query-service.yaml @@ -35,9 +35,9 @@ paths: post: operationId: post_service summary: Query Service - description: > + description: |- Enables you to execute a SQL++ statement. - This method allows you to run queries and modifying statements, and specify query parameters. + This method allows you to run SELECT queries and other DML statements, and specify query parameters. requestBody: required: true description: An object specifying one or more query parameters. @@ -98,11 +98,9 @@ paths: get: operationId: get_service summary: Read-Only Query Service - description: > + description: |- Enables you to execute a SQL++ statement. - This method allows you to run queries and modifying statements, and specify query parameters. - It does not allow you to run modifying statements. - + This method allows you to run SELECT queries, and specify query parameters. This endpoint is intended for situations where use of the `POST` method is restricted. parameters: @@ -189,18 +187,18 @@ components: $ref: '../../../docs/modules/n1ql-rest-query/examples/exrequesterror.json' Unauthorized: - description: > + description: |- Unauthorized. The credentials provided with the request are missing or invalid. Forbidden: - description: > + description: |- Forbidden. There is a read-only violation. Either there was an attempt to create or update in a GET request or a POST request where `readonly` is set, or the client does not have the authorization to modify an object (index, keyspace or namespace) in the statement. NotFound: - description: > + description: |- Not found. The statement in the request references an invalid namespace or keyspace. content: @@ -211,33 +209,33 @@ components: $ref: '../../../docs/modules/n1ql-rest-query/examples/exnotfound.json' MethodNotAllowed: - description: > + description: |- Method not allowed. The statement in the request references an invalid namespace or keyspace. Conflict: - description: > + description: |- Conflict. There is an attempt to create an object (keyspace or index) that already exists. Gone: - description: > + description: |- Gone. The server is shutting down gracefully. Previously made requests are being completed, but no new requests are being accepted. InternalServerError: - description: > + description: |- Internal server error. There was an unforeseen problem processing the request. PayloadTooLarge: - description: > + description: |- Payload too large. The query is too large for the Query Service to process. ServiceUnavailable: - description: > + description: |- Service unavailable. There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. content: @@ -510,7 +508,7 @@ components: namespace: type: string x-desc-name: namespace - description: > + description: |- Specifies the namespace to use. Currently, only the `default` namespace is available. x-has-example: true @@ -1088,7 +1086,7 @@ components: # properties: # user: # type: string -# description: > +# description: |- # An identity for authentication. # Note that bucket names may be prefixed with `local:`, and admin names may be prefixed with `admin:`. # pass: @@ -1109,7 +1107,7 @@ components: description: The client context ID of the request, if one was supplied — see `client_context_id` in [Request Parameters](#Request). signature: type: object - description: > + description: |- The schema of the results. Present only when the query completes successfully. x-has-example: true @@ -1118,7 +1116,7 @@ components: results: type: array items: {} - description: > + description: |- An array of all the objects returned by the query. An object can be any JSON value. status: @@ -1134,14 +1132,14 @@ components: - fatal errors: type: array - description: > + description: |- An array of 0 or more error objects. If an error occurred during processing of the request, it will be represented by an error object in this list. items: $ref: "#/components/schemas/Conditions" warnings: type: array - description: > + description: |- An array of 0 or more warning objects. If a warning occurred during processing of the request, it is represented by a warning object in this list. items: @@ -1162,19 +1160,19 @@ components: properties: code: type: integer - description: > + description: |- A unique number that identifies the error or warning. The code ranges are partitioned by component. The codes can also include parts that indicate severity and transience. This property is always present in every condition returned in the Query REST API or captured in a log. msg: type: string - description: > + description: |- A message describing the error or warning in detail. This property is always present in every condition returned in the Query REST API or captured in a log. name: type: string - description: > + description: |- Unique name that has a 1:1 mapping to the code. Uniquely identifies the condition. This property is helpful for pattern matching and can have meaning, making it more memorable than the code. @@ -1195,7 +1193,7 @@ components: 4. Info temp: type: boolean - description: > + description: |- Indicates if the condition is transient — for example, the queue is full. If the value is `false`, it tells clients and users that a retry without modification produces the same condition. @@ -1229,16 +1227,15 @@ components: sortCount: type: integer format: unsigned - description: > + description: |- The number of objects that were sorted. Present only if the request includes `ORDER BY`. - If a query includes ORDER BY, LIMIT, or OFFSET clauses, an application can use the `sortCount` value to give the overall number of results in a message such as `"page 1 of N"`. usedMemory: type: integer format: unsigned - description: > + description: |- The amount of document memory used to execute the request. This property is only returned if a memory quota was set for the query. errorCount: @@ -1265,7 +1262,7 @@ components: Controls: type: object - description: > + description: |- An object containing runtime information provided along with the request. Present only if `controls` was set to true in the [Request Parameters](#Request). properties: @@ -1278,7 +1275,7 @@ components: memoryQuota: type: integer format: unsigned - description: > + description: |- The memory quota for the request, in MB. This property is only returned if a memory quota was set for the query. stmtType: @@ -1289,7 +1286,7 @@ components: Profile: type: object - description: > + description: |- An object containing monitoring and profiling information about the request. Present only if `profile` was set to `"phases"` or `"timings"` in the [Request Parameters](#Request). required: @@ -1463,6 +1460,6 @@ components: # type: apiKey # name: creds # in: query -# description: > +# description: |- # Specify user names and passwords via the `creds` request parameter. # This is the only method that can provide multiple credentials for a request. diff --git a/src/query-settings/swagger/query-settings.yaml b/src/query-settings/swagger/query-settings.yaml index 70e71061..ee9d1351 100644 --- a/src/query-settings/swagger/query-settings.yaml +++ b/src/query-settings/swagger/query-settings.yaml @@ -370,10 +370,10 @@ components: x-desc-refs: | [memory-quota-srv]: #memory-quota-srv [memory_quota_req]: #memory_quota_req - queryN1qlFeatCtrl: + queryN1QLFeatCtrl: type: integer format: int32 - x-desc-name: queryN1qlFeatCtrl + x-desc-name: queryN1QLFeatCtrl description: | SQL++ feature control. This setting is provided for technical support only. @@ -393,11 +393,18 @@ components: description: | This property is available in databases running Couchbase Server 7.6.0 and later. - Sets the soft memory limit for every Query node in the cluster, in MB. + Sets the soft memory limit for the Query service on every Query node in the cluster, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. - When set to `0` (the default), there is no soft memory limit. + When set to `0` (the default), the Query service sets a default soft memory limit for every node. + To do this, the Query service calculates the difference between the total system RAM and 90% of the total system RAM: + + `Total System RAM - (0.9 * Total System RAM)` + + - If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. + + - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. The [node-level][node-quota] `node-quota` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. From 54c86ecba0708163db0a286067e1b268b3616d61 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Thu, 10 Jul 2025 19:03:03 +0100 Subject: [PATCH 14/25] DOC-13299: Migrate Query REST APIs to dev repo (#174) * Add support for extended descriptions * Add support for additional property names * Update Query specs with extended descriptions * Build output documentation --------- Co-authored-by: tech-comm-team-couchbase --- .../analytics-rest-admin/pages/index.adoc | 2 + .../analytics-rest-service/pages/index.adoc | 1 + .../fts-rest-advanced/pages/index.adoc | 1 + .../fts-rest-indexing/pages/index.adoc | 4 + docs/modules/fts-rest-nodes/pages/index.adoc | 5 + docs/modules/fts-rest-query/pages/index.adoc | 1 + .../modules/index-rest-stats/pages/index.adoc | 2 + docs/modules/n1ql-rest-admin/pages/index.adoc | 233 ++-------- .../n1ql-rest-functions/pages/index.adoc | 1 + docs/modules/n1ql-rest-query/pages/index.adoc | 178 +++++--- .../n1ql-rest-settings/pages/index.adoc | 98 ++--- src/admin/swagger/admin.yaml | 404 +++++++++--------- src/query-service/swagger/query-service.yaml | 333 +++++++-------- .../swagger/query-settings.yaml | 177 ++++---- templates/model.mustache | 3 +- templates/property.mustache | 16 + 16 files changed, 669 insertions(+), 790 deletions(-) diff --git a/docs/modules/analytics-rest-admin/pages/index.adoc b/docs/modules/analytics-rest-admin/pages/index.adoc index 133f3b21..488cf098 100644 --- a/docs/modules/analytics-rest-admin/pages/index.adoc +++ b/docs/modules/analytics-rest-admin/pages/index.adoc @@ -2016,6 +2016,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -2080,6 +2081,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/analytics-rest-service/pages/index.adoc b/docs/modules/analytics-rest-service/pages/index.adoc index fac5cae2..53951952 100644 --- a/docs/modules/analytics-rest-service/pages/index.adoc +++ b/docs/modules/analytics-rest-service/pages/index.adoc @@ -1238,6 +1238,7 @@ a¦ Any Type array a¦ + _additional + property_ a¦ diff --git a/docs/modules/fts-rest-advanced/pages/index.adoc b/docs/modules/fts-rest-advanced/pages/index.adoc index 83d62476..795f34eb 100644 --- a/docs/modules/fts-rest-advanced/pages/index.adoc +++ b/docs/modules/fts-rest-advanced/pages/index.adoc @@ -1333,6 +1333,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/fts-rest-indexing/pages/index.adoc b/docs/modules/fts-rest-indexing/pages/index.adoc index fa187672..57975c06 100644 --- a/docs/modules/fts-rest-indexing/pages/index.adoc +++ b/docs/modules/fts-rest-indexing/pages/index.adoc @@ -5324,6 +5324,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -5986,6 +5987,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -6296,6 +6298,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -6825,6 +6828,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/fts-rest-nodes/pages/index.adoc b/docs/modules/fts-rest-nodes/pages/index.adoc index 14317177..1466eeaf 100644 --- a/docs/modules/fts-rest-nodes/pages/index.adoc +++ b/docs/modules/fts-rest-nodes/pages/index.adoc @@ -2702,6 +2702,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -3012,6 +3013,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -3306,6 +3308,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -3456,6 +3459,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -3561,6 +3565,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/fts-rest-query/pages/index.adoc b/docs/modules/fts-rest-query/pages/index.adoc index 37a2d5a7..e501ec2f 100644 --- a/docs/modules/fts-rest-query/pages/index.adoc +++ b/docs/modules/fts-rest-query/pages/index.adoc @@ -1058,6 +1058,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/index-rest-stats/pages/index.adoc b/docs/modules/index-rest-stats/pages/index.adoc index 21760917..b91c5528 100644 --- a/docs/modules/index-rest-stats/pages/index.adoc +++ b/docs/modules/index-rest-stats/pages/index.adoc @@ -1270,6 +1270,7 @@ endif::collapse-models[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -1326,6 +1327,7 @@ endif::collapse-models[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index e79bab7b..9eaa95f1 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -27,7 +27,6 @@ include::{specDir}overview/document-before.adoc[opts=optional] -- The Query Admin REST API is a secondary API provided by the Query service. This API enables you to retrieve statistics about the clusters and nodes running the Query service; view or specify node-level settings; and view or delete requests. - -- [discrete#version] @@ -178,7 +177,6 @@ DELETE /admin/active_requests/{request} [markdown] -- Terminates the specified active query request. - -- @@ -225,7 +223,6 @@ a¦ -- The name of a request. This is the `requestID` that was assigned automatically when the statement was created. - -- [%hardbreaks] @@ -381,7 +378,6 @@ Returns all active index requests. * Use [Retrieve an Active Request](#get_active_request) to get information about an active index request. * Use [Delete an Active Request](#delete_active_request) to terminate an active index request. - -- @@ -530,7 +526,6 @@ GET /admin/active_requests/{request} [markdown] -- Returns the specified active query request. - -- @@ -577,7 +572,6 @@ a¦ -- The name of a request. This is the `requestID` that was assigned automatically when the statement was created. - -- [%hardbreaks] @@ -724,7 +718,6 @@ GET /admin/active_requests [markdown] -- Returns all active query requests. - -- @@ -898,7 +891,6 @@ DELETE /admin/completed_requests/{request} [markdown] -- Purges the specified completed request. - -- @@ -945,7 +937,6 @@ a¦ -- The name of a request. This is the `requestID` that was assigned automatically when the statement was created. - -- [%hardbreaks] @@ -1101,7 +1092,6 @@ Returns all completed index requests. * Use [Retrieve a Completed Request](#get_completed_request) to get information about a completed index request. * Use [Delete a Completed Request](#delete_completed_request) to purge a completed index request. - -- @@ -1250,7 +1240,6 @@ GET /admin/completed_requests/{request} [markdown] -- Returns the specified completed request. - -- @@ -1297,7 +1286,6 @@ a¦ -- The name of a request. This is the `requestID` that was assigned automatically when the statement was created. - -- [%hardbreaks] @@ -1444,7 +1432,6 @@ GET /admin/completed_requests [markdown] -- Returns all completed requests. - -- @@ -2533,7 +2520,6 @@ This endpoint is available in databases running Couchbase Server 7.6.0 and later Runs the garbage collector. A message is written to `query.log` whenever the garbage collector endpoint is invoked. - -- @@ -2589,7 +2575,7 @@ a| xref:Garbage[] | 401 a| [markdown] -- -Error 10000: authentication failure. The invoking user is not a valid full-admin user. +Error 10000: authentication failure. The invoking user is not a valid full-admin user. -- a| Object @@ -2823,7 +2809,6 @@ This endpoint is available in databases running Couchbase Server 7.6.0 and later Runs the garbage collector and attempts to return freed memory to the OS. A message is written to `query.log` whenever the garbage collector endpoint is invoked. - -- @@ -2879,7 +2864,7 @@ a| xref:Garbage[] | 401 a| [markdown] -- -Error 10000: authentication failure. The invoking user is not a valid full-admin user. +Error 10000: authentication failure. The invoking user is not a valid full-admin user. -- a| Object @@ -3005,7 +2990,6 @@ DELETE /admin/prepareds/{name} [markdown] -- Deletes the specified prepared statement. - -- @@ -3052,7 +3036,6 @@ a¦ -- The name of a prepared statement. This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. - -- [%hardbreaks] @@ -3205,7 +3188,6 @@ GET /admin/prepareds/{name} [markdown] -- Returns the specified prepared statement. - -- @@ -3252,7 +3234,6 @@ a¦ -- The name of a prepared statement. This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. - -- [%hardbreaks] @@ -3402,7 +3383,6 @@ Returns all prepared index statements. * Use [Retrieve a Prepared Statement](#get_prepared) to get information about a prepared index statement. * Use [Delete a Prepared Statement](#delete_prepared) to delete a prepared index statement. - -- @@ -3551,7 +3531,6 @@ GET /admin/prepareds [markdown] -- Returns all prepared statements. - -- @@ -3723,7 +3702,6 @@ GET /admin/settings [markdown] -- Returns node-level query settings. - -- @@ -3872,7 +3850,6 @@ POST /admin/settings [markdown] -- Updates node-level query settings. - -- @@ -4269,7 +4246,6 @@ a¦ The name of a statistic. Only top-level statistic names can be used. You cannot specify a metric. - -- [%hardbreaks] @@ -4316,7 +4292,7 @@ a¦ String | 200 a| [markdown] -- -An object containing all metrics for the specified statistic. Each statistic has a different set of metrics. +An object containing all metrics for the specified statistic. Each statistic has a different set of metrics. -- a| xref:Metrics[] @@ -4464,7 +4440,7 @@ Returns all statistics. | 200 a| [markdown] -- -An object containing all statistics. Each statistic consists of a top-level statistic name and a metric name. Each statistic has a different set of metrics. +An object containing all statistics. Each statistic consists of a top-level statistic name and a metric name. Each statistic has a different set of metrics. -- a| xref:Statistics[] @@ -4566,7 +4542,6 @@ GET /admin/vitals -- Returns data about the running state and health of the query engine. This information can be very useful to assess the current workload and performance characteristics of a query engine, and hence load-balance the requests being sent to various query engines. - -- @@ -4895,7 +4870,6 @@ a¦ -- Only returned by the POST method. The amount of memory released to the OS. - -- [%hardbreaks] @@ -4961,8 +4935,7 @@ All completed requests that match these parameters are tracked in the completed Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - +[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config //end::desc-Logging_Parameters[] endif::model-descriptions[] @@ -4996,7 +4969,6 @@ a¦ -- The IP address of the client. If specified, all completed requests from this IP address are logged. - -- [%hardbreaks] @@ -5016,7 +4988,6 @@ a¦ ifdef::alt-markdown-links[] [client_context_id]: #client_context_id - endif::alt-markdown-links[] The opaque ID or context provided by the client. If specified, all completed requests with this client context ID are logged. @@ -5024,7 +4995,6 @@ If specified, all completed requests with this client context ID are logged. Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. [client_context_id]: ../n1ql-rest-query/index.html#client_context_id - -- [%hardbreaks] @@ -5041,7 +5011,6 @@ a¦ -- An error number. If specified, all completed queries returning this error number are logged. - -- [%hardbreaks] @@ -5062,8 +5031,7 @@ A unique string which tags a set of qualifiers. Refer to [Configure Completed Requests][sys-completed-config] for more information. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - +[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config -- [%hardbreaks] @@ -5083,8 +5051,7 @@ a¦ A duration in milliseconds. If specified, all completed queries lasting longer than this threshold are logged. -This is another way of specifying the [node-level](#completed-threshold) `completed-threshold` setting. - +This is another way of specifying the `completed-threshold` setting. -- [%hardbreaks] @@ -5103,7 +5070,6 @@ a¦ -- A user name, as given in the request credentials. If specified, all completed queries with this user name are logged. - -- [%hardbreaks] @@ -5157,7 +5123,6 @@ a¦ The number of errors. If specified, all completed queries that return at least this many errors are logged. Queries with fewer errors are not logged. - -- [%hardbreaks] @@ -5245,6 +5210,7 @@ endif::collapse-models[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ @@ -5714,13 +5680,12 @@ a¦ ifdef::alt-markdown-links[] [client_context_id]: #client_context_id - endif::alt-markdown-links[] The opaque ID or context provided by the client. + Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. [client_context_id]: ../n1ql-rest-query/index.html#client_context_id - -- [%hardbreaks] @@ -5728,25 +5693,6 @@ Refer to the [request-level][client_context_id] `client_context_id` parameter fo a¦ String -a¦ -*cpuTime* + -_optional_ -a¦ - -[markdown] --- -The total sum of [execTime][exec_time] across all operators. - -[exec_time]: ../n1ql-rest-query/index.html#exec_time - --- - -[%hardbreaks] -*Example:* `+++"90.734075ms"+++` -{blank} -a¦ String (duration) - - a¦ *elapsedTime* + _optional_ @@ -5756,7 +5702,6 @@ a¦ -- The time taken from when the request was acknowledged by the service to when the request was completed. It includes the time taken by the service to schedule the request. - -- [%hardbreaks] @@ -5807,7 +5752,6 @@ a¦ -- The memory quota for the request, in MB. This property is only returned if a memory quota is set for the query. - -- [%hardbreaks] @@ -5841,7 +5785,6 @@ Count of documents processed at selective phases involved in the query execution For active requests, this property is dynamic, depending on the documents processed by various phases up to this moment in time. Polling the active requests again may return different values. - -- [%hardbreaks] @@ -5862,7 +5805,6 @@ Indicates the numbers of each kind of query operator involved in different phase For instance, a non-covering index path might involve one index scan and one fetch operator. A join would probably involve two or more fetches, one per keyspace. A union select would have twice as many operator counts, one per each branch of the union. - -- [%hardbreaks] @@ -5882,7 +5824,6 @@ Cumulative execution times for various phases involved in the query execution, s For active requests, this property is dynamic, depending on the documents processed by various phases up to this moment in time. Polling the active requests again may return different values. - -- [%hardbreaks] @@ -6031,7 +5972,6 @@ Note that the `completed` state means that the request was started and completed The request could have been successful, or completed with errors. To find requests that were successful, use this field in conjunction with the `errorCount` field: search for requests whose state is `completed` and whose error count is `0`. - -- [%hardbreaks] @@ -6078,7 +6018,6 @@ a¦ -- The amount of document memory used to execute the request. This property is only returned if a memory quota is set for the query. - -- [%hardbreaks] @@ -6204,7 +6143,6 @@ a¦ ifdef::alt-markdown-links[] [atrcollection_req]: #atrcollection_req - endif::alt-markdown-links[] Specifies the collection where [active transaction records][additional-storage-use] are stored. The collection must be present. @@ -6213,12 +6151,12 @@ If not specified, the active transaction record is stored in the default collect The value must be a string in the form `"bucket.scope.collection"` or `"namespace:bucket.scope.collection"`. If any part of the path contains a special character, that part of the path must be delimited in backticks ``. +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + The [request-level][atrcollection_req] `atrcollection` parameter specifies this property per request. If a request does not include this parameter, the node-level `atrcollection` setting will be used. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [atrcollection_req]: ../n1ql-rest-query/index.html#atrcollection_req - -- [%hardbreaks] @@ -6240,7 +6178,6 @@ Specifies whether the query engine should create a prepared statement every time Refer to [Auto-Prepare][auto-prepare] for more information. [auto-prepare]: /cloud/n1ql/n1ql-language-reference/prepare.html#auto-prepare - -- [%hardbreaks] @@ -6260,7 +6197,6 @@ a¦ ifdef::alt-markdown-links[] [queryCleanupClientAttempts]: #queryCleanupClientAttempts - endif::alt-markdown-links[] When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. @@ -6268,7 +6204,6 @@ The [cluster-level][queryCleanupClientAttempts] `queryCleanupClientAttempts` set When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupClientAttempts]: ../n1ql-rest-settings/index.html#queryCleanupClientAttempts - -- [%hardbreaks] @@ -6288,7 +6223,6 @@ a¦ ifdef::alt-markdown-links[] [queryCleanupLostAttempts]: #queryCleanupLostAttempts - endif::alt-markdown-links[] When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. @@ -6296,7 +6230,6 @@ The [cluster-level][queryCleanupLostAttempts] `queryCleanupLostAttempts` setting When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupLostAttempts]: ../n1ql-rest-settings/index.html#queryCleanupLostAttempts - -- [%hardbreaks] @@ -6316,7 +6249,6 @@ a¦ ifdef::alt-markdown-links[] [queryCleanupWindow]: #queryCleanupWindow - endif::alt-markdown-links[] Specifies how frequently the Query service checks its subset of [active transaction records][additional-storage-use] for cleanup. Decreasing this setting causes expiration transactions to be found more swiftly, with the tradeoff of increasing the number of reads per second used for the scanning process. @@ -6332,12 +6264,12 @@ Valid units are: * `m` (minutes) * `h` (hours) +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + The [cluster-level][queryCleanupWindow] `queryCleanupWindow` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [queryCleanupWindow]: ../n1ql-rest-settings/index.html#queryCleanupWindow - -- [%hardbreaks] @@ -6372,7 +6304,6 @@ a¦ ifdef::alt-markdown-links[] [queryCompletedLimit]: #queryCompletedLimit - endif::alt-markdown-links[] Sets the number of requests to be logged in the completed requests catalog. As new completed requests are added, old ones are removed. @@ -6381,12 +6312,12 @@ Increase this when the completed request keyspace is not big enough to track the Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. +[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [queryCompletedLimit]: ../n1ql-rest-settings/index.html#queryCompletedLimit - -- [%hardbreaks] @@ -6406,7 +6337,6 @@ a¦ [.status]##Couchbase Server 7.6## ifdef::alt-markdown-links[] [queryCompletedMaxPlanSize]: #queryCompletedMaxPlanSize - endif::alt-markdown-links[] This property is available in databases running Couchbase Server 7.6.0 and later. @@ -6418,12 +6348,12 @@ You must obtain execution plans for such queries via profiling or using the EXPL Refer to [Configure Completed Requests][sys-completed-config] for more information. +[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [queryCompletedMaxPlanSize]: ../n1ql-rest-settings/index.html#queryCompletedMaxPlanSize - -- [%hardbreaks] @@ -6450,8 +6380,7 @@ Specify `0` (the default) to disable completed request streaming. Refer to [Stream Completed Requests][sys-history] for more information and examples. -[sys-history]: /server/8.0/manage/monitor/monitoring-n1ql-query.html#sys-history - +[sys-history]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-history -- [%hardbreaks] @@ -6469,7 +6398,6 @@ a¦ ifdef::alt-markdown-links[] [queryCompletedThreshold]: #queryCompletedThreshold - endif::alt-markdown-links[] A duration in milliseconds. All completed queries lasting longer than this threshold are logged in the completed requests catalog. @@ -6479,12 +6407,12 @@ Specify any negative number to track none. Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. +[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [queryCompletedThreshold]: ../n1ql-rest-settings/index.html#queryCompletedThreshold - -- [%hardbreaks] @@ -6504,7 +6432,6 @@ a¦ ifdef::alt-markdown-links[] [controls_req]: #controls_req - endif::alt-markdown-links[] Specifies if there should be a controls section returned with the request results. @@ -6516,7 +6443,6 @@ The [request-level][controls_req] `controls` parameter specifies this property p If a request does not include this parameter, the node-level `controls` setting will be used. [controls_req]: ../n1ql-rest-query/index.html#controls_req - -- [%hardbreaks] @@ -6540,7 +6466,6 @@ The output file includes a controls section and performance measurements, such a NOTE: If `cpuprofile` is left running too long, it can slow the system down as its file size increases. To stop `cpuprofile`, run with the empty setting of `""`. - -- [%hardbreaks] @@ -6560,7 +6485,6 @@ a¦ Use debug mode. When set to `true`, extra logging is provided. - -- [%hardbreaks] @@ -6580,7 +6504,6 @@ a¦ This field is only available with the POST method. When specified alongside other settings, this field instructs the node that is processing the request to cascade those settings to all other query nodes. The actual value of this field is ignored. - -- [%hardbreaks] @@ -6633,7 +6556,6 @@ a¦ ifdef::alt-markdown-links[] [queryLogLevel]: #queryLogLevel - endif::alt-markdown-links[] Log level used in the logger. @@ -6663,7 +6585,6 @@ The [cluster-level][queryLogLevel] `queryLogLevel` setting specifies this proper When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryLogLevel]: ../n1ql-rest-settings/index.html#queryLogLevel - -- [%hardbreaks] @@ -6683,7 +6604,6 @@ a¦ -- Max index API. This setting is provided for technical support only. - -- [%hardbreaks] @@ -6702,7 +6622,6 @@ ifdef::alt-markdown-links[] [queryMaxParallelism]: #queryMaxParallelism [max_parallelism_req]: #max_parallelism_req - endif::alt-markdown-links[] Specifies the maximum parallelism for queries on this node. @@ -6712,6 +6631,9 @@ Similarly, if the value is greater than the number of allowed cores, the maximum (The number of allowed cores is the same as the number of logical CPUs. In Community Edition, the number of allowed cores cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed cores.) +Refer to [Max Parallelism][max-parallelism] for more information. + +[max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism The [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6721,12 +6643,8 @@ If a request includes this parameter, it will be capped by the node-level `max-p NOTE: To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. -Refer to [Max Parallelism][max-parallelism] for more information. - -[max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req - -- [%hardbreaks] @@ -6747,7 +6665,6 @@ ifdef::alt-markdown-links[] [queryMemoryQuota]: #queryMemoryQuota [memory_quota_req]: #memory_quota_req - endif::alt-markdown-links[] Specifies the maximum amount of memory a request may use on this node, in MB. @@ -6769,7 +6686,6 @@ If a request includes this parameter, it will be capped by the node-level `memor [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req - -- [%hardbreaks] @@ -6791,7 +6707,6 @@ Filename to write the diagnostic memory usage log. NOTE: If `memprofile` is left running too long, it can slow the system down as its file size increases. To stop `memprofile`, run with the empty setting of `""`. - -- [%hardbreaks] @@ -6810,7 +6725,6 @@ a¦ -- Mutex profile. This setting is provided for technical support only. - -- [%hardbreaks] @@ -6829,7 +6743,6 @@ a¦ ifdef::alt-markdown-links[] [queryN1QLFeatCtrl]: #queryN1QLFeatCtrl - endif::alt-markdown-links[] SQL++ feature control. This setting is provided for technical support only. @@ -6840,7 +6753,6 @@ The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies thi When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryN1QLFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1QLFeatCtrl - -- [%hardbreaks] @@ -6860,7 +6772,6 @@ a¦ [.status]##Couchbase Server 7.6## ifdef::alt-markdown-links[] [queryNodeQuota]: #queryNodeQuota - endif::alt-markdown-links[] This property is available in databases running Couchbase Server 7.6.0 and later. @@ -6881,7 +6792,6 @@ The [cluster-level][queryNodeQuota] `queryNodeQuota` setting specifies this prop When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNodeQuota]: ../n1ql-rest-settings/index.html#queryNodeQuota - -- [%hardbreaks] @@ -6900,7 +6810,6 @@ a¦ [.status]##Couchbase Server 7.6## ifdef::alt-markdown-links[] [queryNodeQuotaValPercent]: #queryNodeQuotaValPercent - endif::alt-markdown-links[] This property is available in databases running Couchbase Server 7.6.0 and later. @@ -6911,7 +6820,6 @@ The [cluster-level][queryNodeQuotaValPercent] `queryNodeQuotaValPercent` setting When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNodeQuotaValPercent]: ../n1ql-rest-settings/index.html#queryNodeQuotaValPercent - -- [%hardbreaks] @@ -6932,7 +6840,6 @@ a¦ [.status]##Couchbase Server 7.6## ifdef::alt-markdown-links[] [queryNumCpus]: #queryNumCpus - endif::alt-markdown-links[] This property is available in databases running Couchbase Server 7.6.0 and later. @@ -6949,7 +6856,6 @@ The [cluster-level][queryNumCpus] `queryNumCpus` setting specifies this property When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNumCpus]: ../n1ql-rest-settings/index.html#queryNumCpus - -- [%hardbreaks] @@ -6969,20 +6875,19 @@ ifdef::alt-markdown-links[] [queryNumAtrs]: #queryNumAtrs [numatrs_req]: #numatrs_req - endif::alt-markdown-links[] Specifies the total number of [active transaction records][additional-storage-use]. +[additional-storage-use]: /cloud/learn/data/transactions.html#active-transaction-record-entries + The [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, the [request-level][numatrs_req] `numatrs` parameter specifies this property per request. The minimum of that and the node-level `numatrs` setting is applied. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req - -- [%hardbreaks] @@ -7001,7 +6906,6 @@ ifdef::alt-markdown-links[] [queryPipelineBatch]: #queryPipelineBatch [pipeline_batch_req]: #pipeline_batch_req - endif::alt-markdown-links[] Controls the number of items execution operators can batch for Fetch from the KV. @@ -7013,7 +6917,6 @@ The minimum of that and the node-level `pipeline-batch` setting is applied. [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req - -- [%hardbreaks] @@ -7034,7 +6937,6 @@ ifdef::alt-markdown-links[] [queryPipelineCap]: #queryPipelineCap [pipeline_cap_req]: #pipeline_cap_req - endif::alt-markdown-links[] Maximum number of items each execution operator can buffer between various operators. @@ -7046,7 +6948,6 @@ The minimum of that and the node-level `pipeline-cap` setting is applied. [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req - -- [%hardbreaks] @@ -7065,7 +6966,6 @@ a¦ -- The number of service threads for transactions where the scan consistency is `request_plus` or `at_plus`. The default is 16 times the number of logical cores. - -- [%hardbreaks] @@ -7084,7 +6984,6 @@ a¦ ifdef::alt-markdown-links[] [queryPreparedLimit]: #queryPreparedLimit - endif::alt-markdown-links[] Maximum number of prepared statements in the cache. When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. @@ -7093,7 +6992,6 @@ The [cluster-level][queryPreparedLimit] `queryPreparedLimit` setting specifies t When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryPreparedLimit]: ../n1ql-rest-settings/index.html#queryPreparedLimit - -- [%hardbreaks] @@ -7113,7 +7011,6 @@ a¦ ifdef::alt-markdown-links[] [pretty_req]: #pretty_req - endif::alt-markdown-links[] Specifies whether query results are returned in pretty format. @@ -7121,7 +7018,6 @@ The [request-level][pretty_req] `pretty` parameter specifies this property per r If a request does not include this parameter, the node-level setting is used, which defaults to `false`. [pretty_req]: ../n1ql-rest-query/index.html#pretty_req - -- [%hardbreaks] @@ -7141,7 +7037,6 @@ a¦ ifdef::alt-markdown-links[] [profile_req]: #profile_req - endif::alt-markdown-links[] Specifies if there should be a profile section returned with the request results. The valid values are: @@ -7158,12 +7053,12 @@ NOTE: If `profile` is not set as one of the above values, then the profile setti Refer to [Monitoring and Profiling Details][monitor-profile-details] for more information and examples. +[monitor-profile-details]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details + The [request-level][profile_req] `profile` parameter specifies this property per request. If a request does not include this parameter, the node-level `profile` setting will be used. -[monitor-profile-details]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details [profile_req]: ../n1ql-rest-query/index.html#profile_req - -- [%hardbreaks] @@ -7202,7 +7097,6 @@ ifdef::alt-markdown-links[] [queryScanCap]: #queryScanCap [scan_cap_req]: #scan_cap_req - endif::alt-markdown-links[] Maximum buffered channel size between the indexer client and the query service for index scans. This parameter controls when to use scan backfill. @@ -7218,7 +7112,6 @@ The minimum of that and the node-level `scan-cap` setting is applied. [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req - -- [%hardbreaks] @@ -7237,7 +7130,6 @@ a¦ -- The number of service threads for the query. The default is 4 times the number of cores on the query node. - -- [%hardbreaks] @@ -7258,7 +7150,6 @@ ifdef::alt-markdown-links[] [queryTimeout]: #queryTimeout [timeout_req]: #timeout_req - endif::alt-markdown-links[] Maximum time to spend on the request before timing out (ns). @@ -7276,7 +7167,6 @@ The minimum of that and the node-level `timeout` setting is applied. [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout [timeout_req]: ../n1ql-rest-query/index.html#timeout_req - -- [%hardbreaks] @@ -7298,7 +7188,6 @@ ifdef::alt-markdown-links[] [queryTxTimeout]: #queryTxTimeout [txtimeout_req]: #txtimeout_req - endif::alt-markdown-links[] Maximum time to spend on a transaction before timing out (ns). This setting only applies to requests containing the `BEGIN TRANSACTION` statement, or to requests where the [tximplicit][tximplicit] parameter is set. @@ -7310,16 +7199,16 @@ It must not be delimited by quotes, and must not include a unit. Specify `0` (the default value) to disable. When disabled, no timeout is applied and the transaction runs for however long it takes. +[tximplicit]: ../n1ql-rest-query/index.html#tximplicit + The [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, the [request-level][txtimeout_req] `txtimeout` parameter specifies this property per request. The minimum of that and the node-level `txtimeout` setting is applied. -[tximplicit]: ../n1ql-rest-query/index.html#tximplicit [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req - -- [%hardbreaks] @@ -7340,7 +7229,6 @@ ifdef::alt-markdown-links[] [queryUseCBO]: #queryUseCBO [use_cbo_req]: #use_cbo_req - endif::alt-markdown-links[] Specifies whether the cost-based optimizer is enabled. @@ -7352,7 +7240,6 @@ If a request does not include this parameter, the node-level setting is used, wh [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req - -- [%hardbreaks] @@ -7373,7 +7260,6 @@ ifdef::alt-markdown-links[] [queryUseReplica]: #queryUseReplica [use_replica_req]: #use_replica_req - endif::alt-markdown-links[] Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. The possible values are: @@ -7384,13 +7270,6 @@ The possible values are: * `unset` — read from replica is enabled or disabled at request level. -The [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. -When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. -If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. -If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. - Do not enable read from replica when you require consistent results. Only SELECT queries that are not within a transaction can read from replica. @@ -7399,9 +7278,15 @@ Reading from replica is only possible with databases running Couchbase Server 7. Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. +The [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. +If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. +If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. + [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req - -- [%hardbreaks] @@ -7477,7 +7362,6 @@ a¦ -- This property is provided for technical support only. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7494,7 +7378,6 @@ a¦ -- This property is provided for technical support only. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7511,7 +7394,6 @@ a¦ -- The name of the prepared statement. This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. - -- [%hardbreaks] @@ -7528,7 +7410,6 @@ a¦ -- The namespace in which the prepared statement is stored. Currently, only the `default` namespace is available. - -- [%hardbreaks] @@ -7544,7 +7425,6 @@ a¦ [markdown] -- The node on which the prepared statement is stored. - -- [%hardbreaks] @@ -7594,7 +7474,6 @@ It includes the time taken by the service to schedule the request. This property is only returned when the prepared statement has been executed. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7613,7 +7492,6 @@ The mean amount of calendar time taken to complete the execution of the prepared This property is only returned when the prepared statement has been executed. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7631,7 +7509,6 @@ a¦ Date and time of last use. This property is only returned when the prepared statement has been executed. - -- [%hardbreaks] @@ -7651,7 +7528,6 @@ It includes the time taken by the service to schedule the request. This property is only returned when the prepared statement has been executed. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7670,7 +7546,6 @@ The maximum amount of calendar time taken to complete the execution of the prepa This property is only returned when the prepared statement has been executed. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7690,7 +7565,6 @@ It includes the time taken by the service to schedule the request. This property is only returned when the prepared statement has been executed. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7709,7 +7583,6 @@ The minimum amount of calendar time taken to complete the execution of the prepa This property is only returned when the prepared statement has been executed. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - -- [%hardbreaks] @@ -7798,7 +7671,6 @@ a¦ The total number of audit records sent to the server. Some requests cause more than one audit record to be emitted. Records in the output queue that have not yet been sent to the server are not counted. - -- [%hardbreaks] @@ -8025,7 +7897,6 @@ a¦ -- Number of query requests processed per second. 15-minute exponentially weighted moving average. - -- [%hardbreaks] @@ -8042,7 +7913,6 @@ a¦ -- Number of query requests processed per second. 1-minute exponentially weighted moving average. - -- [%hardbreaks] @@ -8059,7 +7929,6 @@ a¦ -- Number of query requests processed per second. 5-minute exponentially weighted moving average. - -- [%hardbreaks] @@ -8076,7 +7945,6 @@ a¦ -- End-to-end time to process a query (ns). The 75th percentile. - -- [%hardbreaks] @@ -8093,7 +7961,6 @@ a¦ -- End-to-end time to process a query (ns). The 95th percentile. - -- [%hardbreaks] @@ -8110,7 +7977,6 @@ a¦ -- End-to-end time to process a query (ns). The 99th percentile. - -- [%hardbreaks] @@ -8127,7 +7993,6 @@ a¦ -- End-to-end time to process a query (ns). The 99.9th percentile. - -- [%hardbreaks] @@ -8159,7 +8024,6 @@ a¦ -- End-to-end time to process a query (ns). The maximum value. - -- [%hardbreaks] @@ -8176,7 +8040,6 @@ a¦ -- End-to-end time to process a query (ns). The mean value. - -- [%hardbreaks] @@ -8193,7 +8056,6 @@ a¦ -- Number of query requests processed per second. Mean rate since the query service started. - -- [%hardbreaks] @@ -8210,7 +8072,6 @@ a¦ -- End-to-end time to process a query (ns). The median value. - -- [%hardbreaks] @@ -8227,7 +8088,6 @@ a¦ -- End-to-end time to process a query (ns). The minimum value. - -- [%hardbreaks] @@ -8244,7 +8104,6 @@ a¦ -- End-to-end time to process a query (ns). The standard deviation. - -- [%hardbreaks] @@ -8677,7 +8536,6 @@ a¦ -- The host memory quota. This reflects the node-quota setting. - -- [%hardbreaks] @@ -8754,7 +8612,6 @@ a¦ -- The amount of memory allocated for heap objects (bytes). This increases as heap objects are allocated, and decreases as objects are freed. - -- [%hardbreaks] @@ -8771,7 +8628,6 @@ a¦ -- The cumulative amount of memory allocated for heap objects (bytes). This increases as heap objects are allocated, but does not decrease when objects are freed. - -- [%hardbreaks] @@ -8788,7 +8644,6 @@ a¦ -- The total amount of memory obtained from the operating system (bytes). This measures the virtual address space reserved by the query engine for heaps, stacks, and other internal data structures. - -- [%hardbreaks] @@ -8820,7 +8675,6 @@ a¦ -- The total number of values allocated to contain documents or computations around documents. (This is only of relevance internally.) - -- [%hardbreaks] @@ -8852,7 +8706,6 @@ a¦ -- CPU usage. The percentage of time spent executing user code since the last time the statistics were checked. - -- [%hardbreaks] @@ -8869,7 +8722,6 @@ a¦ -- CPU usage. The percentage of time spent executing system code since the last time the statistics were checked. - -- [%hardbreaks] @@ -8976,7 +8828,6 @@ a¦ -- Number of query requests processed per second. 1-minute exponentially weighted moving average. - -- [%hardbreaks] @@ -8993,7 +8844,6 @@ a¦ -- Number of query requests processed per second. 5-minute exponentially weighted moving average. - -- [%hardbreaks] @@ -9010,7 +8860,6 @@ a¦ -- Number of query requests processed per second. 15-minute exponentially weighted moving average. - -- [%hardbreaks] @@ -9057,7 +8906,6 @@ a¦ -- End-to-end time to process a query. The mean value. - -- [%hardbreaks] @@ -9074,7 +8922,6 @@ a¦ -- End-to-end time to process a query. The median value. - -- [%hardbreaks] @@ -9091,7 +8938,6 @@ a¦ -- End-to-end time to process a query. The 80th percentile. - -- [%hardbreaks] @@ -9108,7 +8954,6 @@ a¦ -- End-to-end time to process a query. The 95th percentile. - -- [%hardbreaks] @@ -9125,7 +8970,6 @@ a¦ -- End-to-end time to process a query. The 99th percentile. - -- [%hardbreaks] @@ -9157,7 +9001,6 @@ a¦ -- Number of servicers temporarily paused due to memory pressure. (Applies to serverless environments only.) - -- [%hardbreaks] @@ -9174,7 +9017,6 @@ a¦ -- Number of times servicers have been temporarily paused. (Applies to serverless environments only.) - -- [%hardbreaks] @@ -9191,7 +9033,6 @@ a¦ -- High water mark for temp space use directly by query. (Doesn't include use by the GSI and Search clients.) - -- [%hardbreaks] @@ -9208,7 +9049,6 @@ a¦ -- Current Query temp space use. (Doesn't include use by the GSI and Search clients.) - -- [%hardbreaks] @@ -9270,7 +9110,6 @@ a¦ Integer -- The Admin API supports admin credentials. Credentials can be passed via HTTP headers (HTTP basic authentication). - -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-functions/pages/index.adoc b/docs/modules/n1ql-rest-functions/pages/index.adoc index f7ddd5b7..48f8032c 100644 --- a/docs/modules/n1ql-rest-functions/pages/index.adoc +++ b/docs/modules/n1ql-rest-functions/pages/index.adoc @@ -1203,6 +1203,7 @@ endif::collapse-models[] ¦ Property ¦ ¦ Schema a¦ + _additional + property_ a¦ diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index d12ee28a..00985240 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -27,13 +27,12 @@ include::{specDir}overview/document-before.adoc[opts=optional] -- The Query Service REST API is provided by the Query service. This API enables you to run SQL++ queries and set request-level parameters. - -- [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information @@ -801,7 +800,6 @@ One of the following SQL++ severity levels, listed in order of severity: 2. Error 3. Warn 4. Info - -- [%hardbreaks] @@ -975,7 +973,6 @@ ifdef::model-descriptions[] Present only if `profile` was set to `"timings"` in the [Request Parameters](#Request). The execution details for various phases involved in the query execution, such as kernel and service execution times, number of documents processed at each query operator in each phase, and number of phase switches. - //end::desc-Execution_Timings[] endif::model-descriptions[] @@ -1319,7 +1316,6 @@ a¦ [markdown] -- Count of documents processed at selective phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. - -- [%hardbreaks] @@ -1342,7 +1338,6 @@ A join would probably involve two or more fetches, one per keyspace. A union select would have twice as many operator counts, one per each branch of the union. This is in essence the count of all the operators in the `executionTimings` object. - -- [%hardbreaks] @@ -1359,7 +1354,6 @@ a¦ [markdown] -- Cumulative execution times for various phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. - -- [%hardbreaks] @@ -1508,7 +1502,6 @@ The value is an array of JSON values, one for each positional parameter in the s Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for details. [section_srh_tlm_n1b]: /cloud/n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b - -- [%hardbreaks] @@ -1527,7 +1520,6 @@ a¦ ifdef::alt-markdown-links[] [atrcollection-srv]: #atrcollection-srv - endif::alt-markdown-links[] Specifies the collection where the [active transaction record][additional-storage-use] (ATR) is stored. The collection must be present. @@ -1536,8 +1528,12 @@ If not specified, the ATR is stored in the default collection in the default sco The value must be a string in the form `"bucket.scope.collection"` or `"namespace:bucket.scope.collection"`. If any part of the path contains a special character, that part of the path must be delimited in backticks ``. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +The [node-level][atrcollection-srv] `atrcollection` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. + +[atrcollection-srv]: ../n1ql-rest-admin/index.html#atrcollection-srv -- [%hardbreaks] @@ -1559,7 +1555,6 @@ This saves you from having to make two separate requests in cases where you want Refer to [Auto-Execute][auto-execute] for more information. [auto-execute]: /cloud/n1ql/n1ql-language-reference/prepare.html#auto-execute - -- [%hardbreaks] @@ -1581,7 +1576,6 @@ SQL++ is agnostic about the content of this parameter; it is just echoed in the * Maximum allowed size is 64 characters; all others will be cut. * If it contains an escape character `/` or quote `"`, it will be rejected as error code 1110. - -- [%hardbreaks] @@ -1599,7 +1593,6 @@ a¦ Compression format to use for response data on the wire. Values are case-insensitive. - -- [%hardbreaks] @@ -1620,7 +1613,6 @@ a¦ ifdef::alt-markdown-links[] [controls-srv]: #controls-srv - endif::alt-markdown-links[] Specifies if there should be a controls section returned with the request results. @@ -1628,6 +1620,10 @@ When set to `true`, the query response document includes a controls section with If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. +The [node-level][controls-srv] `controls` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. + +[controls-srv]: ../n1ql-rest-admin/index.html#controls-srv -- [%hardbreaks] @@ -1645,7 +1641,7 @@ a¦ -- The level of [durability][durability] for mutations produced by the request. -If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the [tximplicit](#tximplicit) parameter set to `true`, the durability level is specified for all mutations within that transaction. +If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, the durability level is specified for all mutations within that transaction. Durability is also supported for non-transactional DML statements. In this case, the `kvtimeout` parameter is used as the durability timeout. @@ -1654,7 +1650,6 @@ If not specified, the default durability level is `"majority"`. Set the durability level to `"none"` or `""` to specify no durability. [durability]: /server/7.6/learn/data/durability.html - -- [%hardbreaks] @@ -1672,9 +1667,8 @@ a¦ [markdown] -- -In databases running Couchbase Server 6.5 and later, this parameter is ignored and has no effect. +In Couchbase Server 6.5 and later, this parameter is ignored and has no effect. It is included for compatibility with previous versions of Couchbase Server. - -- [%hardbreaks] @@ -1692,7 +1686,6 @@ a¦ Desired character encoding for the query results. Only possible value is `UTF-8` and is case-insensitive. - -- [%hardbreaks] @@ -1711,7 +1704,6 @@ a¦ Desired format for the query results. Values are case-insensitive. - -- [%hardbreaks] @@ -1747,7 +1739,6 @@ Valid units are: Specify a duration of `0` or a negative duration to disable. When disabled, no timeout is applied and the KV operation runs for however long it takes. - -- [%hardbreaks] @@ -1768,12 +1759,23 @@ ifdef::alt-markdown-links[] [max-parallelism-srv]: #max-parallelism-srv [queryMaxParallelism]: #queryMaxParallelism - endif::alt-markdown-links[] Specifies the maximum parallelism for the query. The default value is the same as the number of partitions of the index selected for the query. +The [node-level][max-parallelism-srv] `max-parallelism` setting specifies the ceiling for this parameter for a single node. +If the request-level parameter is zero or negative, the parallelism for the query is set to the node-level setting. +If the request-level parameter is greater than zero and less than the node-level setting, the request-level parameter overrides the node-level setting. +If the request-level parameter is greater than the node-level setting, the parallelism for the query is set to the node-level setting. + +In addition, the [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies the ceiling for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. + +[max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv +[queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism -- [%hardbreaks] @@ -1793,7 +1795,6 @@ ifdef::alt-markdown-links[] [memory-quota-srv]: #memory-quota-srv [queryMemoryQuota]: #queryMemoryQuota - endif::alt-markdown-links[] Specifies the maximum amount of memory the request may use, in MB. @@ -1807,6 +1808,15 @@ process a request, such as the stack, the operators, or some intermediate values Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). +The [node-level][memory-quota-srv] `memory-quota` setting specifies the ceiling for this parameter for a single node. +If the node-level setting is zero (the default), the request-level parameter overrides the node-level setting. +If the node-level setting is greater than zero, the request-level parameter is capped by the node-level setting. + +In addition, the [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies the ceiling for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv +[queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota -- [%hardbreaks] @@ -1861,13 +1871,20 @@ ifdef::alt-markdown-links[] [numatrs-srv]: #numatrs-srv [queryNumAtrs]: #queryNumAtrs - endif::alt-markdown-links[] Specifies the total number of [active transaction records][additional-storage-use]. Must be a positive integer. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + +The [node-level][numatrs-srv] `numatrs` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. + +In addition, the [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. +[numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv +[queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs -- [%hardbreaks] @@ -1888,10 +1905,17 @@ ifdef::alt-markdown-links[] [pipeline-batch-srv]: #pipeline-batch-srv [queryPipelineBatch]: #queryPipelineBatch - endif::alt-markdown-links[] Controls the number of items execution operators can batch for Fetch from the KV. +The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. + +In addition, the [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv +[queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch -- [%hardbreaks] @@ -1911,10 +1935,17 @@ ifdef::alt-markdown-links[] [pipeline-cap-srv]: #pipeline-cap-srv [queryPipelineCap]: #queryPipelineCap - endif::alt-markdown-links[] Maximum number of items each execution operator can buffer between various operators. +The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. + +In addition, the [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv +[queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap -- [%hardbreaks] @@ -1938,7 +1969,6 @@ Refer to [EXECUTE][execute] for examples. If both `prepared` and `statement` are present and non-empty, an error is returned. [execute]: /cloud/n1ql/n1ql-language-reference/execute.html - -- [%hardbreaks] @@ -1962,7 +1992,6 @@ If the DML statement explicitly specifies the document expiration, the statement If `false`, document expiration is set to 0 when modified by a DML statement, unless the DML statement explicitly specifies the document expiration. Not supported for statements in a transaction. - -- [%hardbreaks] @@ -1982,10 +2011,13 @@ a¦ ifdef::alt-markdown-links[] [pretty-srv]: #pretty-srv - endif::alt-markdown-links[] Specifies the query results returned in pretty format. +The [node-level][pretty-srv] `pretty` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. + +[pretty-srv]: ../n1ql-rest-admin/index.html#pretty-srv -- [%hardbreaks] @@ -2004,7 +2036,6 @@ a¦ ifdef::alt-markdown-links[] [profile-srv]: #profile-srv - endif::alt-markdown-links[] Specifies if there should be a profile section returned with the request results. The valid values are: @@ -2021,6 +2052,10 @@ This information will be included in the `system:active_requests` and `system:co If `profile` is not set as one of the above values, then the profile setting does not change. +The [node-level][profile-srv] `profile` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. + +[profile-srv]: ../n1ql-rest-admin/index.html#profile-srv -- [%hardbreaks] @@ -2042,7 +2077,6 @@ Specifies the namespace, bucket, and scope used to resolve partial keyspace refe The query context may be a _full path_, containing namespace, bucket, and scope; or a _relative path_, containing just the bucket and scope. Currently, only the `default` namespace is available. If the namespace name is omitted, the default namespace in the current session is used. - -- [%hardbreaks] @@ -2071,7 +2105,6 @@ If `readonly` is `true`, then the following statements are not allowed: * UPSERT When using GET requests, it's best to set `readonly` to `true`. - -- [%hardbreaks] @@ -2092,7 +2125,6 @@ ifdef::alt-markdown-links[] [scan-cap-srv]: #scan-cap-srv [queryScanCap]: #queryScanCap - endif::alt-markdown-links[] Maximum buffered channel size between the indexer client and the query service for index scans. This parameter controls when to use scan backfill. @@ -2100,6 +2132,14 @@ This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. +The [node-level][scan-cap-srv] `scan-cap` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. + +In addition, the [cluster-level][queryScanCap] `queryScanCap` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv +[queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap -- [%hardbreaks] @@ -2143,11 +2183,10 @@ Values are case-insensitive. For multi-statement requests, the default behavior is RYOW within each request. If you want to disable RYOW within a request, add a separate `request_consistency` parameter that can be set to `not_bounded`. -If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the [tximplicit](#tximplicit) parameter set to `true`, then this parameter sets the transactional scan consistency. +If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, then this parameter sets the transactional scan consistency. Refer to [Transactional Scan Consistency][transactional-scan-consistency] for details. [transactional-scan-consistency]: /cloud/n1ql/n1ql-manage/query-settings.html#transactional-scan-consistency - -- [%hardbreaks] @@ -2182,7 +2221,6 @@ Scan vectors have two forms: Note that `scan_vector` can only be used if the query uses at most one keyspace; if it is used for a query referencing more than one keyspace, the query will fail with an error. For queries referencing multiple keyspaces, use `scan_vectors`. - -- [%hardbreaks] @@ -2204,7 +2242,6 @@ A map from keyspace names to scan vectors. See `scan_vector`. The scan vectors can be Full or Sparse. - -- [%hardbreaks] @@ -2237,7 +2274,6 @@ Valid units are: * `h` (hours) Specify `0` or a negative integer to disable. - -- [%hardbreaks] @@ -2274,7 +2310,6 @@ a¦ If `true`, causes statement projection terms to be sorted alphabetically. If `false` (the default), statement projection terms are returned in the order specified by the query. - -- [%hardbreaks] @@ -2304,7 +2339,6 @@ If it does, the Query Service responds with error 1040. To avoid this, either URL-encode the semicolon as `%3B`, or just omit the semicolon if possible. This restriction does not apply when specifying the request parameters in JSON format. - -- [%hardbreaks] @@ -2324,7 +2358,6 @@ ifdef::alt-markdown-links[] [timeout-srv]: #timeout-srv [queryTimeout]: #queryTimeout - endif::alt-markdown-links[] Maximum time to spend on the request before timing out. @@ -2342,9 +2375,18 @@ Valid units are: Specify a duration of `0` or a negative duration to disable. When disabled, no timeout is applied and the request runs for however long it takes. -If [tximplicit](#tximplicit) or [txid](#txid) is set, this parameter is ignored. +If `tximplicit` or `txid` is set, this parameter is ignored. The request inherits the remaining time of the transaction as timeout. +The [node-level][timeout-srv] `timeout` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. +However, if the node-level setting is greater than 0, the timeout for the query is limited to the node-level setting. + +In addition, the [cluster-level][queryTimeout] `queryTimeout` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv +[queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout -- [%hardbreaks] @@ -2362,7 +2404,6 @@ a¦ -- Transaction data. For internal use only. - -- [%hardbreaks] @@ -2385,7 +2426,6 @@ For use with DML statements within a transaction, rollbacks, and commits. The transaction ID should be the same as the transaction ID generated by the `BEGIN TRANSACTION` statement. The transaction must be active and non-expired. - -- [%hardbreaks] @@ -2407,8 +2447,7 @@ When this parameter is true, the Query service starts a transaction and executes If execution is successful, the Query service commits the transaction; otherwise the transaction is rolled back. The statement may not be part of an ongoing transaction. -If the [txid](#txid) request-level parameter is set, the `tximplicit` parameter is ignored. - +If the `txid` request-level parameter is set, the `tximplicit` parameter is ignored. -- [%hardbreaks] @@ -2428,7 +2467,6 @@ a¦ Transaction statement number. The transaction statement number must be a positive integer, and must be higher than any previous transaction statement numbers in the transaction. If the transaction statement number is lower than the transaction statement number for any previous statement, an error is generated. - -- [%hardbreaks] @@ -2448,13 +2486,12 @@ ifdef::alt-markdown-links[] [txtimeout-srv]: #txtimeout-srv [queryTxTimeout]: #queryTxTimeout - endif::alt-markdown-links[] Maximum time to spend on a transaction before timing out. -Only applies to `BEGIN TRANSACTION` statements, or DML statements for which [tximplicit](#tximplicit) is set. +Only applies to `BEGIN TRANSACTION` statements, or DML statements for which `tximplicit` is set. For other statements, it is ignored. -Within a transaction, the request-level [timeout](#timeout_req) parameter is ignored. +Within a transaction, the request-level `timeout` parameter is ignored. The transaction timeout clock starts when the `BEGIN WORK` statement is successful. Once the transaction timeout is reached, no statement is allowed to continue in the transaction. @@ -2474,6 +2511,15 @@ When disabled, the request-level timeout is set to the default. The default is `"15s"` for cbq files or scripts, `"2m"` for interactive cbq sessions or redirected input. +The [node-level][txtimeout-srv] `txtimeout` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. +However, if the node-level setting is greater than 0, the transaction timeout for the query is limited to the node-level setting. + +In addition, the [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv +[queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout -- [%hardbreaks] @@ -2493,10 +2539,17 @@ ifdef::alt-markdown-links[] [use-cbo-srv]: #use-cbo-srv [queryUseCBO]: #queryUseCBO - endif::alt-markdown-links[] Specifies whether the cost-based optimizer is enabled. +The [node-level][use-cbo-srv] `use-cbo` setting specifies the default for this parameter for a single node. +The request-level parameter overrides the node-level setting. + +In addition, the [cluster-level][queryUseCBO] `queryUseCBO` setting specifies the default for this parameter for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv +[queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO -- [%hardbreaks] @@ -2508,7 +2561,7 @@ a¦ Boolean a¦ [#use_fts] *use_fts* + _optional_ -a¦ +a¦ [.edition]##{enterprise}## [markdown] -- @@ -2523,7 +2576,6 @@ If none of the available Search indexes are qualified, the available GSI indexes Refer to [Flex Indexes][flex-indexes] for more information. [flex-indexes]: /cloud/n1ql/n1ql-language-reference/flex-indexes.html - -- [%hardbreaks] @@ -2536,7 +2588,7 @@ a¦ Boolean a¦ [#use_replica_req] *use_replica* + _optional_ -a¦ [.status]##Couchbase Server 7.6## +a¦ [markdown] -- @@ -2544,7 +2596,6 @@ ifdef::alt-markdown-links[] [use-replica-srv]: #use-replica-srv [queryUseReplica]: #queryUseReplica - endif::alt-markdown-links[] Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. The possible values are: @@ -2564,6 +2615,15 @@ Reading from replica is only possible with databases running Couchbase Server 7. Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. +The [node-level][use-replica-srv] `use-replica` setting specifies the default for this property for a single node. +The request-level parameter usually overrides the node-level setting. +However, when the node-level setting is `off`, the request-level parameter cannot enable the property. + +In addition, the [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. +When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + +[use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv +[queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica -- [%hardbreaks] @@ -2575,6 +2635,7 @@ a¦ String a¦ [#identifier] +*{lt}$identifier{gt}* + _additional + property_ a¦ @@ -2596,7 +2657,6 @@ The value of the named parameter can be any JSON value. Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for details. [section_srh_tlm_n1b]: /cloud/n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b - -- [%hardbreaks] @@ -2932,7 +2992,7 @@ Time spent waiting to be scheduled for CPU time. a¦ String (duration) -a¦ [#serv_time] +a¦ *servTime* + _optional_ a¦ @@ -2944,7 +3004,6 @@ Time spent waiting for another service, such as index or data. For index scan, it is time spent waiting for GSI/indexer. For fetch, it is time spent waiting on the KV store. - -- [%hardbreaks] @@ -3007,7 +3066,6 @@ include::{specDir}security/document-begin.adoc[opts=optional] -- Specify a user name and password via HTTP headers. This method can only be used to provide a single credential. - -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index 9858a25d..e28a4277 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -921,7 +921,6 @@ Defines whether the user has access to all URLs, or only URLs specified by the a This field set must be set to `false` to enable the `allowed_urls` and `disallowed_urls` fields. Setting this field to `true` enables access to all endpoints. - -- [%hardbreaks] @@ -944,7 +943,6 @@ For example, if you wish to allow access to all Google APIs, add the URL `https: To allow complete access to `localhost`, use `http://localhost`. Note that each URL must include the port, protocol, and all other components of the URL. - -- [%hardbreaks] @@ -966,7 +964,6 @@ The CURL() function will disallow any URL that starts with this value. If both `allowed_urls` and `disallowed_urls` fields are populated, the `disallowed_urls` field takes precedence over `allowed_urls`. Note that each URL must include the port, protocol, and all other components of the URL. - -- [%hardbreaks] @@ -1025,7 +1022,6 @@ a¦ ifdef::alt-markdown-links[] [cleanupclientattempts]: #cleanupclientattempts - endif::alt-markdown-links[] When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. @@ -1033,7 +1029,6 @@ The [node-level][cleanupclientattempts] `cleanupclientattempts` setting specifie When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanupclientattempts]: ../n1ql-rest-admin/index.html#cleanupclientattempts - -- [%hardbreaks] @@ -1053,7 +1048,6 @@ a¦ ifdef::alt-markdown-links[] [cleanuplostattempts]: #cleanuplostattempts - endif::alt-markdown-links[] When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. @@ -1061,7 +1055,6 @@ The [node-level][cleanuplostattempts] `cleanuplostattempts` setting specifies th When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanuplostattempts]: ../n1ql-rest-admin/index.html#cleanuplostattempts - -- [%hardbreaks] @@ -1081,7 +1074,6 @@ a¦ ifdef::alt-markdown-links[] [cleanupwindow]: #cleanupwindow - endif::alt-markdown-links[] Specifies how frequently the Query service checks its subset of [active transaction records][additional-storage-use] for cleanup. Decreasing this setting causes expiration transactions to be found more swiftly, with the tradeoff of increasing the number of reads per second used for the scanning process. @@ -1097,12 +1089,12 @@ Valid units are: * `m` (minutes) * `h` (hours) +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + The [node-level][cleanupwindow] `cleanupwindow` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [cleanupwindow]: ../n1ql-rest-admin/index.html#cleanupwindow - -- [%hardbreaks] @@ -1122,7 +1114,6 @@ a¦ ifdef::alt-markdown-links[] [completed-limit]: #completed-limit - endif::alt-markdown-links[] Sets the number of requests to be logged in the completed requests catalog. As new completed requests are added, old ones are removed. @@ -1131,12 +1122,12 @@ Increase this when the completed request keyspace is not big enough to track the Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. +[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + The [node-level][completed-limit] `completed-limit` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[sys-completed-config]: /capella/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [completed-limit]: ../n1ql-rest-admin/index.html#completed-limit - -- [%hardbreaks] @@ -1156,10 +1147,7 @@ a¦ ifdef::alt-markdown-links[] [completed-max-plan-size]: #completed-max-plan-size - endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - A plan size in bytes. Limits the size of query execution plans that can be logged in the completed requests catalog. Values larger than the maximum limit are silently treated as the maximum limit. @@ -1168,12 +1156,12 @@ You must obtain execution plans for such queries via profiling or using the EXPL Refer to [Configure the Completed Requests][sys-completed-config] for more information. +[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + The [node-level][completed-max-plan-size] `completed-max-plan-size` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[sys-completed-config]: /capella/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [completed-max-plan-size]: ../n1ql-rest-admin/index.html#completed-max-plan-size - -- [%hardbreaks] @@ -1194,7 +1182,6 @@ a¦ ifdef::alt-markdown-links[] [completed-threshold]: #completed-threshold - endif::alt-markdown-links[] A duration in milliseconds. All completed queries lasting longer than this threshold are logged in the completed requests catalog. @@ -1204,12 +1191,12 @@ Specify any negative number to track none. Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. +[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + The [node-level][completed-threshold] `completed-threshold` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. -[sys-completed-config]: /capella/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [completed-threshold]: ../n1ql-rest-admin/index.html#completed-threshold - -- [%hardbreaks] @@ -1229,7 +1216,6 @@ a¦ ifdef::alt-markdown-links[] [loglevel]: #loglevel - endif::alt-markdown-links[] Log level used in the logger. @@ -1259,7 +1245,6 @@ The [node-level][loglevel] `loglevel` setting specifies this property for a sing When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [loglevel]: ../n1ql-rest-admin/index.html#loglevel - -- [%hardbreaks] @@ -1281,7 +1266,6 @@ ifdef::alt-markdown-links[] [max-parallelism-srv]: #max-parallelism-srv [max_parallelism_req]: #max_parallelism_req - endif::alt-markdown-links[] Specifies the maximum parallelism for queries on all Query nodes in the cluster. @@ -1292,6 +1276,10 @@ Similarly, if the value is greater than the number of allowed cores, the maximum In Community Edition, the number of allowed cores cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed cores.) +Refer to [Max Parallelism][max-parallelism] for more information. + +[max-parallelism]: /server/8.0/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism + The [node-level][max-parallelism-srv] `max-parallelism` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1300,12 +1288,8 @@ If a request includes this parameter, it will be capped by the node-level `max-p NOTE: To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. -Refer to [Max Parallelism][max-parallelism] for more information. - -[max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req - -- [%hardbreaks] @@ -1326,7 +1310,6 @@ ifdef::alt-markdown-links[] [memory-quota-srv]: #memory-quota-srv [memory_quota_req]: #memory_quota_req - endif::alt-markdown-links[] Specifies the maximum amount of memory a request may use on any Query node in the cluster, in MB. @@ -1345,7 +1328,6 @@ If a request includes this parameter, it will be capped by the node-level `memor [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req - -- [%hardbreaks] @@ -1365,7 +1347,6 @@ a¦ ifdef::alt-markdown-links[] [n1ql-feat-ctrl]: #n1ql-feat-ctrl - endif::alt-markdown-links[] SQL++ feature control. This setting is provided for technical support only. @@ -1374,7 +1355,6 @@ The [node-level][n1ql-feat-ctrl] `n1ql-feat-ctrl` setting specifies this propert When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [n1ql-feat-ctrl]: ../n1ql-rest-admin/index.html#n1ql-feat-ctrl - -- [%hardbreaks] @@ -1392,10 +1372,7 @@ a¦ ifdef::alt-markdown-links[] [node-quota]: #node-quota - endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - Sets the soft memory limit for the Query service on every Query node in the cluster, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. @@ -1413,7 +1390,6 @@ The [node-level][node-quota] `node-quota` setting specifies this property for a When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [node-quota]: ../n1ql-rest-admin/index.html#node-quota - -- [%hardbreaks] @@ -1432,10 +1408,7 @@ a¦ ifdef::alt-markdown-links[] [node-quota-val-percent]: #node-quota-val-percent - endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - The percentage of the `queryNodeQuota` that is dedicated to tracked value content memory across all active requests for every Query node in the cluster. (The `queryMemoryQuota` setting specifies the maximum amount of document memory an individual request may use on any Query node in the cluster.) @@ -1443,7 +1416,6 @@ The [node-level][node-quota-val-percent] `node-quota-val-percent` setting specif When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [node-quota-val-percent]: ../n1ql-rest-admin/index.html#node-quota-val-percent - -- [%hardbreaks] @@ -1465,20 +1437,19 @@ ifdef::alt-markdown-links[] [numatrs-srv]: #numatrs-srv [numatrs_req]: #numatrs_req - endif::alt-markdown-links[] Specifies the total number of [active transaction records][additional-storage-use] for all Query nodes in the cluster. +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + The [node-level][numatrs-srv] `numatrs` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, there is a [request-level][numatrs_req] `numatrs` parameter. If a request includes this parameter, it will be capped by the node-level `numatrs` setting. -[additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req - -- [%hardbreaks] @@ -1500,10 +1471,7 @@ a¦ ifdef::alt-markdown-links[] [num-cpus]: #num-cpus - endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - The number of CPUs the Query service can use on any Query node in the cluster. Note that this setting requires a restart of the Query service to take effect. @@ -1517,7 +1485,6 @@ The [node-level][num-cpus] `num-cpus` setting specifies this property for a sing When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [num-cpus]: ../n1ql-rest-admin/index.html#num-cpus - -- [%hardbreaks] @@ -1537,7 +1504,6 @@ ifdef::alt-markdown-links[] [pipeline-batch-srv]: #pipeline-batch-srv [pipeline_batch_req]: #pipeline_batch_req - endif::alt-markdown-links[] Controls the number of items execution operators can batch for Fetch from the KV. @@ -1549,7 +1515,6 @@ The minimum of that and the node-level `pipeline-batch` setting is applied. [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req - -- [%hardbreaks] @@ -1570,7 +1535,6 @@ ifdef::alt-markdown-links[] [pipeline-cap-srv]: #pipeline-cap-srv [pipeline_cap_req]: #pipeline_cap_req - endif::alt-markdown-links[] Maximum number of items each execution operator can buffer between various operators. @@ -1582,7 +1546,6 @@ The minimum of that and the node-level `pipeline-cap` setting is applied. [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req - -- [%hardbreaks] @@ -1602,7 +1565,6 @@ a¦ ifdef::alt-markdown-links[] [prepared-limit]: #prepared-limit - endif::alt-markdown-links[] Maximum number of prepared statements in the cache. When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. @@ -1611,7 +1573,6 @@ The [node-level][prepared-limit] `prepared-limit` setting specifies this propert When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [prepared-limit]: ../n1ql-rest-admin/index.html#prepared-limit - -- [%hardbreaks] @@ -1632,7 +1593,6 @@ ifdef::alt-markdown-links[] [scan-cap-srv]: #scan-cap-srv [scan_cap_req]: #scan_cap_req - endif::alt-markdown-links[] Maximum buffered channel size between the indexer client and the query service for index scans. This parameter controls when to use scan backfill. @@ -1648,7 +1608,6 @@ The minimum of that and the node-level `scan-cap` setting is applied. [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req - -- [%hardbreaks] @@ -1669,7 +1628,6 @@ ifdef::alt-markdown-links[] [timeout-srv]: #timeout-srv [timeout_req]: #timeout_req - endif::alt-markdown-links[] Maximum time to spend on the request before timing out (ns). @@ -1687,7 +1645,6 @@ The minimum of that and the node-level `timeout` setting is applied. [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv [timeout_req]: ../n1ql-rest-query/index.html#timeout_req - -- [%hardbreaks] @@ -1709,7 +1666,6 @@ ifdef::alt-markdown-links[] [txtimeout-srv]: #txtimeout-srv [txtimeout_req]: #txtimeout_req - endif::alt-markdown-links[] Maximum time to spend on a transaction before timing out. This setting only applies to requests containing the `BEGIN TRANSACTION` statement, or to requests where the [tximplicit][tximplicit] parameter is set. @@ -1729,16 +1685,16 @@ Valid units are: Specify `0ms` (the default value) to disable. When disabled, no timeout is applied and the transaction runs for however long it takes. +[tximplicit]: ../n1ql-rest-query/index.html#tximplicit + The [node-level][txtimeout-srv] `txtimeout` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, there is a [request-level][txtimeout_req] `txtimeout` parameter. If a request includes this parameter, it will be capped by the node-level `txtimeout` setting. -[tximplicit]: ../n1ql-rest-query/index.html#tximplicit [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req - -- [%hardbreaks] @@ -1761,7 +1717,6 @@ The specified path must already exist. Only absolute paths are allowed. The default path is `var/lib/couchbase/tmp` within the Couchbase Server installation directory. - -- [%hardbreaks] @@ -1783,7 +1738,6 @@ Setting the size to `0` disables backfill. Setting the size to `-1` means the size is unlimited. The maximum size is limited only by the available disk space. - -- [%hardbreaks] @@ -1804,7 +1758,6 @@ ifdef::alt-markdown-links[] [use-cbo-srv]: #use-cbo-srv [use_cbo_req]: #use_cbo_req - endif::alt-markdown-links[] Specifies whether the cost-based optimizer is enabled. @@ -1816,7 +1769,6 @@ If a request does not include this parameter, the node-level setting is used, wh [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req - -- [%hardbreaks] @@ -1837,7 +1789,6 @@ ifdef::alt-markdown-links[] [use-replica-srv]: #use-replica-srv [use_replica_req]: #use_replica_req - endif::alt-markdown-links[] Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. The possible values are: @@ -1848,24 +1799,23 @@ The possible values are: * `unset` — read from replica is enabled or disabled at request level. -The [node-level][use-replica-srv] `use-replica` setting specifies this property for a single node. -When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - -In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. -If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. -If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. - Do not enable read from replica when you require consistent results. Only SELECT queries that are not within a transaction can read from replica. -Reading from replica is only possible with databases running Couchbase Server 7.6.0 or later. +Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 or later. Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. +The [node-level][use-replica-srv] `use-replica` setting specifies this property for a single node. +When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. + +In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. +If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. +If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. + [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req - -- [%hardbreaks] diff --git a/src/admin/swagger/admin.yaml b/src/admin/swagger/admin.yaml index 2fe84e7b..69f592a9 100644 --- a/src/admin/swagger/admin.yaml +++ b/src/admin/swagger/admin.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: Query Admin REST API version: capella - description: | + description: |- The Query Admin REST API is a secondary API provided by the Query service. This API enables you to retrieve statistics about the clusters and nodes running the Query service; view or specify node-level settings; and view or delete requests. @@ -155,7 +155,7 @@ paths: get: operationId: get_prepareds summary: Retrieve All Prepared Statements - description: | + description: |- Returns all prepared statements. tags: - prepared statements @@ -177,7 +177,7 @@ paths: summary: Retrieve a Prepared Statement parameters: - $ref: "#/components/parameters/PathName" - description: | + description: |- Returns the specified prepared statement. tags: - prepared statements @@ -195,7 +195,7 @@ paths: summary: Delete a Prepared Statement parameters: - $ref: "#/components/parameters/PathName" - description: | + description: |- Deletes the specified prepared statement. tags: - prepared statements @@ -215,7 +215,7 @@ paths: get: operationId: get_active_requests summary: Retrieve All Active Requests - description: | + description: |- Returns all active query requests. tags: - active requests @@ -237,7 +237,7 @@ paths: summary: Retrieve an Active Request parameters: - $ref: "#/components/parameters/PathRequest" - description: | + description: |- Returns the specified active query request. tags: - active requests @@ -255,7 +255,7 @@ paths: summary: Delete an Active Request parameters: - $ref: "#/components/parameters/PathRequest" - description: | + description: |- Terminates the specified active query request. tags: - active requests @@ -275,7 +275,7 @@ paths: get: operationId: get_completed_requests summary: Retrieve All Completed Requests - description: | + description: |- Returns all completed requests. tags: - completed requests @@ -297,7 +297,7 @@ paths: summary: Retrieve a Completed Request parameters: - $ref: "#/components/parameters/PathRequest" - description: | + description: |- Returns the specified completed request. tags: - completed requests @@ -315,7 +315,7 @@ paths: summary: Delete a Completed Request parameters: - $ref: "#/components/parameters/PathRequest" - description: | + description: |- Purges the specified completed request. tags: - completed requests @@ -335,7 +335,7 @@ paths: get: operationId: get_prepared_indexes summary: Retrieve Prepared Index Statements - description: | + description: |- Returns all prepared index statements. * Use [Retrieve a Prepared Statement](#get_prepared) to get information about a prepared index statement. @@ -353,7 +353,7 @@ paths: type: array items: type: string - description: | + description: |- The name of the prepared statement. This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. @@ -361,7 +361,7 @@ paths: get: operationId: get_active_indexes summary: Retrieve Active Index Requests - description: | + description: |- Returns all active index requests. * Use [Retrieve an Active Request](#get_active_request) to get information about an active index request. @@ -385,7 +385,7 @@ paths: get: operationId: get_completed_indexes summary: Retrieve Completed Index Requests - description: | + description: |- Returns all completed index requests. * Use [Retrieve a Completed Request](#get_completed_request) to get information about a completed index request. @@ -424,7 +424,7 @@ paths: get: operationId: get_gc summary: Run Garbage Collector - description: | + description: |- This endpoint is available in databases running Couchbase Server 7.6.0 and later. Runs the garbage collector. @@ -442,7 +442,7 @@ paths: schema: $ref: "#/components/schemas/Garbage" 401: - description: | + description: |- Error 10000: authentication failure. The invoking user is not a valid full-admin user. content: @@ -452,7 +452,7 @@ paths: post: operationId: post_gc summary: Run Garbage Collector and Release Memory - description: | + description: |- This endpoint is available in databases running Couchbase Server 7.6.0 and later. Runs the garbage collector and attempts to return freed memory to the OS. @@ -470,7 +470,7 @@ paths: schema: $ref: "#/components/schemas/Garbage" 401: - description: | + description: |- Error 10000: authentication failure. The invoking user is not a valid full-admin user. content: @@ -486,7 +486,7 @@ paths: get: operationId: get_vitals summary: Retrieve Vitals - description: | + description: |- Returns data about the running state and health of the query engine. This information can be very useful to assess the current workload and performance characteristics of a query engine, and hence load-balance the requests being sent to various query engines. tags: @@ -512,7 +512,7 @@ paths: - Default: [] responses: 200: - description: | + description: |- An object containing all statistics. Each statistic consists of a top-level statistic name and a metric name. Each statistic has a different set of metrics. @@ -534,7 +534,7 @@ paths: - Default: [] responses: 200: - description: | + description: |- An object containing all metrics for the specified statistic. Each statistic has a different set of metrics. content: @@ -562,7 +562,7 @@ paths: get: operationId: get_settings summary: Retrieve Node-Level Query Settings - description: | + description: |- Returns node-level query settings. tags: - settings @@ -578,7 +578,7 @@ paths: post: operationId: post_settings summary: Update Node-Level Query Settings - description: | + description: |- Updates node-level query settings. tags: - settings @@ -653,26 +653,18 @@ components: properties: clientContextID: type: string - description: | + description: |- The opaque ID or context provided by the client. + x-desc-more: |- Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. [client_context_id]: ../n1ql-rest-query/index.html#client_context_id - x-desc-refs: | + x-desc-refs: |- [client_context_id]: #client_context_id - cpuTime: - type: string - format: duration - description: | - The total sum of [execTime][exec_time] across all operators. - - [exec_time]: ../n1ql-rest-query/index.html#exec_time - x-has-example: true - example: "90.734075ms" elapsedTime: type: string format: duration - description: | + description: |- The time taken from when the request was acknowledged by the service to when the request was completed. It includes the time taken by the service to schedule the request. errorCount: @@ -689,7 +681,7 @@ components: example: "752.858519ms" memoryQuota: type: integer - description: | + description: |- The memory quota for the request, in MB. This property is only returned if a memory quota is set for the query. node: @@ -697,7 +689,7 @@ components: description: IP address and port number of the node where the query is executed. phaseCounts: type: object - description: | + description: |- Count of documents processed at selective phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. For active requests, this property is dynamic, depending on the documents processed by various phases up to this moment in time. @@ -710,7 +702,7 @@ components: x-has-example: true phaseOperators: type: object - description: | + description: |- Indicates the numbers of each kind of query operator involved in different phases of the query processing. For instance, a non-covering index path might involve one index scan and one fetch operator. @@ -725,7 +717,7 @@ components: x-has-example: true phaseTimes: type: object - description: | + description: |- Cumulative execution times for various phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. For active requests, this property is dynamic, depending on the documents processed by various phases up to this moment in time. @@ -778,7 +770,7 @@ components: This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. state: type: string - description: | + description: |- The state of the query execution, such as `completed`, `running`, `cancelled`. Note that the `completed` state means that the request was started and completed by the Query service, but it does not mean that it was necessarily successful. @@ -793,7 +785,7 @@ components: description: Whether the cost-based optimizer is enabled for the query. usedMemory: type: integer - description: | + description: |- The amount of document memory used to execute the request. This property is only returned if a memory quota is set for the query. userAgent: @@ -839,27 +831,27 @@ components: description: The full prepared statement in encoded format. featureControls: type: integer - description: | + description: |- This property is provided for technical support only. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. indexApiVersion: type: integer - description: | + description: |- This property is provided for technical support only. It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. name: type: string - description: | + description: |- The name of the prepared statement. This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. namespace: type: string - description: | + description: |- The namespace in which the prepared statement is stored. Currently, only the `default` namespace is available. node: type: string - description: | + description: |- The node on which the prepared statement is stored. statement: type: string @@ -870,7 +862,7 @@ components: avgElapsedTime: type: string format: duration - description: | + description: |- The mean time taken from when the request to execute the prepared statement was acknowledged by the service, to when the request was completed. It includes the time taken by the service to schedule the request. @@ -879,7 +871,7 @@ components: avgServiceTime: type: string format: duration - description: | + description: |- The mean amount of calendar time taken to complete the execution of the prepared statement. This property is only returned when the prepared statement has been executed. @@ -887,14 +879,14 @@ components: lastUse: type: string format: date-time - description: | + description: |- Date and time of last use. This property is only returned when the prepared statement has been executed. maxElapsedTime: type: string format: duration - description: | + description: |- The maximum time taken from when the request to execute the prepared statement was acknowledged by the service, to when the request was completed. It includes the time taken by the service to schedule the request. @@ -903,7 +895,7 @@ components: maxServiceTime: type: string format: duration - description: | + description: |- The maximum amount of calendar time taken to complete the execution of the prepared statement. This property is only returned when the prepared statement has been executed. @@ -911,7 +903,7 @@ components: minElapsedTime: type: string format: duration - description: | + description: |- The minimum time taken from when the request to execute the prepared statement was acknowledged by the service, to when the request was completed. It includes the time taken by the service to schedule the request. @@ -920,7 +912,7 @@ components: minServiceTime: type: string format: duration - description: | + description: |- The minimum amount of calendar time taken to complete the execution of the prepared statement. This property is only returned when the prepared statement has been executed. @@ -975,7 +967,7 @@ components: host.memory.quota: type: integer format: int64 - description: | + description: |- The host memory quota. This reflects the node-quota setting. host.memory.total: @@ -995,19 +987,19 @@ components: memory.usage: type: integer format: int64 - description: | + description: |- The amount of memory allocated for heap objects (bytes). This increases as heap objects are allocated, and decreases as objects are freed. memory.total: type: integer format: int64 - description: | + description: |- The cumulative amount of memory allocated for heap objects (bytes). This increases as heap objects are allocated, but does not decrease when objects are freed. memory.system: type: integer format: int64 - description: | + description: |- The total amount of memory obtained from the operating system (bytes). This measures the virtual address space reserved by the query engine for heaps, stacks, and other internal data structures. node: @@ -1015,7 +1007,7 @@ components: description: The name or IP address and port of the node. node.allocated.values: type: integer - description: | + description: |- The total number of values allocated to contain documents or computations around documents. (This is only of relevance internally.) node.memory.usage: @@ -1024,13 +1016,13 @@ components: cpu.user.percent: type: integer format: int64 - description: | + description: |- CPU usage. The percentage of time spent executing user code since the last time the statistics were checked. cpu.sys.percent: type: integer format: int64 - description: | + description: |- CPU usage. The percentage of time spent executing system code since the last time the statistics were checked. process.memory.usage: @@ -1053,17 +1045,17 @@ components: description: Total number of active requests. request.per.sec.1min: type: number - description: | + description: |- Number of query requests processed per second. 1-minute exponentially weighted moving average. request.per.sec.5min: type: number - description: | + description: |- Number of query requests processed per second. 5-minute exponentially weighted moving average. request.per.sec.15min: type: number - description: | + description: |- Number of query requests processed per second. 15-minute exponentially weighted moving average. request.queued.count: @@ -1075,31 +1067,31 @@ components: request_time.mean: type: string format: duration - description: | + description: |- End-to-end time to process a query. The mean value. request_time.median: type: string format: duration - description: | + description: |- End-to-end time to process a query. The median value. request_time.80percentile: type: string format: duration - description: | + description: |- End-to-end time to process a query. The 80th percentile. request_time.95percentile: type: string format: duration - description: | + description: |- End-to-end time to process a query. The 95th percentile. request_time.99percentile: type: string format: duration - description: | + description: |- End-to-end time to process a query. The 99th percentile. request.prepared.percent: @@ -1107,22 +1099,22 @@ components: description: Percentage of requests that are prepared statements. servicers.paused.count: type: integer - description: | + description: |- Number of servicers temporarily paused due to memory pressure. (Applies to serverless environments only.) servicers.paused.total: type: integer - description: | + description: |- Number of times servicers have been temporarily paused. (Applies to serverless environments only.) temp.hwm: type: integer - description: | + description: |- High water mark for temp space use directly by query. (Doesn't include use by the GSI and Search clients.) temp.usage: type: integer - description: | + description: |- Current Query temp space use. (Doesn't include use by the GSI and Search clients.) @@ -1138,7 +1130,7 @@ components: description: Total number of query requests with `at_plus` index consistency. audit_actions.count: type: integer - description: | + description: |- The total number of audit records sent to the server. Some requests cause more than one audit record to be emitted. Records in the output queue that have not yet been sent to the server are not counted. @@ -1186,37 +1178,37 @@ components: description: Total end-to-end time to process all queries (ns). request_timer.15m.rate: type: number - description: | + description: |- Number of query requests processed per second. 15-minute exponentially weighted moving average. request_timer.1m.rate: type: number - description: | + description: |- Number of query requests processed per second. 1-minute exponentially weighted moving average. request_timer.5m.rate: type: number - description: | + description: |- Number of query requests processed per second. 5-minute exponentially weighted moving average. request_timer.75%: type: number - description: | + description: |- End-to-end time to process a query (ns). The 75th percentile. request_timer.95%: type: number - description: | + description: |- End-to-end time to process a query (ns). The 95th percentile. request_timer.99%: type: number - description: | + description: |- End-to-end time to process a query (ns). The 99th percentile. request_timer.99.9%: type: number - description: | + description: |- End-to-end time to process a query (ns). The 99.9th percentile. request_timer.count: @@ -1224,32 +1216,32 @@ components: description: Total number of query requests. request_timer.max: type: integer - description: | + description: |- End-to-end time to process a query (ns). The maximum value. request_timer.mean: type: number - description: | + description: |- End-to-end time to process a query (ns). The mean value. request_timer.mean.rate: type: number - description: | + description: |- Number of query requests processed per second. Mean rate since the query service started. request_timer.median: type: number - description: | + description: |- End-to-end time to process a query (ns). The median value. request_timer.min: type: integer - description: | + description: |- End-to-end time to process a query (ns). The minimum value. request_timer.stddev: type: number - description: | + description: |- End-to-end time to process a query (ns). The standard deviation. requests.count: @@ -1350,7 +1342,7 @@ components: x-has-default: true x-has-example: true x-desc-name: atrcollection-srv - description: | + description: |- Specifies the collection where [active transaction records][additional-storage-use] are stored. The collection must be present. If not specified, the active transaction record is stored in the default collection in the default scope in the bucket containing the first mutated document within the transaction. @@ -1358,12 +1350,13 @@ components: The value must be a string in the form `"bucket.scope.collection"` or `"namespace:bucket.scope.collection"`. If any part of the path contains a special character, that part of the path must be delimited in backticks ``. + [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- The [request-level][atrcollection_req] `atrcollection` parameter specifies this property per request. If a request does not include this parameter, the node-level `atrcollection` setting will be used. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [atrcollection_req]: ../n1ql-rest-query/index.html#atrcollection_req - x-desc-refs: | + x-desc-refs: |- [atrcollection_req]: #atrcollection_req auto-prepare: type: boolean @@ -1372,7 +1365,7 @@ components: x-has-default: true x-has-example: true x-desc-name: auto-prepare - description: | + description: |- Specifies whether the query engine should create a prepared statement every time a SQL++ request is submitted, whether the PREPARE statement is included or not. Refer to [Auto-Prepare][auto-prepare] for more information. @@ -1386,14 +1379,14 @@ components: x-has-default: true x-has-example: true x-desc-name: cleanupclientattempts - description: | + description: |- When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. - + x-desc-more: |- The [cluster-level][queryCleanupClientAttempts] `queryCleanupClientAttempts` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupClientAttempts]: ../n1ql-rest-settings/index.html#queryCleanupClientAttempts - x-desc-refs: | + x-desc-refs: |- [queryCleanupClientAttempts]: #queryCleanupClientAttempts cleanuplostattempts: type: boolean @@ -1402,14 +1395,14 @@ components: x-has-default: true x-has-example: true x-desc-name: cleanuplostattempts - description: | + description: |- When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. - + x-desc-more: |- The [cluster-level][queryCleanupLostAttempts] `queryCleanupLostAttempts` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupLostAttempts]: ../n1ql-rest-settings/index.html#queryCleanupLostAttempts - x-desc-refs: | + x-desc-refs: |- [queryCleanupLostAttempts]: #queryCleanupLostAttempts cleanupwindow: type: string @@ -1419,7 +1412,7 @@ components: x-has-default: true x-has-example: true x-desc-name: cleanupwindow - description: | + description: |- Specifies how frequently the Query service checks its subset of [active transaction records][additional-storage-use] for cleanup. Decreasing this setting causes expiration transactions to be found more swiftly, with the tradeoff of increasing the number of reads per second used for the scanning process. @@ -1434,12 +1427,13 @@ components: * `m` (minutes) * `h` (hours) + [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- The [cluster-level][queryCleanupWindow] `queryCleanupWindow` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [queryCleanupWindow]: ../n1ql-rest-settings/index.html#queryCleanupWindow - x-desc-refs: | + x-desc-refs: |- [queryCleanupWindow]: #queryCleanupWindow completed: type: object @@ -1447,13 +1441,13 @@ components: default: {"aborted": null, "threshold": 1000} example: {"user": "marco", "error": 12003} x-desc-name: completed - description: | + description: |- A nested object that sets the parameters for the completed requests catalog. All completed requests that match these parameters are tracked in the completed requests catalog. Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config properties: aborted: type: boolean @@ -1468,19 +1462,19 @@ components: example: "172.1.2.3" x-has-default: true x-has-example: true - description: | + description: |- The IP address of the client. If specified, all completed requests from this IP address are logged. context: type: string - description: | + description: |- The opaque ID or context provided by the client. If specified, all completed requests with this client context ID are logged. - + x-desc-more: |- Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. [client_context_id]: ../n1ql-rest-query/index.html#client_context_id - x-desc-refs: | + x-desc-refs: |- [client_context_id]: #client_context_id error: type: integer @@ -1489,7 +1483,7 @@ components: example: 12003 x-has-default: true x-has-example: true - description: | + description: |- An error number. If specified, all completed queries returning this error number are logged. tag: @@ -1498,12 +1492,12 @@ components: example: "both_user_and_error" x-has-default: true x-has-example: true - description: | + description: |- A unique string which tags a set of qualifiers. Refer to [Configure Completed Requests][sys-completed-config] for more information. - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config threshold: type: integer format: int32 @@ -1511,18 +1505,18 @@ components: example: 7000 x-has-default: true x-has-example: true - description: | + description: |- A duration in milliseconds. If specified, all completed queries lasting longer than this threshold are logged. - This is another way of specifying the [node-level](#completed-threshold) `completed-threshold` setting. + This is another way of specifying the `completed-threshold` setting. user: type: string default: "" example: "marco" x-has-default: true x-has-example: true - description: | + description: |- A user name, as given in the request credentials. If specified, all completed queries with this user name are logged. statement: @@ -1541,7 +1535,7 @@ components: format: int32 example: 5 x-has-example: true - description: | + description: |- The number of errors. If specified, all completed queries that return at least this many errors are logged. Queries with fewer errors are not logged. @@ -1553,7 +1547,7 @@ components: x-has-default: true x-has-example: true x-desc-name: completed-limit - description: | + description: |- Sets the number of requests to be logged in the completed requests catalog. As new completed requests are added, old ones are removed. @@ -1561,12 +1555,13 @@ components: Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. + [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + x-desc-more: |- The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [queryCompletedLimit]: ../n1ql-rest-settings/index.html#queryCompletedLimit - x-desc-refs: | + x-desc-refs: |- [queryCompletedLimit]: #queryCompletedLimit completed-max-plan-size: type: integer @@ -1577,7 +1572,7 @@ components: x-has-default: true x-desc-name: completed-max-plan-size x-desc-status: Couchbase Server 7.6 - description: | + description: |- This property is available in databases running Couchbase Server 7.6.0 and later. A plan size in bytes. @@ -1588,19 +1583,20 @@ components: Refer to [Configure Completed Requests][sys-completed-config] for more information. + [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + x-desc-more: |- The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [queryCompletedMaxPlanSize]: ../n1ql-rest-settings/index.html#queryCompletedMaxPlanSize - x-desc-refs: | + x-desc-refs: |- [queryCompletedMaxPlanSize]: #queryCompletedMaxPlanSize completed-stream-size: type: integer format: int32 default: 0 x-desc-name: completed-stream-size - description: | + description: |- A file size in MiB. When specified, completed requests are saved to the Couchbase Server `logs` directory. Completed requests are saved to GZIP archives with the prefix `local_request_log`. @@ -1610,7 +1606,7 @@ components: Refer to [Stream Completed Requests][sys-history] for more information and examples. - [sys-history]: /server/8.0/manage/monitor/monitoring-n1ql-query.html#sys-history + [sys-history]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-history completed-threshold: type: integer format: int32 @@ -1619,7 +1615,7 @@ components: x-has-default: true x-has-example: true x-desc-name: completed-threshold - description: | + description: |- A duration in milliseconds. All completed queries lasting longer than this threshold are logged in the completed requests catalog. @@ -1628,12 +1624,13 @@ components: Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. + [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + x-desc-more: |- The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [queryCompletedThreshold]: ../n1ql-rest-settings/index.html#queryCompletedThreshold - x-desc-refs: | + x-desc-refs: |- [queryCompletedThreshold]: #queryCompletedThreshold controls: type: boolean @@ -1642,18 +1639,18 @@ components: x-has-default: true x-has-example: true x-desc-name: controls-srv - description: | + description: |- Specifies if there should be a controls section returned with the request results. When set to `true`, the query response document includes a controls section with runtime information provided along with the request, such as positional and named parameters or settings. NOTE: If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. - + x-desc-more: |- The [request-level][controls_req] `controls` parameter specifies this property per request. If a request does not include this parameter, the node-level `controls` setting will be used. [controls_req]: ../n1ql-rest-query/index.html#controls_req - x-desc-refs: | + x-desc-refs: |- [controls_req]: #controls_req cpuprofile: type: string @@ -1662,7 +1659,7 @@ components: x-has-default: true x-has-example: true x-desc-name: cpuprofile - description: | + description: |- The absolute path and filename to write the CPU profile to a local file. The output file includes a controls section and performance measurements, such as memory allocation and garbage collection, to pinpoint bottlenecks and ways to improve your code execution. @@ -1677,7 +1674,7 @@ components: x-has-default: true x-has-example: true x-desc-name: debug - description: | + description: |- Use debug mode. When set to `true`, extra logging is provided. @@ -1686,7 +1683,7 @@ components: example: true x-has-example: true x-desc-name: distribute - description: | + description: |- This field is only available with the POST method. When specified alongside other settings, this field instructs the node that is processing the request to cascade those settings to all other query nodes. The actual value of this field is ignored. @@ -1716,7 +1713,7 @@ components: x-has-default: true x-has-example: true x-desc-name: loglevel - description: | + description: |- Log level used in the logger. All values, in descending order of data: @@ -1740,18 +1737,18 @@ components: Major items, like crashes. * `NONE` — Doesn't write anything. - + x-desc-more: |- The [cluster-level][queryLogLevel] `queryLogLevel` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryLogLevel]: ../n1ql-rest-settings/index.html#queryLogLevel - x-desc-refs: | + x-desc-refs: |- [queryLogLevel]: #queryLogLevel max-index-api: type: integer format: int32 x-desc-name: max-index-api - description: | + description: |- Max index API. This setting is provided for technical support only. max-parallelism: @@ -1762,7 +1759,7 @@ components: x-has-default: true x-has-example: true x-desc-name: max-parallelism-srv - description: | + description: |- Specifies the maximum parallelism for queries on this node. If the value is zero or negative, the maximum parallelism is restricted to the number of allowed cores. @@ -1771,7 +1768,10 @@ components: (The number of allowed cores is the same as the number of logical CPUs. In Community Edition, the number of allowed cores cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed cores.) + Refer to [Max Parallelism][max-parallelism] for more information. + [max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism + x-desc-more: |- The [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1780,12 +1780,9 @@ components: NOTE: To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. - Refer to [Max Parallelism][max-parallelism] for more information. - - [max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req - x-desc-refs: | + x-desc-refs: |- [queryMaxParallelism]: #queryMaxParallelism [max_parallelism_req]: #max_parallelism_req memory-quota: @@ -1796,7 +1793,7 @@ components: x-has-default: true x-has-example: true x-desc-name: memory-quota-srv - description: | + description: |- Specifies the maximum amount of memory a request may use on this node, in MB. Specify `0` (the default value) to disable. @@ -1808,7 +1805,7 @@ components: Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). - + x-desc-more: |- The [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1817,7 +1814,7 @@ components: [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req - x-desc-refs: | + x-desc-refs: |- [queryMemoryQuota]: #queryMemoryQuota [memory_quota_req]: #memory_quota_req memprofile: @@ -1827,7 +1824,7 @@ components: x-has-default: true x-has-example: true x-desc-name: memprofile - description: | + description: |- Filename to write the diagnostic memory usage log. NOTE: If `memprofile` is left running too long, it can slow the system down as its file size increases. @@ -1838,7 +1835,7 @@ components: default: false x-has-default: true x-desc-name: mutexprofile - description: | + description: |- Mutex profile. This setting is provided for technical support only. n1ql-feat-ctrl: @@ -1852,17 +1849,17 @@ components: x-has-default: true x-has-example: true x-desc-name: n1ql-feat-ctrl - description: | + description: |- SQL++ feature control. This setting is provided for technical support only. The value may be an integer. On databases running Couchbase Server 7.6 or later, it may also be a string representing a hexadecimal number. - + x-desc-more: |- The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryN1QLFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1QLFeatCtrl - x-desc-refs: | + x-desc-refs: |- [queryN1QLFeatCtrl]: #queryN1QLFeatCtrl node-quota: type: integer @@ -1871,7 +1868,7 @@ components: x-has-default: true x-desc-name: node-quota x-desc-status: Couchbase Server 7.6 - description: | + description: |- This property is available in databases running Couchbase Server 7.6.0 and later. Sets the soft memory limit for the Query service on this node, in MB. @@ -1886,12 +1883,12 @@ components: - If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. - + x-desc-more: |- The [cluster-level][queryNodeQuota] `queryNodeQuota` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNodeQuota]: ../n1ql-rest-settings/index.html#queryNodeQuota - x-desc-refs: | + x-desc-refs: |- [queryNodeQuota]: #queryNodeQuota node-quota-val-percent: type: integer @@ -1902,17 +1899,17 @@ components: x-has-default: true x-desc-name: node-quota-val-percent x-desc-status: Couchbase Server 7.6 - description: | + description: |- This property is available in databases running Couchbase Server 7.6.0 and later. The percentage of the `node-quota` that is dedicated to tracked value content memory across all active requests on this node. (The `memory-quota` setting specifies the maximum amount of document memory an individual request may use on this node.) - + x-desc-more: |- The [cluster-level][queryNodeQuotaValPercent] `queryNodeQuotaValPercent` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNodeQuotaValPercent]: ../n1ql-rest-settings/index.html#queryNodeQuotaValPercent - x-desc-refs: | + x-desc-refs: |- [queryNodeQuotaValPercent]: #queryNodeQuotaValPercent num-cpus: type: integer @@ -1921,7 +1918,7 @@ components: x-has-default: true x-desc-name: num-cpus x-desc-status: Couchbase Server 7.6 - description: | + description: |- This property is available in databases running Couchbase Server 7.6.0 and later. The number of CPUs the Query service can use on this node. @@ -1932,29 +1929,30 @@ components: The number of CPUs can never be greater than the number of logical CPUs. In Community Edition, the number of allowed CPUs cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed CPUs. - + x-desc-more: |- The [cluster-level][queryNumCpus] `queryNumCpus` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNumCpus]: ../n1ql-rest-settings/index.html#queryNumCpus - x-desc-refs: | + x-desc-refs: |- [queryNumCpus]: #queryNumCpus numatrs: type: string x-desc-name: numatrs-srv - description: | + description: |- Specifies the total number of [active transaction records][additional-storage-use]. + [additional-storage-use]: /cloud/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- The [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, the [request-level][numatrs_req] `numatrs` parameter specifies this property per request. The minimum of that and the node-level `numatrs` setting is applied. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req - x-desc-refs: | + x-desc-refs: |- [queryNumAtrs]: #queryNumAtrs [numatrs_req]: #numatrs_req pipeline-batch: @@ -1965,9 +1963,9 @@ components: x-has-default: true x-has-example: true x-desc-name: pipeline-batch-srv - description: | + description: |- Controls the number of items execution operators can batch for Fetch from the KV. - + x-desc-more: |- The [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1976,7 +1974,7 @@ components: [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req - x-desc-refs: | + x-desc-refs: |- [queryPipelineBatch]: #queryPipelineBatch [pipeline_batch_req]: #pipeline_batch_req pipeline-cap: @@ -1987,9 +1985,9 @@ components: x-has-default: true x-has-example: true x-desc-name: pipeline-cap-srv - description: | + description: |- Maximum number of items each execution operator can buffer between various operators. - + x-desc-more: |- The [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1998,7 +1996,7 @@ components: [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req - x-desc-refs: | + x-desc-refs: |- [queryPipelineCap]: #queryPipelineCap [pipeline_cap_req]: #pipeline_cap_req plus-servicers: @@ -2007,7 +2005,7 @@ components: example: 16 x-has-example: true x-desc-name: plus-servicers - description: | + description: |- The number of service threads for transactions where the scan consistency is `request_plus` or `at_plus`. The default is 16 times the number of logical cores. prepared-limit: @@ -2018,15 +2016,15 @@ components: x-has-default: true x-has-example: true x-desc-name: prepared-limit - description: | + description: |- Maximum number of prepared statements in the cache. When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. - + x-desc-more: |- The [cluster-level][queryPreparedLimit] `queryPreparedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryPreparedLimit]: ../n1ql-rest-settings/index.html#queryPreparedLimit - x-desc-refs: | + x-desc-refs: |- [queryPreparedLimit]: #queryPreparedLimit pretty: type: boolean @@ -2035,14 +2033,14 @@ components: x-has-default: true x-has-example: true x-desc-name: pretty-srv - description: | + description: |- Specifies whether query results are returned in pretty format. - + x-desc-more: |- The [request-level][pretty_req] `pretty` parameter specifies this property per request. If a request does not include this parameter, the node-level setting is used, which defaults to `false`. [pretty_req]: ../n1ql-rest-query/index.html#pretty_req - x-desc-refs: | + x-desc-refs: |- [pretty_req]: #pretty_req profile: type: string @@ -2052,7 +2050,7 @@ components: x-has-example: true enum: ["off","phases","timings"] x-desc-name: profile-srv - description: | + description: |- Specifies if there should be a profile section returned with the request results. The valid values are: @@ -2065,15 +2063,16 @@ components: This information will be included in the `system:active_requests` and `system:completed_requests` keyspaces. NOTE: If `profile` is not set as one of the above values, then the profile setting does not change. - + Refer to [Monitoring and Profiling Details][monitor-profile-details] for more information and examples. + [monitor-profile-details]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details + x-desc-more: |- The [request-level][profile_req] `profile` parameter specifies this property per request. If a request does not include this parameter, the node-level `profile` setting will be used. - [monitor-profile-details]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details [profile_req]: ../n1ql-rest-query/index.html#profile_req - x-desc-refs: | + x-desc-refs: |- [profile_req]: #profile_req request-size-cap: type: integer @@ -2092,13 +2091,13 @@ components: x-has-default: true x-has-example: true x-desc-name: scan-cap-srv - description: | + description: |- Maximum buffered channel size between the indexer client and the query service for index scans. This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. - + x-desc-more: |- The [cluster-level][queryScanCap] `queryScanCap` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -2107,7 +2106,7 @@ components: [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req - x-desc-refs: | + x-desc-refs: |- [queryScanCap]: #queryScanCap [scan_cap_req]: #scan_cap_req servicers: @@ -2118,7 +2117,7 @@ components: x-has-default: true x-has-example: true x-desc-name: servicers - description: | + description: |- The number of service threads for the query. The default is 4 times the number of cores on the query node. timeout: @@ -2129,7 +2128,7 @@ components: x-has-default: true x-has-example: true x-desc-name: timeout-srv - description: | + description: |- Maximum time to spend on the request before timing out (ns). The value for this setting is an integer, representing a duration in nanoseconds. @@ -2137,7 +2136,7 @@ components: Specify `0` (the default value) or a negative integer to disable. When disabled, no timeout is applied and the request runs for however long it takes. - + x-desc-more: |- The [cluster-level][queryTimeout] `queryTimeout` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -2146,7 +2145,7 @@ components: [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout [timeout_req]: ../n1ql-rest-query/index.html#timeout_req - x-desc-refs: | + x-desc-refs: |- [queryTimeout]: #queryTimeout [timeout_req]: #timeout_req txtimeout: @@ -2157,7 +2156,7 @@ components: x-has-default: true x-has-example: true x-desc-name: txtimeout-srv - description: | + description: |- Maximum time to spend on a transaction before timing out (ns). This setting only applies to requests containing the `BEGIN TRANSACTION` statement, or to requests where the [tximplicit][tximplicit] parameter is set. For all other requests, it is ignored. @@ -2168,16 +2167,17 @@ components: Specify `0` (the default value) to disable. When disabled, no timeout is applied and the transaction runs for however long it takes. + [tximplicit]: ../n1ql-rest-query/index.html#tximplicit + x-desc-more: |- The [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, the [request-level][txtimeout_req] `txtimeout` parameter specifies this property per request. The minimum of that and the node-level `txtimeout` setting is applied. - [tximplicit]: ../n1ql-rest-query/index.html#tximplicit [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req - x-desc-refs: | + x-desc-refs: |- [tximplicit]: #tximplicit [queryTxTimeout]: #queryTxTimeout [txtimeout_req]: #txtimeout_req @@ -2188,9 +2188,9 @@ components: x-has-default: true x-has-example: true x-desc-name: use-cbo-srv - description: | + description: |- Specifies whether the cost-based optimizer is enabled. - + x-desc-more: |- The [cluster-level][queryUseCBO] `queryUseCBO` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -2199,7 +2199,7 @@ components: [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req - x-desc-refs: | + x-desc-refs: |- [queryUseCBO]: #queryUseCBO [use_cbo_req]: #use_cbo_req use-replica: @@ -2211,7 +2211,7 @@ components: x-has-example: true x-desc-name: use-replica-srv x-desc-status: Couchbase Server 7.6 - description: | + description: |- Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. The possible values are: @@ -2221,13 +2221,6 @@ components: * `unset` — read from replica is enabled or disabled at request level. - The [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. - If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. - If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. - Do not enable read from replica when you require consistent results. Only SELECT queries that are not within a transaction can read from replica. @@ -2235,10 +2228,17 @@ components: Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. + x-desc-more: |- + The [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + + In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. + If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. + If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req - x-desc-refs: | + x-desc-refs: |- [queryUseReplica]: #queryUseReplica [use_replica_req]: #use_replica_req @@ -2289,7 +2289,7 @@ components: description: The amount of memory freed. released: type: integer - description: | + description: |- Only returned by the POST method. The amount of memory released to the OS. status: @@ -2338,7 +2338,7 @@ components: - unbounded - updates - warnings - description: | + description: |- The name of a statistic. Only top-level statistic names can be used. You cannot specify a metric. @@ -2349,7 +2349,7 @@ components: type: string in: path required: true - description: | + description: |- The name of a prepared statement. This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. @@ -2359,7 +2359,7 @@ components: type: string in: path required: true - description: | + description: |- The name of a request. This is the `requestID` that was assigned automatically when the statement was created. @@ -2383,6 +2383,6 @@ components: Default: type: http scheme: basic - description: | + description: |- The Admin API supports admin credentials. Credentials can be passed via HTTP headers (HTTP basic authentication). diff --git a/src/query-service/swagger/query-service.yaml b/src/query-service/swagger/query-service.yaml index 82fc1fd7..b4b22727 100644 --- a/src/query-service/swagger/query-service.yaml +++ b/src/query-service/swagger/query-service.yaml @@ -1,8 +1,8 @@ openapi: 3.0.3 info: title: Query Service REST API - version: capella - description: | + version: '8.0' + description: |- The Query Service REST API is provided by the Query service. This API enables you to run SQL++ queries and set request-level parameters. @@ -254,7 +254,7 @@ components: type: array items: {} x-desc-name: args - description: | + description: |- Supplies the values for positional parameters in the statement. Applicable if the statement or prepared statement contains 1 or more positional parameters. @@ -270,7 +270,7 @@ components: atrcollection: type: string x-desc-name: atrcollection_req - description: | + description: |- Specifies the collection where the [active transaction record][additional-storage-use] (ATR) is stored. The collection must be present. If not specified, the ATR is stored in the default collection in the default scope in the bucket containing the first mutated document within the transaction. @@ -278,20 +278,20 @@ components: The value must be a string in the form `"bucket.scope.collection"` or `"namespace:bucket.scope.collection"`. If any part of the path contains a special character, that part of the path must be delimited in backticks ``. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries + [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- + The [node-level][atrcollection-srv] `atrcollection` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. -# The [node-level][atrcollection-srv] `atrcollection` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. - -# [atrcollection-srv]: ../n1ql-rest-admin/index.html#atrcollection-srv - x-desc-refs: | + [atrcollection-srv]: ../n1ql-rest-admin/index.html#atrcollection-srv + x-desc-refs: |- [atrcollection-srv]: #atrcollection-srv x-has-example: true example: default:`travel-sample`.transaction.test auto_execute: type: boolean x-desc-name: auto_execute - description: | + description: |- Specifies that prepared statements should be executed automatically as soon as they are created. This saves you from having to make two separate requests in cases where you want to prepare a statement and execute it immediately. @@ -305,7 +305,7 @@ components: client_context_id: type: string x-desc-name: client_context_id - description: | + description: |- A piece of data supplied by the client that is echoed in the response, if present. SQL++ is agnostic about the content of this parameter; it is just echoed in the response. @@ -314,7 +314,7 @@ components: compression: type: string x-desc-name: compression - description: | + description: |- Compression format to use for response data on the wire. Values are case-insensitive. @@ -326,18 +326,18 @@ components: controls: type: boolean x-desc-name: controls_req - description: | + description: |- Specifies if there should be a controls section returned with the request results. When set to `true`, the query response document includes a controls section with runtime information provided along with the request, such as positional and named parameters or settings. If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. + x-desc-more: |- + The [node-level][controls-srv] `controls` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. -# The [node-level][controls-srv] `controls` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. - -# [controls-srv]: ../n1ql-rest-admin/index.html#controls-srv - x-desc-refs: | + [controls-srv]: ../n1ql-rest-admin/index.html#controls-srv + x-desc-refs: |- [controls-srv]: #controls-srv x-has-example: true example: true @@ -346,7 +346,7 @@ components: # items: # $ref: "#/components/schemas/Credentials" # x-desc-name: creds -# description: | +# description: |- # Specifies the login credentials. # The Query API supports two types of identity: local (or bucket) and admin. @@ -363,10 +363,10 @@ components: durability_level: type: string x-desc-name: durability_level - description: | + description: |- The level of [durability][durability] for mutations produced by the request. - If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the [tximplicit](#tximplicit) parameter set to `true`, the durability level is specified for all mutations within that transaction. + If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, the durability level is specified for all mutations within that transaction. Durability is also supported for non-transactional DML statements. In this case, the `kvtimeout` parameter is used as the durability timeout. @@ -388,13 +388,13 @@ components: encoded_plan: type: string x-desc-name: encoded_plan - description: | - In databases running Couchbase Server 6.5 and later, this parameter is ignored and has no effect. + description: |- + In Couchbase Server 6.5 and later, this parameter is ignored and has no effect. It is included for compatibility with previous versions of Couchbase Server. encoding: type: string x-desc-name: encoding - description: | + description: |- Desired character encoding for the query results. Only possible value is `UTF-8` and is case-insensitive. @@ -403,7 +403,7 @@ components: format: type: string x-desc-name: format - description: | + description: |- Desired format for the query results. Values are case-insensitive. @@ -415,7 +415,7 @@ components: kvtimeout: type: string x-desc-name: kvtimeout - description: | + description: |- The approximate time to wait for a KV get operation before timing out. This applies to statements within a transaction, and to non-transactional statements, whether `durability_level` is set or not. @@ -442,24 +442,24 @@ components: type: integer format: int32 x-desc-name: max_parallelism_req - description: | + description: |- Specifies the maximum parallelism for the query. The default value is the same as the number of partitions of the index selected for the query. + x-desc-more: |- + The [node-level][max-parallelism-srv] `max-parallelism` setting specifies the ceiling for this parameter for a single node. + If the request-level parameter is zero or negative, the parallelism for the query is set to the node-level setting. + If the request-level parameter is greater than zero and less than the node-level setting, the request-level parameter overrides the node-level setting. + If the request-level parameter is greater than the node-level setting, the parallelism for the query is set to the node-level setting. -# The [node-level][max-parallelism-srv] `max-parallelism` setting specifies the ceiling for this parameter for a single node. -# If the request-level parameter is zero or negative, the parallelism for the query is set to the node-level setting. -# If the request-level parameter is greater than zero and less than the node-level setting, the request-level parameter overrides the node-level setting. -# If the request-level parameter is greater than the node-level setting, the parallelism for the query is set to the node-level setting. - -# In addition, the [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies the ceiling for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + In addition, the [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies the ceiling for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. + To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. -# [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv -# [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism - x-desc-refs: | + [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv + [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism + x-desc-refs: |- [max-parallelism-srv]: #max-parallelism-srv [queryMaxParallelism]: #queryMaxParallelism x-has-example: true @@ -468,7 +468,7 @@ components: type: integer format: int32 x-desc-name: memory_quota_req - description: | + description: |- Specifies the maximum amount of memory the request may use, in MB. Specify `0` (the default value) to disable. @@ -480,17 +480,17 @@ components: Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). + x-desc-more: |- + The [node-level][memory-quota-srv] `memory-quota` setting specifies the ceiling for this parameter for a single node. + If the node-level setting is zero (the default), the request-level parameter overrides the node-level setting. + If the node-level setting is greater than zero, the request-level parameter is capped by the node-level setting. -# The [node-level][memory-quota-srv] `memory-quota` setting specifies the ceiling for this parameter for a single node. -# If the node-level setting is zero (the default), the request-level parameter overrides the node-level setting. -# If the node-level setting is greater than zero, the request-level parameter is capped by the node-level setting. + In addition, the [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies the ceiling for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies the ceiling for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv -# [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota - x-desc-refs: | + [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv + [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota + x-desc-refs: |- [memory-quota-srv]: #memory-quota-srv [queryMemoryQuota]: #queryMemoryQuota x-has-default: true @@ -517,21 +517,21 @@ components: type: integer format: int32 x-desc-name: numatrs_req - description: | + description: |- Specifies the total number of [active transaction records][additional-storage-use]. Must be a positive integer. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries + [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- + The [node-level][numatrs-srv] `numatrs` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. -# The [node-level][numatrs-srv] `numatrs` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. + In addition, the [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv -# [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs - x-desc-refs: | + [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv + [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs + x-desc-refs: |- [numatrs-srv]: #numatrs-srv [queryNumAtrs]: #queryNumAtrs x-has-default: true @@ -542,18 +542,18 @@ components: type: integer format: int32 x-desc-name: pipeline_batch_req - description: | + description: |- Controls the number of items execution operators can batch for Fetch from the KV. + x-desc-more: |- + The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. -# The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. + In addition, the [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv -# [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch - x-desc-refs: | + [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv + [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch + x-desc-refs: |- [pipeline-batch-srv]: #pipeline-batch-srv [queryPipelineBatch]: #queryPipelineBatch x-has-example: true @@ -562,18 +562,18 @@ components: type: integer format: int32 x-desc-name: pipeline_cap_req - description: | + description: |- Maximum number of items each execution operator can buffer between various operators. + x-desc-more: |- + The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. -# The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. + In addition, the [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv -# [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap - x-desc-refs: | + [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv + [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap + x-desc-refs: |- [pipeline-cap-srv]: #pipeline-cap-srv [queryPipelineCap]: #queryPipelineCap x-has-example: true @@ -581,7 +581,7 @@ components: prepared: type: string x-desc-name: prepared - description: | + description: |- _Required_ if `statement` not provided. The name of the prepared SQL++ statement to be executed. @@ -596,7 +596,7 @@ components: preserve_expiry: type: boolean x-desc-name: preserve_expiry - description: | + description: |- Specifies whether documents should keep their current expiration setting when modified by a DML statement. If `true`, documents will keep any existing expiration setting when modified by a DML statement. @@ -612,21 +612,21 @@ components: pretty: type: boolean x-desc-name: pretty_req - description: | + description: |- Specifies the query results returned in pretty format. + x-desc-more: |- + The [node-level][pretty-srv] `pretty` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. -# The [node-level][pretty-srv] `pretty` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. - -# [pretty-srv]: ../n1ql-rest-admin/index.html#pretty-srv - x-desc-refs: | + [pretty-srv]: ../n1ql-rest-admin/index.html#pretty-srv + x-desc-refs: |- [pretty-srv]: #pretty-srv x-has-example: true example: false profile: type: string x-desc-name: profile_req - description: | + description: |- Specifies if there should be a profile section returned with the request results. The valid values are: @@ -641,12 +641,12 @@ components: This information will be included in the `system:active_requests` and `system:completed_requests` keyspaces. If `profile` is not set as one of the above values, then the profile setting does not change. + x-desc-more: |- + The [node-level][profile-srv] `profile` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. -# The [node-level][profile-srv] `profile` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. - -# [profile-srv]: ../n1ql-rest-admin/index.html#profile-srv - x-desc-refs: | + [profile-srv]: ../n1ql-rest-admin/index.html#profile-srv + x-desc-refs: |- [profile-srv]: #profile-srv enum: ["off", "phases", "timings"] x-has-example: true @@ -654,7 +654,7 @@ components: query_context: type: string x-desc-name: query_context - description: | + description: |- Specifies the namespace, bucket, and scope used to resolve partial keyspace references within the request. The query context may be a _full path_, containing namespace, bucket, and scope; or a _relative path_, containing just the bucket and scope. @@ -667,7 +667,7 @@ components: readonly: type: boolean x-desc-name: readonly - description: | + description: |- Controls whether a query can change a resulting recordset. If `readonly` is `true`, then the following statements are not allowed: @@ -688,22 +688,22 @@ components: type: integer format: int32 x-desc-name: scan_cap_req - description: | + description: |- Maximum buffered channel size between the indexer client and the query service for index scans. This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. + x-desc-more: |- + The [node-level][scan-cap-srv] `scan-cap` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. -# The [node-level][scan-cap-srv] `scan-cap` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. + In addition, the [cluster-level][queryScanCap] `queryScanCap` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryScanCap] `queryScanCap` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv -# [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap - x-desc-refs: | + [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv + [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap + x-desc-refs: |- [scan-cap-srv]: #scan-cap-srv [queryScanCap]: #queryScanCap x-has-example: true @@ -711,7 +711,7 @@ components: scan_consistency: type: string x-desc-name: scan_consistency - description: | + description: |- Specifies the consistency guarantee or constraint for index scanning. The valid values are: @@ -740,7 +740,7 @@ components: For multi-statement requests, the default behavior is RYOW within each request. If you want to disable RYOW within a request, add a separate `request_consistency` parameter that can be set to `not_bounded`. - If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the [tximplicit](#tximplicit) parameter set to `true`, then this parameter sets the transactional scan consistency. + If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, then this parameter sets the transactional scan consistency. Refer to [Transactional Scan Consistency][transactional-scan-consistency] for details. [transactional-scan-consistency]: /cloud/n1ql/n1ql-manage/query-settings.html#transactional-scan-consistency @@ -753,7 +753,7 @@ components: type: object x-type: array x-desc-name: scan_vector - description: | + description: |- _Required_ if `scan_consistency` is `at_plus` and `scan_vectors` not provided. Specify the lower bound vector timestamp for one keyspace when using `at_plus` scan consistency. @@ -783,7 +783,7 @@ components: type: object x-type: array x-desc-name: scan_vectors - description: | + description: |- _Required_ if `scan_consistency` is `at_plus` and `scan_vector` not provided. A map from keyspace names to scan vectors. @@ -794,7 +794,7 @@ components: type: string format: duration x-desc-name: scan_wait - description: | + description: |- Can be supplied with `scan_consistency` values of `request_plus`, `statement_plus` and `at_plus`. Specifies the maximum time the client is willing to wait for an index to catch up to the vector timestamp in the request. @@ -828,7 +828,7 @@ components: sort_projection: type: boolean x-desc-name: sort_projection - description: | + description: |- If `true`, causes statement projection terms to be sorted alphabetically. If `false` (the default), statement projection terms are returned in the order specified by the query. @@ -839,7 +839,7 @@ components: statement: type: string x-desc-name: statement - description: | + description: |- _Required_ if `prepared` not provided. Any valid SQL++ statement for a POST request, or a read-only SQL++ statement (SELECT, EXPLAIN) for a GET request. @@ -859,7 +859,7 @@ components: type: string format: duration x-desc-name: timeout_req - description: | + description: |- Maximum time to spend on the request before timing out. The value for this parameter is a string. @@ -876,19 +876,19 @@ components: Specify a duration of `0` or a negative duration to disable. When disabled, no timeout is applied and the request runs for however long it takes. - If [tximplicit](#tximplicit) or [txid](#txid) is set, this parameter is ignored. + If `tximplicit` or `txid` is set, this parameter is ignored. The request inherits the remaining time of the transaction as timeout. + x-desc-more: |- + The [node-level][timeout-srv] `timeout` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. + However, if the node-level setting is greater than 0, the timeout for the query is limited to the node-level setting. -# The [node-level][timeout-srv] `timeout` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. -# However, if the node-level setting is greater than 0, the timeout for the query is limited to the node-level setting. - -# In addition, the [cluster-level][queryTimeout] `queryTimeout` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + In addition, the [cluster-level][queryTimeout] `queryTimeout` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv -# [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout - x-desc-refs: | + [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv + [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout + x-desc-refs: |- [timeout-srv]: #timeout-srv [queryTimeout]: #queryTimeout x-has-example: true @@ -896,14 +896,14 @@ components: txdata: type: object x-desc-name: txdata - description: | + description: |- Transaction data. For internal use only. txid: type: string format: UUID x-desc-name: txid - description: | + description: |- _Required_ for statements within a transaction. Transaction ID. @@ -917,14 +917,14 @@ components: tximplicit: type: boolean x-desc-name: tximplicit - description: | + description: |- Specifies that a DML statement is a singleton transaction. When this parameter is true, the Query service starts a transaction and executes the statement. If execution is successful, the Query service commits the transaction; otherwise the transaction is rolled back. The statement may not be part of an ongoing transaction. - If the [txid](#txid) request-level parameter is set, the `tximplicit` parameter is ignored. + If the `txid` request-level parameter is set, the `tximplicit` parameter is ignored. x-has-default: true x-has-example: true default: false @@ -933,7 +933,7 @@ components: type: integer format: int32 x-desc-name: txstmtnum - description: | + description: |- Transaction statement number. The transaction statement number must be a positive integer, and must be higher than any previous transaction statement numbers in the transaction. If the transaction statement number is lower than the transaction statement number for any previous statement, an error is generated. @@ -943,12 +943,12 @@ components: type: string format: duration x-desc-name: txtimeout_req - description: | + description: |- Maximum time to spend on a transaction before timing out. - Only applies to `BEGIN TRANSACTION` statements, or DML statements for which [tximplicit](#tximplicit) is set. + Only applies to `BEGIN TRANSACTION` statements, or DML statements for which `tximplicit` is set. For other statements, it is ignored. - Within a transaction, the request-level [timeout](#timeout_req) parameter is ignored. + Within a transaction, the request-level `timeout` parameter is ignored. The transaction timeout clock starts when the `BEGIN WORK` statement is successful. Once the transaction timeout is reached, no statement is allowed to continue in the transaction. @@ -967,17 +967,17 @@ components: When disabled, the request-level timeout is set to the default. The default is `"15s"` for cbq files or scripts, `"2m"` for interactive cbq sessions or redirected input. + x-desc-more: |- + The [node-level][txtimeout-srv] `txtimeout` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. + However, if the node-level setting is greater than 0, the transaction timeout for the query is limited to the node-level setting. -# The [node-level][txtimeout-srv] `txtimeout` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. -# However, if the node-level setting is greater than 0, the transaction timeout for the query is limited to the node-level setting. + In addition, the [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv -# [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout - x-desc-refs: | + [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv + [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout + x-desc-refs: |- [txtimeout-srv]: #txtimeout-srv [queryTxTimeout]: #queryTxTimeout x-has-example: true @@ -985,18 +985,18 @@ components: use_cbo: type: boolean x-desc-name: use_cbo_req - description: | + description: |- Specifies whether the cost-based optimizer is enabled. + x-desc-more: |- + The [node-level][use-cbo-srv] `use-cbo` setting specifies the default for this parameter for a single node. + The request-level parameter overrides the node-level setting. -# The [node-level][use-cbo-srv] `use-cbo` setting specifies the default for this parameter for a single node. -# The request-level parameter overrides the node-level setting. + In addition, the [cluster-level][queryUseCBO] `queryUseCBO` setting specifies the default for this parameter for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# In addition, the [cluster-level][queryUseCBO] `queryUseCBO` setting specifies the default for this parameter for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - -# [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv -# [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO - x-desc-refs: | + [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv + [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO + x-desc-refs: |- [use-cbo-srv]: #use-cbo-srv [queryUseCBO]: #queryUseCBO x-has-example: true @@ -1004,7 +1004,8 @@ components: use_fts: type: boolean x-desc-name: use_fts - description: | + x-desc-edition: "{enterprise}" + description: |- Specifies that the query should use a Search index. If the query contains a `USING FTS` hint, that takes priority over this parameter. @@ -1028,8 +1029,7 @@ components: default: unset example: on x-desc-name: use_replica_req - x-desc-status: Couchbase Server 7.6 - description: | + description: |- Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. The possible values are: @@ -1047,23 +1047,23 @@ components: Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. + x-desc-more: |- + The [node-level][use-replica-srv] `use-replica` setting specifies the default for this property for a single node. + The request-level parameter usually overrides the node-level setting. + However, when the node-level setting is `off`, the request-level parameter cannot enable the property. -# The [node-level][use-replica-srv] `use-replica` setting specifies the default for this property for a single node. -# The request-level parameter usually overrides the node-level setting. -# However, when the node-level setting is `off`, the request-level parameter cannot enable the property. - -# In addition, the [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. -# When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. + In addition, the [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. + When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. -# [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv -# [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica - x-desc-refs: | + [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv + [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica + x-desc-refs: |- [use-replica-srv]: #use-replica-srv [queryUseReplica]: #queryUseReplica additionalProperties: x-desc-name: identifier x-additionalPropertiesName: $identifier - description: | + description: |- Supplies the value for a named parameter in the statement. Applicable if the statement or prepared statement contains 1 or more named parameters. @@ -1184,7 +1184,7 @@ components: query.execute.index_not_found sev: type: integer - description: | + description: |- One of the following SQL++ severity levels, listed in order of severity: 1. Severe @@ -1305,7 +1305,7 @@ components: description: IP address and port number of the node where the query was executed. phaseCounts: type: object - description: | + description: |- Count of documents processed at selective phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. x-has-example: true example: @@ -1315,7 +1315,7 @@ components: } phaseOperators: type: object - description: | + description: |- Indicates the numbers of each kind of query operator involved in different phases of the query processing. For instance, a non-covering index path might involve one index scan and one fetch operator. @@ -1332,7 +1332,7 @@ components: } phaseTimes: type: object - description: | + description: |- Cumulative execution times for various phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. x-has-example: true example: @@ -1348,7 +1348,7 @@ components: executionTimings: type: object title: Execution Timings - description: | + description: |- Present only if `profile` was set to `"timings"` in the [Request Parameters](#Request). The execution details for various phases involved in the query execution, such as kernel and service execution times, number of documents processed at each query operator in each phase, and number of phase switches. @@ -1401,8 +1401,7 @@ components: servTime: type: string format: duration - x-desc-name: serv_time - description: | + description: |- Time spent waiting for another service, such as index or data. For index scan, it is time spent waiting for GSI/indexer. @@ -1452,7 +1451,7 @@ components: Header: type: http scheme: basic - description: | + description: |- Specify a user name and password via HTTP headers. This method can only be used to provide a single credential. diff --git a/src/query-settings/swagger/query-settings.yaml b/src/query-settings/swagger/query-settings.yaml index ee9d1351..b8488fd5 100644 --- a/src/query-settings/swagger/query-settings.yaml +++ b/src/query-settings/swagger/query-settings.yaml @@ -140,14 +140,14 @@ components: x-has-default: true x-has-example: true x-desc-name: queryCleanupClientAttempts - description: | + description: |- When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. - + x-desc-more: |- The [node-level][cleanupclientattempts] `cleanupclientattempts` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanupclientattempts]: ../n1ql-rest-admin/index.html#cleanupclientattempts - x-desc-refs: | + x-desc-refs: |- [cleanupclientattempts]: #cleanupclientattempts queryCleanupLostAttempts: type: boolean @@ -156,14 +156,14 @@ components: x-has-default: true x-has-example: true x-desc-name: queryCleanupLostAttempts - description: | + description: |- When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. - + x-desc-more: |- The [node-level][cleanuplostattempts] `cleanuplostattempts` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanuplostattempts]: ../n1ql-rest-admin/index.html#cleanuplostattempts - x-desc-refs: | + x-desc-refs: |- [cleanuplostattempts]: #cleanuplostattempts queryCleanupWindow: type: string @@ -173,7 +173,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryCleanupWindow - description: | + description: |- Specifies how frequently the Query service checks its subset of [active transaction records][additional-storage-use] for cleanup. Decreasing this setting causes expiration transactions to be found more swiftly, with the tradeoff of increasing the number of reads per second used for the scanning process. @@ -188,12 +188,13 @@ components: * `m` (minutes) * `h` (hours) + [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- The [node-level][cleanupwindow] `cleanupwindow` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [cleanupwindow]: ../n1ql-rest-admin/index.html#cleanupwindow - x-desc-refs: | + x-desc-refs: |- [cleanupwindow]: #cleanupwindow queryCompletedLimit: type: integer @@ -203,7 +204,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryCompletedLimit - description: | + description: |- Sets the number of requests to be logged in the completed requests catalog. As new completed requests are added, old ones are removed. @@ -211,12 +212,13 @@ components: Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. + [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + x-desc-more: |- The [node-level][completed-limit] `completed-limit` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [sys-completed-config]: /capella/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [completed-limit]: ../n1ql-rest-admin/index.html#completed-limit - x-desc-refs: | + x-desc-refs: |- [completed-limit]: #completed-limit queryCompletedMaxPlanSize: type: integer @@ -226,9 +228,7 @@ components: maximum: 20840448 x-has-default: true x-desc-name: queryCompletedMaxPlanSize - description: | - This property is available in databases running Couchbase Server 7.6.0 and later. - + description: |- A plan size in bytes. Limits the size of query execution plans that can be logged in the completed requests catalog. Values larger than the maximum limit are silently treated as the maximum limit. @@ -237,12 +237,13 @@ components: Refer to [Configure the Completed Requests][sys-completed-config] for more information. + [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + x-desc-more: |- The [node-level][completed-max-plan-size] `completed-max-plan-size` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [sys-completed-config]: /capella/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [completed-max-plan-size]: ../n1ql-rest-admin/index.html#completed-max-plan-size - x-desc-refs: | + x-desc-refs: |- [completed-max-plan-size]: #completed-max-plan-size queryCompletedThreshold: type: integer @@ -252,7 +253,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryCompletedThreshold - description: | + description: |- A duration in milliseconds. All completed queries lasting longer than this threshold are logged in the completed requests catalog. @@ -261,12 +262,13 @@ components: Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. + [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config + x-desc-more: |- The [node-level][completed-threshold] `completed-threshold` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - [sys-completed-config]: /capella/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config [completed-threshold]: ../n1ql-rest-admin/index.html#completed-threshold - x-desc-refs: | + x-desc-refs: |- [completed-threshold]: #completed-threshold queryLogLevel: type: string @@ -276,7 +278,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryLogLevel - description: | + description: |- Log level used in the logger. All values, in descending order of data: @@ -300,12 +302,12 @@ components: Major items, like crashes. * `NONE` — Doesn't write anything. - + x-desc-more: |- The [node-level][loglevel] `loglevel` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [loglevel]: ../n1ql-rest-admin/index.html#loglevel - x-desc-refs: | + x-desc-refs: |- [loglevel]: #loglevel queryMaxParallelism: type: integer @@ -315,7 +317,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryMaxParallelism - description: | + description: |- Specifies the maximum parallelism for queries on all Query nodes in the cluster. If the value is zero or negative, the maximum parallelism is restricted to the number of allowed cores. @@ -325,6 +327,10 @@ components: In Community Edition, the number of allowed cores cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed cores.) + Refer to [Max Parallelism][max-parallelism] for more information. + + [max-parallelism]: /server/8.0/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism + x-desc-more: |- The [node-level][max-parallelism-srv] `max-parallelism` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -332,13 +338,10 @@ components: If a request includes this parameter, it will be capped by the node-level `max-parallelism` setting. NOTE: To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. - - Refer to [Max Parallelism][max-parallelism] for more information. - [max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req - x-desc-refs: | + x-desc-refs: |- [max-parallelism-srv]: #max-parallelism-srv [max_parallelism_req]: #max_parallelism_req queryMemoryQuota: @@ -349,7 +352,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryMemoryQuota - description: | + description: |- Specifies the maximum amount of memory a request may use on any Query node in the cluster, in MB. This parameter enforces a ceiling on the memory used for the tracked documents required for @@ -358,7 +361,7 @@ components: Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). - + x-desc-more: |- The [node-level][memory-quota-srv] `memory-quota` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -367,22 +370,22 @@ components: [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req - x-desc-refs: | + x-desc-refs: |- [memory-quota-srv]: #memory-quota-srv [memory_quota_req]: #memory_quota_req queryN1QLFeatCtrl: type: integer format: int32 x-desc-name: queryN1QLFeatCtrl - description: | + description: |- SQL++ feature control. This setting is provided for technical support only. - + x-desc-more: |- The [node-level][n1ql-feat-ctrl] `n1ql-feat-ctrl` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [n1ql-feat-ctrl]: ../n1ql-rest-admin/index.html#n1ql-feat-ctrl - x-desc-refs: | + x-desc-refs: |- [n1ql-feat-ctrl]: #n1ql-feat-ctrl queryNodeQuota: type: integer @@ -390,9 +393,7 @@ components: default: 0 x-has-default: true x-desc-name: queryNodeQuota - description: | - This property is available in databases running Couchbase Server 7.6.0 and later. - + description: |- Sets the soft memory limit for the Query service on every Query node in the cluster, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. @@ -405,12 +406,12 @@ components: - If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. - + x-desc-more: |- The [node-level][node-quota] `node-quota` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [node-quota]: ../n1ql-rest-admin/index.html#node-quota - x-desc-refs: | + x-desc-refs: |- [node-quota]: #node-quota queryNodeQuotaValPercent: type: integer @@ -420,17 +421,15 @@ components: maximum: 100 x-has-default: true x-desc-name: queryNodeQuotaValPercent - description: | - This property is available in databases running Couchbase Server 7.6.0 and later. - + description: |- The percentage of the `queryNodeQuota` that is dedicated to tracked value content memory across all active requests for every Query node in the cluster. (The `queryMemoryQuota` setting specifies the maximum amount of document memory an individual request may use on any Query node in the cluster.) - + x-desc-more: |- The [node-level][node-quota-val-percent] `node-quota-val-percent` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [node-quota-val-percent]: ../n1ql-rest-admin/index.html#node-quota-val-percent - x-desc-refs: | + x-desc-refs: |- [node-quota-val-percent]: #node-quota-val-percent queryNumAtrs: type: integer @@ -442,19 +441,20 @@ components: x-has-default: true x-has-example: true x-desc-name: queryNumAtrs - description: | + description: |- Specifies the total number of [active transaction records][additional-storage-use] for all Query nodes in the cluster. + [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries + x-desc-more: |- The [node-level][numatrs-srv] `numatrs` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, there is a [request-level][numatrs_req] `numatrs` parameter. If a request includes this parameter, it will be capped by the node-level `numatrs` setting. - [additional-storage-use]: /server/7.6/learn/data/transactions.html#active-transaction-record-entries [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req - x-desc-refs: | + x-desc-refs: |- [numatrs-srv]: #numatrs-srv [numatrs_req]: #numatrs_req queryNumCpus: @@ -463,9 +463,7 @@ components: default: 0 x-has-default: true x-desc-name: queryNumCpus - description: | - This property is available in databases running Couchbase Server 7.6.0 and later. - + description: |- The number of CPUs the Query service can use on any Query node in the cluster. Note that this setting requires a restart of the Query service to take effect. @@ -474,12 +472,12 @@ components: The number of CPUs can never be greater than the number of logical CPUs. In Community Edition, the number of allowed CPUs cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed CPUs. - + x-desc-more: |- The [node-level][num-cpus] `num-cpus` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [num-cpus]: ../n1ql-rest-admin/index.html#num-cpus - x-desc-refs: | + x-desc-refs: |- [num-cpus]: #num-cpus queryPipelineBatch: type: integer @@ -489,9 +487,9 @@ components: x-has-default: true x-has-example: true x-desc-name: queryPipelineBatch - description: | + description: |- Controls the number of items execution operators can batch for Fetch from the KV. - + x-desc-more: |- The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -500,7 +498,7 @@ components: [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req - x-desc-refs: | + x-desc-refs: |- [pipeline-batch-srv]: #pipeline-batch-srv [pipeline_batch_req]: #pipeline_batch_req queryPipelineCap: @@ -511,9 +509,9 @@ components: x-has-default: true x-has-example: true x-desc-name: queryPipelineCap - description: | + description: |- Maximum number of items each execution operator can buffer between various operators. - + x-desc-more: |- The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -522,7 +520,7 @@ components: [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req - x-desc-refs: | + x-desc-refs: |- [pipeline-cap-srv]: #pipeline-cap-srv [pipeline_cap_req]: #pipeline_cap_req queryPreparedLimit: @@ -533,15 +531,15 @@ components: x-has-default: true x-has-example: true x-desc-name: queryPreparedLimit - description: | + description: |- Maximum number of prepared statements in the cache. When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. - + x-desc-more: |- The [node-level][prepared-limit] `prepared-limit` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [prepared-limit]: ../n1ql-rest-admin/index.html#prepared-limit - x-desc-refs: | + x-desc-refs: |- [prepared-limit]: #prepared-limit queryScanCap: type: integer @@ -551,13 +549,13 @@ components: x-has-default: true x-has-example: true x-desc-name: queryScanCap - description: | + description: |- Maximum buffered channel size between the indexer client and the query service for index scans. This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. - + x-desc-more: |- The [node-level][scan-cap-srv] `scan-cap` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -566,7 +564,7 @@ components: [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req - x-desc-refs: | + x-desc-refs: |- [scan-cap-srv]: #scan-cap-srv [scan_cap_req]: #scan_cap_req queryTimeout: @@ -577,7 +575,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryTimeout - description: | + description: |- Maximum time to spend on the request before timing out (ns). The value for this setting is an integer, representing a duration in nanoseconds. @@ -585,7 +583,7 @@ components: Specify `0` (the default value) or a negative integer to disable. When disabled, no timeout is applied and the request runs for however long it takes. - + x-desc-more: |- The [node-level][timeout-srv] `timeout` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -594,7 +592,7 @@ components: [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv [timeout_req]: ../n1ql-rest-query/index.html#timeout_req - x-desc-refs: | + x-desc-refs: |- [timeout-srv]: #timeout-srv [timeout_req]: #timeout_req queryTxTimeout: @@ -605,7 +603,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryTxTimeout - description: | + description: |- Maximum time to spend on a transaction before timing out. This setting only applies to requests containing the `BEGIN TRANSACTION` statement, or to requests where the [tximplicit][tximplicit] parameter is set. For all other requests, it is ignored. @@ -624,16 +622,17 @@ components: Specify `0ms` (the default value) to disable. When disabled, no timeout is applied and the transaction runs for however long it takes. + [tximplicit]: ../n1ql-rest-query/index.html#tximplicit + x-desc-more: |- The [node-level][txtimeout-srv] `txtimeout` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. In addition, there is a [request-level][txtimeout_req] `txtimeout` parameter. If a request includes this parameter, it will be capped by the node-level `txtimeout` setting. - [tximplicit]: ../n1ql-rest-query/index.html#tximplicit [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req - x-desc-refs: | + x-desc-refs: |- [tximplicit]: #tximplicit [txtimeout-srv]: #txtimeout-srv [txtimeout_req]: #txtimeout_req @@ -642,7 +641,7 @@ components: example: "/opt/couchbase/var/lib/couchbase/tmp" x-has-example: true x-desc-name: queryTmpSpaceDir - description: | + description: |- The path to which the indexer writes temporary backfill files, to store any transient data during query processing. The specified path must already exist. @@ -657,7 +656,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryTmpSpaceSize - description: | + description: |- The maximum size of temporary backfill files (MB). Setting the size to `0` disables backfill. @@ -671,9 +670,9 @@ components: x-has-default: true x-has-example: true x-desc-name: queryUseCBO - description: | + description: |- Specifies whether the cost-based optimizer is enabled. - + x-desc-more: |- The [node-level][use-cbo-srv] `use-cbo` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -682,7 +681,7 @@ components: [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req - x-desc-refs: | + x-desc-refs: |- [use-cbo-srv]: #use-cbo-srv [use_cbo_req]: #use_cbo_req queryUseReplica: @@ -693,7 +692,7 @@ components: x-has-default: true x-has-example: true x-desc-name: queryUseReplica - description: | + description: |- Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. The possible values are: @@ -703,24 +702,24 @@ components: * `unset` — read from replica is enabled or disabled at request level. - The [node-level][use-replica-srv] `use-replica` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. - If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. - If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. - Do not enable read from replica when you require consistent results. Only SELECT queries that are not within a transaction can read from replica. - Reading from replica is only possible with databases running Couchbase Server 7.6.0 or later. + Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 or later. Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. + x-desc-more: |- + The [node-level][use-replica-srv] `use-replica` setting specifies this property for a single node. + When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. + + In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. + If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. + If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req - x-desc-refs: | + x-desc-refs: |- [use-replica-srv]: #use-replica-srv [use_replica_req]: #use_replica_req queryCurlWhitelist: @@ -735,7 +734,7 @@ components: properties: all_access: type: boolean - description: | + description: |- Defines whether the user has access to all URLs, or only URLs specified by the access list. This field set must be set to `false` to enable the `allowed_urls` and `disallowed_urls` fields. @@ -743,7 +742,7 @@ components: Setting this field to `true` enables access to all endpoints. allowed_urls: type: array - description: | + description: |- An array of strings, each of which is a URL to which you wish to grant access. Each URL is a prefix match. The CURL() function will allow any URL that starts with this value. @@ -757,7 +756,7 @@ components: type: string disallowed_urls: type: array - description: | + description: |- An array of strings, each of which is a URL that will be restricted for all roles. Each URL is a prefix match. The CURL() function will disallow any URL that starts with this value. @@ -773,7 +772,7 @@ components: Default: type: http scheme: basic - description: | + description: |- Users must have one of the following RBAC roles: * Full Admin diff --git a/templates/model.mustache b/templates/model.mustache index 847d5c67..c0d17631 100644 --- a/templates/model.mustache +++ b/templates/model.mustache @@ -29,7 +29,8 @@ a¦ {{>schemas}} {{/vars}} {{#additionalProperties}} {{! ADDITIONAL PROPERTY NAME }} -a¦ {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}}{{/vendorExtensions}} +a¦ {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}} +{{#x-additionalPropertiesName}}*{lt}{{this}}{gt}* +{{/x-additionalPropertiesName}}{{/vendorExtensions}} _additional + property_ {{! ADDITIONAL PROPERTY DESCRIPTION }} diff --git a/templates/property.mustache b/templates/property.mustache index f4f1cfa6..19eccde5 100644 --- a/templates/property.mustache +++ b/templates/property.mustache @@ -15,11 +15,26 @@ endif::alt-markdown-links[] {{#description}} {{{unescapedDescription}}} {{/description}} +{{#vendorExtensions}} +{{#x-desc-more}} + +{{{this}}} +{{/x-desc-more}} +{{/vendorExtensions}} {{! if ref is present, fetch remote description}} {{#ref}} include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{/ref}} -- +{{#vendorExtensions}} +{{#x-enumDescriptions}} + +.Enum Descriptions +.... +{{{this}}} +.... +{{/x-enumDescriptions}} +{{/vendorExtensions}} [%hardbreaks] {{! enumerated values}} @@ -80,4 +95,5 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{#vendorExtensions.x-has-example}} *Example:* `{{#isString}}+++"{{/isString}}{{{example}}}{{#isString}}"+++{{/isString}}` {{/vendorExtensions.x-has-example}} +{{! OpenAPI generator doesn't support externalDocs in schemas, so don't try }} {blank} \ No newline at end of file From a9352347650bf51c3acf6c55b27d23459adaef5a Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Tue, 15 Jul 2025 12:31:04 +0100 Subject: [PATCH 15/25] MB-67577: Migrate Query REST APIs to dev repo (#175) * Add preview config * Remove Query specs * Move Query gradle scripts to docs * Move Analytics specs and Gradle scripts to docs * Move Eventing specs and build scripts to docs * Move Index specs and Gradle scripts to docs * Move unpublished specs to docs * Update Gradle scripts for new spec locations * Update license and readmes * Update Git repo ID and user ID for query specs * Update copyright year * Build output documentation --- LICENSE | 4 +- README.adoc | 8 +- .../analytics-admin.gradle | 2 +- .../attachments}/analytics-admin.yaml | 0 .../analytics-rest-admin}/gradle.properties | 0 .../analytics-config.gradle | 2 +- .../attachments}/analytics-config.yaml | 0 .../analytics-rest-config}/gradle.properties | 0 .../analytics-library.gradle | 2 +- .../attachments}/analytics-library.yaml | 0 .../analytics-rest-library}/gradle.properties | 0 .../analytics-links.gradle | 2 +- .../attachments}/analytics-links.yaml | 0 .../analytics-rest-links}/gradle.properties | 0 .../analytics-service.gradle | 2 +- .../attachments}/analytics-service.yaml | 0 .../analytics-rest-service}/gradle.properties | 0 .../analytics-settings.gradle | 2 +- .../attachments}/analytics-settings.yaml | 0 .../gradle.properties | 0 .../attachments}/eventing.yaml | 0 .../attachments}/overlay.json | 0 .../eventing-rest-api}/eventing.gradle | 4 +- .../attachments}/indexes.yaml | 0 .../modules/index-rest-stats}/indexes.gradle | 2 +- .../modules/n1ql-rest-admin}/admin.gradle | 6 +- .../n1ql-rest-admin/attachments/_admin.yaml | 0 docs/modules/n1ql-rest-admin/pages/index.adoc | 100 ++--- .../attachments/_functions.yaml | 0 .../n1ql-rest-functions}/functions.gradle | 6 +- .../n1ql-rest-functions/pages/index.adoc | 77 ++-- .../attachments/_query-service.yaml | 0 docs/modules/n1ql-rest-query/pages/index.adoc | 370 ++++++++++++++++-- .../n1ql-rest-query}/query-service.gradle | 6 +- .../attachments/_query-settings.yaml | 0 .../n1ql-rest-settings/pages/index.adoc | 22 +- .../n1ql-rest-settings}/query-settings.gradle | 6 +- .../ns_server/attachments}/new_spec.yaml | 0 .../ns_server/attachments}/ns_server.yaml | 0 docs/modules/ns_server/readme.adoc | 3 + .../view_engine/attachments}/view_engine.yaml | 0 docs/modules/view_engine/readme.adoc | 3 + docs/preview/HEAD.yml | 7 + settings.gradle | 24 +- src/ns_server/readme.adoc | 3 - src/view_engine/readme.adoc | 3 - 46 files changed, 496 insertions(+), 170 deletions(-) rename {src/analytics-admin => docs/modules/analytics-rest-admin}/analytics-admin.gradle (89%) rename {src/analytics-admin/swagger => docs/modules/analytics-rest-admin/attachments}/analytics-admin.yaml (100%) rename {src/analytics-admin => docs/modules/analytics-rest-admin}/gradle.properties (100%) rename {src/analytics-config => docs/modules/analytics-rest-config}/analytics-config.gradle (89%) rename {src/analytics-config/swagger => docs/modules/analytics-rest-config/attachments}/analytics-config.yaml (100%) rename {src/analytics-config => docs/modules/analytics-rest-config}/gradle.properties (100%) rename {src/analytics-library => docs/modules/analytics-rest-library}/analytics-library.gradle (89%) rename {src/analytics-library/swagger => docs/modules/analytics-rest-library/attachments}/analytics-library.yaml (100%) rename {src/analytics-library => docs/modules/analytics-rest-library}/gradle.properties (100%) rename {src/analytics-links => docs/modules/analytics-rest-links}/analytics-links.gradle (89%) rename {src/analytics-links/swagger => docs/modules/analytics-rest-links/attachments}/analytics-links.yaml (100%) rename {src/analytics-links => docs/modules/analytics-rest-links}/gradle.properties (100%) rename {src/analytics-service => docs/modules/analytics-rest-service}/analytics-service.gradle (89%) rename {src/analytics-service/swagger => docs/modules/analytics-rest-service/attachments}/analytics-service.yaml (100%) rename {src/analytics-service => docs/modules/analytics-rest-service}/gradle.properties (100%) rename {src/analytics-settings => docs/modules/analytics-rest-settings}/analytics-settings.gradle (89%) rename {src/analytics-settings/swagger => docs/modules/analytics-rest-settings/attachments}/analytics-settings.yaml (100%) rename {src/analytics-settings => docs/modules/analytics-rest-settings}/gradle.properties (100%) rename {src/eventing/swagger => docs/modules/eventing-rest-api/attachments}/eventing.yaml (100%) rename {src/eventing/swagger => docs/modules/eventing-rest-api/attachments}/overlay.json (100%) rename {src/eventing => docs/modules/eventing-rest-api}/eventing.gradle (93%) rename {src/indexes/swagger => docs/modules/index-rest-stats/attachments}/indexes.yaml (100%) rename {src/indexes => docs/modules/index-rest-stats}/indexes.gradle (90%) rename {src/admin => docs/modules/n1ql-rest-admin}/admin.gradle (79%) rename src/admin/swagger/admin.yaml => docs/modules/n1ql-rest-admin/attachments/_admin.yaml (100%) rename src/functions/swagger/functions.yaml => docs/modules/n1ql-rest-functions/attachments/_functions.yaml (100%) rename {src/functions => docs/modules/n1ql-rest-functions}/functions.gradle (79%) rename src/query-service/swagger/query-service.yaml => docs/modules/n1ql-rest-query/attachments/_query-service.yaml (100%) rename {src/query-service => docs/modules/n1ql-rest-query}/query-service.gradle (79%) rename src/query-settings/swagger/query-settings.yaml => docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml (100%) rename {src/query-settings => docs/modules/n1ql-rest-settings}/query-settings.gradle (79%) rename {src/ns_server/swagger => docs/modules/ns_server/attachments}/new_spec.yaml (100%) rename {src/ns_server/swagger => docs/modules/ns_server/attachments}/ns_server.yaml (100%) create mode 100644 docs/modules/ns_server/readme.adoc rename {src/view_engine/swagger => docs/modules/view_engine/attachments}/view_engine.yaml (100%) create mode 100644 docs/modules/view_engine/readme.adoc create mode 100644 docs/preview/HEAD.yml delete mode 100644 src/ns_server/readme.adoc delete mode 100644 src/view_engine/readme.adoc diff --git a/LICENSE b/LICENSE index 8d8ca809..2ae20167 100644 --- a/LICENSE +++ b/LICENSE @@ -1,9 +1,9 @@ Couchbase Developer REST API Documentation © 2025 by Couchbase Inc. -Files within the top-level `src` directory are licensed under the Business Source License 1.1 (BSL). +Within the top-level `docs` directory, files in each `attachments` subdirectory are licensed under the Business Source License 1.1 (BSL). For details, see the BSL-Couchbase.txt file in the top-level `licenses` directory. -Files within the top-level `docs` directory are licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. +All other files within the top-level `docs` directory are licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. For details, see the CC-BY-NC-SA-4.0.txt file in the top-level `licenses` directory, or the Creative Commons CC BY-NC-SA 4.0 license page at https://creativecommons.org/licenses/by-nc-sa/4.0/. All other files are derivative works, based on the OpenAPI Generator Gradle Plugin. diff --git a/README.adoc b/README.adoc index 61cb39ad..acfe366e 100644 --- a/README.adoc +++ b/README.adoc @@ -5,7 +5,7 @@ This project uses the https://openapi-generator.tech/docs/plugins/#gradle[OpenAP == Usage guide This repository handles several OpenAPI subprojects. -Each subproject is stored in its own subfolder within the `src` folder. +Each subproject is stored in its own subfolder within the `docs/modules` folder. === Build Script @@ -19,12 +19,12 @@ These do not have a gradle build script. === OpenAPI Specification -Within each subproject, the OpenAPI Specification (JSON or YAML) is stored in a folder called `swagger`. +Within each subproject, the OpenAPI Specification (JSON or YAML) is stored in a folder called `attachments`. (For some subprojects, the OpenAPI specification file may be stored remotely, i.e. alongside the development source files.) === AsciiDoc Content -Each generated AsciiDoc page is stored in its own folder in the `docs` folder. +Within each subproject, the generated AsciiDoc page is stored in the `pages` folder. (In Antora terms, each generated AsciiDoc page is stored in its own module.) For each subproject, additional AsciiDoc content may be stored in the `partials` folder and its subfolders. @@ -50,7 +50,7 @@ This project is based on the https://openapi-generator.tech/[OpenAPI Generator] == Licensing -The Couchbase Developer REST API Documentation © 2024 by Couchbase Inc. is licensed under various licenses. +The Couchbase Developer REST API Documentation © 2025 by Couchbase Inc. is licensed under various licenses. The Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) is one such license. See the LICENSE file for details. All licenses used in this repository can be found in the top-level `licenses` directory. diff --git a/src/analytics-admin/analytics-admin.gradle b/docs/modules/analytics-rest-admin/analytics-admin.gradle similarity index 89% rename from src/analytics-admin/analytics-admin.gradle rename to docs/modules/analytics-rest-admin/analytics-admin.gradle index 73791c03..bab5986a 100644 --- a/src/analytics-admin/analytics-admin.gradle +++ b/docs/modules/analytics-rest-admin/analytics-admin.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/analytics-admin.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/analytics-admin.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-admin/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/analytics-admin/swagger/analytics-admin.yaml b/docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml similarity index 100% rename from src/analytics-admin/swagger/analytics-admin.yaml rename to docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml diff --git a/src/analytics-admin/gradle.properties b/docs/modules/analytics-rest-admin/gradle.properties similarity index 100% rename from src/analytics-admin/gradle.properties rename to docs/modules/analytics-rest-admin/gradle.properties diff --git a/src/analytics-config/analytics-config.gradle b/docs/modules/analytics-rest-config/analytics-config.gradle similarity index 89% rename from src/analytics-config/analytics-config.gradle rename to docs/modules/analytics-rest-config/analytics-config.gradle index 6c8a56d9..f77f94b9 100644 --- a/src/analytics-config/analytics-config.gradle +++ b/docs/modules/analytics-rest-config/analytics-config.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/analytics-config.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/analytics-config.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-config/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/analytics-config/swagger/analytics-config.yaml b/docs/modules/analytics-rest-config/attachments/analytics-config.yaml similarity index 100% rename from src/analytics-config/swagger/analytics-config.yaml rename to docs/modules/analytics-rest-config/attachments/analytics-config.yaml diff --git a/src/analytics-config/gradle.properties b/docs/modules/analytics-rest-config/gradle.properties similarity index 100% rename from src/analytics-config/gradle.properties rename to docs/modules/analytics-rest-config/gradle.properties diff --git a/src/analytics-library/analytics-library.gradle b/docs/modules/analytics-rest-library/analytics-library.gradle similarity index 89% rename from src/analytics-library/analytics-library.gradle rename to docs/modules/analytics-rest-library/analytics-library.gradle index d6d715db..7ad4c57f 100644 --- a/src/analytics-library/analytics-library.gradle +++ b/docs/modules/analytics-rest-library/analytics-library.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/analytics-library.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/analytics-library.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-library/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/analytics-library/swagger/analytics-library.yaml b/docs/modules/analytics-rest-library/attachments/analytics-library.yaml similarity index 100% rename from src/analytics-library/swagger/analytics-library.yaml rename to docs/modules/analytics-rest-library/attachments/analytics-library.yaml diff --git a/src/analytics-library/gradle.properties b/docs/modules/analytics-rest-library/gradle.properties similarity index 100% rename from src/analytics-library/gradle.properties rename to docs/modules/analytics-rest-library/gradle.properties diff --git a/src/analytics-links/analytics-links.gradle b/docs/modules/analytics-rest-links/analytics-links.gradle similarity index 89% rename from src/analytics-links/analytics-links.gradle rename to docs/modules/analytics-rest-links/analytics-links.gradle index 38fd331a..2fa35122 100644 --- a/src/analytics-links/analytics-links.gradle +++ b/docs/modules/analytics-rest-links/analytics-links.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/analytics-links.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/analytics-links.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-links/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/analytics-links/swagger/analytics-links.yaml b/docs/modules/analytics-rest-links/attachments/analytics-links.yaml similarity index 100% rename from src/analytics-links/swagger/analytics-links.yaml rename to docs/modules/analytics-rest-links/attachments/analytics-links.yaml diff --git a/src/analytics-links/gradle.properties b/docs/modules/analytics-rest-links/gradle.properties similarity index 100% rename from src/analytics-links/gradle.properties rename to docs/modules/analytics-rest-links/gradle.properties diff --git a/src/analytics-service/analytics-service.gradle b/docs/modules/analytics-rest-service/analytics-service.gradle similarity index 89% rename from src/analytics-service/analytics-service.gradle rename to docs/modules/analytics-rest-service/analytics-service.gradle index 49e3ed15..22535a95 100644 --- a/src/analytics-service/analytics-service.gradle +++ b/docs/modules/analytics-rest-service/analytics-service.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/analytics-service.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/analytics-service.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-service/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/analytics-service/swagger/analytics-service.yaml b/docs/modules/analytics-rest-service/attachments/analytics-service.yaml similarity index 100% rename from src/analytics-service/swagger/analytics-service.yaml rename to docs/modules/analytics-rest-service/attachments/analytics-service.yaml diff --git a/src/analytics-service/gradle.properties b/docs/modules/analytics-rest-service/gradle.properties similarity index 100% rename from src/analytics-service/gradle.properties rename to docs/modules/analytics-rest-service/gradle.properties diff --git a/src/analytics-settings/analytics-settings.gradle b/docs/modules/analytics-rest-settings/analytics-settings.gradle similarity index 89% rename from src/analytics-settings/analytics-settings.gradle rename to docs/modules/analytics-rest-settings/analytics-settings.gradle index fcec26c5..6ddb10dc 100644 --- a/src/analytics-settings/analytics-settings.gradle +++ b/docs/modules/analytics-rest-settings/analytics-settings.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/analytics-settings.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/analytics-settings.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-settings/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/analytics-settings/swagger/analytics-settings.yaml b/docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml similarity index 100% rename from src/analytics-settings/swagger/analytics-settings.yaml rename to docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml diff --git a/src/analytics-settings/gradle.properties b/docs/modules/analytics-rest-settings/gradle.properties similarity index 100% rename from src/analytics-settings/gradle.properties rename to docs/modules/analytics-rest-settings/gradle.properties diff --git a/src/eventing/swagger/eventing.yaml b/docs/modules/eventing-rest-api/attachments/eventing.yaml similarity index 100% rename from src/eventing/swagger/eventing.yaml rename to docs/modules/eventing-rest-api/attachments/eventing.yaml diff --git a/src/eventing/swagger/overlay.json b/docs/modules/eventing-rest-api/attachments/overlay.json similarity index 100% rename from src/eventing/swagger/overlay.json rename to docs/modules/eventing-rest-api/attachments/overlay.json diff --git a/src/eventing/eventing.gradle b/docs/modules/eventing-rest-api/eventing.gradle similarity index 93% rename from src/eventing/eventing.gradle rename to docs/modules/eventing-rest-api/eventing.gradle index a543d27f..f20450b1 100644 --- a/src/eventing/eventing.gradle +++ b/docs/modules/eventing-rest-api/eventing.gradle @@ -4,7 +4,7 @@ plugins { jayOverlay { targetFile.set("${projectDir}/build/bundle/eventing.yaml") - overlayFile.set("${projectDir}/swagger/overlay.json") + overlayFile.set("${projectDir}/attachments/overlay.json") outputDir.set("${projectDir}/build/overlay") } @@ -12,7 +12,7 @@ apply plugin: 'org.openapi.generator' task bundleSpec(type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask) { generatorName = "openapi-yaml" - inputSpec = file("swagger/eventing.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/eventing.yaml").getAbsolutePath().toString() outputDir = "${projectDir}/build/bundle" globalProperties = [ generateAliasAsModel: "true" diff --git a/src/indexes/swagger/indexes.yaml b/docs/modules/index-rest-stats/attachments/indexes.yaml similarity index 100% rename from src/indexes/swagger/indexes.yaml rename to docs/modules/index-rest-stats/attachments/indexes.yaml diff --git a/src/indexes/indexes.gradle b/docs/modules/index-rest-stats/indexes.gradle similarity index 90% rename from src/indexes/indexes.gradle rename to docs/modules/index-rest-stats/indexes.gradle index 9b64006a..bff74967 100644 --- a/src/indexes/indexes.gradle +++ b/docs/modules/index-rest-stats/indexes.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/indexes.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/indexes.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/index-rest-stats/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/src/admin/admin.gradle b/docs/modules/n1ql-rest-admin/admin.gradle similarity index 79% rename from src/admin/admin.gradle rename to docs/modules/n1ql-rest-admin/admin.gradle index 33bca101..8c1a64dc 100644 --- a/src/admin/admin.gradle +++ b/docs/modules/n1ql-rest-admin/admin.gradle @@ -2,11 +2,11 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/admin.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/admin/admin.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-admin/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" - gitUserId = "couchbaselabs" + gitRepoId = "query" + gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-admin/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-admin/partials/paths/", diff --git a/src/admin/swagger/admin.yaml b/docs/modules/n1ql-rest-admin/attachments/_admin.yaml similarity index 100% rename from src/admin/swagger/admin.yaml rename to docs/modules/n1ql-rest-admin/attachments/_admin.yaml diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 9eaa95f1..23fcb5be 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/query :leveloffset: 1 @@ -32,7 +32,7 @@ This API enables you to retrieve statistics about the clusters and nodes running [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information @@ -2515,8 +2515,6 @@ GET /admin/gc [markdown] -- -This endpoint is available in databases running Couchbase Server 7.6.0 and later. - Runs the garbage collector. A message is written to `query.log` whenever the garbage collector endpoint is invoked. @@ -2804,9 +2802,7 @@ POST /admin/gc [markdown] -- -This endpoint is available in databases running Couchbase Server 7.6.0 and later. - -Runs the garbage collector and attempts to return freed memory to the OS. +Run the garbage collector and attempts to return freed memory to the OS. A message is written to `query.log` whenever the garbage collector endpoint is invoked. -- @@ -4935,7 +4931,7 @@ All completed requests that match these parameters are tracked in the completed Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. -[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config //end::desc-Logging_Parameters[] endif::model-descriptions[] @@ -5031,7 +5027,7 @@ A unique string which tags a set of qualifiers. Refer to [Configure Completed Requests][sys-completed-config] for more information. -[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config -- [%hardbreaks] @@ -5088,7 +5084,6 @@ a¦ -- A LIKE search pattern to match against the query text. If specified, all completed queries where the pattern is found are logged. - -- [%hardbreaks] @@ -5121,7 +5116,7 @@ a¦ [markdown] -- The number of errors. -If specified, all completed queries that return at least this many errors are logged. +If specified, all completed queries that return at least this many errors are logged. Queries with fewer errors are not logged. -- @@ -5204,13 +5199,18 @@ endif::collapse-models[] //tag::Logging_Parameters_Plan_Pairs[] +ifdef::model-descriptions[] +//tag::desc-Logging_Parameters_Plan_Pairs[] +An object containing one or more field:value pairs. +//end::desc-Logging_Parameters_Plan_Pairs[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== ¦ Property ¦ ¦ Schema a¦ - +*{lt}field{gt}* + _additional + property_ a¦ @@ -5693,6 +5693,24 @@ Refer to the [request-level][client_context_id] `client_context_id` parameter fo a¦ String +a¦ +*cpuTime* + +_optional_ +a¦ + +[markdown] +-- +The total sum of [execTime][exec_time] across all operators. + +[exec_time]: ../n1ql-rest-query/index.html#exec_time +-- + +[%hardbreaks] +*Example:* `+++"90.734075ms"+++` +{blank} +a¦ String (duration) + + a¦ *elapsedTime* + _optional_ @@ -5733,8 +5751,7 @@ a¦ -- The total sum of [servTime][serv_time] across all operators. -[serv_time]: ../n1ql-rest-query/index.html#serv_time - +[serv_time]: ../n1ql-rest-query/index.html#serv_time -- [%hardbreaks] @@ -5946,12 +5963,11 @@ a¦ -- The memory session size for the request, in bytes. -Each request has a dedicated memory session. +Each request has a dedicated memory session. When a query requires a document or value, memory is allocated from this session based on the size of the document or value. -Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. +Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. - -- [%hardbreaks] @@ -6064,8 +6080,7 @@ a¦ -- The total sum of [kernTime][kern_time] across all operators. -[kern_time]: ../n1ql-rest-query/index.html#kern_time - +[kern_time]: ../n1ql-rest-query/index.html#kern_time -- [%hardbreaks] @@ -6081,9 +6096,8 @@ a¦ [markdown] -- -An array of text phrases that provide a basic analysis of the request execution. +An array of text phrases that provide a basic analysis of the request execution. These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. - -- [%hardbreaks] @@ -6177,7 +6191,7 @@ Specifies whether the query engine should create a prepared statement every time Refer to [Auto-Prepare][auto-prepare] for more information. -[auto-prepare]: /cloud/n1ql/n1ql-language-reference/prepare.html#auto-prepare +[auto-prepare]: ../n1ql/n1ql-language-reference/prepare.html#auto-prepare -- [%hardbreaks] @@ -6312,7 +6326,7 @@ Increase this when the completed request keyspace is not big enough to track the Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6330,7 +6344,7 @@ a¦ Integer (int32) a¦ [#completed-max-plan-size] *completed-max-plan-size* + _optional_ -a¦ [.status]##Couchbase Server 7.6## +a¦ [markdown] -- @@ -6338,8 +6352,6 @@ ifdef::alt-markdown-links[] [queryCompletedMaxPlanSize]: #queryCompletedMaxPlanSize endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - A plan size in bytes. Limits the size of query execution plans that can be logged in the completed requests catalog. Values larger than the maximum limit are silently treated as the maximum limit. @@ -6348,7 +6360,7 @@ You must obtain execution plans for such queries via profiling or using the EXPL Refer to [Configure Completed Requests][sys-completed-config] for more information. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6380,7 +6392,7 @@ Specify `0` (the default) to disable completed request streaming. Refer to [Stream Completed Requests][sys-history] for more information and examples. -[sys-history]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-history +[sys-history]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-history -- [%hardbreaks] @@ -6407,7 +6419,7 @@ Specify any negative number to track none. Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. -[sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6633,7 +6645,7 @@ In Community Edition, the number of allowed cores cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed cores.) Refer to [Max Parallelism][max-parallelism] for more information. -[max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism +[max-parallelism]: ../n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism The [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6671,9 +6683,8 @@ Specifies the maximum amount of memory a request may use on this node, in MB. Specify `0` (the default value) to disable. When disabled, there is no quota. -This parameter enforces a ceiling on the memory used for the tracked documents required for -processing a request. It does not take into account any other memory that might be used to -process a request, such as the stack, the operators, or some intermediate values. +This parameter enforces a ceiling on the memory used for the tracked documents required for processing a request. +It does not take into account any other memory that might be used to process a request, such as the stack, the operators, or some intermediate values. Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). @@ -6746,8 +6757,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] SQL++ feature control. This setting is provided for technical support only. -The value may be an integer. -On databases running Couchbase Server 7.6 or later, it may also be a string representing a hexadecimal number. +The value may be an integer, or a string representing a hexadecimal number. The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6765,7 +6775,7 @@ a¦ Integer (int32) a¦ [#node-quota] *node-quota* + _optional_ -a¦ [.status]##Couchbase Server 7.6## +a¦ [markdown] -- @@ -6773,8 +6783,6 @@ ifdef::alt-markdown-links[] [queryNodeQuota]: #queryNodeQuota endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - Sets the soft memory limit for the Query service on this node, in MB. The garbage collector tries to keep below this target. It is not a hard, absolute limit, and memory usage may exceed this value. @@ -6803,7 +6811,7 @@ a¦ Integer (int32) a¦ [#node-quota-val-percent] *node-quota-val-percent* + _optional_ -a¦ [.status]##Couchbase Server 7.6## +a¦ [markdown] -- @@ -6811,8 +6819,6 @@ ifdef::alt-markdown-links[] [queryNodeQuotaValPercent]: #queryNodeQuotaValPercent endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - The percentage of the `node-quota` that is dedicated to tracked value content memory across all active requests on this node. (The `memory-quota` setting specifies the maximum amount of document memory an individual request may use on this node.) @@ -6833,7 +6839,7 @@ a¦ Integer (int32) a¦ [#num-cpus] *num-cpus* + _optional_ -a¦ [.status]##Couchbase Server 7.6## +a¦ [markdown] -- @@ -6841,8 +6847,6 @@ ifdef::alt-markdown-links[] [queryNumCpus]: #queryNumCpus endif::alt-markdown-links[] -This property is available in databases running Couchbase Server 7.6.0 and later. - The number of CPUs the Query service can use on this node. Note that this setting requires a restart of the Query service to take effect. @@ -6878,7 +6882,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies the total number of [active transaction records][additional-storage-use]. -[additional-storage-use]: /cloud/learn/data/transactions.html#active-transaction-record-entries +[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries The [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -7053,7 +7057,7 @@ NOTE: If `profile` is not set as one of the above values, then the profile setti Refer to [Monitoring and Profiling Details][monitor-profile-details] for more information and examples. -[monitor-profile-details]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details +[monitor-profile-details]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details The [request-level][profile_req] `profile` parameter specifies this property per request. If a request does not include this parameter, the node-level `profile` setting will be used. @@ -7252,7 +7256,7 @@ a¦ Boolean a¦ [#use-replica-srv] *use-replica* + _optional_ -a¦ [.status]##Couchbase Server 7.6## +a¦ [markdown] -- @@ -7273,7 +7277,7 @@ The possible values are: Do not enable read from replica when you require consistent results. Only SELECT queries that are not within a transaction can read from replica. -Reading from replica is only possible with databases running Couchbase Server 7.6.0 or later. +Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 or later. Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. diff --git a/src/functions/swagger/functions.yaml b/docs/modules/n1ql-rest-functions/attachments/_functions.yaml similarity index 100% rename from src/functions/swagger/functions.yaml rename to docs/modules/n1ql-rest-functions/attachments/_functions.yaml diff --git a/src/functions/functions.gradle b/docs/modules/n1ql-rest-functions/functions.gradle similarity index 79% rename from src/functions/functions.gradle rename to docs/modules/n1ql-rest-functions/functions.gradle index 05055b6d..6f3ffc40 100644 --- a/src/functions/functions.gradle +++ b/docs/modules/n1ql-rest-functions/functions.gradle @@ -2,11 +2,11 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/functions.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/functions/functions.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-functions/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" - gitUserId = "couchbaselabs" + gitRepoId = "query" + gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-functions/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-functions/partials/paths/", diff --git a/docs/modules/n1ql-rest-functions/pages/index.adoc b/docs/modules/n1ql-rest-functions/pages/index.adoc index 48f8032c..ea17243b 100644 --- a/docs/modules/n1ql-rest-functions/pages/index.adoc +++ b/docs/modules/n1ql-rest-functions/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/query :leveloffset: 1 @@ -32,7 +32,7 @@ This API enables you to manage the JavaScript libraries and objects that are use [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information @@ -174,7 +174,6 @@ Deletes the specified library entirely. By default, this operation deletes a global library. For a scoped library, you must specify the bucket and scope. - -- @@ -243,8 +242,8 @@ a¦ [markdown] -- -For scoped libraries only. The bucket in which the library is stored. - +For scoped libraries only. +The bucket in which the library is stored. -- [%hardbreaks] @@ -261,8 +260,8 @@ a¦ [markdown] -- -For scoped libraries only. The scope in which the library is stored. - +For scoped libraries only. +The scope in which the library is stored. -- [%hardbreaks] @@ -313,13 +312,13 @@ a| | 400 a| [markdown] -- -Bad request. The path may not conform to the schema. +Bad request. The path may not conform to the schema. -- a| | 404 a| [markdown] -- -Not found. The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. +Not found. The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. -- a| @@ -421,8 +420,9 @@ GET /evaluator/v1/libraries -- Returns all libraries and functions. -By default, this operation returns all global libraries and functions, and all scoped libraries and functions. To return all the libraries and functions in a single scope, specify a bucket and scope. +By default, this operation returns all global libraries and functions, and all scoped libraries and functions. +To return all the libraries and functions in a single scope, specify a bucket and scope. -- @@ -468,8 +468,8 @@ a¦ [markdown] -- -For scoped libraries only. The bucket from which to fetch libraries. - +For scoped libraries only. +The bucket from which to fetch libraries. -- [%hardbreaks] @@ -486,8 +486,8 @@ a¦ [markdown] -- -For scoped libraries only. The scope from which to fetch libraries. - +For scoped libraries only. +The scope from which to fetch libraries. -- [%hardbreaks] @@ -540,7 +540,7 @@ a| xref:Libraries[] | 400 a| [markdown] -- -Bad request. The path may not conform to the schema. +Bad request. The path may not conform to the schema. -- a| @@ -642,8 +642,9 @@ GET /evaluator/v1/libraries/{library} -- Returns a library with all its functions. -By default, this operation returns a global library. For a scoped library, you must specify the bucket and scope. +By default, this operation returns a global library. +For a scoped library, you must specify the bucket and scope. -- @@ -715,8 +716,8 @@ a¦ [markdown] -- -For scoped libraries only. The bucket in which the library is stored. - +For scoped libraries only. +The bucket in which the library is stored. -- [%hardbreaks] @@ -733,8 +734,8 @@ a¦ [markdown] -- -For scoped libraries only. The scope in which the library is stored. - +For scoped libraries only. +The scope in which the library is stored. -- [%hardbreaks] @@ -787,13 +788,13 @@ a| xref:Functions[] | 400 a| [markdown] -- -Bad request. The path may not conform to the schema. +Bad request. The path may not conform to the schema. -- a| | 404 a| [markdown] -- -Not found. The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. +Not found. The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. -- a| @@ -893,10 +894,12 @@ POST /evaluator/v1/libraries/{library} [markdown] -- -Creates the specified library and its associated functions. If the specified library exists, the existing library is overwritten. +Creates the specified library and its associated functions. +If the specified library exists, the existing library is overwritten. -By default, this operation creates or updates a global library. For a scoped library, you must specify the bucket and scope. +By default, this operation creates or updates a global library. +For a scoped library, you must specify the bucket and scope. -- @@ -968,8 +971,8 @@ a¦ [markdown] -- -For scoped libraries only. The bucket in which the library is stored. - +For scoped libraries only. +The bucket in which the library is stored. -- [%hardbreaks] @@ -986,8 +989,8 @@ a¦ [markdown] -- -For scoped libraries only. The scope in which the library is stored. - +For scoped libraries only. +The scope in which the library is stored. -- [%hardbreaks] @@ -1064,13 +1067,13 @@ a| | 400 a| [markdown] -- -Bad request. The body of the request may be incorrect, or the path may not conform to the schema. +Bad request. The body of the request may be incorrect, or the path may not conform to the schema. -- a| | 404 a| [markdown] -- -Not found. The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. +Not found. The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. -- a| @@ -1203,7 +1206,7 @@ endif::collapse-models[] ¦ Property ¦ ¦ Schema a¦ - +*{lt}library{gt}* + _additional + property_ a¦ @@ -1213,7 +1216,6 @@ a¦ The JavaScript code for all functions in the library. The name of the property is the name of the library. - -- [%hardbreaks] @@ -1286,8 +1288,8 @@ a¦ [markdown] -- -For scoped libraries, the bucket in which the library is stored. For global libraries, this string is empty. - +For scoped libraries, the bucket in which the library is stored. +For global libraries, this string is empty. -- [%hardbreaks] @@ -1303,8 +1305,8 @@ a¦ [markdown] -- -For scoped libraries, the scope in which the library is stored. For global libraries, this string is empty. - +For scoped libraries, the scope in which the library is stored. +For global libraries, this string is empty. -- [%hardbreaks] @@ -1321,7 +1323,6 @@ a¦ [markdown] -- The JavaScript code for all functions in the library. - -- [%hardbreaks] @@ -1385,7 +1386,6 @@ include::{specDir}security/document-begin.adoc[opts=optional] To manage global libraries, users must have the *Manage Global External Functions* RBAC role. This role enables you to create, read, update, or delete any global library, but does not give you access to any scoped libraries. - -- [%hardbreaks] @@ -1419,7 +1419,6 @@ To manage scoped libraries, users must have the *Manage Scope External Functions This role enables you to create, read, update, or delete any library in the scope to which you have access, but does not give you access to any other scoped libraries. In addition, this role enables you to read any global library, but not to create, update, or delete them. - -- [%hardbreaks] diff --git a/src/query-service/swagger/query-service.yaml b/docs/modules/n1ql-rest-query/attachments/_query-service.yaml similarity index 100% rename from src/query-service/swagger/query-service.yaml rename to docs/modules/n1ql-rest-query/attachments/_query-service.yaml diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 00985240..216c1157 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/query :leveloffset: 1 @@ -365,6 +365,8 @@ a| xref:Response[] | http (basic) | xref:security-header[] +| apiKey +| xref:security-parameter[] |=== @@ -627,6 +629,8 @@ a| xref:Response[] | http (basic) | xref:security-header[] +| apiKey +| xref:security-parameter[] |=== @@ -679,7 +683,7 @@ endif::[] [#models] = Definitions -:count-models: 8 +:count-models: 9 :leveloffset: +1 @@ -695,6 +699,7 @@ endif::collapse-models[] [%hardbreaks] xref:Conditions[] xref:Controls[] +xref:Credentials[] xref:Execution_Timings[] xref:Metrics[] xref:Profile[] @@ -949,6 +954,80 @@ include::{specDir}definitions/Controls/definition-end.adoc[opts=optional] +// markup not found, no include::{specDir}definitions/Credentials/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#Credentials] += Credentials + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/Credentials/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::Credentials[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*user* + +_optional_ +a¦ + +[markdown] +-- +An identity for authentication. +Note that bucket names may be prefixed with `local:`, and admin names may be prefixed with `admin:`. +-- + +[%hardbreaks] +*Example:* `+++"local:bucket-name"+++` +{blank} +a¦ String + + +a¦ +*pass* + +_optional_ +a¦ + +[markdown] +-- +A password for authentication. +-- + +[%hardbreaks] +*Example:* `+++"password"+++` +{blank} +a¦ String + + +|=== + +//end::Credentials[] + + + + +// markup not found, no include::{specDir}definitions/Credentials/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/Credentials/definition-after.adoc[opts=optional] + + + + // markup not found, no include::{specDir}definitions/Execution_Timings/definition-before.adoc[opts=optional] @@ -1084,7 +1163,7 @@ The total time taken for the request, that is the time from when the request was [%hardbreaks] {blank} -a¦ String +a¦ String (duration) a¦ @@ -1099,7 +1178,7 @@ The time taken for the execution of the request, that is the time from when quer [%hardbreaks] {blank} -a¦ String +a¦ String (duration) a¦ @@ -1132,6 +1211,22 @@ The total number of bytes in the results. a¦ Integer (unsigned) +a¦ +*naturalLanguageProcessingTime* + +_optional_ +a¦ + +[markdown] +-- +The total time spent processing a natural language request. +The cumulation of authentication, collecting schema, and time waiting for the response from the LLM, or wait time for the natural language request to be serviced. +-- + +[%hardbreaks] +{blank} +a¦ String (duration) + + a¦ *mutationCount* + _optional_ @@ -1220,10 +1315,11 @@ a¦ -- The memory session size for the request, in bytes. -Each request has a dedicated memory session. When a query requires a document or value, memory is allocated from this session based on the size of the document or value. Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. +Each request has a dedicated memory session. +When a query requires a document or value, memory is allocated from this session based on the size of the document or value. +Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. - -- [%hardbreaks] @@ -1435,7 +1531,7 @@ a¦ [markdown] -- -An array of text phrases that provide a basic analysis of the request execution. +An array of text phrases that provide a basic analysis of the request execution. These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. -- @@ -1501,7 +1597,7 @@ The value is an array of JSON values, one for each positional parameter in the s Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for details. -[section_srh_tlm_n1b]: /cloud/n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b +[section_srh_tlm_n1b]: ../n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b -- [%hardbreaks] @@ -1554,7 +1650,7 @@ This saves you from having to make two separate requests in cases where you want Refer to [Auto-Execute][auto-execute] for more information. -[auto-execute]: /cloud/n1ql/n1ql-language-reference/prepare.html#auto-execute +[auto-execute]: ../n1ql/n1ql-language-reference/prepare.html#auto-execute -- [%hardbreaks] @@ -1632,6 +1728,28 @@ The request-level parameter overrides the node-level setting. a¦ Boolean +a¦ [#creds] +*creds* + +_optional_ +a¦ + +[markdown] +-- +Specifies the login credentials. +The Query API supports two types of identity: local (or bucket) and admin. + +The format is an identity and password. +You can specify credentials for multiple identities. + +If credentials are supplied in the request header, then HTTP Basic Authentication takes precedence and `creds` is ignored. +-- + +[%hardbreaks] +*Example:* `[{"user":"local:bucket-name","pass":"password"},{"user":"admin:admin-name","pass":"password"}]` +{blank} +a¦ xref:Credentials[] + array + a¦ [#durability_level] *durability_level* + _optional_ @@ -1649,7 +1767,7 @@ In this case, the `kvtimeout` parameter is used as the durability timeout. If not specified, the default durability level is `"majority"`. Set the durability level to `"none"` or `""` to specify no durability. -[durability]: /server/7.6/learn/data/durability.html +[durability]: /server/8.0/learn/data/durability.html -- [%hardbreaks] @@ -1667,8 +1785,8 @@ a¦ [markdown] -- -In Couchbase Server 6.5 and later, this parameter is ignored and has no effect. -It is included for compatibility with previous versions of Couchbase Server. +In clusters running Couchbase Server 6.5 and later, this parameter is ignored and has no effect. +It is included for compatibility with previous versions. -- [%hardbreaks] @@ -1801,9 +1919,8 @@ Specifies the maximum amount of memory the request may use, in MB. Specify `0` (the default value) to disable. When disabled, there is no quota. -This parameter enforces a ceiling on the memory used for the tracked documents required for -processing a request. It does not take into account any other memory that might be used to -process a request, such as the stack, the operators, or some intermediate values. +This parameter enforces a ceiling on the memory used for the tracked documents required for processing a request. +It does not take into account any other memory that might be used to process a request, such as the stack, the operators, or some intermediate values. Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). @@ -1860,6 +1977,151 @@ Currently, only the `default` namespace is available. a¦ String +a¦ [#natural] +*natural* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +The prompt for a natural language request. +The Query Service uses the prompt to generate a SQL++ statement. + +If the generated statement is a SELECT statement, the generated statement is returned and executed automatically. + +If the generated statement is not a SELECT statement, the generated statement is returned, but not executed. +In this case, you must verify the statement and execute it in a separate request. + +Natural language requests use the Couchbase Capella iQ service as a backend. +You must have a Couchbase Capella account to make a natural language request. + +This parameter is available in clusters running Couchbase Server 8.0 and later. + +To use this parameter, you must also specify the `natural_cred`, `natural_orgid`, and `natural_context` parameters. +If you don't specify all four parameters, the Query Service returns an error. +-- + +[%hardbreaks] +*Example:* `+++"Show me count of airlines per country"+++` +{blank} +a¦ String + + +a¦ [#natural_cred] +*natural_cred* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +The Couchbase Capella credentials for a natural language request, in the form `username:password`. +Be careful not to expose the credentials in log files or other output. + +Natural language requests use the Couchbase Capella iQ service as a backend. +You must have a Couchbase Capella account to make a natural language request. + +This parameter is available in clusters running Couchbase Server 8.0 and later. + +To use this parameter, you must also specify the `natural`, `natural_orgid`, and `natural_context` parameters. +If you don't specify all four parameters, the Query Service returns an error. +-- + +[%hardbreaks] +*Example:* `+++"username:password"+++` +{blank} +a¦ String (password) + + +a¦ [#natural_orgid] +*natural_orgid* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +The Couchbase Capella organization ID for a natural language request. + +Natural language requests use the Couchbase Capella iQ service as a backend. +You must have a Couchbase Capella account to make a natural language request. + +This parameter is available in clusters running Couchbase Server 8.0 and later. + +To use this parameter, you must also specify the `natural`, `natural_cred`, and `natural_context` parameters. +If you don't specify all four parameters, the Query Service returns an error. +-- + +[%hardbreaks] +{blank} +a¦ UUID (uuid) + + +a¦ [#natural_context] +*natural_context* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +A list of paths specifying keyspaces for a natural language request. +The Query Service infers the schema of each keyspace, in order to give more precise responses from the natural language request. + +The parameter may contain up to four paths, separated by commas. +Spaces are allowed. +Each path may be: + +* A full path, in the form `bucket.scope.collection` or `namespace:bucket.scope.collection`. + +* A path prefix, in the form `namespace:bucket` or `bucket`, to specify the default collection in the default scope. + +* A partial path, in the form `collection`. + In this case, you must specify the `query_context` parameter to provide the bucket and scope. + +Natural language requests use the Couchbase Capella iQ service as a backend. +You must have a Couchbase Capella account to make a natural language request. + +This parameter is available in clusters running Couchbase Server 8.0 and later. + +To use this parameter, you must also specify the `natural`, `natural_cred`, and `natural_orgid` parameters. +If you don't specify all four parameters, the Query Service returns an error. +-- + +[%hardbreaks] +*Example:* `+++"travel-sample, travel-sample.inventory.airline, airline"+++` +{blank} +a¦ String + + +a¦ [#natural_output] +*natural_output* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +Specifies the required output for a natural language request. + +* `sql` — + The output is a SQL++ statement. + +* `jsudf` — + The output is a `CREATE FUNCTION` statement which you can use to generate a SQL++ managed JavaScript user-defined function. + +* `ftssql` — + The output is a SQL++ statement which can use a Flex index, if available. + +Natural language requests use the Couchbase Capella iQ service as a backend. +You must have a Couchbase Capella account to make a natural language request. + +This parameter is available in clusters running Couchbase Server 8.0 and later. +-- + +[%hardbreaks] +*Values:* `"sql"`, `"jsudf"`, `"ftssql"` +*Default:* `+++"sql"+++` +{blank} +a¦ String + + a¦ [#numatrs_req] *numatrs* + _optional_ @@ -1961,18 +2223,18 @@ a¦ [markdown] -- -_Required_ if `statement` not provided. +_Required_ if `statement` or `natural` not provided. The name of the prepared SQL++ statement to be executed. Refer to [EXECUTE][execute] for examples. If both `prepared` and `statement` are present and non-empty, an error is returned. -[execute]: /cloud/n1ql/n1ql-language-reference/execute.html +[execute]: ../n1ql/n1ql-language-reference/execute.html -- [%hardbreaks] -*Example:* `+++"a1355198-2576-4e3d-af04-5acc77d8a681"+++` +*Example:* `+++"[127.0.0.1:8091]pricy_hotel"+++` {blank} a¦ String @@ -2186,7 +2448,7 @@ If you want to disable RYOW within a request, add a separate `request_consistenc If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, then this parameter sets the transactional scan consistency. Refer to [Transactional Scan Consistency][transactional-scan-consistency] for details. -[transactional-scan-consistency]: /cloud/n1ql/n1ql-manage/query-settings.html#transactional-scan-consistency +[transactional-scan-consistency]: ../n1ql/n1ql-manage/query-settings.html#transactional-scan-consistency -- [%hardbreaks] @@ -2326,7 +2588,7 @@ a¦ [markdown] -- -_Required_ if `prepared` not provided. +_Required_ if `prepared` or `natural` not provided. Any valid SQL++ statement for a POST request, or a read-only SQL++ statement (SELECT, EXPLAIN) for a GET request. @@ -2575,7 +2837,7 @@ If none of the available Search indexes are qualified, the available GSI indexes Refer to [Flex Indexes][flex-indexes] for more information. -[flex-indexes]: /cloud/n1ql/n1ql-language-reference/flex-indexes.html +[flex-indexes]: ../n1ql/n1ql-language-reference/flex-indexes.html -- [%hardbreaks] @@ -2610,7 +2872,7 @@ If the node-level setting is also `unset`, read from replica is disabled for thi Do not enable read from replica when you require consistent results. Only SELECT queries that are not within a transaction can read from replica. -Reading from replica is only possible with databases running Couchbase Server 7.6.0 or later. +Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 or later. Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. @@ -2647,19 +2909,24 @@ Applicable if the statement or prepared statement contains 1 or more named param The name of this property consists of two parts: -1. The `$` character. - In databases running Couchbase Server 7.6.0 and later, this may be the `$` character or the `@` character. +1. The `$` character or the `@` character. 2. An identifier that specifies the name of the parameter. - This must start with an alpha character, followed by one or more alphanumeric characters. + This starts with an optional underscore (`_`), followed by an alpha character, followed by one or more alphanumeric characters, and ends with an optional underscore (`_`). + +If the named parameter contains sensitive information, start and end the name of the parameter (after the initial `$` or `@`) with an underscore (`_`). +This masks the parameter value in the active requests catalog, the completed requests catalog, the response `controls` section, the cbq shell file history, and the query logs. +When masked, a string parameter value is replaced by asterisks (`*`); other parameter values are replaced by `null`. +Parameter masking is available in clusters running Couchbase Server 7.6.8 and later. The value of the named parameter can be any JSON value. Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for details. -[section_srh_tlm_n1b]: /cloud/n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b +[section_srh_tlm_n1b]: ../n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b -- [%hardbreaks] +*Example:* `LAX` {blank} a¦ Any Type @@ -2740,6 +3007,22 @@ The client context ID of the request, if one was supplied — see `client_co a¦ String +a¦ +*generated_statement* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +The generated statement, if the request was a natural language prompt. +-- + +[%hardbreaks] +*Example:* `+++"SELECT country, COUNT(*) AS `airline_count` FROM `travel-sample`.`inventory`.`airline` AS `a` GROUP BY country"+++` +{blank} +a¦ String + + a¦ *signature* + _optional_ @@ -2992,7 +3275,7 @@ Time spent waiting to be scheduled for CPU time. a¦ String (duration) -a¦ +a¦ [#serv_time] *servTime* + _optional_ a¦ @@ -3082,6 +3365,39 @@ __Type__ : http +// markup not found, no include::{specDir}security/Parameter/security-scheme-before.adoc[opts=optional] + + +[[security-parameter]] += Parameter + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Parameter/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +Specify user names and passwords via the `creds` request parameter. +This is the only method that can provide multiple credentials for a request. +-- + +.API Key +[%hardbreaks] +__Key parameter__ : creds +__Key in__ : query + + +// markup not found, no include::{specDir}security/Parameter/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Parameter/security-scheme-after.adoc[opts=optional] + + + + include::{specDir}security/document-end.adoc[opts=optional] :leveloffset: -1 diff --git a/src/query-service/query-service.gradle b/docs/modules/n1ql-rest-query/query-service.gradle similarity index 79% rename from src/query-service/query-service.gradle rename to docs/modules/n1ql-rest-query/query-service.gradle index 585e8a1c..8b49e6f9 100644 --- a/src/query-service/query-service.gradle +++ b/docs/modules/n1ql-rest-query/query-service.gradle @@ -2,11 +2,11 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/query-service.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/service/service.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-query/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" - gitUserId = "couchbaselabs" + gitRepoId = "query" + gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-query/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-query/partials/paths/", diff --git a/src/query-settings/swagger/query-settings.yaml b/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml similarity index 100% rename from src/query-settings/swagger/query-settings.yaml rename to docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index e28a4277..8e188029 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -8,7 +8,7 @@ include::partial$header-attributes.adoc[opts=optional] [comment] This file is created automatically by OpenAPI Generator. -DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger +DO NOT EDIT! See https://github.com/couchbase/query :leveloffset: 1 @@ -32,7 +32,7 @@ This API enables you to view or specify cluster-level Query settings. [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information @@ -1122,7 +1122,7 @@ Increase this when the completed request keyspace is not big enough to track the Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. -[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config The [node-level][completed-limit] `completed-limit` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1156,7 +1156,7 @@ You must obtain execution plans for such queries via profiling or using the EXPL Refer to [Configure the Completed Requests][sys-completed-config] for more information. -[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config The [node-level][completed-max-plan-size] `completed-max-plan-size` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1191,7 +1191,7 @@ Specify any negative number to track none. Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. -[sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +[sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config The [node-level][completed-threshold] `completed-threshold` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1278,7 +1278,7 @@ In Enterprise Edition, there is no limit to the number of allowed cores.) Refer to [Max Parallelism][max-parallelism] for more information. -[max-parallelism]: /server/8.0/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism +[max-parallelism]: ../n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism The [node-level][max-parallelism-srv] `max-parallelism` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1313,9 +1313,8 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies the maximum amount of memory a request may use on any Query node in the cluster, in MB. -This parameter enforces a ceiling on the memory used for the tracked documents required for -processing a request. It does not take into account any other memory that might be used to -process a request, such as the stack, the operators, or some intermediate values. +This parameter enforces a ceiling on the memory used for the tracked documents required for processing a request. +It does not take into account any other memory that might be used to process a request, such as the stack, the operators, or some intermediate values. Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). @@ -1711,7 +1710,7 @@ a¦ [markdown] -- -The path to which the indexer writes temporary backfill files, to store any transient data during query processing. +The path to which the Index Service writes temporary backfill files, and the Query Service writes spill files, to store any transient data during query processing. The specified path must already exist. Only absolute paths are allowed. @@ -1732,7 +1731,8 @@ a¦ [markdown] -- -The maximum size of temporary backfill files (MB). +In MiB, the maximum size of temporary backfill files for each indexer, and the maximum size of temporary files for spilled sorting and other operations. +In a cluster with both secondary indexing and full text search, the limit for disk space use is three times this setting. Setting the size to `0` disables backfill. Setting the size to `-1` means the size is unlimited. diff --git a/src/query-settings/query-settings.gradle b/docs/modules/n1ql-rest-settings/query-settings.gradle similarity index 79% rename from src/query-settings/query-settings.gradle rename to docs/modules/n1ql-rest-settings/query-settings.gradle index 14e42f8d..7f934c60 100644 --- a/src/query-settings/query-settings.gradle +++ b/docs/modules/n1ql-rest-settings/query-settings.gradle @@ -2,11 +2,11 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("swagger/query-settings.yaml").getAbsolutePath().toString() + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/settings/settings.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-settings/pages" templateDir = "${rootDir}/templates" - gitRepoId = "cb-swagger" - gitUserId = "couchbaselabs" + gitRepoId = "query" + gitUserId = "couchbase" additionalProperties = [ specDir: "${rootDir}/docs/modules/n1ql-rest-settings/partials/", snippetDir: "${rootDir}/docs/modules/n1ql-rest-settings/partials/paths/", diff --git a/src/ns_server/swagger/new_spec.yaml b/docs/modules/ns_server/attachments/new_spec.yaml similarity index 100% rename from src/ns_server/swagger/new_spec.yaml rename to docs/modules/ns_server/attachments/new_spec.yaml diff --git a/src/ns_server/swagger/ns_server.yaml b/docs/modules/ns_server/attachments/ns_server.yaml similarity index 100% rename from src/ns_server/swagger/ns_server.yaml rename to docs/modules/ns_server/attachments/ns_server.yaml diff --git a/docs/modules/ns_server/readme.adoc b/docs/modules/ns_server/readme.adoc new file mode 100644 index 00000000..d1e1d107 --- /dev/null +++ b/docs/modules/ns_server/readme.adoc @@ -0,0 +1,3 @@ += ns_server + +This spec does not yet have an OpenAPI Generator gradle build script. \ No newline at end of file diff --git a/src/view_engine/swagger/view_engine.yaml b/docs/modules/view_engine/attachments/view_engine.yaml similarity index 100% rename from src/view_engine/swagger/view_engine.yaml rename to docs/modules/view_engine/attachments/view_engine.yaml diff --git a/docs/modules/view_engine/readme.adoc b/docs/modules/view_engine/readme.adoc new file mode 100644 index 00000000..6a68590e --- /dev/null +++ b/docs/modules/view_engine/readme.adoc @@ -0,0 +1,3 @@ += view_engine + +This spec does not yet have an OpenAPI Generator gradle build script. \ No newline at end of file diff --git a/docs/preview/HEAD.yml b/docs/preview/HEAD.yml new file mode 100644 index 00000000..c37f530f --- /dev/null +++ b/docs/preview/HEAD.yml @@ -0,0 +1,7 @@ +sources: + docs-server: + branches: release/7.6 + docs-analytics: + branches: release/7.6 + docs-devex: + branches: release/7.6 \ No newline at end of file diff --git a/settings.gradle b/settings.gradle index db32b25d..ac195227 100644 --- a/settings.gradle +++ b/settings.gradle @@ -17,29 +17,29 @@ include 'admin', 'search-stats', 'search-query', 'search-manage' -project(':admin').projectDir = new File (settingsDir, 'src/admin') +project(':admin').projectDir = new File (settingsDir, 'docs/modules/n1ql-rest-admin') project(':admin').buildFileName = 'admin.gradle' -project(':query-settings').projectDir = new File (settingsDir, 'src/query-settings') +project(':query-settings').projectDir = new File (settingsDir, 'docs/modules/n1ql-rest-settings') project(':query-settings').buildFileName = 'query-settings.gradle' -project(':query-service').projectDir = new File (settingsDir, 'src/query-service') +project(':query-service').projectDir = new File (settingsDir, 'docs/modules/n1ql-rest-query') project(':query-service').buildFileName = 'query-service.gradle' -project(':eventing').projectDir = new File (settingsDir, 'src/eventing') +project(':eventing').projectDir = new File (settingsDir, 'docs/modules/eventing-rest-api') project(':eventing').buildFileName = 'eventing.gradle' -project(':functions').projectDir = new File (settingsDir, 'src/functions') +project(':functions').projectDir = new File (settingsDir, 'docs/modules/n1ql-rest-functions') project(':functions').buildFileName = 'functions.gradle' -project(':indexes').projectDir = new File (settingsDir, 'src/indexes') +project(':indexes').projectDir = new File (settingsDir, 'docs/modules/index-rest-stats') project(':indexes').buildFileName = 'indexes.gradle' -project(':analytics-service').projectDir = new File (settingsDir, 'src/analytics-service') +project(':analytics-service').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-service') project(':analytics-service').buildFileName = 'analytics-service.gradle' -project(':analytics-config').projectDir = new File (settingsDir, 'src/analytics-config') +project(':analytics-config').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-config') project(':analytics-config').buildFileName = 'analytics-config.gradle' -project(':analytics-settings').projectDir = new File (settingsDir, 'src/analytics-settings') +project(':analytics-settings').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-settings') project(':analytics-settings').buildFileName = 'analytics-settings.gradle' -project(':analytics-admin').projectDir = new File (settingsDir, 'src/analytics-admin') +project(':analytics-admin').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-admin') project(':analytics-admin').buildFileName = 'analytics-admin.gradle' -project(':analytics-links').projectDir = new File (settingsDir, 'src/analytics-links') +project(':analytics-links').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-links') project(':analytics-links').buildFileName = 'analytics-links.gradle' -project(':analytics-library').projectDir = new File (settingsDir, 'src/analytics-library') +project(':analytics-library').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-library') project(':analytics-library').buildFileName = 'analytics-library.gradle' project(':search-index').projectDir = new File (settingsDir, 'docs/modules/fts-rest-indexing') project(':search-index').buildFileName = 'search-index.gradle' diff --git a/src/ns_server/readme.adoc b/src/ns_server/readme.adoc deleted file mode 100644 index e6c7413b..00000000 --- a/src/ns_server/readme.adoc +++ /dev/null @@ -1,3 +0,0 @@ -= ns_server - -This spec does not yet have a swagger2markup gradle build script. \ No newline at end of file diff --git a/src/view_engine/readme.adoc b/src/view_engine/readme.adoc deleted file mode 100644 index a285372f..00000000 --- a/src/view_engine/readme.adoc +++ /dev/null @@ -1,3 +0,0 @@ -= view_engine - -This spec does not yet have a swagger2markup gradle build script. \ No newline at end of file From 7f84c9454f30ebc0d1ba36b0b019142171d75481 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Thu, 28 Aug 2025 12:43:36 +0100 Subject: [PATCH 16/25] DOC-13306: Add documentation for indexer level scan timeout (#177) * DOC-5669: Add indexer settings REST API * Add index batch size for rebalance * Add the default for `defer_build` * Default timeout for indexer * Update settings * Has examples and defaults * Add description * Add example titles * Update storage mode as a composite schema * Driveby: fix default preview config * Driveby: Update composed schema templates * Driveby: Add descriptions to REST API specs for composite schemas * Driveby: update overlay for Eventing REST API * Driveby: Include description for composite schemas * Driveby: fix maximum and minimum exclusives * Build output documentation --------- Co-authored-by: tech-comm-team-couchbase --- build.gradle | 1 + .../attachments/analytics-links.yaml | 6 +- .../analytics-rest-links/pages/index.adoc | 178 +- .../attachments/analytics-service.yaml | 4 + .../analytics-rest-service/pages/index.adoc | 88 +- .../{overlay.json => _overlay.json} | 6 + .../modules/eventing-rest-api/eventing.gradle | 2 +- .../eventing-rest-api/pages/index.adoc | 76 +- docs/modules/fts-rest-stats/pages/index.adoc | 34 +- .../attachments/index-settings.yaml | 722 ++++++ .../examples/get_settings.json | 84 + .../index-rest-settings/index-settings.gradle | 23 + .../index-rest-settings/pages/index.adoc | 2169 +++++++++++++++++ .../partials/header-attributes.adoc | 5 + .../partials/overview/document-before.adoc | 57 + .../partials/overview/document-end.adoc | 8 + .../paths/get_settings/http-request.adoc | 12 + .../paths/get_settings/http-response.adoc | 9 + .../paths/post_settings/http-request.adoc | 46 + .../partials/security/document-begin.adoc | 2 + .../partials/security/document-end.adoc | 1 + .../index-rest-stats/attachments/indexes.yaml | 3 + .../modules/index-rest-stats/pages/index.adoc | 83 +- .../n1ql-rest-settings/pages/index.adoc | 3 +- docs/preview/HEAD.yml | 6 +- settings.gradle | 3 + templates/models.mustache | 51 +- templates/param.mustache | 12 +- templates/property.mustache | 12 +- 29 files changed, 3639 insertions(+), 67 deletions(-) rename docs/modules/eventing-rest-api/attachments/{overlay.json => _overlay.json} (91%) create mode 100644 docs/modules/index-rest-settings/attachments/index-settings.yaml create mode 100644 docs/modules/index-rest-settings/examples/get_settings.json create mode 100644 docs/modules/index-rest-settings/index-settings.gradle create mode 100644 docs/modules/index-rest-settings/pages/index.adoc create mode 100644 docs/modules/index-rest-settings/partials/header-attributes.adoc create mode 100644 docs/modules/index-rest-settings/partials/overview/document-before.adoc create mode 100644 docs/modules/index-rest-settings/partials/overview/document-end.adoc create mode 100644 docs/modules/index-rest-settings/partials/paths/get_settings/http-request.adoc create mode 100644 docs/modules/index-rest-settings/partials/paths/get_settings/http-response.adoc create mode 100644 docs/modules/index-rest-settings/partials/paths/post_settings/http-request.adoc create mode 100644 docs/modules/index-rest-settings/partials/security/document-begin.adoc create mode 100644 docs/modules/index-rest-settings/partials/security/document-end.adoc diff --git a/build.gradle b/build.gradle index c90f536b..6dbaeb88 100644 --- a/build.gradle +++ b/build.gradle @@ -29,6 +29,7 @@ defaultTasks 'admin:openApiGenerate', 'eventing:openApiGenerate', 'functions:openApiGenerate', 'indexes:openApiGenerate', + 'index-settings:openApiGenerate', 'search-index:openApiGenerate', 'search-nodes:openApiGenerate', 'search-advanced:openApiGenerate', diff --git a/docs/modules/analytics-rest-links/attachments/analytics-links.yaml b/docs/modules/analytics-rest-links/attachments/analytics-links.yaml index 9e601a1c..e12bf1ee 100644 --- a/docs/modules/analytics-rest-links/attachments/analytics-links.yaml +++ b/docs/modules/analytics-rest-links/attachments/analytics-links.yaml @@ -826,7 +826,7 @@ components: ResponseAll: title: Links - description: These properties are common to all links. + description: Properties common to all links. type: object discriminator: propertyName: type @@ -879,6 +879,7 @@ components: ResponseCouchbaseSpecific: title: Couchbase Specific Response + description: Properties specific to remote Couchbase links. type: object required: - activeHostname @@ -1051,6 +1052,7 @@ components: ResponseS3Specific: title: S3 Specific Response + description: Properties specific to S3 links. type: object required: - accessKeyId @@ -1101,6 +1103,7 @@ components: ResponseAzureBlobSpecific: title: Azure Blob Specific Response + description: Properties specific to Azure Blob links. type: object required: - endpoint @@ -1205,6 +1208,7 @@ components: ResponseGCSSpecific: title: GCS Specific Response + description: Properties specific to Google Cloud Storage links. type: object required: - applicationDefaultCredentials diff --git a/docs/modules/analytics-rest-links/pages/index.adoc b/docs/modules/analytics-rest-links/pages/index.adoc index 633d7286..17152706 100644 --- a/docs/modules/analytics-rest-links/pages/index.adoc +++ b/docs/modules/analytics-rest-links/pages/index.adoc @@ -4079,7 +4079,7 @@ endif::collapse-models[] ifdef::model-descriptions[] //tag::desc-ResponseAll[] -These properties are common to all links. +Properties common to all links. //end::desc-ResponseAll[] endif::model-descriptions[] @@ -4199,15 +4199,48 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::ResponseAzureBlob[] -* xref:ResponseAll[] +ifdef::model-descriptions[] +//tag::desc-ResponseAzureBlob[] +These properties are returned for Azure Blob links. +//end::desc-ResponseAzureBlob[] +endif::model-descriptions[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ -* xref:ResponseAzureBlobSpecific[] +[markdown] +-- +include::index.adoc[tag=desc-ResponseAll, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:ResponseAll[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ResponseAzureBlobSpecific, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:ResponseAzureBlobSpecific[] + + +|=== + +//end::ResponseAzureBlob[] + // markup not found, no include::{specDir}definitions/ResponseAzureBlob/definition-end.adoc[opts=optional] @@ -4238,6 +4271,11 @@ endif::collapse-models[] //tag::ResponseAzureBlobSpecific[] +ifdef::model-descriptions[] +//tag::desc-ResponseAzureBlobSpecific[] +Properties specific to Azure Blob links. +//end::desc-ResponseAzureBlobSpecific[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -4446,15 +4484,48 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::ResponseCouchbase[] -* xref:ResponseAll[] +ifdef::model-descriptions[] +//tag::desc-ResponseCouchbase[] +These properties are returned for remote Couchbase links. +//end::desc-ResponseCouchbase[] +endif::model-descriptions[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ -* xref:ResponseCouchbaseSpecific[] +[markdown] +-- +include::index.adoc[tag=desc-ResponseAll, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:ResponseAll[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ResponseCouchbaseSpecific, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:ResponseCouchbaseSpecific[] + + +|=== + +//end::ResponseCouchbase[] + // markup not found, no include::{specDir}definitions/ResponseCouchbase/definition-end.adoc[opts=optional] @@ -4485,6 +4556,11 @@ endif::collapse-models[] //tag::ResponseCouchbaseSpecific[] +ifdef::model-descriptions[] +//tag::desc-ResponseCouchbaseSpecific[] +Properties specific to remote Couchbase links. +//end::desc-ResponseCouchbaseSpecific[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -4952,15 +5028,48 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::ResponseGCS[] -* xref:ResponseAll[] +ifdef::model-descriptions[] +//tag::desc-ResponseGCS[] +These properties are returned for Google Cloud Storage links. +//end::desc-ResponseGCS[] +endif::model-descriptions[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ -* xref:ResponseGCSSpecific[] +[markdown] +-- +include::index.adoc[tag=desc-ResponseAll, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:ResponseAll[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ResponseGCSSpecific, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:ResponseGCSSpecific[] + + +|=== + +//end::ResponseGCS[] + // markup not found, no include::{specDir}definitions/ResponseGCS/definition-end.adoc[opts=optional] @@ -4991,6 +5100,11 @@ endif::collapse-models[] //tag::ResponseGCSSpecific[] +ifdef::model-descriptions[] +//tag::desc-ResponseGCSSpecific[] +Properties specific to Google Cloud Storage links. +//end::desc-ResponseGCSSpecific[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -5082,15 +5196,48 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::ResponseS3[] -* xref:ResponseAll[] +ifdef::model-descriptions[] +//tag::desc-ResponseS3[] +These properties are returned for S3 links. +//end::desc-ResponseS3[] +endif::model-descriptions[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ -* xref:ResponseS3Specific[] +[markdown] +-- +include::index.adoc[tag=desc-ResponseAll, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:ResponseAll[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ResponseS3Specific, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:ResponseS3Specific[] + + +|=== + +//end::ResponseS3[] + // markup not found, no include::{specDir}definitions/ResponseS3/definition-end.adoc[opts=optional] @@ -5121,6 +5268,11 @@ endif::collapse-models[] //tag::ResponseS3Specific[] +ifdef::model-descriptions[] +//tag::desc-ResponseS3Specific[] +Properties specific to S3 links. +//end::desc-ResponseS3Specific[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== diff --git a/docs/modules/analytics-rest-service/attachments/analytics-service.yaml b/docs/modules/analytics-rest-service/attachments/analytics-service.yaml index 1ea30df8..622e9006 100644 --- a/docs/modules/analytics-rest-service/attachments/analytics-service.yaml +++ b/docs/modules/analytics-rest-service/attachments/analytics-service.yaml @@ -132,6 +132,7 @@ components: # Use YAML anchors for properties which are also available as query parameters ParametersCommon: title: Common Parameters + description: Parameters common with the Query Service. type: object required: - statement @@ -210,6 +211,7 @@ components: # Use YAML anchors for properties which are also available as query parameters ParametersLocal: title: Analytics Parameters + description: Parameters specific to the Analytics Service. type: object properties: plan-format: @@ -263,6 +265,7 @@ components: # For the Query Responses page ResponsesCommon: title: Common Responses + description: Responses common with the Query Service. type: object properties: requestID: @@ -328,6 +331,7 @@ components: # For the Query Responses page ResponsesLocal: title: Analytics Responses + description: Responses specific to the Analytics Service. type: object properties: plans: diff --git a/docs/modules/analytics-rest-service/pages/index.adoc b/docs/modules/analytics-rest-service/pages/index.adoc index 53951952..439d8ec4 100644 --- a/docs/modules/analytics-rest-service/pages/index.adoc +++ b/docs/modules/analytics-rest-service/pages/index.adoc @@ -1026,15 +1026,43 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::Parameters[] -* xref:ParametersCommon[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema -* xref:ParametersLocal[] +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ParametersCommon, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:ParametersCommon[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ParametersLocal, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:ParametersLocal[] + + +|=== + +//end::Parameters[] + // markup not found, no include::{specDir}definitions/Parameters/definition-end.adoc[opts=optional] @@ -1065,6 +1093,11 @@ endif::collapse-models[] //tag::ParametersCommon[] +ifdef::model-descriptions[] +//tag::desc-ParametersCommon[] +Parameters common with the Query Service. +//end::desc-ParametersCommon[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -1289,6 +1322,11 @@ endif::collapse-models[] //tag::ParametersLocal[] +ifdef::model-descriptions[] +//tag::desc-ParametersLocal[] +Parameters specific to the Analytics Service. +//end::desc-ParametersLocal[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -1441,15 +1479,43 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::Responses[] -* xref:ResponsesCommon[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema -* xref:ResponsesLocal[] +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ResponsesCommon, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:ResponsesCommon[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-ResponsesLocal, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:ResponsesLocal[] + + +|=== + +//end::Responses[] + // markup not found, no include::{specDir}definitions/Responses/definition-end.adoc[opts=optional] @@ -1480,6 +1546,11 @@ endif::collapse-models[] //tag::ResponsesCommon[] +ifdef::model-descriptions[] +//tag::desc-ResponsesCommon[] +Responses common with the Query Service. +//end::desc-ResponsesCommon[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -1945,6 +2016,11 @@ endif::collapse-models[] //tag::ResponsesLocal[] +ifdef::model-descriptions[] +//tag::desc-ResponsesLocal[] +Responses specific to the Analytics Service. +//end::desc-ResponsesLocal[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== diff --git a/docs/modules/eventing-rest-api/attachments/overlay.json b/docs/modules/eventing-rest-api/attachments/_overlay.json similarity index 91% rename from docs/modules/eventing-rest-api/attachments/overlay.json rename to docs/modules/eventing-rest-api/attachments/_overlay.json index 0882e766..9075e57d 100644 --- a/docs/modules/eventing-rest-api/attachments/overlay.json +++ b/docs/modules/eventing-rest-api/attachments/_overlay.json @@ -5,6 +5,12 @@ "version": 1.0 }, "actions": [ + { + "target": "components.schemas.handler_schema", + "update": { + "description": "An object which defines a function." + } + }, { "target": "components.schemas.settings_schema.properties.allow_sync_documents", "update": { diff --git a/docs/modules/eventing-rest-api/eventing.gradle b/docs/modules/eventing-rest-api/eventing.gradle index f20450b1..1fd57e73 100644 --- a/docs/modules/eventing-rest-api/eventing.gradle +++ b/docs/modules/eventing-rest-api/eventing.gradle @@ -4,7 +4,7 @@ plugins { jayOverlay { targetFile.set("${projectDir}/build/bundle/eventing.yaml") - overlayFile.set("${projectDir}/attachments/overlay.json") + overlayFile.set("${projectDir}/attachments/_overlay.json") outputDir.set("${projectDir}/build/overlay") } diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index e400f11d..4ae39ef0 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -7003,14 +7003,44 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -One of the following: +//tag::AddFunction[] -* xref:handler_schema[] +[cols="25,55,20",separator=¦] +|=== +¦ One{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-handler_schema, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:handler_schema[] -* xref:handler_schema[] + +a¦ _or_ +a¦ + +[markdown] +-- +An array containing a single function definition object. +-- + +[%hardbreaks] +*Minimum items:* `1` +*Maximum items:* `1` +{blank} +a¦ xref:handler_schema[] array +|=== + +//end::AddFunction[] // markup not found, no include::{specDir}definitions/AddFunction/definition-end.adoc[opts=optional] @@ -7040,14 +7070,43 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -One of the following: +//tag::AddFunctions[] + + +[cols="25,55,20",separator=¦] +|=== +¦ One{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-handler_schema, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:handler_schema[] + -* xref:handler_schema[] +a¦ _or_ +a¦ +[markdown] +-- +An array containing one or more function definition objects. +-- -* xref:handler_schema[] +[%hardbreaks] +*Minimum items:* `1` +{blank} +a¦ xref:handler_schema[] array +|=== + +//end::AddFunctions[] // markup not found, no include::{specDir}definitions/AddFunctions/definition-end.adoc[opts=optional] @@ -7622,6 +7681,11 @@ endif::collapse-models[] //tag::handler_schema[] +ifdef::model-descriptions[] +//tag::desc-handler_schema[] +An object which defines a function. +//end::desc-handler_schema[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== diff --git a/docs/modules/fts-rest-stats/pages/index.adoc b/docs/modules/fts-rest-stats/pages/index.adoc index de3c867d..726e6433 100644 --- a/docs/modules/fts-rest-stats/pages/index.adoc +++ b/docs/modules/fts-rest-stats/pages/index.adoc @@ -563,14 +563,42 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::allStats[] -* xref:clusterStats[] +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-clusterStats, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:clusterStats[] -* xref:indexStats[] +a¦ _and_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-indexStats, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:indexStats[] + + +|=== +//end::allStats[] // markup not found, no include::{specDir}definitions/allStats/definition-end.adoc[opts=optional] diff --git a/docs/modules/index-rest-settings/attachments/index-settings.yaml b/docs/modules/index-rest-settings/attachments/index-settings.yaml new file mode 100644 index 00000000..ea66cfa0 --- /dev/null +++ b/docs/modules/index-rest-settings/attachments/index-settings.yaml @@ -0,0 +1,722 @@ +openapi: 3.0.3 +info: + title: Index Settings REST API + version: '8.0' + description: |- + The Index Settings REST API is provided by the Index Service. + This API enables you to retrieve or set Index Service settings. + + Changes automatically propagate to all Index Service nodes, and will be remembered across node and cluster restarts. + + Unless otherwise noted, you should only change the Index Service settings when advised to do so by Couchbase Support. + +servers: + - url: '{scheme}://{host}:{port}' + description: The URL scheme, host, and port are as follows. + variables: + scheme: + default: http + description: |- + The URL scheme. + Use `https` for secure access. + enum: + - http + - https + host: + default: localhost + description: The host name or IP address of a node running the Index Service. + port: + default: "9102" + description: |- + The Index Service REST port. + Use `19102` for secure access. + enum: + - "9102" + - "19102" + +paths: + /settings: + get: + operationId: get_settings + summary: Retrieve Index Settings + description: Returns Index Service settings. + security: + - Default: [] + responses: + "200": + description: |- + Success. + Returns an object giving Index Service settings. + content: + application/json: + schema: + $ref: "#/components/schemas/Settings" + example: + $ref: "../examples/get_settings.json" + "404": + $ref: '#/components/responses/NotFound' + "401": + $ref: '#/components/responses/Unauthorized' + post: + operationId: post_settings + summary: Update Index Settings + description: Updates Index Service settings. + security: + - Default: [] + requestBody: + required: true + description: |- + An object specifying Index Service settings. + You only need to specify the settings you want to change; settings which are not specified are left unchanged. + content: + application/json: + schema: + $ref: "#/components/schemas/Settings" + responses: + "200": + description: |- + Success. + Returns `OK` and no object. + "401": + $ref: '#/components/responses/Unauthorized' + "404": + $ref: '#/components/responses/NotFound' + +components: + schemas: + Settings: + type: object + properties: + indexer.rebalance.transferBatchSize: + type: integer + format: int32 + x-has-default: true + default: 3 + x-has-example: true + example: 7 + writeOnly: true + description: |- + Sets the batch size Couchbase Server uses when rebuilding index files during rebalance. + This setting has no effect on file-based rebalance. + + Couchbase Server breaks the rebuilding of indexes during a rebalance into batches to limit the performance impact. + This setting controls the maximum number of indexes that a rebalance rebuilds concurrently. + You must have the Full Admin or the Cluster Admin role to set this value. + + For an overview of rebalance as it affects the Index Service, including an overview of smart batching, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service). + indexer.settings.allow_large_keys: + type: boolean + x-has-default: true + default: true + description: |- + Whether the size of index keys is unlimited. + + * If true, index keys may have unlimited size. + * If false, the maximum size for index keys and array index keys is specified by `indexer.settings.max_seckey_size` and `indexer.settings.max_array_seckey_size`. + + In Couchbase Server 6.5 and later, the Index Service does not need to restart when you update this setting. + indexer.settings.bufferPoolBlockSize: + type: integer + format: int32 + x-has-default: true + default: 16384 + description: Buffer pool block size. + indexer.settings.build.batch_size: + type: integer + format: int32 + x-has-default: true + default: 5 + description: Build batch size. + indexer.settings.compaction.abort_exceed_interval: + type: boolean + x-has-default: true + default: false + description: Whether to abort index compaction if it is still running after the end of the index compaction interval. + indexer.settings.compaction.check_period: + type: integer + format: int32 + x-has-default: true + default: 30 + description: An interval, specifying how frequently the Index Service checks whether the compaction threshold has been reached (seconds). + indexer.settings.compaction.compaction_mode: + type: string + x-has-default: true + default: circular + description: The compaction mode for indexes. + enum: + - standard + - circular + indexer.settings.compaction.days_of_week: + type: string + x-has-example: true + example: Saturday,Sunday + x-has-default: true + default: Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday + description: |- + The days of the week on which circular compaction is to run, if specified. + Individual values must be day-names, each specified with an initial capital, and otherwise lower-case. + Multiple values must be separated by a single comma, with no spaces. + indexer.settings.compaction.interval: + type: string + x-has-example: true + example: 01:00,05:59 + x-has-default: true + default: 00:00,00:00 + description: |- + A string in the form `fromHour:fromMinute,toHour:toMinute`, specifying the interval during which index compaction can run. + + * `fromHour` — + An integer between 0 and 23 inclusive, specifying the starting hour of the interval. + * `fromMinute` — + An integer between 0 and 59 inclusive, specifying the starting minute of the interval, within the specified starting hour. + * `toHour` — + An integer between 0 and 23 inclusive, specifying the concluding hour of the interval. + * `toMinute` — + An integer between 0 and 59 inclusive, specifying the concluding minute of the interval, within the specified concluding hour. + + The default value means any time. + indexer.settings.compaction.min_frag: + type: integer + format: int32 + x-has-default: true + default: 30 + minimum: 5 + description: The minimum fragmentation threshold to trigger compaction (percentage). + indexer.settings.compaction.min_size: + type: integer + format: int32 + x-has-default: true + default: 524288000 + description: Compaction minimum file size. + indexer.settings.compaction.plasma.manual: + type: boolean + x-has-default: true + default: false + description: For standard indexes using Plasma, whether compaction should be triggered manually. + indexer.settings.compaction.plasma.optional.decrement: + type: integer + format: int32 + x-has-default: true + default: 5 + description: For standard indexes using Plasma, the optional decrement. + indexer.settings.compaction.plasma.optional.min_frag: + type: integer + format: int32 + x-has-default: true + default: 20 + description: For standard indexes using Plasma, the minimum fragmentation threshold to trigger compaction (percentage). + indexer.settings.compaction.plasma.optional.quota: + type: integer + format: int32 + x-has-default: true + default: 25 + description: For standard indexes using Plasma, the optional quota. + indexer.settings.corrupt_index_num_backups: + type: integer + format: int32 + x-has-default: true + default: 1 + description: Corrupt index number of backups. + indexer.settings.cpuProfDir: + type: string + description: The name of the directory where local CPU usage profiling information is captured. + indexer.settings.cpuProfile: + type: boolean + x-has-default: true + default: false + description: Whether the Index Service should capture local CPU usage profiling information. + indexer.settings.defer_build: + type: boolean + x-has-default: true + default: false + description: |- + The default setting for the `defer_build` option for index creation. + + * If this setting is true, and you create an index without specifying `defer_build`, the index is not built immediately. + * If this setting false, and you create an index without specifying `defer_build`, the index is built immediately. + + You can override this setting by specifying the `defer_build` option when you create an index. + indexer.settings.eTagPeriod: + type: integer + format: int32 + x-has-default: true + default: 240 + description: The ETag (entity tag) period. + indexer.settings.enable_corrupt_index_backup: + type: boolean + x-has-default: true + default: false + description: Whether corrupt index backup is enabled. + indexer.settings.enable_page_bloom_filter: + type: boolean + x-has-default: true + default: true + description: |- + Whether Bloom filters are enabled for memory management. + + For details, see [Per Page Bloom Filters](/server/8.0/learn/services-and-indexes/indexes/storage-modes.html#per-page-bloom-filters). + indexer.settings.enable_shard_affinity: + type: boolean + x-has-default: true + default: false + description: |- + Selects the index rebalance method. + See [Index Rebalance Methods](/server/8.0/learn/clusters-and-availability/rebalance.html#index-rebalance-methods). + + * If false (the default), Index Service nodes rebuild indexes that are newly assigned to them during a rebalance. + + * If true, Couchbase Server moves a reassigned index's files between Index Service nodes. + + If set to true, when you create an index, you can use the `WITH` clause to specify which node should contain the index. + However, when you alter an index, you cannot use the `WITH` clause to specify which node should contain the index. + indexer.settings.fast_flush_mode: + type: boolean + x-has-default: true + default: true + description: Whether fast flush mode is enabled. + indexer.settings.gc_percent: + type: integer + format: int32 + x-has-default: true + default: 100 + description: Garbage collection percentage. + indexer.settings.inmemory_snapshot.fdb.interval: + type: integer + format: int32 + x-has-default: true + default: 200 + minimum: 1 + exclusiveMinimum: true + description: |- + For standard indexes using ForestDB, the in-memory snapshotting interval (ms). + This determines the earliest possibility of a scan seeing a given KV mutation. + indexer.settings.inmemory_snapshot.interval: + type: integer + format: int32 + x-has-default: true + default: 200 + minimum: 1 + exclusiveMinimum: true + description: |- + The in-memory snapshotting interval (ms). + This determines the earliest possibility of a scan seeing a given KV mutation. + indexer.settings.inmemory_snapshot.moi.interval: + type: integer + format: int32 + minimum: 1 + exclusiveMinimum: true + x-has-default: true + default: 10 + description: |- + For memory-optimized indexes, the in-memory snapshotting interval (ms). + This determines the earliest possibility of a scan seeing a given KV mutation. + indexer.settings.largeSnapshotThreshold: + type: integer + format: int32 + x-has-default: true + default: 200 + description: The large snapshot threshold. + indexer.settings.log_level: + type: string + x-has-default: true + default: info + description: Indexer logging level. + enum: + - silent + - fatal + - error + - warn + - info + - verbose + - timing + - debug + - trace + indexer.settings.maxNumPartitions: + type: integer + format: int32 + x-has-default: true + default: 64 + description: Maximum number of partitions. + indexer.settings.maxVbQueueLength: + type: integer + format: int32 + x-has-default: true + default: 0 + description: Maximum vBucket queue length. + indexer.settings.max_array_seckey_size: + type: integer + format: int32 + x-has-default: true + default: 10240 + description: |- + If `indexer.settings.allow_large_keys` is false, this setting specifies the maximum size for array index keys. + + In Couchbase Server 6.5 and later, the Index Service does not need to restart when you update this setting. + indexer.settings.max_cpu_percent: + type: integer + format: int32 + x-has-default: true + default: 0 + description: |- + The CPU capacity that the Index Service should use (percentage). + If set to `0`, the indexer will use all CPUs. + indexer.settings.max_seckey_size: + type: integer + format: int32 + x-has-default: true + default: 4608 + description: |- + If `indexer.settings.allow_large_keys` is false, this setting specifies the maximum size for index keys. + + In Couchbase Server 6.5 and later, the Index Service does not need to restart when you update this setting. + indexer.settings.max_writer_lock_prob: + type: integer + format: int32 + x-has-default: true + default: 20 + description: Maximum writer lock prob. + indexer.settings.memProfDir: + type: string + description: The name of the directory where local memory usage profiling information is captured. + indexer.settings.memProfile: + type: boolean + x-has-default: true + default: false + description: Whether the Index Service should capture local memory usage profiling information. + indexer.settings.memory_quota: + type: integer + format: int32 + x-has-default: true + default: 536870912 + description: How much RAM is allocated to the Index Service for the current node. + indexer.settings.minVbQueueLength: + type: integer + format: int32 + x-has-default: true + default: 30 + description: Minimum vBucket queue length. + indexer.settings.moi.debug: + type: boolean + x-has-default: true + default: false + description: Debug memory-optimized index storage. + indexer.settings.moi.persistence_threads: + type: integer + format: int32 + x-has-default: true + default: 4 + description: For memory-optimized index storage, the number of persistence threads. + indexer.settings.moi.recovery.max_rollbacks: + type: integer + format: int32 + x-has-default: true + default: 2 + description: For memory-optimized index storage, the maximum number of committed rollback points. + indexer.settings.moi.recovery_threads: + type: integer + format: int32 + x-has-default: true + default: 8 + description: For memory-optimized index storage, the number of recovery threads. + indexer.settings.num_replica: + type: integer + format: int32 + x-has-default: true + default: 0 + x-has-example: true + example: 2 + description: The default number of index replicas to be created by the Index Service whenever `CREATE INDEX` is invoked. + indexer.settings.percentage_memory_quota: + type: integer + format: int32 + x-has-default: true + default: 0 + description: Percentage memory quota. + indexer.settings.persisted_snapshot.fdb.interval: + type: integer + format: int32 + x-has-default: true + default: 5000 + minimum: 100 + description: |- + For standard indexes using ForestDB, the persisted snapshotting interval (ms). + This must be a multiple of the in-memory snapshot interval. + indexer.settings.persisted_snapshot.interval: + type: integer + format: int32 + x-has-default: true + default: 5000 + minimum: 100 + description: |- + The persisted snapshotting interval (ms). + This must be a multiple of the in-memory snapshot interval. + indexer.settings.persisted_snapshot.moi.interval: + type: integer + format: int32 + x-has-default: true + default: 600000 + minimum: 100 + description: |- + For memory-optimized indexes, the persisted snapshotting interval (ms). + This must be a multiple of the in-memory snapshot interval. + indexer.settings.persisted_snapshot_init_build.fdb.interval: + type: integer + format: int32 + x-has-default: true + default: 5000 + description: For standard indexes using ForestDB, the persisted snapshotting interval for the initial build (ms). + indexer.settings.persisted_snapshot_init_build.interval: + type: integer + format: int32 + x-has-default: true + default: 5000 + description: The persisted snapshotting interval for the initial build (ms). + indexer.settings.persisted_snapshot_init_build.moi.interval: + type: integer + format: int32 + x-has-default: true + default: 600000 + description: For memory-optimized indexes, the persisted snapshotting interval for the initial build (ms). + indexer.settings.plasma.recovery.max_rollbacks: + type: integer + format: int32 + x-has-default: true + default: 2 + description: For standard indexes using Plasma, the maximum number of committed rollback points. + indexer.settings.rebalance.blob_storage_bucket: + type: string + x-has-default: true + default: "" + description: Rebalance blob storage bucket. + indexer.settings.rebalance.blob_storage_prefix: + type: string + x-has-default: true + default: "" + description: Rebalance blob storage prefix. + indexer.settings.rebalance.blob_storage_region: + type: string + x-has-default: true + default: "" + description: Rebalance blob storage region. + indexer.settings.rebalance.blob_storage_scheme: + type: string + x-has-default: true + default: "" + description: Rebalance blob storage scheme. + indexer.settings.rebalance.redistribute_indexes: + type: boolean + x-has-default: true + default: false + description: |- + Whether to redistribute indexes on rebalance. + + * When true, Couchbase Server redistributes indexes when rebalance occurs, in order to optimize performance. + + * When false (the default), such redistribution does not occur. + + For details, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service). + indexer.settings.recovery.max_rollbacks: + type: integer + format: int32 + x-has-default: true + default: 2 + description: The maximum number of committed rollback points. + indexer.settings.scan_getseqnos_retries: + type: integer + format: int32 + x-has-default: true + default: 30 + description: Scan get sequence numbers retries. + indexer.settings.scan_timeout: + type: integer + format: int32 + x-has-default: true + default: 120000 + description: |- + The default timeout for the indexer, in milliseconds. + This is distinct from the Query Service timeout. + The Index Service has its own timeout because index scans consume resources such as memory and CPU while holding snapshots and performing range scan. + + An index scan may time out if the Index Service timeout is lower than the Query Service timeout. + indexer.settings.send_buffer_size: + type: integer + format: int32 + x-has-default: true + default: 1024 + description: Send buffer size. + indexer.settings.serverless.indexLimit: + type: integer + format: int32 + x-has-default: true + default: 201 + description: Serverless index limit. + indexer.settings.sliceBufSize: + type: integer + format: int32 + x-has-default: true + default: 1600 + description: Slice buffer size. + indexer.settings.smallSnapshotThreshold: + type: integer + format: int32 + x-has-default: true + default: 30 + description: Small snapshot threshold. + indexer.settings.snapshotListeners: + type: integer + format: int32 + x-has-default: true + default: 4 + description: Snapshot listeners. + indexer.settings.snapshotRequestWorkers: + type: integer + format: int32 + x-has-default: true + default: 4 + description: Snapshot request workers. + indexer.settings.statsLogDumpInterval: + type: integer + format: int32 + x-has-default: true + default: 60 + description: Statistics log dump interval. + indexer.settings.storage_mode: + $ref: "#/components/schemas/SettingsStorageMode" + indexer.settings.storage_mode.disable_upgrade: + type: boolean + x-has-default: true + default: false + description: Whether upgrade of the index storage mode is disabled. + indexer.settings.thresholds.mem_high: + type: integer + format: int32 + x-has-default: true + default: 70 + description: High memory threshold. + indexer.settings.thresholds.mem_low: + type: integer + format: int32 + x-has-default: true + default: 50 + description: Low memory threshold. + indexer.settings.thresholds.units_high: + type: integer + format: int32 + x-has-default: true + default: 60 + description: High units threshold. + indexer.settings.thresholds.units_low: + type: integer + format: int32 + x-has-default: true + default: 40 + description: Low units threshold. + indexer.settings.units_quota: + type: integer + format: int32 + x-has-default: true + default: 10000 + description: Units quota. + indexer.settings.wal_size: + type: integer + format: int32 + x-has-default: true + default: 4096 + description: Write-ahead log size. + projector.settings.log_level: + type: string + x-has-default: true + default: info + description: Projector logging level. + queryport.client.settings.backfillLimit: + type: integer + format: int32 + x-has-default: true + default: 5120 + description: |- + The maximum size of the backfill file (MB). + + * A value of `0` disables backfill. + * A value of `-1` means the size is unlimited. + + The maximum size is limited only by the available disk space. + queryport.client.settings.closeActiveConnections: + type: boolean + x-has-default: true + default: true + description: Whether to close active connections. + queryport.client.settings.minPoolSizeWM: + type: integer + format: int32 + x-has-default: true + default: 1000 + description: Minimum pool size. + queryport.client.settings.poolOverflow: + type: integer + format: int32 + x-has-default: true + default: 30 + description: Maximum number of connections in a pool. + queryport.client.settings.poolSize: + type: integer + format: int32 + x-has-default: true + default: 5000 + description: Number of simultaneous active connections in a pool. + queryport.client.settings.relConnBatchSize: + type: integer + format: int32 + x-has-default: true + default: 100 + description: Connection batch size. + SettingsStorageMode: + title: Storage Mode + description: The storage mode to be used for the Index Service on this node. + oneOf: + - $ref: "#/components/schemas/SettingsStorageModeEE" + - $ref: "#/components/schemas/SettingsStorageModeCE" + SettingsStorageModeEE: + title: Enterprise Edition + type: string + default: plasma + x-desc-edition: "{enterprise}" + description: |- + If you are using Enterprise Edition, the possible values are: + + * `plasma` (the default) — + Sets the index storage mode to use the Plasma storage engine, which can utilize both memory and persistent storage for index maintenance and index scans. + + * `memory_optimized` — + Sets the index storage mode to use memory optimized global secondary indexes, which can perform index maintenance and index scan faster at in-memory speeds. + + This setting can only be changed while there are no index nodes in the cluster. + To change from standard GSI to memory optimized GSI or vice versa, you need to remove all the Index Service nodes in the cluster. + enum: + - plasma + - memory_optimized + SettingsStorageModeCE: + title: Community Edition + type: string + default: forestdb + x-desc-edition: "{community}" + description: |- + If you are using Community Edition, the default (and only) value is `forestdb`. + enum: + - forestdb + + responses: + NotFound: + description: |- + Not found. + The URL may be specified incorrectly. + Unauthorized: + description: |- + Unauthorized. + Failure to authenticate. + + securitySchemes: + Default: + type: http + scheme: basic + description: |- + Users must have the Full Admin or Cluster Admin role, with Cluster Read and Bucket INDEX List privileges. diff --git a/docs/modules/index-rest-settings/examples/get_settings.json b/docs/modules/index-rest-settings/examples/get_settings.json new file mode 100644 index 00000000..0ddb0911 --- /dev/null +++ b/docs/modules/index-rest-settings/examples/get_settings.json @@ -0,0 +1,84 @@ +{ + "indexer.settings.allow_large_keys": true, + "indexer.settings.bufferPoolBlockSize": 16384, + "indexer.settings.build.batch_size": 5, + "indexer.settings.compaction.abort_exceed_interval": false, + "indexer.settings.compaction.check_period": 30, + "indexer.settings.compaction.compaction_mode": "circular", + "indexer.settings.compaction.days_of_week": "Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday", + "indexer.settings.compaction.interval": "00:00,00:00", + "indexer.settings.compaction.min_frag": 30, + "indexer.settings.compaction.min_size": 524288000, + "indexer.settings.compaction.plasma.manual": false, + "indexer.settings.compaction.plasma.optional.decrement": 5, + "indexer.settings.compaction.plasma.optional.min_frag": 20, + "indexer.settings.compaction.plasma.optional.quota": 25, + "indexer.settings.corrupt_index_num_backups": 1, + "indexer.settings.cpuProfDir": "", + "indexer.settings.cpuProfile": false, + "indexer.settings.defer_build": false, + "indexer.settings.eTagPeriod": 240, + "indexer.settings.enable_corrupt_index_backup": false, + "indexer.settings.enable_page_bloom_filter": true, + "indexer.settings.enable_shard_affinity": false, + "indexer.settings.fast_flush_mode": true, + "indexer.settings.gc_percent": 100, + "indexer.settings.inmemory_snapshot.fdb.interval": 200, + "indexer.settings.inmemory_snapshot.interval": 200, + "indexer.settings.inmemory_snapshot.moi.interval": 10, + "indexer.settings.largeSnapshotThreshold": 200, + "indexer.settings.log_level": "info", + "indexer.settings.maxNumPartitions": 64, + "indexer.settings.maxVbQueueLength": 0, + "indexer.settings.max_array_seckey_size": 10240, + "indexer.settings.max_cpu_percent": 0, + "indexer.settings.max_seckey_size": 4608, + "indexer.settings.max_writer_lock_prob": 20, + "indexer.settings.memProfDir": "", + "indexer.settings.memProfile": false, + "indexer.settings.memory_quota": 536870912, + "indexer.settings.minVbQueueLength": 30, + "indexer.settings.moi.debug": false, + "indexer.settings.moi.persistence_threads": 4, + "indexer.settings.moi.recovery.max_rollbacks": 2, + "indexer.settings.moi.recovery_threads": 8, + "indexer.settings.num_replica": 0, + "indexer.settings.percentage_memory_quota": 0, + "indexer.settings.persisted_snapshot.fdb.interval": 5000, + "indexer.settings.persisted_snapshot.interval": 5000, + "indexer.settings.persisted_snapshot.moi.interval": 600000, + "indexer.settings.persisted_snapshot_init_build.fdb.interval": 5000, + "indexer.settings.persisted_snapshot_init_build.interval": 5000, + "indexer.settings.persisted_snapshot_init_build.moi.interval": 600000, + "indexer.settings.plasma.recovery.max_rollbacks": 2, + "indexer.settings.rebalance.blob_storage_bucket": "", + "indexer.settings.rebalance.blob_storage_prefix": "", + "indexer.settings.rebalance.blob_storage_region": "", + "indexer.settings.rebalance.blob_storage_scheme": "", + "indexer.settings.rebalance.redistribute_indexes": false, + "indexer.settings.recovery.max_rollbacks": 2, + "indexer.settings.scan_getseqnos_retries": 30, + "indexer.settings.scan_timeout": 120000, + "indexer.settings.send_buffer_size": 1024, + "indexer.settings.serverless.indexLimit": 201, + "indexer.settings.sliceBufSize": 1600, + "indexer.settings.smallSnapshotThreshold": 30, + "indexer.settings.snapshotListeners": 4, + "indexer.settings.snapshotRequestWorkers": 4, + "indexer.settings.statsLogDumpInterval": 60, + "indexer.settings.storage_mode": "plasma", + "indexer.settings.storage_mode.disable_upgrade": false, + "indexer.settings.thresholds.mem_high": 70, + "indexer.settings.thresholds.mem_low": 50, + "indexer.settings.thresholds.units_high": 60, + "indexer.settings.thresholds.units_low": 40, + "indexer.settings.units_quota": 10000, + "indexer.settings.wal_size": 4096, + "projector.settings.log_level": "info", + "queryport.client.settings.backfillLimit": 5120, + "queryport.client.settings.closeActiveConnections": true, + "queryport.client.settings.minPoolSizeWM": 1000, + "queryport.client.settings.poolOverflow": 30, + "queryport.client.settings.poolSize": 5000, + "queryport.client.settings.relConnBatchSize": 100 +} \ No newline at end of file diff --git a/docs/modules/index-rest-settings/index-settings.gradle b/docs/modules/index-rest-settings/index-settings.gradle new file mode 100644 index 00000000..fd5fec4b --- /dev/null +++ b/docs/modules/index-rest-settings/index-settings.gradle @@ -0,0 +1,23 @@ +apply plugin: 'org.openapi.generator' + +openApiGenerate { + generatorName = "asciidoc" + inputSpec = file("attachments/index-settings.yaml").getAbsolutePath().toString() + outputDir = "${rootDir}/docs/modules/index-rest-settings/pages" + templateDir = "${rootDir}/templates" + gitRepoId = "cb-swagger" + gitUserId = "couchbaselabs" + additionalProperties = [ + specDir: "${rootDir}/docs/modules/index-rest-settings/partials/", + snippetDir: "${rootDir}/docs/modules/index-rest-settings/partials/paths/", + headerAttributes: "true", + useIntroduction: "true", + useTableTitles: "true", + skipExamples: "true", + legacyDiscriminatorBehavior: "true" + ] + globalProperties = [ + generateAliasAsModel: "true" + ] + generateAliasAsModel = true +} \ No newline at end of file diff --git a/docs/modules/index-rest-settings/pages/index.adoc b/docs/modules/index-rest-settings/pages/index.adoc new file mode 100644 index 00000000..165c65ce --- /dev/null +++ b/docs/modules/index-rest-settings/pages/index.adoc @@ -0,0 +1,2169 @@ += Index Settings REST API +:keywords: OpenAPI, REST +:specDir: partial$ +:snippetDir: partial$paths/ +:page-topic-type: reference +:page-toclevels: 2 +include::partial$header-attributes.adoc[opts=optional] + +[comment] +This file is created automatically by OpenAPI Generator. +DO NOT EDIT! See https://github.com/couchbaselabs/cb-swagger + +:leveloffset: 1 + +include::{specDir}overview/document-before.adoc[opts=optional] + + +[[overview]] += Overview + +:leveloffset: +1 + +// markup not found, no include::{specDir}overview/document-begin.adoc[opts=optional] + + +[markdown] +-- +The Index Settings REST API is provided by the Index Service. +This API enables you to retrieve or set Index Service settings. + +Changes automatically propagate to all Index Service nodes, and will be remembered across node and cluster restarts. + +Unless otherwise noted, you should only change the Index Service settings when advised to do so by Couchbase Support. +-- + +[discrete#version] += Version information +[%hardbreaks] +__Version__ : 8.0 + +[discrete#host] += Host information + +.... +{scheme}://{host}:{port} +.... + +[markdown] +-- +The URL scheme, host, and port are as follows. +-- + +[cols="20,80"] +|=== +| Component | Description + +a| *scheme* +a| [markdown] +-- +The URL scheme. Use `https` for secure access. +-- + +[%hardbreaks] +*Values:* `http`, `https` +*Example:* `+++http+++` +// end + +a| *host* +a| [markdown] +-- +The host name or IP address of a node running the Index Service. +-- + +[%hardbreaks] + +*Example:* `+++localhost+++` +// end + +a| *port* +a| [markdown] +-- +The Index Service REST port. Use `19102` for secure access. +-- + +[%hardbreaks] +*Values:* `9102`, `19102` +*Example:* `+++9102+++` +// end + +|=== + + +include::{specDir}overview/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}overview/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/document-before.adoc[opts=optional] + + +[[resources]] += Resources + +:count-apis: 1 + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/document-begin.adoc[opts=optional] + + +This section describes the operations available with this REST API. +ifeval::[{count-apis} > 1] +The operations are grouped in the following categories. + +[%hardbreaks] +xref:tag-Default[] +endif::[] + + +ifeval::[{count-apis} > 1] +[#tag-Default] += Default +:leveloffset: +1 + +ifeval::["" != ""] + +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] + +[%hardbreaks] +xref:get_settings[] +xref:post_settings[] + + +//tag::get_settings[] + + +// markup not found, no include::{specDir}paths/get_settings/operation-before.adoc[opts=optional] + + +[#get_settings] += Retrieve Index Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/get_settings/operation-begin.adoc[opts=optional] + + +.... +GET /settings +.... + + + +// markup not found, no include::{specDir}paths/get_settings/operation-description-before.adoc[opts=optional] + + +[#get_settings-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/get_settings/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Returns Index Service settings. +-- + + +// markup not found, no include::{specDir}paths/get_settings/operation-description-end.adoc[opts=optional] + + + +[#get_settings-produces] +.Produces +* application/json + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/get_settings/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/get_settings/operation-parameters-before.adoc[opts=optional] + + + + + + +// markup not found, no include::{specDir}paths/get_settings/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/get_settings/operation-responses-before.adoc[opts=optional] + + +[#get_settings-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/get_settings/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. Returns an object giving Index Service settings. +-- +a| xref:Settings[] + + +| 404 +a| [markdown] +-- +Not found. The URL may be specified incorrectly. +-- +a| +| 401 +a| [markdown] +-- +Unauthorized. Failure to authenticate. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/get_settings/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/get_settings/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/get_settings/operation-security-before.adoc[opts=optional] + + +[#get_settings-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/get_settings/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| xref:security-default[] + +|=== + + +// markup not found, no include::{specDir}paths/get_settings/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/get_settings/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}get_settings/http-request.adoc[opts=optional] + + +include::{snippetDir}get_settings/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/get_settings/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/get_settings/operation-after.adoc[opts=optional] + + +//end::get_settings[] + + +//tag::post_settings[] + + +// markup not found, no include::{specDir}paths/post_settings/operation-before.adoc[opts=optional] + + +[#post_settings] += Update Index Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/post_settings/operation-begin.adoc[opts=optional] + + +.... +POST /settings +.... + + + +// markup not found, no include::{specDir}paths/post_settings/operation-description-before.adoc[opts=optional] + + +[#post_settings-description] += Description + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/post_settings/operation-description-begin.adoc[opts=optional] + + +[markdown] +-- +Updates Index Service settings. +-- + + +// markup not found, no include::{specDir}paths/post_settings/operation-description-end.adoc[opts=optional] + + +[#post_settings-consumes] +.Consumes +* application/json + + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/post_settings/operation-description-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/post_settings/operation-parameters-before.adoc[opts=optional] + + +[#post_settings-parameters] += Parameters + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/post_settings/operation-parameters-begin.adoc[opts=optional] + + + + + + +[#post_settings-body] +.Body Parameter +{blank} + +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema + +a¦ *Body* + +_required_ +a¦ + + +[markdown] +-- +An object specifying Index Service settings. You only need to specify the settings you want to change; settings which are not specified are left unchanged. +-- + +[%hardbreaks] +{blank} + +a¦ xref:Settings[] + + + +|=== + + +// markup not found, no include::{specDir}paths/post_settings/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/post_settings/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/post_settings/operation-responses-before.adoc[opts=optional] + + +[#post_settings-responses] += Responses + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/post_settings/operation-responses-begin.adoc[opts=optional] + + +[cols="20,60,20"] +|=== +| HTTP Code | Description | Schema + +| 200 +a| [markdown] +-- +Success. Returns `OK` and no object. +-- +a| +| 401 +a| [markdown] +-- +Unauthorized. Failure to authenticate. +-- +a| +| 404 +a| [markdown] +-- +Not found. The URL may be specified incorrectly. +-- +a| + +|=== + + +// markup not found, no include::{specDir}paths/post_settings/operation-responses-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}paths/post_settings/operation-responses-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/post_settings/operation-security-before.adoc[opts=optional] + + +[#post_settings-security] += Security + +:leveloffset: +1 + +// markup not found, no include::{specDir}paths/post_settings/operation-security-begin.adoc[opts=optional] + + +[cols="20,80"] +|=== +| Type | Name + +| http (basic) +| xref:security-default[] + +|=== + + +// markup not found, no include::{specDir}paths/post_settings/operation-security-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/post_settings/operation-security-after.adoc[opts=optional] + + + +include::{snippetDir}post_settings/http-request.adoc[opts=optional] + + +// markup not found, no include::{snippetDir}post_settings/http-response.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/post_settings/operation-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/post_settings/operation-after.adoc[opts=optional] + + +//end::post_settings[] + + +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] + + + +// markup not found, no include::{specDir}paths/document-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}paths/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}definitions/document-before.adoc[opts=optional] + + +[#models] += Definitions + + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/document-begin.adoc[opts=optional] + + +This section describes the properties consumed and returned by this REST API. + +ifeval::[{count-models} > 1] +ifdef::collapse-models[] +[.two-columns] +endif::collapse-models[] +[%hardbreaks] +xref:Settings[] +xref:SettingsStorageMode[] +ifdef::enum-definitions[] +xref:SettingsStorageModeCE[] +endif::enum-definitions[] +ifdef::enum-definitions[] +xref:SettingsStorageModeEE[] +endif::enum-definitions[] +endif::[] + + + +// markup not found, no include::{specDir}definitions/Settings/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#Settings] += Settings + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/Settings/definition-begin.adoc[opts=optional] + + +.icon:brackets-curly[fw] Object +{blank} + +//tag::Settings[] + + +[cols="25,55,20",separator=¦] +|=== +¦ Property ¦ ¦ Schema + +a¦ +*indexer.rebalance.transferBatchSize* + +_optional_ +a¦ + +[markdown] +-- +Sets the batch size Couchbase Server uses when rebuilding index files during rebalance. +This setting has no effect on file-based rebalance. + +Couchbase Server breaks the rebuilding of indexes during a rebalance into batches to limit the performance impact. +This setting controls the maximum number of indexes that a rebalance rebuilds concurrently. +You must have the Full Admin or the Cluster Admin role to set this value. + +For an overview of rebalance as it affects the Index Service, including an overview of smart batching, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service). +-- + +[%hardbreaks] +*Default:* `3` +*Example:* `7` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.allow_large_keys* + +_optional_ +a¦ + +[markdown] +-- +Whether the size of index keys is unlimited. + +* If true, index keys may have unlimited size. +* If false, the maximum size for index keys and array index keys is specified by `indexer.settings.max_seckey_size` and `indexer.settings.max_array_seckey_size`. + +In Couchbase Server 6.5 and later, the Index Service does not need to restart when you update this setting. +-- + +[%hardbreaks] +*Default:* `true` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.bufferPoolBlockSize* + +_optional_ +a¦ + +[markdown] +-- +Buffer pool block size. +-- + +[%hardbreaks] +*Default:* `16384` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.build.batch_size* + +_optional_ +a¦ + +[markdown] +-- +Build batch size. +-- + +[%hardbreaks] +*Default:* `5` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.compaction.abort_exceed_interval* + +_optional_ +a¦ + +[markdown] +-- +Whether to abort index compaction if it is still running after the end of the index compaction interval. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.compaction.check_period* + +_optional_ +a¦ + +[markdown] +-- +An interval, specifying how frequently the Index Service checks whether the compaction threshold has been reached (seconds). +-- + +[%hardbreaks] +*Default:* `30` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.compaction.compaction_mode* + +_optional_ +a¦ + +[markdown] +-- +The compaction mode for indexes. +-- + +[%hardbreaks] +*Values:* `"standard"`, `"circular"` +*Default:* `+++"circular"+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.compaction.days_of_week* + +_optional_ +a¦ + +[markdown] +-- +The days of the week on which circular compaction is to run, if specified. +Individual values must be day-names, each specified with an initial capital, and otherwise lower-case. +Multiple values must be separated by a single comma, with no spaces. +-- + +[%hardbreaks] +*Default:* `+++"Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday"+++` +*Example:* `+++"Saturday,Sunday"+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.compaction.interval* + +_optional_ +a¦ + +[markdown] +-- +A string in the form `fromHour:fromMinute,toHour:toMinute`, specifying the interval during which index compaction can run. + +* `fromHour` — + An integer between 0 and 23 inclusive, specifying the starting hour of the interval. +* `fromMinute` — + An integer between 0 and 59 inclusive, specifying the starting minute of the interval, within the specified starting hour. +* `toHour` — + An integer between 0 and 23 inclusive, specifying the concluding hour of the interval. +* `toMinute` — + An integer between 0 and 59 inclusive, specifying the concluding minute of the interval, within the specified concluding hour. + +The default value means any time. +-- + +[%hardbreaks] +*Default:* `+++"00:00,00:00"+++` +*Example:* `+++"01:00,05:59"+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.compaction.min_frag* + +_optional_ +a¦ + +[markdown] +-- +The minimum fragmentation threshold to trigger compaction (percentage). +-- + +[%hardbreaks] +*Default:* `30` +*Minimum:* `5` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.compaction.min_size* + +_optional_ +a¦ + +[markdown] +-- +Compaction minimum file size. +-- + +[%hardbreaks] +*Default:* `524288000` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.compaction.plasma.manual* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using Plasma, whether compaction should be triggered manually. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.compaction.plasma.optional.decrement* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using Plasma, the optional decrement. +-- + +[%hardbreaks] +*Default:* `5` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.compaction.plasma.optional.min_frag* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using Plasma, the minimum fragmentation threshold to trigger compaction (percentage). +-- + +[%hardbreaks] +*Default:* `20` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.compaction.plasma.optional.quota* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using Plasma, the optional quota. +-- + +[%hardbreaks] +*Default:* `25` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.corrupt_index_num_backups* + +_optional_ +a¦ + +[markdown] +-- +Corrupt index number of backups. +-- + +[%hardbreaks] +*Default:* `1` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.cpuProfDir* + +_optional_ +a¦ + +[markdown] +-- +The name of the directory where local CPU usage profiling information is captured. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexer.settings.cpuProfile* + +_optional_ +a¦ + +[markdown] +-- +Whether the Index Service should capture local CPU usage profiling information. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.defer_build* + +_optional_ +a¦ + +[markdown] +-- +The default setting for the `defer_build` option for index creation. + +* If this setting is true, and you create an index without specifying `defer_build`, the index is not built immediately. +* If this setting false, and you create an index without specifying `defer_build`, the index is built immediately. + +You can override this setting by specifying the `defer_build` option when you create an index. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.eTagPeriod* + +_optional_ +a¦ + +[markdown] +-- +The ETag (entity tag) period. +-- + +[%hardbreaks] +*Default:* `240` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.enable_corrupt_index_backup* + +_optional_ +a¦ + +[markdown] +-- +Whether corrupt index backup is enabled. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.enable_page_bloom_filter* + +_optional_ +a¦ + +[markdown] +-- +Whether Bloom filters are enabled for memory management. + +For details, see [Per Page Bloom Filters](/server/8.0/learn/services-and-indexes/indexes/storage-modes.html#per-page-bloom-filters). +-- + +[%hardbreaks] +*Default:* `true` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.enable_shard_affinity* + +_optional_ +a¦ + +[markdown] +-- +Selects the index rebalance method. +See [Index Rebalance Methods](/server/8.0/learn/clusters-and-availability/rebalance.html#index-rebalance-methods). + +* If false (the default), Index Service nodes rebuild indexes that are newly assigned to them during a rebalance. + +* If true, Couchbase Server moves a reassigned index's files between Index Service nodes. + +If set to true, when you create an index, you can use the `WITH` clause to specify which node should contain the index. +However, when you alter an index, you cannot use the `WITH` clause to specify which node should contain the index. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.fast_flush_mode* + +_optional_ +a¦ + +[markdown] +-- +Whether fast flush mode is enabled. +-- + +[%hardbreaks] +*Default:* `true` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.gc_percent* + +_optional_ +a¦ + +[markdown] +-- +Garbage collection percentage. +-- + +[%hardbreaks] +*Default:* `100` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.inmemory_snapshot.fdb.interval* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using ForestDB, the in-memory snapshotting interval (ms). +This determines the earliest possibility of a scan seeing a given KV mutation. +-- + +[%hardbreaks] +*Default:* `200` +*Minimum:* `1` (exclusive) +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.inmemory_snapshot.interval* + +_optional_ +a¦ + +[markdown] +-- +The in-memory snapshotting interval (ms). +This determines the earliest possibility of a scan seeing a given KV mutation. +-- + +[%hardbreaks] +*Default:* `200` +*Minimum:* `1` (exclusive) +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.inmemory_snapshot.moi.interval* + +_optional_ +a¦ + +[markdown] +-- +For memory-optimized indexes, the in-memory snapshotting interval (ms). +This determines the earliest possibility of a scan seeing a given KV mutation. +-- + +[%hardbreaks] +*Default:* `10` +*Minimum:* `1` (exclusive) +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.largeSnapshotThreshold* + +_optional_ +a¦ + +[markdown] +-- +The large snapshot threshold. +-- + +[%hardbreaks] +*Default:* `200` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.log_level* + +_optional_ +a¦ + +[markdown] +-- +Indexer logging level. +-- + +[%hardbreaks] +*Values:* `"silent"`, `"fatal"`, `"error"`, `"warn"`, `"info"`, `"verbose"`, `"timing"`, `"debug"`, `"trace"` +*Default:* `+++"info"+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.maxNumPartitions* + +_optional_ +a¦ + +[markdown] +-- +Maximum number of partitions. +-- + +[%hardbreaks] +*Default:* `64` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.maxVbQueueLength* + +_optional_ +a¦ + +[markdown] +-- +Maximum vBucket queue length. +-- + +[%hardbreaks] +*Default:* `0` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.max_array_seckey_size* + +_optional_ +a¦ + +[markdown] +-- +If `indexer.settings.allow_large_keys` is false, this setting specifies the maximum size for array index keys. + +In Couchbase Server 6.5 and later, the Index Service does not need to restart when you update this setting. +-- + +[%hardbreaks] +*Default:* `10240` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.max_cpu_percent* + +_optional_ +a¦ + +[markdown] +-- +The CPU capacity that the Index Service should use (percentage). +If set to `0`, the indexer will use all CPUs. +-- + +[%hardbreaks] +*Default:* `0` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.max_seckey_size* + +_optional_ +a¦ + +[markdown] +-- +If `indexer.settings.allow_large_keys` is false, this setting specifies the maximum size for index keys. + +In Couchbase Server 6.5 and later, the Index Service does not need to restart when you update this setting. +-- + +[%hardbreaks] +*Default:* `4608` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.max_writer_lock_prob* + +_optional_ +a¦ + +[markdown] +-- +Maximum writer lock prob. +-- + +[%hardbreaks] +*Default:* `20` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.memProfDir* + +_optional_ +a¦ + +[markdown] +-- +The name of the directory where local memory usage profiling information is captured. +-- + +[%hardbreaks] +{blank} +a¦ String + + +a¦ +*indexer.settings.memProfile* + +_optional_ +a¦ + +[markdown] +-- +Whether the Index Service should capture local memory usage profiling information. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.memory_quota* + +_optional_ +a¦ + +[markdown] +-- +How much RAM is allocated to the Index Service for the current node. +-- + +[%hardbreaks] +*Default:* `536870912` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.minVbQueueLength* + +_optional_ +a¦ + +[markdown] +-- +Minimum vBucket queue length. +-- + +[%hardbreaks] +*Default:* `30` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.moi.debug* + +_optional_ +a¦ + +[markdown] +-- +Debug memory-optimized index storage. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.moi.persistence_threads* + +_optional_ +a¦ + +[markdown] +-- +For memory-optimized index storage, the number of persistence threads. +-- + +[%hardbreaks] +*Default:* `4` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.moi.recovery.max_rollbacks* + +_optional_ +a¦ + +[markdown] +-- +For memory-optimized index storage, the maximum number of committed rollback points. +-- + +[%hardbreaks] +*Default:* `2` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.moi.recovery_threads* + +_optional_ +a¦ + +[markdown] +-- +For memory-optimized index storage, the number of recovery threads. +-- + +[%hardbreaks] +*Default:* `8` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.num_replica* + +_optional_ +a¦ + +[markdown] +-- +The default number of index replicas to be created by the Index Service whenever `CREATE INDEX` is invoked. +-- + +[%hardbreaks] +*Default:* `0` +*Example:* `2` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.percentage_memory_quota* + +_optional_ +a¦ + +[markdown] +-- +Percentage memory quota. +-- + +[%hardbreaks] +*Default:* `0` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.persisted_snapshot.fdb.interval* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using ForestDB, the persisted snapshotting interval (ms). +This must be a multiple of the in-memory snapshot interval. +-- + +[%hardbreaks] +*Default:* `5000` +*Minimum:* `100` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.persisted_snapshot.interval* + +_optional_ +a¦ + +[markdown] +-- +The persisted snapshotting interval (ms). +This must be a multiple of the in-memory snapshot interval. +-- + +[%hardbreaks] +*Default:* `5000` +*Minimum:* `100` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.persisted_snapshot.moi.interval* + +_optional_ +a¦ + +[markdown] +-- +For memory-optimized indexes, the persisted snapshotting interval (ms). +This must be a multiple of the in-memory snapshot interval. +-- + +[%hardbreaks] +*Default:* `600000` +*Minimum:* `100` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.persisted_snapshot_init_build.fdb.interval* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using ForestDB, the persisted snapshotting interval for the initial build (ms). +-- + +[%hardbreaks] +*Default:* `5000` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.persisted_snapshot_init_build.interval* + +_optional_ +a¦ + +[markdown] +-- +The persisted snapshotting interval for the initial build (ms). +-- + +[%hardbreaks] +*Default:* `5000` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.persisted_snapshot_init_build.moi.interval* + +_optional_ +a¦ + +[markdown] +-- +For memory-optimized indexes, the persisted snapshotting interval for the initial build (ms). +-- + +[%hardbreaks] +*Default:* `600000` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.plasma.recovery.max_rollbacks* + +_optional_ +a¦ + +[markdown] +-- +For standard indexes using Plasma, the maximum number of committed rollback points. +-- + +[%hardbreaks] +*Default:* `2` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.rebalance.blob_storage_bucket* + +_optional_ +a¦ + +[markdown] +-- +Rebalance blob storage bucket. +-- + +[%hardbreaks] +*Default:* `+++""+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.rebalance.blob_storage_prefix* + +_optional_ +a¦ + +[markdown] +-- +Rebalance blob storage prefix. +-- + +[%hardbreaks] +*Default:* `+++""+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.rebalance.blob_storage_region* + +_optional_ +a¦ + +[markdown] +-- +Rebalance blob storage region. +-- + +[%hardbreaks] +*Default:* `+++""+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.rebalance.blob_storage_scheme* + +_optional_ +a¦ + +[markdown] +-- +Rebalance blob storage scheme. +-- + +[%hardbreaks] +*Default:* `+++""+++` +{blank} +a¦ String + + +a¦ +*indexer.settings.rebalance.redistribute_indexes* + +_optional_ +a¦ + +[markdown] +-- +Whether to redistribute indexes on rebalance. + +* When true, Couchbase Server redistributes indexes when rebalance occurs, in order to optimize performance. + +* When false (the default), such redistribution does not occur. + +For details, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service). +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.recovery.max_rollbacks* + +_optional_ +a¦ + +[markdown] +-- +The maximum number of committed rollback points. +-- + +[%hardbreaks] +*Default:* `2` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.scan_getseqnos_retries* + +_optional_ +a¦ + +[markdown] +-- +Scan get sequence numbers retries. +-- + +[%hardbreaks] +*Default:* `30` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.scan_timeout* + +_optional_ +a¦ + +[markdown] +-- +The default timeout for the indexer, in milliseconds. +This is distinct from the Query Service timeout. +The Index Service has its own timeout because index scans consume resources such as memory and CPU while holding snapshots and performing range scan. + +An index scan may time out if the Index Service timeout is lower than the Query Service timeout. +-- + +[%hardbreaks] +*Default:* `120000` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.send_buffer_size* + +_optional_ +a¦ + +[markdown] +-- +Send buffer size. +-- + +[%hardbreaks] +*Default:* `1024` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.serverless.indexLimit* + +_optional_ +a¦ + +[markdown] +-- +Serverless index limit. +-- + +[%hardbreaks] +*Default:* `201` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.sliceBufSize* + +_optional_ +a¦ + +[markdown] +-- +Slice buffer size. +-- + +[%hardbreaks] +*Default:* `1600` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.smallSnapshotThreshold* + +_optional_ +a¦ + +[markdown] +-- +Small snapshot threshold. +-- + +[%hardbreaks] +*Default:* `30` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.snapshotListeners* + +_optional_ +a¦ + +[markdown] +-- +Snapshot listeners. +-- + +[%hardbreaks] +*Default:* `4` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.snapshotRequestWorkers* + +_optional_ +a¦ + +[markdown] +-- +Snapshot request workers. +-- + +[%hardbreaks] +*Default:* `4` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.statsLogDumpInterval* + +_optional_ +a¦ + +[markdown] +-- +Statistics log dump interval. +-- + +[%hardbreaks] +*Default:* `60` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.storage_mode* + +_optional_ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-SettingsStorageMode, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:SettingsStorageMode[] + + +a¦ +*indexer.settings.storage_mode.disable_upgrade* + +_optional_ +a¦ + +[markdown] +-- +Whether upgrade of the index storage mode is disabled. +-- + +[%hardbreaks] +*Default:* `false` +{blank} +a¦ Boolean + + +a¦ +*indexer.settings.thresholds.mem_high* + +_optional_ +a¦ + +[markdown] +-- +High memory threshold. +-- + +[%hardbreaks] +*Default:* `70` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.thresholds.mem_low* + +_optional_ +a¦ + +[markdown] +-- +Low memory threshold. +-- + +[%hardbreaks] +*Default:* `50` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.thresholds.units_high* + +_optional_ +a¦ + +[markdown] +-- +High units threshold. +-- + +[%hardbreaks] +*Default:* `60` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.thresholds.units_low* + +_optional_ +a¦ + +[markdown] +-- +Low units threshold. +-- + +[%hardbreaks] +*Default:* `40` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.units_quota* + +_optional_ +a¦ + +[markdown] +-- +Units quota. +-- + +[%hardbreaks] +*Default:* `10000` +{blank} +a¦ Integer (int32) + + +a¦ +*indexer.settings.wal_size* + +_optional_ +a¦ + +[markdown] +-- +Write-ahead log size. +-- + +[%hardbreaks] +*Default:* `4096` +{blank} +a¦ Integer (int32) + + +a¦ +*projector.settings.log_level* + +_optional_ +a¦ + +[markdown] +-- +Projector logging level. +-- + +[%hardbreaks] +*Default:* `+++"info"+++` +{blank} +a¦ String + + +a¦ +*queryport.client.settings.backfillLimit* + +_optional_ +a¦ + +[markdown] +-- +The maximum size of the backfill file (MB). + +* A value of `0` disables backfill. +* A value of `-1` means the size is unlimited. + +The maximum size is limited only by the available disk space. +-- + +[%hardbreaks] +*Default:* `5120` +{blank} +a¦ Integer (int32) + + +a¦ +*queryport.client.settings.closeActiveConnections* + +_optional_ +a¦ + +[markdown] +-- +Whether to close active connections. +-- + +[%hardbreaks] +*Default:* `true` +{blank} +a¦ Boolean + + +a¦ +*queryport.client.settings.minPoolSizeWM* + +_optional_ +a¦ + +[markdown] +-- +Minimum pool size. +-- + +[%hardbreaks] +*Default:* `1000` +{blank} +a¦ Integer (int32) + + +a¦ +*queryport.client.settings.poolOverflow* + +_optional_ +a¦ + +[markdown] +-- +Maximum number of connections in a pool. +-- + +[%hardbreaks] +*Default:* `30` +{blank} +a¦ Integer (int32) + + +a¦ +*queryport.client.settings.poolSize* + +_optional_ +a¦ + +[markdown] +-- +Number of simultaneous active connections in a pool. +-- + +[%hardbreaks] +*Default:* `5000` +{blank} +a¦ Integer (int32) + + +a¦ +*queryport.client.settings.relConnBatchSize* + +_optional_ +a¦ + +[markdown] +-- +Connection batch size. +-- + +[%hardbreaks] +*Default:* `100` +{blank} +a¦ Integer (int32) + + +|=== + +//end::Settings[] + + + + +// markup not found, no include::{specDir}definitions/Settings/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/Settings/definition-after.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}definitions/SettingsStorageMode/definition-before.adoc[opts=optional] + + +ifdef::collapse-models[] +[discrete] +endif::collapse-models[] +[#SettingsStorageMode] += Storage Mode + +:leveloffset: +1 + +// markup not found, no include::{specDir}definitions/SettingsStorageMode/definition-begin.adoc[opts=optional] + + +.icon:bars[fw] Composite Schema +{blank} + +//tag::SettingsStorageMode[] + +ifdef::model-descriptions[] +//tag::desc-SettingsStorageMode[] +The storage mode to be used for the Index Service on this node. +//end::desc-SettingsStorageMode[] +endif::model-descriptions[] + +[cols="25,55,20",separator=¦] +|=== +¦ One{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ [.edition]##{enterprise}## + +[markdown] +-- +include::index.adoc[tag=desc-SettingsStorageModeEE, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ +include::index.adoc[tag=type-SettingsStorageModeEE, opts=optional] + +a¦ _or_ +a¦ [.edition]##{community}## + +[markdown] +-- +include::index.adoc[tag=desc-SettingsStorageModeCE, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ +include::index.adoc[tag=type-SettingsStorageModeCE, opts=optional] + +|=== + +//end::SettingsStorageMode[] + + +// markup not found, no include::{specDir}definitions/SettingsStorageMode/definition-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/SettingsStorageMode/definition-after.adoc[opts=optional] + + +ifdef::enum-definitions[] +[#SettingsStorageModeCE] += Community Edition + +.icon:menu[fw] Enumeration +{blank} + +//tag::desc-SettingsStorageModeCE[] +If you are using Community Edition, the default (and only) value is `forestdb`. +//end::desc-SettingsStorageModeCE[] + +.Schema +//tag::type-SettingsStorageModeCE[] +String + + +//end::type-SettingsStorageModeCE[] +endif::enum-definitions[] +ifdef::enum-definitions[] +[#SettingsStorageModeEE] += Enterprise Edition + +.icon:menu[fw] Enumeration +{blank} + +//tag::desc-SettingsStorageModeEE[] +If you are using Enterprise Edition, the possible values are: + +* `plasma` (the default) — + Sets the index storage mode to use the Plasma storage engine, which can utilize both memory and persistent storage for index maintenance and index scans. + +* `memory_optimized` — + Sets the index storage mode to use memory optimized global secondary indexes, which can perform index maintenance and index scan faster at in-memory speeds. + +This setting can only be changed while there are no index nodes in the cluster. +To change from standard GSI to memory optimized GSI or vice versa, you need to remove all the Index Service nodes in the cluster. +//end::desc-SettingsStorageModeEE[] + +.Schema +//tag::type-SettingsStorageModeEE[] +String + + +//end::type-SettingsStorageModeEE[] +endif::enum-definitions[] + + +// markup not found, no include::{specDir}definitions/document-end.adoc[opts=optional] + + +:leveloffset: -1 + +// markup not found, no include::{specDir}definitions/document-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}security/document-before.adoc[opts=optional] + + +[[security]] += Security + +:leveloffset: +1 + +include::{specDir}security/document-begin.adoc[opts=optional] + + + + +// markup not found, no include::{specDir}security/Default/security-scheme-before.adoc[opts=optional] + + +[[security-default]] += Default + +:leveloffset: +1 + +// markup not found, no include::{specDir}security/Default/security-scheme-begin.adoc[opts=optional] + + +[markdown] +-- +Users must have the Full Admin or Cluster Admin role, with Cluster Read and Bucket INDEX List privileges. +-- + +[%hardbreaks] +__Type__ : http + + +// markup not found, no include::{specDir}security/Default/security-scheme-end.adoc[opts=optional] + +:leveloffset: -1 + + +// markup not found, no include::{specDir}security/Default/security-scheme-after.adoc[opts=optional] + + + + +include::{specDir}security/document-end.adoc[opts=optional] + +:leveloffset: -1 + + + +// markup not found, no include::{specDir}security/document-after.adoc[opts=optional] + + diff --git a/docs/modules/index-rest-settings/partials/header-attributes.adoc b/docs/modules/index-rest-settings/partials/header-attributes.adoc new file mode 100644 index 00000000..d8230b83 --- /dev/null +++ b/docs/modules/index-rest-settings/partials/header-attributes.adoc @@ -0,0 +1,5 @@ +:page-partial: +:page-aliases: rest-api:rest-modify-index-batch-size.adoc +:!example-caption: +:description: The Index Settings REST API is provided by the Index Service. \ +This API enables you to retrieve or set Index Service settings. \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/overview/document-before.adoc b/docs/modules/index-rest-settings/partials/overview/document-before.adoc new file mode 100644 index 00000000..1fb78375 --- /dev/null +++ b/docs/modules/index-rest-settings/partials/overview/document-before.adoc @@ -0,0 +1,57 @@ +// Pass through HTML table styles for this page. +// This overrides Swagger2Markup's table layout defaults. + +ifdef::basebackend-html[] +++++ + +++++ +endif::[] \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/overview/document-end.adoc b/docs/modules/index-rest-settings/partials/overview/document-end.adoc new file mode 100644 index 00000000..4bbd311a --- /dev/null +++ b/docs/modules/index-rest-settings/partials/overview/document-end.adoc @@ -0,0 +1,8 @@ +[discrete] += Examples on this page + +In the HTTP request examples: + +* `$HOST` is the host name or IP address of a node running the Index Service. +* `$USER` is the user name of any authorized user -- see <>. +* `$PASSWORD` is the password to connect to Couchbase Server. \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/paths/get_settings/http-request.adoc b/docs/modules/index-rest-settings/partials/paths/get_settings/http-request.adoc new file mode 100644 index 00000000..0694d7f3 --- /dev/null +++ b/docs/modules/index-rest-settings/partials/paths/get_settings/http-request.adoc @@ -0,0 +1,12 @@ += Example HTTP Request + +==== +The example below retrieves the current index settings. + +.Curl request +[source,sh] +---- +curl -X GET http://$HOST:9102/settings \ + -u $USER:$PASSWORD +---- +==== \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/paths/get_settings/http-response.adoc b/docs/modules/index-rest-settings/partials/paths/get_settings/http-response.adoc new file mode 100644 index 00000000..3c9a69fa --- /dev/null +++ b/docs/modules/index-rest-settings/partials/paths/get_settings/http-response.adoc @@ -0,0 +1,9 @@ += Example HTTP Response + +==== +.Response 200 +[source,json] +---- +include::example$get_settings.json[] +---- +==== \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/paths/post_settings/http-request.adoc b/docs/modules/index-rest-settings/partials/paths/post_settings/http-request.adoc new file mode 100644 index 00000000..7a5fc4ea --- /dev/null +++ b/docs/modules/index-rest-settings/partials/paths/post_settings/http-request.adoc @@ -0,0 +1,46 @@ += Example HTTP Requests + +[#ex-defer-build] +.Defer Index Builds by Default +==== +This example specifies the default setting for deferred builds. + +.Curl request +[source,sh] +---- +curl -X POST http://$HOST:9102/settings \ + -u $USER:$PASSWORD \ + -H 'content-type: application/json' \ + -d '{"indexer.settings.defer_build": true}' +---- +==== + +[#ex-scan-timeout] +.Set the Indexer Scan Timeout +==== +This example sets the indexer scan timeout. + +.Curl request +[source,sh] +---- +curl -X POST http://$HOST:9102/settings \ + -u $USER:$PASSWORD \ + -H 'content-type: application/json' \ + -d '{"indexer.settings.scan_timeout": 15000}' +---- +==== + +[#ex-modify-index-batch-size] +.Modify Index Batch Size +==== +This example modifies the index batch size for rebalance. + +.Curl request +[source,sh] +---- +curl -X POST http://$HOST:9102/settings \ + -u $USER:$PASSWORD \ + -H 'content-type: application/json' \ + -d '{ "indexer.rebalance.transferBatchSize": 7 }' +---- +==== \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/security/document-begin.adoc b/docs/modules/index-rest-settings/partials/security/document-begin.adoc new file mode 100644 index 00000000..cbf1b644 --- /dev/null +++ b/docs/modules/index-rest-settings/partials/security/document-begin.adoc @@ -0,0 +1,2 @@ +The Index Settings API supports admin credentials. +Pass your credentials through HTTP headers (HTTP basic authentication). \ No newline at end of file diff --git a/docs/modules/index-rest-settings/partials/security/document-end.adoc b/docs/modules/index-rest-settings/partials/security/document-end.adoc new file mode 100644 index 00000000..36d8ba1d --- /dev/null +++ b/docs/modules/index-rest-settings/partials/security/document-end.adoc @@ -0,0 +1 @@ +Refer to xref:learn:security/roles.adoc[Roles] for more details. \ No newline at end of file diff --git a/docs/modules/index-rest-stats/attachments/indexes.yaml b/docs/modules/index-rest-stats/attachments/indexes.yaml index 497776de..3fb268b9 100644 --- a/docs/modules/index-rest-stats/attachments/indexes.yaml +++ b/docs/modules/index-rest-stats/attachments/indexes.yaml @@ -163,6 +163,7 @@ components: NodeIdxNode: type: object title: Nodes + description: Node statistics. required: - indexer properties: @@ -217,12 +218,14 @@ components: PartIdxIndexes: type: object title: Indexes + description: Index statistics. additionalProperties: $ref: "#/components/schemas/PartIdxPartitionsIndex" PartIdxPartitions: type: object title: Partitions + description: Index partition statistics. additionalProperties: $ref: "#/components/schemas/PartIdxPartitionsIndex" diff --git a/docs/modules/index-rest-stats/pages/index.adoc b/docs/modules/index-rest-stats/pages/index.adoc index b91c5528..86895d46 100644 --- a/docs/modules/index-rest-stats/pages/index.adoc +++ b/docs/modules/index-rest-stats/pages/index.adoc @@ -1001,14 +1001,42 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::NodeIdx[] -* xref:NodeIdxNode[] + +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-NodeIdxNode, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:NodeIdxNode[] -* xref:PartIdxIndexes[] +a¦ _and_ +a¦ +[markdown] +-- +include::index.adoc[tag=desc-PartIdxIndexes, opts=optional] +-- +[%hardbreaks] +{blank} +a¦ xref:PartIdxIndexes[] + + +|=== + +//end::NodeIdx[] // markup not found, no include::{specDir}definitions/NodeIdx/definition-end.adoc[opts=optional] @@ -1040,6 +1068,11 @@ endif::collapse-models[] //tag::NodeIdxNode[] +ifdef::model-descriptions[] +//tag::desc-NodeIdxNode[] +Node statistics. +//end::desc-NodeIdxNode[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -1225,14 +1258,42 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -All of the following: +//tag::PartIdx[] + + +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ + +[markdown] +-- +include::index.adoc[tag=desc-PartIdxIndexes, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:PartIdxIndexes[] + -* xref:PartIdxIndexes[] +a¦ _and_ +a¦ +[markdown] +-- +include::index.adoc[tag=desc-PartIdxPartitions, opts=optional] +-- -* xref:PartIdxPartitions[] +[%hardbreaks] +{blank} +a¦ xref:PartIdxPartitions[] +|=== + +//end::PartIdx[] // markup not found, no include::{specDir}definitions/PartIdx/definition-end.adoc[opts=optional] @@ -1264,6 +1325,11 @@ endif::collapse-models[] //tag::PartIdxIndexes[] +ifdef::model-descriptions[] +//tag::desc-PartIdxIndexes[] +Index statistics. +//end::desc-PartIdxIndexes[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== @@ -1321,6 +1387,11 @@ endif::collapse-models[] //tag::PartIdxPartitions[] +ifdef::model-descriptions[] +//tag::desc-PartIdxPartitions[] +Index partition statistics. +//end::desc-PartIdxPartitions[] +endif::model-descriptions[] [cols="25,55,20",separator=¦] |=== diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index 8e188029..0f6a7d07 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -1453,8 +1453,7 @@ If a request includes this parameter, it will be capped by the node-level `numat [%hardbreaks] *Default:* `1024` -*Minimum:* `0` -*Exclusive minimum:* `true` +*Minimum:* `0` (exclusive) *Example:* `512` {blank} a¦ Integer (int32) diff --git a/docs/preview/HEAD.yml b/docs/preview/HEAD.yml index c37f530f..ec179b30 100644 --- a/docs/preview/HEAD.yml +++ b/docs/preview/HEAD.yml @@ -1,7 +1,7 @@ sources: docs-server: - branches: release/7.6 + branches: release/8.0 docs-analytics: - branches: release/7.6 + branches: release/8.0 docs-devex: - branches: release/7.6 \ No newline at end of file + branches: release/8.0 \ No newline at end of file diff --git a/settings.gradle b/settings.gradle index ac195227..e8149391 100644 --- a/settings.gradle +++ b/settings.gradle @@ -5,6 +5,7 @@ include 'admin', 'eventing', 'functions', 'indexes', + 'index-settings', 'analytics-admin', 'analytics-config', 'analytics-library', @@ -29,6 +30,8 @@ project(':functions').projectDir = new File (settingsDir, 'docs/modules/n1ql-res project(':functions').buildFileName = 'functions.gradle' project(':indexes').projectDir = new File (settingsDir, 'docs/modules/index-rest-stats') project(':indexes').buildFileName = 'indexes.gradle' +project(':index-settings').projectDir = new File (settingsDir, 'docs/modules/index-rest-settings') +project(':index-settings').buildFileName = 'index-settings.gradle' project(':analytics-service').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-service') project(':analytics-service').buildFileName = 'analytics-service.gradle' project(':analytics-config').projectDir = new File (settingsDir, 'docs/modules/analytics-rest-config') diff --git a/templates/models.mustache b/templates/models.mustache index b2e76b4d..9dc330ad 100644 --- a/templates/models.mustache +++ b/templates/models.mustache @@ -110,24 +110,63 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} +{{! tag for partial}} +//tag::{{name}}[] + +{{! Create partial model description }} +{{#description}} +ifdef::model-descriptions[] +//tag::desc-{{name}}[] +{{{unescapedDescription}}} +//end::desc-{{name}}[] +endif::model-descriptions[] +{{/description}} + {{#oneOf}} -{{#-first}}One of the following: +{{#-first}} +[cols="25,55,20",separator=¦] +|=== +¦ One{nbsp}of{nbsp}... ¦ ¦ Schema {{/-first}} -* {{>schemas}} +a¦ {{^-first}}_or_{{/-first}} +a¦ {{>property}} +a¦ {{>schemas}} +{{#-last}} +|=== +{{/-last}} {{/oneOf}} {{#anyOf}} -{{#-first}}Any of the following: +{{#-first}} +[cols="25,55,20",separator=¦] +|=== +¦ Any{nbsp}of{nbsp}... ¦ ¦ Schema {{/-first}} -* {{>schemas}} +a¦ {{^-first}}_and{nbsp}/ or_{{/-first}} +a¦ {{>property}} +a¦ {{>schemas}} +{{#-last}} +|=== +{{/-last}} {{/anyOf}} {{#allOf}} -{{#-first}}All of the following: +{{#-first}} +[cols="25,55,20",separator=¦] +|=== +¦ All{nbsp}of{nbsp}... ¦ ¦ Schema {{/-first}} -* {{>schemas}} +a¦ {{^-first}}_and_{{/-first}} +a¦ {{>property}} +a¦ {{>schemas}} +{{#-last}} +|=== +{{/-last}} {{/allOf}} + +{{! end tag for partial}} +//end::{{name}}[] {{/composedSchemas}} {{! include partial after definition body }} diff --git a/templates/param.mustache b/templates/param.mustache index 3e0a6319..68e06af2 100644 --- a/templates/param.mustache +++ b/templates/param.mustache @@ -33,20 +33,12 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{/pattern}} {{! minimum value}} {{#minimum}} -*Minimum:* `{{{minimum}}}` +*Minimum:* `{{{minimum}}}`{{#exclusiveMinimum}} (exclusive){{/exclusiveMinimum}} {{/minimum}} {{! maximum value}} {{#maximum}} -*Maximum:* `{{{maximum}}}` +*Maximum:* `{{{maximum}}}`{{#exclusiveMaximum}} (exclusive){{/exclusiveMaximum}} {{/maximum}} -{{! exclusive minimum value}} -{{#exclusiveMinimum}} -*Exclusive minimum:* `{{{exclusiveMinimum}}}` -{{/exclusiveMinimum}} -{{! exclusive maximum value}} -{{#exclusiveMaximum}} -*Exclusive maximum:* `{{{exclusiveMaximum}}}` -{{/exclusiveMaximum}} {{! multiple of value}} {{#multipleOf}} *Multiple of:* `{{{multipleOf}}}` diff --git a/templates/property.mustache b/templates/property.mustache index 19eccde5..0710335f 100644 --- a/templates/property.mustache +++ b/templates/property.mustache @@ -53,20 +53,12 @@ include::index.adoc[tag=desc-{{dataType}}, opts=optional] {{/pattern}} {{! minimum value}} {{#minimum}} -*Minimum:* `{{{minimum}}}` +*Minimum:* `{{{minimum}}}`{{#exclusiveMinimum}} (exclusive){{/exclusiveMinimum}} {{/minimum}} {{! maximum value}} {{#maximum}} -*Maximum:* `{{{maximum}}}` +*Maximum:* `{{{maximum}}}`{{#exclusiveMaximum}} (exclusive){{/exclusiveMaximum}} {{/maximum}} -{{! exclusive minimum value}} -{{#exclusiveMinimum}} -*Exclusive minimum:* `{{{exclusiveMinimum}}}` -{{/exclusiveMinimum}} -{{! exclusive maximum value}} -{{#exclusiveMaximum}} -*Exclusive maximum:* `{{{exclusiveMaximum}}}` -{{/exclusiveMaximum}} {{! multiple of value}} {{#multipleOf}} *Multiple of:* `{{{multipleOf}}}` From 12d8b66f748ae853704cf63fbf4b97e27b5384fb Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Fri, 29 Aug 2025 14:32:45 +0100 Subject: [PATCH 17/25] DOC-11754: Revise queryTmpSpaceDir & queryTmpSpaceSize descriptions (#179) --- .../n1ql-rest-settings/attachments/_query-settings.yaml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml b/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml index b8488fd5..879a723c 100644 --- a/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml +++ b/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml @@ -642,7 +642,7 @@ components: x-has-example: true x-desc-name: queryTmpSpaceDir description: |- - The path to which the indexer writes temporary backfill files, to store any transient data during query processing. + The path to which the Index Service writes temporary backfill files, and the Query Service writes spill files, to store any transient data during query processing. The specified path must already exist. Only absolute paths are allowed. @@ -657,7 +657,8 @@ components: x-has-example: true x-desc-name: queryTmpSpaceSize description: |- - The maximum size of temporary backfill files (MB). + In MiB, the maximum size of temporary backfill files for each indexer, and the maximum size of temporary files for spilled sorting and other operations. + In a cluster with both secondary indexing and full text search, the limit for disk space use is three times this setting. Setting the size to `0` disables backfill. Setting the size to `-1` means the size is unlimited. From af4d2a02ae1b7951c3eff393d7bb2f018ad9a438 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Fri, 29 Aug 2025 17:44:19 +0100 Subject: [PATCH 18/25] DOC-12705: Natural language requests to Query Service API (#180) * DOC-12705: Natural language requests to Query Service API * DOC-12770: add documentation for natural_output parameter * Minor fixes --- .../attachments/_query-service.yaml | 164 ++++++++++++++---- 1 file changed, 129 insertions(+), 35 deletions(-) diff --git a/docs/modules/n1ql-rest-query/attachments/_query-service.yaml b/docs/modules/n1ql-rest-query/attachments/_query-service.yaml index b4b22727..2643a52c 100644 --- a/docs/modules/n1ql-rest-query/attachments/_query-service.yaml +++ b/docs/modules/n1ql-rest-query/attachments/_query-service.yaml @@ -48,27 +48,6 @@ paths: application/x-www-form-urlencoded: schema: $ref: "#/components/schemas/Request" - x-codeSamples: - - lang: Shell - label: JSON - source: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exsuccessful.sh' - - lang: Shell - label: Form Data - source: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exformdata.sh' - - lang: Shell - label: Named Parameters - source: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exnamed.sh' - - lang: Shell - label: Numbered Parameters - source: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exnumbered.sh' - - lang: Shell - label: Unnumbered Parameters - source: - $ref: '../../../docs/modules/n1ql-rest-query/examples/expositional.sh' security: - Header: [] # - Parameter: [] @@ -114,11 +93,6 @@ paths: The format for URL-encoded parameters is consistent with the syntax for variables according to RFC 6570. schema: $ref: "#/components/schemas/Request" - x-codeSamples: - - lang: Shell - label: Read-Only - source: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exreadonly.sh' security: - Header: [] # - Parameter: [] @@ -163,7 +137,7 @@ components: schema: $ref: "#/components/schemas/Response" example: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exsuccessful.json' + $ref: '../examples/exsuccessful.json' BadRequest: description: |- @@ -180,11 +154,11 @@ components: n1qlerror: summary: SQL++ Error value: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exn1qlerror.json' + $ref: '../examples/exn1qlerror.json' requesterror: summary: Request Error value: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exrequesterror.json' + $ref: '../examples/exrequesterror.json' Unauthorized: description: |- @@ -206,7 +180,7 @@ components: schema: $ref: "#/components/schemas/Response" example: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exnotfound.json' + $ref: '../examples/exnotfound.json' MethodNotAllowed: description: |- @@ -243,7 +217,7 @@ components: schema: $ref: "#/components/schemas/Response" example: - $ref: '../../../docs/modules/n1ql-rest-query/examples/exserviceerror.json' + $ref: '../examples/exserviceerror.json' schemas: Request: @@ -389,8 +363,8 @@ components: type: string x-desc-name: encoded_plan description: |- - In Couchbase Server 6.5 and later, this parameter is ignored and has no effect. - It is included for compatibility with previous versions of Couchbase Server. + In clusters running Couchbase Server 6.5 and later, this parameter is ignored and has no effect. + It is included for compatibility with previous versions. encoding: type: string x-desc-name: encoding @@ -513,6 +487,112 @@ components: Currently, only the `default` namespace is available. x-has-example: true example: default + natural: + type: string + x-desc-name: natural + x-desc-status: Couchbase Server 8.0 + description: |- + The prompt for a natural language request. + The Query Service uses the prompt to generate a SQL++ statement. + + If the generated statement is a SELECT statement, the generated statement is returned and executed automatically. + + If the generated statement is not a SELECT statement, the generated statement is returned, but not executed. + In this case, you must verify the statement and execute it in a separate request. + + Natural language requests use the Couchbase Capella iQ service as a backend. + You must have a Couchbase Capella account to make a natural language request. + + This parameter is available in clusters running Couchbase Server 8.0 and later. + + To use this parameter, you must also specify the `natural_cred`, `natural_orgid`, and `natural_context` parameters. + If you don't specify all four parameters, the Query Service returns an error. + x-has-example: true + example: Show me count of airlines per country + natural_cred: + type: string + format: password + x-desc-name: natural_cred + x-desc-status: Couchbase Server 8.0 + description: |- + The Couchbase Capella credentials for a natural language request, in the form `username:password`. + Be careful not to expose the credentials in log files or other output. + + Natural language requests use the Couchbase Capella iQ service as a backend. + You must have a Couchbase Capella account to make a natural language request. + + This parameter is available in clusters running Couchbase Server 8.0 and later. + + To use this parameter, you must also specify the `natural`, `natural_orgid`, and `natural_context` parameters. + If you don't specify all four parameters, the Query Service returns an error. + x-has-example: true + example: : + natural_orgid: + type: string + format: uuid + x-desc-name: natural_orgid + x-desc-status: Couchbase Server 8.0 + description: |- + The Couchbase Capella organization ID for a natural language request. + + Natural language requests use the Couchbase Capella iQ service as a backend. + You must have a Couchbase Capella account to make a natural language request. + + This parameter is available in clusters running Couchbase Server 8.0 and later. + + To use this parameter, you must also specify the `natural`, `natural_cred`, and `natural_context` parameters. + If you don't specify all four parameters, the Query Service returns an error. + natural_context: + type: string + x-desc-name: natural_context + x-desc-status: Couchbase Server 8.0 + description: |- + A list of paths specifying keyspaces for a natural language request. + The Query Service infers the schema of each keyspace, in order to give more precise responses from the natural language request. + + The parameter may contain up to four paths, separated by commas. + Spaces are allowed. + Each path may be: + + * A full path, in the form `bucket.scope.collection` or `namespace:bucket.scope.collection`. + + * A path prefix, in the form `namespace:bucket` or `bucket`, to specify the default collection in the default scope. + + * A partial path, in the form `collection`. + In this case, you must specify the `query_context` parameter to provide the bucket and scope. + + Natural language requests use the Couchbase Capella iQ service as a backend. + You must have a Couchbase Capella account to make a natural language request. + + This parameter is available in clusters running Couchbase Server 8.0 and later. + + To use this parameter, you must also specify the `natural`, `natural_cred`, and `natural_orgid` parameters. + If you don't specify all four parameters, the Query Service returns an error. + x-has-example: true + example: travel-sample, travel-sample.inventory.airline, airline + natural_output: + type: string + x-desc-name: natural_output + x-desc-status: Couchbase Server 8.0 + description: |- + Specifies the required output for a natural language request. + + * `sql` — + The output is a SQL++ statement. + + * `jsudf` — + The output is a `CREATE FUNCTION` statement which you can use to generate a SQL++ managed JavaScript user-defined function. + + * `ftssql` — + The output is a SQL++ statement which can use a Flex index, if available. + + Natural language requests use the Couchbase Capella iQ service as a backend. + You must have a Couchbase Capella account to make a natural language request. + + This parameter is available in clusters running Couchbase Server 8.0 and later. + x-has-default: true + default: sql + enum: ["sql", "jsudf", "ftssql"] numatrs: type: integer format: int32 @@ -582,7 +662,7 @@ components: type: string x-desc-name: prepared description: |- - _Required_ if `statement` not provided. + _Required_ if `statement` or `natural` not provided. The name of the prepared SQL++ statement to be executed. Refer to [EXECUTE][execute] for examples. @@ -840,7 +920,7 @@ components: type: string x-desc-name: statement description: |- - _Required_ if `prepared` not provided. + _Required_ if `prepared` or `natural` not provided. Any valid SQL++ statement for a POST request, or a read-only SQL++ statement (SELECT, EXPLAIN) for a GET request. @@ -1105,6 +1185,12 @@ components: clientContextID: type: string description: The client context ID of the request, if one was supplied — see `client_context_id` in [Request Parameters](#Request). + generated_statement: + type: string + description: |- + The generated statement, if the request was a natural language prompt. + x-has-example: true + example: SELECT country, COUNT(*) AS `airline_count` FROM `travel-sample`.`inventory`.`airline` AS `a` GROUP BY country signature: type: object description: |- @@ -1208,9 +1294,11 @@ components: properties: elapsedTime: type: string + format: duration description: The total time taken for the request, that is the time from when the request was received until the results were returned. executionTime: type: string + format: duration description: The time taken for the execution of the request, that is the time from when query execution started until the results were returned. resultCount: type: integer @@ -1220,6 +1308,12 @@ components: type: integer format: unsigned description: The total number of bytes in the results. + naturalLanguageProcessingTime: + type: string + format: duration + description: |- + The total time spent processing a natural language request. + The cumulation of authentication, collecting schema, and time waiting for the response from the LLM, or wait time for the natural language request to be serviced. mutationCount: type: integer description: The number of mutations that were made during the request. From e12a81d46a989dcae79bc3904a25ad1184e3fbe4 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Mon, 1 Sep 2025 17:11:52 +0100 Subject: [PATCH 19/25] DOC-13111: Mask parameter values in named parameters (#181) --- .../attachments/_query-service.yaml | 30 +++++++++++-------- 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/docs/modules/n1ql-rest-query/attachments/_query-service.yaml b/docs/modules/n1ql-rest-query/attachments/_query-service.yaml index 2643a52c..b7039afc 100644 --- a/docs/modules/n1ql-rest-query/attachments/_query-service.yaml +++ b/docs/modules/n1ql-rest-query/attachments/_query-service.yaml @@ -526,7 +526,7 @@ components: To use this parameter, you must also specify the `natural`, `natural_orgid`, and `natural_context` parameters. If you don't specify all four parameters, the Query Service returns an error. x-has-example: true - example: : + example: username:password natural_orgid: type: string format: uuid @@ -553,7 +553,7 @@ components: The parameter may contain up to four paths, separated by commas. Spaces are allowed. Each path may be: - + * A full path, in the form `bucket.scope.collection` or `namespace:bucket.scope.collection`. * A path prefix, in the form `namespace:bucket` or `bucket`, to specify the default collection in the default scope. @@ -1152,7 +1152,12 @@ components: 1. The `$` character. In databases running Couchbase Server 7.6.0 and later, this may be the `$` character or the `@` character. 2. An identifier that specifies the name of the parameter. - This must start with an alpha character, followed by one or more alphanumeric characters. + This starts with an optional underscore (`_`), followed by an alpha character, followed by one or more alphanumeric characters, and ends with an optional underscore (`_`). + + If the named parameter contains sensitive information, start and end the name of the parameter (after the initial `$` or `@`) with an underscore (`_`). + This masks the parameter value in the active requests catalog, the completed requests catalog, the response `controls` section, the cbq shell file history, and the query logs. + When masked, a string parameter value is replaced by asterisks (`*`); other parameter values are replaced by `null`. + Parameter masking is available in clusters running Couchbase Server 7.6.8 and later. The value of the named parameter can be any JSON value. @@ -1187,6 +1192,7 @@ components: description: The client context ID of the request, if one was supplied — see `client_context_id` in [Request Parameters](#Request). generated_statement: type: string + x-desc-status: Couchbase Server 8.0 description: |- The generated statement, if the request was a natural language prompt. x-has-example: true @@ -1346,12 +1352,12 @@ components: description: > The memory session size for the request, in bytes. - - Each request has a dedicated memory session. + + Each request has a dedicated memory session. When a query requires a document or value, memory is allocated from this session based on the size of the document or value. - Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. + Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. + - This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. Controls: @@ -1519,7 +1525,7 @@ components: description: | The total sum of [kernTime](#kern_time) across all operators. x-has-example: true - example: "1.201307s" + example: "1.201307s" cpuTime: type: string format: duration @@ -1532,13 +1538,13 @@ components: items: type: string description: | - An array of text phrases that provide a basic analysis of the request execution. + An array of text phrases that provide a basic analysis of the request execution. These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. x-has-example: true - example: - [ + example: + [ "High IO time", - "High primary scan document count" + "High primary scan document count" ] securitySchemes: From 0d5713abcb91e2b9ba9d502a27de56aa06771945 Mon Sep 17 00:00:00 2001 From: Simon Dew Date: Wed, 10 Sep 2025 16:18:05 +0100 Subject: [PATCH 20/25] DOC-13516: Update Morpheus REST API builds (#182) * Update remote gradle builds for Morpheus * Fix template for additional properties name * Driveby: Analytics additional property names * Build output documentation --- .../attachments/analytics-admin.yaml | 4 +- .../analytics-rest-admin/pages/index.adoc | 6 +-- .../attachments/analytics-config.yaml | 2 +- .../analytics-rest-config/pages/index.adoc | 2 +- .../attachments/analytics-links.yaml | 2 +- .../analytics-rest-links/pages/index.adoc | 2 +- .../attachments/analytics-service.yaml | 3 +- .../analytics-rest-service/pages/index.adoc | 4 +- .../attachments/analytics-settings.yaml | 2 +- .../analytics-rest-settings/pages/index.adoc | 2 +- .../attachments/eventing.yaml | 2 +- .../eventing-rest-api/pages/index.adoc | 2 +- .../fts-rest-advanced/search-advanced.gradle | 2 +- .../fts-rest-indexing/search-index.gradle | 2 +- .../fts-rest-manage/search-manage.gradle | 2 +- .../fts-rest-nodes/search-nodes.gradle | 2 +- .../fts-rest-query/search-query.gradle | 2 +- .../fts-rest-stats/search-stats.gradle | 2 +- .../index-rest-stats/attachments/indexes.yaml | 2 +- .../modules/index-rest-stats/pages/index.adoc | 2 +- docs/modules/n1ql-rest-admin/admin.gradle | 2 +- .../n1ql-rest-admin/attachments/_admin.yaml | 2 +- docs/modules/n1ql-rest-admin/pages/index.adoc | 43 +++++++++++++++++-- .../attachments/_functions.yaml | 2 +- .../n1ql-rest-functions/functions.gradle | 2 +- .../n1ql-rest-functions/pages/index.adoc | 2 +- docs/modules/n1ql-rest-query/pages/index.adoc | 2 +- .../n1ql-rest-query/query-service.gradle | 2 +- .../attachments/_query-settings.yaml | 2 +- .../n1ql-rest-settings/query-settings.gradle | 2 +- docs/preview/HEAD.yml | 8 ++-- templates/model.mustache | 2 +- 32 files changed, 78 insertions(+), 42 deletions(-) diff --git a/docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml b/docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml index 5fe8dd37..ffd2ec61 100644 --- a/docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml +++ b/docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Analytics Administration REST APIs - version: capella + version: "8.0" description: | The Analytics Administration REST APIs are provided by the Analytics service. These APIs enables you to manage and monitor the Analytics service. @@ -606,6 +606,7 @@ components: landmark: 7 MutationsColl: + x-additionalPropertiesName: scope type: object description: > An object containing one or more collection properties, one for each Analytics collection in the Analytics scope. @@ -615,6 +616,7 @@ components: For example, `` `travel-sample`.inventory ``. title: Collections additionalProperties: + x-additionalPropertiesName: collection type: integer description: > The number of mutations in the DCP queue that have not yet been ingested. diff --git a/docs/modules/analytics-rest-admin/pages/index.adoc b/docs/modules/analytics-rest-admin/pages/index.adoc index 488cf098..f35d47f8 100644 --- a/docs/modules/analytics-rest-admin/pages/index.adoc +++ b/docs/modules/analytics-rest-admin/pages/index.adoc @@ -33,7 +33,7 @@ These APIs enables you to manage and monitor the Analytics service. [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information @@ -2016,7 +2016,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ - +** + _additional + property_ a¦ @@ -2081,7 +2081,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ - +** + _additional + property_ a¦ diff --git a/docs/modules/analytics-rest-config/attachments/analytics-config.yaml b/docs/modules/analytics-rest-config/attachments/analytics-config.yaml index 2202b939..117c4c06 100644 --- a/docs/modules/analytics-rest-config/attachments/analytics-config.yaml +++ b/docs/modules/analytics-rest-config/attachments/analytics-config.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Analytics Configuration REST API - version: capella + version: "8.0" description: | The Analytics Configuration REST API is provided by the Analytics service. This API enables you to configure Analytics nodes and clusters. diff --git a/docs/modules/analytics-rest-config/pages/index.adoc b/docs/modules/analytics-rest-config/pages/index.adoc index 973b43be..969a2e01 100644 --- a/docs/modules/analytics-rest-config/pages/index.adoc +++ b/docs/modules/analytics-rest-config/pages/index.adoc @@ -33,7 +33,7 @@ This API enables you to configure Analytics nodes and clusters. [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information diff --git a/docs/modules/analytics-rest-links/attachments/analytics-links.yaml b/docs/modules/analytics-rest-links/attachments/analytics-links.yaml index e12bf1ee..dc9d851a 100644 --- a/docs/modules/analytics-rest-links/attachments/analytics-links.yaml +++ b/docs/modules/analytics-rest-links/attachments/analytics-links.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Analytics Links REST API - version: capella + version: "8.0" description: |- The Analytics Links REST API is provided by the Analytics service. This API enables you to manage the links to remote Couchbase clusters and external data sources. diff --git a/docs/modules/analytics-rest-links/pages/index.adoc b/docs/modules/analytics-rest-links/pages/index.adoc index 17152706..ffbc8a7d 100644 --- a/docs/modules/analytics-rest-links/pages/index.adoc +++ b/docs/modules/analytics-rest-links/pages/index.adoc @@ -32,7 +32,7 @@ This API enables you to manage the links to remote Couchbase clusters and extern [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information diff --git a/docs/modules/analytics-rest-service/attachments/analytics-service.yaml b/docs/modules/analytics-rest-service/attachments/analytics-service.yaml index 622e9006..2a7ea9bd 100644 --- a/docs/modules/analytics-rest-service/attachments/analytics-service.yaml +++ b/docs/modules/analytics-rest-service/attachments/analytics-service.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Analytics Service REST API - version: capella + version: "8.0" description: | The Analytics Service REST API is provided by the Analytics service. This API enables you to run Analytics queries and set request-level parameters. @@ -205,6 +205,7 @@ components: description: An array of positional parameter values. items: {} additionalProperties: + x-additionalPropertiesName: '$identifier' description: A named parameter value. # For the Query Parameters page diff --git a/docs/modules/analytics-rest-service/pages/index.adoc b/docs/modules/analytics-rest-service/pages/index.adoc index 439d8ec4..6fed3ddb 100644 --- a/docs/modules/analytics-rest-service/pages/index.adoc +++ b/docs/modules/analytics-rest-service/pages/index.adoc @@ -33,7 +33,7 @@ This API enables you to run Analytics queries and set request-level parameters. [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information @@ -1271,7 +1271,7 @@ a¦ Any Type array a¦ - +*<$identifier>* + _additional + property_ a¦ diff --git a/docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml b/docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml index 7e66fcb1..56b9786a 100644 --- a/docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml +++ b/docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Analytics Settings REST API - version: capella + version: "8.0" description: | The Analytics Settings REST API is provided by the Analytics service. This API enables you to view or set cluster-level Analytics settings. diff --git a/docs/modules/analytics-rest-settings/pages/index.adoc b/docs/modules/analytics-rest-settings/pages/index.adoc index 73619dfc..52052bb2 100644 --- a/docs/modules/analytics-rest-settings/pages/index.adoc +++ b/docs/modules/analytics-rest-settings/pages/index.adoc @@ -33,7 +33,7 @@ This API enables you to view or set cluster-level Analytics settings. [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information diff --git a/docs/modules/eventing-rest-api/attachments/eventing.yaml b/docs/modules/eventing-rest-api/attachments/eventing.yaml index 78a0796a..8fd0671e 100644 --- a/docs/modules/eventing-rest-api/attachments/eventing.yaml +++ b/docs/modules/eventing-rest-api/attachments/eventing.yaml @@ -891,7 +891,7 @@ components: x-has-default: true description: |- Enables the Eventing service debugger. - For details, see [Debugging and Diagnosability](/server/8.0/eventing/eventing-debugging-and-diagnosability.html). + For details, see [Debugging and Diagnosability](/cloud/eventing/eventing-debugging-and-diagnosability.html). cursor_limit: type: integer default: 5 diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index 4ae39ef0..0c829619 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -8636,7 +8636,7 @@ a¦ [markdown] -- Enables the Eventing service debugger. -For details, see [Debugging and Diagnosability](/server/8.0/eventing/eventing-debugging-and-diagnosability.html). +For details, see [Debugging and Diagnosability](/cloud/eventing/eventing-debugging-and-diagnosability.html). -- [%hardbreaks] diff --git a/docs/modules/fts-rest-advanced/search-advanced.gradle b/docs/modules/fts-rest-advanced/search-advanced.gradle index 9a71a90f..ba93d58f 100644 --- a/docs/modules/fts-rest-advanced/search-advanced.gradle +++ b/docs/modules/fts-rest-advanced/search-advanced.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/advanced/advanced.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/morpheus/docs/spec/advanced/advanced.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-advanced/pages" templateDir = "${rootDir}/templates" gitRepoId = "cbft" diff --git a/docs/modules/fts-rest-indexing/search-index.gradle b/docs/modules/fts-rest-indexing/search-index.gradle index 787c91d2..d1393807 100644 --- a/docs/modules/fts-rest-indexing/search-index.gradle +++ b/docs/modules/fts-rest-indexing/search-index.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/index/index.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/morpheus/docs/spec/index/index.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-indexing/pages" templateDir = "${rootDir}/templates" gitRepoId = "cbft" diff --git a/docs/modules/fts-rest-manage/search-manage.gradle b/docs/modules/fts-rest-manage/search-manage.gradle index 1aa16e38..bfabdc60 100644 --- a/docs/modules/fts-rest-manage/search-manage.gradle +++ b/docs/modules/fts-rest-manage/search-manage.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/manage/manage.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/morpheus/docs/spec/manage/manage.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-manage/pages" templateDir = "${rootDir}/templates" gitRepoId = "cbft" diff --git a/docs/modules/fts-rest-nodes/search-nodes.gradle b/docs/modules/fts-rest-nodes/search-nodes.gradle index ea78bcfb..0c35536b 100644 --- a/docs/modules/fts-rest-nodes/search-nodes.gradle +++ b/docs/modules/fts-rest-nodes/search-nodes.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/nodes/nodes.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/morpheus/docs/spec/nodes/nodes.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-nodes/pages" templateDir = "${rootDir}/templates" gitRepoId = "cbft" diff --git a/docs/modules/fts-rest-query/search-query.gradle b/docs/modules/fts-rest-query/search-query.gradle index 81bfe663..5b7e7c35 100644 --- a/docs/modules/fts-rest-query/search-query.gradle +++ b/docs/modules/fts-rest-query/search-query.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/query/query.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/morpheus/docs/spec/query/query.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-query/pages" templateDir = "${rootDir}/templates" gitRepoId = "cbft" diff --git a/docs/modules/fts-rest-stats/search-stats.gradle b/docs/modules/fts-rest-stats/search-stats.gradle index 1eea07f4..7e72a7ac 100644 --- a/docs/modules/fts-rest-stats/search-stats.gradle +++ b/docs/modules/fts-rest-stats/search-stats.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/master/docs/spec/stats/stats.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/cbft/refs/heads/morpheus/docs/spec/stats/stats.yaml" outputDir = "${rootDir}/docs/modules/fts-rest-stats/pages" templateDir = "${rootDir}/templates" gitRepoId = "cbft" diff --git a/docs/modules/index-rest-stats/attachments/indexes.yaml b/docs/modules/index-rest-stats/attachments/indexes.yaml index 3fb268b9..a4c2bce4 100644 --- a/docs/modules/index-rest-stats/attachments/indexes.yaml +++ b/docs/modules/index-rest-stats/attachments/indexes.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Index Statistics REST API - version: capella + version: "8.0" description: |- The Index Statistics REST API is provided by the Index service. This API enables you to get Index service statistics. diff --git a/docs/modules/index-rest-stats/pages/index.adoc b/docs/modules/index-rest-stats/pages/index.adoc index 86895d46..90d883fd 100644 --- a/docs/modules/index-rest-stats/pages/index.adoc +++ b/docs/modules/index-rest-stats/pages/index.adoc @@ -32,7 +32,7 @@ This API enables you to get Index service statistics. [discrete#version] = Version information [%hardbreaks] -__Version__ : capella +__Version__ : 8.0 [discrete#host] = Host information diff --git a/docs/modules/n1ql-rest-admin/admin.gradle b/docs/modules/n1ql-rest-admin/admin.gradle index 8c1a64dc..4c571e99 100644 --- a/docs/modules/n1ql-rest-admin/admin.gradle +++ b/docs/modules/n1ql-rest-admin/admin.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/admin/admin.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/admin/admin.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-admin/pages" templateDir = "${rootDir}/templates" gitRepoId = "query" diff --git a/docs/modules/n1ql-rest-admin/attachments/_admin.yaml b/docs/modules/n1ql-rest-admin/attachments/_admin.yaml index 69f592a9..4efe04d1 100644 --- a/docs/modules/n1ql-rest-admin/attachments/_admin.yaml +++ b/docs/modules/n1ql-rest-admin/attachments/_admin.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Query Admin REST API - version: capella + version: "8.0" description: |- The Query Admin REST API is a secondary API provided by the Query service. This API enables you to retrieve statistics about the clusters and nodes running the Query service; view or specify node-level settings; and view or delete requests. diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 23fcb5be..3a27b163 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -5160,14 +5160,49 @@ endif::collapse-models[] .icon:bars[fw] Composite Schema {blank} -One of the following: +//tag::Logging_Parameters_Plan[] -* xref:Logging_Parameters_Plan_Pairs[] +ifdef::model-descriptions[] +//tag::desc-Logging_Parameters_Plan[] +An object, or an array of objects, containing one or more field:value pairs to match against the query plan. +Each pair describes a field in the query plan and the value it must have. +All completed queries where the specified field:value pairs are found in the plan are logged. +//end::desc-Logging_Parameters_Plan[] +endif::model-descriptions[] +[cols="25,55,20",separator=¦] +|=== +¦ One{nbsp}of{nbsp}... ¦ ¦ Schema + +a¦ +a¦ -* xref:Logging_Parameters_Plan_Pairs[] +[markdown] +-- +include::index.adoc[tag=desc-Logging_Parameters_Plan_Pairs, opts=optional] +-- + +[%hardbreaks] +{blank} +a¦ xref:Logging_Parameters_Plan_Pairs[] + + +a¦ _or_ +a¦ + +[markdown] +-- +An array of objects, each containing one or more field:value pairs. +-- + +[%hardbreaks] +{blank} +a¦ xref:Logging_Parameters_Plan_Pairs[] array +|=== + +//end::Logging_Parameters_Plan[] // markup not found, no include::{specDir}definitions/Logging_Parameters_Plan/definition-end.adoc[opts=optional] @@ -5210,7 +5245,7 @@ endif::model-descriptions[] ¦ Property ¦ ¦ Schema a¦ -*{lt}field{gt}* + +** + _additional + property_ a¦ diff --git a/docs/modules/n1ql-rest-functions/attachments/_functions.yaml b/docs/modules/n1ql-rest-functions/attachments/_functions.yaml index 5f4cac26..553c65cf 100644 --- a/docs/modules/n1ql-rest-functions/attachments/_functions.yaml +++ b/docs/modules/n1ql-rest-functions/attachments/_functions.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Query Functions REST API - version: capella + version: "8.0" description: |- The Query Functions REST API is a secondary API provided by the Query service. This API enables you to manage the JavaScript libraries and objects that are used to create SQL++ user-defined functions. diff --git a/docs/modules/n1ql-rest-functions/functions.gradle b/docs/modules/n1ql-rest-functions/functions.gradle index 6f3ffc40..a29e5999 100644 --- a/docs/modules/n1ql-rest-functions/functions.gradle +++ b/docs/modules/n1ql-rest-functions/functions.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/functions/functions.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/functions/functions.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-functions/pages" templateDir = "${rootDir}/templates" gitRepoId = "query" diff --git a/docs/modules/n1ql-rest-functions/pages/index.adoc b/docs/modules/n1ql-rest-functions/pages/index.adoc index ea17243b..e8d305e3 100644 --- a/docs/modules/n1ql-rest-functions/pages/index.adoc +++ b/docs/modules/n1ql-rest-functions/pages/index.adoc @@ -1206,7 +1206,7 @@ endif::collapse-models[] ¦ Property ¦ ¦ Schema a¦ -*{lt}library{gt}* + +** + _additional + property_ a¦ diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 216c1157..d433d4ae 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -2897,7 +2897,7 @@ a¦ String a¦ [#identifier] -*{lt}$identifier{gt}* + +*<$identifier>* + _additional + property_ a¦ diff --git a/docs/modules/n1ql-rest-query/query-service.gradle b/docs/modules/n1ql-rest-query/query-service.gradle index 8b49e6f9..101f1e3b 100644 --- a/docs/modules/n1ql-rest-query/query-service.gradle +++ b/docs/modules/n1ql-rest-query/query-service.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/service/service.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/service/service.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-query/pages" templateDir = "${rootDir}/templates" gitRepoId = "query" diff --git a/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml b/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml index 879a723c..de82c175 100644 --- a/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml +++ b/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: Query Settings REST API - version: capella + version: "8.0" description: |- The Query Settings REST API is provided by the Query service. This API enables you to view or specify cluster-level Query settings. diff --git a/docs/modules/n1ql-rest-settings/query-settings.gradle b/docs/modules/n1ql-rest-settings/query-settings.gradle index 7f934c60..a0bda8d3 100644 --- a/docs/modules/n1ql-rest-settings/query-settings.gradle +++ b/docs/modules/n1ql-rest-settings/query-settings.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/master/docs/spec/settings/settings.yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/settings/settings.yaml" outputDir = "${rootDir}/docs/modules/n1ql-rest-settings/pages" templateDir = "${rootDir}/templates" gitRepoId = "query" diff --git a/docs/preview/HEAD.yml b/docs/preview/HEAD.yml index ec179b30..b6de9dcb 100644 --- a/docs/preview/HEAD.yml +++ b/docs/preview/HEAD.yml @@ -1,7 +1,5 @@ sources: - docs-server: - branches: release/8.0 - docs-analytics: - branches: release/8.0 + docs-capella: + branches: main docs-devex: - branches: release/8.0 \ No newline at end of file + branches: capella \ No newline at end of file diff --git a/templates/model.mustache b/templates/model.mustache index c0d17631..49114e8a 100644 --- a/templates/model.mustache +++ b/templates/model.mustache @@ -30,7 +30,7 @@ a¦ {{>schemas}} {{#additionalProperties}} {{! ADDITIONAL PROPERTY NAME }} a¦ {{#vendorExtensions}}{{#x-desc-name}}[#{{this}}]{{/x-desc-name}} -{{#x-additionalPropertiesName}}*{lt}{{this}}{gt}* +{{/x-additionalPropertiesName}}{{/vendorExtensions}} +{{#x-additionalPropertiesName}}*<{{this}}>* +{{/x-additionalPropertiesName}}{{/vendorExtensions}} _additional + property_ {{! ADDITIONAL PROPERTY DESCRIPTION }} From a20945ec92a98ced209d2dabc0eedbb96e223ab1 Mon Sep 17 00:00:00 2001 From: Simon Dew Date: Wed, 10 Sep 2025 17:23:31 +0100 Subject: [PATCH 21/25] DOC-13542: Update Capella REST API builds for Morpheus - [Template] Add tags to additional descriptions - Build output documentation - TEMP: Add preview config --- docs/modules/n1ql-rest-admin/pages/index.adoc | 56 +++++++++++++++++++ docs/modules/n1ql-rest-query/pages/index.adoc | 28 ++++++++++ .../n1ql-rest-settings/pages/index.adoc | 44 +++++++++++++++ .../AV-91970-8-0-docs-uptake-capella.yml | 5 ++ templates/property.mustache | 2 + 5 files changed, 135 insertions(+) create mode 100644 docs/preview/AV-91970-8-0-docs-uptake-capella.yml diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 3a27b163..90aaa989 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -4988,9 +4988,11 @@ endif::alt-markdown-links[] The opaque ID or context provided by the client. If specified, all completed requests with this client context ID are logged. +// tag::desc-more[] Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. [client_context_id]: ../n1ql-rest-query/index.html#client_context_id +// end::desc-more[] -- [%hardbreaks] @@ -5718,9 +5720,11 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] The opaque ID or context provided by the client. +// tag::desc-more[] Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. [client_context_id]: ../n1ql-rest-query/index.html#client_context_id +// end::desc-more[] -- [%hardbreaks] @@ -6202,10 +6206,12 @@ If any part of the path contains a special character, that part of the path must [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [request-level][atrcollection_req] `atrcollection` parameter specifies this property per request. If a request does not include this parameter, the node-level `atrcollection` setting will be used. [atrcollection_req]: ../n1ql-rest-query/index.html#atrcollection_req +// end::desc-more[] -- [%hardbreaks] @@ -6249,10 +6255,12 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. +// tag::desc-more[] The [cluster-level][queryCleanupClientAttempts] `queryCleanupClientAttempts` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupClientAttempts]: ../n1ql-rest-settings/index.html#queryCleanupClientAttempts +// end::desc-more[] -- [%hardbreaks] @@ -6275,10 +6283,12 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. +// tag::desc-more[] The [cluster-level][queryCleanupLostAttempts] `queryCleanupLostAttempts` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupLostAttempts]: ../n1ql-rest-settings/index.html#queryCleanupLostAttempts +// end::desc-more[] -- [%hardbreaks] @@ -6315,10 +6325,12 @@ Valid units are: [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [cluster-level][queryCleanupWindow] `queryCleanupWindow` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCleanupWindow]: ../n1ql-rest-settings/index.html#queryCleanupWindow +// end::desc-more[] -- [%hardbreaks] @@ -6363,10 +6375,12 @@ Refer to [Configure Completed Requests][sys-completed-config] for more informati [sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +// tag::desc-more[] The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCompletedLimit]: ../n1ql-rest-settings/index.html#queryCompletedLimit +// end::desc-more[] -- [%hardbreaks] @@ -6397,10 +6411,12 @@ Refer to [Configure Completed Requests][sys-completed-config] for more informati [sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +// tag::desc-more[] The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCompletedMaxPlanSize]: ../n1ql-rest-settings/index.html#queryCompletedMaxPlanSize +// end::desc-more[] -- [%hardbreaks] @@ -6456,10 +6472,12 @@ Refer to [Configure Completed Requests][sys-completed-config] for more informati [sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +// tag::desc-more[] The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryCompletedThreshold]: ../n1ql-rest-settings/index.html#queryCompletedThreshold +// end::desc-more[] -- [%hardbreaks] @@ -6486,10 +6504,12 @@ When set to `true`, the query response document includes a controls section with NOTE: If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. +// tag::desc-more[] The [request-level][controls_req] `controls` parameter specifies this property per request. If a request does not include this parameter, the node-level `controls` setting will be used. [controls_req]: ../n1ql-rest-query/index.html#controls_req +// end::desc-more[] -- [%hardbreaks] @@ -6628,10 +6648,12 @@ Major items, like crashes. * `NONE` — Doesn't write anything. +// tag::desc-more[] The [cluster-level][queryLogLevel] `queryLogLevel` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryLogLevel]: ../n1ql-rest-settings/index.html#queryLogLevel +// end::desc-more[] -- [%hardbreaks] @@ -6682,6 +6704,7 @@ Refer to [Max Parallelism][max-parallelism] for more information. [max-parallelism]: ../n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism +// tag::desc-more[] The [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6692,6 +6715,7 @@ NOTE: To enable queries to run in parallel, you must specify the cluster-level ` [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req +// end::desc-more[] -- [%hardbreaks] @@ -6724,6 +6748,7 @@ It does not take into account any other memory that might be used to process a r Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). +// tag::desc-more[] The [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6732,6 +6757,7 @@ If a request includes this parameter, it will be capped by the node-level `memor [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req +// end::desc-more[] -- [%hardbreaks] @@ -6794,10 +6820,12 @@ SQL++ feature control. This setting is provided for technical support only. The value may be an integer, or a string representing a hexadecimal number. +// tag::desc-more[] The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryN1QLFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1QLFeatCtrl +// end::desc-more[] -- [%hardbreaks] @@ -6831,10 +6859,12 @@ To do this, the Query service calculates the difference between the total system - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. +// tag::desc-more[] The [cluster-level][queryNodeQuota] `queryNodeQuota` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNodeQuota]: ../n1ql-rest-settings/index.html#queryNodeQuota +// end::desc-more[] -- [%hardbreaks] @@ -6857,10 +6887,12 @@ endif::alt-markdown-links[] The percentage of the `node-quota` that is dedicated to tracked value content memory across all active requests on this node. (The `memory-quota` setting specifies the maximum amount of document memory an individual request may use on this node.) +// tag::desc-more[] The [cluster-level][queryNodeQuotaValPercent] `queryNodeQuotaValPercent` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNodeQuotaValPercent]: ../n1ql-rest-settings/index.html#queryNodeQuotaValPercent +// end::desc-more[] -- [%hardbreaks] @@ -6891,10 +6923,12 @@ The number of CPUs can never be greater than the number of logical CPUs. In Community Edition, the number of allowed CPUs cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed CPUs. +// tag::desc-more[] The [cluster-level][queryNumCpus] `queryNumCpus` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryNumCpus]: ../n1ql-rest-settings/index.html#queryNumCpus +// end::desc-more[] -- [%hardbreaks] @@ -6919,6 +6953,7 @@ Specifies the total number of [active transaction records][additional-storage-us [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6927,6 +6962,7 @@ The minimum of that and the node-level `numatrs` setting is applied. [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req +// end::desc-more[] -- [%hardbreaks] @@ -6948,6 +6984,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Controls the number of items execution operators can batch for Fetch from the KV. +// tag::desc-more[] The [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6956,6 +6993,7 @@ The minimum of that and the node-level `pipeline-batch` setting is applied. [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req +// end::desc-more[] -- [%hardbreaks] @@ -6979,6 +7017,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Maximum number of items each execution operator can buffer between various operators. +// tag::desc-more[] The [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -6987,6 +7026,7 @@ The minimum of that and the node-level `pipeline-cap` setting is applied. [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req +// end::desc-more[] -- [%hardbreaks] @@ -7027,10 +7067,12 @@ endif::alt-markdown-links[] Maximum number of prepared statements in the cache. When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. +// tag::desc-more[] The [cluster-level][queryPreparedLimit] `queryPreparedLimit` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [queryPreparedLimit]: ../n1ql-rest-settings/index.html#queryPreparedLimit +// end::desc-more[] -- [%hardbreaks] @@ -7053,10 +7095,12 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies whether query results are returned in pretty format. +// tag::desc-more[] The [request-level][pretty_req] `pretty` parameter specifies this property per request. If a request does not include this parameter, the node-level setting is used, which defaults to `false`. [pretty_req]: ../n1ql-rest-query/index.html#pretty_req +// end::desc-more[] -- [%hardbreaks] @@ -7094,10 +7138,12 @@ Refer to [Monitoring and Profiling Details][monitor-profile-details] for more in [monitor-profile-details]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details +// tag::desc-more[] The [request-level][profile_req] `profile` parameter specifies this property per request. If a request does not include this parameter, the node-level `profile` setting will be used. [profile_req]: ../n1ql-rest-query/index.html#profile_req +// end::desc-more[] -- [%hardbreaks] @@ -7143,6 +7189,7 @@ This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. +// tag::desc-more[] The [cluster-level][queryScanCap] `queryScanCap` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -7151,6 +7198,7 @@ The minimum of that and the node-level `scan-cap` setting is applied. [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req +// end::desc-more[] -- [%hardbreaks] @@ -7198,6 +7246,7 @@ It must not be delimited by quotes, and must not include a unit. Specify `0` (the default value) or a negative integer to disable. When disabled, no timeout is applied and the request runs for however long it takes. +// tag::desc-more[] The [cluster-level][queryTimeout] `queryTimeout` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -7206,6 +7255,7 @@ The minimum of that and the node-level `timeout` setting is applied. [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout [timeout_req]: ../n1ql-rest-query/index.html#timeout_req +// end::desc-more[] -- [%hardbreaks] @@ -7240,6 +7290,7 @@ When disabled, no timeout is applied and the transaction runs for however long i [tximplicit]: ../n1ql-rest-query/index.html#tximplicit +// tag::desc-more[] The [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -7248,6 +7299,7 @@ The minimum of that and the node-level `txtimeout` setting is applied. [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req +// end::desc-more[] -- [%hardbreaks] @@ -7271,6 +7323,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies whether the cost-based optimizer is enabled. +// tag::desc-more[] The [cluster-level][queryUseCBO] `queryUseCBO` setting specifies this property for the whole cluster. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -7279,6 +7332,7 @@ If a request does not include this parameter, the node-level setting is used, wh [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req +// end::desc-more[] -- [%hardbreaks] @@ -7317,6 +7371,7 @@ Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. +// tag::desc-more[] The [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. @@ -7326,6 +7381,7 @@ If the request-level parameter and the node-level setting are both `unset`, read [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req +// end::desc-more[] -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index d433d4ae..c107651b 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -1626,10 +1626,12 @@ If any part of the path contains a special character, that part of the path must [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [node-level][atrcollection-srv] `atrcollection` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. [atrcollection-srv]: ../n1ql-rest-admin/index.html#atrcollection-srv +// end::desc-more[] -- [%hardbreaks] @@ -1716,10 +1718,12 @@ When set to `true`, the query response document includes a controls section with If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. +// tag::desc-more[] The [node-level][controls-srv] `controls` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. [controls-srv]: ../n1ql-rest-admin/index.html#controls-srv +// end::desc-more[] -- [%hardbreaks] @@ -1882,6 +1886,7 @@ Specifies the maximum parallelism for the query. The default value is the same as the number of partitions of the index selected for the query. +// tag::desc-more[] The [node-level][max-parallelism-srv] `max-parallelism` setting specifies the ceiling for this parameter for a single node. If the request-level parameter is zero or negative, the parallelism for the query is set to the node-level setting. If the request-level parameter is greater than zero and less than the node-level setting, the request-level parameter overrides the node-level setting. @@ -1894,6 +1899,7 @@ To enable queries to run in parallel, you must specify the cluster-level `queryM [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism +// end::desc-more[] -- [%hardbreaks] @@ -1925,6 +1931,7 @@ It does not take into account any other memory that might be used to process a r Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). +// tag::desc-more[] The [node-level][memory-quota-srv] `memory-quota` setting specifies the ceiling for this parameter for a single node. If the node-level setting is zero (the default), the request-level parameter overrides the node-level setting. If the node-level setting is greater than zero, the request-level parameter is capped by the node-level setting. @@ -1934,6 +1941,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota +// end::desc-more[] -- [%hardbreaks] @@ -2139,6 +2147,7 @@ Must be a positive integer. [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [node-level][numatrs-srv] `numatrs` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. @@ -2147,6 +2156,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs +// end::desc-more[] -- [%hardbreaks] @@ -2170,6 +2180,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Controls the number of items execution operators can batch for Fetch from the KV. +// tag::desc-more[] The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. @@ -2178,6 +2189,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch +// end::desc-more[] -- [%hardbreaks] @@ -2200,6 +2212,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Maximum number of items each execution operator can buffer between various operators. +// tag::desc-more[] The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. @@ -2208,6 +2221,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap +// end::desc-more[] -- [%hardbreaks] @@ -2276,10 +2290,12 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies the query results returned in pretty format. +// tag::desc-more[] The [node-level][pretty-srv] `pretty` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. [pretty-srv]: ../n1ql-rest-admin/index.html#pretty-srv +// end::desc-more[] -- [%hardbreaks] @@ -2314,10 +2330,12 @@ This information will be included in the `system:active_requests` and `system:co If `profile` is not set as one of the above values, then the profile setting does not change. +// tag::desc-more[] The [node-level][profile-srv] `profile` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. [profile-srv]: ../n1ql-rest-admin/index.html#profile-srv +// end::desc-more[] -- [%hardbreaks] @@ -2394,6 +2412,7 @@ This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. +// tag::desc-more[] The [node-level][scan-cap-srv] `scan-cap` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. @@ -2402,6 +2421,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap +// end::desc-more[] -- [%hardbreaks] @@ -2640,6 +2660,7 @@ When disabled, no timeout is applied and the request runs for however long it ta If `tximplicit` or `txid` is set, this parameter is ignored. The request inherits the remaining time of the transaction as timeout. +// tag::desc-more[] The [node-level][timeout-srv] `timeout` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. However, if the node-level setting is greater than 0, the timeout for the query is limited to the node-level setting. @@ -2649,6 +2670,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout +// end::desc-more[] -- [%hardbreaks] @@ -2773,6 +2795,7 @@ When disabled, the request-level timeout is set to the default. The default is `"15s"` for cbq files or scripts, `"2m"` for interactive cbq sessions or redirected input. +// tag::desc-more[] The [node-level][txtimeout-srv] `txtimeout` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. However, if the node-level setting is greater than 0, the transaction timeout for the query is limited to the node-level setting. @@ -2782,6 +2805,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout +// end::desc-more[] -- [%hardbreaks] @@ -2804,6 +2828,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies whether the cost-based optimizer is enabled. +// tag::desc-more[] The [node-level][use-cbo-srv] `use-cbo` setting specifies the default for this parameter for a single node. The request-level parameter overrides the node-level setting. @@ -2812,6 +2837,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO +// end::desc-more[] -- [%hardbreaks] @@ -2877,6 +2903,7 @@ Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. +// tag::desc-more[] The [node-level][use-replica-srv] `use-replica` setting specifies the default for this property for a single node. The request-level parameter usually overrides the node-level setting. However, when the node-level setting is `off`, the request-level parameter cannot enable the property. @@ -2886,6 +2913,7 @@ When you change the cluster-level setting, the node-level setting is overwritten [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica +// end::desc-more[] -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index 0f6a7d07..59dba392 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -1025,10 +1025,12 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. +// tag::desc-more[] The [node-level][cleanupclientattempts] `cleanupclientattempts` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanupclientattempts]: ../n1ql-rest-admin/index.html#cleanupclientattempts +// end::desc-more[] -- [%hardbreaks] @@ -1051,10 +1053,12 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. +// tag::desc-more[] The [node-level][cleanuplostattempts] `cleanuplostattempts` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanuplostattempts]: ../n1ql-rest-admin/index.html#cleanuplostattempts +// end::desc-more[] -- [%hardbreaks] @@ -1091,10 +1095,12 @@ Valid units are: [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [node-level][cleanupwindow] `cleanupwindow` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [cleanupwindow]: ../n1ql-rest-admin/index.html#cleanupwindow +// end::desc-more[] -- [%hardbreaks] @@ -1124,10 +1130,12 @@ Refer to [Configure the Completed Requests][sys-completed-config] for more infor [sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +// tag::desc-more[] The [node-level][completed-limit] `completed-limit` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [completed-limit]: ../n1ql-rest-admin/index.html#completed-limit +// end::desc-more[] -- [%hardbreaks] @@ -1158,10 +1166,12 @@ Refer to [Configure the Completed Requests][sys-completed-config] for more infor [sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +// tag::desc-more[] The [node-level][completed-max-plan-size] `completed-max-plan-size` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [completed-max-plan-size]: ../n1ql-rest-admin/index.html#completed-max-plan-size +// end::desc-more[] -- [%hardbreaks] @@ -1193,10 +1203,12 @@ Refer to [Configure the Completed Requests][sys-completed-config] for more infor [sys-completed-config]: ../n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config +// tag::desc-more[] The [node-level][completed-threshold] `completed-threshold` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [completed-threshold]: ../n1ql-rest-admin/index.html#completed-threshold +// end::desc-more[] -- [%hardbreaks] @@ -1241,10 +1253,12 @@ Major items, like crashes. * `NONE` — Doesn't write anything. +// tag::desc-more[] The [node-level][loglevel] `loglevel` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [loglevel]: ../n1ql-rest-admin/index.html#loglevel +// end::desc-more[] -- [%hardbreaks] @@ -1280,6 +1294,7 @@ Refer to [Max Parallelism][max-parallelism] for more information. [max-parallelism]: ../n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism +// tag::desc-more[] The [node-level][max-parallelism-srv] `max-parallelism` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1290,6 +1305,7 @@ NOTE: To enable queries to run in parallel, you must specify the cluster-level ` [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req +// end::desc-more[] -- [%hardbreaks] @@ -1319,6 +1335,7 @@ It does not take into account any other memory that might be used to process a r Within a transaction, this setting enforces the memory quota for the transaction by tracking the delta table and the transaction log (approximately). +// tag::desc-more[] The [node-level][memory-quota-srv] `memory-quota` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1327,6 +1344,7 @@ If a request includes this parameter, it will be capped by the node-level `memor [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req +// end::desc-more[] -- [%hardbreaks] @@ -1350,10 +1368,12 @@ endif::alt-markdown-links[] SQL++ feature control. This setting is provided for technical support only. +// tag::desc-more[] The [node-level][n1ql-feat-ctrl] `n1ql-feat-ctrl` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [n1ql-feat-ctrl]: ../n1ql-rest-admin/index.html#n1ql-feat-ctrl +// end::desc-more[] -- [%hardbreaks] @@ -1385,10 +1405,12 @@ To do this, the Query service calculates the difference between the total system - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. +// tag::desc-more[] The [node-level][node-quota] `node-quota` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [node-quota]: ../n1ql-rest-admin/index.html#node-quota +// end::desc-more[] -- [%hardbreaks] @@ -1411,10 +1433,12 @@ endif::alt-markdown-links[] The percentage of the `queryNodeQuota` that is dedicated to tracked value content memory across all active requests for every Query node in the cluster. (The `queryMemoryQuota` setting specifies the maximum amount of document memory an individual request may use on any Query node in the cluster.) +// tag::desc-more[] The [node-level][node-quota-val-percent] `node-quota-val-percent` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [node-quota-val-percent]: ../n1ql-rest-admin/index.html#node-quota-val-percent +// end::desc-more[] -- [%hardbreaks] @@ -1441,6 +1465,7 @@ Specifies the total number of [active transaction records][additional-storage-us [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries +// tag::desc-more[] The [node-level][numatrs-srv] `numatrs` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1449,6 +1474,7 @@ If a request includes this parameter, it will be capped by the node-level `numat [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req +// end::desc-more[] -- [%hardbreaks] @@ -1479,10 +1505,12 @@ The number of CPUs can never be greater than the number of logical CPUs. In Community Edition, the number of allowed CPUs cannot be greater than 4. In Enterprise Edition, there is no limit to the number of allowed CPUs. +// tag::desc-more[] The [node-level][num-cpus] `num-cpus` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [num-cpus]: ../n1ql-rest-admin/index.html#num-cpus +// end::desc-more[] -- [%hardbreaks] @@ -1505,6 +1533,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Controls the number of items execution operators can batch for Fetch from the KV. +// tag::desc-more[] The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1513,6 +1542,7 @@ The minimum of that and the node-level `pipeline-batch` setting is applied. [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req +// end::desc-more[] -- [%hardbreaks] @@ -1536,6 +1566,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Maximum number of items each execution operator can buffer between various operators. +// tag::desc-more[] The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1544,6 +1575,7 @@ The minimum of that and the node-level `pipeline-cap` setting is applied. [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req +// end::desc-more[] -- [%hardbreaks] @@ -1567,10 +1599,12 @@ endif::alt-markdown-links[] Maximum number of prepared statements in the cache. When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. +// tag::desc-more[] The [node-level][prepared-limit] `prepared-limit` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. [prepared-limit]: ../n1ql-rest-admin/index.html#prepared-limit +// end::desc-more[] -- [%hardbreaks] @@ -1598,6 +1632,7 @@ This parameter controls when to use scan backfill. Use `0` or a negative number to disable. Smaller values reduce GC, while larger values reduce indexer backfill. +// tag::desc-more[] The [node-level][scan-cap-srv] `scan-cap` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1606,6 +1641,7 @@ The minimum of that and the node-level `scan-cap` setting is applied. [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req +// end::desc-more[] -- [%hardbreaks] @@ -1635,6 +1671,7 @@ It must not be delimited by quotes, and must not include a unit. Specify `0` (the default value) or a negative integer to disable. When disabled, no timeout is applied and the request runs for however long it takes. +// tag::desc-more[] The [node-level][timeout-srv] `timeout` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1643,6 +1680,7 @@ The minimum of that and the node-level `timeout` setting is applied. [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv [timeout_req]: ../n1ql-rest-query/index.html#timeout_req +// end::desc-more[] -- [%hardbreaks] @@ -1685,6 +1723,7 @@ When disabled, no timeout is applied and the transaction runs for however long i [tximplicit]: ../n1ql-rest-query/index.html#tximplicit +// tag::desc-more[] The [node-level][txtimeout-srv] `txtimeout` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1693,6 +1732,7 @@ If a request includes this parameter, it will be capped by the node-level `txtim [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req +// end::desc-more[] -- [%hardbreaks] @@ -1760,6 +1800,7 @@ ifdef::alt-markdown-links[] endif::alt-markdown-links[] Specifies whether the cost-based optimizer is enabled. +// tag::desc-more[] The [node-level][use-cbo-srv] `use-cbo` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1768,6 +1809,7 @@ If a request does not include this parameter, the node-level setting is used, wh [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req +// end::desc-more[] -- [%hardbreaks] @@ -1806,6 +1848,7 @@ Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 Note that KV range scans cannot currently be started on a replica vBucket. If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. +// tag::desc-more[] The [node-level][use-replica-srv] `use-replica` setting specifies this property for a single node. When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. @@ -1815,6 +1858,7 @@ If the request-level parameter and the node-level setting are both `unset`, read [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req +// end::desc-more[] -- [%hardbreaks] diff --git a/docs/preview/AV-91970-8-0-docs-uptake-capella.yml b/docs/preview/AV-91970-8-0-docs-uptake-capella.yml new file mode 100644 index 00000000..0bccc737 --- /dev/null +++ b/docs/preview/AV-91970-8-0-docs-uptake-capella.yml @@ -0,0 +1,5 @@ +sources: + docs-capella: + branches: main + docs-devex: + branches: merge-80-capella \ No newline at end of file diff --git a/templates/property.mustache b/templates/property.mustache index 0710335f..173ebcef 100644 --- a/templates/property.mustache +++ b/templates/property.mustache @@ -18,7 +18,9 @@ endif::alt-markdown-links[] {{#vendorExtensions}} {{#x-desc-more}} +// tag::desc-more[] {{{this}}} +// end::desc-more[] {{/x-desc-more}} {{/vendorExtensions}} {{! if ref is present, fetch remote description}} From a03c0363c569a8339976891a29640a1f9df9fb74 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Tue, 23 Sep 2025 21:55:09 +0100 Subject: [PATCH 22/25] NO ISSUE: Fix schema for Array models (#187) --- docs/modules/fts-rest-nodes/pages/index.adoc | 1 - templates/models.mustache | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/modules/fts-rest-nodes/pages/index.adoc b/docs/modules/fts-rest-nodes/pages/index.adoc index 1466eeaf..d27ac8f3 100644 --- a/docs/modules/fts-rest-nodes/pages/index.adoc +++ b/docs/modules/fts-rest-nodes/pages/index.adoc @@ -3521,7 +3521,6 @@ The name of the property is the name of the Search index. .Schema String - array diff --git a/templates/models.mustache b/templates/models.mustache index 9dc330ad..3d0751be 100644 --- a/templates/models.mustache +++ b/templates/models.mustache @@ -102,7 +102,7 @@ endif::collapse-models[] {{#items}} .Schema -{{>schemas}} array +{{>schema}} array {{/items}} {{/isArray}} {{/composedSchemas}} From 35c85800a05734a5329b851f278d9d1683e7611e Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Wed, 1 Oct 2025 10:02:35 +0100 Subject: [PATCH 23/25] DOC-12763: Eventing Rearchitecture (#188) * Update spec * Add examples * Interbucket recursion is global only * Build output documentation --------- Co-authored-by: tech-comm-team-couchbase --- .../attachments/eventing.yaml | 97 ++- .../eventing-rest-api/pages/index.adoc | 769 +++++++++++------- .../paths/config_get/http-request.adoc | 11 +- .../paths/config_update/http-request.adoc | 13 + .../operation-description-after.adoc | 2 + 5 files changed, 577 insertions(+), 315 deletions(-) diff --git a/docs/modules/eventing-rest-api/attachments/eventing.yaml b/docs/modules/eventing-rest-api/attachments/eventing.yaml index 8fd0671e..ea36b404 100644 --- a/docs/modules/eventing-rest-api/attachments/eventing.yaml +++ b/docs/modules/eventing-rest-api/attachments/eventing.yaml @@ -610,19 +610,45 @@ paths: $ref: '#/components/responses/Goof' /api/v1/config: + parameters: + - name: bucket + schema: + type: string + in: query + required: false + description: |- + For scoped configuration settings only. + The bucket to which the configuration settings apply. + - name: scope + schema: + type: string + in: query + required: false + description: |- + For scoped configuration settings only. + The scope to which the configuration settings apply. get: operationId: config_get - summary: List Global Config + summary: List Service Config description: |- - Shows all global configuration settings. - Note that the `enable_debugger` and `ram_quota` settings can also be adjusted via the UI. + Shows all service configuration settings. + + In Couchbase Server 8.0 and later, you can list service configuration settings globally, or at the function scope level. + When you list settings at the function scope level, the settings apply only to functions within that function scope. + Some service configuration settings are only available globally. + + Service configuration settings at the function scope level take precedence over global service configuration settings. + If a setting is not specified at the function scope level, the Eventing service checks at the bucket level, and then falls back to the global level. + + You can also see the current values of the `enable_debugger` and `ram_quota` settings via the UI. tags: - - global config + - service config security: - - Unscoped: [] + - Global: [] + - Scoped: [] responses: "200": - description: Returns an object showing the global configuration settings. + description: Returns an object showing the service configuration settings. content: application/json: schema: @@ -631,23 +657,33 @@ paths: $ref: '#/components/responses/Goof' post: operationId: config_update - summary: Modify Global Config + summary: Modify Service Config description: |- - Modify global configuration settings. + Modify service configuration settings. During an edit, settings provided are merged. Unspecified attributes retain their prior values. The response indicates whether the Eventing service must be restarted for the new changes to take effect. + + In Couchbase Server 8.0 and later, you can modify service configuration settings globally, or at the function scope level. + When you modify settings at the function scope level, the settings apply only to functions within that function scope. + Some service configuration settings are only available globally. + + Service configuration settings at the function scope level take precedence over global service configuration settings. + If a setting is not specified at the function scope level, the Eventing service checks at the bucket level, and then falls back to the global level. + + You can also modify the `enable_debugger` and `ram_quota` settings via the UI. tags: - - global config + - service config requestBody: required: true - description: An object providing the global configuration settings. + description: An object providing the service configuration settings. content: application/json: schema: $ref: "#/components/schemas/UnivConfig" security: - - Unscoped: [] + - Global: [] + - Scoped: [] responses: "200": $ref: '#/components/responses/OK' @@ -875,7 +911,7 @@ components: $ref: "#/components/schemas/handler_schema" UnivConfig: - title: Global Config + title: Service Config type: object properties: ram_quota: @@ -884,7 +920,17 @@ components: example: 512 x-has-example: true x-has-default: true - description: The memory allocation for the Eventing Service, per node. + description: |- + The memory allocation for the Eventing Service, per node. + + This setting is only available globally. + enable_curl: + type: boolean + description: |- + Enables the Eventing curl function. + For details, see [cURL](/cloud/eventing/eventing-curl-spec.html). + + This setting is available globally or at the function scope level. enable_debugger: type: boolean default: false @@ -892,6 +938,8 @@ components: description: |- Enables the Eventing service debugger. For details, see [Debugging and Diagnosability](/cloud/eventing/eventing-debugging-and-diagnosability.html). + + This setting is available globally or at the function scope level. cursor_limit: type: integer default: 5 @@ -899,12 +947,27 @@ components: minimum: 1 x-has-default: true description: |- - The maximum number of cursor-aware Eventing functions that can coexist on a given source keyspace. (A cursor-aware Eventing function is one for which the `cursor_aware` setting is `true`.) + The maximum number of cursor-aware Eventing functions that can coexist on a given source keyspace. + (A cursor-aware Eventing function is one for which the `cursor_aware` setting is `true`.) Increasing this setting enables more cursor-aware Eventing functions to register and listen to any given collection. Decreasing this setting prevents further cursor-aware Eventing functions from being registered on any given collection; however, it doesn't unregister already registered cursor-aware Eventing functions. + This setting is only available globally. + num_nodes_running: + type: integer + example: 3 + x-has-example: true + x-desc-status: Couchbase Server 8.0 + description: |- + The number of Eventing nodes on which the functions in scope execute. + + By default, all Eventing functions run on all Eventing nodes. + If this setting is specified, the Evening Service attempts to run the functions in scope on the specified number of nodes. + If fewer nodes are available, the functions run on all available nodes. + + This setting is available globally or at the function scope level. responses: OK: description: Success. @@ -917,8 +980,8 @@ components: type: http scheme: basic description: |- - Global functions with a function scope of ``*.*`` can only be made or managed by users with the Full Admin or Eventing Full Admin role. - For global functions, you do not need to pass the `bucket` and `scope` query parameters to specify the function scope. + Global functions and service configuration settings with a function scope of ``*.*`` can only be made or managed by users with the Full Admin or Eventing Full Admin role. + For global functions and service configuration settings, you do not need to pass the `bucket` and `scope` query parameters to specify the function scope. The credentials must be an administrator username and password. Note that this is the default function scope for all functions after an upgrade from a prior version. @@ -927,7 +990,7 @@ components: type: http scheme: basic description: |- - For scoped functions, you must pass the `bucket` and `scope` query parameters to specify the function scope. + For scoped functions and service configuration settings, you must pass the `bucket` and `scope` query parameters to specify the function scope. The credentials are the username and password of any authorized user. You can quote the REST call on the command line to escape the `&` and `?` characters. diff --git a/docs/modules/eventing-rest-api/pages/index.adoc b/docs/modules/eventing-rest-api/pages/index.adoc index 0c829619..c2698b89 100644 --- a/docs/modules/eventing-rest-api/pages/index.adoc +++ b/docs/modules/eventing-rest-api/pages/index.adoc @@ -114,9 +114,9 @@ The operations are grouped in the following categories. [%hardbreaks] xref:tag-Activation[] xref:tag-Advanced[] -xref:tag-GlobalConfig[] xref:tag-List[] xref:tag-Logging[] +xref:tag-ServiceConfig[] xref:tag-Statistics[] xref:tag-Status[] endif::[] @@ -4299,8 +4299,8 @@ endif::[] ifeval::[{count-apis} > 1] -[#tag-GlobalConfig] -= Global Config +[#tag-List] += List :leveloffset: +1 ifeval::["" != ""] @@ -4312,83 +4312,82 @@ endif::[] endif::[] [%hardbreaks] -xref:config_get[] -xref:config_update[] +xref:list_all[] +xref:list_query[] -//tag::config_get[] +//tag::list_all[] -// markup not found, no include::{specDir}paths/config_get/operation-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-before.adoc[opts=optional] -[#config_get] -= List Global Config +[#list_all] += List All Functions :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_get/operation-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-begin.adoc[opts=optional] .... -GET /api/v1/config +GET /api/v1/list/functions .... -// markup not found, no include::{specDir}paths/config_get/operation-description-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-description-before.adoc[opts=optional] -[#config_get-description] +[#list_all-description] = Description :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_get/operation-description-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-description-begin.adoc[opts=optional] [markdown] -- -Shows all global configuration settings. -Note that the `enable_debugger` and `ram_quota` settings can also be adjusted via the UI. +Returns a list (array) of the names of all Eventing functions in the cluster. +The returned list can also be filtered — see [List Filtered Functions](#list_query). + +If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. -- -// markup not found, no include::{specDir}paths/config_get/operation-description-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-description-end.adoc[opts=optional] -[#config_get-produces] -.Produces -* application/json :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_get/operation-description-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-description-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_get/operation-parameters-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-parameters-before.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_get/operation-parameters-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-parameters-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_get/operation-responses-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-responses-before.adoc[opts=optional] -[#config_get-responses] +[#list_all-responses] = Responses :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_get/operation-responses-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-responses-begin.adoc[opts=optional] [cols="20,60,20"] @@ -4398,11 +4397,9 @@ Note that the `enable_debugger` and `ram_quota` settings can also be adjusted vi | 200 a| [markdown] -- -Returns an object showing the global configuration settings. +Success. -- -a| xref:UnivConfig[] - - +a| | 404 a| [markdown] -- @@ -4413,25 +4410,25 @@ a| |=== -// markup not found, no include::{specDir}paths/config_get/operation-responses-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-responses-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_get/operation-responses-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-responses-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_get/operation-security-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-security-before.adoc[opts=optional] -[#config_get-security] +[#list_all-security] = Security :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_get/operation-security-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-security-begin.adoc[opts=optional] [cols="20,80"] @@ -4444,151 +4441,192 @@ a| |=== -// markup not found, no include::{specDir}paths/config_get/operation-security-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-security-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_get/operation-security-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-security-after.adoc[opts=optional] -include::{snippetDir}config_get/http-request.adoc[opts=optional] +include::{snippetDir}list_all/http-request.adoc[opts=optional] -// markup not found, no include::{snippetDir}config_get/http-response.adoc[opts=optional] +// markup not found, no include::{snippetDir}list_all/http-response.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_get/operation-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_get/operation-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_all/operation-after.adoc[opts=optional] -//end::config_get[] +//end::list_all[] -//tag::config_update[] +//tag::list_query[] -// markup not found, no include::{specDir}paths/config_update/operation-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-before.adoc[opts=optional] -[#config_update] -= Modify Global Config +[#list_query] += List Filtered Functions :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_update/operation-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-begin.adoc[opts=optional] .... -POST /api/v1/config +GET /api/v1/list/functions/query .... -// markup not found, no include::{specDir}paths/config_update/operation-description-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-description-before.adoc[opts=optional] -[#config_update-description] +[#list_query-description] = Description :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_update/operation-description-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-description-begin.adoc[opts=optional] [markdown] -- -Modify global configuration settings. -During an edit, settings provided are merged. -Unspecified attributes retain their prior values. -The response indicates whether the Eventing service must be restarted for the new changes to take effect. +Returns a list (array) of the names of all Eventing functions in the cluster. +The returned list can be filtered by the following: + +- Deployed status : in this case, paused is considered deployed. +- Source bucket: the listen to keyspace. +- Function type: whether the function modifies its own listen to keyspace. + +If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. -- -// markup not found, no include::{specDir}paths/config_update/operation-description-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-description-end.adoc[opts=optional] -[#config_update-consumes] -.Consumes -* application/json :leveloffset: -1 -include::{specDir}paths/config_update/operation-description-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-description-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_update/operation-parameters-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-parameters-before.adoc[opts=optional] -[#config_update-parameters] +[#list_query-parameters] = Parameters :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_update/operation-parameters-begin.adoc[opts=optional] - - - +// markup not found, no include::{specDir}paths/list_query/operation-parameters-begin.adoc[opts=optional] -[#config_update-body] -.Body Parameter +[#list_query-query] +.Query Parameters {blank} [cols="20,60,20",separator=¦] |=== ¦ Name ¦ Description ¦ Schema -a¦ *Body* + -_required_ +a¦ *deployed* + +_optional_ a¦ [markdown] -- -An object providing the global configuration settings. +If `true`, returns the names of all deployed (or paused) functions. +If `false`, returns the names of all undeployed functions. -- [%hardbreaks] {blank} -a¦ xref:UnivConfig[] +a¦ Boolean + + + +a¦ *source_bucket* + +_optional_ +a¦ + + +[markdown] +-- +The name of a bucket. +Returns the names of Eventing functions in the cluster that have a source keyspace under the specified bucket. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *function_type* + +_optional_ +a¦ + + +[markdown] +-- +The function type. + +- `sbm`: Returns the names of Eventing functions in the cluster that modify their own source keyspace. +- `notsbm`: Returns the names of Eventing functions in the cluster that do not modify their own source keyspace. +-- + +[%hardbreaks] +*Values:* `"sbm"`, `"notsbm"` +{blank} + +a¦ String |=== -// markup not found, no include::{specDir}paths/config_update/operation-parameters-end.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/list_query/operation-parameters-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_update/operation-parameters-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-parameters-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_update/operation-responses-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-responses-before.adoc[opts=optional] -[#config_update-responses] +[#list_query-responses] = Responses :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_update/operation-responses-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-responses-begin.adoc[opts=optional] [cols="20,60,20"] @@ -4611,25 +4649,25 @@ a| |=== -// markup not found, no include::{specDir}paths/config_update/operation-responses-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-responses-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_update/operation-responses-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-responses-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_update/operation-security-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-security-before.adoc[opts=optional] -[#config_update-security] +[#list_query-security] = Security :leveloffset: +1 -// markup not found, no include::{specDir}paths/config_update/operation-security-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-security-begin.adoc[opts=optional] [cols="20,80"] @@ -4642,31 +4680,31 @@ a| |=== -// markup not found, no include::{specDir}paths/config_update/operation-security-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-security-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_update/operation-security-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-security-after.adoc[opts=optional] -include::{snippetDir}config_update/http-request.adoc[opts=optional] +include::{snippetDir}list_query/http-request.adoc[opts=optional] -// markup not found, no include::{snippetDir}config_update/http-response.adoc[opts=optional] +// markup not found, no include::{snippetDir}list_query/http-response.adoc[opts=optional] -// markup not found, no include::{specDir}paths/config_update/operation-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/config_update/operation-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/list_query/operation-after.adoc[opts=optional] -//end::config_update[] +//end::list_query[] ifeval::[{count-apis} > 1] @@ -4675,8 +4713,8 @@ endif::[] ifeval::[{count-apis} > 1] -[#tag-List] -= List +[#tag-Logging] += Logging :leveloffset: +1 ifeval::["" != ""] @@ -4688,51 +4726,47 @@ endif::[] endif::[] [%hardbreaks] -xref:list_all[] -xref:list_query[] +xref:log_view[] -//tag::list_all[] +//tag::log_view[] -// markup not found, no include::{specDir}paths/list_all/operation-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-before.adoc[opts=optional] -[#list_all] -= List All Functions +[#log_view] += Get Log for a Function :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_all/operation-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-begin.adoc[opts=optional] .... -GET /api/v1/list/functions +GET /getAppLog .... -// markup not found, no include::{specDir}paths/list_all/operation-description-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-description-before.adoc[opts=optional] -[#list_all-description] +[#log_view-description] = Description :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_all/operation-description-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-description-begin.adoc[opts=optional] [markdown] -- -Returns a list (array) of the names of all Eventing functions in the cluster. -The returned list can also be filtered — see [List Filtered Functions](#list_query). - -If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. +Returns the most recent application log messages for the specified function. -- -// markup not found, no include::{specDir}paths/list_all/operation-description-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-description-end.adoc[opts=optional] @@ -4740,30 +4774,147 @@ If this API is run as a non-Administrator the results are filtered via RBAC to i :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_all/operation-description-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-description-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_all/operation-parameters-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-parameters-before.adoc[opts=optional] + +[#log_view-parameters] += Parameters +:leveloffset: +1 +// markup not found, no include::{specDir}paths/log_view/operation-parameters-begin.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_all/operation-parameters-after.adoc[opts=optional] +[#log_view-query] +.Query Parameters +{blank} +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema +a¦ *name* + +_required_ +a¦ -// markup not found, no include::{specDir}paths/list_all/operation-responses-before.adoc[opts=optional] +[markdown] +-- +The name of a function. +-- -[#list_all-responses] +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *bucket* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The bucket to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *scope* + +_optional_ +a¦ + + +[markdown] +-- +For scoped functions only. +The scope to which the function belongs. +-- + +[%hardbreaks] +{blank} + +a¦ String + + + +a¦ *aggregate* + +_optional_ +a¦ + + +[markdown] +-- +If `false`, the API accesses a single Eventing node. +If `true`, the API accesses all Eventing nodes. +-- + +[%hardbreaks] +*Default:* `false` +{blank} + +a¦ Boolean + + + +a¦ *size* + +_optional_ +a¦ + + +[markdown] +-- +The approximate amount of logging information returned. +Note that when fetching from more than one Eventing node, the amount of logging information returned from each node is the `size` divided by the number of nodes. +-- + +[%hardbreaks] +*Default:* `40960` +{blank} + +a¦ Integer + + + +|=== + + + + + +// markup not found, no include::{specDir}paths/log_view/operation-parameters-end.adoc[opts=optional] + +:leveloffset: -1 + + + + +// markup not found, no include::{specDir}paths/log_view/operation-parameters-after.adoc[opts=optional] + + + +// markup not found, no include::{specDir}paths/log_view/operation-responses-before.adoc[opts=optional] + + +[#log_view-responses] = Responses :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_all/operation-responses-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-responses-begin.adoc[opts=optional] [cols="20,60,20"] @@ -4786,25 +4937,25 @@ a| |=== -// markup not found, no include::{specDir}paths/list_all/operation-responses-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-responses-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_all/operation-responses-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-responses-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_all/operation-security-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-security-before.adoc[opts=optional] -[#list_all-security] +[#log_view-security] = Security :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_all/operation-security-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-security-begin.adoc[opts=optional] [cols="20,80"] @@ -4812,107 +4963,137 @@ a| | Type | Name | http (basic) -| xref:security-unscoped[] +| xref:security-scoped[] +| http (basic) +| xref:security-global[] |=== -// markup not found, no include::{specDir}paths/list_all/operation-security-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-security-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_all/operation-security-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-security-after.adoc[opts=optional] -include::{snippetDir}list_all/http-request.adoc[opts=optional] +include::{snippetDir}log_view/http-request.adoc[opts=optional] -// markup not found, no include::{snippetDir}list_all/http-response.adoc[opts=optional] +// markup not found, no include::{snippetDir}log_view/http-response.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_all/operation-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_all/operation-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/log_view/operation-after.adoc[opts=optional] -//end::list_all[] +//end::log_view[] -//tag::list_query[] +ifeval::[{count-apis} > 1] +:leveloffset: -1 +endif::[] -// markup not found, no include::{specDir}paths/list_query/operation-before.adoc[opts=optional] +ifeval::[{count-apis} > 1] +[#tag-ServiceConfig] += Service Config +:leveloffset: +1 + +ifeval::["" != ""] +endif::[] +ifeval::["" == ""] +**{toc-title}** +endif::[] +endif::[] -[#list_query] -= List Filtered Functions +[%hardbreaks] +xref:config_get[] +xref:config_update[] + + +//tag::config_get[] + + +// markup not found, no include::{specDir}paths/config_get/operation-before.adoc[opts=optional] + + +[#config_get] += List Service Config :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_query/operation-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-begin.adoc[opts=optional] .... -GET /api/v1/list/functions/query +GET /api/v1/config .... -// markup not found, no include::{specDir}paths/list_query/operation-description-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-description-before.adoc[opts=optional] -[#list_query-description] +[#config_get-description] = Description :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_query/operation-description-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-description-begin.adoc[opts=optional] [markdown] -- -Returns a list (array) of the names of all Eventing functions in the cluster. -The returned list can be filtered by the following: +Shows all service configuration settings. -- Deployed status : in this case, paused is considered deployed. -- Source bucket: the listen to keyspace. -- Function type: whether the function modifies its own listen to keyspace. +In Couchbase Server 8.0 and later, you can list service configuration settings globally, or at the function scope level. +When you list settings at the function scope level, the settings apply only to functions within that function scope. +Some service configuration settings are only available globally. -If this API is run as a non-Administrator the results are filtered via RBAC to include only the function scopes the user has access to. +Service configuration settings at the function scope level take precedence over global service configuration settings. +If a setting is not specified at the function scope level, the Eventing service checks at the bucket level, and then falls back to the global level. + +You can also see the current values of the `enable_debugger` and `ram_quota` settings via the UI. -- -// markup not found, no include::{specDir}paths/list_query/operation-description-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-description-end.adoc[opts=optional] +[#config_get-produces] +.Produces +* application/json :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_query/operation-description-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-description-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_query/operation-parameters-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-parameters-before.adoc[opts=optional] -[#list_query-parameters] +[#config_get-parameters] = Parameters :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_query/operation-parameters-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-parameters-begin.adoc[opts=optional] -[#list_query-query] +[#config_get-query] .Query Parameters {blank} @@ -4920,33 +5101,15 @@ If this API is run as a non-Administrator the results are filtered via RBAC to i |=== ¦ Name ¦ Description ¦ Schema -a¦ *deployed* + -_optional_ -a¦ - - -[markdown] --- -If `true`, returns the names of all deployed (or paused) functions. -If `false`, returns the names of all undeployed functions. --- - -[%hardbreaks] -{blank} - -a¦ Boolean - - - -a¦ *source_bucket* + +a¦ *bucket* + _optional_ a¦ [markdown] -- -The name of a bucket. -Returns the names of Eventing functions in the cluster that have a source keyspace under the specified bucket. +For scoped configuration settings only. +The bucket to which the configuration settings apply. -- [%hardbreaks] @@ -4956,21 +5119,18 @@ a¦ String -a¦ *function_type* + +a¦ *scope* + _optional_ a¦ [markdown] -- -The function type. - -- `sbm`: Returns the names of Eventing functions in the cluster that modify their own source keyspace. -- `notsbm`: Returns the names of Eventing functions in the cluster that do not modify their own source keyspace. +For scoped configuration settings only. +The scope to which the configuration settings apply. -- [%hardbreaks] -*Values:* `"sbm"`, `"notsbm"` {blank} a¦ String @@ -4983,26 +5143,26 @@ a¦ String -// markup not found, no include::{specDir}paths/list_query/operation-parameters-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-parameters-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_query/operation-parameters-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-parameters-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_query/operation-responses-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-responses-before.adoc[opts=optional] -[#list_query-responses] +[#config_get-responses] = Responses :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_query/operation-responses-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-responses-begin.adoc[opts=optional] [cols="20,60,20"] @@ -5012,9 +5172,11 @@ a¦ String | 200 a| [markdown] -- -Success. +Returns an object showing the service configuration settings. -- -a| +a| xref:UnivConfig[] + + | 404 a| [markdown] -- @@ -5025,25 +5187,25 @@ a| |=== -// markup not found, no include::{specDir}paths/list_query/operation-responses-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-responses-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_query/operation-responses-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-responses-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_query/operation-security-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-security-before.adoc[opts=optional] -[#list_query-security] +[#config_get-security] = Security :leveloffset: +1 -// markup not found, no include::{specDir}paths/list_query/operation-security-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-security-begin.adoc[opts=optional] [cols="20,80"] @@ -5051,122 +5213,117 @@ a| | Type | Name | http (basic) -| xref:security-unscoped[] +| xref:security-scoped[] +| http (basic) +| xref:security-global[] |=== -// markup not found, no include::{specDir}paths/list_query/operation-security-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_get/operation-security-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/list_query/operation-security-after.adoc[opts=optional] - - - -include::{snippetDir}list_query/http-request.adoc[opts=optional] - - -// markup not found, no include::{snippetDir}list_query/http-response.adoc[opts=optional] - +// markup not found, no include::{specDir}paths/config_get/operation-security-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_query/operation-end.adoc[opts=optional] -:leveloffset: -1 +include::{snippetDir}config_get/http-request.adoc[opts=optional] -// markup not found, no include::{specDir}paths/list_query/operation-after.adoc[opts=optional] +// markup not found, no include::{snippetDir}config_get/http-response.adoc[opts=optional] -//end::list_query[] +// markup not found, no include::{specDir}paths/config_get/operation-end.adoc[opts=optional] -ifeval::[{count-apis} > 1] :leveloffset: -1 -endif::[] -ifeval::[{count-apis} > 1] -[#tag-Logging] -= Logging -:leveloffset: +1 - -ifeval::["" != ""] +// markup not found, no include::{specDir}paths/config_get/operation-after.adoc[opts=optional] -endif::[] -ifeval::["" == ""] -**{toc-title}** -endif::[] -endif::[] -[%hardbreaks] -xref:log_view[] +//end::config_get[] -//tag::log_view[] +//tag::config_update[] -// markup not found, no include::{specDir}paths/log_view/operation-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-before.adoc[opts=optional] -[#log_view] -= Get Log for a Function +[#config_update] += Modify Service Config :leveloffset: +1 -// markup not found, no include::{specDir}paths/log_view/operation-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-begin.adoc[opts=optional] .... -GET /getAppLog +POST /api/v1/config .... -// markup not found, no include::{specDir}paths/log_view/operation-description-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-description-before.adoc[opts=optional] -[#log_view-description] +[#config_update-description] = Description :leveloffset: +1 -// markup not found, no include::{specDir}paths/log_view/operation-description-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-description-begin.adoc[opts=optional] [markdown] -- -Returns the most recent application log messages for the specified function. +Modify service configuration settings. +During an edit, settings provided are merged. +Unspecified attributes retain their prior values. +The response indicates whether the Eventing service must be restarted for the new changes to take effect. + +In Couchbase Server 8.0 and later, you can modify service configuration settings globally, or at the function scope level. +When you modify settings at the function scope level, the settings apply only to functions within that function scope. +Some service configuration settings are only available globally. + +Service configuration settings at the function scope level take precedence over global service configuration settings. +If a setting is not specified at the function scope level, the Eventing service checks at the bucket level, and then falls back to the global level. + +You can also modify the `enable_debugger` and `ram_quota` settings via the UI. -- -// markup not found, no include::{specDir}paths/log_view/operation-description-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-description-end.adoc[opts=optional] +[#config_update-consumes] +.Consumes +* application/json :leveloffset: -1 -// markup not found, no include::{specDir}paths/log_view/operation-description-after.adoc[opts=optional] +include::{specDir}paths/config_update/operation-description-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/log_view/operation-parameters-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-parameters-before.adoc[opts=optional] -[#log_view-parameters] +[#config_update-parameters] = Parameters :leveloffset: +1 -// markup not found, no include::{specDir}paths/log_view/operation-parameters-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-parameters-begin.adoc[opts=optional] -[#log_view-query] +[#config_update-query] .Query Parameters {blank} @@ -5174,23 +5331,6 @@ Returns the most recent application log messages for the specified function. |=== ¦ Name ¦ Description ¦ Schema -a¦ *name* + -_required_ -a¦ - - -[markdown] --- -The name of a function. --- - -[%hardbreaks] -{blank} - -a¦ String - - - a¦ *bucket* + _optional_ a¦ @@ -5198,8 +5338,8 @@ a¦ [markdown] -- -For scoped functions only. -The bucket to which the function belongs. +For scoped configuration settings only. +The bucket to which the configuration settings apply. -- [%hardbreaks] @@ -5216,8 +5356,8 @@ a¦ [markdown] -- -For scoped functions only. -The scope to which the function belongs. +For scoped configuration settings only. +The scope to which the configuration settings apply. -- [%hardbreaks] @@ -5227,70 +5367,58 @@ a¦ String -a¦ *aggregate* + -_optional_ -a¦ +|=== -[markdown] --- -If `false`, the API accesses a single Eventing node. -If `true`, the API accesses all Eventing nodes. --- -[%hardbreaks] -*Default:* `false` +[#config_update-body] +.Body Parameter {blank} -a¦ Boolean - - +[cols="20,60,20",separator=¦] +|=== +¦ Name ¦ Description ¦ Schema -a¦ *size* + -_optional_ +a¦ *Body* + +_required_ a¦ [markdown] -- -The approximate amount of logging information returned. -Note that when fetching from more than one Eventing node, the amount of logging information returned from each node is the `size` divided by the number of nodes. +An object providing the service configuration settings. -- [%hardbreaks] -*Default:* `40960` {blank} -a¦ Integer +a¦ xref:UnivConfig[] |=== - - - -// markup not found, no include::{specDir}paths/log_view/operation-parameters-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-parameters-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/log_view/operation-parameters-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-parameters-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/log_view/operation-responses-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-responses-before.adoc[opts=optional] -[#log_view-responses] +[#config_update-responses] = Responses :leveloffset: +1 -// markup not found, no include::{specDir}paths/log_view/operation-responses-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-responses-begin.adoc[opts=optional] [cols="20,60,20"] @@ -5313,25 +5441,25 @@ a| |=== -// markup not found, no include::{specDir}paths/log_view/operation-responses-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-responses-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/log_view/operation-responses-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-responses-after.adoc[opts=optional] -// markup not found, no include::{specDir}paths/log_view/operation-security-before.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-security-before.adoc[opts=optional] -[#log_view-security] +[#config_update-security] = Security :leveloffset: +1 -// markup not found, no include::{specDir}paths/log_view/operation-security-begin.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-security-begin.adoc[opts=optional] [cols="20,80"] @@ -5346,31 +5474,31 @@ a| |=== -// markup not found, no include::{specDir}paths/log_view/operation-security-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-security-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/log_view/operation-security-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-security-after.adoc[opts=optional] -include::{snippetDir}log_view/http-request.adoc[opts=optional] +include::{snippetDir}config_update/http-request.adoc[opts=optional] -// markup not found, no include::{snippetDir}log_view/http-response.adoc[opts=optional] +// markup not found, no include::{snippetDir}config_update/http-response.adoc[opts=optional] -// markup not found, no include::{specDir}paths/log_view/operation-end.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-end.adoc[opts=optional] :leveloffset: -1 -// markup not found, no include::{specDir}paths/log_view/operation-after.adoc[opts=optional] +// markup not found, no include::{specDir}paths/config_update/operation-after.adoc[opts=optional] -//end::log_view[] +//end::config_update[] ifeval::[{count-apis} > 1] @@ -8594,7 +8722,7 @@ ifdef::collapse-models[] [discrete] endif::collapse-models[] [#UnivConfig] -= Global Config += Service Config :leveloffset: +1 @@ -8619,6 +8747,8 @@ a¦ [markdown] -- The memory allocation for the Eventing Service, per node. + +This setting is only available globally. -- [%hardbreaks] @@ -8628,6 +8758,24 @@ The memory allocation for the Eventing Service, per node. a¦ Integer +a¦ +*enable_curl* + +_optional_ +a¦ + +[markdown] +-- +Enables the Eventing curl function. +For details, see [cURL](/cloud/eventing/eventing-curl-spec.html). + +This setting is available globally or at the function scope level. +-- + +[%hardbreaks] +{blank} +a¦ Boolean + + a¦ *enable_debugger* + _optional_ @@ -8637,6 +8785,8 @@ a¦ -- Enables the Eventing service debugger. For details, see [Debugging and Diagnosability](/cloud/eventing/eventing-debugging-and-diagnosability.html). + +This setting is available globally or at the function scope level. -- [%hardbreaks] @@ -8652,11 +8802,14 @@ a¦ [markdown] -- -The maximum number of cursor-aware Eventing functions that can coexist on a given source keyspace. (A cursor-aware Eventing function is one for which the `cursor_aware` setting is `true`.) +The maximum number of cursor-aware Eventing functions that can coexist on a given source keyspace. +(A cursor-aware Eventing function is one for which the `cursor_aware` setting is `true`.) Increasing this setting enables more cursor-aware Eventing functions to register and listen to any given collection. Decreasing this setting prevents further cursor-aware Eventing functions from being registered on any given collection; however, it doesn't unregister already registered cursor-aware Eventing functions. + +This setting is only available globally. -- [%hardbreaks] @@ -8667,6 +8820,28 @@ Decreasing this setting prevents further cursor-aware Eventing functions from be a¦ Integer +a¦ +*num_nodes_running* + +_optional_ +a¦ [.status]##Couchbase Server 8.0## + +[markdown] +-- +The number of Eventing nodes on which the functions in scope execute. + +By default, all Eventing functions run on all Eventing nodes. +If this setting is specified, the Evening Service attempts to run the functions in scope on the specified number of nodes. +If fewer nodes are available, the functions run on all available nodes. + +This setting is available globally or at the function scope level. +-- + +[%hardbreaks] +*Example:* `3` +{blank} +a¦ Integer + + |=== //end::UnivConfig[] @@ -8719,8 +8894,8 @@ include::{specDir}security/document-begin.adoc[opts=optional] [markdown] -- -Global functions with a function scope of ``*.*`` can only be made or managed by users with the Full Admin or Eventing Full Admin role. -For global functions, you do not need to pass the `bucket` and `scope` query parameters to specify the function scope. +Global functions and service configuration settings with a function scope of ``*.*`` can only be made or managed by users with the Full Admin or Eventing Full Admin role. +For global functions and service configuration settings, you do not need to pass the `bucket` and `scope` query parameters to specify the function scope. The credentials must be an administrator username and password. Note that this is the default function scope for all functions after an upgrade from a prior version. @@ -8753,7 +8928,7 @@ __Type__ : http [markdown] -- -For scoped functions, you must pass the `bucket` and `scope` query parameters to specify the function scope. +For scoped functions and service configuration settings, you must pass the `bucket` and `scope` query parameters to specify the function scope. The credentials are the username and password of any authorized user. You can quote the REST call on the command line to escape the `&` and `?` characters. diff --git a/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc index 2fc22054..d1843786 100644 --- a/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc +++ b/docs/modules/eventing-rest-api/partials/paths/config_get/http-request.adoc @@ -1,6 +1,6 @@ = Example HTTP Requests -.View global configuration +.View global service configuration settings ==== .Curl request [source,sh] @@ -8,3 +8,12 @@ curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" ---- ==== + +.View scoped service configuration settings +==== +.Curl request +[source,sh] +---- +curl -XGET "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config?bucket=bulk&scope=data" +---- +==== diff --git a/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc b/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc index b81c303d..03764422 100644 --- a/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc +++ b/docs/modules/eventing-rest-api/partials/paths/config_update/http-request.adoc @@ -30,6 +30,19 @@ curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config" \ ---- ==== +.Set service configuration settings for a scope +==== +This example specifies that 3 Eventing nodes should run the functions in this scope. +If fewer than 3 nodes are available, the functions will run on all Eventing nodes. + +.Curl request +[source,sh] +---- +curl -XPOST "http://$ADMIN:$PASSWORD@$HOST:8096/api/v1/config?bucket=bulk&scope=data" \ + -d '{"num_nodes_running": 3}' +---- +==== + .Allow interbucket recursion ==== This example disables the safety checks that prevent basic infinite recursive Eventing functions. diff --git a/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc b/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc index caedb31e..3c7f3971 100644 --- a/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc +++ b/docs/modules/eventing-rest-api/partials/paths/config_update/operation-description-after.adoc @@ -5,4 +5,6 @@ If you need to turn off infinite recursion protection for Eventing functions, yo For details, see xref:eventing:troubleshooting-best-practices.adoc#cyclicredun[Troubleshooting and Best Practices]. Allowing interbucket recursion is highly discouraged unless you have an advanced use case and follow strict non-production coding and verification. + +You can only enable or disable interbucket recursion globally, not for specified function scopes. ==== \ No newline at end of file From 7692db38579a9d84a6528185c109ecbef7970231 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Fri, 3 Oct 2025 19:45:58 +0100 Subject: [PATCH 24/25] DOC-13588: Issues with streaming completed requests (#190) * Build output documentation * Remove residual specs --- .../n1ql-rest-admin/attachments/_admin.yaml | 2388 ----------------- docs/modules/n1ql-rest-admin/pages/index.adoc | 23 +- .../attachments/_functions.yaml | 264 -- .../attachments/_query-service.yaml | 1564 ----------- docs/modules/n1ql-rest-query/pages/index.adoc | 32 +- .../attachments/_query-settings.yaml | 780 ------ .../n1ql-rest-settings/pages/index.adoc | 4 + 7 files changed, 54 insertions(+), 5001 deletions(-) delete mode 100644 docs/modules/n1ql-rest-admin/attachments/_admin.yaml delete mode 100644 docs/modules/n1ql-rest-functions/attachments/_functions.yaml delete mode 100644 docs/modules/n1ql-rest-query/attachments/_query-service.yaml delete mode 100644 docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml diff --git a/docs/modules/n1ql-rest-admin/attachments/_admin.yaml b/docs/modules/n1ql-rest-admin/attachments/_admin.yaml deleted file mode 100644 index 4efe04d1..00000000 --- a/docs/modules/n1ql-rest-admin/attachments/_admin.yaml +++ /dev/null @@ -1,2388 +0,0 @@ -openapi: 3.0.3 -info: - title: Query Admin REST API - version: "8.0" - description: |- - The Query Admin REST API is a secondary API provided by the Query service. - This API enables you to retrieve statistics about the clusters and nodes running the Query service; view or specify node-level settings; and view or delete requests. - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Query Service. - port: - default: "8093" - description: |- - The Query Service REST port. - Use `18093` for secure access. - enum: - - "8093" - - "18093" - -tags: - - name: configuration - description: Operations for cluster and node configuration. - - name: prepared statements - description: Operations for prepared statements. - - name: active requests - description: Operations for active requests. - - name: completed requests - description: Operations for completed requests. - - name: statistics - description: Operations for query statistics. - - name: settings - description: Operations for query settings. - - name: default - description: Other operations. - -# The output of this spec is used in more than one location, so Markdown cannot use relative links. -# Absolute links begin with /cloud -- this must be replaced for every branch. -# Relative links point to a location relative to the REST API reference page by default. -# The x-desc-refs attribute is used to override links when content is transcluded to other locations. - -# The AsciiDoc Markdown converter does not recognize HTML tags like . -# Use the x-desc-name vendor extension to specify the anchor for a property. - -paths: - /admin/clusters: - get: - operationId: get_clusters - summary: Read All Clusters - description: Returns information about all clusters. - tags: - - configuration - security: - - Default: [] - responses: - 200: - description: An array of objects, each of which gives information about one cluster. - content: - application/json: - schema: - type: array - items: - $ref: "#/components/schemas/Clusters" - - /admin/clusters/{cluster}: - get: - operationId: get_cluster - summary: Read a Cluster - parameters: - - $ref: "#/components/parameters/PathCluster" - description: Returns information about the specified cluster. - tags: - - configuration - security: - - Default: [] - responses: - 200: - description: An object giving information about the specified cluster. - content: - application/json: - schema: - $ref: "#/components/schemas/Clusters" - - /admin/clusters/{cluster}/nodes: - get: - operationId: get_nodes - summary: Read All Nodes - parameters: - - $ref: "#/components/parameters/PathCluster" - description: Returns information about all nodes in the specified cluster. - tags: - - configuration - security: - - Default: [] - responses: - 200: - description: An array of objects, each of which gives information about one node. - content: - application/json: - schema: - type: array - items: - $ref: "#/components/schemas/Nodes" - - /admin/clusters/{cluster}/nodes/{node}: - get: - operationId: get_node - summary: Read a Node - parameters: - - $ref: "#/components/parameters/PathCluster" - - $ref: "#/components/parameters/PathNode" - description: Returns information about the specified node in the specified cluster. - tags: - - configuration - security: - - Default: [] - responses: - 200: - description: An object giving information about the specified node. - content: - application/json: - schema: - $ref: "#/components/schemas/Nodes" - - /admin/config: - get: - operationId: get_config - summary: Read Configuration - description: Returns the configuration of the query service on the cluster. - tags: - - configuration - security: - - Default: [] - responses: - 200: - description: An object giving information about the specified node. - content: - application/json: - schema: - $ref: "#/components/schemas/Nodes" - - /admin/prepareds: - get: - operationId: get_prepareds - summary: Retrieve All Prepared Statements - description: |- - Returns all prepared statements. - tags: - - prepared statements - security: - - Default: [] - responses: - 200: - description: An array of objects, each of which contains information about one prepared statement. - content: - application/json: - schema: - type: array - items: - $ref: "#/components/schemas/Statements" - - /admin/prepareds/{name}: - get: - operationId: get_prepared - summary: Retrieve a Prepared Statement - parameters: - - $ref: "#/components/parameters/PathName" - description: |- - Returns the specified prepared statement. - tags: - - prepared statements - security: - - Default: [] - responses: - 200: - description: An object containing information about the specified prepared statement. - content: - application/json: - schema: - $ref: "#/components/schemas/Statements" - delete: - operationId: delete_prepared - summary: Delete a Prepared Statement - parameters: - - $ref: "#/components/parameters/PathName" - description: |- - Deletes the specified prepared statement. - tags: - - prepared statements - security: - - Default: [] - responses: - 200: - description: The prepared statement was successfully deleted. - 500: - description: Returns an error message if the prepared statement could not be found. - content: - application/json: - schema: - type: object - - /admin/active_requests: - get: - operationId: get_active_requests - summary: Retrieve All Active Requests - description: |- - Returns all active query requests. - tags: - - active requests - security: - - Default: [] - responses: - 200: - description: An array of objects, each of which contains information about one active request. - content: - application/json: - schema: - type: array - items: - $ref: "#/components/schemas/Requests" - - /admin/active_requests/{request}: - get: - operationId: get_active_request - summary: Retrieve an Active Request - parameters: - - $ref: "#/components/parameters/PathRequest" - description: |- - Returns the specified active query request. - tags: - - active requests - security: - - Default: [] - responses: - 200: - description: An object containing information about the specified active request. - content: - application/json: - schema: - $ref: "#/components/schemas/Requests" - delete: - operationId: delete_active_request - summary: Delete an Active Request - parameters: - - $ref: "#/components/parameters/PathRequest" - description: |- - Terminates the specified active query request. - tags: - - active requests - security: - - Default: [] - responses: - 200: - description: The active request was successfully terminated. - 500: - description: Returns an error message if the active request could not be found. - content: - application/json: - schema: - type: object - - /admin/completed_requests: - get: - operationId: get_completed_requests - summary: Retrieve All Completed Requests - description: |- - Returns all completed requests. - tags: - - completed requests - security: - - Default: [] - responses: - 200: - description: An array of objects, each of which contains information about one completed request. - content: - application/json: - schema: - type: array - items: - $ref: "#/components/schemas/Requests" - - /admin/completed_requests/{request}: - get: - operationId: get_completed_request - summary: Retrieve a Completed Request - parameters: - - $ref: "#/components/parameters/PathRequest" - description: |- - Returns the specified completed request. - tags: - - completed requests - security: - - Default: [] - responses: - 200: - description: An object containing information about the specified completed request. - content: - application/json: - schema: - $ref: "#/components/schemas/Requests" - delete: - operationId: delete_completed_request - summary: Delete a Completed Request - parameters: - - $ref: "#/components/parameters/PathRequest" - description: |- - Purges the specified completed request. - tags: - - completed requests - security: - - Default: [] - responses: - 200: - description: The completed request was successfully purged. - 500: - description: Returns an error message if the completed request could not be found. - content: - application/json: - schema: - type: object - - /admin/indexes/prepareds: - get: - operationId: get_prepared_indexes - summary: Retrieve Prepared Index Statements - description: |- - Returns all prepared index statements. - - * Use [Retrieve a Prepared Statement](#get_prepared) to get information about a prepared index statement. - * Use [Delete a Prepared Statement](#delete_prepared) to delete a prepared index statement. - tags: - - prepared statements - security: - - Default: [] - responses: - 200: - description: An array of strings, each of which is the name of a prepared index statement. - content: - application/json: - schema: - type: array - items: - type: string - description: |- - The name of the prepared statement. - This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. - - /admin/indexes/active_requests: - get: - operationId: get_active_indexes - summary: Retrieve Active Index Requests - description: |- - Returns all active index requests. - - * Use [Retrieve an Active Request](#get_active_request) to get information about an active index request. - * Use [Delete an Active Request](#delete_active_request) to terminate an active index request. - tags: - - active requests - security: - - Default: [] - responses: - 200: - description: An array of strings, each of which is the requestID of an active index request. - content: - application/json: - schema: - type: array - items: - type: string - description: Unique request ID internally generated for the query. - - /admin/indexes/completed_requests: - get: - operationId: get_completed_indexes - summary: Retrieve Completed Index Requests - description: |- - Returns all completed index requests. - - * Use [Retrieve a Completed Request](#get_completed_request) to get information about a completed index request. - * Use [Delete a Completed Request](#delete_completed_request) to purge a completed index request. - tags: - - completed requests - security: - - Default: [] - responses: - 200: - description: An array of strings, each of which is the requestID of a completed index request. - content: - application/json: - schema: - type: array - items: - type: string - description: Unique request ID internally generated for the query. - - /admin/ping: - get: - operationId: get_ping - summary: Ping - description: Returns a minimal response, indicating that the service is running and reachable. - tags: - - default - responses: - 200: - description: An empty object. - content: - application/json: - schema: - type: object - - /admin/gc: - get: - operationId: get_gc - summary: Run Garbage Collector - description: |- - This endpoint is available in databases running Couchbase Server 7.6.0 and later. - - Runs the garbage collector. - - A message is written to `query.log` whenever the garbage collector endpoint is invoked. - tags: - - default - security: - - Default: [] - responses: - 200: - description: Indicates that the garbage collector was invoked. - content: - application/json: - schema: - $ref: "#/components/schemas/Garbage" - 401: - description: |- - Error 10000: authentication failure. - The invoking user is not a valid full-admin user. - content: - application/json: - schema: - type: object - post: - operationId: post_gc - summary: Run Garbage Collector and Release Memory - description: |- - This endpoint is available in databases running Couchbase Server 7.6.0 and later. - - Runs the garbage collector and attempts to return freed memory to the OS. - - A message is written to `query.log` whenever the garbage collector endpoint is invoked. - tags: - - default - security: - - Default: [] - responses: - 200: - description: Indicates that the garbage collector was invoked. - content: - application/json: - schema: - $ref: "#/components/schemas/Garbage" - 401: - description: |- - Error 10000: authentication failure. - The invoking user is not a valid full-admin user. - content: - application/json: - schema: - type: object - - # /admin/ssl_cert: - # get: - # deprecated: true - - /admin/vitals: - get: - operationId: get_vitals - summary: Retrieve Vitals - description: |- - Returns data about the running state and health of the query engine. - This information can be very useful to assess the current workload and performance characteristics of a query engine, and hence load-balance the requests being sent to various query engines. - tags: - - statistics - security: - - Default: [] - responses: - 200: - description: An object containing all vital statistics. - content: - application/json: - schema: - $ref: "#/components/schemas/Vitals" - - /admin/stats: - get: - operationId: get_stats - summary: Retrieve All Statistics - description: Returns all statistics. - tags: - - statistics - security: - - Default: [] - responses: - 200: - description: |- - An object containing all statistics. - Each statistic consists of a top-level statistic name and a metric name. - Each statistic has a different set of metrics. - content: - application/json: - schema: - $ref: "#/components/schemas/Statistics" - - /admin/stats/{stat}: - get: - operationId: get_stat - summary: Retrieve a Statistic - parameters: - - $ref: "#/components/parameters/PathStat" - description: Returns the specified statistic. - tags: - - statistics - security: - - Default: [] - responses: - 200: - description: |- - An object containing all metrics for the specified statistic. - Each statistic has a different set of metrics. - content: - application/json: - schema: - $ref: "#/components/schemas/Metrics" - - /debug/vars: - get: - operationId: get_debug_vars - summary: Get Debug Variables - description: Currently unused. - tags: - - statistics - responses: - 302: - description: Redirects to the [Retrieve All Statistics](#get_stats) endpoint. - content: - text/html: - schema: - type: string - format: text/html - - /admin/settings: - get: - operationId: get_settings - summary: Retrieve Node-Level Query Settings - description: |- - Returns node-level query settings. - tags: - - settings - security: - - Default: [] - responses: - 200: - description: An object giving node-level query settings. - content: - application/json: - schema: - $ref: "#/components/schemas/Settings" - post: - operationId: post_settings - summary: Update Node-Level Query Settings - description: |- - Updates node-level query settings. - tags: - - settings - security: - - Default: [] - requestBody: - description: An object specifying node-level query settings. - content: - application/json: - schema: - $ref: "#/components/schemas/Settings" - application/x-www-form-urlencoded: - schema: - $ref: "#/components/schemas/Settings" - responses: - 200: - description: An object giving node-level query settings, including the latest changes. - content: - application/json: - schema: - $ref: "#/components/schemas/Settings" - -components: - schemas: - Clusters: - type: object - title: Cluster Information - properties: - name: - type: string - description: The name of the cluster. - datastore: - type: string - description: The URL of the datastore. - configstore: - type: string - description: The URL of the configstore. - accountstore: - type: string - description: The URL of the accountstore. - version: - type: string - - Nodes: - type: object - title: Node Information - properties: - cluster: - type: string - description: The name of the cluster. - name: - type: string - description: The URL of the node, including port number. - queryEndpoint: - type: string - description: The HTTP URL of the query endpoint. - adminEndpoint: - type: string - description: The HTTP URL of the admin endpoint. - querySecure: - type: string - description: The HTTPS URL of the query endpoint. - adminSecure: - type: string - description: The HTTPS URL of the admin endpoint. - options: - type: string - - Requests: - type: object - title: Requests - properties: - clientContextID: - type: string - description: |- - The opaque ID or context provided by the client. - x-desc-more: |- - Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. - - [client_context_id]: ../n1ql-rest-query/index.html#client_context_id - x-desc-refs: |- - [client_context_id]: #client_context_id - elapsedTime: - type: string - format: duration - description: |- - The time taken from when the request was acknowledged by the service to when the request was completed. - It includes the time taken by the service to schedule the request. - errorCount: - type: integer - description: Total number of errors encountered while executing the query. - ioTime: - type: string - format: duration - description: | - The total sum of [servTime][serv_time] across all operators. - - [serv_time]: ../n1ql-rest-query/index.html#serv_time - x-has-example: true - example: "752.858519ms" - memoryQuota: - type: integer - description: |- - The memory quota for the request, in MB. - This property is only returned if a memory quota is set for the query. - node: - type: string - description: IP address and port number of the node where the query is executed. - phaseCounts: - type: object - description: |- - Count of documents processed at selective phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. - - For active requests, this property is dynamic, depending on the documents processed by various phases up to this moment in time. - Polling the active requests again may return different values. - example: - { - "fetch": 16, - "indexScan": 187 - } - x-has-example: true - phaseOperators: - type: object - description: |- - Indicates the numbers of each kind of query operator involved in different phases of the query processing. - - For instance, a non-covering index path might involve one index scan and one fetch operator. - A join would probably involve two or more fetches, one per keyspace. - A union select would have twice as many operator counts, one per each branch of the union. - example: - { - "authorize": 1, - "fetch": 1, - "indexScan": 2 - } - x-has-example: true - phaseTimes: - type: object - description: |- - Cumulative execution times for various phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. - - For active requests, this property is dynamic, depending on the documents processed by various phases up to this moment in time. - Polling the active requests again may return different values. - example: - { - "authorize": "823.631µs", - "fetch": "656.873µs", - "indexScan": "29.146543ms", - "instantiate": "236.221µs", - "parse": "826.382µs", - "plan": "11.831101ms", - "run": "16.892181ms" - } - x-has-example: true - remoteAddr: - type: string - description: IP address and port number of the client application, from where the query is received. - requestId: - type: string - format: uuid - description: Unique request ID internally generated for the query. - requestTime: - type: string - format: date-time - description: Timestamp when the query is received. - resultCount: - type: integer - description: Total number of documents returned in the query result. - resultSize: - type: integer - description: Total number of bytes returned in the query result. - scanConsistency: - type: string - description: The value of the query setting Scan Consistency used for the query. - serviceTime: - type: string - format: duration - description: Total amount of calendar time taken to complete the query. - sessionMemory: - type: integer - format: bytes - description: | - The memory session size for the request, in bytes. - - Each request has a dedicated memory session. - When a query requires a document or value, memory is allocated from this session based on the size of the document or value. - Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. - - This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. - state: - type: string - description: |- - The state of the query execution, such as `completed`, `running`, `cancelled`. - - Note that the `completed` state means that the request was started and completed by the Query service, but it does not mean that it was necessarily successful. - The request could have been successful, or completed with errors. - - To find requests that were successful, use this field in conjunction with the `errorCount` field: search for requests whose state is `completed` and whose error count is `0`. - statement: - type: string - description: The query statement being executed. - useCBO: - type: boolean - description: Whether the cost-based optimizer is enabled for the query. - usedMemory: - type: integer - description: |- - The amount of document memory used to execute the request. - This property is only returned if a memory quota is set for the query. - userAgent: - type: string - description: Name of the client application or program that issued the query. - users: - type: string - description: Username with whose privileges the query is run. - waitTime: - type: string - format: duration - description: | - The total sum of [kernTime][kern_time] across all operators. - - [kern_time]: ../n1ql-rest-query/index.html#kern_time - x-has-example: true - example: "1.201307s" - ~analysis: - type: array - items: - type: string - description: | - An array of text phrases that provide a basic analysis of the request execution. - These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. - x-has-example: true - example: - [ - "High IO time", - "High primary scan document count" - ] - - Statements: - type: object - title: Prepared Statements - required: - - encoded_plan - - name - - statement - - uses - properties: - encoded_plan: - type: string - description: The full prepared statement in encoded format. - featureControls: - type: integer - description: |- - This property is provided for technical support only. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - indexApiVersion: - type: integer - description: |- - This property is provided for technical support only. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - name: - type: string - description: |- - The name of the prepared statement. - This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. - namespace: - type: string - description: |- - The namespace in which the prepared statement is stored. - Currently, only the `default` namespace is available. - node: - type: string - description: |- - The node on which the prepared statement is stored. - statement: - type: string - description: The text of the query. - uses: - type: integer - description: The count of times the prepared statement has been executed. - avgElapsedTime: - type: string - format: duration - description: |- - The mean time taken from when the request to execute the prepared statement was acknowledged by the service, to when the request was completed. - It includes the time taken by the service to schedule the request. - - This property is only returned when the prepared statement has been executed. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - avgServiceTime: - type: string - format: duration - description: |- - The mean amount of calendar time taken to complete the execution of the prepared statement. - - This property is only returned when the prepared statement has been executed. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - lastUse: - type: string - format: date-time - description: |- - Date and time of last use. - - This property is only returned when the prepared statement has been executed. - maxElapsedTime: - type: string - format: duration - description: |- - The maximum time taken from when the request to execute the prepared statement was acknowledged by the service, to when the request was completed. - It includes the time taken by the service to schedule the request. - - This property is only returned when the prepared statement has been executed. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - maxServiceTime: - type: string - format: duration - description: |- - The maximum amount of calendar time taken to complete the execution of the prepared statement. - - This property is only returned when the prepared statement has been executed. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - minElapsedTime: - type: string - format: duration - description: |- - The minimum time taken from when the request to execute the prepared statement was acknowledged by the service, to when the request was completed. - It includes the time taken by the service to schedule the request. - - This property is only returned when the prepared statement has been executed. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - minServiceTime: - type: string - format: duration - description: |- - The minimum amount of calendar time taken to complete the execution of the prepared statement. - - This property is only returned when the prepared statement has been executed. - It is only returned when retrieving a specific prepared statement, not when retrieving all prepared statements. - - Vitals: - type: object - title: Vital Statistics - properties: - bucket.IO.stats: - type: object - description: The number of reads and retries for each bucket. - uptime: - type: string - format: duration - description: The uptime of the query engine. - local.time: - type: string - format: date-time - description: The local time of the query engine. - version: - type: string - description: The version of the query engine. - total.threads: - type: integer - description: The number of active threads used by the query engine. - cores: - type: integer - description: The maximum number of logical cores available to the query engine. - ffdc.total: - type: integer - description: The total number of times FFDC has been invoked since the last restart. - gc.num: - type: integer - format: int64 - description: The target heap size of the next garbage collection cycle. - gc.pause.time: - type: string - format: duration - description: The total time spent pausing for garbage collection since the query engine started (ns). - gc.pause.percent: - type: integer - format: int64 - description: The percentage of time spent pausing for garbage collection since the last time the statistics were checked. - healthy: - type: boolean - description: False when either the unbounded or plus request queues are full; true otherwise. - host.memory.free: - type: integer - format: int64 - description: Amount of free memory on the host. - host.memory.quota: - type: integer - format: int64 - description: |- - The host memory quota. - This reflects the node-quota setting. - host.memory.total: - type: integer - format: int64 - description: Total memory on the host. - host.memory.value_quota: - type: integer - format: int64 - description: This the total document memory quota on the node. - load: - type: integer - description: A calculation for how busy the server is. - loadfactor: - type: integer - description: The moving 15 minute average of the load calculation. - memory.usage: - type: integer - format: int64 - description: |- - The amount of memory allocated for heap objects (bytes). - This increases as heap objects are allocated, and decreases as objects are freed. - memory.total: - type: integer - format: int64 - description: |- - The cumulative amount of memory allocated for heap objects (bytes). - This increases as heap objects are allocated, but does not decrease when objects are freed. - memory.system: - type: integer - format: int64 - description: |- - The total amount of memory obtained from the operating system (bytes). - This measures the virtual address space reserved by the query engine for heaps, stacks, and other internal data structures. - node: - type: string - description: The name or IP address and port of the node. - node.allocated.values: - type: integer - description: |- - The total number of values allocated to contain documents or computations around documents. - (This is only of relevance internally.) - node.memory.usage: - type: integer - description: The currently allocated document memory on the node. - cpu.user.percent: - type: integer - format: int64 - description: |- - CPU usage. - The percentage of time spent executing user code since the last time the statistics were checked. - cpu.sys.percent: - type: integer - format: int64 - description: |- - CPU usage. - The percentage of time spent executing system code since the last time the statistics were checked. - process.memory.usage: - type: integer - description: Current process memory use. - process.percore.cpupercent: - type: number - description: Average CPU usage per core. - process.rss: - type: integer - description: Process RSS (bytes) - process.service.usage: - type: integer - description: The number of active servicers for the dominant workload — unbound queue servicers or plus queue servicers. - request.completed.count: - type: integer - description: Total number of completed requests. - request.active.count: - type: integer - description: Total number of active requests. - request.per.sec.1min: - type: number - description: |- - Number of query requests processed per second. - 1-minute exponentially weighted moving average. - request.per.sec.5min: - type: number - description: |- - Number of query requests processed per second. - 5-minute exponentially weighted moving average. - request.per.sec.15min: - type: number - description: |- - Number of query requests processed per second. - 15-minute exponentially weighted moving average. - request.queued.count: - type: integer - description: Number of queued requests. - request.quota.used.hwm: - type: integer - description: High water mark for request quota use. - request_time.mean: - type: string - format: duration - description: |- - End-to-end time to process a query. - The mean value. - request_time.median: - type: string - format: duration - description: |- - End-to-end time to process a query. - The median value. - request_time.80percentile: - type: string - format: duration - description: |- - End-to-end time to process a query. - The 80th percentile. - request_time.95percentile: - type: string - format: duration - description: |- - End-to-end time to process a query. - The 95th percentile. - request_time.99percentile: - type: string - format: duration - description: |- - End-to-end time to process a query. - The 99th percentile. - request.prepared.percent: - type: integer - description: Percentage of requests that are prepared statements. - servicers.paused.count: - type: integer - description: |- - Number of servicers temporarily paused due to memory pressure. - (Applies to serverless environments only.) - servicers.paused.total: - type: integer - description: |- - Number of times servicers have been temporarily paused. - (Applies to serverless environments only.) - temp.hwm: - type: integer - description: |- - High water mark for temp space use directly by query. - (Doesn't include use by the GSI and Search clients.) - temp.usage: - type: integer - description: |- - Current Query temp space use. - (Doesn't include use by the GSI and Search clients.) - - Statistics: - type: object - title: Statistics - properties: - active_requests.count: - type: integer - description: Total number of active requests. - at_plus.count: - type: integer - description: Total number of query requests with `at_plus` index consistency. - audit_actions.count: - type: integer - description: |- - The total number of audit records sent to the server. - Some requests cause more than one audit record to be emitted. - Records in the output queue that have not yet been sent to the server are not counted. - audit_actions_failed.count: - type: integer - description: The total number of audit records sent to the server that failed. - audit_requests_filtered.count: - type: integer - description: The number of potentially auditable requests that cause no audit action to be taken. - audit_requests_total.count: - type: integer - description: The total number of potentially auditable requests sent to the query engine. - cancelled.count: - type: integer - description: Total number of cancelled requests. - deletes.count: - type: integer - description: Total number of DELETE operations. - errors.count: - type: integer - description: The total number of query errors returned so far. - index_scans.count: - type: integer - description: Total number of secondary index scans. - inserts.count: - type: integer - description: Total number of INSERT operations. - invalid_requests.count: - type: integer - description: Total number of requests for unsupported endpoints. - mutations.count: - type: integer - description: Total number of document mutations. - prepared.count: - type: integer - description: Total number of prepared statements executed. - primary_scans.count: - type: integer - description: Total number of primary index scans. - queued_requests.count: - type: integer - description: Total number of queued requests. - request_time.count: - type: integer - description: Total end-to-end time to process all queries (ns). - request_timer.15m.rate: - type: number - description: |- - Number of query requests processed per second. - 15-minute exponentially weighted moving average. - request_timer.1m.rate: - type: number - description: |- - Number of query requests processed per second. - 1-minute exponentially weighted moving average. - request_timer.5m.rate: - type: number - description: |- - Number of query requests processed per second. - 5-minute exponentially weighted moving average. - request_timer.75%: - type: number - description: |- - End-to-end time to process a query (ns). - The 75th percentile. - request_timer.95%: - type: number - description: |- - End-to-end time to process a query (ns). - The 95th percentile. - request_timer.99%: - type: number - description: |- - End-to-end time to process a query (ns). - The 99th percentile. - request_timer.99.9%: - type: number - description: |- - End-to-end time to process a query (ns). - The 99.9th percentile. - request_timer.count: - type: integer - description: Total number of query requests. - request_timer.max: - type: integer - description: |- - End-to-end time to process a query (ns). - The maximum value. - request_timer.mean: - type: number - description: |- - End-to-end time to process a query (ns). - The mean value. - request_timer.mean.rate: - type: number - description: |- - Number of query requests processed per second. - Mean rate since the query service started. - request_timer.median: - type: number - description: |- - End-to-end time to process a query (ns). - The median value. - request_timer.min: - type: integer - description: |- - End-to-end time to process a query (ns). - The minimum value. - request_timer.stddev: - type: number - description: |- - End-to-end time to process a query (ns). - The standard deviation. - requests.count: - type: integer - description: Total number of query requests. - requests_1000ms.count: - type: integer - description: Number of queries that take longer than 1000ms. - requests_250ms.count: - type: integer - description: Number of queries that take longer than 250ms. - requests_5000ms.count: - type: integer - description: Number of queries that take longer than 5000ms. - requests_500ms.count: - type: integer - description: Number of queries that take longer than 500ms. - result_count.count: - type: integer - description: Total number of results (documents) returned by the query engine. - result_size.count: - type: integer - description: Total size of data returned by the query engine (bytes). - scan_plus.count: - type: integer - description: Total number of query requests with `request_plus` index consistency. - selects.count: - type: integer - description: Total number of SELECT requests. - service_time.count: - type: integer - description: Time to execute all queries (ns). - unbounded.count: - type: integer - description: Total number of query requests with `not_bounded` index consistency. - updates.count: - type: integer - description: Total number of UPDATE requests. - warnings.count: - type: integer - description: The total number of query warnings returned so far. - - Metrics: - type: object - title: Metrics - properties: - count: - type: integer - description: A single value that represents the current state. - 15m.rate: - type: number - description: 15-minute exponentially weighted moving average. - 1m.rate: - type: number - description: 1-minute exponentially weighted moving average. - 5m.rate: - type: number - description: 5-minute exponentially weighted moving average. - mean.rate: - type: number - description: Mean rate since the query service started. - max: - type: integer - description: The maximum value. - mean: - type: number - description: The mean value. - median: - type: number - description: The median value. - min: - type: integer - description: The minimum value. - stddev: - type: number - description: The standard deviation. - 75%: - type: number - description: The 75th percentile. - 95%: - type: number - description: The 95th percentile. - 99%: - type: number - description: The 99th percentile. - 99.9%: - type: number - description: The 99.9th percentile. - - Settings: - type: object - title: Settings - properties: - atrcollection: - type: string - default: "" - example: default:`travel-sample`.transaction.test - x-has-default: true - x-has-example: true - x-desc-name: atrcollection-srv - description: |- - Specifies the collection where [active transaction records][additional-storage-use] are stored. - The collection must be present. - If not specified, the active transaction record is stored in the default collection in the default scope in the bucket containing the first mutated document within the transaction. - - The value must be a string in the form `"bucket.scope.collection"` or `"namespace:bucket.scope.collection"`. - If any part of the path contains a special character, that part of the path must be delimited in backticks ``. - - [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [request-level][atrcollection_req] `atrcollection` parameter specifies this property per request. - If a request does not include this parameter, the node-level `atrcollection` setting will be used. - - [atrcollection_req]: ../n1ql-rest-query/index.html#atrcollection_req - x-desc-refs: |- - [atrcollection_req]: #atrcollection_req - auto-prepare: - type: boolean - default: false - example: true - x-has-default: true - x-has-example: true - x-desc-name: auto-prepare - description: |- - Specifies whether the query engine should create a prepared statement every time a SQL++ request is submitted, whether the PREPARE statement is included or not. - - Refer to [Auto-Prepare][auto-prepare] for more information. - - [auto-prepare]: /cloud/n1ql/n1ql-language-reference/prepare.html#auto-prepare - - cleanupclientattempts: - type: boolean - default: true - example: false - x-has-default: true - x-has-example: true - x-desc-name: cleanupclientattempts - description: |- - When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. - x-desc-more: |- - The [cluster-level][queryCleanupClientAttempts] `queryCleanupClientAttempts` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryCleanupClientAttempts]: ../n1ql-rest-settings/index.html#queryCleanupClientAttempts - x-desc-refs: |- - [queryCleanupClientAttempts]: #queryCleanupClientAttempts - cleanuplostattempts: - type: boolean - default: true - example: false - x-has-default: true - x-has-example: true - x-desc-name: cleanuplostattempts - description: |- - When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. - x-desc-more: |- - The [cluster-level][queryCleanupLostAttempts] `queryCleanupLostAttempts` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryCleanupLostAttempts]: ../n1ql-rest-settings/index.html#queryCleanupLostAttempts - x-desc-refs: |- - [queryCleanupLostAttempts]: #queryCleanupLostAttempts - cleanupwindow: - type: string - format: duration - default: 60s - example: 30s - x-has-default: true - x-has-example: true - x-desc-name: cleanupwindow - description: |- - Specifies how frequently the Query service checks its subset of [active transaction records][additional-storage-use] for cleanup. - Decreasing this setting causes expiration transactions to be found more swiftly, with the tradeoff of increasing the number of reads per second used for the scanning process. - - The value for this setting is a string. - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [cluster-level][queryCleanupWindow] `queryCleanupWindow` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryCleanupWindow]: ../n1ql-rest-settings/index.html#queryCleanupWindow - x-desc-refs: |- - [queryCleanupWindow]: #queryCleanupWindow - completed: - type: object - title: Logging Parameters - default: {"aborted": null, "threshold": 1000} - example: {"user": "marco", "error": 12003} - x-desc-name: completed - description: |- - A nested object that sets the parameters for the completed requests catalog. - All completed requests that match these parameters are tracked in the completed requests catalog. - - Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. - - [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - properties: - aborted: - type: boolean - default: null - example: true - x-has-default: true - x-has-example: true - description: If true, all requests that generate a panic are logged. - client: - type: string - default: "" - example: "172.1.2.3" - x-has-default: true - x-has-example: true - description: |- - The IP address of the client. - If specified, all completed requests from this IP address are logged. - context: - type: string - description: |- - The opaque ID or context provided by the client. - If specified, all completed requests with this client context ID are logged. - x-desc-more: |- - Refer to the [request-level][client_context_id] `client_context_id` parameter for more information. - - [client_context_id]: ../n1ql-rest-query/index.html#client_context_id - x-desc-refs: |- - [client_context_id]: #client_context_id - error: - type: integer - format: int32 - default: null - example: 12003 - x-has-default: true - x-has-example: true - description: |- - An error number. - If specified, all completed queries returning this error number are logged. - tag: - type: string - default: "" - example: "both_user_and_error" - x-has-default: true - x-has-example: true - description: |- - A unique string which tags a set of qualifiers. - - Refer to [Configure Completed Requests][sys-completed-config] for more information. - - [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - threshold: - type: integer - format: int32 - default: 1000 - example: 7000 - x-has-default: true - x-has-example: true - description: |- - A duration in milliseconds. - If specified, all completed queries lasting longer than this threshold are logged. - - This is another way of specifying the `completed-threshold` setting. - user: - type: string - default: "" - example: "marco" - x-has-default: true - x-has-example: true - description: |- - A user name, as given in the request credentials. - If specified, all completed queries with this user name are logged. - statement: - type: string - default: "" - example: "%FIND USER%" - x-has-default: true - x-has-example: true - description: | - A LIKE search pattern to match against the query text. - If specified, all completed queries where the pattern is found are logged. - plan: - $ref: "#/components/schemas/Logging_Parameters_Plan" - errors: - type: integer - format: int32 - example: 5 - x-has-example: true - description: |- - The number of errors. - If specified, all completed queries that return at least this many errors are logged. - Queries with fewer errors are not logged. - completed-limit: - type: integer - format: int32 - default: 4000 - example: 7000 - x-has-default: true - x-has-example: true - x-desc-name: completed-limit - description: |- - Sets the number of requests to be logged in the completed requests catalog. - As new completed requests are added, old ones are removed. - - Increase this when the completed request keyspace is not big enough to track the slow requests, such as when you want a larger sample of slow requests. - - Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. - - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - x-desc-more: |- - The [cluster-level][queryCompletedLimit] `queryCompletedLimit` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryCompletedLimit]: ../n1ql-rest-settings/index.html#queryCompletedLimit - x-desc-refs: |- - [queryCompletedLimit]: #queryCompletedLimit - completed-max-plan-size: - type: integer - format: int32 - default: 262144 - minimum: 0 - maximum: 20840448 - x-has-default: true - x-desc-name: completed-max-plan-size - x-desc-status: Couchbase Server 7.6 - description: |- - This property is available in databases running Couchbase Server 7.6.0 and later. - - A plan size in bytes. - Limits the size of query execution plans that can be logged in the completed requests catalog. - Values larger than the maximum limit are silently treated as the maximum limit. - Queries with plans larger than this are not logged. - You must obtain execution plans for such queries via profiling or using the EXPLAIN statement. - - Refer to [Configure Completed Requests][sys-completed-config] for more information. - - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - x-desc-more: |- - The [cluster-level][queryCompletedMaxPlanSize] `queryCompletedMaxPlanSize` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryCompletedMaxPlanSize]: ../n1ql-rest-settings/index.html#queryCompletedMaxPlanSize - x-desc-refs: |- - [queryCompletedMaxPlanSize]: #queryCompletedMaxPlanSize - completed-stream-size: - type: integer - format: int32 - default: 0 - x-desc-name: completed-stream-size - description: |- - A file size in MiB. - When specified, completed requests are saved to the Couchbase Server `logs` directory. - Completed requests are saved to GZIP archives with the prefix `local_request_log`. - The value of this property determines the size of the data to retain, per node. - - Specify `0` (the default) to disable completed request streaming. - - Refer to [Stream Completed Requests][sys-history] for more information and examples. - - [sys-history]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-history - completed-threshold: - type: integer - format: int32 - default: 1000 - example: 7000 - x-has-default: true - x-has-example: true - x-desc-name: completed-threshold - description: |- - A duration in milliseconds. - All completed queries lasting longer than this threshold are logged in the completed requests catalog. - - Specify `0` to track all requests, independent of duration. - Specify any negative number to track none. - - Refer to [Configure Completed Requests][sys-completed-config] for more information and examples. - - [sys-completed-config]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - x-desc-more: |- - The [cluster-level][queryCompletedThreshold] `queryCompletedThreshold` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryCompletedThreshold]: ../n1ql-rest-settings/index.html#queryCompletedThreshold - x-desc-refs: |- - [queryCompletedThreshold]: #queryCompletedThreshold - controls: - type: boolean - default: false - example: true - x-has-default: true - x-has-example: true - x-desc-name: controls-srv - description: |- - Specifies if there should be a controls section returned with the request results. - - When set to `true`, the query response document includes a controls section with runtime information provided along with the request, such as positional and named parameters or settings. - - NOTE: If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. - x-desc-more: |- - The [request-level][controls_req] `controls` parameter specifies this property per request. - If a request does not include this parameter, the node-level `controls` setting will be used. - - [controls_req]: ../n1ql-rest-query/index.html#controls_req - x-desc-refs: |- - [controls_req]: #controls_req - cpuprofile: - type: string - default: "" - example: /tmp/info.txt - x-has-default: true - x-has-example: true - x-desc-name: cpuprofile - description: |- - The absolute path and filename to write the CPU profile to a local file. - - The output file includes a controls section and performance measurements, such as memory allocation and garbage collection, to pinpoint bottlenecks and ways to improve your code execution. - - NOTE: If `cpuprofile` is left running too long, it can slow the system down as its file size increases. - - To stop `cpuprofile`, run with the empty setting of `""`. - debug: - type: boolean - default: false - example: true - x-has-default: true - x-has-example: true - x-desc-name: debug - description: |- - Use debug mode. - - When set to `true`, extra logging is provided. - distribute: - type: boolean - example: true - x-has-example: true - x-desc-name: distribute - description: |- - This field is only available with the POST method. - When specified alongside other settings, this field instructs the node that is processing the request to cascade those settings to all other query nodes. - The actual value of this field is ignored. - functions-limit: - type: integer - format: int32 - default: 16384 - example: 7000 - x-has-default: true - x-has-example: true - x-desc-name: functions-limit - description: Maximum number of user-defined functions. - keep-alive-length: - type: integer - format: int32 - default: 16384 - example: 7000 - x-has-default: true - x-has-example: true - x-desc-name: keep-alive-length - description: Maximum size of buffered result. - loglevel: - type: string - default: INFO - enum: ["DEBUG","TRACE","INFO","WARN","ERROR","SEVERE","NONE"] - example: DEBUG - x-has-default: true - x-has-example: true - x-desc-name: loglevel - description: |- - Log level used in the logger. - - All values, in descending order of data: - - * `DEBUG` — For developers. - Writes everything. - - * `TRACE` — For developers. - Less info than `DEBUG`. - - * `INFO` — For admin & customers. - Lists warnings & errors. - - * `WARN` — For admin. - Only abnormal items. - - * `ERROR` — For admin. - Only errors to be fixed. - - * `SEVERE` — For admin. - Major items, like crashes. - - * `NONE` — Doesn't write anything. - x-desc-more: |- - The [cluster-level][queryLogLevel] `queryLogLevel` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryLogLevel]: ../n1ql-rest-settings/index.html#queryLogLevel - x-desc-refs: |- - [queryLogLevel]: #queryLogLevel - max-index-api: - type: integer - format: int32 - x-desc-name: max-index-api - description: |- - Max index API. - This setting is provided for technical support only. - max-parallelism: - type: integer - format: int32 - default: 1 - example: 0 - x-has-default: true - x-has-example: true - x-desc-name: max-parallelism-srv - description: |- - Specifies the maximum parallelism for queries on this node. - - If the value is zero or negative, the maximum parallelism is restricted to the number of allowed cores. - Similarly, if the value is greater than the number of allowed cores, the maximum parallelism is restricted to the number of allowed cores. - - (The number of allowed cores is the same as the number of logical CPUs. - In Community Edition, the number of allowed cores cannot be greater than 4. - In Enterprise Edition, there is no limit to the number of allowed cores.) - Refer to [Max Parallelism][max-parallelism] for more information. - - [max-parallelism]: /cloud/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism - x-desc-more: |- - The [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, there is a [request-level][max_parallelism_req] `max_parallelism` parameter. - If a request includes this parameter, it will be capped by the node-level `max-parallelism` setting. - - NOTE: To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. - - [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism - [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req - x-desc-refs: |- - [queryMaxParallelism]: #queryMaxParallelism - [max_parallelism_req]: #max_parallelism_req - memory-quota: - type: integer - format: int32 - default: 0 - example: 4 - x-has-default: true - x-has-example: true - x-desc-name: memory-quota-srv - description: |- - Specifies the maximum amount of memory a request may use on this node, in MB. - - Specify `0` (the default value) to disable. - When disabled, there is no quota. - - This parameter enforces a ceiling on the memory used for the tracked documents required for - processing a request. It does not take into account any other memory that might be used to - process a request, such as the stack, the operators, or some intermediate values. - - Within a transaction, this setting enforces the memory quota for the transaction by tracking the - delta table and the transaction log (approximately). - x-desc-more: |- - The [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][memory_quota_req] `memory_quota` parameter specifies this property per request. - If a request includes this parameter, it will be capped by the node-level `memory-quota` setting. - - [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota - [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req - x-desc-refs: |- - [queryMemoryQuota]: #queryMemoryQuota - [memory_quota_req]: #memory_quota_req - memprofile: - type: string - default: "" - example: /tmp/memory-usage.log - x-has-default: true - x-has-example: true - x-desc-name: memprofile - description: |- - Filename to write the diagnostic memory usage log. - - NOTE: If `memprofile` is left running too long, it can slow the system down as its file size increases. - - To stop `memprofile`, run with the empty setting of `""`. - mutexprofile: - type: boolean - default: false - x-has-default: true - x-desc-name: mutexprofile - description: |- - Mutex profile. - This setting is provided for technical support only. - n1ql-feat-ctrl: - type: integer - # type should be [string, integer] but swagger2markup cannot process - # fix with move to Redocly / openapi-generator - format: int32 - default: 76 - example: 16460 - x-example: "0x1" - x-has-default: true - x-has-example: true - x-desc-name: n1ql-feat-ctrl - description: |- - SQL++ feature control. - This setting is provided for technical support only. - The value may be an integer. - On databases running Couchbase Server 7.6 or later, it may also be a string representing a hexadecimal number. - x-desc-more: |- - The [cluster-level][queryN1QLFeatCtrl] `queryN1QLFeatCtrl` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryN1QLFeatCtrl]: ../n1ql-rest-settings/index.html#queryN1QLFeatCtrl - x-desc-refs: |- - [queryN1QLFeatCtrl]: #queryN1QLFeatCtrl - node-quota: - type: integer - format: int32 - default: 0 - x-has-default: true - x-desc-name: node-quota - x-desc-status: Couchbase Server 7.6 - description: |- - This property is available in databases running Couchbase Server 7.6.0 and later. - - Sets the soft memory limit for the Query service on this node, in MB. - The garbage collector tries to keep below this target. - It is not a hard, absolute limit, and memory usage may exceed this value. - - When set to `0` (the default), the Query service sets a default soft memory limit for the node. - To do this, the Query service calculates the difference between the total system RAM and 90% of the total system RAM: - - `Total System RAM - (0.9 * Total System RAM)` - - - If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. - - - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. - x-desc-more: |- - The [cluster-level][queryNodeQuota] `queryNodeQuota` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryNodeQuota]: ../n1ql-rest-settings/index.html#queryNodeQuota - x-desc-refs: |- - [queryNodeQuota]: #queryNodeQuota - node-quota-val-percent: - type: integer - format: int32 - default: 67 - minimum: 0 - maximum: 100 - x-has-default: true - x-desc-name: node-quota-val-percent - x-desc-status: Couchbase Server 7.6 - description: |- - This property is available in databases running Couchbase Server 7.6.0 and later. - - The percentage of the `node-quota` that is dedicated to tracked value content memory across all active requests on this node. - (The `memory-quota` setting specifies the maximum amount of document memory an individual request may use on this node.) - x-desc-more: |- - The [cluster-level][queryNodeQuotaValPercent] `queryNodeQuotaValPercent` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryNodeQuotaValPercent]: ../n1ql-rest-settings/index.html#queryNodeQuotaValPercent - x-desc-refs: |- - [queryNodeQuotaValPercent]: #queryNodeQuotaValPercent - num-cpus: - type: integer - format: int32 - default: 0 - x-has-default: true - x-desc-name: num-cpus - x-desc-status: Couchbase Server 7.6 - description: |- - This property is available in databases running Couchbase Server 7.6.0 and later. - - The number of CPUs the Query service can use on this node. - Note that this setting requires a restart of the Query service to take effect. - - When set to `0` (the default), the Query service can use all available CPUs, up to the limits described below. - - The number of CPUs can never be greater than the number of logical CPUs. - In Community Edition, the number of allowed CPUs cannot be greater than 4. - In Enterprise Edition, there is no limit to the number of allowed CPUs. - x-desc-more: |- - The [cluster-level][queryNumCpus] `queryNumCpus` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryNumCpus]: ../n1ql-rest-settings/index.html#queryNumCpus - x-desc-refs: |- - [queryNumCpus]: #queryNumCpus - numatrs: - type: string - x-desc-name: numatrs-srv - description: |- - Specifies the total number of [active transaction records][additional-storage-use]. - - [additional-storage-use]: /cloud/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][numatrs_req] `numatrs` parameter specifies this property per request. - The minimum of that and the node-level `numatrs` setting is applied. - - [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs - [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req - x-desc-refs: |- - [queryNumAtrs]: #queryNumAtrs - [numatrs_req]: #numatrs_req - pipeline-batch: - type: integer - format: int32 - default: 16 - example: 64 - x-has-default: true - x-has-example: true - x-desc-name: pipeline-batch-srv - description: |- - Controls the number of items execution operators can batch for Fetch from the KV. - x-desc-more: |- - The [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][pipeline_batch_req] `pipeline_batch` parameter specifies this property per request. - The minimum of that and the node-level `pipeline-batch` setting is applied. - - [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch - [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req - x-desc-refs: |- - [queryPipelineBatch]: #queryPipelineBatch - [pipeline_batch_req]: #pipeline_batch_req - pipeline-cap: - type: integer - format: int32 - default: 512 - example: 1024 - x-has-default: true - x-has-example: true - x-desc-name: pipeline-cap-srv - description: |- - Maximum number of items each execution operator can buffer between various operators. - x-desc-more: |- - The [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][pipeline_cap_req] `pipeline_cap` parameter specifies this property per request. - The minimum of that and the node-level `pipeline-cap` setting is applied. - - [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap - [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req - x-desc-refs: |- - [queryPipelineCap]: #queryPipelineCap - [pipeline_cap_req]: #pipeline_cap_req - plus-servicers: - type: integer - format: int32 - example: 16 - x-has-example: true - x-desc-name: plus-servicers - description: |- - The number of service threads for transactions where the scan consistency is `request_plus` or `at_plus`. - The default is 16 times the number of logical cores. - prepared-limit: - type: integer - format: int32 - default: 16384 - example: 65536 - x-has-default: true - x-has-example: true - x-desc-name: prepared-limit - description: |- - Maximum number of prepared statements in the cache. - When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. - x-desc-more: |- - The [cluster-level][queryPreparedLimit] `queryPreparedLimit` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [queryPreparedLimit]: ../n1ql-rest-settings/index.html#queryPreparedLimit - x-desc-refs: |- - [queryPreparedLimit]: #queryPreparedLimit - pretty: - type: boolean - default: false - example: true - x-has-default: true - x-has-example: true - x-desc-name: pretty-srv - description: |- - Specifies whether query results are returned in pretty format. - x-desc-more: |- - The [request-level][pretty_req] `pretty` parameter specifies this property per request. - If a request does not include this parameter, the node-level setting is used, which defaults to `false`. - - [pretty_req]: ../n1ql-rest-query/index.html#pretty_req - x-desc-refs: |- - [pretty_req]: #pretty_req - profile: - type: string - default: "off" - example: "phases" - x-has-default: true - x-has-example: true - enum: ["off","phases","timings"] - x-desc-name: profile-srv - description: |- - Specifies if there should be a profile section returned with the request results. - The valid values are: - - * `off` — No profiling information is added to the query response. - - * `phases` — The query response includes a profile section with stats and details about various phases of the query plan and execution. - Three phase times will be included in the `system:active_requests` and `system:completed_requests` monitoring keyspaces. - - * `timings` — Besides the phase times, the profile section of the query response document will include a full query plan with timing and information about the number of processed documents at each phase. - This information will be included in the `system:active_requests` and `system:completed_requests` keyspaces. - - NOTE: If `profile` is not set as one of the above values, then the profile setting does not change. - - Refer to [Monitoring and Profiling Details][monitor-profile-details] for more information and examples. - - [monitor-profile-details]: /cloud/n1ql/n1ql-manage/monitoring-n1ql-query.html#monitor-profile-details - x-desc-more: |- - The [request-level][profile_req] `profile` parameter specifies this property per request. - If a request does not include this parameter, the node-level `profile` setting will be used. - - [profile_req]: ../n1ql-rest-query/index.html#profile_req - x-desc-refs: |- - [profile_req]: #profile_req - request-size-cap: - type: integer - format: int32 - default: 67108864 - example: 70000 - x-has-default: true - x-has-example: true - x-desc-name: request-size-cap - description: Maximum size of a request. - scan-cap: - type: integer - format: int32 - default: 512 - example: 1024 - x-has-default: true - x-has-example: true - x-desc-name: scan-cap-srv - description: |- - Maximum buffered channel size between the indexer client and the query service for index scans. - This parameter controls when to use scan backfill. - - Use `0` or a negative number to disable. - Smaller values reduce GC, while larger values reduce indexer backfill. - x-desc-more: |- - The [cluster-level][queryScanCap] `queryScanCap` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][scan_cap_req] `scan_cap` parameter specifies this property per request. - The minimum of that and the node-level `scan-cap` setting is applied. - - [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap - [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req - x-desc-refs: |- - [queryScanCap]: #queryScanCap - [scan_cap_req]: #scan_cap_req - servicers: - type: integer - format: int32 - default: 32 - example: 8 - x-has-default: true - x-has-example: true - x-desc-name: servicers - description: |- - The number of service threads for the query. - The default is 4 times the number of cores on the query node. - timeout: - type: integer - format: int64 - default: 0 - example: 500000000 - x-has-default: true - x-has-example: true - x-desc-name: timeout-srv - description: |- - Maximum time to spend on the request before timing out (ns). - - The value for this setting is an integer, representing a duration in nanoseconds. - It must not be delimited by quotes, and must not include a unit. - - Specify `0` (the default value) or a negative integer to disable. - When disabled, no timeout is applied and the request runs for however long it takes. - x-desc-more: |- - The [cluster-level][queryTimeout] `queryTimeout` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][timeout_req] `timeout` parameter specifies this property per request. - The minimum of that and the node-level `timeout` setting is applied. - - [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout - [timeout_req]: ../n1ql-rest-query/index.html#timeout_req - x-desc-refs: |- - [queryTimeout]: #queryTimeout - [timeout_req]: #timeout_req - txtimeout: - type: integer - format: int64 - default: 0 - example: 500000000 - x-has-default: true - x-has-example: true - x-desc-name: txtimeout-srv - description: |- - Maximum time to spend on a transaction before timing out (ns). - This setting only applies to requests containing the `BEGIN TRANSACTION` statement, or to requests where the [tximplicit][tximplicit] parameter is set. - For all other requests, it is ignored. - - The value for this setting is an integer, representing a duration in nanoseconds. - It must not be delimited by quotes, and must not include a unit. - - Specify `0` (the default value) to disable. - When disabled, no timeout is applied and the transaction runs for however long it takes. - - [tximplicit]: ../n1ql-rest-query/index.html#tximplicit - x-desc-more: |- - The [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][txtimeout_req] `txtimeout` parameter specifies this property per request. - The minimum of that and the node-level `txtimeout` setting is applied. - - [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout - [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req - x-desc-refs: |- - [tximplicit]: #tximplicit - [queryTxTimeout]: #queryTxTimeout - [txtimeout_req]: #txtimeout_req - use-cbo: - type: boolean - default: true - example: false - x-has-default: true - x-has-example: true - x-desc-name: use-cbo-srv - description: |- - Specifies whether the cost-based optimizer is enabled. - x-desc-more: |- - The [cluster-level][queryUseCBO] `queryUseCBO` setting specifies this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][use_cbo_req] `use_cbo` parameter specifies this property per request. - If a request does not include this parameter, the node-level setting is used, which defaults to `true`. - - [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO - [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req - x-desc-refs: |- - [queryUseCBO]: #queryUseCBO - [use_cbo_req]: #use_cbo_req - use-replica: - type: string - default: unset - enum: ["off","on","unset"] - example: "on" - x-has-default: true - x-has-example: true - x-desc-name: use-replica-srv - x-desc-status: Couchbase Server 7.6 - description: |- - Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. - The possible values are: - - * `off` — read from replica is disabled for all queries and cannot be overridden at request level. - - * `on` — read from replica is enabled for all queries, but can be disabled at request level. - - * `unset` — read from replica is enabled or disabled at request level. - - Do not enable read from replica when you require consistent results. - Only SELECT queries that are not within a transaction can read from replica. - - Reading from replica is only possible with databases running Couchbase Server 7.6.0 or later. - - Note that KV range scans cannot currently be started on a replica vBucket. - If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. - x-desc-more: |- - The [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. - If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. - If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. - - [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica - [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req - x-desc-refs: |- - [queryUseReplica]: #queryUseReplica - [use_replica_req]: #use_replica_req - - Logging_Parameters_Plan: - title: Plan Qualifier - description: |- - An object, or an array of objects, containing one or more field:value pairs to match against the query plan. - Each pair describes a field in the query plan and the value it must have. - All completed queries where the specified field:value pairs are found in the plan are logged. - oneOf: - - $ref: '#/components/schemas/Logging_Parameters_Plan_Pairs' - - type: array - title: 'Repeated Field:Value Pairs' - example: - - index: ix1 - - index: ix2 - x-has-example: true - items: - $ref: '#/components/schemas/Logging_Parameters_Plan_Pairs' - - Logging_Parameters_Plan_Pairs: - type: object - title: 'Field:Value Pairs' - default: {} - example: - index: ix1 - '#operator': IntersectScan - x-has-default: true - x-has-example: true - additionalProperties: - description: |- - A field:value pair describing a field in the query plan, and the value that the field must have for the request to be logged. - The name of the property is the name of the field in the query plan. - The value may be a string, number, array, or any other JSON value. - - Within a single JSON object, if multiple field:value pairs are specified, then all pairs must be matched (using AND). - For example, `{"index": "ix1", "#operator": "IntersectScan"}` specifies that if the query plan has an `index` field with the value `"ix1"` AND has an `IntersectScan` operator, then the request should be logged. - - Within an array of JSON objects, each field:value pair must be unique, but fields can be repeated. - For example, `[{"index": "ix1"}, {"index": "ix2"}]` specifies that if the query plan has an `index` field with the value `"ix1"` AND another `index` field with the value `"ix2"`, then the request should be logged. - - Garbage: - type: object - title: Garbage Collection - properties: - freed: - type: integer - description: The amount of memory freed. - released: - type: integer - description: |- - Only returned by the POST method. - The amount of memory released to the OS. - status: - type: string - description: The status of the garbage collector. - required: - - freed - - status - - parameters: - PathStat: - name: stat - in: path - required: true - schema: - type: string - enum: - - active_requests - - at_plus - - audit_actions - - audit_actions_failed - - audit_requests_filtered - - audit_requests_total - - cancelled - - deletes - - errors - - index_scans - - inserts - - invalid_requests - - mutations - - prepared - - primary_scans - - queued_requests - - request_time - - request_timer - - requests - - requests_1000ms - - requests_250ms - - requests_5000ms - - requests_500ms - - result_count - - result_size - - scan_plus - - selects - - service_time - - unbounded - - updates - - warnings - description: |- - The name of a statistic. - Only top-level statistic names can be used. - You cannot specify a metric. - - PathName: - name: name - schema: - type: string - in: path - required: true - description: |- - The name of a prepared statement. - This may be a UUID that was assigned automatically, or a name that was user-specified when the statement was created. - - PathRequest: - name: request - schema: - type: string - in: path - required: true - description: |- - The name of a request. - This is the `requestID` that was assigned automatically when the statement was created. - - PathCluster: - name: cluster - schema: - type: string - in: path - required: true - description: The name of a cluster. - - PathNode: - name: node - schema: - type: string - in: path - required: true - description: The name of a node. - - securitySchemes: - Default: - type: http - scheme: basic - description: |- - The Admin API supports admin credentials. - Credentials can be passed via HTTP headers (HTTP basic authentication). diff --git a/docs/modules/n1ql-rest-admin/pages/index.adoc b/docs/modules/n1ql-rest-admin/pages/index.adoc index 90aaa989..3dd804c9 100644 --- a/docs/modules/n1ql-rest-admin/pages/index.adoc +++ b/docs/modules/n1ql-rest-admin/pages/index.adoc @@ -5025,6 +5025,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config + +endif::alt-markdown-links[] A unique string which tags a set of qualifiers. Refer to [Configure Completed Requests][sys-completed-config] for more information. @@ -5715,7 +5719,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] -[client_context_id]: #client_context_id +[client_context_id]: query-settings.html#client_context_id endif::alt-markdown-links[] The opaque ID or context provided by the client. @@ -6228,6 +6232,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[auto-prepare]: ../n1ql-language-reference/prepare.html#auto-prepare + +endif::alt-markdown-links[] Specifies whether the query engine should create a prepared statement every time a SQL++ request is submitted, whether the PREPARE statement is included or not. Refer to [Auto-Prepare][auto-prepare] for more information. @@ -6347,6 +6355,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config + +endif::alt-markdown-links[] include::index.adoc[tag=desc-Logging_Parameters, opts=optional] -- @@ -6363,6 +6375,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config [queryCompletedLimit]: #queryCompletedLimit endif::alt-markdown-links[] @@ -6398,6 +6411,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config [queryCompletedMaxPlanSize]: #queryCompletedMaxPlanSize endif::alt-markdown-links[] @@ -6434,6 +6448,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[sys-history]: monitoring-n1ql-query.html#sys-history + +endif::alt-markdown-links[] A file size in MiB. When specified, completed requests are saved to the Couchbase Server `logs` directory. Completed requests are saved to GZIP archives with the prefix `local_request_log`. @@ -6459,6 +6477,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config [queryCompletedThreshold]: #queryCompletedThreshold endif::alt-markdown-links[] @@ -6688,6 +6707,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[max-parallelism]: ../n1ql-language-reference/index-partitioning.html#max-parallelism [queryMaxParallelism]: #queryMaxParallelism [max_parallelism_req]: #max_parallelism_req @@ -7118,6 +7138,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[monitor-profile-details]: monitoring-n1ql-query.html#monitor-profile-details [profile_req]: #profile_req endif::alt-markdown-links[] diff --git a/docs/modules/n1ql-rest-functions/attachments/_functions.yaml b/docs/modules/n1ql-rest-functions/attachments/_functions.yaml deleted file mode 100644 index 553c65cf..00000000 --- a/docs/modules/n1ql-rest-functions/attachments/_functions.yaml +++ /dev/null @@ -1,264 +0,0 @@ -openapi: 3.0.3 -info: - title: Query Functions REST API - version: "8.0" - description: |- - The Query Functions REST API is a secondary API provided by the Query service. - This API enables you to manage the JavaScript libraries and objects that are used to create SQL++ user-defined functions. - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Query Service. - port: - default: "8093" - description: |- - The Query Service REST port. - Use `18093` for secure access. - enum: - - "8093" - - "18093" - -paths: - /evaluator/v1/libraries: - get: - operationId: get_collection - summary: Read All Libraries - parameters: - - name: bucket - schema: - type: string - in: query - required: false - description: > - For scoped libraries only. - The bucket from which to fetch libraries. - - name: scope - schema: - type: string - in: query - required: false - description: > - For scoped libraries only. - The scope from which to fetch libraries. - description: > - Returns all libraries and functions. - - - By default, this operation returns all global libraries and functions, and all scoped libraries and functions. - To return all the libraries and functions in a single scope, specify a bucket and scope. - security: - - Global: [] - - Scope: [] - responses: - "200": - description: An array of objects, each giving information about a single library. - content: - application/json: - schema: - type: array - items: - $ref: "#/components/schemas/Libraries" - "400": - $ref: "#/components/responses/BadRequest" - - /evaluator/v1/libraries/{library}: - parameters: - - $ref: "#/components/parameters/PathLibrary" - - $ref: "#/components/parameters/QueryBucket" - - $ref: "#/components/parameters/QueryScope" - get: - operationId: get_library - summary: Read a Library - description: > - Returns a library with all its functions. - - - By default, this operation returns a global library. - For a scoped library, you must specify the bucket and scope. - security: - - Global: [] - - Scope: [] - responses: - "200": - description: An object with a single property, giving information about the specified library. - content: - application/json: - schema: - $ref: "#/components/schemas/Functions" - "400": - $ref: "#/components/responses/BadRequest" - "404": - $ref: "#/components/responses/LibraryNotFound" - post: - operationId: post_library - summary: Create or Update a Library - description: > - Creates the specified library and its associated functions. - If the specified library exists, the existing library is overwritten. - - - By default, this operation creates or updates a global library. - For a scoped library, you must specify the bucket and scope. - requestBody: - required: true - description: The JavaScript code for all functions in the library. - content: - application/json: - schema: - type: string - example: function f2c(f) { return (5/9)*(f-32); } - x-has-example: true - security: - - Global: [] - - Scope: [] - responses: - "200": - $ref: "#/components/responses/OK" - "400": - description: > - Bad request. - The body of the request may be incorrect, or the path may not conform to the schema. - "404": - $ref: "#/components/responses/LibraryNotFound" - delete: - operationId: delete_library - summary: Delete a Library - description: | - Deletes the specified library entirely. - - By default, this operation deletes a global library. - For a scoped library, you must specify the bucket and scope. - security: - - Global: [] - - Scope: [] - responses: - "200": - $ref: "#/components/responses/OK" - "400": - $ref: "#/components/responses/BadRequest" - "404": - $ref: "#/components/responses/LibraryNotFound" - -components: - parameters: - PathLibrary: - name: library - schema: - type: string - in: path - required: true - description: The name of a library. - - QueryBucket: &queryBucket - name: bucket - schema: - type: string - in: query - required: false - description: > - For scoped libraries only. - The bucket in which the library is stored. - - QueryScope: &queryScope - name: scope - schema: - type: string - in: query - required: false - description: > - For scoped libraries only. - The scope in which the library is stored. - - schemas: - Libraries: - type: object - title: Library - properties: - name: - type: string - description: The name of a library. - example: math - x-has-example: true - bucket: - type: string - description: > - For scoped libraries, the bucket in which the library is stored. - For global libraries, this string is empty. - example: travel-sample - x-has-example: true - scope: - type: string - description: > - For scoped libraries, the scope in which the library is stored. - For global libraries, this string is empty. - example: inventory - x-has-example: true - code: - type: string - description: > - The JavaScript code for all functions in the library. - example: function add(a, b) { return a + b; } - function mul(a, b) { return a * b; } - x-has-example: true - required: - - name - - bucket - - scope - - code - - Functions: - type: object - title: Functions - additionalProperties: - type: string - description: | - The JavaScript code for all functions in the library. - - The name of the property is the name of the library. - example: function add(a, b) { return a + b; } - function mul(a, b) { return a * b; } - x-has-example: true - - responses: - OK: - description: The operation was successful. - - LibraryNotFound: - description: > - Not found. - The library name in the path may be incorrect, or the bucket and scope may be specified incorrectly. - - BadRequest: - description: > - Bad request. - The path may not conform to the schema. - - securitySchemes: - Global: - type: http - scheme: basic - description: | - To manage global libraries, users must have the *Manage Global External Functions* RBAC role. - - This role enables you to create, read, update, or delete any global library, but does not give you access to any scoped libraries. - - Scope: - type: http - scheme: basic - description: | - To manage scoped libraries, users must have the *Manage Scope External Functions* RBAC role, with permissions on the specified bucket and scope. - - This role enables you to create, read, update, or delete any library in the scope to which you have access, but does not give you access to any other scoped libraries. - In addition, this role enables you to read any global library, but not to create, update, or delete them. diff --git a/docs/modules/n1ql-rest-query/attachments/_query-service.yaml b/docs/modules/n1ql-rest-query/attachments/_query-service.yaml deleted file mode 100644 index b7039afc..00000000 --- a/docs/modules/n1ql-rest-query/attachments/_query-service.yaml +++ /dev/null @@ -1,1564 +0,0 @@ -openapi: 3.0.3 -info: - title: Query Service REST API - version: '8.0' - description: |- - The Query Service REST API is provided by the Query service. - This API enables you to run SQL++ queries and set request-level parameters. - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Query Service. - port: - default: "8093" - description: |- - The Query Service REST port. - Use `18093` for secure access. - enum: - - "8093" - - "18093" - -paths: - /query/service: - post: - operationId: post_service - summary: Query Service - description: |- - Enables you to execute a SQL++ statement. - This method allows you to run SELECT queries and other DML statements, and specify query parameters. - requestBody: - required: true - description: An object specifying one or more query parameters. - content: - application/json: - schema: - $ref: "#/components/schemas/Request" - application/x-www-form-urlencoded: - schema: - $ref: "#/components/schemas/Request" - security: - - Header: [] -# - Parameter: [] - responses: - "200": - $ref: '#/components/responses/OK' - "400": - $ref: '#/components/responses/BadRequest' - "401": - $ref: '#/components/responses/Unauthorized' - "403": - $ref: '#/components/responses/Forbidden' - "404": - $ref: '#/components/responses/NotFound' - "405": - $ref: '#/components/responses/MethodNotAllowed' - "409": - $ref: '#/components/responses/Conflict' - "410": - $ref: '#/components/responses/Gone' - "413": - $ref: '#/components/responses/PayloadTooLarge' - "500": - $ref: '#/components/responses/InternalServerError' - "503": - $ref: '#/components/responses/ServiceUnavailable' - get: - operationId: get_service - summary: Read-Only Query Service - description: |- - Enables you to execute a SQL++ statement. - This method allows you to run SELECT queries, and specify query parameters. - - This endpoint is intended for situations where use of the `POST` method is restricted. - parameters: - - name: body - in: query - required: true - style: form - explode: true - description: |- - Specify the parameters in the query URL in URL-encoded format. - The format for URL-encoded parameters is consistent with the syntax for variables according to RFC 6570. - schema: - $ref: "#/components/schemas/Request" - security: - - Header: [] -# - Parameter: [] - responses: - "200": - $ref: '#/components/responses/OK' - "400": - $ref: '#/components/responses/BadRequest' - "401": - $ref: '#/components/responses/Unauthorized' - "403": - $ref: '#/components/responses/Forbidden' - "404": - $ref: '#/components/responses/NotFound' - "405": - $ref: '#/components/responses/MethodNotAllowed' - "409": - $ref: '#/components/responses/Conflict' - "410": - $ref: '#/components/responses/Gone' - "413": - $ref: '#/components/responses/PayloadTooLarge' - "500": - $ref: '#/components/responses/InternalServerError' - "503": - $ref: '#/components/responses/ServiceUnavailable' - -# The output of this spec is used in more than one location, so Markdown cannot use relative links. -# Absolute links begin with /cloud -- this must be replaced for every branch. -# Relative links point to a location relative to the REST API reference page by default. -# The x-desc-refs attribute is used to override links when content is transcluded to other locations. - -# The AsciiDoc Markdown converter does not recognize HTML tags like . -# Use the x-desc-name vendor extension to specify the anchor for a property. - -components: - responses: - OK: - description: The operation was successful. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - example: - $ref: '../examples/exsuccessful.json' - - BadRequest: - description: |- - Bad Request. - The request cannot be processed for one of the following reasons: - the statement contains a SQL++ syntax error; - the request has a missing or unrecognized HTTP parameter; - the request is badly formatted — for example, the request body contains a JSON syntax error. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - examples: - n1qlerror: - summary: SQL++ Error - value: - $ref: '../examples/exn1qlerror.json' - requesterror: - summary: Request Error - value: - $ref: '../examples/exrequesterror.json' - - Unauthorized: - description: |- - Unauthorized. - The credentials provided with the request are missing or invalid. - - Forbidden: - description: |- - Forbidden. - There is a read-only violation. - Either there was an attempt to create or update in a GET request or a POST request where `readonly` is set, or the client does not have the authorization to modify an object (index, keyspace or namespace) in the statement. - - NotFound: - description: |- - Not found. - The statement in the request references an invalid namespace or keyspace. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - example: - $ref: '../examples/exnotfound.json' - - MethodNotAllowed: - description: |- - Method not allowed. - The statement in the request references an invalid namespace or keyspace. - - Conflict: - description: |- - Conflict. - There is an attempt to create an object (keyspace or index) that already exists. - - Gone: - description: |- - Gone. - The server is shutting down gracefully. - Previously made requests are being completed, but no new requests are being accepted. - - InternalServerError: - description: |- - Internal server error. - There was an unforeseen problem processing the request. - - PayloadTooLarge: - description: |- - Payload too large. - The query is too large for the Query Service to process. - - ServiceUnavailable: - description: |- - Service unavailable. - There is an issue (that is possibly temporary) preventing the request being processed; the request queue is full or the data store is not accessible. - content: - application/json: - schema: - $ref: "#/components/schemas/Response" - example: - $ref: '../examples/exserviceerror.json' - - schemas: - Request: - type: object - title: Request Parameters - properties: - args: - type: array - items: {} - x-desc-name: args - description: |- - Supplies the values for positional parameters in the statement. - Applicable if the statement or prepared statement contains 1 or more positional parameters. - - The value is an array of JSON values, one for each positional parameter in the statement. - - Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for details. - - [section_srh_tlm_n1b]: /cloud/n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b - x-has-example: true - example: - - LAX - - 6 - atrcollection: - type: string - x-desc-name: atrcollection_req - description: |- - Specifies the collection where the [active transaction record][additional-storage-use] (ATR) is stored. - The collection must be present. - If not specified, the ATR is stored in the default collection in the default scope in the bucket containing the first mutated document within the transaction. - - The value must be a string in the form `"bucket.scope.collection"` or `"namespace:bucket.scope.collection"`. - If any part of the path contains a special character, that part of the path must be delimited in backticks ``. - - [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [node-level][atrcollection-srv] `atrcollection` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - - [atrcollection-srv]: ../n1ql-rest-admin/index.html#atrcollection-srv - x-desc-refs: |- - [atrcollection-srv]: #atrcollection-srv - x-has-example: true - example: default:`travel-sample`.transaction.test - auto_execute: - type: boolean - x-desc-name: auto_execute - description: |- - Specifies that prepared statements should be executed automatically as soon as they are created. - This saves you from having to make two separate requests in cases where you want to prepare a statement and execute it immediately. - - Refer to [Auto-Execute][auto-execute] for more information. - - [auto-execute]: /cloud/n1ql/n1ql-language-reference/prepare.html#auto-execute - x-has-default: true - x-has-example: true - default: false - example: true - client_context_id: - type: string - x-desc-name: client_context_id - description: |- - A piece of data supplied by the client that is echoed in the response, if present. - SQL++ is agnostic about the content of this parameter; it is just echoed in the response. - - * Maximum allowed size is 64 characters; all others will be cut. - * If it contains an escape character `/` or quote `"`, it will be rejected as error code 1110. - compression: - type: string - x-desc-name: compression - description: |- - Compression format to use for response data on the wire. - - Values are case-insensitive. - enum: ["ZIP", "RLE", "LZMA", "LZO", "NONE"] - x-has-default: true - x-has-example: true - default: NONE - example: zip - controls: - type: boolean - x-desc-name: controls_req - description: |- - Specifies if there should be a controls section returned with the request results. - - When set to `true`, the query response document includes a controls section with runtime information provided along with the request, such as positional and named parameters or settings. - - If the request qualifies for caching, these values will also be cached in the `completed_requests` system keyspace. - x-desc-more: |- - The [node-level][controls-srv] `controls` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - - [controls-srv]: ../n1ql-rest-admin/index.html#controls-srv - x-desc-refs: |- - [controls-srv]: #controls-srv - x-has-example: true - example: true -# creds: -# type: array -# items: -# $ref: "#/components/schemas/Credentials" -# x-desc-name: creds -# description: |- -# Specifies the login credentials. -# The Query API supports two types of identity: local (or bucket) and admin. - -# The format is an identity and password. -# You can specify credentials for multiple identities. - -# If credentials are supplied in the request header, then HTTP Basic Authentication takes precedence and `creds` is ignored. -# x-has-example: true -# example: -# - user: local:bucket-name -# pass: password -# - user: admin:admin-name -# pass: password - durability_level: - type: string - x-desc-name: durability_level - description: |- - The level of [durability][durability] for mutations produced by the request. - - If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, the durability level is specified for all mutations within that transaction. - - Durability is also supported for non-transactional DML statements. - In this case, the `kvtimeout` parameter is used as the durability timeout. - - If not specified, the default durability level is `"majority"`. - Set the durability level to `"none"` or `""` to specify no durability. - - [durability]: /server/7.6/learn/data/durability.html - enum: - - "" - - none - - majority - - majorityAndPersistActive - - persistToMajority - x-has-default: true - x-has-example: true - default: majority - example: none - encoded_plan: - type: string - x-desc-name: encoded_plan - description: |- - In clusters running Couchbase Server 6.5 and later, this parameter is ignored and has no effect. - It is included for compatibility with previous versions. - encoding: - type: string - x-desc-name: encoding - description: |- - Desired character encoding for the query results. - - Only possible value is `UTF-8` and is case-insensitive. - x-has-default: true - default: UTF-8 - format: - type: string - x-desc-name: format - description: |- - Desired format for the query results. - - Values are case-insensitive. - enum: ["JSON", "XML", "CSV", "TSV"] - x-has-default: true - x-has-example: true - default: JSON - example: XML - kvtimeout: - type: string - x-desc-name: kvtimeout - description: |- - The approximate time to wait for a KV get operation before timing out. - This applies to statements within a transaction, and to non-transactional statements, whether `durability_level` is set or not. - - If `use_replica` is enabled for a query, then this parameter also specifies the approximate time to wait before fetching data from a replica vBucket when the active vBucket is inaccessible. - - The value for this parameter is a string. - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - Specify a duration of `0` or a negative duration to disable. - When disabled, no timeout is applied and the KV operation runs for however long it takes. - x-has-default: true - x-has-example: true - default: 2.5s - example: 10ms - max_parallelism: - type: integer - format: int32 - x-desc-name: max_parallelism_req - description: |- - Specifies the maximum parallelism for the query. - - The default value is the same as the number of partitions of the index selected for the query. - x-desc-more: |- - The [node-level][max-parallelism-srv] `max-parallelism` setting specifies the ceiling for this parameter for a single node. - If the request-level parameter is zero or negative, the parallelism for the query is set to the node-level setting. - If the request-level parameter is greater than zero and less than the node-level setting, the request-level parameter overrides the node-level setting. - If the request-level parameter is greater than the node-level setting, the parallelism for the query is set to the node-level setting. - - In addition, the [cluster-level][queryMaxParallelism] `queryMaxParallelism` setting specifies the ceiling for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. - - [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv - [queryMaxParallelism]: ../n1ql-rest-settings/index.html#queryMaxParallelism - x-desc-refs: |- - [max-parallelism-srv]: #max-parallelism-srv - [queryMaxParallelism]: #queryMaxParallelism - x-has-example: true - example: 3 - memory_quota: - type: integer - format: int32 - x-desc-name: memory_quota_req - description: |- - Specifies the maximum amount of memory the request may use, in MB. - - Specify `0` (the default value) to disable. - When disabled, there is no quota. - - This parameter enforces a ceiling on the memory used for the tracked documents required for - processing a request. It does not take into account any other memory that might be used to - process a request, such as the stack, the operators, or some intermediate values. - - Within a transaction, this setting enforces the memory quota for the transaction by tracking the - delta table and the transaction log (approximately). - x-desc-more: |- - The [node-level][memory-quota-srv] `memory-quota` setting specifies the ceiling for this parameter for a single node. - If the node-level setting is zero (the default), the request-level parameter overrides the node-level setting. - If the node-level setting is greater than zero, the request-level parameter is capped by the node-level setting. - - In addition, the [cluster-level][queryMemoryQuota] `queryMemoryQuota` setting specifies the ceiling for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv - [queryMemoryQuota]: ../n1ql-rest-settings/index.html#queryMemoryQuota - x-desc-refs: |- - [memory-quota-srv]: #memory-quota-srv - [queryMemoryQuota]: #queryMemoryQuota - x-has-default: true - x-has-example: true - default: 0 - example: 4 - metrics: - type: boolean - x-desc-name: metrics - description: Specifies that metrics should be returned with query results. - x-has-default: true - x-has-example: true - default: true - example: false - namespace: - type: string - x-desc-name: namespace - description: |- - Specifies the namespace to use. - Currently, only the `default` namespace is available. - x-has-example: true - example: default - natural: - type: string - x-desc-name: natural - x-desc-status: Couchbase Server 8.0 - description: |- - The prompt for a natural language request. - The Query Service uses the prompt to generate a SQL++ statement. - - If the generated statement is a SELECT statement, the generated statement is returned and executed automatically. - - If the generated statement is not a SELECT statement, the generated statement is returned, but not executed. - In this case, you must verify the statement and execute it in a separate request. - - Natural language requests use the Couchbase Capella iQ service as a backend. - You must have a Couchbase Capella account to make a natural language request. - - This parameter is available in clusters running Couchbase Server 8.0 and later. - - To use this parameter, you must also specify the `natural_cred`, `natural_orgid`, and `natural_context` parameters. - If you don't specify all four parameters, the Query Service returns an error. - x-has-example: true - example: Show me count of airlines per country - natural_cred: - type: string - format: password - x-desc-name: natural_cred - x-desc-status: Couchbase Server 8.0 - description: |- - The Couchbase Capella credentials for a natural language request, in the form `username:password`. - Be careful not to expose the credentials in log files or other output. - - Natural language requests use the Couchbase Capella iQ service as a backend. - You must have a Couchbase Capella account to make a natural language request. - - This parameter is available in clusters running Couchbase Server 8.0 and later. - - To use this parameter, you must also specify the `natural`, `natural_orgid`, and `natural_context` parameters. - If you don't specify all four parameters, the Query Service returns an error. - x-has-example: true - example: username:password - natural_orgid: - type: string - format: uuid - x-desc-name: natural_orgid - x-desc-status: Couchbase Server 8.0 - description: |- - The Couchbase Capella organization ID for a natural language request. - - Natural language requests use the Couchbase Capella iQ service as a backend. - You must have a Couchbase Capella account to make a natural language request. - - This parameter is available in clusters running Couchbase Server 8.0 and later. - - To use this parameter, you must also specify the `natural`, `natural_cred`, and `natural_context` parameters. - If you don't specify all four parameters, the Query Service returns an error. - natural_context: - type: string - x-desc-name: natural_context - x-desc-status: Couchbase Server 8.0 - description: |- - A list of paths specifying keyspaces for a natural language request. - The Query Service infers the schema of each keyspace, in order to give more precise responses from the natural language request. - - The parameter may contain up to four paths, separated by commas. - Spaces are allowed. - Each path may be: - - * A full path, in the form `bucket.scope.collection` or `namespace:bucket.scope.collection`. - - * A path prefix, in the form `namespace:bucket` or `bucket`, to specify the default collection in the default scope. - - * A partial path, in the form `collection`. - In this case, you must specify the `query_context` parameter to provide the bucket and scope. - - Natural language requests use the Couchbase Capella iQ service as a backend. - You must have a Couchbase Capella account to make a natural language request. - - This parameter is available in clusters running Couchbase Server 8.0 and later. - - To use this parameter, you must also specify the `natural`, `natural_cred`, and `natural_orgid` parameters. - If you don't specify all four parameters, the Query Service returns an error. - x-has-example: true - example: travel-sample, travel-sample.inventory.airline, airline - natural_output: - type: string - x-desc-name: natural_output - x-desc-status: Couchbase Server 8.0 - description: |- - Specifies the required output for a natural language request. - - * `sql` — - The output is a SQL++ statement. - - * `jsudf` — - The output is a `CREATE FUNCTION` statement which you can use to generate a SQL++ managed JavaScript user-defined function. - - * `ftssql` — - The output is a SQL++ statement which can use a Flex index, if available. - - Natural language requests use the Couchbase Capella iQ service as a backend. - You must have a Couchbase Capella account to make a natural language request. - - This parameter is available in clusters running Couchbase Server 8.0 and later. - x-has-default: true - default: sql - enum: ["sql", "jsudf", "ftssql"] - numatrs: - type: integer - format: int32 - x-desc-name: numatrs_req - description: |- - Specifies the total number of [active transaction records][additional-storage-use]. - Must be a positive integer. - - [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [node-level][numatrs-srv] `numatrs` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - - In addition, the [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv - [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs - x-desc-refs: |- - [numatrs-srv]: #numatrs-srv - [queryNumAtrs]: #queryNumAtrs - x-has-default: true - x-has-example: true - default: 1024 - example: 512 - pipeline_batch: - type: integer - format: int32 - x-desc-name: pipeline_batch_req - description: |- - Controls the number of items execution operators can batch for Fetch from the KV. - x-desc-more: |- - The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. - - In addition, the [cluster-level][queryPipelineBatch] `queryPipelineBatch` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv - [queryPipelineBatch]: ../n1ql-rest-settings/index.html#queryPipelineBatch - x-desc-refs: |- - [pipeline-batch-srv]: #pipeline-batch-srv - [queryPipelineBatch]: #queryPipelineBatch - x-has-example: true - example: 64 - pipeline_cap: - type: integer - format: int32 - x-desc-name: pipeline_cap_req - description: |- - Maximum number of items each execution operator can buffer between various operators. - x-desc-more: |- - The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. - - In addition, the [cluster-level][queryPipelineCap] `queryPipelineCap` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv - [queryPipelineCap]: ../n1ql-rest-settings/index.html#queryPipelineCap - x-desc-refs: |- - [pipeline-cap-srv]: #pipeline-cap-srv - [queryPipelineCap]: #queryPipelineCap - x-has-example: true - example: 1024 - prepared: - type: string - x-desc-name: prepared - description: |- - _Required_ if `statement` or `natural` not provided. - - The name of the prepared SQL++ statement to be executed. - Refer to [EXECUTE][execute] for examples. - - If both `prepared` and `statement` are present and non-empty, an error is returned. - - [execute]: /cloud/n1ql/n1ql-language-reference/execute.html - x-has-example: true - example: a1355198-2576-4e3d-af04-5acc77d8a681 - x-example: "[127.0.0.1:8091]pricy_hotel" - preserve_expiry: - type: boolean - x-desc-name: preserve_expiry - description: |- - Specifies whether documents should keep their current expiration setting when modified by a DML statement. - - If `true`, documents will keep any existing expiration setting when modified by a DML statement. - If the DML statement explicitly specifies the document expiration, the statement overrides this parameter, and the expiration is changed. - - If `false`, document expiration is set to 0 when modified by a DML statement, unless the DML statement explicitly specifies the document expiration. - - Not supported for statements in a transaction. - x-has-default: true - x-has-example: true - default: false - example: true - pretty: - type: boolean - x-desc-name: pretty_req - description: |- - Specifies the query results returned in pretty format. - x-desc-more: |- - The [node-level][pretty-srv] `pretty` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - - [pretty-srv]: ../n1ql-rest-admin/index.html#pretty-srv - x-desc-refs: |- - [pretty-srv]: #pretty-srv - x-has-example: true - example: false - profile: - type: string - x-desc-name: profile_req - description: |- - Specifies if there should be a profile section returned with the request results. - The valid values are: - - * `off` — No profiling information is added to the query response. - - * `phases` — - The query response includes a profile section with stats and details about various phases of the query plan and execution. - Three phase times will be included in the `system:active_requests` and `system:completed_requests` monitoring keyspaces. - - * `timings` — - Besides the phase times, the profile section of the query response document will include a full query plan with timing and information about the number of processed documents at each phase. - This information will be included in the `system:active_requests` and `system:completed_requests` keyspaces. - - If `profile` is not set as one of the above values, then the profile setting does not change. - x-desc-more: |- - The [node-level][profile-srv] `profile` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - - [profile-srv]: ../n1ql-rest-admin/index.html#profile-srv - x-desc-refs: |- - [profile-srv]: #profile-srv - enum: ["off", "phases", "timings"] - x-has-example: true - example: phases - query_context: - type: string - x-desc-name: query_context - description: |- - Specifies the namespace, bucket, and scope used to resolve partial keyspace references within the request. - - The query context may be a _full path_, containing namespace, bucket, and scope; or a _relative path_, containing just the bucket and scope. - Currently, only the `default` namespace is available. - If the namespace name is omitted, the default namespace in the current session is used. - x-has-default: true - x-has-example: true - default: "default:" - example: default:travel-sample.inventory - readonly: - type: boolean - x-desc-name: readonly - description: |- - Controls whether a query can change a resulting recordset. - - If `readonly` is `true`, then the following statements are not allowed: - - * CREATE INDEX - * DROP INDEX - * INSERT - * MERGE - * UPDATE - * UPSERT - - When using GET requests, it's best to set `readonly` to `true`. - x-has-default: true - x-has-example: true - default: false - example: true - scan_cap: - type: integer - format: int32 - x-desc-name: scan_cap_req - description: |- - Maximum buffered channel size between the indexer client and the query service for index scans. - This parameter controls when to use scan backfill. - - Use `0` or a negative number to disable. - Smaller values reduce GC, while larger values reduce indexer backfill. - x-desc-more: |- - The [node-level][scan-cap-srv] `scan-cap` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting, but only if it is lower than the node-level setting. - - In addition, the [cluster-level][queryScanCap] `queryScanCap` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv - [queryScanCap]: ../n1ql-rest-settings/index.html#queryScanCap - x-desc-refs: |- - [scan-cap-srv]: #scan-cap-srv - [queryScanCap]: #queryScanCap - x-has-example: true - example: 1024 - scan_consistency: - type: string - x-desc-name: scan_consistency - description: |- - Specifies the consistency guarantee or constraint for index scanning. - The valid values are: - - * `not_bounded` — - No timestamp vector is used in the index scan. - This is the fastest mode, because it avoids the costs of obtaining the vector and waiting for the index to catch up to the vector. - - * `at_plus` — - This implements bounded consistency. - The request includes a `scan_vector` parameter and value, which is used as a lower bound. - This can be used to implement read-your-own-writes (RYOW). - - * `request_plus` — - This implements strong consistency per request. - Before processing the request, a current vector is obtained. - The vector is used as a lower bound for the statements in the request. - If there are DML statements in the request, RYOW is also applied within the request. - (If `request_plus` is specified in a query that runs during a failover of an index node, the query waits until the rebalance operation completes and the index data has rebalanced before returning a result.) - - * `statement_plus` — - This implements strong consistency per statement. - Before processing each statement, a current vector is obtained and used as a lower bound for that statement. - - Values are case-insensitive. - - For multi-statement requests, the default behavior is RYOW within each request. - If you want to disable RYOW within a request, add a separate `request_consistency` parameter that can be set to `not_bounded`. - - If the request contains a `BEGIN TRANSACTION` statement, or a DML statement with the `tximplicit` parameter set to `true`, then this parameter sets the transactional scan consistency. - Refer to [Transactional Scan Consistency][transactional-scan-consistency] for details. - - [transactional-scan-consistency]: /cloud/n1ql/n1ql-manage/query-settings.html#transactional-scan-consistency - enum: ["not_bounded", "at_plus", "request_plus", "statement_plus"] - x-has-default: true - x-has-example: true - default: not_bounded - example: at_plus - scan_vector: - type: object - x-type: array - x-desc-name: scan_vector - description: |- - _Required_ if `scan_consistency` is `at_plus` and `scan_vectors` not provided. - - Specify the lower bound vector timestamp for one keyspace when using `at_plus` scan consistency. - - Scan vectors are built of two-element [`value`, `guard`] entries: - - * `value`: a vBucket's sequence number (a JSON number) - * `guard`: a vBucket's UUID (a string) - - Scan vectors have two forms: - - 1. Full: an array of [`value`, `guard`] entries, giving an entry for every vBucket in the system. - 2. Sparse: an object providing entries for specific vBuckets, mapping a vBucket number (a string) to each [`value`, `guard`] entry. - - Note that `scan_vector` can only be used if the query uses at most one keyspace; if it is used for a query referencing more than one keyspace, the query will fail with an error. - - For queries referencing multiple keyspaces, use `scan_vectors`. - x-has-example: true - example: - 5: - - 5409393 - - VB5ID - 19: - - 47574574 - - VB19ID - scan_vectors: - type: object - x-type: array - x-desc-name: scan_vectors - description: |- - _Required_ if `scan_consistency` is `at_plus` and `scan_vector` not provided. - - A map from keyspace names to scan vectors. - See `scan_vector`. - - The scan vectors can be Full or Sparse. - scan_wait: - type: string - format: duration - x-desc-name: scan_wait - description: |- - Can be supplied with `scan_consistency` values of `request_plus`, `statement_plus` and `at_plus`. - - Specifies the maximum time the client is willing to wait for an index to catch up to the vector timestamp in the request. - - Specifies how much time the client is willing to wait for the indexer to satisfy the required `scan_consistency` and `scan_vector` criteria. - After receiving the scan request, if the indexer is unable to catch up within the `scan_wait` time and initiate the scan, the indexer aborts with an error and the scan fails. - - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - Specify `0` or a negative integer to disable. - x-has-default: true - x-has-example: true - default: "" - example: 30m - signature: - type: boolean - x-desc-name: signature - description: Include a header for the results schema in the response. - x-has-default: true - x-has-example: true - default: true - example: false - sort_projection: - type: boolean - x-desc-name: sort_projection - description: |- - If `true`, causes statement projection terms to be sorted alphabetically. - - If `false` (the default), statement projection terms are returned in the order specified by the query. - x-has-default: true - x-has-example: true - default: false - example: true - statement: - type: string - x-desc-name: statement - description: |- - _Required_ if `prepared` or `natural` not provided. - - Any valid SQL++ statement for a POST request, or a read-only SQL++ statement (SELECT, EXPLAIN) for a GET request. - - If both `prepared` and `statement` are present and non-empty, an error is returned. - - --- - - When specifying the request parameters as form data, the statement may not contain an unescaped semicolon (`;`). - If it does, the Query Service responds with error 1040. - To avoid this, either URL-encode the semicolon as `%3B`, or just omit the semicolon if possible. - - This restriction does not apply when specifying the request parameters in JSON format. - x-has-example: true - example: SELECT * FROM `travel-sample`.inventory.hotel LIMIT 1 - timeout: - type: string - format: duration - x-desc-name: timeout_req - description: |- - Maximum time to spend on the request before timing out. - - The value for this parameter is a string. - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - Specify a duration of `0` or a negative duration to disable. - When disabled, no timeout is applied and the request runs for however long it takes. - - If `tximplicit` or `txid` is set, this parameter is ignored. - The request inherits the remaining time of the transaction as timeout. - x-desc-more: |- - The [node-level][timeout-srv] `timeout` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - However, if the node-level setting is greater than 0, the timeout for the query is limited to the node-level setting. - - In addition, the [cluster-level][queryTimeout] `queryTimeout` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv - [queryTimeout]: ../n1ql-rest-settings/index.html#queryTimeout - x-desc-refs: |- - [timeout-srv]: #timeout-srv - [queryTimeout]: #queryTimeout - x-has-example: true - example: 30m - txdata: - type: object - x-desc-name: txdata - description: |- - Transaction data. - For internal use only. - txid: - type: string - format: UUID - x-desc-name: txid - description: |- - _Required_ for statements within a transaction. - - Transaction ID. - Specifies the transaction to which a statement belongs. - For use with DML statements within a transaction, rollbacks, and commits. - - The transaction ID should be the same as the transaction ID generated by the `BEGIN TRANSACTION` statement. - The transaction must be active and non-expired. - x-has-example: true - example: d81d9b4a-b758-4f98-b007-87ba262d3a51 - tximplicit: - type: boolean - x-desc-name: tximplicit - description: |- - Specifies that a DML statement is a singleton transaction. - - When this parameter is true, the Query service starts a transaction and executes the statement. - If execution is successful, the Query service commits the transaction; otherwise the transaction is rolled back. - - The statement may not be part of an ongoing transaction. - If the `txid` request-level parameter is set, the `tximplicit` parameter is ignored. - x-has-default: true - x-has-example: true - default: false - example: true - txstmtnum: - type: integer - format: int32 - x-desc-name: txstmtnum - description: |- - Transaction statement number. - The transaction statement number must be a positive integer, and must be higher than any previous transaction statement numbers in the transaction. - If the transaction statement number is lower than the transaction statement number for any previous statement, an error is generated. - x-has-example: true - example: 10 - txtimeout: - type: string - format: duration - x-desc-name: txtimeout_req - description: |- - Maximum time to spend on a transaction before timing out. - Only applies to `BEGIN TRANSACTION` statements, or DML statements for which `tximplicit` is set. - For other statements, it is ignored. - - Within a transaction, the request-level `timeout` parameter is ignored. - The transaction timeout clock starts when the `BEGIN WORK` statement is successful. - Once the transaction timeout is reached, no statement is allowed to continue in the transaction. - - The value for this parameter is a string. - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - Specify a duration of `0` to disable. - When disabled, the request-level timeout is set to the default. - - The default is `"15s"` for cbq files or scripts, `"2m"` for interactive cbq sessions or redirected input. - x-desc-more: |- - The [node-level][txtimeout-srv] `txtimeout` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - However, if the node-level setting is greater than 0, the transaction timeout for the query is limited to the node-level setting. - - In addition, the [cluster-level][queryTxTimeout] `queryTxTimeout` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv - [queryTxTimeout]: ../n1ql-rest-settings/index.html#queryTxTimeout - x-desc-refs: |- - [txtimeout-srv]: #txtimeout-srv - [queryTxTimeout]: #queryTxTimeout - x-has-example: true - example: 30m - use_cbo: - type: boolean - x-desc-name: use_cbo_req - description: |- - Specifies whether the cost-based optimizer is enabled. - x-desc-more: |- - The [node-level][use-cbo-srv] `use-cbo` setting specifies the default for this parameter for a single node. - The request-level parameter overrides the node-level setting. - - In addition, the [cluster-level][queryUseCBO] `queryUseCBO` setting specifies the default for this parameter for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv - [queryUseCBO]: ../n1ql-rest-settings/index.html#queryUseCBO - x-desc-refs: |- - [use-cbo-srv]: #use-cbo-srv - [queryUseCBO]: #queryUseCBO - x-has-example: true - example: true - use_fts: - type: boolean - x-desc-name: use_fts - x-desc-edition: "{enterprise}" - description: |- - Specifies that the query should use a Search index. - - If the query contains a `USING FTS` hint, that takes priority over this parameter. - - If the query does not contain a `USING FTS` hint, and this parameter is set to true, all Search indexes are considered for the query. - If a qualified Search index is available, it is selected for the query. - If none of the available Search indexes are qualified, the available GSI indexes are considered instead. - - Refer to [Flex Indexes][flex-indexes] for more information. - - [flex-indexes]: /cloud/n1ql/n1ql-language-reference/flex-indexes.html - x-has-default: true - x-has-example: true - default: false - example: true - use_replica: - type: string - enum: ["off","on","unset"] - x-has-default: true - x-has-example: true - default: unset - example: on - x-desc-name: use_replica_req - description: |- - Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. - The possible values are: - - * `off` — read from replica is disabled for this request. - - * `on` — read from replica is enabled for this request, unless it has been disabled for all requests at node level. - - * `unset` — read from replica is specified by the node-level setting. - If the node-level setting is also `unset`, read from replica is disabled for this request. - - Do not enable read from replica when you require consistent results. - Only SELECT queries that are not within a transaction can read from replica. - - Reading from replica is only possible with databases running Couchbase Server 7.6.0 or later. - - Note that KV range scans cannot currently be started on a replica vBucket. - If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. - x-desc-more: |- - The [node-level][use-replica-srv] `use-replica` setting specifies the default for this property for a single node. - The request-level parameter usually overrides the node-level setting. - However, when the node-level setting is `off`, the request-level parameter cannot enable the property. - - In addition, the [cluster-level][queryUseReplica] `queryUseReplica` setting specifies the default for this property for the whole cluster. - When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster. - - [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv - [queryUseReplica]: ../n1ql-rest-settings/index.html#queryUseReplica - x-desc-refs: |- - [use-replica-srv]: #use-replica-srv - [queryUseReplica]: #queryUseReplica - additionalProperties: - x-desc-name: identifier - x-additionalPropertiesName: $identifier - description: |- - Supplies the value for a named parameter in the statement. - Applicable if the statement or prepared statement contains 1 or more named parameters. - - The name of this property consists of two parts: - - 1. The `$` character. - In databases running Couchbase Server 7.6.0 and later, this may be the `$` character or the `@` character. - 2. An identifier that specifies the name of the parameter. - This starts with an optional underscore (`_`), followed by an alpha character, followed by one or more alphanumeric characters, and ends with an optional underscore (`_`). - - If the named parameter contains sensitive information, start and end the name of the parameter (after the initial `$` or `@`) with an underscore (`_`). - This masks the parameter value in the active requests catalog, the completed requests catalog, the response `controls` section, the cbq shell file history, and the query logs. - When masked, a string parameter value is replaced by asterisks (`*`); other parameter values are replaced by `null`. - Parameter masking is available in clusters running Couchbase Server 7.6.8 and later. - - The value of the named parameter can be any JSON value. - - Refer to [Named Parameters and Positional Parameters][section_srh_tlm_n1b] for details. - - [section_srh_tlm_n1b]: /cloud/n1ql/n1ql-manage/query-settings.html#section_srh_tlm_n1b - -# Credentials: -# type: object -# title: Credentials -# properties: -# user: -# type: string -# description: |- -# An identity for authentication. -# Note that bucket names may be prefixed with `local:`, and admin names may be prefixed with `admin:`. -# pass: -# type: string -# description: A password for authentication. - - Response: - type: object - title: Response Body - description: The response body has the following structure. - properties: - requestID: - type: string - format: UUID - description: A unique identifier for the response. - clientContextID: - type: string - description: The client context ID of the request, if one was supplied — see `client_context_id` in [Request Parameters](#Request). - generated_statement: - type: string - x-desc-status: Couchbase Server 8.0 - description: |- - The generated statement, if the request was a natural language prompt. - x-has-example: true - example: SELECT country, COUNT(*) AS `airline_count` FROM `travel-sample`.`inventory`.`airline` AS `a` GROUP BY country - signature: - type: object - description: |- - The schema of the results. - Present only when the query completes successfully. - x-has-example: true - example: - id: json - results: - type: array - items: {} - description: |- - An array of all the objects returned by the query. - An object can be any JSON value. - status: - type: string - description: The status of the request. - enum: - - success - - running - - errors - - completed - - stopped - - timeout - - fatal - errors: - type: array - description: |- - An array of 0 or more error objects. - If an error occurred during processing of the request, it will be represented by an error object in this list. - items: - $ref: "#/components/schemas/Conditions" - warnings: - type: array - description: |- - An array of 0 or more warning objects. - If a warning occurred during processing of the request, it is represented by a warning object in this list. - items: - $ref: "#/components/schemas/Conditions" - metrics: - $ref: "#/components/schemas/Metrics" - controls: - $ref: "#/components/schemas/Controls" - profile: - $ref: "#/components/schemas/Profile" - - Conditions: - type: object - description: Errors and warnings have the following format. - required: - - code - - msg - properties: - code: - type: integer - description: |- - A unique number that identifies the error or warning. - The code ranges are partitioned by component. - The codes can also include parts that indicate severity and transience. - This property is always present in every condition returned in the Query REST API or captured in a log. - msg: - type: string - description: |- - A message describing the error or warning in detail. - This property is always present in every condition returned in the Query REST API or captured in a log. - name: - type: string - description: |- - Unique name that has a 1:1 mapping to the code. - Uniquely identifies the condition. - This property is helpful for pattern matching and can have meaning, making it more memorable than the code. - The name should be fully qualified. - x-has-example: true - example: - indexing.scan.io_failure - x-example: - query.execute.index_not_found - sev: - type: integer - description: |- - One of the following SQL++ severity levels, listed in order of severity: - - 1. Severe - 2. Error - 3. Warn - 4. Info - temp: - type: boolean - description: |- - Indicates if the condition is transient — for example, the queue is full. - If the value is `false`, it tells clients and users that a retry without modification produces the same condition. - - Metrics: - type: object - description: An object containing metrics about the request. - required: - - elapsedTime - - executionTime - - resultCount - - resultSize - properties: - elapsedTime: - type: string - format: duration - description: The total time taken for the request, that is the time from when the request was received until the results were returned. - executionTime: - type: string - format: duration - description: The time taken for the execution of the request, that is the time from when query execution started until the results were returned. - resultCount: - type: integer - format: unsigned - description: The total number of objects in the results. - resultSize: - type: integer - format: unsigned - description: The total number of bytes in the results. - naturalLanguageProcessingTime: - type: string - format: duration - description: |- - The total time spent processing a natural language request. - The cumulation of authentication, collecting schema, and time waiting for the response from the LLM, or wait time for the natural language request to be serviced. - mutationCount: - type: integer - description: The number of mutations that were made during the request. - format: unsigned - sortCount: - type: integer - format: unsigned - description: |- - The number of objects that were sorted. - Present only if the request includes `ORDER BY`. - - If a query includes ORDER BY, LIMIT, or OFFSET clauses, an application can use the `sortCount` value to give the overall number of results in a message such as `"page 1 of N"`. - usedMemory: - type: integer - format: unsigned - description: |- - The amount of document memory used to execute the request. - This property is only returned if a memory quota was set for the query. - errorCount: - type: integer - format: unsigned - description: The number of errors that occurred during the request. - warningCount: - type: integer - format: unsigned - description: The number of warnings that occurred during the request. - sessionMemory: - type: integer - format: bytes - description: > - The memory session size for the request, in bytes. - - - Each request has a dedicated memory session. - When a query requires a document or value, memory is allocated from this session based on the size of the document or value. - Once the document or value is processed, the allocated memory is returned back to the session, enabling it to be reused by the request. - - - This metric is available only when `node-quota` and `node-quota-val-percent` are configured for the node. - - Controls: - type: object - description: |- - An object containing runtime information provided along with the request. - Present only if `controls` was set to true in the [Request Parameters](#Request). - properties: - scan_consistency: - type: string - description: The value of the query setting Scan Consistency used for the query. - use_cbo: - type: boolean - description: Whether the cost-based optimizer was enabled for the query. - memoryQuota: - type: integer - format: unsigned - description: |- - The memory quota for the request, in MB. - This property is only returned if a memory quota was set for the query. - stmtType: - type: string - description: The type of query statement. - x-has-example: true - example: SELECT - - Profile: - type: object - description: |- - An object containing monitoring and profiling information about the request. - Present only if `profile` was set to `"phases"` or `"timings"` in the [Request Parameters](#Request). - required: - - requestTime - - servicingHost - - phaseCounts - - phaseOperators - - phaseTimes - properties: - requestTime: - type: string - format: date-time - description: Timestamp when the query was received. - servicingHost: - type: string - description: IP address and port number of the node where the query was executed. - phaseCounts: - type: object - description: |- - Count of documents processed at selective phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. - x-has-example: true - example: - { - "fetch": 16, - "indexScan": 187 - } - phaseOperators: - type: object - description: |- - Indicates the numbers of each kind of query operator involved in different phases of the query processing. - - For instance, a non-covering index path might involve one index scan and one fetch operator. - A join would probably involve two or more fetches, one per keyspace. - A union select would have twice as many operator counts, one per each branch of the union. - - This is in essence the count of all the operators in the `executionTimings` object. - x-has-example: true - example: - { - "authorize": 1, - "fetch": 1, - "indexScan": 2 - } - phaseTimes: - type: object - description: |- - Cumulative execution times for various phases involved in the query execution, such as authorize, index scan, fetch, parse, plan, run, etc. - x-has-example: true - example: - { - "authorize": "823.631µs", - "fetch": "656.873µs", - "indexScan": "29.146543ms", - "instantiate": "236.221µs", - "parse": "826.382µs", - "plan": "11.831101ms", - "run": "16.892181ms" - } - executionTimings: - type: object - title: Execution Timings - description: |- - Present only if `profile` was set to `"timings"` in the [Request Parameters](#Request). - - The execution details for various phases involved in the query execution, such as kernel and service execution times, number of documents processed at each query operator in each phase, and number of phase switches. - required: - - '#operator' - - '#stats' - properties: - '#operator': - type: string - description: Name of the operator. - x-has-example: true - example: Fetch - '#stats': - type: object - title: Statistics - description: Statistics collected for the operator. - properties: - '#itemsIn': - type: integer - format: int32 - description: Number of input documents to the operator. - x-has-example: true - example: 187 - '#itemsOut': - type: integer - format: int32 - description: Number of output documents after the operator processing. - x-has-example: true - example: 16 - '#phaseSwitches': - type: integer - format: int32 - description: Number of switches between executing, waiting for services, or waiting for the goroutine scheduler. - x-has-example: true - example: 413 - execTime: - type: string - format: duration - x-desc-name: exec_time - description: Time spent executing the operator code inside SQL++ query engine. - x-has-example: true - example: "128.434µs" - kernTime: - type: string - format: duration - x-desc-name: kern_time - description: Time spent waiting to be scheduled for CPU time. - x-has-example: true - example: "15.027879ms" - servTime: - type: string - format: duration - description: |- - Time spent waiting for another service, such as index or data. - - For index scan, it is time spent waiting for GSI/indexer. - - For fetch, it is time spent waiting on the KV store. - x-has-example: true - example: "1.590934ms" - '~child': - type: object - description: Further nested operators, each with their own execution timings. - ioTime: - type: string - format: duration - description: | - The total sum of [servTime](#serv_time) across all operators. - x-has-example: true - example: "752.858519ms" - waitTime: - type: string - format: duration - description: | - The total sum of [kernTime](#kern_time) across all operators. - x-has-example: true - example: "1.201307s" - cpuTime: - type: string - format: duration - description: | - The total sum of [execTime](#exec_time) across all operators. - x-has-example: true - example: "90.734075ms" - ~analysis: - type: array - items: - type: string - description: | - An array of text phrases that provide a basic analysis of the request execution. - These phrases highlight notable aspects of the execution, such as high document counts during primary scans or warnings related to memory and resource usages. - x-has-example: true - example: - [ - "High IO time", - "High primary scan document count" - ] - - securitySchemes: - Header: - type: http - scheme: basic - description: |- - Specify a user name and password via HTTP headers. - This method can only be used to provide a single credential. - -# Parameter: -# type: apiKey -# name: creds -# in: query -# description: |- -# Specify user names and passwords via the `creds` request parameter. -# This is the only method that can provide multiple credentials for a request. diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index c107651b..2f90f1c9 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -867,7 +867,7 @@ endif::collapse-models[] ifdef::model-descriptions[] //tag::desc-Controls[] An object containing runtime information provided along with the request. -Present only if `controls` was set to true in the [Request Parameters](#Request). +Present only if `controls` was set to true in the request parameters. //end::desc-Controls[] endif::model-descriptions[] @@ -1049,7 +1049,7 @@ endif::collapse-models[] ifdef::model-descriptions[] //tag::desc-Execution_Timings[] -Present only if `profile` was set to `"timings"` in the [Request Parameters](#Request). +Present only if `profile` was set to `"timings"` in the request parameters. The execution details for various phases involved in the query execution, such as kernel and service execution times, number of documents processed at each query operator in each phase, and number of phase switches. //end::desc-Execution_Timings[] @@ -1366,7 +1366,7 @@ endif::collapse-models[] ifdef::model-descriptions[] //tag::desc-Profile[] An object containing monitoring and profiling information about the request. -Present only if `profile` was set to `"phases"` or `"timings"` in the [Request Parameters](#Request). +Present only if `profile` was set to `"phases"` or `"timings"` in the request parameters. //end::desc-Profile[] endif::model-descriptions[] @@ -1590,6 +1590,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[section_srh_tlm_n1b]: #section_srh_tlm_n1b + +endif::alt-markdown-links[] Supplies the values for positional parameters in the statement. Applicable if the statement or prepared statement contains 1 or more positional parameters. @@ -1647,6 +1651,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[auto-execute]: ../n1ql-language-reference/prepare.html#auto-execute + +endif::alt-markdown-links[] Specifies that prepared statements should be executed automatically as soon as they are created. This saves you from having to make two separate requests in cases where you want to prepare a statement and execute it immediately. @@ -2237,6 +2245,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[execute]: ../n1ql-language-reference/execute.html + +endif::alt-markdown-links[] _Required_ if `statement` or `natural` not provided. The name of the prepared SQL++ statement to be executed. @@ -2437,6 +2449,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[transactional-scan-consistency]: #transactional-scan-consistency + +endif::alt-markdown-links[] Specifies the consistency guarantee or constraint for index scanning. The valid values are: @@ -2853,6 +2869,10 @@ a¦ [.edition]##{enterprise}## [markdown] -- +ifdef::alt-markdown-links[] +[flex-indexes]: ../n1ql-language-reference/flex-indexes.html + +endif::alt-markdown-links[] Specifies that the query should use a Search index. If the query contains a `USING FTS` hint, that takes priority over this parameter. @@ -2932,6 +2952,10 @@ a¦ [markdown] -- +ifdef::alt-markdown-links[] +[section_srh_tlm_n1b]: #section_srh_tlm_n1b + +endif::alt-markdown-links[] Supplies the value for a named parameter in the statement. Applicable if the statement or prepared statement contains 1 or more named parameters. @@ -3027,7 +3051,7 @@ a¦ [markdown] -- -The client context ID of the request, if one was supplied — see `client_context_id` in [Request Parameters](#Request). +The client context ID of the request, if one was supplied — see `client_context_id` in the request parameters. -- [%hardbreaks] diff --git a/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml b/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml deleted file mode 100644 index de82c175..00000000 --- a/docs/modules/n1ql-rest-settings/attachments/_query-settings.yaml +++ /dev/null @@ -1,780 +0,0 @@ -openapi: 3.0.3 -info: - title: Query Settings REST API - version: "8.0" - description: |- - The Query Settings REST API is provided by the Query service. - This API enables you to view or specify cluster-level Query settings. - -servers: - - url: '{scheme}://{host}:{port}' - description: The URL scheme, host, and port are as follows. - variables: - scheme: - default: http - description: |- - The URL scheme. - Use `https` for secure access. - enum: - - http - - https - host: - default: localhost - description: The host name or IP address of a node running the Query Service. - port: - default: "8091" - description: |- - The Cluster administration REST port. - Use `18091` for secure access. - - Note that the port numbers for this REST API are different to the port numbers used by the other Query REST APIs. - enum: - - "8091" - - "18091" - -paths: - /settings/querySettings: - get: - operationId: get_settings - summary: Retrieve Cluster-Level Query Settings - description: Returns all cluster-level query settings, including the CURL access settings. - security: - - Default: [] - responses: - 200: - description: An object giving cluster-level query settings. - content: - application/json: - schema: - $ref: "#/components/schemas/Settings" - post: - operationId: post_settings - summary: Update Cluster-Level Query Settings - description: Updates cluster-level query settings, including the CURL access settings. - security: - - Default: [] - requestBody: - description: An object specifying cluster-level query settings. - content: - application/json: - schema: - $ref: "#/components/schemas/Settings" - application/x-www-form-urlencoded: - schema: - $ref: "#/components/schemas/Settings" - responses: - 200: - description: An object giving cluster-level query settings, including the latest changes. - content: - application/json: - schema: - $ref: "#/components/schemas/Settings" - 400: - description: Returns an error message if a parameter or value is incorrect. - content: - application/json: - schema: - type: object - - /settings/querySettings/curlWhitelist: - get: - operationId: get_access - summary: Retrieve CURL Access List - description: Returns the cluster-level CURL access settings only. - security: - - Default: [] - responses: - 200: - description: An object determining which URLs may be accessed by the `CURL()` function. - content: - application/json: - schema: - $ref: "#/components/schemas/Access" - post: - operationId: post_access - summary: Update CURL Access List - description: Updates the cluster-level CURL access settings only. - security: - - Default: [] - requestBody: - description: An object determining which URLs may be accessed by the `CURL()` function. - content: - application/json: - schema: - $ref: "#/components/schemas/Access" - application/x-www-form-urlencoded: - schema: - $ref: "#/components/schemas/Access" - responses: - 200: - description: An object determining which URLs may be accessed by the `CURL()` function, including the latest changes. - content: - application/json: - schema: - $ref: "#/components/schemas/Access" - 400: - description: Returns an error message if a parameter or value is incorrect. - content: - application/json: - schema: - type: object - -# The output of this spec is used in more than one location, so Markdown cannot use relative links. -# Absolute links begin with /cloud -- this must be replaced for every branch. -# Relative links point to a location relative to the REST API reference page by default. -# The x-desc-refs attribute is used to override links when content is transcluded to other locations. - -# The AsciiDoc Markdown converter does not recognize HTML tags like . -# Use the x-desc-name vendor extension to specify the anchor for a property. - -components: - schemas: - Settings: - type: object - title: Settings - properties: - queryCleanupClientAttempts: - type: boolean - default: true - example: false - x-has-default: true - x-has-example: true - x-desc-name: queryCleanupClientAttempts - description: |- - When enabled, the Query service preferentially aims to clean up just transactions that it has created, leaving transactions for the distributed cleanup process only when it is forced to. - x-desc-more: |- - The [node-level][cleanupclientattempts] `cleanupclientattempts` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [cleanupclientattempts]: ../n1ql-rest-admin/index.html#cleanupclientattempts - x-desc-refs: |- - [cleanupclientattempts]: #cleanupclientattempts - queryCleanupLostAttempts: - type: boolean - default: true - example: false - x-has-default: true - x-has-example: true - x-desc-name: queryCleanupLostAttempts - description: |- - When enabled, the Query service takes part in the distributed cleanup process, and cleans up expired transactions created by any client. - x-desc-more: |- - The [node-level][cleanuplostattempts] `cleanuplostattempts` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [cleanuplostattempts]: ../n1ql-rest-admin/index.html#cleanuplostattempts - x-desc-refs: |- - [cleanuplostattempts]: #cleanuplostattempts - queryCleanupWindow: - type: string - format: duration - default: 60s - example: 30s - x-has-default: true - x-has-example: true - x-desc-name: queryCleanupWindow - description: |- - Specifies how frequently the Query service checks its subset of [active transaction records][additional-storage-use] for cleanup. - Decreasing this setting causes expiration transactions to be found more swiftly, with the tradeoff of increasing the number of reads per second used for the scanning process. - - The value for this setting is a string. - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [node-level][cleanupwindow] `cleanupwindow` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [cleanupwindow]: ../n1ql-rest-admin/index.html#cleanupwindow - x-desc-refs: |- - [cleanupwindow]: #cleanupwindow - queryCompletedLimit: - type: integer - format: int32 - default: 4000 - example: 7000 - x-has-default: true - x-has-example: true - x-desc-name: queryCompletedLimit - description: |- - Sets the number of requests to be logged in the completed requests catalog. - As new completed requests are added, old ones are removed. - - Increase this when the completed request keyspace is not big enough to track the slow requests, such as when you want a larger sample of slow requests. - - Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. - - [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - x-desc-more: |- - The [node-level][completed-limit] `completed-limit` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [completed-limit]: ../n1ql-rest-admin/index.html#completed-limit - x-desc-refs: |- - [completed-limit]: #completed-limit - queryCompletedMaxPlanSize: - type: integer - format: int32 - default: 262144 - minimum: 0 - maximum: 20840448 - x-has-default: true - x-desc-name: queryCompletedMaxPlanSize - description: |- - A plan size in bytes. - Limits the size of query execution plans that can be logged in the completed requests catalog. - Values larger than the maximum limit are silently treated as the maximum limit. - Queries with plans larger than this are not logged. - You must obtain execution plans for such queries via profiling or using the EXPLAIN statement. - - Refer to [Configure the Completed Requests][sys-completed-config] for more information. - - [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - x-desc-more: |- - The [node-level][completed-max-plan-size] `completed-max-plan-size` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [completed-max-plan-size]: ../n1ql-rest-admin/index.html#completed-max-plan-size - x-desc-refs: |- - [completed-max-plan-size]: #completed-max-plan-size - queryCompletedThreshold: - type: integer - format: int32 - default: 1000 - example: 7000 - x-has-default: true - x-has-example: true - x-desc-name: queryCompletedThreshold - description: |- - A duration in milliseconds. - All completed queries lasting longer than this threshold are logged in the completed requests catalog. - - Specify `0` to track all requests, independent of duration. - Specify any negative number to track none. - - Refer to [Configure the Completed Requests][sys-completed-config] for more information and examples. - - [sys-completed-config]: /server/8.0/n1ql/n1ql-manage/monitoring-n1ql-query.html#sys-completed-config - x-desc-more: |- - The [node-level][completed-threshold] `completed-threshold` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [completed-threshold]: ../n1ql-rest-admin/index.html#completed-threshold - x-desc-refs: |- - [completed-threshold]: #completed-threshold - queryLogLevel: - type: string - default: INFO - enum: ["DEBUG","TRACE","INFO","WARN","ERROR","SEVERE","NONE"] - example: DEBUG - x-has-default: true - x-has-example: true - x-desc-name: queryLogLevel - description: |- - Log level used in the logger. - - All values, in descending order of data: - - * `DEBUG` — For developers. - Writes everything. - - * `TRACE` — For developers. - Less info than `DEBUG`. - - * `INFO` — For admin & customers. - Lists warnings & errors. - - * `WARN` — For admin. - Only abnormal items. - - * `ERROR` — For admin. - Only errors to be fixed. - - * `SEVERE` — For admin. - Major items, like crashes. - - * `NONE` — Doesn't write anything. - x-desc-more: |- - The [node-level][loglevel] `loglevel` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [loglevel]: ../n1ql-rest-admin/index.html#loglevel - x-desc-refs: |- - [loglevel]: #loglevel - queryMaxParallelism: - type: integer - format: int32 - default: 1 - example: 0 - x-has-default: true - x-has-example: true - x-desc-name: queryMaxParallelism - description: |- - Specifies the maximum parallelism for queries on all Query nodes in the cluster. - - If the value is zero or negative, the maximum parallelism is restricted to the number of allowed cores. - Similarly, if the value is greater than the number of allowed cores, the maximum parallelism is restricted to the number of allowed cores. - - (The number of allowed cores is the same as the number of logical CPUs. - In Community Edition, the number of allowed cores cannot be greater than 4. - In Enterprise Edition, there is no limit to the number of allowed cores.) - - Refer to [Max Parallelism][max-parallelism] for more information. - - [max-parallelism]: /server/8.0/n1ql/n1ql-language-reference/index-partitioning.html#max-parallelism - x-desc-more: |- - The [node-level][max-parallelism-srv] `max-parallelism` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, there is a [request-level][max_parallelism_req] `max_parallelism` parameter. - If a request includes this parameter, it will be capped by the node-level `max-parallelism` setting. - - NOTE: To enable queries to run in parallel, you must specify the cluster-level `queryMaxParallelism` parameter, or specify the node-level `max-parallelism` parameter on all Query nodes. - - [max-parallelism-srv]: ../n1ql-rest-admin/index.html#max-parallelism-srv - [max_parallelism_req]: ../n1ql-rest-query/index.html#max_parallelism_req - x-desc-refs: |- - [max-parallelism-srv]: #max-parallelism-srv - [max_parallelism_req]: #max_parallelism_req - queryMemoryQuota: - type: integer - format: int32 - default: 0 - example: 4 - x-has-default: true - x-has-example: true - x-desc-name: queryMemoryQuota - description: |- - Specifies the maximum amount of memory a request may use on any Query node in the cluster, in MB. - - This parameter enforces a ceiling on the memory used for the tracked documents required for - processing a request. It does not take into account any other memory that might be used to - process a request, such as the stack, the operators, or some intermediate values. - - Within a transaction, this setting enforces the memory quota for the transaction by tracking the - delta table and the transaction log (approximately). - x-desc-more: |- - The [node-level][memory-quota-srv] `memory-quota` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, there is a [request-level][memory_quota_req] `memory_quota` parameter. - If a request includes this parameter, it will be capped by the node-level `memory-quota` setting. - - [memory-quota-srv]: ../n1ql-rest-admin/index.html#memory-quota-srv - [memory_quota_req]: ../n1ql-rest-query/index.html#memory_quota_req - x-desc-refs: |- - [memory-quota-srv]: #memory-quota-srv - [memory_quota_req]: #memory_quota_req - queryN1QLFeatCtrl: - type: integer - format: int32 - x-desc-name: queryN1QLFeatCtrl - description: |- - SQL++ feature control. - This setting is provided for technical support only. - x-desc-more: |- - The [node-level][n1ql-feat-ctrl] `n1ql-feat-ctrl` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [n1ql-feat-ctrl]: ../n1ql-rest-admin/index.html#n1ql-feat-ctrl - x-desc-refs: |- - [n1ql-feat-ctrl]: #n1ql-feat-ctrl - queryNodeQuota: - type: integer - format: int32 - default: 0 - x-has-default: true - x-desc-name: queryNodeQuota - description: |- - Sets the soft memory limit for the Query service on every Query node in the cluster, in MB. - The garbage collector tries to keep below this target. - It is not a hard, absolute limit, and memory usage may exceed this value. - - When set to `0` (the default), the Query service sets a default soft memory limit for every node. - To do this, the Query service calculates the difference between the total system RAM and 90% of the total system RAM: - - `Total System RAM - (0.9 * Total System RAM)` - - - If the difference is greater than 8 GiB, the default soft memory limit is set to the total system RAM minus 8 GiB. - - - If the difference is 8 GiB or less, the default soft memory limit is set to 90% of the total system RAM. - x-desc-more: |- - The [node-level][node-quota] `node-quota` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [node-quota]: ../n1ql-rest-admin/index.html#node-quota - x-desc-refs: |- - [node-quota]: #node-quota - queryNodeQuotaValPercent: - type: integer - format: int32 - default: 67 - minimum: 0 - maximum: 100 - x-has-default: true - x-desc-name: queryNodeQuotaValPercent - description: |- - The percentage of the `queryNodeQuota` that is dedicated to tracked value content memory across all active requests for every Query node in the cluster. - (The `queryMemoryQuota` setting specifies the maximum amount of document memory an individual request may use on any Query node in the cluster.) - x-desc-more: |- - The [node-level][node-quota-val-percent] `node-quota-val-percent` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [node-quota-val-percent]: ../n1ql-rest-admin/index.html#node-quota-val-percent - x-desc-refs: |- - [node-quota-val-percent]: #node-quota-val-percent - queryNumAtrs: - type: integer - format: int32 - minimum: 0 - exclusiveMinimum: true - default: 1024 - example: 512 - x-has-default: true - x-has-example: true - x-desc-name: queryNumAtrs - description: |- - Specifies the total number of [active transaction records][additional-storage-use] for all Query nodes in the cluster. - - [additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries - x-desc-more: |- - The [node-level][numatrs-srv] `numatrs` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, there is a [request-level][numatrs_req] `numatrs` parameter. - If a request includes this parameter, it will be capped by the node-level `numatrs` setting. - - [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv - [numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req - x-desc-refs: |- - [numatrs-srv]: #numatrs-srv - [numatrs_req]: #numatrs_req - queryNumCpus: - type: integer - format: int32 - default: 0 - x-has-default: true - x-desc-name: queryNumCpus - description: |- - The number of CPUs the Query service can use on any Query node in the cluster. - Note that this setting requires a restart of the Query service to take effect. - - When set to `0` (the default), the Query service can use all available CPUs, up to the limits described below. - - The number of CPUs can never be greater than the number of logical CPUs. - In Community Edition, the number of allowed CPUs cannot be greater than 4. - In Enterprise Edition, there is no limit to the number of allowed CPUs. - x-desc-more: |- - The [node-level][num-cpus] `num-cpus` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [num-cpus]: ../n1ql-rest-admin/index.html#num-cpus - x-desc-refs: |- - [num-cpus]: #num-cpus - queryPipelineBatch: - type: integer - format: int32 - default: 16 - example: 64 - x-has-default: true - x-has-example: true - x-desc-name: queryPipelineBatch - description: |- - Controls the number of items execution operators can batch for Fetch from the KV. - x-desc-more: |- - The [node-level][pipeline-batch-srv] `pipeline-batch` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][pipeline_batch_req] `pipeline_batch` parameter specifies this property per request. - The minimum of that and the node-level `pipeline-batch` setting is applied. - - [pipeline-batch-srv]: ../n1ql-rest-admin/index.html#pipeline-batch-srv - [pipeline_batch_req]: ../n1ql-rest-query/index.html#pipeline_batch_req - x-desc-refs: |- - [pipeline-batch-srv]: #pipeline-batch-srv - [pipeline_batch_req]: #pipeline_batch_req - queryPipelineCap: - type: integer - format: int32 - default: 512 - example: 1024 - x-has-default: true - x-has-example: true - x-desc-name: queryPipelineCap - description: |- - Maximum number of items each execution operator can buffer between various operators. - x-desc-more: |- - The [node-level][pipeline-cap-srv] `pipeline-cap` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][pipeline_cap_req] `pipeline_cap` parameter specifies this property per request. - The minimum of that and the node-level `pipeline-cap` setting is applied. - - [pipeline-cap-srv]: ../n1ql-rest-admin/index.html#pipeline-cap-srv - [pipeline_cap_req]: ../n1ql-rest-query/index.html#pipeline_cap_req - x-desc-refs: |- - [pipeline-cap-srv]: #pipeline-cap-srv - [pipeline_cap_req]: #pipeline_cap_req - queryPreparedLimit: - type: integer - format: int32 - default: 16384 - example: 65536 - x-has-default: true - x-has-example: true - x-desc-name: queryPreparedLimit - description: |- - Maximum number of prepared statements in the cache. - When this cache reaches the limit, the least recently used prepared statements will be discarded as new prepared statements are created. - x-desc-more: |- - The [node-level][prepared-limit] `prepared-limit` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - [prepared-limit]: ../n1ql-rest-admin/index.html#prepared-limit - x-desc-refs: |- - [prepared-limit]: #prepared-limit - queryScanCap: - type: integer - format: int32 - default: 512 - example: 1024 - x-has-default: true - x-has-example: true - x-desc-name: queryScanCap - description: |- - Maximum buffered channel size between the indexer client and the query service for index scans. - This parameter controls when to use scan backfill. - - Use `0` or a negative number to disable. - Smaller values reduce GC, while larger values reduce indexer backfill. - x-desc-more: |- - The [node-level][scan-cap-srv] `scan-cap` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][scan_cap_req] `scan_cap` parameter specifies this property per request. - The minimum of that and the node-level `scan-cap` setting is applied. - - [scan-cap-srv]: ../n1ql-rest-admin/index.html#scan-cap-srv - [scan_cap_req]: ../n1ql-rest-query/index.html#scan_cap_req - x-desc-refs: |- - [scan-cap-srv]: #scan-cap-srv - [scan_cap_req]: #scan_cap_req - queryTimeout: - type: integer - format: int64 - default: 0 - example: 500000000 - x-has-default: true - x-has-example: true - x-desc-name: queryTimeout - description: |- - Maximum time to spend on the request before timing out (ns). - - The value for this setting is an integer, representing a duration in nanoseconds. - It must not be delimited by quotes, and must not include a unit. - - Specify `0` (the default value) or a negative integer to disable. - When disabled, no timeout is applied and the request runs for however long it takes. - x-desc-more: |- - The [node-level][timeout-srv] `timeout` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][timeout_req] `timeout` parameter specifies this property per request. - The minimum of that and the node-level `timeout` setting is applied. - - [timeout-srv]: ../n1ql-rest-admin/index.html#timeout-srv - [timeout_req]: ../n1ql-rest-query/index.html#timeout_req - x-desc-refs: |- - [timeout-srv]: #timeout-srv - [timeout_req]: #timeout_req - queryTxTimeout: - type: string - format: duration - default: "0ms" - example: "0.5s" - x-has-default: true - x-has-example: true - x-desc-name: queryTxTimeout - description: |- - Maximum time to spend on a transaction before timing out. - This setting only applies to requests containing the `BEGIN TRANSACTION` statement, or to requests where the [tximplicit][tximplicit] parameter is set. - For all other requests, it is ignored. - - The value for this setting is a string. - Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second). - Valid units are: - - * `ns` (nanoseconds) - * `us` (microseconds) - * `ms` (milliseconds) - * `s` (seconds) - * `m` (minutes) - * `h` (hours) - - Specify `0ms` (the default value) to disable. - When disabled, no timeout is applied and the transaction runs for however long it takes. - - [tximplicit]: ../n1ql-rest-query/index.html#tximplicit - x-desc-more: |- - The [node-level][txtimeout-srv] `txtimeout` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, there is a [request-level][txtimeout_req] `txtimeout` parameter. - If a request includes this parameter, it will be capped by the node-level `txtimeout` setting. - - [txtimeout-srv]: ../n1ql-rest-admin/index.html#txtimeout-srv - [txtimeout_req]: ../n1ql-rest-query/index.html#txtimeout_req - x-desc-refs: |- - [tximplicit]: #tximplicit - [txtimeout-srv]: #txtimeout-srv - [txtimeout_req]: #txtimeout_req - queryTmpSpaceDir: - type: string - example: "/opt/couchbase/var/lib/couchbase/tmp" - x-has-example: true - x-desc-name: queryTmpSpaceDir - description: |- - The path to which the Index Service writes temporary backfill files, and the Query Service writes spill files, to store any transient data during query processing. - - The specified path must already exist. - Only absolute paths are allowed. - - The default path is `var/lib/couchbase/tmp` within the Couchbase Server installation directory. - queryTmpSpaceSize: - type: integer - format: int32 - default: 5120 - example: 2048 - x-has-default: true - x-has-example: true - x-desc-name: queryTmpSpaceSize - description: |- - In MiB, the maximum size of temporary backfill files for each indexer, and the maximum size of temporary files for spilled sorting and other operations. - In a cluster with both secondary indexing and full text search, the limit for disk space use is three times this setting. - - Setting the size to `0` disables backfill. - Setting the size to `-1` means the size is unlimited. - - The maximum size is limited only by the available disk space. - queryUseCBO: - type: boolean - default: true - example: false - x-has-default: true - x-has-example: true - x-desc-name: queryUseCBO - description: |- - Specifies whether the cost-based optimizer is enabled. - x-desc-more: |- - The [node-level][use-cbo-srv] `use-cbo` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][use_cbo_req] `use_cbo` parameter specifies this property per request. - If a request does not include this parameter, the node-level setting is used, which defaults to `true`. - - [use-cbo-srv]: ../n1ql-rest-admin/index.html#use-cbo-srv - [use_cbo_req]: ../n1ql-rest-query/index.html#use_cbo_req - x-desc-refs: |- - [use-cbo-srv]: #use-cbo-srv - [use_cbo_req]: #use_cbo_req - queryUseReplica: - type: string - default: unset - enum: ["off","on","unset"] - example: "on" - x-has-default: true - x-has-example: true - x-desc-name: queryUseReplica - description: |- - Specifies whether a query can fetch data from a replica vBucket if active vBuckets are inaccessible. - The possible values are: - - * `off` — read from replica is disabled for all queries and cannot be overridden at request level. - - * `on` — read from replica is enabled for all queries, but can be disabled at request level. - - * `unset` — read from replica is enabled or disabled at request level. - - Do not enable read from replica when you require consistent results. - Only SELECT queries that are not within a transaction can read from replica. - - Reading from replica is only possible if the cluster uses Couchbase Server 7.6.0 or later. - - Note that KV range scans cannot currently be started on a replica vBucket. - If a query uses sequential scan and a data node becomes unavailable, the query might return an error, even if read from replica is enabled for the request. - x-desc-more: |- - The [node-level][use-replica-srv] `use-replica` setting specifies this property for a single node. - When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster. - - In addition, the [request-level][use_replica_req] `use_replica` parameter specifies this property per request. - If a request does not include this parameter, or if the request-level parameter is `unset`, the node-level setting is used. - If the request-level parameter and the node-level setting are both `unset`, read from replica is disabled for that request. - - [use-replica-srv]: ../n1ql-rest-admin/index.html#use-replica-srv - [use_replica_req]: ../n1ql-rest-query/index.html#use_replica_req - x-desc-refs: |- - [use-replica-srv]: #use-replica-srv - [use_replica_req]: #use_replica_req - queryCurlWhitelist: - $ref: "#/components/schemas/Access" - - Access: - type: object - x-desc-name: queryCurlWhitelist - description: An object which determines which URLs may be accessed by the `CURL()` function. - required: - - all_access - properties: - all_access: - type: boolean - description: |- - Defines whether the user has access to all URLs, or only URLs specified by the access list. - - This field set must be set to `false` to enable the `allowed_urls` and `disallowed_urls` fields. - - Setting this field to `true` enables access to all endpoints. - allowed_urls: - type: array - description: |- - An array of strings, each of which is a URL to which you wish to grant access. - Each URL is a prefix match. - The CURL() function will allow any URL that starts with this value. - - For example, if you wish to allow access to all Google APIs, add the URL `https://maps.googleapis.com` to the array. - To allow complete access to `localhost`, use `http://localhost`. - - Note that each URL must include the port, protocol, and all other components of the URL. - default: [] - items: - type: string - disallowed_urls: - type: array - description: |- - An array of strings, each of which is a URL that will be restricted for all roles. - Each URL is a prefix match. - The CURL() function will disallow any URL that starts with this value. - - If both `allowed_urls` and `disallowed_urls` fields are populated, the `disallowed_urls` field takes precedence over `allowed_urls`. - - Note that each URL must include the port, protocol, and all other components of the URL. - default: [] - items: - type: string - - securitySchemes: - Default: - type: http - scheme: basic - description: |- - Users must have one of the following RBAC roles: - - * Full Admin - * Cluster Admin \ No newline at end of file diff --git a/docs/modules/n1ql-rest-settings/pages/index.adoc b/docs/modules/n1ql-rest-settings/pages/index.adoc index 59dba392..6cd96732 100644 --- a/docs/modules/n1ql-rest-settings/pages/index.adoc +++ b/docs/modules/n1ql-rest-settings/pages/index.adoc @@ -1118,6 +1118,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config [completed-limit]: #completed-limit endif::alt-markdown-links[] @@ -1153,6 +1154,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config [completed-max-plan-size]: #completed-max-plan-size endif::alt-markdown-links[] @@ -1190,6 +1192,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[sys-completed-config]: monitoring-n1ql-query.html#sys-completed-config [completed-threshold]: #completed-threshold endif::alt-markdown-links[] @@ -1277,6 +1280,7 @@ a¦ [markdown] -- ifdef::alt-markdown-links[] +[max-parallelism]: ../n1ql-language-reference/index-partitioning.html#max-parallelism [max-parallelism-srv]: #max-parallelism-srv [max_parallelism_req]: #max_parallelism_req From 1cdaf772a703c5782bf80213b07cd81af43b9940 Mon Sep 17 00:00:00 2001 From: Simon Dew <39966290+simon-dew@users.noreply.github.com> Date: Fri, 10 Oct 2025 13:20:56 +0100 Subject: [PATCH 25/25] DOC-13513: Update Data API passthroughs (#193) * Add overlay for Query Service API * Update build script for Query Service API * Embargo Eventing, FTS, and Indexing docs * Unpublish local specs * Update gradle builds for unpublished specs * Update creds parameter for cbq * Remove badge from use_fts * Build output documentation --- .../analytics-admin.gradle | 2 +- ...ytics-admin.yaml => _analytics-admin.yaml} | 0 .../analytics-config.gradle | 2 +- ...ics-config.yaml => _analytics-config.yaml} | 0 .../analytics-library.gradle | 2 +- ...s-library.yaml => _analytics-library.yaml} | 0 .../analytics-links.gradle | 2 +- ...ytics-links.yaml => _analytics-links.yaml} | 0 .../analytics-service.gradle | 2 +- ...s-service.yaml => _analytics-service.yaml} | 0 .../analytics-settings.gradle | 2 +- ...settings.yaml => _analytics-settings.yaml} | 0 .../{eventing.yaml => _eventing.yaml} | 0 .../modules/eventing-rest-api/eventing.gradle | 2 +- .../partials/header-attributes.adoc | 4 +- .../partials/header-attributes.adoc | 4 +- .../partials/header-attributes.adoc | 4 +- .../partials/header-attributes.adoc | 4 +- .../partials/header-attributes.adoc | 4 +- .../partials/header-attributes.adoc | 4 +- docs/modules/fts-rest-stats/pages/index.adoc | 255 ++++++++++++++++++ .../partials/header-attributes.adoc | 4 +- ...dex-settings.yaml => _index-settings.yaml} | 0 .../index-rest-settings/index-settings.gradle | 2 +- .../partials/header-attributes.adoc | 3 +- .../{indexes.yaml => _indexes.yaml} | 0 docs/modules/index-rest-stats/indexes.gradle | 2 +- .../n1ql-rest-query/attachments/_overlay.json | 31 +++ docs/modules/n1ql-rest-query/pages/index.adoc | 93 +------ .../n1ql-rest-query/query-service.gradle | 30 ++- .../{new_spec.yaml => _new_spec.yaml} | 0 .../{ns_server.yaml => _ns_server.yaml} | 0 .../{view_engine.yaml => _view_engine.yaml} | 0 33 files changed, 352 insertions(+), 106 deletions(-) rename docs/modules/analytics-rest-admin/attachments/{analytics-admin.yaml => _analytics-admin.yaml} (100%) rename docs/modules/analytics-rest-config/attachments/{analytics-config.yaml => _analytics-config.yaml} (100%) rename docs/modules/analytics-rest-library/attachments/{analytics-library.yaml => _analytics-library.yaml} (100%) rename docs/modules/analytics-rest-links/attachments/{analytics-links.yaml => _analytics-links.yaml} (100%) rename docs/modules/analytics-rest-service/attachments/{analytics-service.yaml => _analytics-service.yaml} (100%) rename docs/modules/analytics-rest-settings/attachments/{analytics-settings.yaml => _analytics-settings.yaml} (100%) rename docs/modules/eventing-rest-api/attachments/{eventing.yaml => _eventing.yaml} (100%) rename docs/modules/index-rest-settings/attachments/{index-settings.yaml => _index-settings.yaml} (100%) rename docs/modules/index-rest-stats/attachments/{indexes.yaml => _indexes.yaml} (100%) create mode 100644 docs/modules/n1ql-rest-query/attachments/_overlay.json rename docs/modules/ns_server/attachments/{new_spec.yaml => _new_spec.yaml} (100%) rename docs/modules/ns_server/attachments/{ns_server.yaml => _ns_server.yaml} (100%) rename docs/modules/view_engine/attachments/{view_engine.yaml => _view_engine.yaml} (100%) diff --git a/docs/modules/analytics-rest-admin/analytics-admin.gradle b/docs/modules/analytics-rest-admin/analytics-admin.gradle index bab5986a..de85902d 100644 --- a/docs/modules/analytics-rest-admin/analytics-admin.gradle +++ b/docs/modules/analytics-rest-admin/analytics-admin.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/analytics-admin.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_analytics-admin.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-admin/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml b/docs/modules/analytics-rest-admin/attachments/_analytics-admin.yaml similarity index 100% rename from docs/modules/analytics-rest-admin/attachments/analytics-admin.yaml rename to docs/modules/analytics-rest-admin/attachments/_analytics-admin.yaml diff --git a/docs/modules/analytics-rest-config/analytics-config.gradle b/docs/modules/analytics-rest-config/analytics-config.gradle index f77f94b9..4fe23dd8 100644 --- a/docs/modules/analytics-rest-config/analytics-config.gradle +++ b/docs/modules/analytics-rest-config/analytics-config.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/analytics-config.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_analytics-config.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-config/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/analytics-rest-config/attachments/analytics-config.yaml b/docs/modules/analytics-rest-config/attachments/_analytics-config.yaml similarity index 100% rename from docs/modules/analytics-rest-config/attachments/analytics-config.yaml rename to docs/modules/analytics-rest-config/attachments/_analytics-config.yaml diff --git a/docs/modules/analytics-rest-library/analytics-library.gradle b/docs/modules/analytics-rest-library/analytics-library.gradle index 7ad4c57f..d61ae235 100644 --- a/docs/modules/analytics-rest-library/analytics-library.gradle +++ b/docs/modules/analytics-rest-library/analytics-library.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/analytics-library.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_analytics-library.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-library/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/analytics-rest-library/attachments/analytics-library.yaml b/docs/modules/analytics-rest-library/attachments/_analytics-library.yaml similarity index 100% rename from docs/modules/analytics-rest-library/attachments/analytics-library.yaml rename to docs/modules/analytics-rest-library/attachments/_analytics-library.yaml diff --git a/docs/modules/analytics-rest-links/analytics-links.gradle b/docs/modules/analytics-rest-links/analytics-links.gradle index 2fa35122..77bbbebb 100644 --- a/docs/modules/analytics-rest-links/analytics-links.gradle +++ b/docs/modules/analytics-rest-links/analytics-links.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/analytics-links.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_analytics-links.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-links/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/analytics-rest-links/attachments/analytics-links.yaml b/docs/modules/analytics-rest-links/attachments/_analytics-links.yaml similarity index 100% rename from docs/modules/analytics-rest-links/attachments/analytics-links.yaml rename to docs/modules/analytics-rest-links/attachments/_analytics-links.yaml diff --git a/docs/modules/analytics-rest-service/analytics-service.gradle b/docs/modules/analytics-rest-service/analytics-service.gradle index 22535a95..31f779a7 100644 --- a/docs/modules/analytics-rest-service/analytics-service.gradle +++ b/docs/modules/analytics-rest-service/analytics-service.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/analytics-service.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_analytics-service.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-service/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/analytics-rest-service/attachments/analytics-service.yaml b/docs/modules/analytics-rest-service/attachments/_analytics-service.yaml similarity index 100% rename from docs/modules/analytics-rest-service/attachments/analytics-service.yaml rename to docs/modules/analytics-rest-service/attachments/_analytics-service.yaml diff --git a/docs/modules/analytics-rest-settings/analytics-settings.gradle b/docs/modules/analytics-rest-settings/analytics-settings.gradle index 6ddb10dc..1708f3db 100644 --- a/docs/modules/analytics-rest-settings/analytics-settings.gradle +++ b/docs/modules/analytics-rest-settings/analytics-settings.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/analytics-settings.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_analytics-settings.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/analytics-rest-settings/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml b/docs/modules/analytics-rest-settings/attachments/_analytics-settings.yaml similarity index 100% rename from docs/modules/analytics-rest-settings/attachments/analytics-settings.yaml rename to docs/modules/analytics-rest-settings/attachments/_analytics-settings.yaml diff --git a/docs/modules/eventing-rest-api/attachments/eventing.yaml b/docs/modules/eventing-rest-api/attachments/_eventing.yaml similarity index 100% rename from docs/modules/eventing-rest-api/attachments/eventing.yaml rename to docs/modules/eventing-rest-api/attachments/_eventing.yaml diff --git a/docs/modules/eventing-rest-api/eventing.gradle b/docs/modules/eventing-rest-api/eventing.gradle index 1fd57e73..2af99636 100644 --- a/docs/modules/eventing-rest-api/eventing.gradle +++ b/docs/modules/eventing-rest-api/eventing.gradle @@ -12,7 +12,7 @@ apply plugin: 'org.openapi.generator' task bundleSpec(type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask) { generatorName = "openapi-yaml" - inputSpec = file("attachments/eventing.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_eventing.yaml").getAbsolutePath().toString() outputDir = "${projectDir}/build/bundle" globalProperties = [ generateAliasAsModel: "true" diff --git a/docs/modules/eventing-rest-api/partials/header-attributes.adoc b/docs/modules/eventing-rest-api/partials/header-attributes.adoc index 690e987b..33290405 100644 --- a/docs/modules/eventing-rest-api/partials/header-attributes.adoc +++ b/docs/modules/eventing-rest-api/partials/header-attributes.adoc @@ -1,4 +1,4 @@ -:page-aliases: eventing:eventing-api.adoc -:page-edition: Enterprise Edition +:page-meta-robots: noindex +:page-embargo: EMBARGOED :page-partial: :!example-caption: diff --git a/docs/modules/fts-rest-advanced/partials/header-attributes.adoc b/docs/modules/fts-rest-advanced/partials/header-attributes.adoc index 75e2b583..abe379c2 100644 --- a/docs/modules/fts-rest-advanced/partials/header-attributes.adoc +++ b/docs/modules/fts-rest-advanced/partials/header-attributes.adoc @@ -1,4 +1,6 @@ -:page-aliases: rest-api:rest-fts-advanced.adoc +:page-meta-robots: noindex +:page-embargo: EMBARGOED +:page-partial: :!example-caption: :description: The Search Advanced REST APIs are provided by the Search Service. \ These APIs enable you to manage and monitor advanced settings of your Search indexes. diff --git a/docs/modules/fts-rest-indexing/partials/header-attributes.adoc b/docs/modules/fts-rest-indexing/partials/header-attributes.adoc index 460f9988..3125c4db 100644 --- a/docs/modules/fts-rest-indexing/partials/header-attributes.adoc +++ b/docs/modules/fts-rest-indexing/partials/header-attributes.adoc @@ -1,4 +1,6 @@ -:page-aliases: rest-api:rest-fts-indexing.adoc +:page-meta-robots: noindex +:page-embargo: EMBARGOED +:page-partial: :!example-caption: :description: The Search Indexing REST API is provided by the Search Service. \ This API enables you to manage and monitor your Search indexes. diff --git a/docs/modules/fts-rest-manage/partials/header-attributes.adoc b/docs/modules/fts-rest-manage/partials/header-attributes.adoc index 1685880b..f1b232a9 100644 --- a/docs/modules/fts-rest-manage/partials/header-attributes.adoc +++ b/docs/modules/fts-rest-manage/partials/header-attributes.adoc @@ -1,4 +1,6 @@ -:page-aliases: rest-api:rest-fts-partition-file-transfer.adoc +:page-meta-robots: noindex +:page-embargo: EMBARGOED +:page-partial: :!example-caption: :description: The Search Manager Options REST API is provided by the Search Service. \ This API enables you to set cluster-level Search settings; in particular, to configure rebalance based on file transfer. diff --git a/docs/modules/fts-rest-nodes/partials/header-attributes.adoc b/docs/modules/fts-rest-nodes/partials/header-attributes.adoc index be21eb97..7985d13b 100644 --- a/docs/modules/fts-rest-nodes/partials/header-attributes.adoc +++ b/docs/modules/fts-rest-nodes/partials/header-attributes.adoc @@ -1,4 +1,6 @@ -:page-aliases: rest-api:rest-fts-node.adoc +:page-meta-robots: noindex +:page-embargo: EMBARGOED +:page-partial: :!example-caption: :description: The Search Node Configuration REST API is provided by the Search Service. \ This API enables you to manage and monitor your Search nodes. diff --git a/docs/modules/fts-rest-query/partials/header-attributes.adoc b/docs/modules/fts-rest-query/partials/header-attributes.adoc index b33e3ffa..e3cd6269 100644 --- a/docs/modules/fts-rest-query/partials/header-attributes.adoc +++ b/docs/modules/fts-rest-query/partials/header-attributes.adoc @@ -1,4 +1,6 @@ -:page-aliases: rest-api:rest-fts-query.adoc +:page-meta-robots: noindex +:page-embargo: EMBARGOED +:page-partial: :!example-caption: :description: The Search Active Queries REST API is provided by the Search Service. \ This API enables you to get information about active Search queries. diff --git a/docs/modules/fts-rest-stats/pages/index.adoc b/docs/modules/fts-rest-stats/pages/index.adoc index 726e6433..e3ba7624 100644 --- a/docs/modules/fts-rest-stats/pages/index.adoc +++ b/docs/modules/fts-rest-stats/pages/index.adoc @@ -842,6 +842,21 @@ Typically, the Search Service uses one agent pair for each bucket on a node. a¦ Integer +a¦ +*num_indexes* + +_optional_ +a¦ + +[markdown] +-- +The number of Search indexes in the cluster. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + a¦ *num_knn_search_requests* + _optional_ @@ -857,6 +872,21 @@ The total number of [Vector Search](https://docs.couchbase.com/server/8.0/vector a¦ Integer +a¦ +*num_vector_indexes* + +_optional_ +a¦ + +[markdown] +-- +The number of Search indexes in the cluster that have vector/vector_base64 fields. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + a¦ *pct_cpu_gc* + _optional_ @@ -1815,6 +1845,156 @@ This statistic appears on the Server Web Console dashboard as **Search Docs**. a¦ Integer +a¦ +*BUCKET:INDEX:global_query_timer_count* + +_optional_ +a¦ + +[markdown] +-- +The number of Search query timer events received at the global query endpoint. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:global_query_timer_mean_ns* + +_optional_ +a¦ + +[markdown] +-- +The mean runtime for Search queries received at the global query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:global_query_timer_median_ns* + +_optional_ +a¦ + +[markdown] +-- +The median runtime for Search queries received at the global query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:global_query_timer_p80_ns* + +_optional_ +a¦ + +[markdown] +-- +The 80th percentile runtime for Search queries received at the global query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:global_query_timer_p99_ns* + +_optional_ +a¦ + +[markdown] +-- +The 99th percentile runtime for Search queries received at the global query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:grpc_query_timer_count* + +_optional_ +a¦ + +[markdown] +-- +The number of Search query timer events received at the gRPC endpoint. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:grpc_query_timer_mean_ns* + +_optional_ +a¦ + +[markdown] +-- +The mean runtime for Search queries received at the gRPC endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:grpc_query_timer_median_ns* + +_optional_ +a¦ + +[markdown] +-- +The median runtime for Search queries received at the gRPC endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:grpc_query_timer_p80_ns* + +_optional_ +a¦ + +[markdown] +-- +The 80th percentile runtime for Search queries received at the gRPC endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:grpc_query_timer_p99_ns* + +_optional_ +a¦ + +[markdown] +-- +The 99th percentile runtime for Search queries received at the gRPC endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + a¦ *BUCKET:INDEX:last_access_time* + _optional_ @@ -2124,6 +2304,81 @@ This statistic appears on the Server Web Console dashboard as **Search Memory Se a¦ Integer +a¦ +*BUCKET:INDEX:scoped_query_timer_count* + +_optional_ +a¦ + +[markdown] +-- +The number of Search query timer events received at the scoped query endpoint. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:scoped_query_timer_mean_ns* + +_optional_ +a¦ + +[markdown] +-- +The mean runtime for Search queries received at the scoped query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:scoped_query_timer_median_ns* + +_optional_ +a¦ + +[markdown] +-- +The median runtime for Search queries received at the scoped query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:scoped_query_timer_p80_ns* + +_optional_ +a¦ + +[markdown] +-- +The 80th percentile runtime for Search queries received at the scoped query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + +a¦ +*BUCKET:INDEX:scoped_query_timer_p99_ns* + +_optional_ +a¦ + +[markdown] +-- +The 99th percentile runtime for Search queries received at the scoped query endpoint in nanoseconds. +-- + +[%hardbreaks] +{blank} +a¦ Big Decimal + + a¦ *BUCKET:INDEX:timer_batch_store_count* + _optional_ diff --git a/docs/modules/fts-rest-stats/partials/header-attributes.adoc b/docs/modules/fts-rest-stats/partials/header-attributes.adoc index 1b4ed83e..37f11fa7 100644 --- a/docs/modules/fts-rest-stats/partials/header-attributes.adoc +++ b/docs/modules/fts-rest-stats/partials/header-attributes.adoc @@ -1,4 +1,6 @@ -:page-aliases: rest-api:rest-fts-statistics.adoc +:page-meta-robots: noindex +:page-embargo: EMBARGOED +:page-partial: :!example-caption: :description: The Search Statistics REST API is provided by the Search Service. \ This API enables you to get statistics for the Search Service and your Search indexes. diff --git a/docs/modules/index-rest-settings/attachments/index-settings.yaml b/docs/modules/index-rest-settings/attachments/_index-settings.yaml similarity index 100% rename from docs/modules/index-rest-settings/attachments/index-settings.yaml rename to docs/modules/index-rest-settings/attachments/_index-settings.yaml diff --git a/docs/modules/index-rest-settings/index-settings.gradle b/docs/modules/index-rest-settings/index-settings.gradle index fd5fec4b..c8048405 100644 --- a/docs/modules/index-rest-settings/index-settings.gradle +++ b/docs/modules/index-rest-settings/index-settings.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/index-settings.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_index-settings.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/index-rest-settings/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/index-rest-settings/partials/header-attributes.adoc b/docs/modules/index-rest-settings/partials/header-attributes.adoc index d8230b83..3df57645 100644 --- a/docs/modules/index-rest-settings/partials/header-attributes.adoc +++ b/docs/modules/index-rest-settings/partials/header-attributes.adoc @@ -1,5 +1,6 @@ +:page-meta-robots: noindex +:page-embargo: EMBARGOED :page-partial: -:page-aliases: rest-api:rest-modify-index-batch-size.adoc :!example-caption: :description: The Index Settings REST API is provided by the Index Service. \ This API enables you to retrieve or set Index Service settings. \ No newline at end of file diff --git a/docs/modules/index-rest-stats/attachments/indexes.yaml b/docs/modules/index-rest-stats/attachments/_indexes.yaml similarity index 100% rename from docs/modules/index-rest-stats/attachments/indexes.yaml rename to docs/modules/index-rest-stats/attachments/_indexes.yaml diff --git a/docs/modules/index-rest-stats/indexes.gradle b/docs/modules/index-rest-stats/indexes.gradle index bff74967..1568e09a 100644 --- a/docs/modules/index-rest-stats/indexes.gradle +++ b/docs/modules/index-rest-stats/indexes.gradle @@ -2,7 +2,7 @@ apply plugin: 'org.openapi.generator' openApiGenerate { generatorName = "asciidoc" - inputSpec = file("attachments/indexes.yaml").getAbsolutePath().toString() + inputSpec = file("attachments/_indexes.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/index-rest-stats/pages" templateDir = "${rootDir}/templates" gitRepoId = "cb-swagger" diff --git a/docs/modules/n1ql-rest-query/attachments/_overlay.json b/docs/modules/n1ql-rest-query/attachments/_overlay.json new file mode 100644 index 00000000..ea4b7092 --- /dev/null +++ b/docs/modules/n1ql-rest-query/attachments/_overlay.json @@ -0,0 +1,31 @@ +{ + "overlay": "1.0.0", + "info": { + "title": "Overlay for Query Service Schema", + "version": 1.0 + }, + "actions": [ + { + "description": "Update `creds` parameter for Query operations", + "target": "components.schemas.Request.properties", + "update": { + "creds": { + "x-desc-name": "creds", + "description": "In the Data API, this parameter is ignored and has no effect.\n\nIn the cbq shell, this parameter specifies credentials within a session.\nFor more information, see [Switch Between Credentials](../n1ql-intro/cbq.html#cbq-multiple-creds)." + } + } + }, + { + "description": "Remove `Credentials` schema", + "target": "components.schemas.Credentials", + "remove": true + }, + { + "description": "Remove badge from `use_fts` parameter", + "target": "components.schemas.Request.properties.use_fts", + "update": { + "x-desc-edition": false + } + } + ] +} \ No newline at end of file diff --git a/docs/modules/n1ql-rest-query/pages/index.adoc b/docs/modules/n1ql-rest-query/pages/index.adoc index 2f90f1c9..8ba0703b 100644 --- a/docs/modules/n1ql-rest-query/pages/index.adoc +++ b/docs/modules/n1ql-rest-query/pages/index.adoc @@ -683,7 +683,7 @@ endif::[] [#models] = Definitions -:count-models: 9 +:count-models: 8 :leveloffset: +1 @@ -699,7 +699,6 @@ endif::collapse-models[] [%hardbreaks] xref:Conditions[] xref:Controls[] -xref:Credentials[] xref:Execution_Timings[] xref:Metrics[] xref:Profile[] @@ -954,80 +953,6 @@ include::{specDir}definitions/Controls/definition-end.adoc[opts=optional] -// markup not found, no include::{specDir}definitions/Credentials/definition-before.adoc[opts=optional] - - -ifdef::collapse-models[] -[discrete] -endif::collapse-models[] -[#Credentials] -= Credentials - -:leveloffset: +1 - -// markup not found, no include::{specDir}definitions/Credentials/definition-begin.adoc[opts=optional] - - -.icon:brackets-curly[fw] Object -{blank} - -//tag::Credentials[] - - -[cols="25,55,20",separator=¦] -|=== -¦ Property ¦ ¦ Schema - -a¦ -*user* + -_optional_ -a¦ - -[markdown] --- -An identity for authentication. -Note that bucket names may be prefixed with `local:`, and admin names may be prefixed with `admin:`. --- - -[%hardbreaks] -*Example:* `+++"local:bucket-name"+++` -{blank} -a¦ String - - -a¦ -*pass* + -_optional_ -a¦ - -[markdown] --- -A password for authentication. --- - -[%hardbreaks] -*Example:* `+++"password"+++` -{blank} -a¦ String - - -|=== - -//end::Credentials[] - - - - -// markup not found, no include::{specDir}definitions/Credentials/definition-end.adoc[opts=optional] - - -:leveloffset: -1 - -// markup not found, no include::{specDir}definitions/Credentials/definition-after.adoc[opts=optional] - - - - // markup not found, no include::{specDir}definitions/Execution_Timings/definition-before.adoc[opts=optional] @@ -1747,20 +1672,16 @@ a¦ [markdown] -- -Specifies the login credentials. -The Query API supports two types of identity: local (or bucket) and admin. - -The format is an identity and password. -You can specify credentials for multiple identities. +In the Data API, this parameter is ignored and has no effect. -If credentials are supplied in the request header, then HTTP Basic Authentication takes precedence and `creds` is ignored. +In the cbq shell, this parameter specifies credentials within a session. +For more information, see [Switch Between Credentials](../n1ql-intro/cbq.html#cbq-multiple-creds). -- [%hardbreaks] -*Example:* `[{"user":"local:bucket-name","pass":"password"},{"user":"admin:admin-name","pass":"password"}]` {blank} -a¦ xref:Credentials[] - array +a¦ Any Type + a¦ [#durability_level] *durability_level* + @@ -2865,7 +2786,7 @@ a¦ Boolean a¦ [#use_fts] *use_fts* + _optional_ -a¦ [.edition]##{enterprise}## +a¦ [markdown] -- diff --git a/docs/modules/n1ql-rest-query/query-service.gradle b/docs/modules/n1ql-rest-query/query-service.gradle index 101f1e3b..bdae2ca8 100644 --- a/docs/modules/n1ql-rest-query/query-service.gradle +++ b/docs/modules/n1ql-rest-query/query-service.gradle @@ -1,8 +1,31 @@ +plugins { + id("io.datapith.jayOverlay").version("0.1.11") +} + apply plugin: 'org.openapi.generator' +task bundleSpec(type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask) { + generatorName = "openapi-yaml" + remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/service/service.yaml" + outputDir = "${projectDir}/build/bundle" + globalProperties = [ + generateAliasAsModel: "true" + ] + additionalProperties = [ + outputFile: "service.yaml", + ] + generateAliasAsModel = true +} + +jayOverlay { + targetFile.set("${projectDir}/build/bundle/service.yaml") + overlayFile.set("${projectDir}/attachments/_overlay.json") + outputDir.set("${projectDir}/build/overlay") +} + openApiGenerate { generatorName = "asciidoc" - remoteInputSpec = "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/service/service.yaml" + inputSpec = file("build/overlay/service.yaml").getAbsolutePath().toString() outputDir = "${rootDir}/docs/modules/n1ql-rest-query/pages" templateDir = "${rootDir}/templates" gitRepoId = "query" @@ -20,4 +43,7 @@ openApiGenerate { generateAliasAsModel: "true" ] generateAliasAsModel = true -} \ No newline at end of file +} + +tasks.applyOverlay.dependsOn(bundleSpec) +tasks.openApiGenerate.dependsOn(applyOverlay) \ No newline at end of file diff --git a/docs/modules/ns_server/attachments/new_spec.yaml b/docs/modules/ns_server/attachments/_new_spec.yaml similarity index 100% rename from docs/modules/ns_server/attachments/new_spec.yaml rename to docs/modules/ns_server/attachments/_new_spec.yaml diff --git a/docs/modules/ns_server/attachments/ns_server.yaml b/docs/modules/ns_server/attachments/_ns_server.yaml similarity index 100% rename from docs/modules/ns_server/attachments/ns_server.yaml rename to docs/modules/ns_server/attachments/_ns_server.yaml diff --git a/docs/modules/view_engine/attachments/view_engine.yaml b/docs/modules/view_engine/attachments/_view_engine.yaml similarity index 100% rename from docs/modules/view_engine/attachments/view_engine.yaml rename to docs/modules/view_engine/attachments/_view_engine.yaml