OpenSearchIngestion / Client / update_pipeline

update_pipeline#

OpenSearchIngestion.Client.update_pipeline(**kwargs)#

Updates an OpenSearch Ingestion pipeline. For more information, see Updating Amazon OpenSearch Ingestion pipelines.

See also: AWS API Documentation

Request Syntax

response = client.update_pipeline(
    PipelineName='string',
    MinUnits=123,
    MaxUnits=123,
    PipelineConfigurationBody='string',
    LogPublishingOptions={
        'IsLoggingEnabled': True|False,
        'CloudWatchLogDestination': {
            'LogGroup': 'string'
        }
    },
    BufferOptions={
        'PersistentBufferEnabled': True|False
    },
    EncryptionAtRestOptions={
        'KmsKeyArn': 'string'
    }
)
Parameters:
  • PipelineName (string) –

    [REQUIRED]

    The name of the pipeline to update.

  • MinUnits (integer) – The minimum pipeline capacity, in Ingestion Compute Units (ICUs).

  • MaxUnits (integer) – The maximum pipeline capacity, in Ingestion Compute Units (ICUs)

  • PipelineConfigurationBody (string) – The pipeline configuration in YAML format. The command accepts the pipeline configuration as a string or within a .yaml file. If you provide the configuration as a string, each new line must be escaped with \n.

  • LogPublishingOptions (dict) –

    Key-value pairs to configure log publishing.

    • IsLoggingEnabled (boolean) –

      Whether logs should be published.

    • CloudWatchLogDestination (dict) –

      The destination for OpenSearch Ingestion logs sent to Amazon CloudWatch Logs. This parameter is required if IsLoggingEnabled is set to true.

      • LogGroup (string) – [REQUIRED]

        The name of the CloudWatch Logs group to send pipeline logs to. You can specify an existing log group or create a new one. For example, /aws/OpenSearchService/IngestionService/my-pipeline.

  • BufferOptions (dict) –

    Key-value pairs to configure persistent buffering for the pipeline.

    • PersistentBufferEnabled (boolean) – [REQUIRED]

      Whether persistent buffering should be enabled.

  • EncryptionAtRestOptions (dict) –

    Key-value pairs to configure encryption for data that is written to a persistent buffer.

    • KmsKeyArn (string) – [REQUIRED]

      The ARN of the KMS key used to encrypt data-at-rest in OpenSearch Ingestion. By default, data is encrypted using an AWS owned key.

Return type:

dict

Returns:

Response Syntax

