From f150a3c781ee8e6f1b9f8ed71aa15a6107dd65f9 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Tue, 12 Dec 2023 19:13:30 +0000 Subject: [PATCH] Update to latest models --- .../api-change-imagebuilder-35987.json | 5 + .../api-change-location-51420.json | 5 + .../next-release/api-change-logs-77574.json | 5 + .../imagebuilder/2019-12-02/service-2.json | 843 +++++++++++++++++- .../data/location/2020-11-19/service-2.json | 23 +- botocore/data/logs/2014-03-28/service-2.json | 207 ++++- 6 files changed, 1054 insertions(+), 34 deletions(-) create mode 100644 .changes/next-release/api-change-imagebuilder-35987.json create mode 100644 .changes/next-release/api-change-location-51420.json create mode 100644 .changes/next-release/api-change-logs-77574.json diff --git a/.changes/next-release/api-change-imagebuilder-35987.json b/.changes/next-release/api-change-imagebuilder-35987.json new file mode 100644 index 0000000000..3db712fae7 --- /dev/null +++ b/.changes/next-release/api-change-imagebuilder-35987.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``imagebuilder``", + "description": "This release adds the Image Workflows feature to give more flexibility and control over the image building and testing process." +} diff --git a/.changes/next-release/api-change-location-51420.json b/.changes/next-release/api-change-location-51420.json new file mode 100644 index 0000000000..3abbd664e5 --- /dev/null +++ b/.changes/next-release/api-change-location-51420.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``location``", + "description": "This release 1) adds sub-municipality field in Places API for searching and getting places information, and 2) allows optimizing route calculation based on expected arrival time." +} diff --git a/.changes/next-release/api-change-logs-77574.json b/.changes/next-release/api-change-logs-77574.json new file mode 100644 index 0000000000..3800223f9f --- /dev/null +++ b/.changes/next-release/api-change-logs-77574.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``logs``", + "description": "This release introduces the StartLiveTail API to tail ingested logs in near real time." +} diff --git a/botocore/data/imagebuilder/2019-12-02/service-2.json b/botocore/data/imagebuilder/2019-12-02/service-2.json index 863a40ccee..fbb86cedb1 100644 --- a/botocore/data/imagebuilder/2019-12-02/service-2.json +++ b/botocore/data/imagebuilder/2019-12-02/service-2.json @@ -232,6 +232,29 @@ ], "documentation":"

Create a lifecycle policy resource.

" }, + "CreateWorkflow":{ + "name":"CreateWorkflow", + "http":{ + "method":"PUT", + "requestUri":"/CreateWorkflow" + }, + "input":{"shape":"CreateWorkflowRequest"}, + "output":{"shape":"CreateWorkflowResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"InvalidRequestException"}, + {"shape":"IdempotentParameterMismatchException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"}, + {"shape":"InvalidVersionNumberException"}, + {"shape":"ResourceInUseException"}, + {"shape":"InvalidParameterCombinationException"}, + {"shape":"ServiceQuotaExceededException"} + ], + "documentation":"

Create a new workflow or a new version of an existing workflow.

" + }, "DeleteComponent":{ "name":"DeleteComponent", "http":{ @@ -384,6 +407,25 @@ ], "documentation":"

Delete the specified lifecycle policy resource.

" }, + "DeleteWorkflow":{ + "name":"DeleteWorkflow", + "http":{ + "method":"DELETE", + "requestUri":"/DeleteWorkflow" + }, + "input":{"shape":"DeleteWorkflowRequest"}, + "output":{"shape":"DeleteWorkflowResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"InvalidRequestException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"}, + {"shape":"ResourceDependencyException"} + ], + "documentation":"

Deletes a specific workflow resource.

" + }, "GetComponent":{ "name":"GetComponent", "http":{ @@ -618,6 +660,24 @@ ], "documentation":"

Get details for the specified image lifecycle policy.

" }, + "GetWorkflow":{ + "name":"GetWorkflow", + "http":{ + "method":"GET", + "requestUri":"/GetWorkflow" + }, + "input":{"shape":"GetWorkflowRequest"}, + "output":{"shape":"GetWorkflowResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"InvalidRequestException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"} + ], + "documentation":"

Get a workflow resource object.

" + }, "GetWorkflowExecution":{ "name":"GetWorkflowExecution", "http":{ @@ -1012,6 +1072,44 @@ ], "documentation":"

Returns the list of tags for the specified resource.

" }, + "ListWaitingWorkflowSteps":{ + "name":"ListWaitingWorkflowSteps", + "http":{ + "method":"POST", + "requestUri":"/ListWaitingWorkflowSteps" + }, + "input":{"shape":"ListWaitingWorkflowStepsRequest"}, + "output":{"shape":"ListWaitingWorkflowStepsResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"InvalidRequestException"}, + {"shape":"InvalidPaginationTokenException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"} + ], + "documentation":"

Get a list of workflow steps that are waiting for action for workflows in your Amazon Web Services account.

" + }, + "ListWorkflowBuildVersions":{ + "name":"ListWorkflowBuildVersions", + "http":{ + "method":"POST", + "requestUri":"/ListWorkflowBuildVersions" + }, + "input":{"shape":"ListWorkflowBuildVersionsRequest"}, + "output":{"shape":"ListWorkflowBuildVersionsResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"InvalidRequestException"}, + {"shape":"InvalidPaginationTokenException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"} + ], + "documentation":"

Returns a list of build versions for a specific workflow resource.

" + }, "ListWorkflowExecutions":{ "name":"ListWorkflowExecutions", "http":{ @@ -1048,7 +1146,26 @@ {"shape":"ForbiddenException"}, {"shape":"CallRateLimitExceededException"} ], - "documentation":"

Shows runtime data for each step in a runtime instance of the workflow that you specify in the request.

" + "documentation":"

Returns runtime data for each step in a runtime instance of the workflow that you specify in the request.

" + }, + "ListWorkflows":{ + "name":"ListWorkflows", + "http":{ + "method":"POST", + "requestUri":"/ListWorkflows" + }, + "input":{"shape":"ListWorkflowsRequest"}, + "output":{"shape":"ListWorkflowsResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"InvalidRequestException"}, + {"shape":"InvalidPaginationTokenException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"} + ], + "documentation":"

Lists workflow build versions based on filtering parameters.

" }, "PutComponentPolicy":{ "name":"PutComponentPolicy", @@ -1130,6 +1247,28 @@ ], "documentation":"

Applies a policy to an image recipe. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutImageRecipePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared.

" }, + "SendWorkflowStepAction":{ + "name":"SendWorkflowStepAction", + "http":{ + "method":"PUT", + "requestUri":"/SendWorkflowStepAction" + }, + "input":{"shape":"SendWorkflowStepActionRequest"}, + "output":{"shape":"SendWorkflowStepActionResponse"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"ClientException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidRequestException"}, + {"shape":"InvalidParameterValueException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"IdempotentParameterMismatchException"}, + {"shape":"ForbiddenException"}, + {"shape":"CallRateLimitExceededException"}, + {"shape":"ResourceInUseException"} + ], + "documentation":"

