1{ 2 "version":"2.0", 3 "metadata":{ 4 "apiVersion":"2022-01-01", 5 "endpointPrefix":"osis", 6 "protocol":"rest-json", 7 "serviceFullName":"Amazon OpenSearch Ingestion", 8 "serviceId":"OSIS", 9 "signatureVersion":"v4", 10 "uid":"osis-2022-01-01" 11 }, 12 "operations":{ 13 "CreatePipeline":{ 14 "name":"CreatePipeline", 15 "http":{ 16 "method":"POST", 17 "requestUri":"/2022-01-01/osis/createPipeline" 18 }, 19 "input":{"shape":"CreatePipelineRequest"}, 20 "output":{"shape":"CreatePipelineResponse"}, 21 "errors":[ 22 {"shape":"LimitExceededException"}, 23 {"shape":"ValidationException"}, 24 {"shape":"InternalException"}, 25 {"shape":"AccessDeniedException"}, 26 {"shape":"ResourceAlreadyExistsException"}, 27 {"shape":"ResourceNotFoundException"} 28 ], 29 "documentation":"<p>Creates an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/creating-pipeline.html\">Creating Amazon OpenSearch Ingestion pipelines</a>.</p>" 30 }, 31 "DeletePipeline":{ 32 "name":"DeletePipeline", 33 "http":{ 34 "method":"DELETE", 35 "requestUri":"/2022-01-01/osis/deletePipeline/{PipelineName}" 36 }, 37 "input":{"shape":"DeletePipelineRequest"}, 38 "output":{"shape":"DeletePipelineResponse"}, 39 "errors":[ 40 {"shape":"ValidationException"}, 41 {"shape":"InternalException"}, 42 {"shape":"AccessDeniedException"}, 43 {"shape":"ResourceNotFoundException"}, 44 {"shape":"ConflictException"} 45 ], 46 "documentation":"<p>Deletes an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/delete-pipeline.html\">Deleting Amazon OpenSearch Ingestion pipelines</a>.</p>" 47 }, 48 "GetPipeline":{ 49 "name":"GetPipeline", 50 "http":{ 51 "method":"GET", 52 "requestUri":"/2022-01-01/osis/getPipeline/{PipelineName}" 53 }, 54 "input":{"shape":"GetPipelineRequest"}, 55 "output":{"shape":"GetPipelineResponse"}, 56 "errors":[ 57 {"shape":"ValidationException"}, 58 {"shape":"InternalException"}, 59 {"shape":"AccessDeniedException"}, 60 {"shape":"ResourceNotFoundException"} 61 ], 62 "documentation":"<p>Retrieves information about an OpenSearch Ingestion pipeline.</p>" 63 }, 64 "GetPipelineBlueprint":{ 65 "name":"GetPipelineBlueprint", 66 "http":{ 67 "method":"GET", 68 "requestUri":"/2022-01-01/osis/getPipelineBlueprint/{BlueprintName}" 69 }, 70 "input":{"shape":"GetPipelineBlueprintRequest"}, 71 "output":{"shape":"GetPipelineBlueprintResponse"}, 72 "errors":[ 73 {"shape":"AccessDeniedException"}, 74 {"shape":"InternalException"}, 75 {"shape":"ValidationException"}, 76 {"shape":"ResourceNotFoundException"} 77 ], 78 "documentation":"<p>Retrieves information about a specific blueprint for OpenSearch Ingestion. Blueprints are templates for the configuration needed for a <code>CreatePipeline</code> request. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/creating-pipeline.html#pipeline-blueprint\">Using blueprints to create a pipeline</a>.</p>" 79 }, 80 "GetPipelineChangeProgress":{ 81 "name":"GetPipelineChangeProgress", 82 "http":{ 83 "method":"GET", 84 "requestUri":"/2022-01-01/osis/getPipelineChangeProgress/{PipelineName}" 85 }, 86 "input":{"shape":"GetPipelineChangeProgressRequest"}, 87 "output":{"shape":"GetPipelineChangeProgressResponse"}, 88 "errors":[ 89 {"shape":"ValidationException"}, 90 {"shape":"InternalException"}, 91 {"shape":"AccessDeniedException"}, 92 {"shape":"ResourceNotFoundException"} 93 ], 94 "documentation":"<p>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.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/creating-pipeline.html#get-pipeline-progress\">Tracking the status of pipeline creation</a>.</p>" 95 }, 96 "ListPipelineBlueprints":{ 97 "name":"ListPipelineBlueprints", 98 "http":{ 99 "method":"POST", 100 "requestUri":"/2022-01-01/osis/listPipelineBlueprints" 101 }, 102 "input":{"shape":"ListPipelineBlueprintsRequest"}, 103 "output":{"shape":"ListPipelineBlueprintsResponse"}, 104 "errors":[ 105 {"shape":"ValidationException"}, 106 {"shape":"InternalException"}, 107 {"shape":"AccessDeniedException"}, 108 {"shape":"InvalidPaginationTokenException"} 109 ], 110 "documentation":"<p>Retrieves a list of all available blueprints for Data Prepper. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/creating-pipeline.html#pipeline-blueprint\">Using blueprints to create a pipeline</a>.</p>" 111 }, 112 "ListPipelines":{ 113 "name":"ListPipelines", 114 "http":{ 115 "method":"GET", 116 "requestUri":"/2022-01-01/osis/listPipelines" 117 }, 118 "input":{"shape":"ListPipelinesRequest"}, 119 "output":{"shape":"ListPipelinesResponse"}, 120 "errors":[ 121 {"shape":"ValidationException"}, 122 {"shape":"InternalException"}, 123 {"shape":"AccessDeniedException"}, 124 {"shape":"InvalidPaginationTokenException"} 125 ], 126 "documentation":"<p>Lists all OpenSearch Ingestion pipelines in the current Amazon Web Services account and Region. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/list-pipeline.html\">Viewing Amazon OpenSearch Ingestion pipelines</a>.</p>" 127 }, 128 "ListTagsForResource":{ 129 "name":"ListTagsForResource", 130 "http":{ 131 "method":"GET", 132 "requestUri":"/2022-01-01/osis/listTagsForResource/" 133 }, 134 "input":{"shape":"ListTagsForResourceRequest"}, 135 "output":{"shape":"ListTagsForResourceResponse"}, 136 "errors":[ 137 {"shape":"ValidationException"}, 138 {"shape":"ResourceNotFoundException"}, 139 {"shape":"InternalException"}, 140 {"shape":"AccessDeniedException"} 141 ], 142 "documentation":"<p>Lists all resource tags associated with an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/tag-pipeline.html\">Tagging Amazon OpenSearch Ingestion pipelines</a>.</p>" 143 }, 144 "StartPipeline":{ 145 "name":"StartPipeline", 146 "http":{ 147 "method":"PUT", 148 "requestUri":"/2022-01-01/osis/startPipeline/{PipelineName}" 149 }, 150 "input":{"shape":"StartPipelineRequest"}, 151 "output":{"shape":"StartPipelineResponse"}, 152 "errors":[ 153 {"shape":"AccessDeniedException"}, 154 {"shape":"ConflictException"}, 155 {"shape":"InternalException"}, 156 {"shape":"ResourceNotFoundException"}, 157 {"shape":"ValidationException"} 158 ], 159 "documentation":"<p>Starts an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/pipeline--stop-start.html#pipeline--start\">Starting an OpenSearch Ingestion pipeline</a>.</p>" 160 }, 161 "StopPipeline":{ 162 "name":"StopPipeline", 163 "http":{ 164 "method":"PUT", 165 "requestUri":"/2022-01-01/osis/stopPipeline/{PipelineName}" 166 }, 167 "input":{"shape":"StopPipelineRequest"}, 168 "output":{"shape":"StopPipelineResponse"}, 169 "errors":[ 170 {"shape":"AccessDeniedException"}, 171 {"shape":"ConflictException"}, 172 {"shape":"InternalException"}, 173 {"shape":"ResourceNotFoundException"}, 174 {"shape":"ValidationException"} 175 ], 176 "documentation":"<p>Stops an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/pipeline--stop-start.html#pipeline--stop\">Stopping an OpenSearch Ingestion pipeline</a>.</p>" 177 }, 178 "TagResource":{ 179 "name":"TagResource", 180 "http":{ 181 "method":"POST", 182 "requestUri":"/2022-01-01/osis/tagResource/" 183 }, 184 "input":{"shape":"TagResourceRequest"}, 185 "output":{"shape":"TagResourceResponse"}, 186 "errors":[ 187 {"shape":"LimitExceededException"}, 188 {"shape":"ValidationException"}, 189 {"shape":"InternalException"}, 190 {"shape":"AccessDeniedException"}, 191 {"shape":"ResourceNotFoundException"} 192 ], 193 "documentation":"<p>Tags an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/tag-pipeline.html\">Tagging Amazon OpenSearch Ingestion pipelines</a>.</p>" 194 }, 195 "UntagResource":{ 196 "name":"UntagResource", 197 "http":{ 198 "method":"POST", 199 "requestUri":"/2022-01-01/osis/untagResource/" 200 }, 201 "input":{"shape":"UntagResourceRequest"}, 202 "output":{"shape":"UntagResourceResponse"}, 203 "errors":[ 204 {"shape":"ValidationException"}, 205 {"shape":"ResourceNotFoundException"}, 206 {"shape":"InternalException"}, 207 {"shape":"AccessDeniedException"} 208 ], 209 "documentation":"<p>Removes one or more tags from an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/tag-pipeline.html\">Tagging Amazon OpenSearch Ingestion pipelines</a>.</p>" 210 }, 211 "UpdatePipeline":{ 212 "name":"UpdatePipeline", 213 "http":{ 214 "method":"PUT", 215 "requestUri":"/2022-01-01/osis/updatePipeline/{PipelineName}" 216 }, 217 "input":{"shape":"UpdatePipelineRequest"}, 218 "output":{"shape":"UpdatePipelineResponse"}, 219 "errors":[ 220 {"shape":"ValidationException"}, 221 {"shape":"InternalException"}, 222 {"shape":"AccessDeniedException"}, 223 {"shape":"ResourceNotFoundException"}, 224 {"shape":"ConflictException"} 225 ], 226 "documentation":"<p>Updates an OpenSearch Ingestion pipeline. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/update-pipeline.html\">Updating Amazon OpenSearch Ingestion pipelines</a>.</p>" 227 }, 228 "ValidatePipeline":{ 229 "name":"ValidatePipeline", 230 "http":{ 231 "method":"POST", 232 "requestUri":"/2022-01-01/osis/validatePipeline" 233 }, 234 "input":{"shape":"ValidatePipelineRequest"}, 235 "output":{"shape":"ValidatePipelineResponse"}, 236 "errors":[ 237 {"shape":"AccessDeniedException"}, 238 {"shape":"InternalException"}, 239 {"shape":"ValidationException"} 240 ], 241 "documentation":"<p>Checks whether an OpenSearch Ingestion pipeline configuration is valid prior to creation. For more information, see <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/creating-pipeline.html\">Creating Amazon OpenSearch Ingestion pipelines</a>.</p>" 242 } 243 }, 244 "shapes":{ 245 "AccessDeniedException":{ 246 "type":"structure", 247 "members":{ 248 }, 249 "documentation":"<p>You don't have permissions to access the resource.</p>", 250 "error":{"httpStatusCode":403}, 251 "exception":true 252 }, 253 "Boolean":{"type":"boolean"}, 254 "BufferOptions":{ 255 "type":"structure", 256 "required":["PersistentBufferEnabled"], 257 "members":{ 258 "PersistentBufferEnabled":{ 259 "shape":"Boolean", 260 "documentation":"<p>Whether persistent buffering should be enabled.</p>" 261 } 262 }, 263 "documentation":"<p>Options that specify the configuration of a persistent buffer. To configure how OpenSearch Ingestion encrypts this data, set the EncryptionAtRestOptions.</p>" 264 }, 265 "ChangeProgressStage":{ 266 "type":"structure", 267 "members":{ 268 "Name":{ 269 "shape":"String", 270 "documentation":"<p>The name of the stage.</p>" 271 }, 272 "Status":{ 273 "shape":"ChangeProgressStageStatuses", 274 "documentation":"<p>The current status of the stage that the change is in.</p>" 275 }, 276 "Description":{ 277 "shape":"String", 278 "documentation":"<p>A description of the stage.</p>" 279 }, 280 "LastUpdatedAt":{ 281 "shape":"Timestamp", 282 "documentation":"<p>The most recent updated timestamp of the stage.</p>" 283 } 284 }, 285 "documentation":"<p>Progress details for a specific stage of a pipeline configuration change.</p>" 286 }, 287 "ChangeProgressStageList":{ 288 "type":"list", 289 "member":{"shape":"ChangeProgressStage"} 290 }, 291 "ChangeProgressStageStatuses":{ 292 "type":"string", 293 "enum":[ 294 "PENDING", 295 "IN_PROGRESS", 296 "COMPLETED", 297 "FAILED" 298 ] 299 }, 300 "ChangeProgressStatus":{ 301 "type":"structure", 302 "members":{ 303 "StartTime":{ 304 "shape":"Timestamp", 305 "documentation":"<p>The time at which the configuration change is made on the pipeline.</p>" 306 }, 307 "Status":{ 308 "shape":"ChangeProgressStatuses", 309 "documentation":"<p>The overall status of the pipeline configuration change.</p>" 310 }, 311 "TotalNumberOfStages":{ 312 "shape":"Integer", 313 "documentation":"<p>The total number of stages required for the pipeline configuration change.</p>" 314 }, 315 "ChangeProgressStages":{ 316 "shape":"ChangeProgressStageList", 317 "documentation":"<p>Information about the stages that the pipeline is going through to perform the configuration change.</p>" 318 } 319 }, 320 "documentation":"<p>The progress details of a pipeline configuration change.</p>" 321 }, 322 "ChangeProgressStatusList":{ 323 "type":"list", 324 "member":{"shape":"ChangeProgressStatus"} 325 }, 326 "ChangeProgressStatuses":{ 327 "type":"string", 328 "enum":[ 329 "PENDING", 330 "IN_PROGRESS", 331 "COMPLETED", 332 "FAILED" 333 ] 334 }, 335 "CloudWatchLogDestination":{ 336 "type":"structure", 337 "required":["LogGroup"], 338 "members":{ 339 "LogGroup":{ 340 "shape":"LogGroup", 341 "documentation":"<p>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, <code>/aws/OpenSearchService/IngestionService/my-pipeline</code>.</p>" 342 } 343 }, 344 "documentation":"<p>The destination for OpenSearch Ingestion logs sent to Amazon CloudWatch.</p>" 345 }, 346 "ConflictException":{ 347 "type":"structure", 348 "members":{ 349 }, 350 "documentation":"<p>The client attempted to remove a resource that is currently in use.</p>", 351 "error":{"httpStatusCode":409}, 352 "exception":true 353 }, 354 "CreatePipelineRequest":{ 355 "type":"structure", 356 "required":[ 357 "PipelineName", 358 "MinUnits", 359 "MaxUnits", 360 "PipelineConfigurationBody" 361 ], 362 "members":{ 363 "PipelineName":{ 364 "shape":"PipelineName", 365 "documentation":"<p>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.</p>" 366 }, 367 "MinUnits":{ 368 "shape":"PipelineUnits", 369 "documentation":"<p>The minimum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 370 }, 371 "MaxUnits":{ 372 "shape":"PipelineUnits", 373 "documentation":"<p>The maximum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 374 }, 375 "PipelineConfigurationBody":{ 376 "shape":"PipelineConfigurationBody", 377 "documentation":"<p>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 <code>\\n</code>.</p>" 378 }, 379 "LogPublishingOptions":{ 380 "shape":"LogPublishingOptions", 381 "documentation":"<p>Key-value pairs to configure log publishing.</p>" 382 }, 383 "VpcOptions":{ 384 "shape":"VpcOptions", 385 "documentation":"<p>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.</p>" 386 }, 387 "BufferOptions":{ 388 "shape":"BufferOptions", 389 "documentation":"<p>Key-value pairs to configure persistent buffering for the pipeline.</p>" 390 }, 391 "EncryptionAtRestOptions":{ 392 "shape":"EncryptionAtRestOptions", 393 "documentation":"<p>Key-value pairs to configure encryption for data that is written to a persistent buffer.</p>" 394 }, 395 "Tags":{ 396 "shape":"TagList", 397 "documentation":"<p>List of tags to add to the pipeline upon creation.</p>" 398 } 399 } 400 }, 401 "CreatePipelineResponse":{ 402 "type":"structure", 403 "members":{ 404 "Pipeline":{ 405 "shape":"Pipeline", 406 "documentation":"<p>Container for information about the created pipeline.</p>" 407 } 408 } 409 }, 410 "DeletePipelineRequest":{ 411 "type":"structure", 412 "required":["PipelineName"], 413 "members":{ 414 "PipelineName":{ 415 "shape":"PipelineName", 416 "documentation":"<p>The name of the pipeline to delete.</p>", 417 "location":"uri", 418 "locationName":"PipelineName" 419 } 420 } 421 }, 422 "DeletePipelineResponse":{ 423 "type":"structure", 424 "members":{ 425 } 426 }, 427 "EncryptionAtRestOptions":{ 428 "type":"structure", 429 "required":["KmsKeyArn"], 430 "members":{ 431 "KmsKeyArn":{ 432 "shape":"KmsKeyArn", 433 "documentation":"<p>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.</p>" 434 } 435 }, 436 "documentation":"<p>Options to control how OpenSearch encrypts all data-at-rest.</p>" 437 }, 438 "GetPipelineBlueprintRequest":{ 439 "type":"structure", 440 "required":["BlueprintName"], 441 "members":{ 442 "BlueprintName":{ 443 "shape":"String", 444 "documentation":"<p>The name of the blueprint to retrieve.</p>", 445 "location":"uri", 446 "locationName":"BlueprintName" 447 } 448 } 449 }, 450 "GetPipelineBlueprintResponse":{ 451 "type":"structure", 452 "members":{ 453 "Blueprint":{ 454 "shape":"PipelineBlueprint", 455 "documentation":"<p>The requested blueprint in YAML format.</p>" 456 } 457 } 458 }, 459 "GetPipelineChangeProgressRequest":{ 460 "type":"structure", 461 "required":["PipelineName"], 462 "members":{ 463 "PipelineName":{ 464 "shape":"PipelineName", 465 "documentation":"<p>The name of the pipeline.</p>", 466 "location":"uri", 467 "locationName":"PipelineName" 468 } 469 } 470 }, 471 "GetPipelineChangeProgressResponse":{ 472 "type":"structure", 473 "members":{ 474 "ChangeProgressStatuses":{ 475 "shape":"ChangeProgressStatusList", 476 "documentation":"<p>The current status of the change happening on the pipeline.</p>" 477 } 478 } 479 }, 480 "GetPipelineRequest":{ 481 "type":"structure", 482 "required":["PipelineName"], 483 "members":{ 484 "PipelineName":{ 485 "shape":"PipelineName", 486 "documentation":"<p>The name of the pipeline to get information about.</p>", 487 "location":"uri", 488 "locationName":"PipelineName" 489 } 490 } 491 }, 492 "GetPipelineResponse":{ 493 "type":"structure", 494 "members":{ 495 "Pipeline":{ 496 "shape":"Pipeline", 497 "documentation":"<p>Detailed information about the requested pipeline.</p>" 498 } 499 } 500 }, 501 "IngestEndpointUrlsList":{ 502 "type":"list", 503 "member":{"shape":"String"} 504 }, 505 "Integer":{"type":"integer"}, 506 "InternalException":{ 507 "type":"structure", 508 "members":{ 509 }, 510 "documentation":"<p>The request failed because of an unknown error, exception, or failure (the failure is internal to the service).</p>", 511 "error":{"httpStatusCode":500}, 512 "exception":true 513 }, 514 "InvalidPaginationTokenException":{ 515 "type":"structure", 516 "members":{ 517 }, 518 "documentation":"<p>An invalid pagination token provided in the request.</p>", 519 "error":{"httpStatusCode":400}, 520 "exception":true 521 }, 522 "KmsKeyArn":{ 523 "type":"string", 524 "max":2048, 525 "min":7 526 }, 527 "LimitExceededException":{ 528 "type":"structure", 529 "members":{ 530 }, 531 "documentation":"<p>You attempted to create more than the allowed number of tags.</p>", 532 "error":{"httpStatusCode":409}, 533 "exception":true 534 }, 535 "ListPipelineBlueprintsRequest":{ 536 "type":"structure", 537 "members":{ 538 } 539 }, 540 "ListPipelineBlueprintsResponse":{ 541 "type":"structure", 542 "members":{ 543 "Blueprints":{ 544 "shape":"PipelineBlueprintsSummaryList", 545 "documentation":"<p>A list of available blueprints for Data Prepper.</p>" 546 } 547 } 548 }, 549 "ListPipelinesRequest":{ 550 "type":"structure", 551 "members":{ 552 "MaxResults":{ 553 "shape":"MaxResults", 554 "documentation":"<p>An optional parameter that specifies the maximum number of results to return. You can use <code>nextToken</code> to get the next page of results.</p>", 555 "location":"querystring", 556 "locationName":"maxResults" 557 }, 558 "NextToken":{ 559 "shape":"NextToken", 560 "documentation":"<p>If your initial <code>ListPipelines</code> operation returns a <code>nextToken</code>, you can include the returned <code>nextToken</code> in subsequent <code>ListPipelines</code> operations, which returns results in the next page.</p>", 561 "location":"querystring", 562 "locationName":"nextToken" 563 } 564 } 565 }, 566 "ListPipelinesResponse":{ 567 "type":"structure", 568 "members":{ 569 "NextToken":{ 570 "shape":"NextToken", 571 "documentation":"<p>When <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.</p>" 572 }, 573 "Pipelines":{ 574 "shape":"PipelineSummaryList", 575 "documentation":"<p>A list of all existing Data Prepper pipelines.</p>" 576 } 577 } 578 }, 579 "ListTagsForResourceRequest":{ 580 "type":"structure", 581 "required":["Arn"], 582 "members":{ 583 "Arn":{ 584 "shape":"PipelineArn", 585 "documentation":"<p>The Amazon Resource Name (ARN) of the pipeline to retrieve tags for.</p>", 586 "location":"querystring", 587 "locationName":"arn" 588 } 589 } 590 }, 591 "ListTagsForResourceResponse":{ 592 "type":"structure", 593 "members":{ 594 "Tags":{ 595 "shape":"TagList", 596 "documentation":"<p>A list of tags associated with the given pipeline.</p>" 597 } 598 } 599 }, 600 "LogGroup":{ 601 "type":"string", 602 "max":512, 603 "min":1, 604 "pattern":"\\/aws\\/vendedlogs\\/[\\.\\-_/#A-Za-z0-9]+" 605 }, 606 "LogPublishingOptions":{ 607 "type":"structure", 608 "members":{ 609 "IsLoggingEnabled":{ 610 "shape":"Boolean", 611 "documentation":"<p>Whether logs should be published.</p>" 612 }, 613 "CloudWatchLogDestination":{ 614 "shape":"CloudWatchLogDestination", 615 "documentation":"<p>The destination for OpenSearch Ingestion logs sent to Amazon CloudWatch Logs. This parameter is required if <code>IsLoggingEnabled</code> is set to <code>true</code>.</p>" 616 } 617 }, 618 "documentation":"<p>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.</p>" 619 }, 620 "MaxResults":{ 621 "type":"integer", 622 "max":100, 623 "min":1 624 }, 625 "NextToken":{ 626 "type":"string", 627 "max":3000, 628 "min":0, 629 "pattern":"^([\\s\\S]*)$" 630 }, 631 "Pipeline":{ 632 "type":"structure", 633 "members":{ 634 "PipelineName":{ 635 "shape":"String", 636 "documentation":"<p>The name of the pipeline.</p>" 637 }, 638 "PipelineArn":{ 639 "shape":"String", 640 "documentation":"<p>The Amazon Resource Name (ARN) of the pipeline.</p>" 641 }, 642 "MinUnits":{ 643 "shape":"Integer", 644 "documentation":"<p>The minimum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 645 }, 646 "MaxUnits":{ 647 "shape":"Integer", 648 "documentation":"<p>The maximum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 649 }, 650 "Status":{ 651 "shape":"PipelineStatus", 652 "documentation":"<p>The current status of the pipeline.</p>" 653 }, 654 "StatusReason":{ 655 "shape":"PipelineStatusReason", 656 "documentation":"<p>The reason for the current status of the pipeline.</p>" 657 }, 658 "PipelineConfigurationBody":{ 659 "shape":"String", 660 "documentation":"<p>The Data Prepper pipeline configuration in YAML format.</p>" 661 }, 662 "CreatedAt":{ 663 "shape":"Timestamp", 664 "documentation":"<p>The date and time when the pipeline was created.</p>" 665 }, 666 "LastUpdatedAt":{ 667 "shape":"Timestamp", 668 "documentation":"<p>The date and time when the pipeline was last updated.</p>" 669 }, 670 "IngestEndpointUrls":{ 671 "shape":"IngestEndpointUrlsList", 672 "documentation":"<p>The ingestion endpoints for the pipeline, which you can send data to.</p>" 673 }, 674 "LogPublishingOptions":{ 675 "shape":"LogPublishingOptions", 676 "documentation":"<p>Key-value pairs that represent log publishing settings.</p>" 677 }, 678 "VpcEndpoints":{ 679 "shape":"VpcEndpointsList", 680 "documentation":"<p>The VPC interface endpoints that have access to the pipeline.</p>" 681 }, 682 "BufferOptions":{"shape":"BufferOptions"}, 683 "EncryptionAtRestOptions":{"shape":"EncryptionAtRestOptions"}, 684 "ServiceVpcEndpoints":{ 685 "shape":"ServiceVpcEndpointsList", 686 "documentation":"<p>A list of VPC endpoints that OpenSearch Ingestion has created to other AWS services.</p>" 687 }, 688 "Tags":{ 689 "shape":"TagList", 690 "documentation":"<p>A list of tags associated with the given pipeline.</p>" 691 } 692 }, 693 "documentation":"<p>Information about an existing OpenSearch Ingestion pipeline.</p>" 694 }, 695 "PipelineArn":{ 696 "type":"string", 697 "max":76, 698 "min":46, 699 "pattern":"^arn:(aws|aws\\-cn|aws\\-us\\-gov|aws\\-iso|aws\\-iso\\-b):osis:.+:pipeline\\/.+$" 700 }, 701 "PipelineBlueprint":{ 702 "type":"structure", 703 "members":{ 704 "BlueprintName":{ 705 "shape":"String", 706 "documentation":"<p>The name of the blueprint.</p>" 707 }, 708 "PipelineConfigurationBody":{ 709 "shape":"String", 710 "documentation":"<p>The YAML configuration of the blueprint.</p>" 711 } 712 }, 713 "documentation":"<p>Container for information about an OpenSearch Ingestion blueprint.</p>" 714 }, 715 "PipelineBlueprintSummary":{ 716 "type":"structure", 717 "members":{ 718 "BlueprintName":{ 719 "shape":"String", 720 "documentation":"<p>The name of the blueprint.</p>" 721 } 722 }, 723 "documentation":"<p>A summary of an OpenSearch Ingestion blueprint.</p>" 724 }, 725 "PipelineBlueprintsSummaryList":{ 726 "type":"list", 727 "member":{"shape":"PipelineBlueprintSummary"} 728 }, 729 "PipelineConfigurationBody":{ 730 "type":"string", 731 "max":24000, 732 "min":1 733 }, 734 "PipelineName":{ 735 "type":"string", 736 "max":28, 737 "min":3, 738 "pattern":"[a-z][a-z0-9\\-]+" 739 }, 740 "PipelineStatus":{ 741 "type":"string", 742 "enum":[ 743 "CREATING", 744 "ACTIVE", 745 "UPDATING", 746 "DELETING", 747 "CREATE_FAILED", 748 "UPDATE_FAILED", 749 "STARTING", 750 "START_FAILED", 751 "STOPPING", 752 "STOPPED" 753 ] 754 }, 755 "PipelineStatusReason":{ 756 "type":"structure", 757 "members":{ 758 "Description":{ 759 "shape":"String", 760 "documentation":"<p>A description of why a pipeline has a certain status.</p>" 761 } 762 }, 763 "documentation":"<p>Information about a pipeline's current status.</p>" 764 }, 765 "PipelineSummary":{ 766 "type":"structure", 767 "members":{ 768 "Status":{ 769 "shape":"PipelineStatus", 770 "documentation":"<p>The current status of the pipeline.</p>" 771 }, 772 "StatusReason":{"shape":"PipelineStatusReason"}, 773 "PipelineName":{ 774 "shape":"PipelineName", 775 "documentation":"<p>The name of the pipeline.</p>" 776 }, 777 "PipelineArn":{ 778 "shape":"PipelineArn", 779 "documentation":"<p>The Amazon Resource Name (ARN) of the pipeline.</p>" 780 }, 781 "MinUnits":{ 782 "shape":"PipelineUnits", 783 "documentation":"<p>The minimum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 784 }, 785 "MaxUnits":{ 786 "shape":"PipelineUnits", 787 "documentation":"<p>The maximum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 788 }, 789 "CreatedAt":{ 790 "shape":"Timestamp", 791 "documentation":"<p>The date and time when the pipeline was created.</p>" 792 }, 793 "LastUpdatedAt":{ 794 "shape":"Timestamp", 795 "documentation":"<p>The date and time when the pipeline was last updated.</p>" 796 }, 797 "Tags":{ 798 "shape":"TagList", 799 "documentation":"<p>A list of tags associated with the given pipeline.</p>" 800 } 801 }, 802 "documentation":"<p>Summary information for an OpenSearch Ingestion pipeline.</p>" 803 }, 804 "PipelineSummaryList":{ 805 "type":"list", 806 "member":{"shape":"PipelineSummary"} 807 }, 808 "PipelineUnits":{ 809 "type":"integer", 810 "min":1 811 }, 812 "ResourceAlreadyExistsException":{ 813 "type":"structure", 814 "members":{ 815 }, 816 "documentation":"<p>You attempted to create a resource that already exists.</p>", 817 "error":{"httpStatusCode":409}, 818 "exception":true 819 }, 820 "ResourceNotFoundException":{ 821 "type":"structure", 822 "members":{ 823 }, 824 "documentation":"<p>You attempted to access or delete a resource that does not exist.</p>", 825 "error":{"httpStatusCode":404}, 826 "exception":true 827 }, 828 "SecurityGroupId":{ 829 "type":"string", 830 "max":20, 831 "min":11, 832 "pattern":"sg-\\w{8}(\\w{9})?" 833 }, 834 "SecurityGroupIds":{ 835 "type":"list", 836 "member":{"shape":"SecurityGroupId"}, 837 "max":12, 838 "min":1 839 }, 840 "ServiceVpcEndpoint":{ 841 "type":"structure", 842 "members":{ 843 "ServiceName":{ 844 "shape":"VpcEndpointServiceName", 845 "documentation":"<p>The name of the service for which a VPC endpoint was created.</p>" 846 }, 847 "VpcEndpointId":{ 848 "shape":"String", 849 "documentation":"<p>The ID of the VPC endpoint that was created.</p>" 850 } 851 }, 852 "documentation":"<p>A container for information about VPC endpoints that were created to other services</p>" 853 }, 854 "ServiceVpcEndpointsList":{ 855 "type":"list", 856 "member":{"shape":"ServiceVpcEndpoint"} 857 }, 858 "StartPipelineRequest":{ 859 "type":"structure", 860 "required":["PipelineName"], 861 "members":{ 862 "PipelineName":{ 863 "shape":"PipelineName", 864 "documentation":"<p>The name of the pipeline to start.</p>", 865 "location":"uri", 866 "locationName":"PipelineName" 867 } 868 } 869 }, 870 "StartPipelineResponse":{ 871 "type":"structure", 872 "members":{ 873 "Pipeline":{"shape":"Pipeline"} 874 } 875 }, 876 "StopPipelineRequest":{ 877 "type":"structure", 878 "required":["PipelineName"], 879 "members":{ 880 "PipelineName":{ 881 "shape":"PipelineName", 882 "documentation":"<p>The name of the pipeline to stop.</p>", 883 "location":"uri", 884 "locationName":"PipelineName" 885 } 886 } 887 }, 888 "StopPipelineResponse":{ 889 "type":"structure", 890 "members":{ 891 "Pipeline":{"shape":"Pipeline"} 892 } 893 }, 894 "String":{"type":"string"}, 895 "StringList":{ 896 "type":"list", 897 "member":{"shape":"String"} 898 }, 899 "SubnetId":{ 900 "type":"string", 901 "max":24, 902 "min":15, 903 "pattern":"subnet-\\w{8}(\\w{9})?" 904 }, 905 "SubnetIds":{ 906 "type":"list", 907 "member":{"shape":"SubnetId"}, 908 "max":12, 909 "min":1 910 }, 911 "Tag":{ 912 "type":"structure", 913 "required":[ 914 "Key", 915 "Value" 916 ], 917 "members":{ 918 "Key":{ 919 "shape":"TagKey", 920 "documentation":"<p>The tag key. Tag keys must be unique for the pipeline to which they are attached.</p>" 921 }, 922 "Value":{ 923 "shape":"TagValue", 924 "documentation":"<p>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 <code>project : Trinity</code> and <code>cost-center : Trinity</code> </p>" 925 } 926 }, 927 "documentation":"<p>A tag (key-value pair) for an OpenSearch Ingestion pipeline.</p>" 928 }, 929 "TagKey":{ 930 "type":"string", 931 "max":128, 932 "min":1, 933 "pattern":".*" 934 }, 935 "TagList":{ 936 "type":"list", 937 "member":{"shape":"Tag"} 938 }, 939 "TagResourceRequest":{ 940 "type":"structure", 941 "required":[ 942 "Arn", 943 "Tags" 944 ], 945 "members":{ 946 "Arn":{ 947 "shape":"PipelineArn", 948 "documentation":"<p>The Amazon Resource Name (ARN) of the pipeline to tag.</p>", 949 "location":"querystring", 950 "locationName":"arn" 951 }, 952 "Tags":{ 953 "shape":"TagList", 954 "documentation":"<p>The list of key-value tags to add to the pipeline.</p>" 955 } 956 } 957 }, 958 "TagResourceResponse":{ 959 "type":"structure", 960 "members":{ 961 } 962 }, 963 "TagValue":{ 964 "type":"string", 965 "max":256, 966 "min":0, 967 "pattern":".*" 968 }, 969 "Timestamp":{"type":"timestamp"}, 970 "UntagResourceRequest":{ 971 "type":"structure", 972 "required":[ 973 "Arn", 974 "TagKeys" 975 ], 976 "members":{ 977 "Arn":{ 978 "shape":"PipelineArn", 979 "documentation":"<p>The Amazon Resource Name (ARN) of the pipeline to remove tags from.</p>", 980 "location":"querystring", 981 "locationName":"arn" 982 }, 983 "TagKeys":{ 984 "shape":"StringList", 985 "documentation":"<p>The tag keys to remove.</p>" 986 } 987 } 988 }, 989 "UntagResourceResponse":{ 990 "type":"structure", 991 "members":{ 992 } 993 }, 994 "UpdatePipelineRequest":{ 995 "type":"structure", 996 "required":["PipelineName"], 997 "members":{ 998 "PipelineName":{ 999 "shape":"PipelineName", 1000 "documentation":"<p>The name of the pipeline to update.</p>", 1001 "location":"uri", 1002 "locationName":"PipelineName" 1003 }, 1004 "MinUnits":{ 1005 "shape":"PipelineUnits", 1006 "documentation":"<p>The minimum pipeline capacity, in Ingestion Compute Units (ICUs).</p>" 1007 }, 1008 "MaxUnits":{ 1009 "shape":"PipelineUnits", 1010 "documentation":"<p>The maximum pipeline capacity, in Ingestion Compute Units (ICUs)</p>" 1011 }, 1012 "PipelineConfigurationBody":{ 1013 "shape":"PipelineConfigurationBody", 1014 "documentation":"<p>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 <code>\\n</code>.</p>" 1015 }, 1016 "LogPublishingOptions":{ 1017 "shape":"LogPublishingOptions", 1018 "documentation":"<p>Key-value pairs to configure log publishing.</p>" 1019 }, 1020 "BufferOptions":{ 1021 "shape":"BufferOptions", 1022 "documentation":"<p>Key-value pairs to configure persistent buffering for the pipeline.</p>" 1023 }, 1024 "EncryptionAtRestOptions":{ 1025 "shape":"EncryptionAtRestOptions", 1026 "documentation":"<p>Key-value pairs to configure encryption for data that is written to a persistent buffer.</p>" 1027 } 1028 } 1029 }, 1030 "UpdatePipelineResponse":{ 1031 "type":"structure", 1032 "members":{ 1033 "Pipeline":{ 1034 "shape":"Pipeline", 1035 "documentation":"<p>Container for information about the updated pipeline.</p>" 1036 } 1037 } 1038 }, 1039 "ValidatePipelineRequest":{ 1040 "type":"structure", 1041 "required":["PipelineConfigurationBody"], 1042 "members":{ 1043 "PipelineConfigurationBody":{ 1044 "shape":"PipelineConfigurationBody", 1045 "documentation":"<p>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 <code>\\n</code>.</p>" 1046 } 1047 } 1048 }, 1049 "ValidatePipelineResponse":{ 1050 "type":"structure", 1051 "members":{ 1052 "isValid":{ 1053 "shape":"Boolean", 1054 "documentation":"<p>A boolean indicating whether or not the pipeline configuration is valid.</p>" 1055 }, 1056 "Errors":{ 1057 "shape":"ValidationMessageList", 1058 "documentation":"<p>A list of errors if the configuration is invalid.</p>" 1059 } 1060 } 1061 }, 1062 "ValidationException":{ 1063 "type":"structure", 1064 "members":{ 1065 }, 1066 "documentation":"<p>An exception for missing or invalid input fields.</p>", 1067 "error":{"httpStatusCode":400}, 1068 "exception":true 1069 }, 1070 "ValidationMessage":{ 1071 "type":"structure", 1072 "members":{ 1073 "Message":{ 1074 "shape":"String", 1075 "documentation":"<p>The validation message.</p>" 1076 } 1077 }, 1078 "documentation":"<p>A validation message associated with a <code>ValidatePipeline</code> request in OpenSearch Ingestion.</p>" 1079 }, 1080 "ValidationMessageList":{ 1081 "type":"list", 1082 "member":{"shape":"ValidationMessage"} 1083 }, 1084 "VpcEndpoint":{ 1085 "type":"structure", 1086 "members":{ 1087 "VpcEndpointId":{ 1088 "shape":"String", 1089 "documentation":"<p>The unique identifier of the endpoint.</p>" 1090 }, 1091 "VpcId":{ 1092 "shape":"String", 1093 "documentation":"<p>The ID for your VPC. Amazon Web Services PrivateLink generates this value when you create a VPC.</p>" 1094 }, 1095 "VpcOptions":{ 1096 "shape":"VpcOptions", 1097 "documentation":"<p>Information about the VPC, including associated subnets and security groups.</p>" 1098 } 1099 }, 1100 "documentation":"<p>An OpenSearch Ingestion-managed VPC endpoint that will access one or more pipelines.</p>" 1101 }, 1102 "VpcEndpointServiceName":{ 1103 "type":"string", 1104 "enum":["OPENSEARCH_SERVERLESS"] 1105 }, 1106 "VpcEndpointsList":{ 1107 "type":"list", 1108 "member":{"shape":"VpcEndpoint"} 1109 }, 1110 "VpcOptions":{ 1111 "type":"structure", 1112 "required":["SubnetIds"], 1113 "members":{ 1114 "SubnetIds":{ 1115 "shape":"SubnetIds", 1116 "documentation":"<p>A list of subnet IDs associated with the VPC endpoint.</p>" 1117 }, 1118 "SecurityGroupIds":{ 1119 "shape":"SecurityGroupIds", 1120 "documentation":"<p>A list of security groups associated with the VPC endpoint.</p>" 1121 } 1122 }, 1123 "documentation":"<p>Options that specify the subnets and security groups for an OpenSearch Ingestion VPC endpoint.</p>" 1124 } 1125 }, 1126 "documentation":"<p>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 <a href=\"https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ingestion.html\">Getting data into your cluster using OpenSearch Ingestion</a>.</p>" 1127} 1128