{
    'Pipeline': {
        'PipelineName': 'string',
        'PipelineArn': 'string',
        'MinUnits': 123,
        'MaxUnits': 123,
        'Status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'STARTING'|'START_FAILED'|'STOPPING'|'STOPPED',
        'StatusReason': {
            'Description': 'string'
        },
        'PipelineConfigurationBody': 'string',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'IngestEndpointUrls': [
            'string',
        ],
        'LogPublishingOptions': {
            'IsLoggingEnabled': True|False,
            'CloudWatchLogDestination': {
                'LogGroup': 'string'
            }
        },
        'VpcEndpoints': [
            {
                'VpcEndpointId': 'string',
                'VpcId': 'string',
                'VpcOptions': {
                    'SubnetIds': [
                        'string',
                    ],
                    'SecurityGroupIds': [
                        'string',
                    ]
                }
            },
        ],
        'BufferOptions': {
            'PersistentBufferEnabled': True|False
        },
        'EncryptionAtRestOptions': {
            'KmsKeyArn': 'string'
        },
        'ServiceVpcEndpoints': [
            {
                'ServiceName': 'OPENSEARCH_SERVERLESS',
                'VpcEndpointId': 'string'
            },
        ],
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) –

    • Pipeline (dict) –

      Container for information about the updated pipeline.

      • PipelineName (string) –

        The name of the pipeline.

      • PipelineArn (string) –

        The Amazon Resource Name (ARN) of the pipeline.

      • MinUnits (integer) –

        The minimum pipeline capacity, in Ingestion Compute Units (ICUs).

      • MaxUnits (integer) –

        The maximum pipeline capacity, in Ingestion Compute Units (ICUs).

      • Status (string) –

        The current status of the pipeline.

      • StatusReason (dict) –

        The reason for the current status of the pipeline.

        • Description (string) –

          A description of why a pipeline has a certain status.

      • PipelineConfigurationBody (string) –

        The Data Prepper pipeline configuration in YAML format.

      • CreatedAt (datetime) –

        The date and time when the pipeline was created.

      • LastUpdatedAt (datetime) –

        The date and time when the pipeline was last updated.

      • IngestEndpointUrls (list) –

        The ingestion endpoints for the pipeline, which you can send data to.

        • (string) –

      • LogPublishingOptions (dict) –

        Key-value pairs that represent log publishing settings.

        • IsLoggingEnabled (boolean) –

          Whether logs should be published.

        • CloudWatchLogDestination (dict) –

          The destination for OpenSearch Ingestion logs sent to Amazon CloudWatch Logs. This parameter is required if IsLoggingEnabled is set to true.

          • LogGroup (string) –

            The name of the CloudWatch Logs group to send pipeline logs to. You can specify an existing log group or create a new one. For example, /aws/OpenSearchService/IngestionService/my-pipeline.

      • VpcEndpoints (list) –

        The VPC interface endpoints that have access to the pipeline.

        • (dict) –

          An OpenSearch Ingestion-managed VPC endpoint that will access one or more pipelines.

          • VpcEndpointId (string) –

            The unique identifier of the endpoint.

          • VpcId (string) –

            The ID for your VPC. Amazon Web Services PrivateLink generates this value when you create a VPC.

          • VpcOptions (dict) –

            Information about the VPC, including associated subnets and security groups.

            • SubnetIds (list) –

              A list of subnet IDs associated with the VPC endpoint.

              • (string) –

            • SecurityGroupIds (list) –

              A list of security groups associated with the VPC endpoint.

              • (string) –

      • BufferOptions (dict) –

        Options that specify the configuration of a persistent buffer. To configure how OpenSearch Ingestion encrypts this data, set the EncryptionAtRestOptions.

        • PersistentBufferEnabled (boolean) –

          Whether persistent buffering should be enabled.

      • EncryptionAtRestOptions (dict) –

        Options to control how OpenSearch encrypts all data-at-rest.

        • KmsKeyArn (string) –

          The ARN of the KMS key used to encrypt data-at-rest in OpenSearch Ingestion. By default, data is encrypted using an AWS owned key.

      • ServiceVpcEndpoints (list) –

        A list of VPC endpoints that OpenSearch Ingestion has created to other AWS services.

        • (dict) –

          A container for information about VPC endpoints that were created to other services

          • ServiceName (string) –

            The name of the service for which a VPC endpoint was created.

          • VpcEndpointId (string) –

            The ID of the VPC endpoint that was created.

      • Tags (list) –

        A list of tags associated with the given pipeline.

        • (dict) –

          A tag (key-value pair) for an OpenSearch Ingestion pipeline.

          • Key (string) –

            The tag key. Tag keys must be unique for the pipeline to which they are attached.

          • Value (string) –

            The value assigned to the corresponding tag key. Tag values can be null and don’t have to be unique in a tag set. For example, you can have a key value pair in a tag set of project : Trinity and cost-center : Trinity

Exceptions

  • OpenSearchIngestion.Client.exceptions.ValidationException

  • OpenSearchIngestion.Client.exceptions.InternalException

  • OpenSearchIngestion.Client.exceptions.AccessDeniedException

  • OpenSearchIngestion.Client.exceptions.ResourceNotFoundException

  • OpenSearchIngestion.Client.exceptions.ConflictException