Pauses or resumes image creation when the associated workflow runs a WaitForAction step.

" + }, "StartImagePipelineExecution":{ "name":"StartImagePipelineExecution", "http":{ @@ -1241,7 +1380,7 @@ {"shape":"CallRateLimitExceededException"}, {"shape":"ResourceInUseException"} ], - "documentation":"

Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images.

UpdateImagePipeline does not support selective updates for the pipeline. You must specify all of the required properties in the update request, not just the properties that have changed.

" + "documentation":"

Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images. You must specify exactly one recipe for your image, using either a containerRecipeArn or an imageRecipeArn.

UpdateImagePipeline does not support selective updates for the pipeline. You must specify all of the required properties in the update request, not just the properties that have changed.

" }, "UpdateInfrastructureConfiguration":{ "name":"UpdateInfrastructureConfiguration", @@ -1507,7 +1646,7 @@ }, "changeDescription":{ "shape":"NonEmptyString", - "documentation":"

The change description of the component.

" + "documentation":"

Describes what change has been made in this version of the component, or what makes this version different from other versions of the component.

" }, "type":{ "shape":"ComponentType", @@ -1685,7 +1824,7 @@ "documentation":"

Describes how or why the component changed state.

" } }, - "documentation":"

A group of fields that describe the current status of components that are no longer active.

" + "documentation":"

A group of fields that describe the current status of components.

" }, "ComponentStatus":{ "type":"string", @@ -2006,7 +2145,7 @@ }, "changeDescription":{ "shape":"NonEmptyString", - "documentation":"

The change description of the component. Describes what change has been made in this version, or what makes this version different from other versions of this component.

" + "documentation":"

The change description of the component. Describes what change has been made in this version, or what makes this version different from other versions of the component.

" }, "platform":{ "shape":"Platform", @@ -2260,6 +2399,14 @@ "imageScanningConfiguration":{ "shape":"ImageScanningConfiguration", "documentation":"

Contains settings for vulnerability scans.

" + }, + "workflows":{ + "shape":"WorkflowConfigurationList", + "documentation":"

Contains an array of workflow configuration objects.

" + }, + "executionRole":{ + "shape":"RoleNameOrArn", + "documentation":"

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.

" } } }, @@ -2393,6 +2540,14 @@ "imageScanningConfiguration":{ "shape":"ImageScanningConfiguration", "documentation":"

Contains settings for vulnerability scans.

" + }, + "workflows":{ + "shape":"WorkflowConfigurationList", + "documentation":"

Contains an array of workflow configuration objects.

" + }, + "executionRole":{ + "shape":"RoleNameOrArn", + "documentation":"

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.

" } } }, @@ -2522,7 +2677,7 @@ }, "executionRole":{ "shape":"RoleNameOrArn", - "documentation":"

The role name or Amazon Resource Name (ARN) for the IAM role that grants Image Builder access to run lifecycle actions.

" + "documentation":"

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to run lifecycle actions.

" }, "resourceType":{ "shape":"LifecyclePolicyResourceType", @@ -2560,6 +2715,71 @@ } } }, + "CreateWorkflowRequest":{ + "type":"structure", + "required":[ + "name", + "semanticVersion", + "clientToken", + "type" + ], + "members":{ + "name":{ + "shape":"ResourceName", + "documentation":"

The name of the workflow to create.

" + }, + "semanticVersion":{ + "shape":"VersionNumber", + "documentation":"

The semantic version of this workflow resource. The semantic version syntax adheres to the following rules.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

" + }, + "description":{ + "shape":"NonEmptyString", + "documentation":"

Describes the workflow.

" + }, + "changeDescription":{ + "shape":"NonEmptyString", + "documentation":"

Describes what change has been made in this version of the workflow, or what makes this version different from other versions of the workflow.

" + }, + "data":{ + "shape":"InlineWorkflowData", + "documentation":"

Contains the UTF-8 encoded YAML document content for the workflow. Alternatively, you can specify the uri of a YAML document file stored in Amazon S3. However, you cannot specify both properties.

" + }, + "uri":{ + "shape":"Uri", + "documentation":"

