o gZh@sHddlZddlmZddlmZddlmZmZm Z GdddeZ dS)N)ObjectApiResponse)NamespacedClient) SKIP_IN_PATH_quote_rewrite_parametersc(@seZdZedddddddddedejedejedejejeej efdejedejed ejed ejejd d efd e ej fddZ eddiddddddddddd dejejeej efdejedejedejedejejeej efdeje dejed ejedeje d e ej fddZeddidddddddddddejeej efdejedejedejejeej efdeje dejed ejedeje d ejejd d efd e ej fddZedddddddddddddddddddejedejed ejejeej fdejedejejeej efd!ejejd d efdejed"ejejeej fd#ejejeej fd ejed$ejejeej fd%ejejeej fd&ejejeej fd'ejejeej fd ejejd d efd e ej f d(d)Zedd*d+id,ddddddddddddddd-ded ejeej fd&ejeej fd.ejedejedejedejejeej efd!ejejd d efdejed"ejejeej fd+ejejeej fd#ejejeej fd ejed$ejejeej fd%ejejeej fd'ejejeej fd ejejd d efd e ej f$d/d0Zedddddd1dedejedejejeej efdejedejed ejed e ej fd2d3Zedddddd4dedejedejejeej efdejed ejed ejejd d efd e ej fd5d6Zeddidddddddd7dedejedejejeej efdejedejed ejed ejejd d efd e ej fd8d9Zedddddddddd: dedejedejedejejeej efdejedejed ejed ejejd d efd;ejedZedd*d+id,ddddddddddddddd?ded.ejedejed ejejeej fdejedejejeej efd!ejejd d efdejed+ejejeej fd ejed$ejejdejeej ffd%ejejeej fd&ejejeej fd'ejejeej fd ejejd d efd e ej f d@dAZedddddddBdCejedejedejejeej efdejed ejed ejejd d efd e ej fdDdEZdS)FTransformClientN)delete_dest_index error_trace filter_pathforcehumanprettytimeout transform_idr r r r r rrz t.Literal[-1]z t.Literal[0]returnc Cs|tvrtddt|} i} |dur|| d<|dur!|| d<|dur)|| d<|dur1|| d<|dur9|| d<|durA|| d <|durI|| d <d d i} |jd | | | dS)a Deletes an existing transform. ``_ :param transform_id: Identifier for the transform. :param delete_dest_index: If this value is true, the destination index is deleted together with the transform. If false, the destination index will not be deleted :param force: If this value is false, the transform must be stopped before it can be deleted. If true, the transform is deleted regardless of its current state. :param timeout: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. /Empty value passed for parameter 'transform_id' /_transform/Nr r r r r rracceptapplication/jsonDELETEparamsheadersr ValueErrorrperform_request) selfrr r r r r rr_TransformClient__path_TransformClient__query_TransformClient__headersr![/var/www/html/lang_env/lib/python3.10/site-packages/elasticsearch/_sync/client/transform.pydelete_transforms,z TransformClient.delete_transformfromfrom_)parameter_aliases) rallow_no_matchr exclude_generatedr r%r rsizer'r(r)c Cs|tvr dt|} nd} i} |dur|| d<|dur || d<|dur(|| d<|dur0|| d<|dur8|| d<|dur@|| d <|durH|| d <| durP| | d <d d i} |jd| | | dS)a Retrieves configuration information for transforms. ``_ :param transform_id: Identifier for the transform. It can be a transform identifier or a wildcard expression. You can get information for all transforms by using `_all`, by specifying `*` as the ``, or by omitting the ``. :param allow_no_match: Specifies what to do when the request: 1. Contains wildcard expressions and there are no transforms that match. 2. Contains the _all string or no identifiers and there are no matches. 3. Contains wildcard expressions and there are only partial matches. If this parameter is false, the request returns a 404 status code when there are no matches or only partial matches. :param exclude_generated: Excludes fields that were automatically added when creating the transform. This allows the configuration to be in an acceptable format to be retrieved and then added to another cluster. :param from_: Skips the specified number of transforms. :param size: Specifies the maximum number of transforms to obtain. rz /_transformNr'r r(r r$r rr)rrGETrrrr) rrr'r r(r r%r rr)rrr r!r!r" get_transformNs0#zTransformClient.get_transform)r'r r r%r rr)rc Cs|tvrtddt|d} i} |dur|| d<|dur"|| d<|dur*|| d<|dur2|| d<|dur:|| d <|durB|| d <|durJ|| d <| durR| | d <d di} |jd| | | dS)aH Retrieves usage information for transforms. ``_ :param transform_id: Identifier for the transform. It can be a transform identifier or a wildcard expression. You can get information for all transforms by using `_all`, by specifying `*` as the ``, or by omitting the ``. :param allow_no_match: Specifies what to do when the request: 1. Contains wildcard expressions and there are no transforms that match. 2. Contains the _all string or no identifiers and there are no matches. 3. Contains wildcard expressions and there are only partial matches. If this parameter is false, the request returns a 404 status code when there are no matches or only partial matches. :param from_: Skips the specified number of transforms. :param size: Specifies the maximum number of transforms to obtain. :param timeout: Controls the time to wait for the stats rrz/_statsNr'r r r$r rr)rrrr*rr) rrr'r r r%r rr)rrrr r!r!r"get_transform_statss0!z#TransformClient.get_transform_statsT) body_fields)r descriptiondestr r frequencyr latestpivotrretention_policysettingssourcesyncrr/r0r1r2r3r4r5r6r7cCs:|tvr dt|d}nd}i}i}|dur||d<|dur#||d<|dur+||d<|dur3||d<|dur;||d <|durC||d <|durK||d <| durS| |d <| dur[| |d <| durc| |d<| durk| |d<| durs| |d<|dur{||d<|dur||d<|sd}ddi}|durd|d<|jd||||dS)ax Previews a transform. ``_ :param transform_id: Identifier for the transform to preview. If you specify this path parameter, you cannot provide transform configuration details in the request body. :param description: Free text description of the transform. :param dest: The destination for the transform. :param frequency: The interval between checks for changes in the source indices when the transform is running continuously. Also determines the retry interval in the event of transient failures while the transform is searching or indexing. The minimum value is 1s and the maximum is 1h. :param latest: The latest method transforms the data by finding the latest document for each unique key. :param pivot: The pivot method transforms the data by aggregating and grouping it. These objects define the group by fields and the aggregation to reduce the data. :param retention_policy: Defines a retention policy for the transform. Data that meets the defined criteria is deleted from the destination index. :param settings: Defines optional transform settings. :param source: The source of the data for the transform. :param sync: Defines the properties transforms require to run continuously. :param timeout: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. rz /_previewz/_transform/_previewNr/r0r r r1r r2r3rr4r5r6r7rrr content-typePOSTrrbodyr+)rrr/r0r r r1r r2r3rr4r5r6r7rr_TransformClient__bodyrr r!r!r"preview_transformsR1 z!TransformClient.preview_transform_metameta)r.r&)defer_validationr/r r r1r r2r?r3rr4r5r7rr@cCsd|tvrtd|durtd|durtddt|}i}i}|dur+||d<|dur3||d<|dur;||d<|durC||d <|durK||d <|durS||d <|dur[||d <| durc| |d <| durk| |d<| durs| |d<| dur{| |d<| dur| |d<|dur||d<|dur||d<|dur||d<|dur||d<ddd}|jd||||dS)a> Instantiates a transform. ``_ :param transform_id: Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters. :param dest: The destination for the transform. :param source: The source of the data for the transform. :param defer_validation: When the transform is created, a series of validations occur to ensure its success. For example, there is a check for the existence of the source indices and a check that the destination index is not part of the source index pattern. You can use this parameter to skip the checks, for example when the source index does not exist until after the transform is created. The validations are always run when you start the transform, however, with the exception of privilege checks. :param description: Free text description of the transform. :param frequency: The interval between checks for changes in the source indices when the transform is running continuously. Also determines the retry interval in the event of transient failures while the transform is searching or indexing. The minimum value is `1s` and the maximum is `1h`. :param latest: The latest method transforms the data by finding the latest document for each unique key. :param meta: Defines optional transform metadata. :param pivot: The pivot method transforms the data by aggregating and grouping it. These objects define the group by fields and the aggregation to reduce the data. :param retention_policy: Defines a retention policy for the transform. Data that meets the defined criteria is deleted from the destination index. :param settings: Defines optional transform settings. :param sync: Defines the properties transforms require to run continuously. :param timeout: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. rNz'Empty value passed for parameter 'dest'z)Empty value passed for parameter 'source'rr0r6r@r/r r r1r r2r>r3rr4r5r7rrrr8PUTr:r)rrr0r6r@r/r r r1r r2r?r3rr4r5r7rrr<rr r!r!r" put_transform!sZ<  zTransformClient.put_transform)r r r r rc C|tvrtddt|d}i}|dur||d<|dur"||d<|dur*||d<|dur2||d<|dur:||d <d d i} |jd ||| d S)aa Resets an existing transform. ``_ :param transform_id: Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters. :param force: If this value is `true`, the transform is reset regardless of its current state. If it's `false`, the transform must be stopped before it can be reset. rrz/_resetNr r r r rrrr9rr) rrr r r r rrrr r!r!r"reset_transforms$zTransformClient.reset_transform)r r r rrc CrD)a" Schedules now a transform. ``_ :param transform_id: Identifier for the transform. :param timeout: Controls the time to wait for the scheduling to take place rrz/_schedule_nowNr r r rrrrr9rr) rrr r r rrrrr r!r!r"schedule_now_transforms$z&TransformClient.schedule_now_transform)r r r%r rrc Cs|tvrtddt|d}i} |dur|| d<|dur"|| d<|dur*|| d<|dur2|| d<|dur:|| d <|durB|| d <d d i} |jd || | dS)a> Starts one or more transforms. ``_ :param transform_id: Identifier for the transform. :param from_: Restricts the set of transformed entities to those changed after this time. Relative times like now-30d are supported. Only applicable for continuous transforms. :param timeout: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. rrz/_startNr r r$r rrrrr9rr) rrr r r%r rrrrr r!r!r"start_transforms(zTransformClient.start_transform) r'r r r r rrwait_for_checkpointwait_for_completionrHrIc Cs|tvrtddt|d} i} |dur|| d<|dur"|| d<|dur*|| d<|dur2|| d<|dur:|| d <|durB|| d <|durJ|| d <| durR| | d <| durZ| | d <ddi} |jd| | | dS)a7 Stops one or more transforms. ``_ :param transform_id: Identifier for the transform. To stop multiple transforms, use a comma-separated list or a wildcard expression. To stop all transforms, use `_all` or `*` as the identifier. :param allow_no_match: Specifies what to do when the request: contains wildcard expressions and there are no transforms that match; contains the `_all` string or no identifiers and there are no matches; contains wildcard expressions and there are only partial matches. If it is true, the API returns a successful acknowledgement message when there are no matches. When there are only partial matches, the API stops the appropriate transforms. If it is false, the request returns a 404 status code when there are no matches or only partial matches. :param force: If it is true, the API forcefully stops the transforms. :param timeout: Period to wait for a response when `wait_for_completion` is `true`. If no response is received before the timeout expires, the request returns a timeout exception. However, the request continues processing and eventually moves the transform to a STOPPED state. :param wait_for_checkpoint: If it is true, the transform does not completely stop until the current checkpoint is completed. If it is false, the transform stops as soon as possible. :param wait_for_completion: If it is true, the API blocks until the indexer state completely stops. If it is false, the API returns immediately and the indexer is stopped asynchronously in the background. rrz/_stopNr'r r r r rrrHrIrrr9rr)rrr'r r r r rrrHrIrrr r!r!r"stop_transform s4*zTransformClient.stop_transform)r@r/r0r r r1r r?rr4r5r6r7rcCs&|tvrtddt|d}i}i}|dur||d<|dur$||d<|dur,||d<|dur4||d<|dur<||d <|durD||d <|durL||d <| durT| |d <| dur\| |d <| durd| |d<| durl| |d<| durt| |d<|dur|||d<|dur||d<ddd}|jd||||dS)a Updates certain properties of a transform. ``_ :param transform_id: Identifier for the transform. :param defer_validation: When true, deferrable validations are not run. This behavior may be desired if the source index does not exist until after the transform is created. :param description: Free text description of the transform. :param dest: The destination for the transform. :param frequency: The interval between checks for changes in the source indices when the transform is running continuously. Also determines the retry interval in the event of transient failures while the transform is searching or indexing. The minimum value is 1s and the maximum is 1h. :param meta: Defines optional transform metadata. :param retention_policy: Defines a retention policy for the transform. Data that meets the defined criteria is deleted from the destination index. :param settings: Defines optional transform settings. :param source: The source of the data for the transform. :param sync: Defines the properties transforms require to run continuously. :param timeout: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. rrz/_updateNr@r/r0r r r1r r>rr4r5r6r7rrrAr9r:r)rrr@r/r0r r r1r r?rr4r5r6r7rrrr<r r!r!r"update_transformOsJ/  z TransformClient.update_transform)dry_runr r r rrrLc Csd}i}|dur ||d<|dur||d<|dur||d<|dur$||d<|dur,||d<|dur4||d<d d i} |jd ||| d S) a Upgrades all transforms. ``_ :param dry_run: When true, the request checks for updates but does not run them. :param timeout: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. z/_transform/_upgradeNrLr r r rrrrr9r)r) rrLr r r rrrrr r!r!r"upgrade_transformss$z"TransformClient.upgrade_transforms)__name__ __module__ __qualname__rstrtOptionalboolUnionSequencerAnyr#intr,r-Mappingr=rCrErFrGrJrKrMr!r!r!r"rs   2    :    7      Y       f ) %  ,     D      Q r) typingrRZelastic_transportr_baserutilsrrrrr!r!r!r"s