{ "version":"2.0", "metadata":{ "apiVersion":"2022-01-01", "endpointPrefix":"osis", "protocol":"rest-json", "serviceFullName":"Amazon OpenSearch Ingestion", "serviceId":"OSIS", "signatureVersion":"v4", "uid":"osis-2022-01-01" }, "operations":{ "CreatePipeline":{ "name":"CreatePipeline", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/createPipeline" }, "input":{"shape":"CreatePipelineRequest"}, "output":{"shape":"CreatePipelineResponse"}, "errors":[ {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Creates an OpenSearch Ingestion pipeline. For more information, see Creating Amazon OpenSearch Ingestion pipelines.

" }, "DeletePipeline":{ "name":"DeletePipeline", "http":{ "method":"DELETE", "requestUri":"/2022-01-01/osis/deletePipeline/{PipelineName}" }, "input":{"shape":"DeletePipelineRequest"}, "output":{"shape":"DeletePipelineResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ConflictException"} ], "documentation":"

Deletes an OpenSearch Ingestion pipeline. For more information, see Deleting Amazon OpenSearch Ingestion pipelines.

" }, "GetPipeline":{ "name":"GetPipeline", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/getPipeline/{PipelineName}" }, "input":{"shape":"GetPipelineRequest"}, "output":{"shape":"GetPipelineResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Retrieves information about an OpenSearch Ingestion pipeline.

" }, "GetPipelineBlueprint":{ "name":"GetPipelineBlueprint", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/getPipelineBlueprint/{BlueprintName}" }, "input":{"shape":"GetPipelineBlueprintRequest"}, "output":{"shape":"GetPipelineBlueprintResponse"}, "errors":[ {"shape":"AccessDeniedException"}, {"shape":"InternalException"}, {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Retrieves information about a specific blueprint for OpenSearch Ingestion. Blueprints are templates for the configuration needed for a CreatePipeline request. For more information, see Using blueprints to create a pipeline.

" }, "GetPipelineChangeProgress":{ "name":"GetPipelineChangeProgress", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/getPipelineChangeProgress/{PipelineName}" }, "input":{"shape":"GetPipelineChangeProgressRequest"}, "output":{"shape":"GetPipelineChangeProgressResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Returns progress information for the current change happening on an OpenSearch Ingestion pipeline. Currently, this operation only returns information when a pipeline is being created.

For more information, see Tracking the status of pipeline creation.

" }, "ListPipelineBlueprints":{ "name":"ListPipelineBlueprints", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/listPipelineBlueprints" }, "input":{"shape":"ListPipelineBlueprintsRequest"}, "output":{"shape":"ListPipelineBlueprintsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"InvalidPaginationTokenException"} ], "documentation":"

Retrieves a list of all available blueprints for Data Prepper. For more information, see Using blueprints to create a pipeline.

" }, "ListPipelines":{ "name":"ListPipelines", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/listPipelines" }, "input":{"shape":"ListPipelinesRequest"}, "output":{"shape":"ListPipelinesResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"InvalidPaginationTokenException"} ], "documentation":"

Lists all OpenSearch Ingestion pipelines in the current Amazon Web Services account and Region. For more information, see Viewing Amazon OpenSearch Ingestion pipelines.

" }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/listTagsForResource/" }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Lists all resource tags associated with an OpenSearch Ingestion pipeline. For more information, see Tagging Amazon OpenSearch Ingestion pipelines.

" }, "StartPipeline":{ "name":"StartPipeline", "http":{ "method":"PUT", "requestUri":"/2022-01-01/osis/startPipeline/{PipelineName}" }, "input":{"shape":"StartPipelineRequest"}, "output":{"shape":"StartPipelineResponse"}, "errors":[ {"shape":"AccessDeniedException"}, {"shape":"ConflictException"}, {"shape":"InternalException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"} ], "documentation":"

Starts an OpenSearch Ingestion pipeline. For more information, see Starting an OpenSearch Ingestion pipeline.

" }, "StopPipeline":{ "name":"StopPipeline", "http":{ "method":"PUT", "requestUri":"/2022-01-01/osis/stopPipeline/{PipelineName}" }, "input":{"shape":"StopPipelineRequest"}, "output":{"shape":"StopPipelineResponse"}, "errors":[ {"shape":"AccessDeniedException"}, {"shape":"ConflictException"}, {"shape":"InternalException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"} ], "documentation":"

Stops an OpenSearch Ingestion pipeline. For more information, see Stopping an OpenSearch Ingestion pipeline.

" }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/tagResource/" }, "input":{"shape":"TagResourceRequest"}, "output":{"shape":"TagResourceResponse"}, "errors":[ {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Tags an OpenSearch Ingestion pipeline. For more information, see Tagging Amazon OpenSearch Ingestion pipelines.

" }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/untagResource/" }, "input":{"shape":"UntagResourceRequest"}, "output":{"shape":"UntagResourceResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Removes one or more tags from an OpenSearch Ingestion pipeline. For more information, see Tagging Amazon OpenSearch Ingestion pipelines.

" }, "UpdatePipeline":{ "name":"UpdatePipeline", "http":{ "method":"PUT", "requestUri":"/2022-01-01/osis/updatePipeline/{PipelineName}" }, "input":{"shape":"UpdatePipelineRequest"}, "output":{"shape":"UpdatePipelineResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ConflictException"} ], "documentation":"

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

" }, "ValidatePipeline":{ "name":"ValidatePipeline", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/validatePipeline" }, "input":{"shape":"ValidatePipelineRequest"}, "output":{"shape":"ValidatePipelineResponse"}, "errors":[ {"shape":"AccessDeniedException"}, {"shape":"InternalException"}, {"shape":"ValidationException"} ], "documentation":"

Checks whether an OpenSearch Ingestion pipeline configuration is valid prior to creation. For more information, see Creating Amazon OpenSearch Ingestion pipelines.

" } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "members":{ }, "documentation":"

You don't have permissions to access the resource.

", "error":{"httpStatusCode":403}, "exception":true }, "Boolean":{"type":"boolean"}, "BufferOptions":{ "type":"structure", "required":["PersistentBufferEnabled"], "members":{ "PersistentBufferEnabled":{ "shape":"Boolean", "documentation":"

Whether persistent buffering should be enabled.

" } }, "documentation":"

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

" }, "ChangeProgressStage":{ "type":"structure", "members":{ "Name":{ "shape":"String", "documentation":"

The name of the stage.

" }, "Status":{ "shape":"ChangeProgressStageStatuses", "documentation":"

The current status of the stage that the change is in.

" }, "Description":{ "shape":"String", "documentation":"

A description of the stage.

" }, "LastUpdatedAt":{ "shape":"Timestamp", "documentation":"

The most recent updated timestamp of the stage.

" } }, "documentation":"

Progress details for a specific stage of a pipeline configuration change.

" }, "ChangeProgressStageList":{ "type":"list", "member":{"shape":"ChangeProgressStage"} }, "ChangeProgressStageStatuses":{ "type":"string", "enum":[ "PENDING", "IN_PROGRESS", "COMPLETED", "FAILED" ] }, "ChangeProgressStatus":{ "type":"structure", "members":{ "StartTime":{ "shape":"Timestamp", "documentation":"

The time at which the configuration change is made on the pipeline.

" }, "Status":{ "shape":"ChangeProgressStatuses", "documentation":"

The overall status of the pipeline configuration change.

" }, "TotalNumberOfStages":{ "shape":"Integer", "documentation":"

The total number of stages required for the pipeline configuration change.

" }, "ChangeProgressStages":{ "shape":"ChangeProgressStageList", "documentation":"

Information about the stages that the pipeline is going through to perform the configuration change.

" } }, "documentation":"

The progress details of a pipeline configuration change.

" }, "ChangeProgressStatusList":{ "type":"list", "member":{"shape":"ChangeProgressStatus"} }, "ChangeProgressStatuses":{ "type":"string", "enum":[ "PENDING", "IN_PROGRESS", "COMPLETED", "FAILED" ] }, "CloudWatchLogDestination":{ "type":"structure", "required":["LogGroup"], "members":{ "LogGroup":{ "shape":"LogGroup", "documentation":"

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.

" } }, "documentation":"

The destination for OpenSearch Ingestion logs sent to Amazon CloudWatch.

" }, "ConflictException":{ "type":"structure", "members":{ }, "documentation":"

The client attempted to remove a resource that is currently in use.

", "error":{"httpStatusCode":409}, "exception":true }, "CreatePipelineRequest":{ "type":"structure", "required":[ "PipelineName", "MinUnits", "MaxUnits", "PipelineConfigurationBody" ], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the OpenSearch Ingestion pipeline to create. Pipeline names are unique across the pipelines owned by an account within an Amazon Web Services Region.

" }, "MinUnits":{ "shape":"PipelineUnits", "documentation":"

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

" }, "MaxUnits":{ "shape":"PipelineUnits", "documentation":"

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

" }, "PipelineConfigurationBody":{ "shape":"PipelineConfigurationBody", "documentation":"

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":{ "shape":"LogPublishingOptions", "documentation":"

Key-value pairs to configure log publishing.

" }, "VpcOptions":{ "shape":"VpcOptions", "documentation":"

Container for the values required to configure VPC access for the pipeline. If you don't specify these values, OpenSearch Ingestion creates the pipeline with a public endpoint.

" }, "BufferOptions":{ "shape":"BufferOptions", "documentation":"

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

" }, "EncryptionAtRestOptions":{ "shape":"EncryptionAtRestOptions", "documentation":"

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

" }, "Tags":{ "shape":"TagList", "documentation":"

List of tags to add to the pipeline upon creation.

" } } }, "CreatePipelineResponse":{ "type":"structure", "members":{ "Pipeline":{ "shape":"Pipeline", "documentation":"

Container for information about the created pipeline.

" } } }, "DeletePipelineRequest":{ "type":"structure", "required":["PipelineName"], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline to delete.

", "location":"uri", "locationName":"PipelineName" } } }, "DeletePipelineResponse":{ "type":"structure", "members":{ } }, "EncryptionAtRestOptions":{ "type":"structure", "required":["KmsKeyArn"], "members":{ "KmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"

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.

" } }, "documentation":"

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

" }, "GetPipelineBlueprintRequest":{ "type":"structure", "required":["BlueprintName"], "members":{ "BlueprintName":{ "shape":"String", "documentation":"

The name of the blueprint to retrieve.

", "location":"uri", "locationName":"BlueprintName" } } }, "GetPipelineBlueprintResponse":{ "type":"structure", "members":{ "Blueprint":{ "shape":"PipelineBlueprint", "documentation":"

The requested blueprint in YAML format.

" } } }, "GetPipelineChangeProgressRequest":{ "type":"structure", "required":["PipelineName"], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline.

", "location":"uri", "locationName":"PipelineName" } } }, "GetPipelineChangeProgressResponse":{ "type":"structure", "members":{ "ChangeProgressStatuses":{ "shape":"ChangeProgressStatusList", "documentation":"

The current status of the change happening on the pipeline.

" } } }, "GetPipelineRequest":{ "type":"structure", "required":["PipelineName"], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline to get information about.

", "location":"uri", "locationName":"PipelineName" } } }, "GetPipelineResponse":{ "type":"structure", "members":{ "Pipeline":{ "shape":"Pipeline", "documentation":"

Detailed information about the requested pipeline.

" } } }, "IngestEndpointUrlsList":{ "type":"list", "member":{"shape":"String"} }, "Integer":{"type":"integer"}, "InternalException":{ "type":"structure", "members":{ }, "documentation":"

The request failed because of an unknown error, exception, or failure (the failure is internal to the service).

", "error":{"httpStatusCode":500}, "exception":true }, "InvalidPaginationTokenException":{ "type":"structure", "members":{ }, "documentation":"

An invalid pagination token provided in the request.

", "error":{"httpStatusCode":400}, "exception":true }, "KmsKeyArn":{ "type":"string", "max":2048, "min":7 }, "LimitExceededException":{ "type":"structure", "members":{ }, "documentation":"

You attempted to create more than the allowed number of tags.

", "error":{"httpStatusCode":409}, "exception":true }, "ListPipelineBlueprintsRequest":{ "type":"structure", "members":{ } }, "ListPipelineBlueprintsResponse":{ "type":"structure", "members":{ "Blueprints":{ "shape":"PipelineBlueprintsSummaryList", "documentation":"

A list of available blueprints for Data Prepper.

" } } }, "ListPipelinesRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"MaxResults", "documentation":"

An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.

", "location":"querystring", "locationName":"maxResults" }, "NextToken":{ "shape":"NextToken", "documentation":"

If your initial ListPipelines operation returns a nextToken, you can include the returned nextToken in subsequent ListPipelines operations, which returns results in the next page.

", "location":"querystring", "locationName":"nextToken" } } }, "ListPipelinesResponse":{ "type":"structure", "members":{ "NextToken":{ "shape":"NextToken", "documentation":"

When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

" }, "Pipelines":{ "shape":"PipelineSummaryList", "documentation":"

A list of all existing Data Prepper pipelines.

" } } }, "ListTagsForResourceRequest":{ "type":"structure", "required":["Arn"], "members":{ "Arn":{ "shape":"PipelineArn", "documentation":"

The Amazon Resource Name (ARN) of the pipeline to retrieve tags for.

", "location":"querystring", "locationName":"arn" } } }, "ListTagsForResourceResponse":{ "type":"structure", "members":{ "Tags":{ "shape":"TagList", "documentation":"

A list of tags associated with the given pipeline.

" } } }, "LogGroup":{ "type":"string", "max":512, "min":1, "pattern":"\\/aws\\/vendedlogs\\/[\\.\\-_/#A-Za-z0-9]+" }, "LogPublishingOptions":{ "type":"structure", "members":{ "IsLoggingEnabled":{ "shape":"Boolean", "documentation":"

Whether logs should be published.

" }, "CloudWatchLogDestination":{ "shape":"CloudWatchLogDestination", "documentation":"

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

" } }, "documentation":"

Container for the values required to configure logging for the pipeline. If you don't specify these values, OpenSearch Ingestion will not publish logs from your application to CloudWatch Logs.

" }, "MaxResults":{ "type":"integer", "max":100, "min":1 }, "NextToken":{ "type":"string", "max":3000, "min":0, "pattern":"^([\\s\\S]*)$" }, "Pipeline":{ "type":"structure", "members":{ "PipelineName":{ "shape":"String", "documentation":"

The name of the pipeline.

" }, "PipelineArn":{ "shape":"String", "documentation":"

The Amazon Resource Name (ARN) of the pipeline.

" }, "MinUnits":{ "shape":"Integer", "documentation":"

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

" }, "MaxUnits":{ "shape":"Integer", "documentation":"

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

" }, "Status":{ "shape":"PipelineStatus", "documentation":"

The current status of the pipeline.

" }, "StatusReason":{ "shape":"PipelineStatusReason", "documentation":"

The reason for the current status of the pipeline.

" }, "PipelineConfigurationBody":{ "shape":"String", "documentation":"

The Data Prepper pipeline configuration in YAML format.

" }, "CreatedAt":{ "shape":"Timestamp", "documentation":"

The date and time when the pipeline was created.

" }, "LastUpdatedAt":{ "shape":"Timestamp", "documentation":"

The date and time when the pipeline was last updated.

" }, "IngestEndpointUrls":{ "shape":"IngestEndpointUrlsList", "documentation":"

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

" }, "LogPublishingOptions":{ "shape":"LogPublishingOptions", "documentation":"

Key-value pairs that represent log publishing settings.

" }, "VpcEndpoints":{ "shape":"VpcEndpointsList", "documentation":"

The VPC interface endpoints that have access to the pipeline.

" }, "BufferOptions":{"shape":"BufferOptions"}, "EncryptionAtRestOptions":{"shape":"EncryptionAtRestOptions"}, "ServiceVpcEndpoints":{ "shape":"ServiceVpcEndpointsList", "documentation":"

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

" }, "Tags":{ "shape":"TagList", "documentation":"

A list of tags associated with the given pipeline.

" } }, "documentation":"

Information about an existing OpenSearch Ingestion pipeline.

" }, "PipelineArn":{ "type":"string", "max":76, "min":46, "pattern":"^arn:(aws|aws\\-cn|aws\\-us\\-gov|aws\\-iso|aws\\-iso\\-b):osis:.+:pipeline\\/.+$" }, "PipelineBlueprint":{ "type":"structure", "members":{ "BlueprintName":{ "shape":"String", "documentation":"

The name of the blueprint.

" }, "PipelineConfigurationBody":{ "shape":"String", "documentation":"

The YAML configuration of the blueprint.

" } }, "documentation":"

Container for information about an OpenSearch Ingestion blueprint.

" }, "PipelineBlueprintSummary":{ "type":"structure", "members":{ "BlueprintName":{ "shape":"String", "documentation":"

The name of the blueprint.

" } }, "documentation":"

A summary of an OpenSearch Ingestion blueprint.

" }, "PipelineBlueprintsSummaryList":{ "type":"list", "member":{"shape":"PipelineBlueprintSummary"} }, "PipelineConfigurationBody":{ "type":"string", "max":24000, "min":1 }, "PipelineName":{ "type":"string", "max":28, "min":3, "pattern":"[a-z][a-z0-9\\-]+" }, "PipelineStatus":{ "type":"string", "enum":[ "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED" ] }, "PipelineStatusReason":{ "type":"structure", "members":{ "Description":{ "shape":"String", "documentation":"

A description of why a pipeline has a certain status.

" } }, "documentation":"

Information about a pipeline's current status.

" }, "PipelineSummary":{ "type":"structure", "members":{ "Status":{ "shape":"PipelineStatus", "documentation":"

The current status of the pipeline.

" }, "StatusReason":{"shape":"PipelineStatusReason"}, "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline.

" }, "PipelineArn":{ "shape":"PipelineArn", "documentation":"

The Amazon Resource Name (ARN) of the pipeline.

" }, "MinUnits":{ "shape":"PipelineUnits", "documentation":"

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

" }, "MaxUnits":{ "shape":"PipelineUnits", "documentation":"

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

" }, "CreatedAt":{ "shape":"Timestamp", "documentation":"

The date and time when the pipeline was created.

" }, "LastUpdatedAt":{ "shape":"Timestamp", "documentation":"

The date and time when the pipeline was last updated.

" }, "Tags":{ "shape":"TagList", "documentation":"

A list of tags associated with the given pipeline.

" } }, "documentation":"

Summary information for an OpenSearch Ingestion pipeline.

" }, "PipelineSummaryList":{ "type":"list", "member":{"shape":"PipelineSummary"} }, "PipelineUnits":{ "type":"integer", "min":1 }, "ResourceAlreadyExistsException":{ "type":"structure", "members":{ }, "documentation":"

You attempted to create a resource that already exists.

", "error":{"httpStatusCode":409}, "exception":true }, "ResourceNotFoundException":{ "type":"structure", "members":{ }, "documentation":"

You attempted to access or delete a resource that does not exist.

", "error":{"httpStatusCode":404}, "exception":true }, "SecurityGroupId":{ "type":"string", "max":20, "min":11, "pattern":"sg-\\w{8}(\\w{9})?" }, "SecurityGroupIds":{ "type":"list", "member":{"shape":"SecurityGroupId"}, "max":12, "min":1 }, "ServiceVpcEndpoint":{ "type":"structure", "members":{ "ServiceName":{ "shape":"VpcEndpointServiceName", "documentation":"

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

" }, "VpcEndpointId":{ "shape":"String", "documentation":"

The ID of the VPC endpoint that was created.

" } }, "documentation":"

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

" }, "ServiceVpcEndpointsList":{ "type":"list", "member":{"shape":"ServiceVpcEndpoint"} }, "StartPipelineRequest":{ "type":"structure", "required":["PipelineName"], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline to start.

", "location":"uri", "locationName":"PipelineName" } } }, "StartPipelineResponse":{ "type":"structure", "members":{ "Pipeline":{"shape":"Pipeline"} } }, "StopPipelineRequest":{ "type":"structure", "required":["PipelineName"], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline to stop.

", "location":"uri", "locationName":"PipelineName" } } }, "StopPipelineResponse":{ "type":"structure", "members":{ "Pipeline":{"shape":"Pipeline"} } }, "String":{"type":"string"}, "StringList":{ "type":"list", "member":{"shape":"String"} }, "SubnetId":{ "type":"string", "max":24, "min":15, "pattern":"subnet-\\w{8}(\\w{9})?" }, "SubnetIds":{ "type":"list", "member":{"shape":"SubnetId"}, "max":12, "min":1 }, "Tag":{ "type":"structure", "required":[ "Key", "Value" ], "members":{ "Key":{ "shape":"TagKey", "documentation":"

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

" }, "Value":{ "shape":"TagValue", "documentation":"

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

" } }, "documentation":"

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

" }, "TagKey":{ "type":"string", "max":128, "min":1, "pattern":".*" }, "TagList":{ "type":"list", "member":{"shape":"Tag"} }, "TagResourceRequest":{ "type":"structure", "required":[ "Arn", "Tags" ], "members":{ "Arn":{ "shape":"PipelineArn", "documentation":"

The Amazon Resource Name (ARN) of the pipeline to tag.

", "location":"querystring", "locationName":"arn" }, "Tags":{ "shape":"TagList", "documentation":"

The list of key-value tags to add to the pipeline.

" } } }, "TagResourceResponse":{ "type":"structure", "members":{ } }, "TagValue":{ "type":"string", "max":256, "min":0, "pattern":".*" }, "Timestamp":{"type":"timestamp"}, "UntagResourceRequest":{ "type":"structure", "required":[ "Arn", "TagKeys" ], "members":{ "Arn":{ "shape":"PipelineArn", "documentation":"

The Amazon Resource Name (ARN) of the pipeline to remove tags from.

", "location":"querystring", "locationName":"arn" }, "TagKeys":{ "shape":"StringList", "documentation":"

The tag keys to remove.

" } } }, "UntagResourceResponse":{ "type":"structure", "members":{ } }, "UpdatePipelineRequest":{ "type":"structure", "required":["PipelineName"], "members":{ "PipelineName":{ "shape":"PipelineName", "documentation":"

The name of the pipeline to update.

", "location":"uri", "locationName":"PipelineName" }, "MinUnits":{ "shape":"PipelineUnits", "documentation":"

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

" }, "MaxUnits":{ "shape":"PipelineUnits", "documentation":"

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

" }, "PipelineConfigurationBody":{ "shape":"PipelineConfigurationBody", "documentation":"

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":{ "shape":"LogPublishingOptions", "documentation":"

Key-value pairs to configure log publishing.

" }, "BufferOptions":{ "shape":"BufferOptions", "documentation":"

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

" }, "EncryptionAtRestOptions":{ "shape":"EncryptionAtRestOptions", "documentation":"

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

" } } }, "UpdatePipelineResponse":{ "type":"structure", "members":{ "Pipeline":{ "shape":"Pipeline", "documentation":"

Container for information about the updated pipeline.

" } } }, "ValidatePipelineRequest":{ "type":"structure", "required":["PipelineConfigurationBody"], "members":{ "PipelineConfigurationBody":{ "shape":"PipelineConfigurationBody", "documentation":"

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.

" } } }, "ValidatePipelineResponse":{ "type":"structure", "members":{ "isValid":{ "shape":"Boolean", "documentation":"

A boolean indicating whether or not the pipeline configuration is valid.

" }, "Errors":{ "shape":"ValidationMessageList", "documentation":"

A list of errors if the configuration is invalid.

" } } }, "ValidationException":{ "type":"structure", "members":{ }, "documentation":"

An exception for missing or invalid input fields.

", "error":{"httpStatusCode":400}, "exception":true }, "ValidationMessage":{ "type":"structure", "members":{ "Message":{ "shape":"String", "documentation":"

The validation message.

" } }, "documentation":"

A validation message associated with a ValidatePipeline request in OpenSearch Ingestion.

" }, "ValidationMessageList":{ "type":"list", "member":{"shape":"ValidationMessage"} }, "VpcEndpoint":{ "type":"structure", "members":{ "VpcEndpointId":{ "shape":"String", "documentation":"

The unique identifier of the endpoint.

" }, "VpcId":{ "shape":"String", "documentation":"

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

" }, "VpcOptions":{ "shape":"VpcOptions", "documentation":"

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

" } }, "documentation":"

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

" }, "VpcEndpointServiceName":{ "type":"string", "enum":["OPENSEARCH_SERVERLESS"] }, "VpcEndpointsList":{ "type":"list", "member":{"shape":"VpcEndpoint"} }, "VpcOptions":{ "type":"structure", "required":["SubnetIds"], "members":{ "SubnetIds":{ "shape":"SubnetIds", "documentation":"

A list of subnet IDs associated with the VPC endpoint.

" }, "SecurityGroupIds":{ "shape":"SecurityGroupIds", "documentation":"

A list of security groups associated with the VPC endpoint.

" } }, "documentation":"

Options that specify the subnets and security groups for an OpenSearch Ingestion VPC endpoint.

" } }, "documentation":"

Use the Amazon OpenSearch Ingestion API to create and manage ingestion pipelines. OpenSearch Ingestion is a fully managed data collector that delivers real-time log and trace data to OpenSearch Service domains. For more information, see Getting data into your cluster using OpenSearch Ingestion.

" }