The uri of a YAML component document file. This must be an S3 URL (s3://bucket/key), and the requester must have permission to access the S3 bucket it points to. If you use Amazon S3, you can specify component content up to your service quota.

Alternatively, you can specify the YAML document inline, using the component data property. You cannot specify both properties.

" + }, + "kmsKeyId":{ + "shape":"NonEmptyString", + "documentation":"

The ID of the KMS key that is used to encrypt this workflow resource.

" + }, + "tags":{ + "shape":"TagMap", + "documentation":"

Tags that apply to the workflow resource.

" + }, + "clientToken":{ + "shape":"ClientToken", + "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see Ensuring idempotency in the Amazon EC2 API Reference.

", + "idempotencyToken":true + }, + "type":{ + "shape":"WorkflowType", + "documentation":"

The phase in the image build process for which the workflow resource is responsible.

" + } + } + }, + "CreateWorkflowResponse":{ + "type":"structure", + "members":{ + "clientToken":{ + "shape":"ClientToken", + "documentation":"

The client token that uniquely identifies the request.

" + }, + "workflowBuildVersionArn":{ + "shape":"WorkflowBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource that the request created.

" + } + } + }, "CvssScore":{ "type":"structure", "members":{ @@ -2832,6 +3052,27 @@ } } }, + "DeleteWorkflowRequest":{ + "type":"structure", + "required":["workflowBuildVersionArn"], + "members":{ + "workflowBuildVersionArn":{ + "shape":"WorkflowBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource to delete.

", + "location":"querystring", + "locationName":"workflowBuildVersionArn" + } + } + }, + "DeleteWorkflowResponse":{ + "type":"structure", + "members":{ + "workflowBuildVersionArn":{ + "shape":"WorkflowBuildVersionArn", + "documentation":"

The ARN of the workflow resource that this request deleted.

" + } + } + }, "DiskImageFormat":{ "type":"string", "enum":[ @@ -3201,7 +3442,7 @@ }, "component":{ "shape":"Component", - "documentation":"

The component object associated with the specified ARN.

" + "documentation":"

The component object specified in the request.

" } } }, @@ -3540,6 +3781,31 @@ "endTime":{ "shape":"DateTime", "documentation":"

The timestamp when the specified runtime instance of the workflow finished.

" + }, + "parallelGroup":{ + "shape":"ParallelGroup", + "documentation":"

Test workflows are defined within named runtime groups. The parallel group is a named group that contains one or more test workflows.

" + } + } + }, + "GetWorkflowRequest":{ + "type":"structure", + "required":["workflowBuildVersionArn"], + "members":{ + "workflowBuildVersionArn":{ + "shape":"WorkflowVersionArnOrBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource that you want to get.

", + "location":"querystring", + "locationName":"workflowBuildVersionArn" + } + } + }, + "GetWorkflowResponse":{ + "type":"structure", + "members":{ + "workflow":{ + "shape":"Workflow", + "documentation":"

The workflow resource specified in the request.

" } } }, @@ -3744,6 +4010,14 @@ "lifecycleExecutionId":{ "shape":"LifecycleExecutionId", "documentation":"

Identifies the last runtime instance of the lifecycle policy to take action on the image.

" + }, + "executionRole":{ + "shape":"RoleNameOrArn", + "documentation":"

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.

" + }, + "workflows":{ + "shape":"WorkflowConfigurationList", + "documentation":"

Contains the build and test workflows that are associated with the image.

" } }, "documentation":"

An Image Builder image. You must specify exactly one recipe for the image – either a container recipe (containerRecipe), which creates a container image, or an image recipe (imageRecipe), which creates an AMI.

" @@ -3867,6 +4141,14 @@ "imageScanningConfiguration":{ "shape":"ImageScanningConfiguration", "documentation":"

Contains settings for vulnerability scans.

" + }, + "executionRole":{ + "shape":"RoleNameOrArn", + "documentation":"

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.

" + }, + "workflows":{ + "shape":"WorkflowConfigurationList", + "documentation":"

Contains the workflows that run for the image pipeline.

" } }, "documentation":"

Details of an image pipeline.

" @@ -4375,7 +4657,7 @@ }, "changeDescription":{ "shape":"NonEmptyString", - "documentation":"

The change description of the component. This description indicates the change that has been made in this version, or what makes this version different from other versions of this component.

" + "documentation":"

The change description of the component. This description indicates the change that has been made in this version, or what makes this version different from other versions of the component.

" }, "type":{ "shape":"ComponentType", @@ -4623,6 +4905,12 @@ "min":1, "pattern":"[^\\x00]+" }, + "InlineWorkflowData":{ + "type":"string", + "max":16000, + "min":1, + "pattern":"[^\\x00]+" + }, "InspectorScoreDetails":{ "type":"structure", "members":{ @@ -5008,7 +5296,7 @@ }, "executionRole":{ "shape":"RoleNameOrArn", - "documentation":"

The name of the IAM role that Image Builder uses to run the lifecycle policy. This is a custom role that you create.

" + "documentation":"

The name or Amazon Resource Name (ARN) of the IAM role that Image Builder uses to run the lifecycle policy. This is a custom role that you create.

" }, "resourceType":{ "shape":"LifecyclePolicyResourceType", @@ -5114,7 +5402,7 @@ "members":{ "tagMap":{ "shape":"TagMap", - "documentation":"

Contains a list of tags that Image Builder uses to skip lifecycle actions for AMIs that have them.

" + "documentation":"

Contains a list of tags that Image Builder uses to skip lifecycle actions for resources that have them.

" }, "amis":{ "shape":"LifecyclePolicyDetailExclusionRulesAmis", @@ -5132,15 +5420,15 @@ }, "regions":{ "shape":"StringList", - "documentation":"

Specifies Amazon Web Services accounts whose resources are excluded from the lifecycle action.

" + "documentation":"

Configures Amazon Web Services Regions that are excluded from the lifecycle action.

" }, "sharedAccounts":{ "shape":"AccountList", - "documentation":"

Specifies configuration details for Image Builder to exclude the most recent resources from lifecycle actions.

" + "documentation":"

Specifies Amazon Web Services accounts whose resources are excluded from the lifecycle action.

" }, "lastLaunched":{ "shape":"LifecyclePolicyDetailExclusionRulesAmisLastLaunched", - "documentation":"

Configures Amazon Web Services Regions that are excluded from the lifecycle action.

" + "documentation":"

Specifies configuration details for Image Builder to exclude the most recent resources from lifecycle actions.

" }, "tagMap":{ "shape":"TagMap", @@ -5294,7 +5582,7 @@ }, "executionRole":{ "shape":"RoleNameOrArn", - "documentation":"

The name of the IAM role that Image Builder uses to run the lifecycle policy.

" + "documentation":"

The name or Amazon Resource Name (ARN) of the IAM role that Image Builder uses to run the lifecycle policy.

" }, "resourceType":{ "shape":"LifecyclePolicyResourceType", @@ -5951,6 +6239,65 @@ } } }, + "ListWaitingWorkflowStepsRequest":{ + "type":"structure", + "members":{ + "maxResults":{ + "shape":"RestrictedInteger", + "documentation":"

The maximum items to return in a request.

", + "box":true + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

" + } + } + }, + "ListWaitingWorkflowStepsResponse":{ + "type":"structure", + "members":{ + "steps":{ + "shape":"WorkflowStepExecutionList", + "documentation":"

An array of the workflow steps that are waiting for action in your Amazon Web Services account.

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

The next token used for paginated responses. When this field isn't empty, there are additional elements that the service hasn't included in this request. Use this token with the next request to retrieve additional objects.

" + } + } + }, + "ListWorkflowBuildVersionsRequest":{ + "type":"structure", + "required":["workflowVersionArn"], + "members":{ + "workflowVersionArn":{ + "shape":"WorkflowWildcardVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource for which to get a list of build versions.

" + }, + "maxResults":{ + "shape":"RestrictedInteger", + "documentation":"

The maximum items to return in a request.

", + "box":true + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

" + } + } + }, + "ListWorkflowBuildVersionsResponse":{ + "type":"structure", + "members":{ + "workflowSummaryList":{ + "shape":"WorkflowSummaryList", + "documentation":"

A list that contains metadata for the workflow builds that have run for the workflow resource specified in the request.

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

The next token used for paginated responses. When this field isn't empty, there are additional elements that the service hasn't included in this request. Use this token with the next request to retrieve additional objects.

" + } + } + }, "ListWorkflowExecutionsRequest":{ "type":"structure", "required":["imageBuildVersionArn"], @@ -6047,14 +6394,53 @@ } } }, - "Logging":{ + "ListWorkflowsRequest":{ "type":"structure", "members":{ - "s3Logs":{ - "shape":"S3Logs", - "documentation":"

The Amazon S3 logging configuration.

" - } - }, + "owner":{ + "shape":"Ownership", + "documentation":"

Used to get a list of workflow build version filtered by the identity of the creator.

" + }, + "filters":{ + "shape":"FilterList", + "documentation":"

Used to streamline search results.

" + }, + "byName":{ + "shape":"Boolean", + "documentation":"

Specify all or part of the workflow name to streamline results.

" + }, + "maxResults":{ + "shape":"RestrictedInteger", + "documentation":"

The maximum items to return in a request.

", + "box":true + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

" + } + } + }, + "ListWorkflowsResponse":{ + "type":"structure", + "members":{ + "workflowVersionList":{ + "shape":"WorkflowVersionList", + "documentation":"

A list of workflow build versions that match the request criteria.

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

The next token used for paginated responses. When this field isn't empty, there are additional elements that the service hasn't included in this request. Use this token with the next request to retrieve additional objects.

" + } + } + }, + "Logging":{ + "type":"structure", + "members":{ + "s3Logs":{ + "shape":"S3Logs", + "documentation":"

The Amazon S3 logging configuration.

" + } + }, "documentation":"

Logging configuration defines where Image Builder uploads your logs.

" }, "MaxParallelLaunches":{ @@ -6076,6 +6462,13 @@ "min":0 }, "NullableBoolean":{"type":"boolean"}, + "OnWorkflowFailure":{ + "type":"string", + "enum":[ + "CONTINUE", + "ABORT" + ] + }, "OrganizationArn":{ "type":"string", "pattern":"^arn:aws[^:]*:organizations::[0-9]{12}:organization/o-[a-z0-9]{10,32}$" @@ -6183,6 +6576,12 @@ "max":65535, "min":1 }, + "ParallelGroup":{ + "type":"string", + "max":100, + "min":1, + "pattern":"^[A-Za-z0-9][A-Za-z0-9-_+#]{0,99}$" + }, "PipelineExecutionStartCondition":{ "type":"string", "enum":[ @@ -6516,12 +6915,61 @@ "documentation":"

The condition configures when the pipeline should trigger a new image build. When the pipelineExecutionStartCondition is set to EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE, and you use semantic version filters on the base image or components in your image recipe, EC2 Image Builder will build a new image only when there are new versions of the image or components in your recipe that match the semantic version filter. When it is set to EXPRESSION_MATCH_ONLY, it will build a new image every time the CRON expression matches the current time. For semantic version syntax, see CreateComponent in the EC2 Image Builder API Reference.

" } }, - "documentation":"

A schedule configures how often and when a pipeline will automatically create a new image.

" + "documentation":"

A schedule configures when and how often a pipeline will automatically create a new image.

" }, "SecurityGroupIds":{ "type":"list", "member":{"shape":"NonEmptyString"} }, + "SendWorkflowStepActionRequest":{ + "type":"structure", + "required":[ + "stepExecutionId", + "imageBuildVersionArn", + "action", + "clientToken" + ], + "members":{ + "stepExecutionId":{ + "shape":"WorkflowStepExecutionId", + "documentation":"

Uniquely identifies the workflow step that sent the step action.

" + }, + "imageBuildVersionArn":{ + "shape":"ImageBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the image build version to send action for.

" + }, + "action":{ + "shape":"WorkflowStepActionType", + "documentation":"

The action for the image creation process to take while a workflow WaitForAction step waits for an asynchronous action to complete.

" + }, + "reason":{ + "shape":"NonEmptyString", + "documentation":"

The reason why this action is sent.

" + }, + "clientToken":{ + "shape":"ClientToken", + "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see Ensuring idempotency in the Amazon EC2 API Reference.

", + "idempotencyToken":true + } + } + }, + "SendWorkflowStepActionResponse":{ + "type":"structure", + "members":{ + "stepExecutionId":{ + "shape":"WorkflowStepExecutionId", + "documentation":"

The workflow step that sent the step action.

" + }, + "imageBuildVersionArn":{ + "shape":"ImageBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the image build version that received the action request.

" + }, + "clientToken":{ + "shape":"ClientToken", + "documentation":"

The client token that uniquely identifies the request.

" + } + } + }, "ServiceException":{ "type":"structure", "members":{ @@ -6880,6 +7328,14 @@ "imageScanningConfiguration":{ "shape":"ImageScanningConfiguration", "documentation":"

Contains settings for vulnerability scans.

" + }, + "workflows":{ + "shape":"WorkflowConfigurationList", + "documentation":"

Contains the workflows to run for the pipeline.

" + }, + "executionRole":{ + "shape":"RoleNameOrArn", + "documentation":"

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.

" } } }, @@ -7005,7 +7461,7 @@ }, "executionRole":{ "shape":"RoleNameOrArn", - "documentation":"

The name of the IAM role that Image Builder should use to update the lifecycle policy.

" + "documentation":"

The name or Amazon Resource Name (ARN) of the IAM role that Image Builder uses to update the lifecycle policy.

" }, "resourceType":{ "shape":"LifecyclePolicyResourceType", @@ -7115,11 +7571,97 @@ "type":"list", "member":{"shape":"VulnerablePackage"} }, + "Workflow":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"WorkflowBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource.

" + }, + "name":{ + "shape":"ResourceName", + "documentation":"

The name of the workflow resource.

" + }, + "version":{ + "shape":"VersionNumber", + "documentation":"

The workflow resource version. Workflow resources are immutable. To make a change, you can clone a workflow or create a new version.

" + }, + "description":{ + "shape":"NonEmptyString", + "documentation":"

The description of the workflow.

" + }, + "changeDescription":{ + "shape":"NonEmptyString", + "documentation":"

Describes what change has been made in this version of the workflow, or what makes this version different from other versions of the workflow.

" + }, + "type":{ + "shape":"WorkflowType", + "documentation":"

Specifies the image creation stage that the workflow applies to. Image Builder currently supports build and test workflows.

" + }, + "state":{ + "shape":"WorkflowState", + "documentation":"

Describes the current status of the workflow and the reason for that status.

" + }, + "owner":{ + "shape":"NonEmptyString", + "documentation":"

The owner of the workflow resource.

" + }, + "data":{ + "shape":"WorkflowData", + "documentation":"

Contains the YAML document content for the workflow.

" + }, + "kmsKeyId":{ + "shape":"NonEmptyString", + "documentation":"

The KMS key identifier used to encrypt the workflow resource.

" + }, + "dateCreated":{ + "shape":"DateTime", + "documentation":"

The timestamp when Image Builder created the workflow resource.

" + }, + "tags":{ + "shape":"TagMap", + "documentation":"

The tags that apply to the workflow resource

" + }, + "parameters":{ + "shape":"WorkflowParameterDetailList", + "documentation":"

An array of input parameters that that the image workflow uses to control actions or configure settings.

" + } + }, + "documentation":"

Defines a process that Image Builder uses to build and test images during the image creation process.

" + }, "WorkflowBuildVersionArn":{ "type":"string", "max":1024, "pattern":"^arn:aws(?:-[a-z]+)*:imagebuilder:[a-z]{2,}(?:-[a-z]+)+-[0-9]+:(?:[0-9]{12}|aws):workflow/(build|test|distribution)/[a-z0-9-_]+/[0-9]+\\.[0-9]+\\.[0-9]+/[0-9]+$" }, + "WorkflowConfiguration":{ + "type":"structure", + "required":["workflowArn"], + "members":{ + "workflowArn":{ + "shape":"WorkflowVersionArnOrBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource.

" + }, + "parameters":{ + "shape":"WorkflowParameterList", + "documentation":"

Contains parameter values for each of the parameters that the workflow document defined for the workflow resource.

" + }, + "parallelGroup":{ + "shape":"ParallelGroup", + "documentation":"

Test workflows are defined within named runtime groups called parallel groups. The parallel group is the named group that contains this test workflow. Test workflows within a parallel group can run at the same time. Image Builder starts up to five test workflows in the group at the same time, and starts additional workflows as others complete, until all workflows in the group have completed. This field only applies for test workflows.

" + }, + "onFailure":{ + "shape":"OnWorkflowFailure", + "documentation":"

The action to take if the workflow fails.

" + } + }, + "documentation":"

Contains control settings and configurable inputs for a workflow resource.

" + }, + "WorkflowConfigurationList":{ + "type":"list", + "member":{"shape":"WorkflowConfiguration"} + }, + "WorkflowData":{"type":"string"}, "WorkflowExecutionId":{ "type":"string", "pattern":"^wf-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" @@ -7175,6 +7717,10 @@ "endTime":{ "shape":"DateTime", "documentation":"

The timestamp when this runtime instance of the workflow finished.

" + }, + "parallelGroup":{ + "shape":"ParallelGroup", + "documentation":"

The name of the test group that included the test workflow resource at runtime.

" } }, "documentation":"

Metadata that includes details and status from this runtime instance of the workflow.

" @@ -7188,27 +7734,175 @@ "COMPLETED", "FAILED", "ROLLBACK_IN_PROGRESS", - "ROLLBACK_COMPLETED" + "ROLLBACK_COMPLETED", + "CANCELLED" ] }, "WorkflowExecutionsList":{ "type":"list", "member":{"shape":"WorkflowExecutionMetadata"} }, + "WorkflowNameArn":{ + "type":"string", + "pattern":"^arn:aws(?:-[a-z]+)*:imagebuilder:[a-z]{2,}(?:-[a-z]+)+-[0-9]+:(?:[0-9]{12}|aws):workflow/(build|test|distribution)/[a-z0-9-_]+/x\\.x\\.x$" + }, + "WorkflowParameter":{ + "type":"structure", + "required":[ + "name", + "value" + ], + "members":{ + "name":{ + "shape":"WorkflowParameterName", + "documentation":"

The name of the workflow parameter to set.

" + }, + "value":{ + "shape":"WorkflowParameterValueList", + "documentation":"

Sets the value for the named workflow parameter.

" + } + }, + "documentation":"

Contains a key/value pair that sets the named workflow parameter.

" + }, + "WorkflowParameterDescription":{ + "type":"string", + "max":1024, + "min":0, + "pattern":"[^\\x00]+" + }, + "WorkflowParameterDetail":{ + "type":"structure", + "required":[ + "name", + "type" + ], + "members":{ + "name":{ + "shape":"WorkflowParameterName", + "documentation":"

The name of this input parameter.

" + }, + "type":{ + "shape":"WorkflowParameterType", + "documentation":"

The type of input this parameter provides. The currently supported value is \"string\".

" + }, + "defaultValue":{ + "shape":"WorkflowParameterValueList", + "documentation":"

The default value of this parameter if no input is provided.

" + }, + "description":{ + "shape":"WorkflowParameterDescription", + "documentation":"

Describes this parameter.

" + } + }, + "documentation":"

Defines a parameter that's used to provide configuration details for the workflow.

" + }, + "WorkflowParameterDetailList":{ + "type":"list", + "member":{"shape":"WorkflowParameterDetail"} + }, + "WorkflowParameterList":{ + "type":"list", + "member":{"shape":"WorkflowParameter"}, + "min":1 + }, + "WorkflowParameterName":{ + "type":"string", + "max":128, + "min":1, + "pattern":"[^\\x00]+" + }, + "WorkflowParameterType":{ + "type":"string", + "max":20, + "min":1, + "pattern":"^string|integer|boolean|stringList$" + }, + "WorkflowParameterValue":{ + "type":"string", + "min":0, + "pattern":"[^\\x00]*" + }, + "WorkflowParameterValueList":{ + "type":"list", + "member":{"shape":"WorkflowParameterValue"} + }, + "WorkflowState":{ + "type":"structure", + "members":{ + "status":{ + "shape":"WorkflowStatus", + "documentation":"

The current state of the workflow.

" + }, + "reason":{ + "shape":"NonEmptyString", + "documentation":"

Describes how or why the workflow changed state.

" + } + }, + "documentation":"

A group of fields that describe the current status of workflow.

" + }, + "WorkflowStatus":{ + "type":"string", + "enum":["DEPRECATED"] + }, "WorkflowStepAction":{ "type":"string", "pattern":"^[A-Za-z][A-Za-z0-9-_]{1,99}$" }, + "WorkflowStepActionType":{ + "type":"string", + "enum":[ + "RESUME", + "STOP" + ] + }, "WorkflowStepCount":{"type":"integer"}, "WorkflowStepDescription":{ "type":"string", "max":500, "min":0 }, + "WorkflowStepExecution":{ + "type":"structure", + "members":{ + "stepExecutionId":{ + "shape":"WorkflowStepExecutionId", + "documentation":"

Uniquely identifies the workflow step that ran for the associated image build version.

" + }, + "imageBuildVersionArn":{ + "shape":"ImageBuildVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the image build version that ran the workflow.

" + }, + "workflowExecutionId":{ + "shape":"WorkflowExecutionId", + "documentation":"

Uniquely identifies the runtime instance of the workflow that contains the workflow step that ran for the associated image build version.

" + }, + "workflowBuildVersionArn":{ + "shape":"WorkflowBuildVersionArn", + "documentation":"

The ARN of the workflow resource that ran.

" + }, + "name":{ + "shape":"WorkflowStepName", + "documentation":"

The name of the workflow step.

" + }, + "action":{ + "shape":"WorkflowStepAction", + "documentation":"

The name of the step action.

" + }, + "startTime":{ + "shape":"DateTime", + "documentation":"

The timestamp when the workflow step started.

" + } + }, + "documentation":"

Contains runtime details for an instance of a workflow that ran for the associated image build version.

" + }, "WorkflowStepExecutionId":{ "type":"string", "pattern":"^step-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" }, + "WorkflowStepExecutionList":{ + "type":"list", + "member":{"shape":"WorkflowStepExecution"} + }, "WorkflowStepExecutionRollbackStatus":{ "type":"string", "enum":[ @@ -7225,7 +7919,8 @@ "SKIPPED", "RUNNING", "COMPLETED", - "FAILED" + "FAILED", + "CANCELLED" ] }, "WorkflowStepExecutionsList":{ @@ -7298,6 +7993,56 @@ "max":43200, "min":0 }, + "WorkflowSummary":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"WorkflowNameArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource.

" + }, + "name":{ + "shape":"ResourceName", + "documentation":"

The name of the workflow.

" + }, + "version":{ + "shape":"VersionNumber", + "documentation":"

The version of the workflow.

" + }, + "description":{ + "shape":"NonEmptyString", + "documentation":"

Describes the workflow.

" + }, + "changeDescription":{ + "shape":"NonEmptyString", + "documentation":"

The change description for the current version of the workflow resource.

" + }, + "type":{ + "shape":"WorkflowType", + "documentation":"

The image creation stage that this workflow applies to. Image Builder currently supports build and test stage workflows.

" + }, + "owner":{ + "shape":"NonEmptyString", + "documentation":"

The owner of the workflow resource.

" + }, + "state":{ + "shape":"WorkflowState", + "documentation":"

Describes the current state of the workflow resource.

" + }, + "dateCreated":{ + "shape":"DateTime", + "documentation":"

The original creation date of the workflow resource.

" + }, + "tags":{ + "shape":"TagMap", + "documentation":"

Contains a list of tags that are defined for the workflow.

" + } + }, + "documentation":"

Contains metadata about the workflow resource.

" + }, + "WorkflowSummaryList":{ + "type":"list", + "member":{"shape":"WorkflowSummary"} + }, "WorkflowType":{ "type":"string", "enum":[ @@ -7305,6 +8050,56 @@ "TEST", "DISTRIBUTION" ] + }, + "WorkflowVersion":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"WorkflowVersionArn", + "documentation":"

The Amazon Resource Name (ARN) of the workflow resource.

" + }, + "name":{ + "shape":"ResourceName", + "documentation":"

The name of the workflow.

" + }, + "version":{ + "shape":"VersionNumber", + "documentation":"

The semantic version of the workflow resource. The format includes three nodes: <major>.<minor>.<patch>.

" + }, + "description":{ + "shape":"NonEmptyString", + "documentation":"

Describes the workflow.

" + }, + "type":{ + "shape":"WorkflowType", + "documentation":"

The image creation stage that this workflow applies to. Image Builder currently supports build and test stage workflows.

" + }, + "owner":{ + "shape":"NonEmptyString", + "documentation":"

The owner of the workflow resource.

" + }, + "dateCreated":{ + "shape":"DateTime", + "documentation":"

The timestamp when Image Builder created the workflow version.

" + } + }, + "documentation":"

Contains details about this version of the workflow.

" + }, + "WorkflowVersionArn":{ + "type":"string", + "pattern":"^arn:aws(?:-[a-z]+)*:imagebuilder:[a-z]{2,}(?:-[a-z]+)+-[0-9]+:(?:[0-9]{12}|aws):workflow/(build|test|distribution)/[a-z0-9-_]+/[0-9]+\\.[0-9]+\\.[0-9]+$" + }, + "WorkflowVersionArnOrBuildVersionArn":{ + "type":"string", + "pattern":"^arn:aws(?:-[a-z]+)*:imagebuilder:[a-z]{2,}(?:-[a-z]+)+-[0-9]+:(?:[0-9]{12}|aws):workflow/(build|test|distribution)/[a-z0-9-_]+/(?:(?:([0-9]+|x)\\.([0-9]+|x)\\.([0-9]+|x))|(?:[0-9]+\\.[0-9]+\\.[0-9]+/[0-9]+))$" + }, + "WorkflowVersionList":{ + "type":"list", + "member":{"shape":"WorkflowVersion"} + }, + "WorkflowWildcardVersionArn":{ + "type":"string", + "pattern":"^arn:aws(?:-[a-z]+)*:imagebuilder:[a-z]{2,}(?:-[a-z]+)+-[0-9]+:(?:[0-9]{12}|aws):workflow/(build|test|distribution)/[a-z0-9-_]+/(?:[0-9]+|x)\\.(?:[0-9]+|x)\\.(?:[0-9]+|x)$" } }, "documentation":"

EC2 Image Builder is a fully managed Amazon Web Services service that makes it easier to automate the creation, management, and deployment of customized, secure, and up-to-date \"golden\" server images that are pre-installed and pre-configured with software and settings to meet specific IT standards.

" diff --git a/botocore/data/location/2020-11-19/service-2.json b/botocore/data/location/2020-11-19/service-2.json index 466d523584..4e2f70081a 100644 --- a/botocore/data/location/2020-11-19/service-2.json +++ b/botocore/data/location/2020-11-19/service-2.json @@ -1869,6 +1869,10 @@ "DestinationPosition" ], "members":{ + "ArrivalTime":{ + "shape":"Timestamp", + "documentation":"

Specifies the desired time of arrival. Uses the given time to calculate the route. Otherwise, the best time of day to travel with the best traffic conditions is used to calculate the route.

ArrivalTime is not supported Esri.

" + }, "CalculatorName":{ "shape":"ResourceName", "documentation":"

The name of the route calculator resource that you want to use to calculate the route.

", @@ -1889,7 +1893,7 @@ }, "DepartureTime":{ "shape":"Timestamp", - "documentation":"

Specifies the desired time of departure. Uses the given time to calculate the route. Otherwise, the best time of day to travel with the best traffic conditions is used to calculate the route.

Setting a departure time in the past returns a 400 ValidationException error.

 " + "documentation":"

Specifies the desired time of departure. Uses the given time to calculate the route. Otherwise, the best time of day to travel with the best traffic conditions is used to calculate the route.

" }, "DestinationPosition":{ "shape":"Position", @@ -1909,6 +1913,10 @@ "location":"querystring", "locationName":"key" }, + "OptimizeFor":{ + "shape":"OptimizationMode", + "documentation":"

Specifies the distance to optimize for when calculating a route.

" + }, "TravelMode":{ "shape":"TravelMode", "documentation":"

Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility. You can choose Car, Truck, Walking, Bicycle or Motorcycle as options for the TravelMode.

Bicycle and Motorcycle are only valid when using Grab as a data provider, and only within Southeast Asia.

Truck is not available for Grab.

For more details on the using Grab for routing, including areas of coverage, see GrabMaps in the Amazon Location Service Developer Guide.

The TravelMode you specify also determines how you specify route preferences:

Default Value: Car

" @@ -3627,7 +3635,7 @@ "members":{ "FilterGeometry":{ "shape":"TrackingFilterGeometry", - "documentation":"

The geomerty used to filter device positions.

" + "documentation":"

The geometry used to filter device positions.

" }, "MaxResults":{ "shape":"ListDevicePositionsRequestMaxResultsInteger", @@ -4330,6 +4338,13 @@ "min":1, "pattern":"^[-._\\w]+$" }, + "OptimizationMode":{ + "type":"string", + "enum":[ + "FastestRoute", + "ShortestRoute" + ] + }, "Place":{ "type":"structure", "required":["Geometry"], @@ -4375,6 +4390,10 @@ "shape":"String", "documentation":"

The name for a street or a road to identify a location. For example, Main Street.

" }, + "SubMunicipality":{ + "shape":"String", + "documentation":"

An area that's part of a larger municipality. For example, Blissville is a submunicipality in the Queen County in New York.

This property supported by Esri and OpenData. The Esri property is district, and the OpenData property is borough.

" + }, "SubRegion":{ "shape":"String", "documentation":"

A county, or an area that's part of a larger region. For example, Metro Vancouver.

" diff --git a/botocore/data/logs/2014-03-28/service-2.json b/botocore/data/logs/2014-03-28/service-2.json index 3495c1aa43..8ef3aa7cfa 100644 --- a/botocore/data/logs/2014-03-28/service-2.json +++ b/botocore/data/logs/2014-03-28/service-2.json @@ -59,7 +59,7 @@ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], - "documentation":"

Creates a delivery. A delivery is a connection between a logical delivery source and a logical delivery destination that you have already created.

Only some Amazon Web Services services support being configured as a delivery source using this operation. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

A delivery destination can represent a log group in CloudWatch Logs, an Amazon S3 bucket, or a delivery stream in Kinesis Data Firehose.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

You can't update an existing delivery. You can only create and delete deliveries.

" + "documentation":"

Creates a delivery. A delivery is a connection between a logical delivery source and a logical delivery destination that you have already created.

Only some Amazon Web Services services support being configured as a delivery source using this operation. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

A delivery destination can represent a log group in CloudWatch Logs, an Amazon S3 bucket, or a delivery stream in Kinesis Data Firehose.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

You can't update an existing delivery. You can only create and delete deliveries.

" }, "CreateExportTask":{ "name":"CreateExportTask", @@ -520,7 +520,7 @@ {"shape":"InvalidParameterException"}, {"shape":"ServiceUnavailableException"} ], - "documentation":"

This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions.

You can use the queryDefinitionNamePrefix parameter to limit the results to only the query definitions that have names that start with a certain string.

" + "documentation":"

This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions. You can retrieve query definitions from the current account or from a source account that is linked to the current account.

You can use the queryDefinitionNamePrefix parameter to limit the results to only the query definitions that have names that start with a certain string.

" }, "DescribeResourcePolicies":{ "name":"DescribeResourcePolicies", @@ -853,7 +853,7 @@ {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"} ], - "documentation":"

