Skip to content

Commit

Permalink
[3.2.1 Backport] REST API Docs: enterprise-edition -> `Enterprise E…
Browse files Browse the repository at this point in the history
…dition` (#7170)

Co-authored-by: Elliot Francis Hunter <[email protected]>
  • Loading branch information
bbrks and ElliotFrancisHunter authored Oct 22, 2024
1 parent 9326dbd commit 8a6d671
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions docs/api/components/schemas.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -673,15 +673,15 @@ Retrieved-replication:
description: |-
This defines what conflict resolution policy Sync Gateway should use to apply when resolving conflicting revisions.
Changing this is an enterprise-edition only feature.
Changing this is an Enterprise Edition only feature.
**Behaviour**
* *default* - In priority order, this will cause
- Deletes to always win (the delete with the longest revision history wins if both revisions are deletes)
- The revision with the longest revision history to win. This means the the revision with the most changes and therefore the highest revision ID will win.
* *localWins* - This will result in local revisions always being the winner in any conflict.
* *remoteWins* - This will result in remote revisions always being the winner in any conflict.
* *custom* - This will result in conflicts going through your own custom conflict resolver. You must provide this logic as a Javascript function in the `custom_conflict_resolver` parameter. This is an enterprise-edition only feature.
* *custom* - This will result in conflicts going through your own custom conflict resolver. You must provide this logic as a Javascript function in the `custom_conflict_resolver` parameter. This is an Enterprise Edition only feature.
Note: replications created prior to Sync Gateway 2.8 will default to `default`.
Expand All @@ -693,7 +693,7 @@ Retrieved-replication:
- localWins
- custom
custom_conflict_resolver:
description: "This specifies the Javascript function to use to resolve conflicts between conflicting revisions.\n \nThis **must** be used when `conflict_resolution_type=custom`. This property will be ignored when `conflict_resolution_type` is not `custom`.\n\nThe Javascript function to provide this property should be in backticks (like the sync function). The function takes 1 parameter which is a struct that represents the conflict. This struct has 2 properties:\n* `LocalDocument` - The local document. This contains the document ID under the `_id` key.\n* `RemoteDocument` - The remote document\nThe function should return the new documents body. This can be the winning revision (for example, `return conflict.LocalDocument`), a new body, or `nil` to resolve as a delete.\n\nExample:\n```\n\"custom_conflict_resolver\":\\`\n\tfunction(conflict) {\n\t\tconsole.log(\"Doc ID: \"+conflict.LocalDocument._id);\n\t\tconsole.log(\"Full remote doc: \"+JSON.stringify(conflict.RemoteDocument));\n\t\treturn conflict.RemoteDocument;\n\t}\n\\`\n```\n\nUsing complex `custom_conflict_resolver` functions can noticeably degrade performance. Use a built-in resolver whenever possible.\n\nThis is an enterprise-edition only feature.\n"
description: "This specifies the Javascript function to use to resolve conflicts between conflicting revisions.\n \nThis **must** be used when `conflict_resolution_type=custom`. This property will be ignored when `conflict_resolution_type` is not `custom`.\n\nThe Javascript function to provide this property should be in backticks (like the sync function). The function takes 1 parameter which is a struct that represents the conflict. This struct has 2 properties:\n* `LocalDocument` - The local document. This contains the document ID under the `_id` key.\n* `RemoteDocument` - The remote document\nThe function should return the new documents body. This can be the winning revision (for example, `return conflict.LocalDocument`), a new body, or `nil` to resolve as a delete.\n\nExample:\n```\n\"custom_conflict_resolver\":\\`\n\tfunction(conflict) {\n\t\tconsole.log(\"Doc ID: \"+conflict.LocalDocument._id);\n\t\tconsole.log(\"Full remote doc: \"+JSON.stringify(conflict.RemoteDocument));\n\t\treturn conflict.RemoteDocument;\n\t}\n\\`\n```\n\nUsing complex `custom_conflict_resolver` functions can noticeably degrade performance. Use a built-in resolver whenever possible.\n\nThis is an Enterprise Edition only feature.\n"
type: string
default: none
purge_on_removal:
Expand All @@ -711,7 +711,7 @@ Retrieved-replication:
Replications created prior to Sync Gateway 2.8 must have delta-sync disabled.
Enabling this is an enterprise-edition only feature.
Enabling this is an Enterprise Edition only feature.
type: boolean
default: false
max_backoff_time:
Expand Down Expand Up @@ -776,7 +776,7 @@ Retrieved-replication:
type: boolean
default: false
batch_size:
description: The amount of changes to be sent in one batch of replications. Changing this is an enterprise-edition only feature.
description: The amount of changes to be sent in one batch of replications. Changing this is an Enterprise Edition only feature.
type: integer
default: 200
run_as:
Expand Down Expand Up @@ -901,15 +901,15 @@ Replication:
description: |-
This defines what conflict resolution policy Sync Gateway should use to apply when resolving conflicting revisions.
Changing this is an enterprise-edition only feature.
Changing this is an Enterprise Edition only feature.
**Behaviour**
* *default* - In priority order, this will cause
- Deletes to always win (the delete with the longest revision history wins if both revisions are deletes)
- The revision with the longest revision history to win. This means the the revision with the most changes and therefore the highest revision ID will win.
* *localWins* - This will result in local revisions always being the winner in any conflict.
* *remoteWins* - This will result in remote revisions always being the winner in any conflict.
* *custom* - This will result in conflicts going through your own custom conflict resolver. You must provide this logic as a Javascript function in the `custom_conflict_resolver` parameter. This is an enterprise-edition only feature.
* *custom* - This will result in conflicts going through your own custom conflict resolver. You must provide this logic as a Javascript function in the `custom_conflict_resolver` parameter. This is an Enterprise Edition only feature.
Note: replications created prior to Sync Gateway 2.8 will default to `default`.
Expand All @@ -921,7 +921,7 @@ Replication:
- localWins
- custom
custom_conflict_resolver:
description: "This specifies the Javascript function to use to resolve conflicts between conflicting revisions.\n \nThis **must** be used when `conflict_resolution_type=custom`. This property will be ignored when `conflict_resolution_type` is not `custom`.\n\nThe Javascript function to provide this property should be in backticks (like the sync function). The function takes 1 parameter which is a struct that represents the conflict. This struct has 2 properties:\n* `LocalDocument` - The local document. This contains the document ID under the `_id` key.\n* `RemoteDocument` - The remote document\nThe function should return the new documents body. This can be the winning revision (for example, `return conflict.LocalDocument`), a new body, or `nil` to resolve as a delete.\n\nExample:\n```\n\"custom_conflict_resolver\":\\`\n\tfunction(conflict) {\n\t\tconsole.log(\"Doc ID: \"+conflict.LocalDocument._id);\n\t\tconsole.log(\"Full remote doc: \"+JSON.stringify(conflict.RemoteDocument));\n\t\treturn conflict.RemoteDocument;\n\t}\n\\`\n```\n\nUsing complex `custom_conflict_resolver` functions can noticeably degrade performance. Use a built-in resolver whenever possible.\n\nThis is an enterprise-edition only feature.\n"
description: "This specifies the Javascript function to use to resolve conflicts between conflicting revisions.\n \nThis **must** be used when `conflict_resolution_type=custom`. This property will be ignored when `conflict_resolution_type` is not `custom`.\n\nThe Javascript function to provide this property should be in backticks (like the sync function). The function takes 1 parameter which is a struct that represents the conflict. This struct has 2 properties:\n* `LocalDocument` - The local document. This contains the document ID under the `_id` key.\n* `RemoteDocument` - The remote document\nThe function should return the new documents body. This can be the winning revision (for example, `return conflict.LocalDocument`), a new body, or `nil` to resolve as a delete.\n\nExample:\n```\n\"custom_conflict_resolver\":\\`\n\tfunction(conflict) {\n\t\tconsole.log(\"Doc ID: \"+conflict.LocalDocument._id);\n\t\tconsole.log(\"Full remote doc: \"+JSON.stringify(conflict.RemoteDocument));\n\t\treturn conflict.RemoteDocument;\n\t}\n\\`\n```\n\nUsing complex `custom_conflict_resolver` functions can noticeably degrade performance. Use a built-in resolver whenever possible.\n\nThis is an Enterprise Edition only feature.\n"
type: string
default: none
purge_on_removal:
Expand All @@ -939,7 +939,7 @@ Replication:
Replications created prior to Sync Gateway 2.8 must have delta-sync disabled.
Enabling this is an enterprise-edition only feature.
Enabling this is an Enterprise Edition only feature.
type: boolean
default: false
max_backoff_time:
Expand Down Expand Up @@ -1004,7 +1004,7 @@ Replication:
type: boolean
default: false
batch_size:
description: The amount of changes to be sent in one batch of replications. Changing this is an enterprise-edition only feature.
description: The amount of changes to be sent in one batch of replications. Changing this is an Enterprise Edition only feature.
type: integer
default: 200
run_as:
Expand Down Expand Up @@ -1240,13 +1240,13 @@ Database:
description: |-
If true, documents will be imported in to Sync Gateway from the bucket when requested. Documents will be ran through the set `import_filter` if any is set.
The default value depends on the edition of Sync Gateway being used. If the edition is the community-edition, then this will default to `false` or else in the enterprise-edition, it will default to `true`.
The default value depends on the edition of Sync Gateway being used. If the edition is the Community Edition, then this will default to `false` or else in the Enterprise Edition, it will default to `true`.
This can also be set to the string `continuous` which maps to true.
type: boolean
import_partitions:
description: |-
** This is an enterprise-edition feature only**
** This is an Enterprise Edition feature only**
This is how many import partitions should be used for import sharding.
Expand Down Expand Up @@ -1308,7 +1308,7 @@ Database:
description: |-
The maximum amount of memory the revision cache should take up in MB, setting to 0 will disable any eviction based on memory at rev cache.
When set this memory limit will work in in hand with revision cache size parameter. So you will potentially get eviction at revision cache both based off memory footprint and number of items in the cache.
**This is an enterprise-edition feature only**
**This is an Enterprise Edition feature only**
type: integer
default: 0
shard_count:
Expand Down Expand Up @@ -1737,14 +1737,14 @@ Database:
description: |-
Delta sync configuration settings.
**This is an enterprise-edition feature only**
**This is an Enterprise Edition feature only**
type: object
properties:
enabled:
description: |-
Whether delta sync is enabled.
**This is an enterprise-edition feature only**
**This is an Enterprise Edition feature only**
type: boolean
default: false
rev_max_age_seconds:
Expand Down Expand Up @@ -2257,7 +2257,7 @@ Startup-config:
description: |-
Whether to enable the DP permissions check feature of admin auth.
Defaults to `true` if using enterprise-edition or `false` if using community-edition.
Defaults to `true` if using Enterprise Edition or `false` if using Community Edition.
type: boolean
server_read_timeout:
description: |-
Expand Down

0 comments on commit 8a6d671

Please sign in to comment.