{ "version":"2.0", "metadata":{ "apiVersion":"2022-01-01", "endpointPrefix":"osis", "protocol":"rest-json", "protocols":["rest-json"], "serviceFullName":"Amazon OpenSearch Ingestion", "serviceId":"OSIS", "signatureVersion":"v4", "uid":"osis-2022-01-01", "auth":["aws.auth#sigv4"] }, "operations":{ "CreatePipeline":{ "name":"CreatePipeline", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/createPipeline" }, "input":{"shape":"CreatePipelineRequest"}, "output":{"shape":"CreatePipelineResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"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.
" }, "CreatePipelineEndpoint":{ "name":"CreatePipelineEndpoint", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/createPipelineEndpoint" }, "input":{"shape":"CreatePipelineEndpointRequest"}, "output":{"shape":"CreatePipelineEndpointResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"Creates a VPC endpoint for an OpenSearch Ingestion pipeline. Pipeline endpoints allow you to ingest data from your VPC into pipelines that you have access to.
" }, "DeletePipeline":{ "name":"DeletePipeline", "http":{ "method":"DELETE", "requestUri":"/2022-01-01/osis/deletePipeline/{PipelineName}" }, "input":{"shape":"DeletePipelineRequest"}, "output":{"shape":"DeletePipelineResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"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.
" }, "DeletePipelineEndpoint":{ "name":"DeletePipelineEndpoint", "http":{ "method":"DELETE", "requestUri":"/2022-01-01/osis/deletePipelineEndpoint/{EndpointId}" }, "input":{"shape":"DeletePipelineEndpointRequest"}, "output":{"shape":"DeletePipelineEndpointResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"Deletes a VPC endpoint for an OpenSearch Ingestion pipeline.
", "idempotent":true }, "DeleteResourcePolicy":{ "name":"DeleteResourcePolicy", "http":{ "method":"DELETE", "requestUri":"/2022-01-01/osis/resourcePolicy/{ResourceArn}" }, "input":{"shape":"DeleteResourcePolicyRequest"}, "output":{"shape":"DeleteResourcePolicyResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"Deletes a resource-based policy from an OpenSearch Ingestion resource.
", "idempotent":true }, "GetPipeline":{ "name":"GetPipeline", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/getPipeline/{PipelineName}" }, "input":{"shape":"GetPipelineRequest"}, "output":{"shape":"GetPipelineResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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.
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.
" }, "GetResourcePolicy":{ "name":"GetResourcePolicy", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/resourcePolicy/{ResourceArn}" }, "input":{"shape":"GetResourcePolicyRequest"}, "output":{"shape":"GetResourcePolicyResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"Retrieves the resource-based policy attached to an OpenSearch Ingestion resource.
" }, "ListPipelineBlueprints":{ "name":"ListPipelineBlueprints", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/listPipelineBlueprints" }, "input":{"shape":"ListPipelineBlueprintsRequest"}, "output":{"shape":"ListPipelineBlueprintsResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"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.
" }, "ListPipelineEndpointConnections":{ "name":"ListPipelineEndpointConnections", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/listPipelineEndpointConnections" }, "input":{"shape":"ListPipelineEndpointConnectionsRequest"}, "output":{"shape":"ListPipelineEndpointConnectionsResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"Lists the pipeline endpoints connected to pipelines in your account.
" }, "ListPipelineEndpoints":{ "name":"ListPipelineEndpoints", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/listPipelineEndpoints" }, "input":{"shape":"ListPipelineEndpointsRequest"}, "output":{"shape":"ListPipelineEndpointsResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"Lists all pipeline endpoints in your account.
" }, "ListPipelines":{ "name":"ListPipelines", "http":{ "method":"GET", "requestUri":"/2022-01-01/osis/listPipelines" }, "input":{"shape":"ListPipelinesRequest"}, "output":{"shape":"ListPipelinesResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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.
" }, "PutResourcePolicy":{ "name":"PutResourcePolicy", "http":{ "method":"PUT", "requestUri":"/2022-01-01/osis/resourcePolicy/{ResourceArn}" }, "input":{"shape":"PutResourcePolicyRequest"}, "output":{"shape":"PutResourcePolicyResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"} ], "documentation":"Attaches a resource-based policy to an OpenSearch Ingestion resource. Resource-based policies grant permissions to principals to perform actions on the resource.
", "idempotent":true }, "RevokePipelineEndpointConnections":{ "name":"RevokePipelineEndpointConnections", "http":{ "method":"POST", "requestUri":"/2022-01-01/osis/revokePipelineEndpointConnections" }, "input":{"shape":"RevokePipelineEndpointConnectionsRequest"}, "output":{"shape":"RevokePipelineEndpointConnectionsResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"shape":"LimitExceededException"}, {"shape":"ValidationException"}, {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"Revokes pipeline endpoints from specified endpoint IDs.
", "idempotent":true }, "StartPipeline":{ "name":"StartPipeline", "http":{ "method":"PUT", "requestUri":"/2022-01-01/osis/startPipeline/{PipelineName}" }, "input":{"shape":"StartPipelineRequest"}, "output":{"shape":"StartPipelineResponse"}, "errors":[ {"shape":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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":"DisabledOperationException"}, {"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 }, "AwsAccountId":{ "type":"string", "max":12, "min":12, "pattern":"^\\\\d{12}$" }, "BlueprintFormat":{ "type":"string", "pattern":"(YAML|JSON)" }, "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. For more information, see Persistent buffering.
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" ] }, "CidrBlock":{ "type":"string", "pattern":"^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)/24$" }, "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/vendedlogs/OpenSearchService/pipelines.
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 }, "CreatePipelineEndpointRequest":{ "type":"structure", "required":[ "PipelineArn", "VpcOptions" ], "members":{ "PipelineArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the pipeline to create the endpoint for.
" }, "VpcOptions":{ "shape":"PipelineEndpointVpcOptions", "documentation":"Container for the VPC configuration for the pipeline endpoint, including subnet IDs and security group IDs.
" } } }, "CreatePipelineEndpointResponse":{ "type":"structure", "members":{ "PipelineArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the pipeline associated with the endpoint.
" }, "EndpointId":{ "shape":"PipelineEndpointId", "documentation":"The unique identifier of the pipeline endpoint.
" }, "Status":{ "shape":"PipelineEndpointStatus", "documentation":"The current status of the pipeline endpoint.
" }, "VpcId":{ "shape":"String", "documentation":"The ID of the VPC where the pipeline endpoint was created.
" } } }, "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.
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.
" }, "PipelineRoleArn":{ "shape":"PipelineRoleArn", "documentation":"The Amazon Resource Name (ARN) of the IAM role that grants the pipeline permission to access Amazon Web Services resources.
" } } }, "CreatePipelineResponse":{ "type":"structure", "members":{ "Pipeline":{ "shape":"Pipeline", "documentation":"Container for information about the created pipeline.
" } } }, "DeletePipelineEndpointRequest":{ "type":"structure", "required":["EndpointId"], "members":{ "EndpointId":{ "shape":"PipelineEndpointId", "documentation":"The unique identifier of the pipeline endpoint to delete.
", "location":"uri", "locationName":"EndpointId" } } }, "DeletePipelineEndpointResponse":{ "type":"structure", "members":{} }, "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":{} }, "DeleteResourcePolicyRequest":{ "type":"structure", "required":["ResourceArn"], "members":{ "ResourceArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the resource from which to delete the policy.
", "location":"uri", "locationName":"ResourceArn" } } }, "DeleteResourcePolicyResponse":{ "type":"structure", "members":{} }, "DisabledOperationException":{ "type":"structure", "members":{}, "documentation":"Exception is thrown when an operation has been disabled.
", "error":{"httpStatusCode":409}, "exception":true }, "EncryptionAtRestOptions":{ "type":"structure", "required":["KmsKeyArn"], "members":{ "KmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"The ARN of the KMS key used to encrypt buffer data. By default, data is encrypted using an Amazon Web Services owned key.
" } }, "documentation":"Options to control how OpenSearch encrypts buffer data.
" }, "GetPipelineBlueprintRequest":{ "type":"structure", "required":["BlueprintName"], "members":{ "BlueprintName":{ "shape":"String", "documentation":"The name of the blueprint to retrieve.
", "location":"uri", "locationName":"BlueprintName" }, "Format":{ "shape":"BlueprintFormat", "documentation":"The format format of the blueprint to retrieve.
", "location":"querystring", "locationName":"format" } } }, "GetPipelineBlueprintResponse":{ "type":"structure", "members":{ "Blueprint":{ "shape":"PipelineBlueprint", "documentation":"The requested blueprint in YAML format.
" }, "Format":{ "shape":"String", "documentation":"The format of the blueprint.
" } } }, "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.
", "location":"uri", "locationName":"PipelineName" } } }, "GetPipelineResponse":{ "type":"structure", "members":{ "Pipeline":{ "shape":"Pipeline", "documentation":"Detailed information about the requested pipeline.
" } } }, "GetResourcePolicyRequest":{ "type":"structure", "required":["ResourceArn"], "members":{ "ResourceArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the resource for which to retrieve the policy.
", "location":"uri", "locationName":"ResourceArn" } } }, "GetResourcePolicyResponse":{ "type":"structure", "members":{ "ResourceArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the resource.
" }, "Policy":{ "shape":"ResourcePolicy", "documentation":"The resource-based policy document in JSON format.
" } } }, "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.
" } } }, "ListPipelineEndpointConnectionsRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"MaxResults", "documentation":"The maximum number of pipeline endpoint connections to return in the response.
", "location":"querystring", "locationName":"maxResults" }, "NextToken":{ "shape":"NextToken", "documentation":"If your initial ListPipelineEndpointConnections operation returns a nextToken, you can include the returned nextToken in subsequent ListPipelineEndpointConnections operations, which returns results in the next page.
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.
A list of pipeline endpoint connections.
" } } }, "ListPipelineEndpointsRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"MaxResults", "documentation":"The maximum number of pipeline endpoints to return in the response.
", "location":"querystring", "locationName":"maxResults" }, "NextToken":{ "shape":"NextToken", "documentation":"If your initial ListPipelineEndpoints operation returns a NextToken, you can include the returned NextToken in subsequent ListPipelineEndpoints operations, which returns results in the next page.
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.
A list of pipeline endpoints.
" } } }, "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.
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.
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.
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.
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"}, "VpcEndpointService":{ "shape":"String", "documentation":"The VPC endpoint service name for the pipeline.
" }, "ServiceVpcEndpoints":{ "shape":"ServiceVpcEndpointsList", "documentation":"A list of VPC endpoints that OpenSearch Ingestion has created to other Amazon Web Services services.
" }, "Destinations":{ "shape":"PipelineDestinationList", "documentation":"Destinations to which the pipeline writes data.
" }, "Tags":{ "shape":"TagList", "documentation":"A list of tags associated with the given pipeline.
" }, "PipelineRoleArn":{ "shape":"PipelineRoleArn", "documentation":"The Amazon Resource Name (ARN) of the IAM role that the pipeline uses to access AWS resources.
" } }, "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.
" }, "DisplayName":{ "shape":"String", "documentation":"The display name of the blueprint.
" }, "DisplayDescription":{ "shape":"String", "documentation":"A description of the blueprint.
" }, "Service":{ "shape":"String", "documentation":"The name of the service that the blueprint is associated with.
" }, "UseCase":{ "shape":"String", "documentation":"The use case that the blueprint relates to.
" } }, "documentation":"Container for information about an OpenSearch Ingestion blueprint.
" }, "PipelineBlueprintSummary":{ "type":"structure", "members":{ "BlueprintName":{ "shape":"String", "documentation":"The name of the blueprint.
" }, "DisplayName":{ "shape":"String", "documentation":"The display name of the blueprint.
" }, "DisplayDescription":{ "shape":"String", "documentation":"A description of the blueprint.
" }, "Service":{ "shape":"String", "documentation":"The name of the service that the blueprint is associated with.
" }, "UseCase":{ "shape":"String", "documentation":"The use case that the blueprint relates to.
" } }, "documentation":"A summary of an OpenSearch Ingestion blueprint.
" }, "PipelineBlueprintsSummaryList":{ "type":"list", "member":{"shape":"PipelineBlueprintSummary"} }, "PipelineConfigurationBody":{ "type":"string", "max":100000, "min":1 }, "PipelineDestination":{ "type":"structure", "members":{ "ServiceName":{ "shape":"String", "documentation":"The name of the service receiving data from the pipeline.
" }, "Endpoint":{ "shape":"String", "documentation":"The endpoint receiving data from the pipeline.
" } }, "documentation":"An object representing the destination of a pipeline.
" }, "PipelineDestinationList":{ "type":"list", "member":{"shape":"PipelineDestination"} }, "PipelineEndpoint":{ "type":"structure", "members":{ "PipelineArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the pipeline associated with this endpoint.
" }, "EndpointId":{ "shape":"PipelineEndpointId", "documentation":"The unique identifier for the pipeline endpoint.
" }, "Status":{ "shape":"PipelineEndpointStatus", "documentation":"The current status of the pipeline endpoint.
" }, "VpcId":{ "shape":"String", "documentation":"The ID of the VPC where the pipeline endpoint is created.
" }, "VpcOptions":{ "shape":"PipelineEndpointVpcOptions", "documentation":"Configuration options for the VPC endpoint, including subnet and security group settings.
" }, "IngestEndpointUrl":{ "shape":"String", "documentation":"The URL used to ingest data to the pipeline through the VPC endpoint.
" } }, "documentation":"Represents a VPC endpoint for an OpenSearch Ingestion pipeline, enabling private connectivity between your VPC and the pipeline.
" }, "PipelineEndpointConnection":{ "type":"structure", "members":{ "PipelineArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the pipeline in the endpoint connection.
" }, "EndpointId":{ "shape":"PipelineEndpointId", "documentation":"The unique identifier of the endpoint in the connection.
" }, "Status":{ "shape":"PipelineEndpointStatus", "documentation":"The current status of the pipeline endpoint connection.
" }, "VpcEndpointOwner":{ "shape":"AwsAccountId", "documentation":"The Amazon Web Services account ID that owns the VPC endpoint used in this connection.
" } }, "documentation":"Represents a connection to a pipeline endpoint, containing details about the endpoint association.
" }, "PipelineEndpointConnectionsSummaryList":{ "type":"list", "member":{"shape":"PipelineEndpointConnection"} }, "PipelineEndpointId":{ "type":"string", "max":512, "min":3, "pattern":"^[a-zA-Z0-9][a-zA-Z0-9-_]+$" }, "PipelineEndpointIdsList":{ "type":"list", "member":{"shape":"PipelineEndpointId"} }, "PipelineEndpointStatus":{ "type":"string", "enum":[ "CREATING", "ACTIVE", "CREATE_FAILED", "DELETING", "REVOKING", "REVOKED" ] }, "PipelineEndpointVpcOptions":{ "type":"structure", "members":{ "SubnetIds":{ "shape":"SubnetIds", "documentation":"A list of subnet IDs where the pipeline endpoint network interfaces are created.
" }, "SecurityGroupIds":{ "shape":"SecurityGroupIds", "documentation":"A list of security group IDs that control network access to the pipeline endpoint.
" } }, "documentation":"Configuration settings for the VPC endpoint, specifying network access controls.
" }, "PipelineEndpointsSummaryList":{ "type":"list", "member":{"shape":"PipelineEndpoint"} }, "PipelineName":{ "type":"string", "max":28, "min":3, "pattern":"[a-z][a-z0-9\\-]+" }, "PipelineRoleArn":{ "type":"string", "max":2048, "min":20, "pattern":"^arn:(aws|aws\\-cn|aws\\-us\\-gov|aws\\-iso|aws\\-iso\\-b|aws\\-iso\\-e|aws\\-iso\\-f):iam::[0-9]+:role\\/.*$" }, "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.
" }, "Destinations":{ "shape":"PipelineDestinationList", "documentation":"A list of destinations to which the pipeline writes data.
" }, "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 }, "PutResourcePolicyRequest":{ "type":"structure", "required":[ "ResourceArn", "Policy" ], "members":{ "ResourceArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the resource to attach the policy to.
", "location":"uri", "locationName":"ResourceArn" }, "Policy":{ "shape":"ResourcePolicy", "documentation":"The resource-based policy document in JSON format.
" } } }, "PutResourcePolicyResponse":{ "type":"structure", "members":{ "ResourceArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the resource.
" }, "Policy":{ "shape":"ResourcePolicy", "documentation":"The resource-based policy document that was attached to the resource.
" } } }, "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 }, "ResourcePolicy":{ "type":"string", "max":204800, "min":2 }, "RevokePipelineEndpointConnectionsRequest":{ "type":"structure", "required":[ "PipelineArn", "EndpointIds" ], "members":{ "PipelineArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the pipeline from which to revoke endpoint connections.
" }, "EndpointIds":{ "shape":"PipelineEndpointIdsList", "documentation":"A list of endpoint IDs for which to revoke access to the pipeline.
" } } }, "RevokePipelineEndpointConnectionsResponse":{ "type":"structure", "members":{ "PipelineArn":{ "shape":"PipelineArn", "documentation":"The Amazon Resource Name (ARN) of the pipeline from which endpoint connections were revoked.
" } } }, "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 unique identifier 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
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.
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.
" }, "PipelineRoleArn":{ "shape":"PipelineRoleArn", "documentation":"The Amazon Resource Name (ARN) of the IAM role that grants the pipeline permission to access Amazon Web Services resources.
" } } }, "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.
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.
Whether a VPC is attached to the pipeline.
" }, "CidrBlock":{ "shape":"CidrBlock", "documentation":"The CIDR block to be reserved for OpenSearch Ingestion to create elastic network interfaces (ENIs).
" } }, "documentation":"Options for attaching a VPC to pipeline.
" }, "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.
" }, "VpcEndpointManagement":{ "type":"string", "enum":[ "CUSTOMER", "SERVICE" ] }, "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.
" }, "VpcAttachmentOptions":{ "shape":"VpcAttachmentOptions", "documentation":"Options for attaching a VPC to a pipeline.
" }, "VpcEndpointManagement":{ "shape":"VpcEndpointManagement", "documentation":"Defines whether you or Amazon OpenSearch Ingestion service create and manage the VPC endpoint configured for the pipeline.
" } }, "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.
" }