Creates or updates a logical delivery destination. A delivery destination is an Amazon Web Services resource that represents an Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, and Kinesis Data Firehose are supported as logs delivery destinations.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

Only some Amazon Web Services services support being configured as a delivery source. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

If you use this operation to update an existing delivery destination, all the current delivery destination parameters are overwritten with the new parameter values that you specify.

" + "documentation":"

Creates or updates a logical delivery destination. A delivery destination is an Amazon Web Services resource that represents an Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, and Kinesis Data Firehose are supported as logs delivery destinations.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

Only some Amazon Web Services services support being configured as a delivery source. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

If you use this operation to update an existing delivery destination, all the current delivery destination parameters are overwritten with the new parameter values that you specify.

" }, "PutDeliveryDestinationPolicy":{ "name":"PutDeliveryDestinationPolicy", @@ -887,7 +887,7 @@ {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"} ], - "documentation":"

Creates or updates a logical delivery source. A delivery source represents an Amazon Web Services resource that sends logs to an logs delivery destination. The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.

To configure logs delivery between a delivery destination and an Amazon Web Services service that is supported as a delivery source, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

Only some Amazon Web Services services support being configured as a delivery source. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

If you use this operation to update an existing delivery source, all the current delivery source parameters are overwritten with the new parameter values that you specify.

