Class UpdateRequest<TDocument, TPartialDocument>
Request for Update
https://opensearch.org/docs/latest/api-reference/document-apis/update-document/
Inheritance
Inherited Members
Namespace: OpenSearch.Client
Assembly: OpenSearch.Client.dll
Syntax
public class UpdateRequest<TDocument, TPartialDocument> : PlainRequestBase<UpdateRequestParameters>, IUpdateRequest<TDocument, TPartialDocument>, IRequest<UpdateRequestParameters>, IRequest where TDocument : class where TPartialDocument : class
Type Parameters
Name | Description |
---|---|
TDocument | |
TPartialDocument |
Constructors
| Edit this page View SourceUpdateRequest()
Used for serialization purposes, making sure we have a parameterless constructor
Declaration
protected UpdateRequest()
UpdateRequest(Id)
/{index}/_update/{id}
Declaration
public UpdateRequest(Id id)
Parameters
Type | Name | Description |
---|---|---|
Id | id | this parameter is required |
UpdateRequest(IndexName, Id)
/{index}/_update/{id}
Declaration
public UpdateRequest(IndexName index, Id id)
Parameters
Type | Name | Description |
---|---|---|
IndexName | index | this parameter is required |
Id | id | this parameter is required |
UpdateRequest(TDocument, IndexName, Id)
/{index}/_update/{id}
Declaration
public UpdateRequest(TDocument documentWithId, IndexName index = null, Id id = null)
Parameters
Type | Name | Description |
---|---|---|
TDocument | documentWithId | |
IndexName | index | |
Id | id | The document used to resolve the path from |
Properties
| Edit this page View SourceDetectNoop
Declaration
public bool? DetectNoop { get; set; }
Property Value
Type | Description |
---|---|
bool? |
Doc
Declaration
public TPartialDocument Doc { get; set; }
Property Value
Type | Description |
---|---|
TPartialDocument |
DocAsUpsert
Declaration
public bool? DocAsUpsert { get; set; }
Property Value
Type | Description |
---|---|
bool? |
IfPrimaryTerm
Only perform the operation if the document has this primary term.
Declaration
public long? IfPrimaryTerm { get; set; }
Property Value
Type | Description |
---|---|
long? |
IfSequenceNumber
Only perform the operation if the document has this sequence number.
Declaration
public long? IfSequenceNumber { get; set; }
Property Value
Type | Description |
---|---|
long? |
Lang
The script language.
Declaration
public string Lang { get; set; }
Property Value
Type | Description |
---|---|
string |
Refresh
If 'true', OpenSearch refreshes the affected shards to make this operation visible to search, if wait_for
then wait for a refresh to
make this operation visible to search, if false
do nothing with refreshes.
Declaration
public Refresh? Refresh { get; set; }
Property Value
Type | Description |
---|---|
Refresh? |
RequireAlias
If true
, the destination must be an index alias.
Declaration
public bool? RequireAlias { get; set; }
Property Value
Type | Description |
---|---|
bool? |
RetryOnConflict
Specify how many times should the operation be retried when a conflict occurs.
Declaration
public long? RetryOnConflict { get; set; }
Property Value
Type | Description |
---|---|
long? |
Routing
A document is routed to a particular shard in an index using the following formula
shard_num = hash(_routing) % num_primary_shards
OpenSearch will use the document id if not provided.
For requests that are constructed from/for a document OpenSearch.Client will automatically infer the routing key if that document has a JoinField or a routing mapping on for its type exists on ConnectionSettings
Declaration
public Routing Routing { get; set; }
Property Value
Type | Description |
---|---|
Routing |
Script
Declaration
public IScript Script { get; set; }
Property Value
Type | Description |
---|---|
IScript |
ScriptedUpsert
If you would like your script to run regardless of whether the document exists or not — i.e. the script handles initializing the document instead of the upsert element — then set scripted_upsert to true
Declaration
public bool? ScriptedUpsert { get; set; }
Property Value
Type | Description |
---|---|
bool? |
Self
Declaration
protected IUpdateRequest<TDocument, TPartialDocument> Self { get; }
Property Value
Type | Description |
---|---|
IUpdateRequest<TDocument, TPartialDocument> |
Source
Declaration
public Union<bool, ISourceFilter> Source { get; set; }
Property Value
Type | Description |
---|---|
Union<bool, ISourceFilter> |
SourceEnabled
Whether the _source should be included in the response.
Declaration
public bool? SourceEnabled { get; set; }
Property Value
Type | Description |
---|---|
bool? |
Timeout
Period to wait for dynamic mapping updates and active shards. This guarantees OpenSearch waits for at least the timeout before failing. The actual wait time could be longer, particularly when multiple waits occur.
Declaration
public Time Timeout { get; set; }
Property Value
Type | Description |
---|---|
Time |
Upsert
Declaration
public TDocument Upsert { get; set; }
Property Value
Type | Description |
---|---|
TDocument |
WaitForActiveShards
The number of shard copies that must be active before proceeding with the operations. Set to 'all' or any positive integer up to the total number of shards in the index (number_of_replicas+1). Defaults to 1 meaning the primary shard.
Declaration
public string WaitForActiveShards { get; set; }
Property Value
Type | Description |
---|---|
string |