" + "documentation":"

Creates or updates a logical delivery source. A delivery source represents an Amazon Web Services resource that sends logs to an logs delivery destination. The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.

To configure logs delivery between a delivery destination and an Amazon Web Services service that is supported as a delivery source, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

Only some Amazon Web Services services support being configured as a delivery source. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

If you use this operation to update an existing delivery source, all the current delivery source parameters are overwritten with the new parameter values that you specify.

" }, "PutDestination":{ "name":"PutDestination", @@ -1014,6 +1014,24 @@ ], "documentation":"

Creates or updates a subscription filter and associates it with the specified log group. With subscription filters, you can subscribe to a real-time stream of log events ingested through PutLogEvents and have them delivered to a specific destination. When log events are sent to the receiving service, they are Base64 encoded and compressed with the GZIP format.

The following destinations are supported for subscription filters:

Each log group can have up to two subscription filters associated with it. If you are updating an existing filter, you must specify the correct name in filterName.

To perform a PutSubscriptionFilter operation for any destination except a Lambda function, you must also have the iam:PassRole permission.

" }, + "StartLiveTail":{ + "name":"StartLiveTail", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"StartLiveTailRequest"}, + "output":{"shape":"StartLiveTailResponse"}, + "errors":[ + {"shape":"AccessDeniedException"}, + {"shape":"InvalidParameterException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"LimitExceededException"}, + {"shape":"InvalidOperationException"} + ], + "documentation":"

Starts a Live Tail streaming session for one or more log groups. A Live Tail session returns a stream of log events that have been recently ingested in the log groups. For more information, see Use Live Tail to view logs in near real time.

The response to this operation is a response stream, over which the server sends live log events and the client receives them.

The following objects are sent over the stream:

You can end a session before it times out by closing the session stream or by closing the client that is receiving the stream. The session also ends if the established connection between the client and the server breaks.

", + "endpoint":{"hostPrefix":"streaming-"} + }, "StartQuery":{ "name":"StartQuery", "http":{ @@ -1516,7 +1534,7 @@ "members":{ "logGroupArnList":{ "shape":"LogGroupArnList", - "documentation":"

An array containing the ARNs of the log groups that this anomaly detector will watch. You must specify at least one ARN.

" + "documentation":"

An array containing the ARN of the log group that this anomaly detector will watch. You can specify only one log group ARN.

" }, "detectorName":{ "shape":"DetectorName", @@ -1571,7 +1589,7 @@ }, "logGroupClass":{ "shape":"LogGroupClass", - "documentation":"

Use this parameter to specify the log group class for this log group. There are two classes:

If you omit this parameter, the default of STANDARD is used.

For details about the features supported by each class, see Log classes

" + "documentation":"

Use this parameter to specify the log group class for this log group. There are two classes:

If you omit this parameter, the default of STANDARD is used.

After a log group is created, its class can't be changed.

For details about the features supported by each class, see Log classes

" } } }, @@ -1863,7 +1881,7 @@ "documentation":"

The tags that have been assigned to this delivery destination.

" } }, - "documentation":"

This structure contains information about one delivery destination in your account. A delivery destination is an Amazon Web Services resource that represents an Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, are supported as Kinesis Data Firehose delivery destinations.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

" + "documentation":"

This structure contains information about one delivery destination in your account. A delivery destination is an Amazon Web Services resource that represents an Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, are supported as Kinesis Data Firehose delivery destinations.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

" }, "DeliveryDestinationConfiguration":{ "type":"structure", @@ -1933,7 +1951,7 @@ "documentation":"

The tags that have been assigned to this delivery source.

" } }, - "documentation":"

This structure contains information about one delivery source in your account. A delivery source is an Amazon Web Services resource that sends logs to an Amazon Web Services destination. The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.

Only some Amazon Web Services services support being configured as a delivery source. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

" + "documentation":"

This structure contains information about one delivery source in your account. A delivery source is an Amazon Web Services resource that sends logs to an Amazon Web Services destination. The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.

Only some Amazon Web Services services support being configured as a delivery source. These services are listed as Supported [V2 Permissions] in the table at Enabling logging from Amazon Web Services services.

To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:

You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.

" }, "DeliverySourceName":{ "type":"string", @@ -3030,6 +3048,7 @@ "documentation":"

The sequence token is not valid. You can get the correct sequence token in the expectedSequenceToken field in the InvalidSequenceTokenException message.

PutLogEvents actions are now always accepted and never return InvalidSequenceTokenException regardless of receiving an invalid sequence token.

", "exception":true }, + "IsSampled":{"type":"boolean"}, "KmsKeyId":{ "type":"string", "max":256 @@ -3145,6 +3164,92 @@ "deprecated":true, "deprecatedMessage":"Please use the generic tagging API model ListTagsForResourceRequest and ListTagsForResourceResponse" }, + "LiveTailSessionLogEvent":{ + "type":"structure", + "members":{ + "logStreamName":{ + "shape":"LogStreamName", + "documentation":"

The name of the log stream that ingested this log event.

" + }, + "logGroupIdentifier":{ + "shape":"LogGroupIdentifier", + "documentation":"

The name or ARN of the log group that ingested this log event.

" + }, + "message":{ + "shape":"EventMessage", + "documentation":"

The log event message text.

" + }, + "timestamp":{ + "shape":"Timestamp", + "documentation":"

The timestamp specifying when this log event was created.

" + }, + "ingestionTime":{ + "shape":"Timestamp", + "documentation":"

The timestamp specifying when this log event was ingested into the log group.

" + } + }, + "documentation":"

This object contains the information for one log event returned in a Live Tail stream.

" + }, + "LiveTailSessionMetadata":{ + "type":"structure", + "members":{ + "sampled":{ + "shape":"IsSampled", + "documentation":"

If this is true, then more than 500 log events matched the request for this update, and the sessionResults includes a sample of 500 of those events.

If this is false, then 500 or fewer log events matched the request for this update, so no sampling was necessary. In this case, the sessionResults array includes all log events that matched your request during this time.

" + } + }, + "documentation":"

This object contains the metadata for one LiveTailSessionUpdate structure. It indicates whether that update includes only a sample of 500 log events out of a larger number of ingested log events, or if it contains all of the matching log events ingested during that second of time.

" + }, + "LiveTailSessionResults":{ + "type":"list", + "member":{"shape":"LiveTailSessionLogEvent"} + }, + "LiveTailSessionStart":{ + "type":"structure", + "members":{ + "requestId":{ + "shape":"RequestId", + "documentation":"

The unique ID generated by CloudWatch Logs to identify this Live Tail session request.

" + }, + "sessionId":{ + "shape":"SessionId", + "documentation":"

The unique ID generated by CloudWatch Logs to identify this Live Tail session.

" + }, + "logGroupIdentifiers":{ + "shape":"StartLiveTailLogGroupIdentifiers", + "documentation":"

An array of the names and ARNs of the log groups included in this Live Tail session.

" + }, + "logStreamNames":{ + "shape":"InputLogStreamNames", + "documentation":"

If your StartLiveTail operation request included a logStreamNames parameter that filtered the session to only include certain log streams, these streams are listed here.

" + }, + "logStreamNamePrefixes":{ + "shape":"InputLogStreamNames", + "documentation":"

If your StartLiveTail operation request included a logStreamNamePrefixes parameter that filtered the session to only include log streams that have names that start with certain prefixes, these prefixes are listed here.

" + }, + "logEventFilterPattern":{ + "shape":"FilterPattern", + "documentation":"

An optional pattern to filter the results to include only log events that match the pattern. For example, a filter pattern of error 404 displays only log events that include both error and 404.

For more information about filter pattern syntax, see Filter and Pattern Syntax.

" + } + }, + "documentation":"

This object contains information about this Live Tail session, including the log groups included and the log stream filters, if any.

", + "event":true + }, + "LiveTailSessionUpdate":{ + "type":"structure", + "members":{ + "sessionMetadata":{ + "shape":"LiveTailSessionMetadata", + "documentation":"

This object contains the session metadata for a Live Tail session.

" + }, + "sessionResults":{ + "shape":"LiveTailSessionResults", + "documentation":"

An array, where each member of the array includes the information for one log event in the Live Tail session.

A sessionResults array can include as many as 500 log events. If the number of log events matching the request exceeds 500 per second, the log events are sampled down to 500 log events to be included in each sessionUpdate structure.

" + } + }, + "documentation":"

This object contains the log events and metadata for a Live Tail session.

", + "event":true + }, "LogEvent":{ "type":"string", "min":1 @@ -4121,6 +4226,11 @@ }, "documentation":"

Represents the rejected events.

" }, + "RequestId":{ + "type":"string", + "max":256, + "min":0 + }, "ResourceAlreadyExistsException":{ "type":"structure", "members":{ @@ -4236,6 +4346,27 @@ "exception":true, "fault":true }, + "SessionId":{ + "type":"string", + "max":256, + "min":0 + }, + "SessionStreamingException":{ + "type":"structure", + "members":{ + "message":{"shape":"Message"} + }, + "documentation":"

his exception is returned if an unknown error occurs during a Live Tail session.

", + "exception":true + }, + "SessionTimeoutException":{ + "type":"structure", + "members":{ + "message":{"shape":"Message"} + }, + "documentation":"

This exception is returned in a Live Tail stream when the Live Tail session times out. Live Tail sessions time out after three hours.

", + "exception":true + }, "StandardUnit":{ "type":"string", "enum":[ @@ -4269,6 +4400,66 @@ ] }, "StartFromHead":{"type":"boolean"}, + "StartLiveTailLogGroupIdentifiers":{ + "type":"list", + "member":{"shape":"LogGroupIdentifier"}, + "max":10, + "min":1 + }, + "StartLiveTailRequest":{ + "type":"structure", + "required":["logGroupIdentifiers"], + "members":{ + "logGroupIdentifiers":{ + "shape":"StartLiveTailLogGroupIdentifiers", + "documentation":"

An array where each item in the array is a log group to include in the Live Tail session.

Specify each log group by its ARN.

If you specify an ARN, the ARN can't end with an asterisk (*).

You can include up to 10 log groups.

" + }, + "logStreamNames":{ + "shape":"InputLogStreamNames", + "documentation":"

If you specify this parameter, then only log events in the log streams that you specify here are included in the Live Tail session.

You can specify this parameter only if you specify only one log group in logGroupIdentifiers.

" + }, + "logStreamNamePrefixes":{ + "shape":"InputLogStreamNames", + "documentation":"

If you specify this parameter, then only log events in the log streams that have names that start with the prefixes that you specify here are included in the Live Tail session.

You can specify this parameter only if you specify only one log group in logGroupIdentifiers.

" + }, + "logEventFilterPattern":{ + "shape":"FilterPattern", + "documentation":"

An optional pattern to use to filter the results to include only log events that match the pattern. For example, a filter pattern of error 404 causes only log events that include both error and 404 to be included in the Live Tail stream.

Regular expression filter patterns are supported.

For more information about filter pattern syntax, see Filter and Pattern Syntax.

" + } + } + }, + "StartLiveTailResponse":{ + "type":"structure", + "members":{ + "responseStream":{ + "shape":"StartLiveTailResponseStream", + "documentation":"

An object that includes the stream returned by your request. It can include both log events and exceptions.

" + } + } + }, + "StartLiveTailResponseStream":{ + "type":"structure", + "members":{ + "sessionStart":{ + "shape":"LiveTailSessionStart", + "documentation":"

This object contains information about this Live Tail session, including the log groups included and the log stream filters, if any.

" + }, + "sessionUpdate":{ + "shape":"LiveTailSessionUpdate", + "documentation":"

This object contains the log events and session metadata.

" + }, + "SessionTimeoutException":{ + "shape":"SessionTimeoutException", + "documentation":"

This exception is returned in the stream when the Live Tail session times out. Live Tail sessions time out after three hours.

" + }, + "SessionStreamingException":{ + "shape":"SessionStreamingException", + "documentation":"

This exception is returned if an unknown error occurs.

" + } + }, + "documentation":"

This object includes the stream returned by your StartLiveTail request.

", + "eventstream":true + }, "StartQueryRequest":{ "type":"structure", "required":[