From 73a0fd12fbd555531939de0cbbd34ae0f8d4e306 Mon Sep 17 00:00:00 2001 From: awssdkgo Date: Fri, 30 Sep 2022 18:13:55 +0000 Subject: [PATCH] Release v1.44.109 (2022-09-30) === ### Service Client Updates * `service/codedeploy`: Updates service API and documentation * This release allows you to override the alarm configurations when creating a deployment. * `service/devops-guru`: Updates service API and documentation * `service/dlm`: Updates service API and documentation * `service/runtime.sagemaker`: Updates service API and documentation * `service/sagemaker`: Updates service API and documentation * A new parameter called ExplainerConfig is added to CreateEndpointConfig API to enable SageMaker Clarify online explainability feature. * `service/sso-oidc`: Updates service documentation --- CHANGELOG.md | 13 + aws/endpoints/defaults.go | 61 ++ aws/version.go | 2 +- models/apis/codedeploy/2014-10-06/api-2.json | 8 +- models/apis/codedeploy/2014-10-06/docs-2.json | 198 ++-- models/apis/devops-guru/2020-12-01/api-2.json | 26 +- .../apis/devops-guru/2020-12-01/docs-2.json | 43 +- models/apis/dlm/2018-01-12/api-2.json | 34 +- models/apis/dlm/2018-01-12/docs-2.json | 53 +- .../runtime.sagemaker/2017-05-13/api-2.json | 11 + .../runtime.sagemaker/2017-05-13/docs-2.json | 8 +- models/apis/sagemaker/2017-07-24/api-2.json | 239 ++++- models/apis/sagemaker/2017-07-24/docs-2.json | 166 ++++ models/apis/sso-oidc/2019-06-10/docs-2.json | 18 +- models/endpoints/endpoints.json | 23 + service/codedeploy/api.go | 588 ++++++----- service/codedeploy/doc.go | 44 +- service/codedeploy/errors.go | 34 +- service/devopsguru/api.go | 222 +++-- service/dlm/api.go | 270 ++++- service/dlm/doc.go | 6 +- service/sagemaker/api.go | 926 ++++++++++++++++++ service/sagemakerruntime/api.go | 19 + service/ssooidc/api.go | 45 +- service/ssooidc/doc.go | 58 +- 25 files changed, 2569 insertions(+), 546 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 08fd649b14..593622a0bb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,16 @@ +Release v1.44.109 (2022-09-30) +=== + +### Service Client Updates +* `service/codedeploy`: Updates service API and documentation + * This release allows you to override the alarm configurations when creating a deployment. +* `service/devops-guru`: Updates service API and documentation +* `service/dlm`: Updates service API and documentation +* `service/runtime.sagemaker`: Updates service API and documentation +* `service/sagemaker`: Updates service API and documentation + * A new parameter called ExplainerConfig is added to CreateEndpointConfig API to enable SageMaker Clarify online explainability feature. +* `service/sso-oidc`: Updates service documentation + Release v1.44.108 (2022-09-29) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index cddbe1bb00..1ec4a1ee86 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -5168,6 +5168,64 @@ var awsPartition = partition{ }: endpoint{}, }, }, + "codestar-notifications": service{ + Endpoints: serviceEndpoints{ + endpointKey{ + Region: "ap-east-1", + }: endpoint{}, + endpointKey{ + Region: "ap-northeast-1", + }: endpoint{}, + endpointKey{ + Region: "ap-northeast-2", + }: endpoint{}, + endpointKey{ + Region: "ap-south-1", + }: endpoint{}, + endpointKey{ + Region: "ap-southeast-1", + }: endpoint{}, + endpointKey{ + Region: "ap-southeast-2", + }: endpoint{}, + endpointKey{ + Region: "ca-central-1", + }: endpoint{}, + endpointKey{ + Region: "eu-central-1", + }: endpoint{}, + endpointKey{ + Region: "eu-north-1", + }: endpoint{}, + endpointKey{ + Region: "eu-west-1", + }: endpoint{}, + endpointKey{ + Region: "eu-west-2", + }: endpoint{}, + endpointKey{ + Region: "eu-west-3", + }: endpoint{}, + endpointKey{ + Region: "me-south-1", + }: endpoint{}, + endpointKey{ + Region: "sa-east-1", + }: endpoint{}, + endpointKey{ + Region: "us-east-1", + }: endpoint{}, + endpointKey{ + Region: "us-east-2", + }: endpoint{}, + endpointKey{ + Region: "us-west-1", + }: endpoint{}, + endpointKey{ + Region: "us-west-2", + }: endpoint{}, + }, + }, "cognito-identity": service{ Endpoints: serviceEndpoints{ endpointKey{ @@ -12960,6 +13018,9 @@ var awsPartition = partition{ endpointKey{ Region: "ap-southeast-2", }: endpoint{}, + endpointKey{ + Region: "ap-southeast-3", + }: endpoint{}, endpointKey{ Region: "ca-central-1", }: endpoint{}, diff --git a/aws/version.go b/aws/version.go index 5b66e4f423..c09688d1c0 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.44.108" +const SDKVersion = "1.44.109" diff --git a/models/apis/codedeploy/2014-10-06/api-2.json b/models/apis/codedeploy/2014-10-06/api-2.json index 3af4e41fea..6cce704403 100644 --- a/models/apis/codedeploy/2014-10-06/api-2.json +++ b/models/apis/codedeploy/2014-10-06/api-2.json @@ -206,6 +206,8 @@ {"shape":"DescriptionTooLongException"}, {"shape":"DeploymentLimitExceededException"}, {"shape":"InvalidTargetInstancesException"}, + {"shape":"InvalidAlarmConfigException"}, + {"shape":"AlarmsLimitExceededException"}, {"shape":"InvalidAutoRollbackConfigException"}, {"shape":"InvalidLoadBalancerInfoException"}, {"shape":"InvalidFileExistsBehaviorException"}, @@ -1264,7 +1266,8 @@ "targetInstances":{"shape":"TargetInstances"}, "autoRollbackConfiguration":{"shape":"AutoRollbackConfiguration"}, "updateOutdatedInstancesOnly":{"shape":"Boolean"}, - "fileExistsBehavior":{"shape":"FileExistsBehavior"} + "fileExistsBehavior":{"shape":"FileExistsBehavior"}, + "overrideAlarmConfiguration":{"shape":"AlarmConfiguration"} } }, "CreateDeploymentOutput":{ @@ -1511,7 +1514,8 @@ "deploymentStatusMessages":{"shape":"DeploymentStatusMessageList"}, "computePlatform":{"shape":"ComputePlatform"}, "externalId":{"shape":"ExternalId"}, - "relatedDeployments":{"shape":"RelatedDeployments"} + "relatedDeployments":{"shape":"RelatedDeployments"}, + "overrideAlarmConfiguration":{"shape":"AlarmConfiguration"} } }, "DeploymentIsNotInReadyStateException":{ diff --git a/models/apis/codedeploy/2014-10-06/docs-2.json b/models/apis/codedeploy/2014-10-06/docs-2.json index 900528e8a5..1ed6982140 100644 --- a/models/apis/codedeploy/2014-10-06/docs-2.json +++ b/models/apis/codedeploy/2014-10-06/docs-2.json @@ -1,13 +1,13 @@ { "version": "2.0", - "service": "AWS CodeDeploy

AWS CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances, on-premises instances running in your own facility, serverless AWS Lambda functions, or applications in an Amazon ECS service.

You can deploy a nearly unlimited variety of application content, such as an updated Lambda function, updated applications in an Amazon ECS service, code, web and configuration files, executables, packages, scripts, multimedia files, and so on. AWS CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use AWS CodeDeploy.

AWS CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.

AWS CodeDeploy Components

Use the information in this guide to help you work with the following AWS CodeDeploy components:

This guide also contains information to help you get details about the instances in your deployments, to make on-premises instances available for AWS CodeDeploy deployments, to get details about a Lambda function deployment, and to get details about Amazon ECS service deployments.

AWS CodeDeploy Information Resources

", + "service": "

CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances, on-premises instances running in your own facility, serverless Lambda functions, or applications in an Amazon ECS service.

You can deploy a nearly unlimited variety of application content, such as an updated Lambda function, updated applications in an Amazon ECS service, code, web and configuration files, executables, packages, scripts, multimedia files, and so on. CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use CodeDeploy.

CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.

CodeDeploy Components

Use the information in this guide to help you work with the following CodeDeploy components:

This guide also contains information to help you get details about the instances in your deployments, to make on-premises instances available for CodeDeploy deployments, to get details about a Lambda function deployment, and to get details about Amazon ECS service deployments.

CodeDeploy Information Resources

", "operations": { "AddTagsToOnPremisesInstances": "

Adds tags to on-premises instances.

", "BatchGetApplicationRevisions": "

Gets information about one or more application revisions. The maximum number of application revisions that can be returned is 25.

", "BatchGetApplications": "

Gets information about one or more applications. The maximum number of applications that can be returned is 100.

", "BatchGetDeploymentGroups": "

Gets information about one or more deployment groups.

", - "BatchGetDeploymentInstances": "

This method works, but is deprecated. Use BatchGetDeploymentTargets instead.

Returns an array of one or more instances associated with a deployment. This method works with EC2/On-premises and AWS Lambda compute platforms. The newer BatchGetDeploymentTargets works with all compute platforms. The maximum number of instances that can be returned is 25.

", - "BatchGetDeploymentTargets": "

Returns an array of one or more targets associated with a deployment. This method works with all compute types and should be used instead of the deprecated BatchGetDeploymentInstances. The maximum number of targets that can be returned is 25.

The type of targets returned depends on the deployment's compute platform or deployment method:

", + "BatchGetDeploymentInstances": "

This method works, but is deprecated. Use BatchGetDeploymentTargets instead.

Returns an array of one or more instances associated with a deployment. This method works with EC2/On-premises and Lambda compute platforms. The newer BatchGetDeploymentTargets works with all compute platforms. The maximum number of instances that can be returned is 25.

", + "BatchGetDeploymentTargets": "

Returns an array of one or more targets associated with a deployment. This method works with all compute types and should be used instead of the deprecated BatchGetDeploymentInstances. The maximum number of targets that can be returned is 25.

The type of targets returned depends on the deployment's compute platform or deployment method:

", "BatchGetDeployments": "

Gets information about one or more deployments. The maximum number of deployments that can be returned is 25.

", "BatchGetOnPremisesInstances": "

Gets information about one or more on-premises instances. The maximum number of on-premises instances that can be returned is 25.

", "ContinueDeployment": "

For a blue/green deployment, starts the process of rerouting traffic from instances in the original environment to instances in the replacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.)

", @@ -30,17 +30,17 @@ "GetDeploymentTarget": "

Returns information about a deployment target.

", "GetOnPremisesInstance": "

Gets information about an on-premises instance.

", "ListApplicationRevisions": "

Lists information about revisions for an application.

", - "ListApplications": "

Lists the applications registered with the IAM user or AWS account.

", - "ListDeploymentConfigs": "

Lists the deployment configurations with the IAM user or AWS account.

", - "ListDeploymentGroups": "

Lists the deployment groups for an application registered with the IAM user or AWS account.

", - "ListDeploymentInstances": "

The newer BatchGetDeploymentTargets should be used instead because it works with all compute types. ListDeploymentInstances throws an exception if it is used with a compute platform other than EC2/On-premises or AWS Lambda.

Lists the instance for a deployment associated with the IAM user or AWS account.

", + "ListApplications": "

Lists the applications registered with the IAM user or Amazon Web Services account.

", + "ListDeploymentConfigs": "

Lists the deployment configurations with the IAM user or Amazon Web Services account.

", + "ListDeploymentGroups": "

Lists the deployment groups for an application registered with the IAM user or Amazon Web Services account.

", + "ListDeploymentInstances": "

The newer BatchGetDeploymentTargets should be used instead because it works with all compute types. ListDeploymentInstances throws an exception if it is used with a compute platform other than EC2/On-premises or Lambda.

Lists the instance for a deployment associated with the IAM user or Amazon Web Services account.

", "ListDeploymentTargets": "

Returns an array of target IDs that are associated a deployment.

", - "ListDeployments": "

Lists the deployments in a deployment group for an application registered with the IAM user or AWS account.

", + "ListDeployments": "

Lists the deployments in a deployment group for an application registered with the IAM user or Amazon Web Services account.

", "ListGitHubAccountTokenNames": "

Lists the names of stored connections to GitHub accounts.

", "ListOnPremisesInstances": "

Gets a list of names for one or more on-premises instances.

Unless otherwise specified, both registered and deregistered on-premises instance names are listed. To list only registered or deregistered on-premises instance names, use the registration status parameter.

", "ListTagsForResource": "

Returns a list of tags for the resource identified by a specified Amazon Resource Name (ARN). Tags are used to organize and categorize your CodeDeploy resources.

", - "PutLifecycleEventHookExecutionStatus": "

Sets the result of a Lambda validation function. The function validates lifecycle hooks during a deployment that uses the AWS Lambda or Amazon ECS compute platform. For AWS Lambda deployments, the available lifecycle hooks are BeforeAllowTraffic and AfterAllowTraffic. For Amazon ECS deployments, the available lifecycle hooks are BeforeInstall, AfterInstall, AfterAllowTestTraffic, BeforeAllowTraffic, and AfterAllowTraffic. Lambda validation functions return Succeeded or Failed. For more information, see AppSpec 'hooks' Section for an AWS Lambda Deployment and AppSpec 'hooks' Section for an Amazon ECS Deployment.

", - "RegisterApplicationRevision": "

Registers with AWS CodeDeploy a revision for the specified application.

", + "PutLifecycleEventHookExecutionStatus": "

Sets the result of a Lambda validation function. The function validates lifecycle hooks during a deployment that uses the Lambda or Amazon ECS compute platform. For Lambda deployments, the available lifecycle hooks are BeforeAllowTraffic and AfterAllowTraffic. For Amazon ECS deployments, the available lifecycle hooks are BeforeInstall, AfterInstall, AfterAllowTestTraffic, BeforeAllowTraffic, and AfterAllowTraffic. Lambda validation functions return Succeeded or Failed. For more information, see AppSpec 'hooks' Section for an Lambda Deployment and AppSpec 'hooks' Section for an Amazon ECS Deployment.

", + "RegisterApplicationRevision": "

Registers with CodeDeploy a revision for the specified application.

", "RegisterOnPremisesInstance": "

Registers an on-premises instance.

Only one IAM ARN (an IAM session ARN or IAM user ARN) is supported in the request. You cannot use both.

", "RemoveTagsFromOnPremisesInstances": "

Removes one or more tags from one or more on-premises instances.

", "SkipWaitTimeForInstanceTermination": "

In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is complete.

", @@ -69,17 +69,19 @@ } }, "AlarmConfiguration": { - "base": "

Information about alarms associated with the deployment group.

", + "base": "

Information about alarms associated with a deployment or deployment group.

", "refs": { "CreateDeploymentGroupInput$alarmConfiguration": "

Information to add about Amazon CloudWatch alarms when the deployment group is created.

", + "CreateDeploymentInput$overrideAlarmConfiguration": "

Allows you to specify information about alarms associated with a deployment. The alarm configuration that you specify here will override the alarm configuration at the deployment group level. Consider overriding the alarm configuration if you have set up alarms at the deployment group level that are causing deployment failures. In this case, you would call CreateDeployment to create a new deployment that uses a previous application revision that is known to work, and set its alarm configuration to turn off alarm polling. Turning off alarm polling ensures that the new deployment proceeds without being blocked by the alarm that was generated by the previous, failed, deployment.

If you specify an overrideAlarmConfiguration, you need the UpdateDeploymentGroup IAM permission when calling CreateDeployment.

", "DeploymentGroupInfo$alarmConfiguration": "

A list of alarms associated with the deployment group.

", + "DeploymentInfo$overrideAlarmConfiguration": null, "UpdateDeploymentGroupInput$alarmConfiguration": "

Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.

" } }, "AlarmList": { "base": null, "refs": { - "AlarmConfiguration$alarms": "

A list of alarms configured for the deployment group. A maximum of 10 alarms can be added to a deployment group.

" + "AlarmConfiguration$alarms": "

A list of alarms configured for the deployment or deployment group. A maximum of 10 alarms can be added.

" } }, "AlarmName": { @@ -94,18 +96,18 @@ } }, "AppSpecContent": { - "base": "

A revision for an AWS Lambda or Amazon ECS deployment that is a YAML-formatted or JSON-formatted string. For AWS Lambda and Amazon ECS deployments, the revision is the same as the AppSpec file. This method replaces the deprecated RawString data type.

", + "base": "

A revision for an Lambda or Amazon ECS deployment that is a YAML-formatted or JSON-formatted string. For Lambda and Amazon ECS deployments, the revision is the same as the AppSpec file. This method replaces the deprecated RawString data type.

", "refs": { - "RevisionLocation$appSpecContent": "

The content of an AppSpec file for an AWS Lambda or Amazon ECS deployment. The content is formatted as JSON or YAML and stored as a RawString.

" + "RevisionLocation$appSpecContent": "

The content of an AppSpec file for an Lambda or Amazon ECS deployment. The content is formatted as JSON or YAML and stored as a RawString.

" } }, "ApplicationAlreadyExistsException": { - "base": "

An application with the specified name with the IAM user or AWS account already exists.

", + "base": "

An application with the specified name with the IAM user or Amazon Web Services account already exists.

", "refs": { } }, "ApplicationDoesNotExistException": { - "base": "

The application does not exist with the IAM user or AWS account.

", + "base": "

The application does not exist with the IAM user or Amazon Web Services account.

", "refs": { } }, @@ -133,25 +135,25 @@ "refs": { "ApplicationInfo$applicationName": "

The application name.

", "ApplicationsList$member": null, - "BatchGetApplicationRevisionsInput$applicationName": "

The name of an AWS CodeDeploy application about which to get revision information.

", + "BatchGetApplicationRevisionsInput$applicationName": "

The name of an CodeDeploy application about which to get revision information.

", "BatchGetApplicationRevisionsOutput$applicationName": "

The name of the application that corresponds to the revisions.

", - "BatchGetDeploymentGroupsInput$applicationName": "

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

", - "CreateApplicationInput$applicationName": "

The name of the application. This name must be unique with the applicable IAM user or AWS account.

", - "CreateDeploymentGroupInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", - "CreateDeploymentInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", - "DeleteApplicationInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", - "DeleteDeploymentGroupInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", + "BatchGetDeploymentGroupsInput$applicationName": "

The name of an CodeDeploy application associated with the applicable IAM or Amazon Web Services account.

", + "CreateApplicationInput$applicationName": "

The name of the application. This name must be unique with the applicable IAM or Amazon Web Services account.

", + "CreateDeploymentGroupInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", + "CreateDeploymentInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", + "DeleteApplicationInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", + "DeleteDeploymentGroupInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", "DeploymentGroupInfo$applicationName": "

The application name.

", "DeploymentInfo$applicationName": "

The application name.

", - "GetApplicationInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", + "GetApplicationInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", "GetApplicationRevisionInput$applicationName": "

The name of the application that corresponds to the revision.

", "GetApplicationRevisionOutput$applicationName": "

The name of the application that corresponds to the revision.

", - "GetDeploymentGroupInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", - "ListApplicationRevisionsInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", - "ListDeploymentGroupsInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", + "GetDeploymentGroupInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", + "ListApplicationRevisionsInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", + "ListDeploymentGroupsInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", "ListDeploymentGroupsOutput$applicationName": "

The application name.

", - "ListDeploymentsInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

If applicationName is specified, then deploymentGroupName must be specified. If it is not specified, then deploymentGroupName must not be specified.

", - "RegisterApplicationRevisionInput$applicationName": "

The name of an AWS CodeDeploy application associated with the IAM user or AWS account.

", + "ListDeploymentsInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

If applicationName is specified, then deploymentGroupName must be specified. If it is not specified, then deploymentGroupName must not be specified.

", + "RegisterApplicationRevisionInput$applicationName": "

The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.

", "UpdateApplicationInput$applicationName": "

The current name of the application you want to change.

", "UpdateApplicationInput$newApplicationName": "

The new name to give the application.

", "UpdateDeploymentGroupInput$applicationName": "

The application name that corresponds to the deployment group to update.

" @@ -165,7 +167,7 @@ "ApplicationRevisionSortBy": { "base": null, "refs": { - "ListApplicationRevisionsInput$sortBy": "

The column name to use to sort the list results:

If not specified or set to null, the results are returned in an arbitrary order.

" + "ListApplicationRevisionsInput$sortBy": "

The column name to use to sort the list results:

If not specified or set to null, the results are returned in an arbitrary order.

" } }, "ApplicationsInfoList": { @@ -231,9 +233,9 @@ "AutoScalingGroupList": { "base": null, "refs": { - "DeleteDeploymentGroupOutput$hooksNotCleanedUp": "

If the output contains no data, and the corresponding deployment group contained at least one Auto Scaling group, AWS CodeDeploy successfully removed all corresponding Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto Scaling group. If the output contains data, AWS CodeDeploy could not remove some Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto Scaling group.

", + "DeleteDeploymentGroupOutput$hooksNotCleanedUp": "

If the output contains no data, and the corresponding deployment group contained at least one Auto Scaling group, CodeDeploy successfully removed all corresponding Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto Scaling group. If the output contains data, CodeDeploy could not remove some Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto Scaling group.

", "DeploymentGroupInfo$autoScalingGroups": "

A list of associated Auto Scaling groups.

", - "UpdateDeploymentGroupOutput$hooksNotCleanedUp": "

If the output contains no data, and the corresponding deployment group contained at least one Auto Scaling group, AWS CodeDeploy successfully removed all corresponding Auto Scaling lifecycle event hooks from the AWS account. If the output contains data, AWS CodeDeploy could not remove some Auto Scaling lifecycle event hooks from the AWS account.

" + "UpdateDeploymentGroupOutput$hooksNotCleanedUp": "

If the output contains no data, and the corresponding deployment group contained at least one Auto Scaling group, CodeDeploy successfully removed all corresponding Auto Scaling lifecycle event hooks from the Amazon Web Services account. If the output contains data, CodeDeploy could not remove some Auto Scaling lifecycle event hooks from the Amazon Web Services account.

" } }, "AutoScalingGroupName": { @@ -248,7 +250,7 @@ "refs": { "CreateDeploymentGroupInput$autoScalingGroups": "

A list of associated Amazon EC2 Auto Scaling groups.

", "TargetInstances$autoScalingGroups": "

The names of one or more Auto Scaling groups to identify a replacement environment for a blue/green deployment.

", - "UpdateDeploymentGroupInput$autoScalingGroups": "

The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them. To keep the Auto Scaling groups, enter their names. To remove Auto Scaling groups, do not enter any Auto Scaling group names.

" + "UpdateDeploymentGroupInput$autoScalingGroups": "

The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them.

" } }, "BatchGetApplicationRevisionsInput": { @@ -348,9 +350,9 @@ "AlarmConfiguration$ignorePollAlarmFailure": "

Indicates whether a deployment should continue if information about the current state of alarms cannot be retrieved from Amazon CloudWatch. The default value is false.

", "ApplicationInfo$linkedToGitHub": "

True if the user has authenticated with GitHub for the specified application. Otherwise, false.

", "AutoRollbackConfiguration$enabled": "

Indicates whether a defined automatic rollback configuration is currently enabled.

", - "CreateDeploymentInput$ignoreApplicationStopFailures": "

If true, then if an ApplicationStop, BeforeBlockTraffic, or AfterBlockTraffic deployment lifecycle event to an instance fails, then the deployment continues to the next deployment lifecycle event. For example, if ApplicationStop fails, the deployment continues with DownloadBundle. If BeforeBlockTraffic fails, the deployment continues with BlockTraffic. If AfterBlockTraffic fails, the deployment continues with ApplicationStop.

If false or not specified, then if a lifecycle event fails during a deployment to an instance, that deployment fails. If deployment to that instance is part of an overall deployment and the number of healthy hosts is not less than the minimum number of healthy hosts, then a deployment to the next instance is attempted.

During a deployment, the AWS CodeDeploy agent runs the scripts specified for ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec file from the previous successful deployment. (All other scripts are run from the AppSpec file in the current deployment.) If one of these scripts contains an error and does not run successfully, the deployment can fail.

If the cause of the failure is a script from the last successful deployment that will never run successfully, create a new deployment and use ignoreApplicationStopFailures to specify that the ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic failures should be ignored.

", + "CreateDeploymentInput$ignoreApplicationStopFailures": "

If true, then if an ApplicationStop, BeforeBlockTraffic, or AfterBlockTraffic deployment lifecycle event to an instance fails, then the deployment continues to the next deployment lifecycle event. For example, if ApplicationStop fails, the deployment continues with DownloadBundle. If BeforeBlockTraffic fails, the deployment continues with BlockTraffic. If AfterBlockTraffic fails, the deployment continues with ApplicationStop.

If false or not specified, then if a lifecycle event fails during a deployment to an instance, that deployment fails. If deployment to that instance is part of an overall deployment and the number of healthy hosts is not less than the minimum number of healthy hosts, then a deployment to the next instance is attempted.

During a deployment, the CodeDeploy agent runs the scripts specified for ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec file from the previous successful deployment. (All other scripts are run from the AppSpec file in the current deployment.) If one of these scripts contains an error and does not run successfully, the deployment can fail.

If the cause of the failure is a script from the last successful deployment that will never run successfully, create a new deployment and use ignoreApplicationStopFailures to specify that the ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic failures should be ignored.

", "CreateDeploymentInput$updateOutdatedInstancesOnly": "

Indicates whether to deploy to all instances or only to instances that are not running the latest application revision.

", - "DeploymentInfo$ignoreApplicationStopFailures": "

If true, then if an ApplicationStop, BeforeBlockTraffic, or AfterBlockTraffic deployment lifecycle event to an instance fails, then the deployment continues to the next deployment lifecycle event. For example, if ApplicationStop fails, the deployment continues with DownloadBundle. If BeforeBlockTraffic fails, the deployment continues with BlockTraffic. If AfterBlockTraffic fails, the deployment continues with ApplicationStop.

If false or not specified, then if a lifecycle event fails during a deployment to an instance, that deployment fails. If deployment to that instance is part of an overall deployment and the number of healthy hosts is not less than the minimum number of healthy hosts, then a deployment to the next instance is attempted.

During a deployment, the AWS CodeDeploy agent runs the scripts specified for ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec file from the previous successful deployment. (All other scripts are run from the AppSpec file in the current deployment.) If one of these scripts contains an error and does not run successfully, the deployment can fail.

If the cause of the failure is a script from the last successful deployment that will never run successfully, create a new deployment and use ignoreApplicationStopFailures to specify that the ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic failures should be ignored.

", + "DeploymentInfo$ignoreApplicationStopFailures": "

If true, then if an ApplicationStop, BeforeBlockTraffic, or AfterBlockTraffic deployment lifecycle event to an instance fails, then the deployment continues to the next deployment lifecycle event. For example, if ApplicationStop fails, the deployment continues with DownloadBundle. If BeforeBlockTraffic fails, the deployment continues with BlockTraffic. If AfterBlockTraffic fails, the deployment continues with ApplicationStop.

If false or not specified, then if a lifecycle event fails during a deployment to an instance, that deployment fails. If deployment to that instance is part of an overall deployment and the number of healthy hosts is not less than the minimum number of healthy hosts, then a deployment to the next instance is attempted.

During a deployment, the CodeDeploy agent runs the scripts specified for ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec file from the previous successful deployment. (All other scripts are run from the AppSpec file in the current deployment.) If one of these scripts contains an error and does not run successfully, the deployment can fail.

If the cause of the failure is a script from the last successful deployment that will never run successfully, create a new deployment and use ignoreApplicationStopFailures to specify that the ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic failures should be ignored.

", "DeploymentInfo$updateOutdatedInstancesOnly": "

Indicates whether only instances that are not running the latest application revision are to be deployed to.

", "DeploymentInfo$instanceTerminationWaitTimeStarted": "

Indicates whether the wait period set for the termination of instances in the original environment has started. Status is 'false' if the KEEP_ALIVE option is specified. Otherwise, 'true' as soon as the termination wait period starts.

" } @@ -369,11 +371,11 @@ "CloudFormationResourceType": { "base": null, "refs": { - "CloudFormationTarget$resourceType": "

The resource type for the AWS CloudFormation blue/green deployment.

" + "CloudFormationTarget$resourceType": "

The resource type for the CloudFormation blue/green deployment.

" } }, "CloudFormationTarget": { - "base": "

Information about the target to be updated by an AWS CloudFormation blue/green deployment. This target type is used for all deployments initiated by a CloudFormation stack update.

", + "base": "

Information about the target to be updated by an CloudFormation blue/green deployment. This target type is used for all deployments initiated by a CloudFormation stack update.

", "refs": { "DeploymentTarget$cloudFormationTarget": null } @@ -491,12 +493,12 @@ } }, "DeploymentConfigAlreadyExistsException": { - "base": "

A deployment configuration with the specified name with the IAM user or AWS account already exists.

", + "base": "

A deployment configuration with the specified name with the IAM user or Amazon Web Services account already exists.

", "refs": { } }, "DeploymentConfigDoesNotExistException": { - "base": "

The deployment configuration does not exist with the IAM user or AWS account.

", + "base": "

The deployment configuration does not exist with the IAM user or Amazon Web Services account.

", "refs": { } }, @@ -527,14 +529,14 @@ "base": null, "refs": { "CreateDeploymentConfigInput$deploymentConfigName": "

The name of the deployment configuration to create.

", - "CreateDeploymentGroupInput$deploymentConfigName": "

If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.

CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or deployment group.

For more information about the predefined deployment configurations in AWS CodeDeploy, see Working with Deployment Configurations in CodeDeploy in the AWS CodeDeploy User Guide.

", - "CreateDeploymentInput$deploymentConfigName": "

The name of a deployment configuration associated with the IAM user or AWS account.

If not specified, the value configured in the deployment group is used as the default. If the deployment group does not have a deployment configuration associated with it, CodeDeployDefault.OneAtATime is used by default.

", - "DeleteDeploymentConfigInput$deploymentConfigName": "

The name of a deployment configuration associated with the IAM user or AWS account.

", + "CreateDeploymentGroupInput$deploymentConfigName": "

If specified, the deployment configuration name can be either one of the predefined configurations provided with CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.

CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or deployment group.

For more information about the predefined deployment configurations in CodeDeploy, see Working with Deployment Configurations in CodeDeploy in the CodeDeploy User Guide.

", + "CreateDeploymentInput$deploymentConfigName": "

The name of a deployment configuration associated with the IAM user or Amazon Web Services account.

If not specified, the value configured in the deployment group is used as the default. If the deployment group does not have a deployment configuration associated with it, CodeDeployDefault.OneAtATime is used by default.

", + "DeleteDeploymentConfigInput$deploymentConfigName": "

The name of a deployment configuration associated with the IAM user or Amazon Web Services account.

", "DeploymentConfigInfo$deploymentConfigName": "

The deployment configuration name.

", "DeploymentConfigsList$member": null, "DeploymentGroupInfo$deploymentConfigName": "

The deployment configuration name.

", "DeploymentInfo$deploymentConfigName": "

The deployment configuration name.

", - "GetDeploymentConfigInput$deploymentConfigName": "

The name of a deployment configuration associated with the IAM user or AWS account.

", + "GetDeploymentConfigInput$deploymentConfigName": "

The name of a deployment configuration associated with the IAM user or Amazon Web Services account.

", "UpdateDeploymentGroupInput$deploymentConfigName": "

The replacement deployment configuration name to use, if you want to change it.

" } }, @@ -552,21 +554,21 @@ "DeploymentCreator": { "base": null, "refs": { - "DeploymentInfo$creator": "

The means by which the deployment was created:

" + "DeploymentInfo$creator": "

The means by which the deployment was created:

" } }, "DeploymentDoesNotExistException": { - "base": "

The deployment with the IAM user or AWS account does not exist.

", + "base": "

The deployment with the IAM user or Amazon Web Services account does not exist.

", "refs": { } }, "DeploymentGroupAlreadyExistsException": { - "base": "

A deployment group with the specified name with the IAM user or AWS account already exists.

", + "base": "

A deployment group with the specified name with the IAM user or Amazon Web Services account already exists.

", "refs": { } }, "DeploymentGroupDoesNotExistException": { - "base": "

The named deployment group with the IAM user or AWS account does not exist.

", + "base": "

The named deployment group with the IAM user or Amazon Web Services account does not exist.

", "refs": { } }, @@ -628,13 +630,13 @@ "refs": { "BatchGetDeploymentInstancesInput$deploymentId": "

The unique ID of a deployment.

", "BatchGetDeploymentTargetsInput$deploymentId": "

The unique ID of a deployment.

", - "CloudFormationTarget$deploymentId": "

The unique ID of an AWS CloudFormation blue/green deployment.

", + "CloudFormationTarget$deploymentId": "

The unique ID of an CloudFormation blue/green deployment.

", "ContinueDeploymentInput$deploymentId": "

The unique ID of a blue/green deployment for which you want to start rerouting traffic to the replacement environment.

", "CreateDeploymentOutput$deploymentId": "

The unique ID of a deployment.

", "DeploymentInfo$deploymentId": "

The unique ID of a deployment.

", "DeploymentsList$member": null, "ECSTarget$deploymentId": "

The unique ID of a deployment.

", - "GetDeploymentInput$deploymentId": "

The unique ID of a deployment associated with the IAM user or AWS account.

", + "GetDeploymentInput$deploymentId": "

The unique ID of a deployment associated with the IAM user or Amazon Web Services account.

", "GetDeploymentInstanceInput$deploymentId": "

The unique ID of a deployment.

", "GetDeploymentTargetInput$deploymentId": "

The unique ID of a deployment.

", "InstanceSummary$deploymentId": "

The unique ID of a deployment.

", @@ -751,11 +753,11 @@ "DeploymentTargetList": { "base": null, "refs": { - "BatchGetDeploymentTargetsOutput$deploymentTargets": "

A list of target objects for a deployment. Each target object contains details about the target, such as its status and lifecycle events. The type of the target objects depends on the deployment' compute platform.

" + "BatchGetDeploymentTargetsOutput$deploymentTargets": "

A list of target objects for a deployment. Each target object contains details about the target, such as its status and lifecycle events. The type of the target objects depends on the deployment' compute platform.

" } }, "DeploymentTargetListSizeExceededException": { - "base": "

The maximum number of targets that can be associated with an Amazon ECS or AWS Lambda deployment was exceeded. The target list of both types of deployments must have exactly one item. This exception does not apply to EC2/On-premises deployments.

", + "base": "

The maximum number of targets that can be associated with an Amazon ECS or Lambda deployment was exceeded. The target list of both types of deployments must have exactly one item. This exception does not apply to EC2/On-premises deployments.

", "refs": { } }, @@ -833,7 +835,7 @@ "EC2TagFilterList": { "base": null, "refs": { - "CreateDeploymentGroupInput$ec2TagFilters": "

The Amazon EC2 tags on which to filter. The deployment group includes EC2 instances with any of the specified tags. Cannot be used in the same call as ec2TagSet.

", + "CreateDeploymentGroupInput$ec2TagFilters": "

The Amazon EC2 tags on which to filter. The deployment group includes Amazon EC2 instances with any of the specified tags. Cannot be used in the same call as ec2TagSet.

", "DeploymentGroupInfo$ec2TagFilters": "

The Amazon EC2 tags on which to filter. The deployment group includes EC2 instances with any of the specified tags.

", "EC2TagSetList$member": null, "TargetInstances$tagFilters": "

The tag filter key, type, and value used to identify Amazon EC2 instances in a replacement environment for a blue/green deployment. Cannot be used in the same call as ec2TagSet.

", @@ -847,18 +849,18 @@ } }, "EC2TagSet": { - "base": "

Information about groups of EC2 instance tags.

", + "base": "

Information about groups of Amazon EC2 instance tags.

", "refs": { - "CreateDeploymentGroupInput$ec2TagSet": "

Information about groups of tags applied to EC2 instances. The deployment group includes only EC2 instances identified by all the tag groups. Cannot be used in the same call as ec2TagFilters.

", - "DeploymentGroupInfo$ec2TagSet": "

Information about groups of tags applied to an EC2 instance. The deployment group includes only EC2 instances identified by all of the tag groups. Cannot be used in the same call as ec2TagFilters.

", - "TargetInstances$ec2TagSet": "

Information about the groups of EC2 instance tags that an instance must be identified by in order for it to be included in the replacement environment for a blue/green deployment. Cannot be used in the same call as tagFilters.

", - "UpdateDeploymentGroupInput$ec2TagSet": "

Information about groups of tags applied to on-premises instances. The deployment group includes only EC2 instances identified by all the tag groups.

" + "CreateDeploymentGroupInput$ec2TagSet": "

Information about groups of tags applied to Amazon EC2 instances. The deployment group includes only Amazon EC2 instances identified by all the tag groups. Cannot be used in the same call as ec2TagFilters.

", + "DeploymentGroupInfo$ec2TagSet": "

Information about groups of tags applied to an Amazon EC2 instance. The deployment group includes only Amazon EC2 instances identified by all of the tag groups. Cannot be used in the same call as ec2TagFilters.

", + "TargetInstances$ec2TagSet": "

Information about the groups of Amazon EC2 instance tags that an instance must be identified by in order for it to be included in the replacement environment for a blue/green deployment. Cannot be used in the same call as tagFilters.

", + "UpdateDeploymentGroupInput$ec2TagSet": "

Information about groups of tags applied to on-premises instances. The deployment group includes only Amazon EC2 instances identified by all the tag groups.

" } }, "EC2TagSetList": { "base": null, "refs": { - "EC2TagSet$ec2TagSetList": "

A list that contains other lists of EC2 instance tag groups. For an instance to be included in the deployment group, it must be identified by all of the tag groups in the list.

" + "EC2TagSet$ec2TagSetList": "

A list that contains other lists of Amazon EC2 instance tag groups. For an instance to be included in the deployment group, it must be identified by all of the tag groups in the list.

" } }, "ECSClusterName": { @@ -899,7 +901,7 @@ } }, "ECSTaskSet": { - "base": "

Information about a set of Amazon ECS tasks in an AWS CodeDeploy deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic. An AWS CodeDeploy application that uses the Amazon ECS compute platform deploys a containerized application in an Amazon ECS service as a task set.

", + "base": "

Information about a set of Amazon ECS tasks in an CodeDeploy deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic. An CodeDeploy application that uses the Amazon ECS compute platform deploys a containerized application in an Amazon ECS service as a task set.

", "refs": { "ECSTaskSetList$member": null } @@ -957,7 +959,7 @@ "ErrorCode": { "base": null, "refs": { - "ErrorInformation$code": "

For more information, see Error Codes for AWS CodeDeploy in the AWS CodeDeploy User Guide.

The error code:

" + "ErrorInformation$code": "

For more information, see Error Codes for CodeDeploy in the CodeDeploy User Guide.

The error code:

" } }, "ErrorInformation": { @@ -987,8 +989,8 @@ "FileExistsBehavior": { "base": null, "refs": { - "CreateDeploymentInput$fileExistsBehavior": "

Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

The fileExistsBehavior parameter takes any of the following values:

", - "DeploymentInfo$fileExistsBehavior": "

Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

" + "CreateDeploymentInput$fileExistsBehavior": "

Information about how CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

The fileExistsBehavior parameter takes any of the following values:

", + "DeploymentInfo$fileExistsBehavior": "

Information about how CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

" } }, "FilterValue": { @@ -1418,7 +1420,7 @@ } }, "InvalidFileExistsBehaviorException": { - "base": "

An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy handles files or directories that already exist in a deployment target location, but weren't part of the previous successful deployment. Valid values include \"DISALLOW,\" \"OVERWRITE,\" and \"RETAIN.\"

", + "base": "

An invalid fileExistsBehavior option was specified to determine how CodeDeploy handles files or directories that already exist in a deployment target location, but weren't part of the previous successful deployment. Valid values include \"DISALLOW,\" \"OVERWRITE,\" and \"RETAIN.\"

", "refs": { } }, @@ -1443,7 +1445,7 @@ } }, "InvalidIgnoreApplicationStopFailuresValueException": { - "base": "

The IgnoreApplicationStopFailures value is invalid. For AWS Lambda deployments, false is expected. For EC2/On-premises deployments, true or false is expected.

", + "base": "

The IgnoreApplicationStopFailures value is invalid. For Lambda deployments, false is expected. For EC2/On-premises deployments, true or false is expected.

", "refs": { } }, @@ -1588,7 +1590,7 @@ } }, "InvalidUpdateOutdatedInstancesOnlyValueException": { - "base": "

The UpdateOutdatedInstancesOnly value is invalid. For AWS Lambda deployments, false is expected. For EC2/On-premises deployments, true or false is expected.

", + "base": "

The UpdateOutdatedInstancesOnly value is invalid. For Lambda deployments, false is expected. For EC2/On-premises deployments, true or false is expected.

", "refs": { } }, @@ -1604,7 +1606,7 @@ "LambdaFunctionAlias": { "base": null, "refs": { - "LambdaFunctionInfo$functionAlias": "

The alias of a Lambda function. For more information, see AWS Lambda Function Aliases in the AWS Lambda Developer Guide.

" + "LambdaFunctionInfo$functionAlias": "

The alias of a Lambda function. For more information, see Lambda Function Aliases in the Lambda Developer Guide.

" } }, "LambdaFunctionInfo": { @@ -1620,9 +1622,9 @@ } }, "LambdaTarget": { - "base": "

Information about the target AWS Lambda function during an AWS Lambda deployment.

", + "base": "

Information about the target Lambda function during an Lambda deployment.

", "refs": { - "DeploymentTarget$lambdaTarget": "

Information about the target for a deployment that uses the AWS Lambda compute platform.

" + "DeploymentTarget$lambdaTarget": "

Information about the target for a deployment that uses the Lambda compute platform.

" } }, "LastDeploymentInfo": { @@ -1659,7 +1661,7 @@ "LifecycleEventList": { "base": null, "refs": { - "CloudFormationTarget$lifecycleEvents": "

The lifecycle events of the AWS CloudFormation blue/green deployment to this target application.

", + "CloudFormationTarget$lifecycleEvents": "

The lifecycle events of the CloudFormation blue/green deployment to this target application.

", "ECSTarget$lifecycleEvents": "

The lifecycle events of the deployment to this target Amazon ECS application.

", "InstanceSummary$lifecycleEvents": "

A list of lifecycle events for this instance.

", "InstanceTarget$lifecycleEvents": "

The lifecycle events of the deployment to this target instance.

", @@ -1676,7 +1678,7 @@ "base": null, "refs": { "LifecycleEvent$status": "

The deployment lifecycle event status:

", - "PutLifecycleEventHookExecutionStatusInput$status": "

The result of a Lambda function that validates a deployment lifecycle event. Succeeded and Failed are the only valid values for status.

" + "PutLifecycleEventHookExecutionStatusInput$status": "

The result of a Lambda function that validates a deployment lifecycle event. The values listed in Valid Values are valid for lifecycle statuses in general; however, only Succeeded and Failed can be passed successfully in your API call.

" } }, "LifecycleHookLimitExceededException": { @@ -1820,7 +1822,7 @@ "LogTail": { "base": null, "refs": { - "Diagnostics$logTail": "

The last portion of the diagnostic log.

If available, AWS CodeDeploy returns up to the last 4 KB of the diagnostic log.

" + "Diagnostics$logTail": "

The last portion of the diagnostic log.

If available, CodeDeploy returns up to the last 4 KB of the diagnostic log.

" } }, "Message": { @@ -1832,14 +1834,14 @@ "MinimumHealthyHosts": { "base": "

Information about minimum healthy instance.

", "refs": { - "CreateDeploymentConfigInput$minimumHealthyHosts": "

The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.

The type parameter takes either of the following values:

The value parameter takes an integer.

For example, to set a minimum of 95% healthy instance, specify a type of FLEET_PERCENT and a value of 95.

", + "CreateDeploymentConfigInput$minimumHealthyHosts": "

The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.

The type parameter takes either of the following values:

The value parameter takes an integer.

For example, to set a minimum of 95% healthy instance, specify a type of FLEET_PERCENT and a value of 95.

", "DeploymentConfigInfo$minimumHealthyHosts": "

Information about the number or percentage of minimum healthy instance.

" } }, "MinimumHealthyHostsType": { "base": null, "refs": { - "MinimumHealthyHosts$type": "

The minimum healthy instance type:

In an example of nine instances, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment is successful if six or more instances are deployed to successfully. Otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instances at a time. The deployment is successful if four or more instances are deployed to successfully. Otherwise, the deployment fails.

In a call to the GetDeploymentConfig, CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide.

" + "MinimumHealthyHosts$type": "

The minimum healthy instance type:

In an example of nine instances, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment is successful if six or more instances are deployed to successfully. Otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instances at a time. The deployment is successful if four or more instances are deployed to successfully. Otherwise, the deployment fails.

In a call to the GetDeploymentConfig, CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see CodeDeploy Instance Health in the CodeDeploy User Guide.

" } }, "MinimumHealthyHostsValue": { @@ -1906,9 +1908,9 @@ "OutdatedInstancesStrategy": { "base": null, "refs": { - "CreateDeploymentGroupInput$outdatedInstancesStrategy": "

Indicates what happens when new EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to UPDATE or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new EC2 instances.

If this option is set to IGNORE, CodeDeploy does not initiate a deployment to update the new EC2 instances. This may result in instances having different revisions.

", - "DeploymentGroupInfo$outdatedInstancesStrategy": "

Indicates what happens when new EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to UPDATE or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new EC2 instances.

If this option is set to IGNORE, CodeDeploy does not initiate a deployment to update the new EC2 instances. This may result in instances having different revisions.

", - "UpdateDeploymentGroupInput$outdatedInstancesStrategy": "

Indicates what happens when new EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to UPDATE or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new EC2 instances.

If this option is set to IGNORE, CodeDeploy does not initiate a deployment to update the new EC2 instances. This may result in instances having different revisions.

" + "CreateDeploymentGroupInput$outdatedInstancesStrategy": "

Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to UPDATE or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.

If this option is set to IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions.

", + "DeploymentGroupInfo$outdatedInstancesStrategy": "

Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to UPDATE or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.

If this option is set to IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions.

", + "UpdateDeploymentGroupInput$outdatedInstancesStrategy": "

Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to UPDATE or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.

If this option is set to IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions.

" } }, "Percentage": { @@ -1929,15 +1931,15 @@ } }, "RawString": { - "base": "

A revision for an AWS Lambda deployment that is a YAML-formatted or JSON-formatted string. For AWS Lambda deployments, the revision is the same as the AppSpec file.

", + "base": "

A revision for an Lambda deployment that is a YAML-formatted or JSON-formatted string. For Lambda deployments, the revision is the same as the AppSpec file.

", "refs": { - "RevisionLocation$string": "

Information about the location of an AWS Lambda deployment revision stored as a RawString.

" + "RevisionLocation$string": "

Information about the location of an Lambda deployment revision stored as a RawString.

" } }, "RawStringContent": { "base": null, "refs": { - "AppSpecContent$content": "

The YAML-formatted or JSON-formatted revision string.

For an AWS Lambda deployment, the content includes a Lambda function name, the alias for its original version, and the alias for its replacement version. The deployment shifts traffic from the original version of the Lambda function to the replacement version.

For an Amazon ECS deployment, the content includes the task name, information about the load balancer that serves traffic to the container, and more.

For both types of deployments, the content can specify Lambda functions that run at specified hooks, such as BeforeInstall, during a deployment.

", + "AppSpecContent$content": "

The YAML-formatted or JSON-formatted revision string.

For an Lambda deployment, the content includes a Lambda function name, the alias for its original version, and the alias for its replacement version. The deployment shifts traffic from the original version of the Lambda function to the replacement version.

For an Amazon ECS deployment, the content includes the task name, information about the load balancer that serves traffic to the container, and more.

For both types of deployments, the content can specify Lambda functions that run at specified hooks, such as BeforeInstall, during a deployment.

", "RawString$content": "

The YAML-formatted or JSON-formatted revision string. It includes information about which Lambda function to update and optional Lambda functions that validate deployment lifecycle events.

" } }, @@ -1992,7 +1994,7 @@ } }, "RevisionDoesNotExistException": { - "base": "

The named revision does not exist with the IAM user or AWS account.

", + "base": "

The named revision does not exist with the IAM user or Amazon Web Services account.

", "refs": { } }, @@ -2032,7 +2034,7 @@ "RevisionLocationType": { "base": null, "refs": { - "RevisionLocation$revisionType": "

The type of application revision:

" + "RevisionLocation$revisionType": "

The type of application revision:

" } }, "RevisionRequiredException": { @@ -2043,8 +2045,8 @@ "Role": { "base": null, "refs": { - "CreateDeploymentGroupInput$serviceRoleArn": "

A service role Amazon Resource Name (ARN) that allows AWS CodeDeploy to act on the user's behalf when interacting with AWS services.

", - "DeploymentGroupInfo$serviceRoleArn": "

A service role Amazon Resource Name (ARN) that grants CodeDeploy permission to make calls to AWS services on your behalf. For more information, see Create a Service Role for AWS CodeDeploy in the AWS CodeDeploy User Guide.

", + "CreateDeploymentGroupInput$serviceRoleArn": "

A service role Amazon Resource Name (ARN) that allows CodeDeploy to act on the user's behalf when interacting with Amazon Web Services services.

", + "DeploymentGroupInfo$serviceRoleArn": "

A service role Amazon Resource Name (ARN) that grants CodeDeploy permission to make calls to Amazon Web Services services on your behalf. For more information, see Create a Service Role for CodeDeploy in the CodeDeploy User Guide.

", "UpdateDeploymentGroupInput$serviceRoleArn": "

A replacement ARN for the service role, if you want to change it.

" } }, @@ -2206,7 +2208,7 @@ "TargetGroupInfo": { "base": "

Information about a target group in Elastic Load Balancing to use in a deployment. Instances are registered as targets in a target group, and traffic is routed to the target group.

", "refs": { - "ECSTaskSet$targetGroup": "

The target group associated with the task set. The target group is used by AWS CodeDeploy to manage traffic to a task set.

", + "ECSTaskSet$targetGroup": "

The target group associated with the task set. The target group is used by CodeDeploy to manage traffic to a task set.

", "TargetGroupInfoList$member": null } }, @@ -2249,7 +2251,7 @@ "TargetIdList": { "base": null, "refs": { - "BatchGetDeploymentTargetsInput$targetIds": "

The unique IDs of the deployment targets. The compute platform of the deployment determines the type of the targets and their formats. The maximum number of deployment target IDs you can specify is 25.

", + "BatchGetDeploymentTargetsInput$targetIds": "

The unique IDs of the deployment targets. The compute platform of the deployment determines the type of the targets and their formats. The maximum number of deployment target IDs you can specify is 25.

", "ListDeploymentTargetsOutput$targetIds": "

The unique IDs of deployment targets.

" } }, @@ -2270,10 +2272,10 @@ "TargetStatus": { "base": null, "refs": { - "CloudFormationTarget$status": "

The status of an AWS CloudFormation blue/green deployment's target application.

", + "CloudFormationTarget$status": "

The status of an CloudFormation blue/green deployment's target application.

", "ECSTarget$status": "

The status an Amazon ECS deployment's target ECS application.

", "InstanceTarget$status": "

The status an EC2/On-premises deployment's target instance.

", - "LambdaTarget$status": "

The status an AWS Lambda deployment's target Lambda function.

" + "LambdaTarget$status": "

The status an Lambda deployment's target Lambda function.

" } }, "ThrottlingException": { @@ -2284,14 +2286,14 @@ "Time": { "base": null, "refs": { - "CloudFormationTarget$lastUpdatedAt": "

The date and time when the target application was updated by an AWS CloudFormation blue/green deployment.

", + "CloudFormationTarget$lastUpdatedAt": "

The date and time when the target application was updated by an CloudFormation blue/green deployment.

", "ECSTarget$lastUpdatedAt": "

The date and time when the target Amazon ECS application was updated by a deployment.

", "InstanceTarget$lastUpdatedAt": "

The date and time when the target instance was updated by a deployment.

", "LambdaTarget$lastUpdatedAt": "

The date and time when the target Lambda function was updated by a deployment.

" } }, "TimeBasedCanary": { - "base": "

A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.

", + "base": "

A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.

", "refs": { "TrafficRoutingConfig$timeBasedCanary": "

A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.

" } @@ -2299,7 +2301,7 @@ "TimeBasedLinear": { "base": "

A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.

", "refs": { - "TrafficRoutingConfig$timeBasedLinear": "

A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.

" + "TrafficRoutingConfig$timeBasedLinear": "

A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

" } }, "TimeRange": { @@ -2316,9 +2318,9 @@ "DeploymentInfo$createTime": "

A timestamp that indicates when the deployment was created.

", "DeploymentInfo$startTime": "

A timestamp that indicates when the deployment was deployed to the deployment group.

In some cases, the reported value of the start time might be later than the complete time. This is due to differences in the clock settings of backend servers that participate in the deployment process.

", "DeploymentInfo$completeTime": "

A timestamp that indicates when the deployment was complete.

", - "GenericRevisionInfo$firstUsedTime": "

When the revision was first used by AWS CodeDeploy.

", - "GenericRevisionInfo$lastUsedTime": "

When the revision was last used by AWS CodeDeploy.

", - "GenericRevisionInfo$registerTime": "

When the revision was registered with AWS CodeDeploy.

", + "GenericRevisionInfo$firstUsedTime": "

When the revision was first used by CodeDeploy.

", + "GenericRevisionInfo$lastUsedTime": "

When the revision was last used by CodeDeploy.

", + "GenericRevisionInfo$registerTime": "

When the revision was registered with CodeDeploy.

", "InstanceInfo$registerTime": "

The time at which the on-premises instance was registered.

", "InstanceInfo$deregisterTime": "

If the on-premises instance was deregistered, the time at which the on-premises instance was deregistered.

", "InstanceSummary$lastUpdatedAt": "

A timestamp that indicates when the instance information was last updated.

", @@ -2338,10 +2340,10 @@ } }, "TrafficRoutingConfig": { - "base": "

The configuration that specifies how traffic is shifted from one version of a Lambda function to another version during an AWS Lambda deployment, or from one Amazon ECS task set to another during an Amazon ECS deployment.

", + "base": "

The configuration that specifies how traffic is shifted from one version of a Lambda function to another version during an Lambda deployment, or from one Amazon ECS task set to another during an Amazon ECS deployment.

", "refs": { "CreateDeploymentConfigInput$trafficRoutingConfig": "

The configuration that specifies how the deployment traffic is routed.

", - "DeploymentConfigInfo$trafficRoutingConfig": "

The configuration that specifies how the deployment traffic is routed. Used for deployments with a Lambda or ECS compute platform only.

" + "DeploymentConfigInfo$trafficRoutingConfig": "

The configuration that specifies how the deployment traffic is routed. Used for deployments with a Lambda or Amazon ECS compute platform only.

" } }, "TrafficRoutingType": { @@ -2353,7 +2355,7 @@ "TrafficWeight": { "base": null, "refs": { - "CloudFormationTarget$targetVersionWeight": "

The percentage of production traffic that the target version of an AWS CloudFormation blue/green deployment receives.

", + "CloudFormationTarget$targetVersionWeight": "

The percentage of production traffic that the target version of an CloudFormation blue/green deployment receives.

", "ECSTaskSet$trafficWeight": "

The percentage of traffic served by this task set.

", "LambdaFunctionInfo$targetVersionWeight": "

The percentage of production traffic that the target version of a Lambda function receives.

" } @@ -2367,9 +2369,9 @@ "TriggerConfigList": { "base": null, "refs": { - "CreateDeploymentGroupInput$triggerConfigurations": "

Information about triggers to create when the deployment group is created. For examples, see Create a Trigger for an AWS CodeDeploy Event in the AWS CodeDeploy User Guide.

", + "CreateDeploymentGroupInput$triggerConfigurations": "

Information about triggers to create when the deployment group is created. For examples, see Create a Trigger for an CodeDeploy Event in the CodeDeploy User Guide.

", "DeploymentGroupInfo$triggerConfigurations": "

Information about triggers associated with the deployment group.

", - "UpdateDeploymentGroupInput$triggerConfigurations": "

Information about triggers to change when the deployment group is updated. For examples, see Edit a Trigger in a CodeDeploy Deployment Group in the AWS CodeDeploy User Guide.

" + "UpdateDeploymentGroupInput$triggerConfigurations": "

Information about triggers to change when the deployment group is updated. For examples, see Edit a Trigger in a CodeDeploy Deployment Group in the CodeDeploy User Guide.

" } }, "TriggerEventType": { diff --git a/models/apis/devops-guru/2020-12-01/api-2.json b/models/apis/devops-guru/2020-12-01/api-2.json index ae0dcaadf5..00c0e1d081 100644 --- a/models/apis/devops-guru/2020-12-01/api-2.json +++ b/models/apis/devops-guru/2020-12-01/api-2.json @@ -1694,7 +1694,8 @@ "type":"structure", "required":["Sns"], "members":{ - "Sns":{"shape":"SnsChannelConfig"} + "Sns":{"shape":"SnsChannelConfig"}, + "Filters":{"shape":"NotificationFilterConfig"} } }, "NotificationChannelId":{ @@ -1703,6 +1704,29 @@ "min":36, "pattern":"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$" }, + "NotificationFilterConfig":{ + "type":"structure", + "members":{ + "Severities":{"shape":"InsightSeverities"}, + "MessageTypes":{"shape":"NotificationMessageTypes"} + } + }, + "NotificationMessageType":{ + "type":"string", + "enum":[ + "NEW_INSIGHT", + "CLOSED_INSIGHT", + "NEW_ASSOCIATION", + "SEVERITY_UPGRADED", + "NEW_RECOMMENDATION" + ] + }, + "NotificationMessageTypes":{ + "type":"list", + "member":{"shape":"NotificationMessageType"}, + "max":5, + "min":0 + }, "NumMetricsAnalyzed":{"type":"integer"}, "NumOpenProactiveInsights":{"type":"integer"}, "NumOpenReactiveInsights":{"type":"integer"}, diff --git a/models/apis/devops-guru/2020-12-01/docs-2.json b/models/apis/devops-guru/2020-12-01/docs-2.json index 39a9fd0d05..e81600efaf 100644 --- a/models/apis/devops-guru/2020-12-01/docs-2.json +++ b/models/apis/devops-guru/2020-12-01/docs-2.json @@ -211,11 +211,11 @@ "AppBoundaryKey": { "base": null, "refs": { - "TagCollection$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", - "TagCollectionFilter$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", - "TagCostEstimationResourceCollectionFilter$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", - "TagHealth$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", - "UpdateTagCollectionFilter$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" + "TagCollection$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", + "TagCollectionFilter$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", + "TagCostEstimationResourceCollectionFilter$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", + "TagHealth$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", + "UpdateTagCollectionFilter$AppBoundaryKey": "

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" } }, "AssociatedResourceArns": { @@ -760,6 +760,7 @@ "InsightSeverities": { "base": null, "refs": { + "NotificationFilterConfig$Severities": "

The severity levels that you want to receive notifications for. For example, you can choose to receive notifications only for insights with HIGH and MEDIUM severity levels. For more information, see Understanding insight severities.

", "SearchInsightsFilters$Severities": "

An array of severity values used to search for insights.

", "SearchOrganizationInsightsFilters$Severities": "

An array of severity values used to search for insights.

" } @@ -1105,6 +1106,24 @@ "RemoveNotificationChannelRequest$Id": "

The ID of the notification channel to be removed.

" } }, + "NotificationFilterConfig": { + "base": "

The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. You can choose to specify which events or message types to receive notifications for. You can also choose to specify which severity levels to receive notifications for.

", + "refs": { + "NotificationChannelConfig$Filters": "

The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. If you do not provide filter configurations, the default configurations are to receive notifications for all message types of High or Medium severity.

" + } + }, + "NotificationMessageType": { + "base": null, + "refs": { + "NotificationMessageTypes$member": null + } + }, + "NotificationMessageTypes": { + "base": null, + "refs": { + "NotificationFilterConfig$MessageTypes": "

The events that you want to receive notifications for. For example, you can choose to receive notifications only when the severity level is upgraded or a new insight is created.

" + } + }, "NumMetricsAnalyzed": { "base": null, "refs": { @@ -1912,7 +1931,7 @@ } }, "TagCollection": { - "base": "

A collection of Amazon Web Services stags.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", + "base": "

A collection of Amazon Web Services tags.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", "refs": { "TagCollections$member": null } @@ -1926,13 +1945,13 @@ "TagCollectionFilters": { "base": null, "refs": { - "ResourceCollectionFilter$Tags": "

The Amazon Web Services tags used to filter the resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" + "ResourceCollectionFilter$Tags": "

The Amazon Web Services tags used to filter the resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" } }, "TagCollections": { "base": null, "refs": { - "ResourceCollection$Tags": "

The Amazon Web Services tags that are used by resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" + "ResourceCollection$Tags": "

The Amazon Web Services tags that are used by resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" } }, "TagCostEstimationResourceCollectionFilter": { @@ -1944,7 +1963,7 @@ "TagCostEstimationResourceCollectionFilters": { "base": null, "refs": { - "CostEstimationResourceCollectionFilter$Tags": "

The Amazon Web Services tags used to filter the resource collection that is used for a cost estimate.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" + "CostEstimationResourceCollectionFilter$Tags": "

The Amazon Web Services tags used to filter the resource collection that is used for a cost estimate.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" } }, "TagHealth": { @@ -1956,8 +1975,8 @@ "TagHealths": { "base": null, "refs": { - "DescribeOrganizationResourceCollectionHealthResponse$Tags": "

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", - "DescribeResourceCollectionHealthResponse$Tags": "

The Amazon Web Services tags that are used by resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" + "DescribeOrganizationResourceCollectionHealthResponse$Tags": "

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

", + "DescribeResourceCollectionHealthResponse$Tags": "

The Amazon Web Services tags that are used by resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" } }, "TagValue": { @@ -2100,7 +2119,7 @@ "UpdateTagCollectionFilters": { "base": null, "refs": { - "UpdateResourceCollectionFilter$Tags": "

The updated Amazon Web Services tags used to filter the resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application or Devops-guru-rds-application. While keys are case-sensitive, the case of key characters don't matter to DevOps Guru. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" + "UpdateResourceCollectionFilter$Tags": "

The updated Amazon Web Services tags used to filter the resources in the resource collection.

Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.

Each Amazon Web Services tag has two parts.

Together these are known as key-value pairs.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

" } }, "UpdateTagValues": { diff --git a/models/apis/dlm/2018-01-12/api-2.json b/models/apis/dlm/2018-01-12/api-2.json index 8542155633..9c88978be7 100644 --- a/models/apis/dlm/2018-01-12/api-2.json +++ b/models/apis/dlm/2018-01-12/api-2.json @@ -152,6 +152,20 @@ "min":0, "pattern":"[0-9A-Za-z _-]+" }, + "ArchiveRetainRule":{ + "type":"structure", + "required":["RetentionArchiveTier"], + "members":{ + "RetentionArchiveTier":{"shape":"RetentionArchiveTier"} + } + }, + "ArchiveRule":{ + "type":"structure", + "required":["RetainRule"], + "members":{ + "RetainRule":{"shape":"ArchiveRetainRule"} + } + }, "AvailabilityZone":{ "type":"string", "max":16, @@ -612,6 +626,14 @@ "min":1 }, "RetainRule":{ + "type":"structure", + "members":{ + "Count":{"shape":"StandardTierRetainRuleCount"}, + "Interval":{"shape":"StandardTierRetainRuleInterval"}, + "IntervalUnit":{"shape":"RetentionIntervalUnitValues"} + } + }, + "RetentionArchiveTier":{ "type":"structure", "members":{ "Count":{"shape":"Count"}, @@ -640,7 +662,8 @@ "FastRestoreRule":{"shape":"FastRestoreRule"}, "CrossRegionCopyRules":{"shape":"CrossRegionCopyRules"}, "ShareRules":{"shape":"ShareRules"}, - "DeprecateRule":{"shape":"DeprecateRule"} + "DeprecateRule":{"shape":"DeprecateRule"}, + "ArchiveRule":{"shape":"ArchiveRule"} } }, "ScheduleList":{ @@ -688,6 +711,15 @@ "max":50, "min":0 }, + "StandardTierRetainRuleCount":{ + "type":"integer", + "max":1000, + "min":0 + }, + "StandardTierRetainRuleInterval":{ + "type":"integer", + "min":0 + }, "StatusMessage":{ "type":"string", "max":500, diff --git a/models/apis/dlm/2018-01-12/docs-2.json b/models/apis/dlm/2018-01-12/docs-2.json index ac9896e199..2572e269df 100644 --- a/models/apis/dlm/2018-01-12/docs-2.json +++ b/models/apis/dlm/2018-01-12/docs-2.json @@ -1,15 +1,15 @@ { "version": "2.0", - "service": "Amazon Data Lifecycle Manager

With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create lifecycle policies, which are used to automate operations on the specified resources.

Amazon DLM supports Amazon EBS volumes and snapshots. For information about using Amazon DLM with Amazon EBS, see Automating the Amazon EBS Snapshot Lifecycle in the Amazon EC2 User Guide.

", + "service": "Amazon Data Lifecycle Manager

With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create lifecycle policies, which are used to automate operations on the specified resources.

Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. For information about using Amazon Data Lifecycle Manager with Amazon EBS, see Amazon Data Lifecycle Manager in the Amazon EC2 User Guide.

", "operations": { "CreateLifecyclePolicy": "

Creates a policy to manage the lifecycle of the specified Amazon Web Services resources. You can create up to 100 lifecycle policies.

", - "DeleteLifecyclePolicy": "

Deletes the specified lifecycle policy and halts the automated operations that the policy specified.

", + "DeleteLifecyclePolicy": "

Deletes the specified lifecycle policy and halts the automated operations that the policy specified.

For more information about deleting a policy, see Delete lifecycle policies.

", "GetLifecyclePolicies": "

Gets summary information about all or the specified data lifecycle policies.

To get complete information about a policy, use GetLifecyclePolicy.

", "GetLifecyclePolicy": "

Gets detailed information about the specified lifecycle policy.

", "ListTagsForResource": "

Lists the tags for the specified resource.

", "TagResource": "

Adds the specified tags to the specified resource.

", "UntagResource": "

Removes the specified tags from the specified resource.

", - "UpdateLifecyclePolicy": "

Updates the specified lifecycle policy.

" + "UpdateLifecyclePolicy": "

Updates the specified lifecycle policy.

For more information about updating a policy, see Modify lifecycle policies.

" }, "shapes": { "Action": { @@ -30,6 +30,18 @@ "Action$Name": "

A descriptive name for the action.

" } }, + "ArchiveRetainRule": { + "base": "

[Snapshot policies only] Specifies information about the archive storage tier retention period.

", + "refs": { + "ArchiveRule$RetainRule": "

Information about the retention period for the snapshot archiving rule.

" + } + }, + "ArchiveRule": { + "base": "

[Snapshot policies only] Specifies a snapshot archiving rule for a schedule.

", + "refs": { + "Schedule$ArchiveRule": "

[Snapshot policies that target volumes only] The snapshot archiving rule for the schedule. When you specify an archiving rule, snapshots are automatically moved from the standard tier to the archive tier once the schedule's retention threshold is met. Snapshots are then retained in the archive tier for the archive retention period that you specify.

For more information about using snapshot archiving, see Considerations for snapshot lifecycle policies.

" + } + }, "AvailabilityZone": { "base": null, "refs": { @@ -73,7 +85,7 @@ "refs": { "DeprecateRule$Count": "

If the schedule has a count-based retention rule, this parameter specifies the number of oldest AMIs to deprecate. The count must be less than or equal to the schedule's retention count, and it can't be greater than 1000.

", "FastRestoreRule$Count": "

The number of snapshots to be enabled with fast snapshot restore.

", - "RetainRule$Count": "

The number of snapshots to retain for each volume, up to a maximum of 1000.

" + "RetentionArchiveTier$Count": "

The maximum number of snapshots to retain in the archive storage tier for each volume. The count must ensure that each snapshot remains in the archive tier for at least 90 days. For example, if the schedule creates snapshots every 30 days, you must specify a count of 3 or more to ensure that each snapshot is archived for at least 90 days.

" } }, "CreateLifecyclePolicyRequest": { @@ -87,7 +99,7 @@ } }, "CreateRule": { - "base": "

[Snapshot and AMI policies only] Specifies when the policy should create snapshots or AMIs.

You must specify either a Cron expression or an interval, interval unit, and start time. You cannot specify both.

", + "base": "

[Snapshot and AMI policies only] Specifies when the policy should create snapshots or AMIs.

", "refs": { "Schedule$CreateRule": "

The creation rule.

" } @@ -233,7 +245,7 @@ } }, "FastRestoreRule": { - "base": "

[Snapshot policies only] Specifies a rule for enabling fast snapshot restore for snapshots created by snaspshot policies. You can enable fast snapshot restore based on either a count or a time interval.

", + "base": "

[Snapshot policies only] Specifies a rule for enabling fast snapshot restore for snapshots created by snapshot policies. You can enable fast snapshot restore based on either a count or a time interval.

", "refs": { "Schedule$FastRestoreRule": "

[Snapshot policies only] The rule for enabling fast snapshot restore.

" } @@ -279,7 +291,7 @@ "CrossRegionCopyRetainRule$Interval": "

The amount of time to retain a cross-Region snapshot or AMI copy. The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.

", "DeprecateRule$Interval": "

If the schedule has an age-based retention rule, this parameter specifies the period after which to deprecate AMIs created by the schedule. The period must be less than or equal to the schedule's retention period, and it can't be greater than 10 years. This is equivalent to 120 months, 520 weeks, or 3650 days.

", "FastRestoreRule$Interval": "

The amount of time to enable fast snapshot restore. The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.

", - "RetainRule$Interval": "

The amount of time to retain each snapshot. The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.

", + "RetentionArchiveTier$Interval": "

Specifies the period of time to retain snapshots in the archive tier. After this period expires, the snapshot is permanently deleted.

", "ShareRule$UnshareInterval": "

The period after which snapshots that are shared with other Amazon Web Services accounts are automatically unshared.

" } }, @@ -353,7 +365,7 @@ } }, "Parameters": { - "base": "

[Snapshot and AMI policies only] Specifies optional parameters for snapshot and AMI policies. The set of valid parameters depends on the combination of policy type and target resource type.

If you choose to exclude boot volumes and you specify tags that consequently exclude all of the additional data volumes attached to an instance, then Amazon DLM will not create any snapshots for the affected instance, and it will emit a SnapshotsCreateFailed Amazon CloudWatch metric. For more information, see Monitor your policies using Amazon CloudWatch.

", + "base": "

[Snapshot and AMI policies only] Specifies optional parameters for snapshot and AMI policies. The set of valid parameters depends on the combination of policy type and target resource type.

If you choose to exclude boot volumes and you specify tags that consequently exclude all of the additional data volumes attached to an instance, then Amazon Data Lifecycle Manager will not create any snapshots for the affected instance, and it will emit a SnapshotsCreateFailed Amazon CloudWatch metric. For more information, see Monitor your policies using Amazon CloudWatch.

", "refs": { "PolicyDetails$Parameters": "

[Snapshot and AMI policies only] A set of optional parameters for snapshot and AMI lifecycle policies.

If you are modifying a policy that was created or previously modified using the Amazon Data Lifecycle Manager console, then you must include this parameter and specify either the default values or the new values that you require. You can't omit this parameter or set its values to null.

" } @@ -441,11 +453,17 @@ } }, "RetainRule": { - "base": "

[Snapshot and AMI policies only] Specifies a retention rule for snapshots created by snapshot policies or for AMIs created by AMI policies. You can retain snapshots based on either a count or a time interval.

You must specify either Count, or Interval and IntervalUnit.

", + "base": "

[Snapshot and AMI policies only] Specifies a retention rule for snapshots created by snapshot policies, or for AMIs created by AMI policies.

For snapshot policies that have an ArchiveRule, this retention rule applies to standard tier retention. When the retention threshold is met, snapshots are moved from the standard to the archive tier.

For snapshot policies that do not have an ArchiveRule, snapshots are permanently deleted when this retention threshold is met.

You can retain snapshots based on either a count or a time interval.

", "refs": { "Schedule$RetainRule": "

The retention rule for snapshots or AMIs created by the policy.

" } }, + "RetentionArchiveTier": { + "base": "

[Snapshot policies only] Describes the retention rule for archived snapshots. Once the archive retention threshold is met, the snapshots are permanently deleted from the archive tier.

The archive retention rule must retain snapshots in the archive tier for a minimum of 90 days.

For count-based schedules, you must specify Count. For age-based schedules, you must specify Interval and IntervalUnit.

For more information about using snapshot archiving, see Considerations for snapshot lifecycle policies.

", + "refs": { + "ArchiveRetainRule$RetentionArchiveTier": "

Information about retention period in the Amazon EBS Snapshots Archive. For more information, see Archive Amazon EBS snapshots.

" + } + }, "RetentionIntervalUnitValues": { "base": null, "refs": { @@ -453,7 +471,8 @@ "CrossRegionCopyRetainRule$IntervalUnit": "

The unit of time for time-based retention. For example, to retain a cross-Region copy for 3 months, specify Interval=3 and IntervalUnit=MONTHS.

", "DeprecateRule$IntervalUnit": "

The unit of time in which to measure the Interval.

", "FastRestoreRule$IntervalUnit": "

The unit of time for enabling fast snapshot restore.

", - "RetainRule$IntervalUnit": "

The unit of time for time-based retention.

", + "RetainRule$IntervalUnit": "

The unit of time for time-based retention. For example, to retain snapshots for 3 months, specify Interval=3 and IntervalUnit=MONTHS. Once the snapshot has been retained for 3 months, it is deleted, or it is moved to the archive tier if you have specified an ArchiveRule.

", + "RetentionArchiveTier$IntervalUnit": "

The unit of time in which to measure the Interval. For example, to retain a snapshots in the archive tier for 6 months, specify Interval=6 and IntervalUnit=MONTHS.

", "ShareRule$UnshareIntervalUnit": "

The unit of time for the automatic unsharing interval.

" } }, @@ -506,6 +525,18 @@ "EventParameters$SnapshotOwner": "

The IDs of the Amazon Web Services accounts that can trigger policy by sharing snapshots with your account. The policy only runs if one of the specified Amazon Web Services accounts shares a snapshot with your account.

" } }, + "StandardTierRetainRuleCount": { + "base": null, + "refs": { + "RetainRule$Count": "

The number of snapshots to retain for each volume, up to a maximum of 1000. For example if you want to retain a maximum of three snapshots, specify 3. When the fourth snapshot is created, the oldest retained snapshot is deleted, or it is moved to the archive tier if you have specified an ArchiveRule.

" + } + }, + "StandardTierRetainRuleInterval": { + "base": null, + "refs": { + "RetainRule$Interval": "

The amount of time to retain each snapshot. The maximum is 100 years. This is equivalent to 1200 months, 5200 weeks, or 36500 days.

" + } + }, "StatusMessage": { "base": null, "refs": { @@ -622,7 +653,7 @@ "TimesList": { "base": null, "refs": { - "CreateRule$Times": "

The time, in UTC, to start the operation. The supported format is hh:mm.

The operation occurs within a one-hour window following the specified time. If you do not specify a time, Amazon DLM selects a time within the next 24 hours.

" + "CreateRule$Times": "

The time, in UTC, to start the operation. The supported format is hh:mm.

The operation occurs within a one-hour window following the specified time. If you do not specify a time, Amazon Data Lifecycle Manager selects a time within the next 24 hours.

" } }, "Timestamp": { diff --git a/models/apis/runtime.sagemaker/2017-05-13/api-2.json b/models/apis/runtime.sagemaker/2017-05-13/api-2.json index 39d886a5fb..f8a7010c6b 100644 --- a/models/apis/runtime.sagemaker/2017-05-13/api-2.json +++ b/models/apis/runtime.sagemaker/2017-05-13/api-2.json @@ -57,6 +57,12 @@ "pattern":"\\p{ASCII}*", "sensitive":true }, + "EnableExplanationsHeader":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, "EndpointName":{ "type":"string", "max":63, @@ -201,6 +207,11 @@ "shape":"InferenceId", "location":"header", "locationName":"X-Amzn-SageMaker-Inference-Id" + }, + "EnableExplanations":{ + "shape":"EnableExplanationsHeader", + "location":"header", + "locationName":"X-Amzn-SageMaker-Enable-Explanations" } }, "payload":"Body" diff --git a/models/apis/runtime.sagemaker/2017-05-13/docs-2.json b/models/apis/runtime.sagemaker/2017-05-13/docs-2.json index 36f8bdbcd4..4fc708e4b0 100644 --- a/models/apis/runtime.sagemaker/2017-05-13/docs-2.json +++ b/models/apis/runtime.sagemaker/2017-05-13/docs-2.json @@ -10,7 +10,7 @@ "base": null, "refs": { "InvokeEndpointInput$Body": "

Provides input data, in the format specified in the ContentType request header. Amazon SageMaker passes all of the data in the body to the model.

For information about the format of the request body, see Common Data Formats-Inference.

", - "InvokeEndpointOutput$Body": "

Includes the inference provided by the model.

For information about the format of the response body, see Common Data Formats-Inference.

" + "InvokeEndpointOutput$Body": "

Includes the inference provided by the model.

For information about the format of the response body, see Common Data Formats-Inference.

If the explainer is activated, the body includes the explanations provided by the model. For more information, see the Response section under Invoke the Endpoint in the Developer Guide.

" } }, "CustomAttributesHeader": { @@ -21,6 +21,12 @@ "InvokeEndpointOutput$CustomAttributes": "

Provides additional information in the response about the inference returned by a model hosted at an Amazon SageMaker endpoint. The information is an opaque value that is forwarded verbatim. You could use this value, for example, to return an ID received in the CustomAttributes header of a request or other metadata that a service endpoint was programmed to produce. The value must consist of no more than 1024 visible US-ASCII characters as specified in Section 3.3.6. Field Value Components of the Hypertext Transfer Protocol (HTTP/1.1). If the customer wants the custom attribute returned, the model must set the custom attribute to be included on the way back.

The code in your model is responsible for setting or updating any custom attributes in the response. If your code does not set this value in the response, an empty value is returned. For example, if a custom attribute represents the trace ID, your model can prepend the custom attribute with Trace ID: in your post-processing function.

This feature is currently supported in the Amazon Web Services SDKs but not in the Amazon SageMaker Python SDK.

" } }, + "EnableExplanationsHeader": { + "base": null, + "refs": { + "InvokeEndpointInput$EnableExplanations": "

An optional JMESPath expression used to override the EnableExplanations parameter of the ClarifyExplainerConfig API. See the EnableExplanations section in the developer guide for more information.

" + } + }, "EndpointName": { "base": null, "refs": { diff --git a/models/apis/sagemaker/2017-07-24/api-2.json b/models/apis/sagemaker/2017-07-24/api-2.json index c1827b9ad7..4e4701e85f 100644 --- a/models/apis/sagemaker/2017-07-24/api-2.json +++ b/models/apis/sagemaker/2017-07-24/api-2.json @@ -4294,6 +4294,230 @@ "RegisterNewBaseline":{"shape":"Boolean"} } }, + "ClarifyContentTemplate":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, + "ClarifyEnableExplanations":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, + "ClarifyExplainerConfig":{ + "type":"structure", + "required":["ShapConfig"], + "members":{ + "EnableExplanations":{"shape":"ClarifyEnableExplanations"}, + "InferenceConfig":{"shape":"ClarifyInferenceConfig"}, + "ShapConfig":{"shape":"ClarifyShapConfig"} + } + }, + "ClarifyFeatureHeaders":{ + "type":"list", + "member":{"shape":"ClarifyHeader"}, + "max":256, + "min":1 + }, + "ClarifyFeatureType":{ + "type":"string", + "enum":[ + "numerical", + "categorical", + "text" + ] + }, + "ClarifyFeatureTypes":{ + "type":"list", + "member":{"shape":"ClarifyFeatureType"}, + "max":256, + "min":1 + }, + "ClarifyFeaturesAttribute":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, + "ClarifyHeader":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, + "ClarifyInferenceConfig":{ + "type":"structure", + "members":{ + "FeaturesAttribute":{"shape":"ClarifyFeaturesAttribute"}, + "ContentTemplate":{"shape":"ClarifyContentTemplate"}, + "MaxRecordCount":{"shape":"ClarifyMaxRecordCount"}, + "MaxPayloadInMB":{"shape":"ClarifyMaxPayloadInMB"}, + "ProbabilityIndex":{"shape":"ClarifyProbabilityIndex"}, + "LabelIndex":{"shape":"ClarifyLabelIndex"}, + "ProbabilityAttribute":{"shape":"ClarifyProbabilityAttribute"}, + "LabelAttribute":{"shape":"ClarifyLabelAttribute"}, + "LabelHeaders":{"shape":"ClarifyLabelHeaders"}, + "FeatureHeaders":{"shape":"ClarifyFeatureHeaders"}, + "FeatureTypes":{"shape":"ClarifyFeatureTypes"} + } + }, + "ClarifyLabelAttribute":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, + "ClarifyLabelHeaders":{ + "type":"list", + "member":{"shape":"ClarifyHeader"}, + "max":16, + "min":1 + }, + "ClarifyLabelIndex":{ + "type":"integer", + "min":0 + }, + "ClarifyMaxPayloadInMB":{ + "type":"integer", + "max":25, + "min":1 + }, + "ClarifyMaxRecordCount":{ + "type":"integer", + "min":1 + }, + "ClarifyMimeType":{ + "type":"string", + "max":255, + "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*\\/[a-zA-Z0-9](-*[a-zA-Z0-9+.])*" + }, + "ClarifyProbabilityAttribute":{ + "type":"string", + "max":64, + "min":1, + "pattern":".*" + }, + "ClarifyProbabilityIndex":{ + "type":"integer", + "min":0 + }, + "ClarifyShapBaseline":{ + "type":"string", + "max":4096, + "min":1, + "pattern":"[\\s\\S]+" + }, + "ClarifyShapBaselineConfig":{ + "type":"structure", + "members":{ + "MimeType":{"shape":"ClarifyMimeType"}, + "ShapBaseline":{"shape":"ClarifyShapBaseline"}, + "ShapBaselineUri":{"shape":"Url"} + } + }, + "ClarifyShapConfig":{ + "type":"structure", + "required":["ShapBaselineConfig"], + "members":{ + "ShapBaselineConfig":{"shape":"ClarifyShapBaselineConfig"}, + "NumberOfSamples":{"shape":"ClarifyShapNumberOfSamples"}, + "UseLogit":{"shape":"ClarifyShapUseLogit"}, + "Seed":{"shape":"ClarifyShapSeed"}, + "TextConfig":{"shape":"ClarifyTextConfig"} + } + }, + "ClarifyShapNumberOfSamples":{ + "type":"integer", + "min":1 + }, + "ClarifyShapSeed":{"type":"integer"}, + "ClarifyShapUseLogit":{"type":"boolean"}, + "ClarifyTextConfig":{ + "type":"structure", + "required":[ + "Language", + "Granularity" + ], + "members":{ + "Language":{"shape":"ClarifyTextLanguage"}, + "Granularity":{"shape":"ClarifyTextGranularity"} + } + }, + "ClarifyTextGranularity":{ + "type":"string", + "enum":[ + "token", + "sentence", + "paragraph" + ] + }, + "ClarifyTextLanguage":{ + "type":"string", + "enum":[ + "af", + "sq", + "ar", + "hy", + "eu", + "bn", + "bg", + "ca", + "zh", + "hr", + "cs", + "da", + "nl", + "en", + "et", + "fi", + "fr", + "de", + "el", + "gu", + "he", + "hi", + "hu", + "is", + "id", + "ga", + "it", + "kn", + "ky", + "lv", + "lt", + "lb", + "mk", + "ml", + "mr", + "ne", + "nb", + "fa", + "pl", + "pt", + "ro", + "ru", + "sa", + "sr", + "tn", + "si", + "sk", + "sl", + "es", + "sv", + "tl", + "ta", + "tt", + "te", + "tr", + "uk", + "ur", + "yo", + "lij", + "xx" + ] + }, "ClientId":{ "type":"string", "max":1024, @@ -5012,7 +5236,8 @@ "DataCaptureConfig":{"shape":"DataCaptureConfig"}, "Tags":{"shape":"TagList"}, "KmsKeyId":{"shape":"KmsKeyId"}, - "AsyncInferenceConfig":{"shape":"AsyncInferenceConfig"} + "AsyncInferenceConfig":{"shape":"AsyncInferenceConfig"}, + "ExplainerConfig":{"shape":"ExplainerConfig"} } }, "CreateEndpointConfigOutput":{ @@ -6971,7 +7196,8 @@ "DataCaptureConfig":{"shape":"DataCaptureConfig"}, "KmsKeyId":{"shape":"KmsKeyId"}, "CreationTime":{"shape":"Timestamp"}, - "AsyncInferenceConfig":{"shape":"AsyncInferenceConfig"} + "AsyncInferenceConfig":{"shape":"AsyncInferenceConfig"}, + "ExplainerConfig":{"shape":"ExplainerConfig"} } }, "DescribeEndpointInput":{ @@ -7003,7 +7229,8 @@ "LastModifiedTime":{"shape":"Timestamp"}, "LastDeploymentConfig":{"shape":"DeploymentConfig"}, "AsyncInferenceConfig":{"shape":"AsyncInferenceConfig"}, - "PendingDeploymentSummary":{"shape":"PendingDeploymentSummary"} + "PendingDeploymentSummary":{"shape":"PendingDeploymentSummary"}, + "ExplainerConfig":{"shape":"ExplainerConfig"} } }, "DescribeExperimentRequest":{ @@ -8914,6 +9141,12 @@ "type":"string", "min":1 }, + "ExplainerConfig":{ + "type":"structure", + "members":{ + "ClarifyExplainerConfig":{"shape":"ClarifyExplainerConfig"} + } + }, "FailStepMetadata":{ "type":"structure", "members":{ diff --git a/models/apis/sagemaker/2017-07-24/docs-2.json b/models/apis/sagemaker/2017-07-24/docs-2.json index d33414cc5d..1db54cd085 100644 --- a/models/apis/sagemaker/2017-07-24/docs-2.json +++ b/models/apis/sagemaker/2017-07-24/docs-2.json @@ -1468,6 +1468,163 @@ "PipelineExecutionStepMetadata$ClarifyCheck": "

Container for the metadata for a Clarify check step. The configurations and outcomes of the check step execution. This includes:

" } }, + "ClarifyContentTemplate": { + "base": null, + "refs": { + "ClarifyInferenceConfig$ContentTemplate": "

A template string used to format a JSON record into an acceptable model container input. For example, a ContentTemplate string '{\"myfeatures\":$features}' will format a list of features [1,2,3] into the record string '{\"myfeatures\":[1,2,3]}'. Required only when the model container input is in JSON Lines format.

" + } + }, + "ClarifyEnableExplanations": { + "base": null, + "refs": { + "ClarifyExplainerConfig$EnableExplanations": "

A JMESPath boolean expression used to filter which records to explain. Explanations are activated by default. See EnableExplanations for additional information.

" + } + }, + "ClarifyExplainerConfig": { + "base": "

The configuration parameters for the SageMaker Clarify explainer.

", + "refs": { + "ExplainerConfig$ClarifyExplainerConfig": "

A member of ExplainerConfig that contains configuration parameters for the SageMaker Clarify explainer.

" + } + }, + "ClarifyFeatureHeaders": { + "base": null, + "refs": { + "ClarifyInferenceConfig$FeatureHeaders": "

The names of the features. If provided, these are included in the endpoint response payload to help readability of the InvokeEndpoint output. See the Response section under Invoke the endpoint in the Developer Guide for more information.

" + } + }, + "ClarifyFeatureType": { + "base": null, + "refs": { + "ClarifyFeatureTypes$member": null + } + }, + "ClarifyFeatureTypes": { + "base": null, + "refs": { + "ClarifyInferenceConfig$FeatureTypes": "

A list of data types of the features (optional). Applicable only to NLP explainability. If provided, FeatureTypes must have at least one 'text' string (for example, ['text']). If FeatureTypes is not provided, the explainer infers the feature types based on the baseline data. The feature types are included in the endpoint response payload. For additional information see the response section under Invoke the endpoint in the Developer Guide for more information.

" + } + }, + "ClarifyFeaturesAttribute": { + "base": null, + "refs": { + "ClarifyInferenceConfig$FeaturesAttribute": "

Provides the JMESPath expression to extract the features from a model container input in JSON Lines format. For example, if FeaturesAttribute is the JMESPath expression 'myfeatures', it extracts a list of features [1,2,3] from request data '{\"myfeatures\":[1,2,3}'.

" + } + }, + "ClarifyHeader": { + "base": null, + "refs": { + "ClarifyFeatureHeaders$member": null, + "ClarifyLabelHeaders$member": null + } + }, + "ClarifyInferenceConfig": { + "base": "

The inference configuration parameter for the model container.

", + "refs": { + "ClarifyExplainerConfig$InferenceConfig": "

The inference configuration parameter for the model container.

" + } + }, + "ClarifyLabelAttribute": { + "base": null, + "refs": { + "ClarifyInferenceConfig$LabelAttribute": "

A JMESPath expression used to locate the list of label headers in the model container output.

Example: If the model container output of a batch request is '{\"labels\":[\"cat\",\"dog\",\"fish\"],\"probability\":[0.6,0.3,0.1]}', then set LabelAttribute to 'labels' to extract the list of label headers [\"cat\",\"dog\",\"fish\"]

" + } + }, + "ClarifyLabelHeaders": { + "base": null, + "refs": { + "ClarifyInferenceConfig$LabelHeaders": "

For multiclass classification problems, the label headers are the names of the classes. Otherwise, the label header is the name of the predicted label. These are used to help readability for the output of the InvokeEndpoint API. See the response section under Invoke the endpoint in the Developer Guide for more information. If there are no label headers in the model container output, provide them manually using this parameter.

" + } + }, + "ClarifyLabelIndex": { + "base": null, + "refs": { + "ClarifyInferenceConfig$LabelIndex": "

A zero-based index used to extract a label header or list of label headers from model container output in CSV format.

Example for a multiclass model: If the model container output consists of label headers followed by probabilities: '\"[\\'cat\\',\\'dog\\',\\'fish\\']\",\"[0.1,0.6,0.3]\"', set LabelIndex to 0 to select the label headers ['cat','dog','fish'].

" + } + }, + "ClarifyMaxPayloadInMB": { + "base": null, + "refs": { + "ClarifyInferenceConfig$MaxPayloadInMB": "

The maximum payload size (MB) allowed of a request from the explainer to the model container. Defaults to 6 MB.

" + } + }, + "ClarifyMaxRecordCount": { + "base": null, + "refs": { + "ClarifyInferenceConfig$MaxRecordCount": "

The maximum number of records in a request that the model container can process when querying the model container for the predictions of a synthetic dataset. A record is a unit of input data that inference can be made on, for example, a single line in CSV data. If MaxRecordCount is 1, the model container expects one record per request. A value of 2 or greater means that the model expects batch requests, which can reduce overhead and speed up the inferencing process. If this parameter is not provided, the explainer will tune the record count per request according to the model container's capacity at runtime.

" + } + }, + "ClarifyMimeType": { + "base": null, + "refs": { + "ClarifyShapBaselineConfig$MimeType": "

The MIME type of the baseline data. Choose from 'text/csv' or 'application/jsonlines'. Defaults to 'text/csv'.

" + } + }, + "ClarifyProbabilityAttribute": { + "base": null, + "refs": { + "ClarifyInferenceConfig$ProbabilityAttribute": "

A JMESPath expression used to extract the probability (or score) from the model container output if the model container is in JSON Lines format.

Example: If the model container output of a single request is '{\"predicted_label\":1,\"probability\":0.6}', then set ProbabilityAttribute to 'probability'.

" + } + }, + "ClarifyProbabilityIndex": { + "base": null, + "refs": { + "ClarifyInferenceConfig$ProbabilityIndex": "

A zero-based index used to extract a probability value (score) or list from model container output in CSV format. If this value is not provided, the entire model container output will be treated as a probability value (score) or list.

Example for a single class model: If the model container output consists of a string-formatted prediction label followed by its probability: '1,0.6', set ProbabilityIndex to 1 to select the probability value 0.6.

Example for a multiclass model: If the model container output consists of a string-formatted prediction label followed by its probability: '\"[\\'cat\\',\\'dog\\',\\'fish\\']\",\"[0.1,0.6,0.3]\"', set ProbabilityIndex to 1 to select the probability values [0.1,0.6,0.3].

" + } + }, + "ClarifyShapBaseline": { + "base": null, + "refs": { + "ClarifyShapBaselineConfig$ShapBaseline": "

The inline SHAP baseline data in string format. ShapBaseline can have one or multiple records to be used as the baseline dataset. The format of the SHAP baseline file should be the same format as the training dataset. For example, if the training dataset is in CSV format and each record contains four features, and all features are numerical, then the format of the baseline data should also share these characteristics. For natural language processing (NLP) of text columns, the baseline value should be the value used to replace the unit of text specified by the Granularity of the TextConfig parameter. The size limit for ShapBasline is 4 KB. Use the ShapBaselineUri parameter if you want to provide more than 4 KB of baseline data.

" + } + }, + "ClarifyShapBaselineConfig": { + "base": "

The configuration for the SHAP baseline (also called the background or reference dataset) of the Kernal SHAP algorithm.

", + "refs": { + "ClarifyShapConfig$ShapBaselineConfig": "

The configuration for the SHAP baseline of the Kernal SHAP algorithm.

" + } + }, + "ClarifyShapConfig": { + "base": "

The configuration for SHAP analysis using SageMaker Clarify Explainer.

", + "refs": { + "ClarifyExplainerConfig$ShapConfig": "

The configuration for SHAP analysis.

" + } + }, + "ClarifyShapNumberOfSamples": { + "base": null, + "refs": { + "ClarifyShapConfig$NumberOfSamples": "

The number of samples to be used for analysis by the Kernal SHAP algorithm.

The number of samples determines the size of the synthetic dataset, which has an impact on latency of explainability requests. For more information, see the Synthetic data of Configure and create an endpoint.

" + } + }, + "ClarifyShapSeed": { + "base": null, + "refs": { + "ClarifyShapConfig$Seed": "

The starting value used to initialize the random number generator in the explainer. Provide a value for this parameter to obtain a deterministic SHAP result.

" + } + }, + "ClarifyShapUseLogit": { + "base": null, + "refs": { + "ClarifyShapConfig$UseLogit": "

A Boolean toggle to indicate if you want to use the logit function (true) or log-odds units (false) for model predictions. Defaults to false.

" + } + }, + "ClarifyTextConfig": { + "base": "

A parameter used to configure the SageMaker Clarify explainer to treat text features as text so that explanations are provided for individual units of text. Required only for natural language processing (NLP) explainability.

", + "refs": { + "ClarifyShapConfig$TextConfig": "

A parameter that indicates if text features are treated as text and explanations are provided for individual units of text. Required for natural language processing (NLP) explainability only.

" + } + }, + "ClarifyTextGranularity": { + "base": null, + "refs": { + "ClarifyTextConfig$Granularity": "

The unit of granularity for the analysis of text features. For example, if the unit is 'token', then each token (like a word in English) of the text is treated as a feature. SHAP values are computed for each unit/feature.

" + } + }, + "ClarifyTextLanguage": { + "base": null, + "refs": { + "ClarifyTextConfig$Language": "

Specifies the language of the text features in ISO 639-1 or ISO 639-3 code of a supported language.

For a mix of multiple languages, use code 'xx'.

" + } + }, "ClientId": { "base": null, "refs": { @@ -4462,6 +4619,14 @@ "CandidateArtifactLocations$Explainability": "

The Amazon S3 prefix to the explainability artifacts generated for the AutoML candidate.

" } }, + "ExplainerConfig": { + "base": "

A parameter to activate explainers.

", + "refs": { + "CreateEndpointConfigInput$ExplainerConfig": "

A member of CreateEndpointConfig that enables explainers.

", + "DescribeEndpointConfigOutput$ExplainerConfig": "

The configuration parameters for an explainer.

", + "DescribeEndpointOutput$ExplainerConfig": "

The configuration parameters for an explainer.

" + } + }, "FailStepMetadata": { "base": "

The container for the metadata for Fail step.

", "refs": { @@ -12254,6 +12419,7 @@ "base": null, "refs": { "AutoMLContainerDefinition$ModelDataUrl": "

The location of the model artifacts. For more information, see .

", + "ClarifyShapBaselineConfig$ShapBaselineUri": "

The uniform resource identifier (URI) of the S3 bucket where the SHAP baseline file is stored. The format of the SHAP baseline file should be the same format as the format of the training dataset. For example, if the training dataset is in CSV format, and each record in the training dataset has four features, and all features are numerical, then the baseline file should also have this same format. Each record should contain only the features. If you are using a virtual private cloud (VPC), the ShapBaselineUri should be accessible to the VPC. For more information about setting up endpoints with Amazon Virtual Private Cloud, see Give SageMaker access to Resources in your Amazon Virtual Private Cloud.

", "ContainerDefinition$ModelDataUrl": "

The S3 path where the model artifacts, which result from model training, are stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix). The S3 path is required for SageMaker built-in algorithms, but not if you use your own algorithms. For more information on built-in algorithms, see Common Parameters.

The model artifacts must be in an S3 bucket that is in the same region as the model or endpoint you are creating.

If you provide a value for this parameter, SageMaker uses Amazon Web Services Security Token Service to download model artifacts from the S3 path you provide. Amazon Web Services STS is activated in your IAM user account by default. If you previously deactivated Amazon Web Services STS for a region, you need to reactivate Amazon Web Services STS for that region. For more information, see Activating and Deactivating Amazon Web Services STS in an Amazon Web Services Region in the Amazon Web Services Identity and Access Management User Guide.

If you use a built-in algorithm to create a model, SageMaker requires that you provide a S3 path to the model artifacts in ModelDataUrl.

", "ModelPackageContainerDefinition$ModelDataUrl": "

The Amazon S3 path where the model artifacts, which result from model training, are stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix).

The model artifacts must be in an S3 bucket that is in the same region as the model package.

", "SourceAlgorithm$ModelDataUrl": "

The Amazon S3 path where the model artifacts, which result from model training, are stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix).

The model artifacts must be in an S3 bucket that is in the same region as the algorithm.

" diff --git a/models/apis/sso-oidc/2019-06-10/docs-2.json b/models/apis/sso-oidc/2019-06-10/docs-2.json index e77083c346..f8b63ea73c 100644 --- a/models/apis/sso-oidc/2019-06-10/docs-2.json +++ b/models/apis/sso-oidc/2019-06-10/docs-2.json @@ -1,9 +1,9 @@ { "version": "2.0", - "service": "

AWS Single Sign-On (SSO) OpenID Connect (OIDC) is a web service that enables a client (such as AWS CLI or a native application) to register with AWS SSO. The service also enables the client to fetch the user’s access token upon successful authentication and authorization with AWS SSO. This service conforms with the OAuth 2.0 based implementation of the device authorization grant standard (https://tools.ietf.org/html/rfc8628).

For general information about AWS SSO, see What is AWS Single Sign-On? in the AWS SSO User Guide.

This API reference guide describes the AWS SSO OIDC operations that you can call programatically and includes detailed information on data types and errors.

AWS provides SDKs that consist of libraries and sample code for various programming languages and platforms such as Java, Ruby, .Net, iOS, and Android. The SDKs provide a convenient way to create programmatic access to AWS SSO and other AWS services. For more information about the AWS SDKs, including how to download and install them, see Tools for Amazon Web Services.

", + "service": "

AWS IAM Identity Center (successor to AWS Single Sign-On) OpenID Connect (OIDC) is a web service that enables a client (such as AWS CLI or a native application) to register with IAM Identity Center. The service also enables the client to fetch the user’s access token upon successful authentication and authorization with IAM Identity Center.

Although AWS Single Sign-On was renamed, the sso and identitystore API namespaces will continue to retain their original name for backward compatibility purposes. For more information, see IAM Identity Center rename.

Considerations for Using This Guide

Before you begin using this guide, we recommend that you first review the following important information about how the IAM Identity Center OIDC service works.

For general information about IAM Identity Center, see What is IAM Identity Center? in the IAM Identity Center User Guide.

", "operations": { "CreateToken": "

Creates and returns an access token for the authorized client. The access token issued will be used to fetch short-term credentials for the assigned roles in the AWS account.

", - "RegisterClient": "

Registers a client with AWS SSO. This allows clients to initiate device authorization. The output should be persisted for reuse through many authentication requests.

", + "RegisterClient": "

Registers a client with IAM Identity Center. This allows clients to initiate device authorization. The output should be persisted for reuse through many authentication requests.

", "StartDeviceAuthorization": "

Initiates device authorization by requesting a pair of verification codes from the authorization service.

" }, "shapes": { @@ -15,7 +15,7 @@ "AccessToken": { "base": null, "refs": { - "CreateTokenResponse$accessToken": "

An opaque token to access AWS SSO resources assigned to a user.

" + "CreateTokenResponse$accessToken": "

An opaque token to access IAM Identity Center resources assigned to a user.

" } }, "AuthCode": { @@ -34,7 +34,7 @@ "refs": { "CreateTokenRequest$clientId": "

The unique identifier string for each client. This value should come from the persisted result of the RegisterClient API.

", "RegisterClientResponse$clientId": "

The unique identifier string for each client. This client uses this identifier to get authenticated by the service in subsequent calls.

", - "StartDeviceAuthorizationRequest$clientId": "

The unique identifier string for the client that is registered with AWS SSO. This value should come from the persisted result of the RegisterClient API operation.

" + "StartDeviceAuthorizationRequest$clientId": "

The unique identifier string for the client that is registered with IAM Identity Center. This value should come from the persisted result of the RegisterClient API operation.

" } }, "ClientName": { @@ -123,13 +123,13 @@ "GrantType": { "base": null, "refs": { - "CreateTokenRequest$grantType": "

Supports grant types for authorization code, refresh token, and device code request.

" + "CreateTokenRequest$grantType": "

Supports grant types for the authorization code, refresh token, and device code request. For device code requests, specify the following value:

urn:ietf:params:oauth:grant-type:device_code

For information about how to obtain the device code, see the StartDeviceAuthorization topic.

" } }, "IdToken": { "base": null, "refs": { - "CreateTokenResponse$idToken": "

The identifier of the user that associated with the access token, if present.

" + "CreateTokenResponse$idToken": "

Currently, idToken is not yet implemented and is not supported. For more information about the features and limitations of the current IAM Identity Center OIDC implementation, see Considerations for Using this Guide in the IAM Identity Center OIDC API Reference.

The identifier of the user that associated with the access token, if present.

" } }, "InternalServerException": { @@ -178,8 +178,8 @@ "RefreshToken": { "base": null, "refs": { - "CreateTokenRequest$refreshToken": "

The token used to obtain an access token in the event that the access token is invalid or expired. This token is not issued by the service.

", - "CreateTokenResponse$refreshToken": "

A token that, if present, can be used to refresh a previously issued access token that might have expired.

" + "CreateTokenRequest$refreshToken": "

Currently, refreshToken is not yet implemented and is not supported. For more information about the features and limitations of the current IAM Identity Center OIDC implementation, see Considerations for Using this Guide in the IAM Identity Center OIDC API Reference.

The token used to obtain an access token in the event that the access token is invalid or expired.

", + "CreateTokenResponse$refreshToken": "

Currently, refreshToken is not yet implemented and is not supported. For more information about the features and limitations of the current IAM Identity Center OIDC implementation, see Considerations for Using this Guide in the IAM Identity Center OIDC API Reference.

A token that, if present, can be used to refresh a previously issued access token that might have expired.

" } }, "RegisterClientRequest": { @@ -232,7 +232,7 @@ "CreateTokenRequest$redirectUri": "

The location of the application that will receive the authorization code. Users authorize the service to send the request to this location.

", "RegisterClientResponse$authorizationEndpoint": "

The endpoint where the client can request authorization.

", "RegisterClientResponse$tokenEndpoint": "

The endpoint where the client can get an access token.

", - "StartDeviceAuthorizationRequest$startUrl": "

The URL for the AWS SSO user portal. For more information, see Using the User Portal in the AWS Single Sign-On User Guide.

", + "StartDeviceAuthorizationRequest$startUrl": "

The URL for the AWS access portal. For more information, see Using the AWS access portal in the IAM Identity Center User Guide.

", "StartDeviceAuthorizationResponse$verificationUri": "

The URI of the verification page that takes the userCode to authorize the device.

", "StartDeviceAuthorizationResponse$verificationUriComplete": "

An alternate URL that the client can use to automatically launch a browser. This process skips the manual step in which the user visits the verification page and enters their code.

" } diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index e40ae5328c..6c052bed15 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -2827,6 +2827,28 @@ "us-west-2" : { } } }, + "codestar-notifications" : { + "endpoints" : { + "ap-east-1" : { }, + "ap-northeast-1" : { }, + "ap-northeast-2" : { }, + "ap-south-1" : { }, + "ap-southeast-1" : { }, + "ap-southeast-2" : { }, + "ca-central-1" : { }, + "eu-central-1" : { }, + "eu-north-1" : { }, + "eu-west-1" : { }, + "eu-west-2" : { }, + "eu-west-3" : { }, + "me-south-1" : { }, + "sa-east-1" : { }, + "us-east-1" : { }, + "us-east-2" : { }, + "us-west-1" : { }, + "us-west-2" : { } + } + }, "cognito-identity" : { "endpoints" : { "ap-northeast-1" : { }, @@ -7604,6 +7626,7 @@ "ap-south-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, + "ap-southeast-3" : { }, "ca-central-1" : { }, "eu-central-1" : { }, "eu-north-1" : { }, diff --git a/service/codedeploy/api.go b/service/codedeploy/api.go index 9d98925691..88f0eaacb3 100644 --- a/service/codedeploy/api.go +++ b/service/codedeploy/api.go @@ -168,7 +168,7 @@ func (c *CodeDeploy) BatchGetApplicationRevisionsRequest(input *BatchGetApplicat // Returned Error Types: // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - ApplicationNameRequiredException // The minimum number of required application names was not specified. @@ -269,7 +269,7 @@ func (c *CodeDeploy) BatchGetApplicationsRequest(input *BatchGetApplicationsInpu // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - BatchLimitExceededException // The maximum number of names or IDs allowed for this request (100) was exceeded. @@ -357,7 +357,7 @@ func (c *CodeDeploy) BatchGetDeploymentGroupsRequest(input *BatchGetDeploymentGr // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - DeploymentGroupNameRequiredException // The deployment group name was not specified. @@ -369,7 +369,8 @@ func (c *CodeDeploy) BatchGetDeploymentGroupsRequest(input *BatchGetDeploymentGr // The maximum number of names or IDs allowed for this request (100) was exceeded. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // See also, https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/BatchGetDeploymentGroups func (c *CodeDeploy) BatchGetDeploymentGroups(input *BatchGetDeploymentGroupsInput) (*BatchGetDeploymentGroupsOutput, error) { @@ -444,7 +445,7 @@ func (c *CodeDeploy) BatchGetDeploymentInstancesRequest(input *BatchGetDeploymen // This method works, but is deprecated. Use BatchGetDeploymentTargets instead. // // Returns an array of one or more instances associated with a deployment. This -// method works with EC2/On-premises and AWS Lambda compute platforms. The newer +// method works with EC2/On-premises and Lambda compute platforms. The newer // BatchGetDeploymentTargets works with all compute platforms. The maximum number // of instances that can be returned is 25. // @@ -461,7 +462,8 @@ func (c *CodeDeploy) BatchGetDeploymentInstancesRequest(input *BatchGetDeploymen // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - InstanceIdRequiredException // The instance ID was not specified. @@ -556,9 +558,9 @@ func (c *CodeDeploy) BatchGetDeploymentTargetsRequest(input *BatchGetDeploymentT // The type of targets returned depends on the deployment's compute platform // or deployment method: // -// - EC2/On-premises: Information about EC2 instance targets. +// - EC2/On-premises: Information about Amazon EC2 instance targets. // -// - AWS Lambda: Information about Lambda functions targets. +// - Lambda: Information about Lambda functions targets. // // - Amazon ECS: Information about Amazon ECS service targets. // @@ -581,7 +583,8 @@ func (c *CodeDeploy) BatchGetDeploymentTargetsRequest(input *BatchGetDeploymentT // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentNotStartedException // The specified deployment has not started. @@ -597,7 +600,7 @@ func (c *CodeDeploy) BatchGetDeploymentTargetsRequest(input *BatchGetDeploymentT // // - DeploymentTargetListSizeExceededException // The maximum number of targets that can be associated with an Amazon ECS or -// AWS Lambda deployment was exceeded. The target list of both types of deployments +// Lambda deployment was exceeded. The target list of both types of deployments // must have exactly one item. This exception does not apply to EC2/On-premises // deployments. // @@ -862,7 +865,8 @@ func (c *CodeDeploy) ContinueDeploymentRequest(input *ContinueDeploymentInput) ( // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentAlreadyCompletedException // The deployment is already complete. @@ -965,8 +969,8 @@ func (c *CodeDeploy) CreateApplicationRequest(input *CreateApplicationInput) (re // The application name was specified in an invalid format. // // - ApplicationAlreadyExistsException -// An application with the specified name with the IAM user or AWS account already -// exists. +// An application with the specified name with the IAM user or Amazon Web Services +// account already exists. // // - ApplicationLimitExceededException // More applications were attempted to be created than are allowed. @@ -1061,7 +1065,7 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - DeploymentGroupNameRequiredException // The deployment group name was not specified. @@ -1070,13 +1074,15 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // The deployment group name was specified in an invalid format. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - RevisionRequiredException // The revision ID was not specified. // // - RevisionDoesNotExistException -// The named revision does not exist with the IAM user or AWS account. +// The named revision does not exist with the IAM user or Amazon Web Services +// account. // // - InvalidRevisionException // The revision was specified in an invalid format. @@ -1085,7 +1091,8 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // The deployment configuration name was specified in an invalid format. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // - DescriptionTooLongException // The description is too long. @@ -1105,6 +1112,22 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // // - A specified tag is not currently applied to any instances. // +// - InvalidAlarmConfigException +// The format of the alarm configuration is invalid. Possible causes include: +// +// - The alarm list is null. +// +// - The alarm object is null. +// +// - The alarm name is empty or null or exceeds the limit of 255 characters. +// +// - Two alarms with the same name have been specified. +// +// - The alarm configuration is enabled, but the alarm list is empty. +// +// - AlarmsLimitExceededException +// The maximum number of alarms for a deployment group (10) was exceeded. +// // - InvalidAutoRollbackConfigException // The automatic rollback configuration was specified in an invalid format. // For example, automatic rollback is enabled, but an invalid triggering event @@ -1114,7 +1137,7 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // An invalid load balancer name, or no load balancer name, was specified. // // - InvalidFileExistsBehaviorException -// An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy +// An invalid fileExistsBehavior option was specified to determine how CodeDeploy // handles files or directories that already exist in a deployment target location, // but weren't part of the previous successful deployment. Valid values include // "DISALLOW," "OVERWRITE," and "RETAIN." @@ -1131,11 +1154,11 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // An API function was called too frequently. // // - InvalidUpdateOutdatedInstancesOnlyValueException -// The UpdateOutdatedInstancesOnly value is invalid. For AWS Lambda deployments, +// The UpdateOutdatedInstancesOnly value is invalid. For Lambda deployments, // false is expected. For EC2/On-premises deployments, true or false is expected. // // - InvalidIgnoreApplicationStopFailuresValueException -// The IgnoreApplicationStopFailures value is invalid. For AWS Lambda deployments, +// The IgnoreApplicationStopFailures value is invalid. For Lambda deployments, // false is expected. For EC2/On-premises deployments, true or false is expected. // // - InvalidGitHubAccountTokenException @@ -1228,8 +1251,8 @@ func (c *CodeDeploy) CreateDeploymentConfigRequest(input *CreateDeploymentConfig // The deployment configuration name was not specified. // // - DeploymentConfigAlreadyExistsException -// A deployment configuration with the specified name with the IAM user or AWS -// account already exists. +// A deployment configuration with the specified name with the IAM user or Amazon +// Web Services account already exists. // // - InvalidMinimumHealthyHostValueException // The minimum healthy instance value was specified in an invalid format. @@ -1328,7 +1351,7 @@ func (c *CodeDeploy) CreateDeploymentGroupRequest(input *CreateDeploymentGroupIn // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - DeploymentGroupNameRequiredException // The deployment group name was not specified. @@ -1337,8 +1360,8 @@ func (c *CodeDeploy) CreateDeploymentGroupRequest(input *CreateDeploymentGroupIn // The deployment group name was specified in an invalid format. // // - DeploymentGroupAlreadyExistsException -// A deployment group with the specified name with the IAM user or AWS account -// already exists. +// A deployment group with the specified name with the IAM user or Amazon Web +// Services account already exists. // // - InvalidEC2TagException // The tag was specified in an invalid format. @@ -1353,7 +1376,8 @@ func (c *CodeDeploy) CreateDeploymentGroupRequest(input *CreateDeploymentGroupIn // The deployment configuration name was specified in an invalid format. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // - RoleRequiredException // The role ID was not specified. @@ -2048,7 +2072,7 @@ func (c *CodeDeploy) GetApplicationRequest(input *GetApplicationInput) (req *req // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // See also, https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/GetApplication func (c *CodeDeploy) GetApplication(input *GetApplicationInput) (*GetApplicationOutput, error) { @@ -2127,7 +2151,7 @@ func (c *CodeDeploy) GetApplicationRevisionRequest(input *GetApplicationRevision // Returned Error Types: // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - ApplicationNameRequiredException // The minimum number of required application names was not specified. @@ -2136,7 +2160,8 @@ func (c *CodeDeploy) GetApplicationRevisionRequest(input *GetApplicationRevision // The application name was specified in an invalid format. // // - RevisionDoesNotExistException -// The named revision does not exist with the IAM user or AWS account. +// The named revision does not exist with the IAM user or Amazon Web Services +// account. // // - RevisionRequiredException // The revision ID was not specified. @@ -2232,7 +2257,8 @@ func (c *CodeDeploy) GetDeploymentRequest(input *GetDeploymentInput) (req *reque // At least one of the deployment IDs was specified in an invalid format. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // See also, https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/GetDeployment func (c *CodeDeploy) GetDeployment(input *GetDeploymentInput) (*GetDeploymentOutput, error) { @@ -2317,7 +2343,8 @@ func (c *CodeDeploy) GetDeploymentConfigRequest(input *GetDeploymentConfigInput) // The deployment configuration name was not specified. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // - InvalidComputePlatformException // The computePlatform is invalid. The computePlatform should be Lambda, Server, @@ -2406,7 +2433,7 @@ func (c *CodeDeploy) GetDeploymentGroupRequest(input *GetDeploymentGroupInput) ( // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - DeploymentGroupNameRequiredException // The deployment group name was not specified. @@ -2415,10 +2442,12 @@ func (c *CodeDeploy) GetDeploymentGroupRequest(input *GetDeploymentGroupInput) ( // The deployment group name was specified in an invalid format. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // See also, https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/GetDeploymentGroup func (c *CodeDeploy) GetDeploymentGroup(input *GetDeploymentGroupInput) (*GetDeploymentGroupOutput, error) { @@ -2505,7 +2534,8 @@ func (c *CodeDeploy) GetDeploymentInstanceRequest(input *GetDeploymentInstanceIn // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - InstanceIdRequiredException // The instance ID was not specified. @@ -2610,7 +2640,8 @@ func (c *CodeDeploy) GetDeploymentTargetRequest(input *GetDeploymentTargetInput) // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentNotStartedException // The specified deployment has not started. @@ -2795,7 +2826,7 @@ func (c *CodeDeploy) ListApplicationRevisionsRequest(input *ListApplicationRevis // Returned Error Types: // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - ApplicationNameRequiredException // The minimum number of required application names was not specified. @@ -2947,7 +2978,8 @@ func (c *CodeDeploy) ListApplicationsRequest(input *ListApplicationsInput) (req // ListApplications API operation for AWS CodeDeploy. // -// Lists the applications registered with the IAM user or AWS account. +// Lists the applications registered with the IAM user or Amazon Web Services +// account. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3082,7 +3114,8 @@ func (c *CodeDeploy) ListDeploymentConfigsRequest(input *ListDeploymentConfigsIn // ListDeploymentConfigs API operation for AWS CodeDeploy. // -// Lists the deployment configurations with the IAM user or AWS account. +// Lists the deployment configurations with the IAM user or Amazon Web Services +// account. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3218,7 +3251,7 @@ func (c *CodeDeploy) ListDeploymentGroupsRequest(input *ListDeploymentGroupsInpu // ListDeploymentGroups API operation for AWS CodeDeploy. // // Lists the deployment groups for an application registered with the IAM user -// or AWS account. +// or Amazon Web Services account. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3236,7 +3269,7 @@ func (c *CodeDeploy) ListDeploymentGroupsRequest(input *ListDeploymentGroupsInpu // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - InvalidNextTokenException // The next token was specified in an invalid format. @@ -3370,9 +3403,10 @@ func (c *CodeDeploy) ListDeploymentInstancesRequest(input *ListDeploymentInstanc // // The newer BatchGetDeploymentTargets should be used instead because it works // with all compute types. ListDeploymentInstances throws an exception if it -// is used with a compute platform other than EC2/On-premises or AWS Lambda. +// is used with a compute platform other than EC2/On-premises or Lambda. // -// Lists the instance for a deployment associated with the IAM user or AWS account. +// Lists the instance for a deployment associated with the IAM user or Amazon +// Web Services account. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3387,7 +3421,8 @@ func (c *CodeDeploy) ListDeploymentInstancesRequest(input *ListDeploymentInstanc // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentNotStartedException // The specified deployment has not started. @@ -3556,7 +3591,8 @@ func (c *CodeDeploy) ListDeploymentTargetsRequest(input *ListDeploymentTargetsIn // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentNotStartedException // The specified deployment has not started. @@ -3651,7 +3687,7 @@ func (c *CodeDeploy) ListDeploymentsRequest(input *ListDeploymentsInput) (req *r // ListDeployments API operation for AWS CodeDeploy. // // Lists the deployments in a deployment group for an application registered -// with the IAM user or AWS account. +// with the IAM user or Amazon Web Services account. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3669,13 +3705,14 @@ func (c *CodeDeploy) ListDeploymentsRequest(input *ListDeploymentsInput) (req *r // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - InvalidDeploymentGroupNameException // The deployment group name was specified in an invalid format. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - DeploymentGroupNameRequiredException // The deployment group name was not specified. @@ -4074,12 +4111,12 @@ func (c *CodeDeploy) PutLifecycleEventHookExecutionStatusRequest(input *PutLifec // PutLifecycleEventHookExecutionStatus API operation for AWS CodeDeploy. // // Sets the result of a Lambda validation function. The function validates lifecycle -// hooks during a deployment that uses the AWS Lambda or Amazon ECS compute -// platform. For AWS Lambda deployments, the available lifecycle hooks are BeforeAllowTraffic +// hooks during a deployment that uses the Lambda or Amazon ECS compute platform. +// For Lambda deployments, the available lifecycle hooks are BeforeAllowTraffic // and AfterAllowTraffic. For Amazon ECS deployments, the available lifecycle // hooks are BeforeInstall, AfterInstall, AfterAllowTestTraffic, BeforeAllowTraffic, // and AfterAllowTraffic. Lambda validation functions return Succeeded or Failed. -// For more information, see AppSpec 'hooks' Section for an AWS Lambda Deployment +// For more information, see AppSpec 'hooks' Section for an Lambda Deployment // (https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-lambda) // and AppSpec 'hooks' Section for an Amazon ECS Deployment (https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-ecs). // @@ -4107,7 +4144,8 @@ func (c *CodeDeploy) PutLifecycleEventHookExecutionStatusRequest(input *PutLifec // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - InvalidDeploymentIdException // At least one of the deployment IDs was specified in an invalid format. @@ -4181,7 +4219,7 @@ func (c *CodeDeploy) RegisterApplicationRevisionRequest(input *RegisterApplicati // RegisterApplicationRevision API operation for AWS CodeDeploy. // -// Registers with AWS CodeDeploy a revision for the specified application. +// Registers with CodeDeploy a revision for the specified application. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4193,7 +4231,7 @@ func (c *CodeDeploy) RegisterApplicationRevisionRequest(input *RegisterApplicati // Returned Error Types: // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - ApplicationNameRequiredException // The minimum number of required application names was not specified. @@ -4509,7 +4547,8 @@ func (c *CodeDeploy) SkipWaitTimeForInstanceTerminationRequest(input *SkipWaitTi // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentAlreadyCompletedException // The deployment is already complete. @@ -4607,10 +4646,12 @@ func (c *CodeDeploy) StopDeploymentRequest(input *StopDeploymentInput) (req *req // At least one deployment ID must be specified. // // - DeploymentDoesNotExistException -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - DeploymentAlreadyCompletedException // The deployment is already complete. @@ -4703,13 +4744,15 @@ func (c *CodeDeploy) TagResourceRequest(input *TagResourceInput) (req *request.R // The ARN of a resource is required, but was not found. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // - TagRequiredException // A tag was not specified. @@ -4807,13 +4850,15 @@ func (c *CodeDeploy) UntagResourceRequest(input *UntagResourceInput) (req *reque // The ARN of a resource is required, but was not found. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // - TagRequiredException // A tag was not specified. @@ -4912,11 +4957,11 @@ func (c *CodeDeploy) UpdateApplicationRequest(input *UpdateApplicationInput) (re // The application name was specified in an invalid format. // // - ApplicationAlreadyExistsException -// An application with the specified name with the IAM user or AWS account already -// exists. +// An application with the specified name with the IAM user or Amazon Web Services +// account already exists. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // See also, https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/UpdateApplication func (c *CodeDeploy) UpdateApplication(input *UpdateApplicationInput) (*UpdateApplicationOutput, error) { @@ -5001,20 +5046,21 @@ func (c *CodeDeploy) UpdateDeploymentGroupRequest(input *UpdateDeploymentGroupIn // The application name was specified in an invalid format. // // - ApplicationDoesNotExistException -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. // // - InvalidDeploymentGroupNameException // The deployment group name was specified in an invalid format. // // - DeploymentGroupAlreadyExistsException -// A deployment group with the specified name with the IAM user or AWS account -// already exists. +// A deployment group with the specified name with the IAM user or Amazon Web +// Services account already exists. // // - DeploymentGroupNameRequiredException // The deployment group name was not specified. // // - DeploymentGroupDoesNotExistException -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. // // - InvalidEC2TagException // The tag was specified in an invalid format. @@ -5029,7 +5075,8 @@ func (c *CodeDeploy) UpdateDeploymentGroupRequest(input *UpdateDeploymentGroupIn // The deployment configuration name was specified in an invalid format. // // - DeploymentConfigDoesNotExistException -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. // // - InvalidRoleException // The service role ARN was specified in an invalid format. Or, if an Auto Scaling @@ -5252,12 +5299,12 @@ func (s *Alarm) SetName(v string) *Alarm { return s } -// Information about alarms associated with the deployment group. +// Information about alarms associated with a deployment or deployment group. type AlarmConfiguration struct { _ struct{} `type:"structure"` - // A list of alarms configured for the deployment group. A maximum of 10 alarms - // can be added to a deployment group. + // A list of alarms configured for the deployment or deployment group. A maximum + // of 10 alarms can be added. Alarms []*Alarm `locationName:"alarms" type:"list"` // Indicates whether the alarm configuration is enabled. @@ -5375,17 +5422,17 @@ func (s *AlarmsLimitExceededException) RequestID() string { return s.RespMetadata.RequestID } -// A revision for an AWS Lambda or Amazon ECS deployment that is a YAML-formatted -// or JSON-formatted string. For AWS Lambda and Amazon ECS deployments, the -// revision is the same as the AppSpec file. This method replaces the deprecated -// RawString data type. +// A revision for an Lambda or Amazon ECS deployment that is a YAML-formatted +// or JSON-formatted string. For Lambda and Amazon ECS deployments, the revision +// is the same as the AppSpec file. This method replaces the deprecated RawString +// data type. type AppSpecContent struct { _ struct{} `type:"structure"` // The YAML-formatted or JSON-formatted revision string. // - // For an AWS Lambda deployment, the content includes a Lambda function name, - // the alias for its original version, and the alias for its replacement version. + // For an Lambda deployment, the content includes a Lambda function name, the + // alias for its original version, and the alias for its replacement version. // The deployment shifts traffic from the original version of the Lambda function // to the replacement version. // @@ -5430,8 +5477,8 @@ func (s *AppSpecContent) SetSha256(v string) *AppSpecContent { return s } -// An application with the specified name with the IAM user or AWS account already -// exists. +// An application with the specified name with the IAM user or Amazon Web Services +// account already exists. type ApplicationAlreadyExistsException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -5495,7 +5542,7 @@ func (s *ApplicationAlreadyExistsException) RequestID() string { return s.RespMetadata.RequestID } -// The application does not exist with the IAM user or AWS account. +// The application does not exist with the IAM user or Amazon Web Services account. type ApplicationDoesNotExistException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -5919,7 +5966,7 @@ func (s *AutoScalingGroup) SetName(v string) *AutoScalingGroup { type BatchGetApplicationRevisionsInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application about which to get revision information. + // The name of an CodeDeploy application about which to get revision information. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -6115,8 +6162,8 @@ func (s *BatchGetApplicationsOutput) SetApplicationsInfo(v []*ApplicationInfo) * type BatchGetDeploymentGroupsInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the applicable - // IAM user or AWS account. + // The name of an CodeDeploy application associated with the applicable IAM + // or Amazon Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -6331,17 +6378,18 @@ type BatchGetDeploymentTargetsInput struct { // of deployment target IDs you can specify is 25. // // * For deployments that use the EC2/On-premises compute platform, the target - // IDs are EC2 or on-premises instances IDs, and their target type is instanceTarget. + // IDs are Amazon EC2 or on-premises instances IDs, and their target type + // is instanceTarget. // - // * For deployments that use the AWS Lambda compute platform, the target - // IDs are the names of Lambda functions, and their target type is instanceTarget. + // * For deployments that use the Lambda compute platform, the target IDs + // are the names of Lambda functions, and their target type is instanceTarget. // // * For deployments that use the Amazon ECS compute platform, the target // IDs are pairs of Amazon ECS clusters and services specified using the // format :. Their target type is ecsTarget. // - // * For deployments that are deployed with AWS CloudFormation, the target - // IDs are CloudFormation stack IDs. Their target type is cloudFormationTarget. + // * For deployments that are deployed with CloudFormation, the target IDs + // are CloudFormation stack IDs. Their target type is cloudFormationTarget. TargetIds []*string `locationName:"targetIds" type:"list"` } @@ -6382,15 +6430,14 @@ type BatchGetDeploymentTargetsOutput struct { // about the target, such as its status and lifecycle events. The type of the // target objects depends on the deployment' compute platform. // - // * EC2/On-premises: Each target object is an EC2 or on-premises instance. + // * EC2/On-premises: Each target object is an Amazon EC2 or on-premises + // instance. // - // * AWS Lambda: The target object is a specific version of an AWS Lambda - // function. + // * Lambda: The target object is a specific version of an Lambda function. // // * Amazon ECS: The target object is an Amazon ECS service. // - // * CloudFormation: The target object is an AWS CloudFormation blue/green - // deployment. + // * CloudFormation: The target object is an CloudFormation blue/green deployment. DeploymentTargets []*DeploymentTarget `locationName:"deploymentTargets" type:"list"` } @@ -6815,33 +6862,33 @@ func (s *BucketNameFilterRequiredException) RequestID() string { return s.RespMetadata.RequestID } -// Information about the target to be updated by an AWS CloudFormation blue/green +// Information about the target to be updated by an CloudFormation blue/green // deployment. This target type is used for all deployments initiated by a CloudFormation // stack update. type CloudFormationTarget struct { _ struct{} `type:"structure"` - // The unique ID of an AWS CloudFormation blue/green deployment. + // The unique ID of an CloudFormation blue/green deployment. DeploymentId *string `locationName:"deploymentId" type:"string"` - // The date and time when the target application was updated by an AWS CloudFormation + // The date and time when the target application was updated by an CloudFormation // blue/green deployment. LastUpdatedAt *time.Time `locationName:"lastUpdatedAt" type:"timestamp"` - // The lifecycle events of the AWS CloudFormation blue/green deployment to this + // The lifecycle events of the CloudFormation blue/green deployment to this // target application. LifecycleEvents []*LifecycleEvent `locationName:"lifecycleEvents" type:"list"` - // The resource type for the AWS CloudFormation blue/green deployment. + // The resource type for the CloudFormation blue/green deployment. ResourceType *string `locationName:"resourceType" type:"string"` - // The status of an AWS CloudFormation blue/green deployment's target application. + // The status of an CloudFormation blue/green deployment's target application. Status *string `locationName:"status" type:"string" enum:"TargetStatus"` // The unique ID of a deployment target that has a type of CloudFormationTarget. TargetId *string `locationName:"targetId" type:"string"` - // The percentage of production traffic that the target version of an AWS CloudFormation + // The percentage of production traffic that the target version of an CloudFormation // blue/green deployment receives. TargetVersionWeight *float64 `locationName:"targetVersionWeight" type:"double"` } @@ -6976,7 +7023,7 @@ type CreateApplicationInput struct { _ struct{} `type:"structure"` // The name of the application. This name must be unique with the applicable - // IAM user or AWS account. + // IAM or Amazon Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -7098,7 +7145,7 @@ type CreateDeploymentConfigInput struct { // * FLEET_PERCENT: The value parameter represents the minimum number of // healthy instances as a percentage of the total number of instances in // the deployment. If you specify FLEET_PERCENT, at the start of the deployment, - // AWS CodeDeploy converts the percentage to the equivalent number of instances + // CodeDeploy converts the percentage to the equivalent number of instances // and rounds up fractional instances. // // The value parameter takes an integer. @@ -7209,8 +7256,8 @@ type CreateDeploymentGroupInput struct { // is created. AlarmConfiguration *AlarmConfiguration `locationName:"alarmConfiguration" type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -7226,7 +7273,7 @@ type CreateDeploymentGroupInput struct { BlueGreenDeploymentConfiguration *BlueGreenDeploymentConfiguration `locationName:"blueGreenDeploymentConfiguration" type:"structure"` // If specified, the deployment configuration name can be either one of the - // predefined configurations provided with AWS CodeDeploy or a custom deployment + // predefined configurations provided with CodeDeploy or a custom deployment // configuration that you create by calling the create deployment configuration // operation. // @@ -7234,9 +7281,9 @@ type CreateDeploymentGroupInput struct { // is used if a configuration isn't specified for the deployment or deployment // group. // - // For more information about the predefined deployment configurations in AWS - // CodeDeploy, see Working with Deployment Configurations in CodeDeploy (https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html) - // in the AWS CodeDeploy User Guide. + // For more information about the predefined deployment configurations in CodeDeploy, + // see Working with Deployment Configurations in CodeDeploy (https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html) + // in the CodeDeploy User Guide. DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string"` // The name of a new deployment group for the specified application. @@ -7248,14 +7295,14 @@ type CreateDeploymentGroupInput struct { // want to run and whether to route deployment traffic behind a load balancer. DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"` - // The Amazon EC2 tags on which to filter. The deployment group includes EC2 - // instances with any of the specified tags. Cannot be used in the same call - // as ec2TagSet. + // The Amazon EC2 tags on which to filter. The deployment group includes Amazon + // EC2 instances with any of the specified tags. Cannot be used in the same + // call as ec2TagSet. Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"` - // Information about groups of tags applied to EC2 instances. The deployment - // group includes only EC2 instances identified by all the tag groups. Cannot - // be used in the same call as ec2TagFilters. + // Information about groups of tags applied to Amazon EC2 instances. The deployment + // group includes only Amazon EC2 instances identified by all the tag groups. + // Cannot be used in the same call as ec2TagFilters. Ec2TagSet *EC2TagSet `locationName:"ec2TagSet" type:"structure"` // The target Amazon ECS services in the deployment group. This applies only @@ -7277,20 +7324,20 @@ type CreateDeploymentGroupInput struct { // Cannot be used in the same call as onPremisesInstanceTagFilters. OnPremisesTagSet *OnPremisesTagSet `locationName:"onPremisesTagSet" type:"structure"` - // Indicates what happens when new EC2 instances are launched mid-deployment + // Indicates what happens when new Amazon EC2 instances are launched mid-deployment // and do not receive the deployed application revision. // // If this option is set to UPDATE or is unspecified, CodeDeploy initiates one // or more 'auto-update outdated instances' deployments to apply the deployed - // application revision to the new EC2 instances. + // application revision to the new Amazon EC2 instances. // // If this option is set to IGNORE, CodeDeploy does not initiate a deployment - // to update the new EC2 instances. This may result in instances having different - // revisions. + // to update the new Amazon EC2 instances. This may result in instances having + // different revisions. OutdatedInstancesStrategy *string `locationName:"outdatedInstancesStrategy" type:"string" enum:"OutdatedInstancesStrategy"` - // A service role Amazon Resource Name (ARN) that allows AWS CodeDeploy to act - // on the user's behalf when interacting with AWS services. + // A service role Amazon Resource Name (ARN) that allows CodeDeploy to act on + // the user's behalf when interacting with Amazon Web Services services. // // ServiceRoleArn is a required field ServiceRoleArn *string `locationName:"serviceRoleArn" type:"string" required:"true"` @@ -7301,8 +7348,8 @@ type CreateDeploymentGroupInput struct { Tags []*Tag `locationName:"tags" type:"list"` // Information about triggers to create when the deployment group is created. - // For examples, see Create a Trigger for an AWS CodeDeploy Event (https://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-notify-sns.html) - // in the AWS CodeDeploy User Guide. + // For examples, see Create a Trigger for an CodeDeploy Event (https://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-notify-sns.html) + // in the CodeDeploy User Guide. TriggerConfigurations []*TriggerConfig `locationName:"triggerConfigurations" type:"list"` } @@ -7496,8 +7543,8 @@ func (s *CreateDeploymentGroupOutput) SetDeploymentGroupId(v string) *CreateDepl type CreateDeploymentInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -7506,8 +7553,8 @@ type CreateDeploymentInput struct { // deployment is created. AutoRollbackConfiguration *AutoRollbackConfiguration `locationName:"autoRollbackConfiguration" type:"structure"` - // The name of a deployment configuration associated with the IAM user or AWS - // account. + // The name of a deployment configuration associated with the IAM user or Amazon + // Web Services account. // // If not specified, the value configured in the deployment group is used as // the default. If the deployment group does not have a deployment configuration @@ -7520,9 +7567,8 @@ type CreateDeploymentInput struct { // A comment about the deployment. Description *string `locationName:"description" type:"string"` - // Information about how AWS CodeDeploy handles files that already exist in - // a deployment target location but weren't part of the previous successful - // deployment. + // Information about how CodeDeploy handles files that already exist in a deployment + // target location but weren't part of the previous successful deployment. // // The fileExistsBehavior parameter takes any of the following values: // @@ -7549,8 +7595,8 @@ type CreateDeploymentInput struct { // than the minimum number of healthy hosts, then a deployment to the next instance // is attempted. // - // During a deployment, the AWS CodeDeploy agent runs the scripts specified - // for ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec + // During a deployment, the CodeDeploy agent runs the scripts specified for + // ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec // file from the previous successful deployment. (All other scripts are run // from the AppSpec file in the current deployment.) If one of these scripts // contains an error and does not run successfully, the deployment can fail. @@ -7561,6 +7607,20 @@ type CreateDeploymentInput struct { // failures should be ignored. IgnoreApplicationStopFailures *bool `locationName:"ignoreApplicationStopFailures" type:"boolean"` + // Allows you to specify information about alarms associated with a deployment. + // The alarm configuration that you specify here will override the alarm configuration + // at the deployment group level. Consider overriding the alarm configuration + // if you have set up alarms at the deployment group level that are causing + // deployment failures. In this case, you would call CreateDeployment to create + // a new deployment that uses a previous application revision that is known + // to work, and set its alarm configuration to turn off alarm polling. Turning + // off alarm polling ensures that the new deployment proceeds without being + // blocked by the alarm that was generated by the previous, failed, deployment. + // + // If you specify an overrideAlarmConfiguration, you need the UpdateDeploymentGroup + // IAM permission when calling CreateDeployment. + OverrideAlarmConfiguration *AlarmConfiguration `locationName:"overrideAlarmConfiguration" type:"structure"` + // The type and location of the revision to deploy. Revision *RevisionLocation `locationName:"revision" type:"structure"` @@ -7655,6 +7715,12 @@ func (s *CreateDeploymentInput) SetIgnoreApplicationStopFailures(v bool) *Create return s } +// SetOverrideAlarmConfiguration sets the OverrideAlarmConfiguration field's value. +func (s *CreateDeploymentInput) SetOverrideAlarmConfiguration(v *AlarmConfiguration) *CreateDeploymentInput { + s.OverrideAlarmConfiguration = v + return s +} + // SetRevision sets the Revision field's value. func (s *CreateDeploymentInput) SetRevision(v *RevisionLocation) *CreateDeploymentInput { s.Revision = v @@ -7709,8 +7775,8 @@ func (s *CreateDeploymentOutput) SetDeploymentId(v string) *CreateDeploymentOutp type DeleteApplicationInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -7782,8 +7848,8 @@ func (s DeleteApplicationOutput) GoString() string { type DeleteDeploymentConfigInput struct { _ struct{} `type:"structure"` - // The name of a deployment configuration associated with the IAM user or AWS - // account. + // The name of a deployment configuration associated with the IAM user or Amazon + // Web Services account. // // DeploymentConfigName is a required field DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string" required:"true"` @@ -7855,8 +7921,8 @@ func (s DeleteDeploymentConfigOutput) GoString() string { type DeleteDeploymentGroupInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -7924,11 +7990,11 @@ type DeleteDeploymentGroupOutput struct { _ struct{} `type:"structure"` // If the output contains no data, and the corresponding deployment group contained - // at least one Auto Scaling group, AWS CodeDeploy successfully removed all - // corresponding Auto Scaling lifecycle event hooks from the Amazon EC2 instances - // in the Auto Scaling group. If the output contains data, AWS CodeDeploy could - // not remove some Auto Scaling lifecycle event hooks from the Amazon EC2 instances - // in the Auto Scaling group. + // at least one Auto Scaling group, CodeDeploy successfully removed all corresponding + // Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto + // Scaling group. If the output contains data, CodeDeploy could not remove some + // Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto + // Scaling group. HooksNotCleanedUp []*AutoScalingGroup `locationName:"hooksNotCleanedUp" type:"list"` } @@ -8138,8 +8204,8 @@ func (s *DeploymentAlreadyCompletedException) RequestID() string { return s.RespMetadata.RequestID } -// A deployment configuration with the specified name with the IAM user or AWS -// account already exists. +// A deployment configuration with the specified name with the IAM user or Amazon +// Web Services account already exists. type DeploymentConfigAlreadyExistsException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -8203,7 +8269,8 @@ func (s *DeploymentConfigAlreadyExistsException) RequestID() string { return s.RespMetadata.RequestID } -// The deployment configuration does not exist with the IAM user or AWS account. +// The deployment configuration does not exist with the IAM user or Amazon Web +// Services account. type DeploymentConfigDoesNotExistException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -8351,7 +8418,7 @@ type DeploymentConfigInfo struct { MinimumHealthyHosts *MinimumHealthyHosts `locationName:"minimumHealthyHosts" type:"structure"` // The configuration that specifies how the deployment traffic is routed. Used - // for deployments with a Lambda or ECS compute platform only. + // for deployments with a Lambda or Amazon ECS compute platform only. TrafficRoutingConfig *TrafficRoutingConfig `locationName:"trafficRoutingConfig" type:"structure"` } @@ -8537,7 +8604,8 @@ func (s *DeploymentConfigNameRequiredException) RequestID() string { return s.RespMetadata.RequestID } -// The deployment with the IAM user or AWS account does not exist. +// The deployment with the IAM user or Amazon Web Services account does not +// exist. type DeploymentDoesNotExistException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -8601,8 +8669,8 @@ func (s *DeploymentDoesNotExistException) RequestID() string { return s.RespMetadata.RequestID } -// A deployment group with the specified name with the IAM user or AWS account -// already exists. +// A deployment group with the specified name with the IAM user or Amazon Web +// Services account already exists. type DeploymentGroupAlreadyExistsException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -8666,7 +8734,8 @@ func (s *DeploymentGroupAlreadyExistsException) RequestID() string { return s.RespMetadata.RequestID } -// The named deployment group with the IAM user or AWS account does not exist. +// The named deployment group with the IAM user or Amazon Web Services account +// does not exist. type DeploymentGroupDoesNotExistException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -8770,9 +8839,9 @@ type DeploymentGroupInfo struct { // instances with any of the specified tags. Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"` - // Information about groups of tags applied to an EC2 instance. The deployment - // group includes only EC2 instances identified by all of the tag groups. Cannot - // be used in the same call as ec2TagFilters. + // Information about groups of tags applied to an Amazon EC2 instance. The deployment + // group includes only Amazon EC2 instances identified by all of the tag groups. + // Cannot be used in the same call as ec2TagFilters. Ec2TagSet *EC2TagSet `locationName:"ec2TagSet" type:"structure"` // The target Amazon ECS services in the deployment group. This applies only @@ -8801,22 +8870,22 @@ type DeploymentGroupInfo struct { // tag groups. Cannot be used in the same call as onPremisesInstanceTagFilters. OnPremisesTagSet *OnPremisesTagSet `locationName:"onPremisesTagSet" type:"structure"` - // Indicates what happens when new EC2 instances are launched mid-deployment + // Indicates what happens when new Amazon EC2 instances are launched mid-deployment // and do not receive the deployed application revision. // // If this option is set to UPDATE or is unspecified, CodeDeploy initiates one // or more 'auto-update outdated instances' deployments to apply the deployed - // application revision to the new EC2 instances. + // application revision to the new Amazon EC2 instances. // // If this option is set to IGNORE, CodeDeploy does not initiate a deployment - // to update the new EC2 instances. This may result in instances having different - // revisions. + // to update the new Amazon EC2 instances. This may result in instances having + // different revisions. OutdatedInstancesStrategy *string `locationName:"outdatedInstancesStrategy" type:"string" enum:"OutdatedInstancesStrategy"` // A service role Amazon Resource Name (ARN) that grants CodeDeploy permission - // to make calls to AWS services on your behalf. For more information, see Create - // a Service Role for AWS CodeDeploy (https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-create-service-role.html) - // in the AWS CodeDeploy User Guide. + // to make calls to Amazon Web Services services on your behalf. For more information, + // see Create a Service Role for CodeDeploy (https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-create-service-role.html) + // in the CodeDeploy User Guide. ServiceRoleArn *string `locationName:"serviceRoleArn" type:"string"` // Information about the deployment group's target revision, including type @@ -9205,7 +9274,7 @@ type DeploymentInfo struct { // * codeDeployRollback: A rollback process created the deployment. // // * CodeDeployAutoUpdate: An auto-update process created the deployment - // when it detected outdated EC2 instances. + // when it detected outdated Amazon EC2 instances. Creator *string `locationName:"creator" type:"string" enum:"DeploymentCreator"` // The deployment configuration name. @@ -9237,9 +9306,8 @@ type DeploymentInfo struct { // ID) that is linked to this deployment. ExternalId *string `locationName:"externalId" type:"string"` - // Information about how AWS CodeDeploy handles files that already exist in - // a deployment target location but weren't part of the previous successful - // deployment. + // Information about how CodeDeploy handles files that already exist in a deployment + // target location but weren't part of the previous successful deployment. // // * DISALLOW: The deployment fails. This is also the default behavior if // no option is specified. @@ -9264,8 +9332,8 @@ type DeploymentInfo struct { // than the minimum number of healthy hosts, then a deployment to the next instance // is attempted. // - // During a deployment, the AWS CodeDeploy agent runs the scripts specified - // for ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec + // During a deployment, the CodeDeploy agent runs the scripts specified for + // ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic in the AppSpec // file from the previous successful deployment. (All other scripts are run // from the AppSpec file in the current deployment.) If one of these scripts // contains an error and does not run successfully, the deployment can fail. @@ -9285,6 +9353,9 @@ type DeploymentInfo struct { // Information about the load balancer used in the deployment. LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"` + // Information about alarms associated with a deployment or deployment group. + OverrideAlarmConfiguration *AlarmConfiguration `locationName:"overrideAlarmConfiguration" type:"structure"` + // Information about the application revision that was deployed to the deployment // group before the most recent successful deployment. PreviousRevision *RevisionLocation `locationName:"previousRevision" type:"structure"` @@ -9463,6 +9534,12 @@ func (s *DeploymentInfo) SetLoadBalancerInfo(v *LoadBalancerInfo) *DeploymentInf return s } +// SetOverrideAlarmConfiguration sets the OverrideAlarmConfiguration field's value. +func (s *DeploymentInfo) SetOverrideAlarmConfiguration(v *AlarmConfiguration) *DeploymentInfo { + s.OverrideAlarmConfiguration = v + return s +} + // SetPreviousRevision sets the PreviousRevision field's value. func (s *DeploymentInfo) SetPreviousRevision(v *RevisionLocation) *DeploymentInfo { s.PreviousRevision = v @@ -9882,7 +9959,7 @@ func (s *DeploymentStyle) SetDeploymentType(v string) *DeploymentStyle { type DeploymentTarget struct { _ struct{} `type:"structure"` - // Information about the target to be updated by an AWS CloudFormation blue/green + // Information about the target to be updated by an CloudFormation blue/green // deployment. This target type is used for all deployments initiated by a CloudFormation // stack update. CloudFormationTarget *CloudFormationTarget `locationName:"cloudFormationTarget" type:"structure"` @@ -9899,7 +9976,7 @@ type DeploymentTarget struct { // compute platform. InstanceTarget *InstanceTarget `locationName:"instanceTarget" type:"structure"` - // Information about the target for a deployment that uses the AWS Lambda compute + // Information about the target for a deployment that uses the Lambda compute // platform. LambdaTarget *LambdaTarget `locationName:"lambdaTarget" type:"structure"` } @@ -10081,7 +10158,7 @@ func (s *DeploymentTargetIdRequiredException) RequestID() string { } // The maximum number of targets that can be associated with an Amazon ECS or -// AWS Lambda deployment was exceeded. The target list of both types of deployments +// Lambda deployment was exceeded. The target list of both types of deployments // must have exactly one item. This exception does not apply to EC2/On-premises // deployments. type DeploymentTargetListSizeExceededException struct { @@ -10303,8 +10380,7 @@ type Diagnostics struct { // The last portion of the diagnostic log. // - // If available, AWS CodeDeploy returns up to the last 4 KB of the diagnostic - // log. + // If available, CodeDeploy returns up to the last 4 KB of the diagnostic log. LogTail *string `locationName:"logTail" type:"string"` // The message associated with the error. @@ -10412,13 +10488,13 @@ func (s *EC2TagFilter) SetValue(v string) *EC2TagFilter { return s } -// Information about groups of EC2 instance tags. +// Information about groups of Amazon EC2 instance tags. type EC2TagSet struct { _ struct{} `type:"structure"` - // A list that contains other lists of EC2 instance tag groups. For an instance - // to be included in the deployment group, it must be identified by all of the - // tag groups in the list. + // A list that contains other lists of Amazon EC2 instance tag groups. For an + // instance to be included in the deployment group, it must be identified by + // all of the tag groups in the list. Ec2TagSetList [][]*EC2TagFilter `locationName:"ec2TagSetList" type:"list"` } @@ -10640,10 +10716,10 @@ func (s *ECSTarget) SetTaskSetsInfo(v []*ECSTaskSet) *ECSTarget { return s } -// Information about a set of Amazon ECS tasks in an AWS CodeDeploy deployment. +// Information about a set of Amazon ECS tasks in an CodeDeploy deployment. // An Amazon ECS task set includes details such as the desired number of tasks, // how many tasks are running, and whether the task set serves production traffic. -// An AWS CodeDeploy application that uses the Amazon ECS compute platform deploys +// An CodeDeploy application that uses the Amazon ECS compute platform deploys // a containerized application in an Amazon ECS service as a task set. type ECSTaskSet struct { _ struct{} `type:"structure"` @@ -10679,7 +10755,7 @@ type ECSTaskSet struct { Status *string `locationName:"status" type:"string"` // The target group associated with the task set. The target group is used by - // AWS CodeDeploy to manage traffic to a task set. + // CodeDeploy to manage traffic to a task set. TargetGroup *TargetGroupInfo `locationName:"targetGroup" type:"structure"` // A label that identifies whether the ECS task set is an original target (BLUE) @@ -10798,8 +10874,8 @@ func (s *ELBInfo) SetName(v string) *ELBInfo { type ErrorInformation struct { _ struct{} `type:"structure"` - // For more information, see Error Codes for AWS CodeDeploy (https://docs.aws.amazon.com/codedeploy/latest/userguide/error-codes.html) - // in the AWS CodeDeploy User Guide (https://docs.aws.amazon.com/codedeploy/latest/userguide). + // For more information, see Error Codes for CodeDeploy (https://docs.aws.amazon.com/codedeploy/latest/userguide/error-codes.html) + // in the CodeDeploy User Guide (https://docs.aws.amazon.com/codedeploy/latest/userguide). // // The error code: // @@ -10831,7 +10907,7 @@ type ErrorInformation struct { // * OVER_MAX_INSTANCES: The maximum number of instances was exceeded. // // * THROTTLED: The operation was throttled because the calling account exceeded - // the throttling limits of one or more AWS services. + // the throttling limits of one or more Amazon Web Services services. // // * TIMEOUT: The deployment has timed out. // @@ -10884,13 +10960,13 @@ type GenericRevisionInfo struct { // A comment about the revision. Description *string `locationName:"description" type:"string"` - // When the revision was first used by AWS CodeDeploy. + // When the revision was first used by CodeDeploy. FirstUsedTime *time.Time `locationName:"firstUsedTime" type:"timestamp"` - // When the revision was last used by AWS CodeDeploy. + // When the revision was last used by CodeDeploy. LastUsedTime *time.Time `locationName:"lastUsedTime" type:"timestamp"` - // When the revision was registered with AWS CodeDeploy. + // When the revision was registered with CodeDeploy. RegisterTime *time.Time `locationName:"registerTime" type:"timestamp"` } @@ -10946,8 +11022,8 @@ func (s *GenericRevisionInfo) SetRegisterTime(v time.Time) *GenericRevisionInfo type GetApplicationInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -11143,8 +11219,8 @@ func (s *GetApplicationRevisionOutput) SetRevisionInfo(v *GenericRevisionInfo) * type GetDeploymentConfigInput struct { _ struct{} `type:"structure"` - // The name of a deployment configuration associated with the IAM user or AWS - // account. + // The name of a deployment configuration associated with the IAM user or Amazon + // Web Services account. // // DeploymentConfigName is a required field DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string" required:"true"` @@ -11226,8 +11302,8 @@ func (s *GetDeploymentConfigOutput) SetDeploymentConfigInfo(v *DeploymentConfigI type GetDeploymentGroupInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -11326,7 +11402,8 @@ func (s *GetDeploymentGroupOutput) SetDeploymentGroupInfo(v *DeploymentGroupInfo type GetDeploymentInput struct { _ struct{} `type:"structure"` - // The unique ID of a deployment associated with the IAM user or AWS account. + // The unique ID of a deployment associated with the IAM user or Amazon Web + // Services account. // // DeploymentId is a required field DeploymentId *string `locationName:"deploymentId" type:"string" required:"true"` @@ -14140,7 +14217,7 @@ func (s *InvalidExternalIdException) RequestID() string { return s.RespMetadata.RequestID } -// An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy +// An invalid fileExistsBehavior option was specified to determine how CodeDeploy // handles files or directories that already exist in a deployment target location, // but weren't part of the previous successful deployment. Valid values include // "DISALLOW," "OVERWRITE," and "RETAIN." @@ -14463,7 +14540,7 @@ func (s *InvalidIamUserArnException) RequestID() string { return s.RespMetadata.RequestID } -// The IgnoreApplicationStopFailures value is invalid. For AWS Lambda deployments, +// The IgnoreApplicationStopFailures value is invalid. For Lambda deployments, // false is expected. For EC2/On-premises deployments, true or false is expected. type InvalidIgnoreApplicationStopFailuresValueException struct { _ struct{} `type:"structure"` @@ -16210,7 +16287,7 @@ func (s *InvalidTriggerConfigException) RequestID() string { return s.RespMetadata.RequestID } -// The UpdateOutdatedInstancesOnly value is invalid. For AWS Lambda deployments, +// The UpdateOutdatedInstancesOnly value is invalid. For Lambda deployments, // false is expected. For EC2/On-premises deployments, true or false is expected. type InvalidUpdateOutdatedInstancesOnlyValueException struct { _ struct{} `type:"structure"` @@ -16282,9 +16359,9 @@ type LambdaFunctionInfo struct { // The version of a Lambda function that production traffic points to. CurrentVersion *string `locationName:"currentVersion" type:"string"` - // The alias of a Lambda function. For more information, see AWS Lambda Function + // The alias of a Lambda function. For more information, see Lambda Function // Aliases (https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) - // in the AWS Lambda Developer Guide. + // in the Lambda Developer Guide. FunctionAlias *string `locationName:"functionAlias" type:"string"` // The name of a Lambda function. @@ -16347,7 +16424,7 @@ func (s *LambdaFunctionInfo) SetTargetVersionWeight(v float64) *LambdaFunctionIn return s } -// Information about the target AWS Lambda function during an AWS Lambda deployment. +// Information about the target Lambda function during an Lambda deployment. type LambdaTarget struct { _ struct{} `type:"structure"` @@ -16363,7 +16440,7 @@ type LambdaTarget struct { // The lifecycle events of the deployment to this target Lambda function. LifecycleEvents []*LifecycleEvent `locationName:"lifecycleEvents" type:"list"` - // The status an AWS Lambda deployment's target Lambda function. + // The status an Lambda deployment's target Lambda function. Status *string `locationName:"status" type:"string" enum:"TargetStatus"` // The Amazon Resource Name (ARN) of the target. @@ -16708,8 +16785,8 @@ func (s *LifecycleHookLimitExceededException) RequestID() string { type ListApplicationRevisionsInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -16739,8 +16816,7 @@ type ListApplicationRevisionsInput struct { // The column name to use to sort the list results: // - // * registerTime: Sort by the time the revisions were registered with AWS - // CodeDeploy. + // * registerTime: Sort by the time the revisions were registered with CodeDeploy. // // * firstUsedTime: Sort by the time the revisions were first used in a deployment. // @@ -17038,8 +17114,8 @@ func (s *ListDeploymentConfigsOutput) SetNextToken(v string) *ListDeploymentConf type ListDeploymentGroupsInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -17381,8 +17457,8 @@ func (s *ListDeploymentTargetsOutput) SetTargetIds(v []*string) *ListDeploymentT type ListDeploymentsInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // If applicationName is specified, then deploymentGroupName must be specified. // If it is not specified, then deploymentGroupName must not be specified. @@ -17896,14 +17972,14 @@ type MinimumHealthyHosts struct { // a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This // means a deployment to only one instance at a time. (You cannot set the type // to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with - // CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all - // instances but one are kept in a healthy state during the deployment. Although - // this allows one instance at a time to be taken offline for a new deployment, - // it also means that if the deployment to the last instance fails, the overall + // CodeDeployDefault.OneAtATime, CodeDeploy attempts to ensure that all instances + // but one are kept in a healthy state during the deployment. Although this + // allows one instance at a time to be taken offline for a new deployment, it + // also means that if the deployment to the last instance fails, the overall // deployment is still successful. // - // For more information, see AWS CodeDeploy Instance Health (https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html) - // in the AWS CodeDeploy User Guide. + // For more information, see CodeDeploy Instance Health (https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html) + // in the CodeDeploy User Guide. Type *string `locationName:"type" type:"string" enum:"MinimumHealthyHostsType"` // The minimum healthy instance value. @@ -18115,7 +18191,9 @@ type PutLifecycleEventHookExecutionStatusInput struct { LifecycleEventHookExecutionId *string `locationName:"lifecycleEventHookExecutionId" type:"string"` // The result of a Lambda function that validates a deployment lifecycle event. - // Succeeded and Failed are the only valid values for status. + // The values listed in Valid Values are valid for lifecycle statuses in general; + // however, only Succeeded and Failed can be passed successfully in your API + // call. Status *string `locationName:"status" type:"string" enum:"LifecycleEventStatus"` } @@ -18187,9 +18265,8 @@ func (s *PutLifecycleEventHookExecutionStatusOutput) SetLifecycleEventHookExecut return s } -// A revision for an AWS Lambda deployment that is a YAML-formatted or JSON-formatted -// string. For AWS Lambda deployments, the revision is the same as the AppSpec -// file. +// A revision for an Lambda deployment that is a YAML-formatted or JSON-formatted +// string. For Lambda deployments, the revision is the same as the AppSpec file. // // Deprecated: RawString and String revision type are deprecated, use AppSpecContent type instead. type RawString struct { @@ -18238,8 +18315,8 @@ func (s *RawString) SetSha256(v string) *RawString { type RegisterApplicationRevisionInput struct { _ struct{} `type:"structure"` - // The name of an AWS CodeDeploy application associated with the IAM user or - // AWS account. + // The name of an CodeDeploy application associated with the IAM user or Amazon + // Web Services account. // // ApplicationName is a required field ApplicationName *string `locationName:"applicationName" min:"1" type:"string" required:"true"` @@ -18671,7 +18748,8 @@ func (s *ResourceValidationException) RequestID() string { return s.RespMetadata.RequestID } -// The named revision does not exist with the IAM user or AWS account. +// The named revision does not exist with the IAM user or Amazon Web Services +// account. type RevisionDoesNotExistException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -18781,8 +18859,8 @@ func (s *RevisionInfo) SetRevisionLocation(v *RevisionLocation) *RevisionInfo { type RevisionLocation struct { _ struct{} `type:"structure"` - // The content of an AppSpec file for an AWS Lambda or Amazon ECS deployment. - // The content is formatted as JSON or YAML and stored as a RawString. + // The content of an AppSpec file for an Lambda or Amazon ECS deployment. The + // content is formatted as JSON or YAML and stored as a RawString. AppSpecContent *AppSpecContent `locationName:"appSpecContent" type:"structure"` // Information about the location of application artifacts stored in GitHub. @@ -18795,19 +18873,19 @@ type RevisionLocation struct { // * GitHub: An application revision stored in GitHub (EC2/On-premises deployments // only). // - // * String: A YAML-formatted or JSON-formatted string (AWS Lambda deployments + // * String: A YAML-formatted or JSON-formatted string (Lambda deployments // only). // // * AppSpecContent: An AppSpecContent object that contains the contents - // of an AppSpec file for an AWS Lambda or Amazon ECS deployment. The content + // of an AppSpec file for an Lambda or Amazon ECS deployment. The content // is formatted as JSON or YAML stored as a RawString. RevisionType *string `locationName:"revisionType" type:"string" enum:"RevisionLocationType"` // Information about the location of a revision stored in Amazon S3. S3Location *S3Location `locationName:"s3Location" type:"structure"` - // Information about the location of an AWS Lambda deployment revision stored - // as a RawString. + // Information about the location of an Lambda deployment revision stored as + // a RawString. String_ *RawString `locationName:"string" deprecated:"true" type:"structure"` } @@ -19760,8 +19838,8 @@ type TargetInstances struct { // for a blue/green deployment. AutoScalingGroups []*string `locationName:"autoScalingGroups" type:"list"` - // Information about the groups of EC2 instance tags that an instance must be - // identified by in order for it to be included in the replacement environment + // Information about the groups of Amazon EC2 instance tags that an instance + // must be identified by in order for it to be included in the replacement environment // for a blue/green deployment. Cannot be used in the same call as tagFilters. Ec2TagSet *EC2TagSet `locationName:"ec2TagSet" type:"structure"` @@ -19872,9 +19950,9 @@ func (s *ThrottlingException) RequestID() string { } // A configuration that shifts traffic from one version of a Lambda function -// or ECS task set to another in two increments. The original and target Lambda -// function versions or ECS task sets are specified in the deployment's AppSpec -// file. +// or Amazon ECS task set to another in two increments. The original and target +// Lambda function versions or ECS task sets are specified in the deployment's +// AppSpec file. type TimeBasedCanary struct { _ struct{} `type:"structure"` @@ -20044,8 +20122,8 @@ func (s *TrafficRoute) SetListenerArns(v []*string) *TrafficRoute { } // The configuration that specifies how traffic is shifted from one version -// of a Lambda function to another version during an AWS Lambda deployment, -// or from one Amazon ECS task set to another during an Amazon ECS deployment. +// of a Lambda function to another version during an Lambda deployment, or from +// one Amazon ECS task set to another during an Amazon ECS deployment. type TrafficRoutingConfig struct { _ struct{} `type:"structure"` @@ -20056,9 +20134,10 @@ type TrafficRoutingConfig struct { TimeBasedCanary *TimeBasedCanary `locationName:"timeBasedCanary" type:"structure"` // A configuration that shifts traffic from one version of a Lambda function - // or ECS task set to another in equal increments, with an equal number of minutes - // between each increment. The original and target Lambda function versions - // or ECS task sets are specified in the deployment's AppSpec file. + // or Amazon ECS task set to another in equal increments, with an equal number + // of minutes between each increment. The original and target Lambda function + // versions or Amazon ECS task sets are specified in the deployment's AppSpec + // file. TimeBasedLinear *TimeBasedLinear `locationName:"timeBasedLinear" type:"structure"` // The type of traffic shifting (TimeBasedCanary or TimeBasedLinear) used by @@ -20466,9 +20545,16 @@ type UpdateDeploymentGroupInput struct { AutoRollbackConfiguration *AutoRollbackConfiguration `locationName:"autoRollbackConfiguration" type:"structure"` // The replacement list of Auto Scaling groups to be included in the deployment - // group, if you want to change them. To keep the Auto Scaling groups, enter - // their names. To remove Auto Scaling groups, do not enter any Auto Scaling - // group names. + // group, if you want to change them. + // + // * To keep the Auto Scaling groups, enter their names or do not specify + // this parameter. + // + // * To remove Auto Scaling groups, specify a non-null empty list of Auto + // Scaling group names to detach all CodeDeploy-managed Auto Scaling lifecycle + // hooks. For examples, see Amazon EC2 instances in an Amazon EC2 Auto Scaling + // group fail to launch and receive the error "Heartbeat Timeout" (https://docs.aws.amazon.com/https:/docs.aws.amazon.com/codedeploy/latest/userguide/troubleshooting-auto-scaling.html#troubleshooting-auto-scaling-heartbeat) + // in the CodeDeploy User Guide. AutoScalingGroups []*string `locationName:"autoScalingGroups" type:"list"` // Information about blue/green deployment options for a deployment group. @@ -20493,7 +20579,7 @@ type UpdateDeploymentGroupInput struct { Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"` // Information about groups of tags applied to on-premises instances. The deployment - // group includes only EC2 instances identified by all the tag groups. + // group includes only Amazon EC2 instances identified by all the tag groups. Ec2TagSet *EC2TagSet `locationName:"ec2TagSet" type:"structure"` // The target Amazon ECS services in the deployment group. This applies only @@ -20517,16 +20603,16 @@ type UpdateDeploymentGroupInput struct { // only on-premises instances identified by all the tag groups. OnPremisesTagSet *OnPremisesTagSet `locationName:"onPremisesTagSet" type:"structure"` - // Indicates what happens when new EC2 instances are launched mid-deployment + // Indicates what happens when new Amazon EC2 instances are launched mid-deployment // and do not receive the deployed application revision. // // If this option is set to UPDATE or is unspecified, CodeDeploy initiates one // or more 'auto-update outdated instances' deployments to apply the deployed - // application revision to the new EC2 instances. + // application revision to the new Amazon EC2 instances. // // If this option is set to IGNORE, CodeDeploy does not initiate a deployment - // to update the new EC2 instances. This may result in instances having different - // revisions. + // to update the new Amazon EC2 instances. This may result in instances having + // different revisions. OutdatedInstancesStrategy *string `locationName:"outdatedInstancesStrategy" type:"string" enum:"OutdatedInstancesStrategy"` // A replacement ARN for the service role, if you want to change it. @@ -20534,7 +20620,7 @@ type UpdateDeploymentGroupInput struct { // Information about triggers to change when the deployment group is updated. // For examples, see Edit a Trigger in a CodeDeploy Deployment Group (https://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-notify-edit.html) - // in the AWS CodeDeploy User Guide. + // in the CodeDeploy User Guide. TriggerConfigurations []*TriggerConfig `locationName:"triggerConfigurations" type:"list"` } @@ -20697,10 +20783,10 @@ type UpdateDeploymentGroupOutput struct { _ struct{} `type:"structure"` // If the output contains no data, and the corresponding deployment group contained - // at least one Auto Scaling group, AWS CodeDeploy successfully removed all - // corresponding Auto Scaling lifecycle event hooks from the AWS account. If - // the output contains data, AWS CodeDeploy could not remove some Auto Scaling - // lifecycle event hooks from the AWS account. + // at least one Auto Scaling group, CodeDeploy successfully removed all corresponding + // Auto Scaling lifecycle event hooks from the Amazon Web Services account. + // If the output contains data, CodeDeploy could not remove some Auto Scaling + // lifecycle event hooks from the Amazon Web Services account. HooksNotCleanedUp []*AutoScalingGroup `locationName:"hooksNotCleanedUp" type:"list"` } diff --git a/service/codedeploy/doc.go b/service/codedeploy/doc.go index 3d19a4dd7c..f3c98c79ec 100644 --- a/service/codedeploy/doc.go +++ b/service/codedeploy/doc.go @@ -3,29 +3,29 @@ // Package codedeploy provides the client and types for making API // requests to AWS CodeDeploy. // -// AWS CodeDeploy is a deployment service that automates application deployments +// CodeDeploy is a deployment service that automates application deployments // to Amazon EC2 instances, on-premises instances running in your own facility, -// serverless AWS Lambda functions, or applications in an Amazon ECS service. +// serverless Lambda functions, or applications in an Amazon ECS service. // // You can deploy a nearly unlimited variety of application content, such as // an updated Lambda function, updated applications in an Amazon ECS service, // code, web and configuration files, executables, packages, scripts, multimedia -// files, and so on. AWS CodeDeploy can deploy application content stored in -// Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do -// not need to make changes to your existing code before you can use AWS CodeDeploy. +// files, and so on. CodeDeploy can deploy application content stored in Amazon +// S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need +// to make changes to your existing code before you can use CodeDeploy. // -// AWS CodeDeploy makes it easier for you to rapidly release new features, helps +// CodeDeploy makes it easier for you to rapidly release new features, helps // you avoid downtime during application deployment, and handles the complexity // of updating your applications, without many of the risks associated with // error-prone manual deployments. // -// # AWS CodeDeploy Components +// # CodeDeploy Components // -// Use the information in this guide to help you work with the following AWS -// CodeDeploy components: +// Use the information in this guide to help you work with the following CodeDeploy +// components: // // - Application: A name that uniquely identifies the application you want -// to deploy. AWS CodeDeploy uses this name, which functions as a container, +// to deploy. CodeDeploy uses this name, which functions as a container, // to ensure the correct combination of revision, deployment configuration, // and deployment group are referenced during a deployment. // @@ -34,19 +34,19 @@ // A Lambda deployment group specifies how to route traffic to a new version // of a Lambda function. An Amazon ECS deployment group specifies the service // created in Amazon ECS to deploy, a load balancer, and a listener to reroute -// production traffic to an updated containerized application. An EC2/On-premises -// deployment group contains individually tagged instances, Amazon EC2 instances -// in Amazon EC2 Auto Scaling groups, or both. All deployment groups can -// specify optional trigger, alarm, and rollback settings. +// production traffic to an updated containerized application. An Amazon +// EC2/On-premises deployment group contains individually tagged instances, +// Amazon EC2 instances in Amazon EC2 Auto Scaling groups, or both. All deployment +// groups can specify optional trigger, alarm, and rollback settings. // // - Deployment configuration: A set of deployment rules and deployment success -// and failure conditions used by AWS CodeDeploy during a deployment. +// and failure conditions used by CodeDeploy during a deployment. // // - Deployment: The process and the components used when updating a Lambda // function, a containerized application in an Amazon ECS service, or of // installing content on one or more instances. // -// - Application revisions: For an AWS Lambda deployment, this is an AppSpec +// - Application revisions: For an Lambda deployment, this is an AppSpec // file that specifies the Lambda function to be updated and one or more // functions to validate deployment lifecycle events. For an Amazon ECS deployment, // this is an AppSpec file that specifies the Amazon ECS task definition, @@ -59,19 +59,19 @@ // identified by its commit ID. // // This guide also contains information to help you get details about the instances -// in your deployments, to make on-premises instances available for AWS CodeDeploy +// in your deployments, to make on-premises instances available for CodeDeploy // deployments, to get details about a Lambda function deployment, and to get // details about Amazon ECS service deployments. // -// AWS CodeDeploy Information Resources +// CodeDeploy Information Resources // -// - AWS CodeDeploy User Guide (https://docs.aws.amazon.com/codedeploy/latest/userguide) +// - CodeDeploy User Guide (https://docs.aws.amazon.com/codedeploy/latest/userguide) // -// - AWS CodeDeploy API Reference Guide (https://docs.aws.amazon.com/codedeploy/latest/APIReference/) +// - CodeDeploy API Reference Guide (https://docs.aws.amazon.com/codedeploy/latest/APIReference/) // -// - AWS CLI Reference for AWS CodeDeploy (https://docs.aws.amazon.com/cli/latest/reference/deploy/index.html) +// - CLI Reference for CodeDeploy (https://docs.aws.amazon.com/cli/latest/reference/deploy/index.html) // -// - AWS CodeDeploy Developer Forum (https://forums.aws.amazon.com/forum.jspa?forumID=179) +// - CodeDeploy Developer Forum (https://forums.aws.amazon.com/forum.jspa?forumID=179) // // See https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06 for more information on this service. // diff --git a/service/codedeploy/errors.go b/service/codedeploy/errors.go index 11057d7b21..02478bb2b3 100644 --- a/service/codedeploy/errors.go +++ b/service/codedeploy/errors.go @@ -17,14 +17,14 @@ const ( // ErrCodeApplicationAlreadyExistsException for service response error code // "ApplicationAlreadyExistsException". // - // An application with the specified name with the IAM user or AWS account already - // exists. + // An application with the specified name with the IAM user or Amazon Web Services + // account already exists. ErrCodeApplicationAlreadyExistsException = "ApplicationAlreadyExistsException" // ErrCodeApplicationDoesNotExistException for service response error code // "ApplicationDoesNotExistException". // - // The application does not exist with the IAM user or AWS account. + // The application does not exist with the IAM user or Amazon Web Services account. ErrCodeApplicationDoesNotExistException = "ApplicationDoesNotExistException" // ErrCodeApplicationLimitExceededException for service response error code @@ -67,14 +67,15 @@ const ( // ErrCodeDeploymentConfigAlreadyExistsException for service response error code // "DeploymentConfigAlreadyExistsException". // - // A deployment configuration with the specified name with the IAM user or AWS - // account already exists. + // A deployment configuration with the specified name with the IAM user or Amazon + // Web Services account already exists. ErrCodeDeploymentConfigAlreadyExistsException = "DeploymentConfigAlreadyExistsException" // ErrCodeDeploymentConfigDoesNotExistException for service response error code // "DeploymentConfigDoesNotExistException". // - // The deployment configuration does not exist with the IAM user or AWS account. + // The deployment configuration does not exist with the IAM user or Amazon Web + // Services account. ErrCodeDeploymentConfigDoesNotExistException = "DeploymentConfigDoesNotExistException" // ErrCodeDeploymentConfigInUseException for service response error code @@ -98,20 +99,22 @@ const ( // ErrCodeDeploymentDoesNotExistException for service response error code // "DeploymentDoesNotExistException". // - // The deployment with the IAM user or AWS account does not exist. + // The deployment with the IAM user or Amazon Web Services account does not + // exist. ErrCodeDeploymentDoesNotExistException = "DeploymentDoesNotExistException" // ErrCodeDeploymentGroupAlreadyExistsException for service response error code // "DeploymentGroupAlreadyExistsException". // - // A deployment group with the specified name with the IAM user or AWS account - // already exists. + // A deployment group with the specified name with the IAM user or Amazon Web + // Services account already exists. ErrCodeDeploymentGroupAlreadyExistsException = "DeploymentGroupAlreadyExistsException" // ErrCodeDeploymentGroupDoesNotExistException for service response error code // "DeploymentGroupDoesNotExistException". // - // The named deployment group with the IAM user or AWS account does not exist. + // The named deployment group with the IAM user or Amazon Web Services account + // does not exist. ErrCodeDeploymentGroupDoesNotExistException = "DeploymentGroupDoesNotExistException" // ErrCodeDeploymentGroupLimitExceededException for service response error code @@ -166,7 +169,7 @@ const ( // "DeploymentTargetListSizeExceededException". // // The maximum number of targets that can be associated with an Amazon ECS or - // AWS Lambda deployment was exceeded. The target list of both types of deployments + // Lambda deployment was exceeded. The target list of both types of deployments // must have exactly one item. This exception does not apply to EC2/On-premises // deployments. ErrCodeDeploymentTargetListSizeExceededException = "DeploymentTargetListSizeExceededException" @@ -407,7 +410,7 @@ const ( // ErrCodeInvalidFileExistsBehaviorException for service response error code // "InvalidFileExistsBehaviorException". // - // An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy + // An invalid fileExistsBehavior option was specified to determine how CodeDeploy // handles files or directories that already exist in a deployment target location, // but weren't part of the previous successful deployment. Valid values include // "DISALLOW," "OVERWRITE," and "RETAIN." @@ -440,7 +443,7 @@ const ( // ErrCodeInvalidIgnoreApplicationStopFailuresValueException for service response error code // "InvalidIgnoreApplicationStopFailuresValueException". // - // The IgnoreApplicationStopFailures value is invalid. For AWS Lambda deployments, + // The IgnoreApplicationStopFailures value is invalid. For Lambda deployments, // false is expected. For EC2/On-premises deployments, true or false is expected. ErrCodeInvalidIgnoreApplicationStopFailuresValueException = "InvalidIgnoreApplicationStopFailuresValueException" @@ -621,7 +624,7 @@ const ( // ErrCodeInvalidUpdateOutdatedInstancesOnlyValueException for service response error code // "InvalidUpdateOutdatedInstancesOnlyValueException". // - // The UpdateOutdatedInstancesOnly value is invalid. For AWS Lambda deployments, + // The UpdateOutdatedInstancesOnly value is invalid. For Lambda deployments, // false is expected. For EC2/On-premises deployments, true or false is expected. ErrCodeInvalidUpdateOutdatedInstancesOnlyValueException = "InvalidUpdateOutdatedInstancesOnlyValueException" @@ -665,7 +668,8 @@ const ( // ErrCodeRevisionDoesNotExistException for service response error code // "RevisionDoesNotExistException". // - // The named revision does not exist with the IAM user or AWS account. + // The named revision does not exist with the IAM user or Amazon Web Services + // account. ErrCodeRevisionDoesNotExistException = "RevisionDoesNotExistException" // ErrCodeRevisionRequiredException for service response error code diff --git a/service/devopsguru/api.go b/service/devopsguru/api.go index 19072b1c94..b2dc38becf 100644 --- a/service/devopsguru/api.go +++ b/service/devopsguru/api.go @@ -4888,11 +4888,12 @@ type CostEstimationResourceCollectionFilter struct { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. Tags []*TagCostEstimationResourceCollectionFilter `type:"list"` } @@ -5970,11 +5971,12 @@ type DescribeOrganizationResourceCollectionHealthOutput struct { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. Tags []*TagHealth `type:"list"` } @@ -6132,11 +6134,12 @@ type DescribeResourceCollectionHealthOutput struct { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. Tags []*TagHealth `type:"list"` } @@ -8736,6 +8739,11 @@ func (s *NotificationChannel) SetId(v string) *NotificationChannel { type NotificationChannelConfig struct { _ struct{} `type:"structure"` + // The filter configurations for the Amazon SNS notification topic you use with + // DevOps Guru. If you do not provide filter configurations, the default configurations + // are to receive notifications for all message types of High or Medium severity. + Filters *NotificationFilterConfig `type:"structure"` + // Information about a notification channel configured in DevOps Guru to send // notifications when insights are created. // @@ -8796,12 +8804,67 @@ func (s *NotificationChannelConfig) Validate() error { return nil } +// SetFilters sets the Filters field's value. +func (s *NotificationChannelConfig) SetFilters(v *NotificationFilterConfig) *NotificationChannelConfig { + s.Filters = v + return s +} + // SetSns sets the Sns field's value. func (s *NotificationChannelConfig) SetSns(v *SnsChannelConfig) *NotificationChannelConfig { s.Sns = v return s } +// The filter configurations for the Amazon SNS notification topic you use with +// DevOps Guru. You can choose to specify which events or message types to receive +// notifications for. You can also choose to specify which severity levels to +// receive notifications for. +type NotificationFilterConfig struct { + _ struct{} `type:"structure"` + + // The events that you want to receive notifications for. For example, you can + // choose to receive notifications only when the severity level is upgraded + // or a new insight is created. + MessageTypes []*string `type:"list" enum:"NotificationMessageType"` + + // The severity levels that you want to receive notifications for. For example, + // you can choose to receive notifications only for insights with HIGH and MEDIUM + // severity levels. For more information, see Understanding insight severities + // (https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities). + Severities []*string `type:"list" enum:"InsightSeverity"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s NotificationFilterConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s NotificationFilterConfig) GoString() string { + return s.String() +} + +// SetMessageTypes sets the MessageTypes field's value. +func (s *NotificationFilterConfig) SetMessageTypes(v []*string) *NotificationFilterConfig { + s.MessageTypes = v + return s +} + +// SetSeverities sets the Severities field's value. +func (s *NotificationFilterConfig) SetSeverities(v []*string) *NotificationFilterConfig { + s.Severities = v + return s +} + // Information about whether DevOps Guru is configured to create an OpsItem // in Amazon Web Services Systems Manager OpsCenter for each created insight. type OpsCenterIntegration struct { @@ -11280,11 +11343,12 @@ type ResourceCollection struct { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. Tags []*TagCollection `type:"list"` } @@ -11373,11 +11437,12 @@ type ResourceCollectionFilter struct { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. Tags []*TagCollectionFilter `type:"list"` } @@ -12464,7 +12529,7 @@ func (s *StartTimeRange) SetToTime(v time.Time) *StartTimeRange { return s } -// A collection of Amazon Web Services stags. +// A collection of Amazon Web Services tags. // // Tags help you identify and organize your Amazon Web Services resources. Many // Amazon Web Services services support tagging, so you can assign the same @@ -12486,11 +12551,12 @@ func (s *StartTimeRange) SetToTime(v time.Time) *StartTimeRange { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage -// must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application -// or Devops-guru-rds-application. While keys are case-sensitive, the case of -// key characters don't matter to DevOps Guru. For example, DevOps Guru works -// with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible -// key/value pairs in your application might be Devops-Guru-production-application/RDS +// must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application +// or devops-guru-rds-application. When you create a key, the case of characters +// in the key can be whatever you choose. After you create a key, it is case-sensitive. +// For example, DevOps Guru works with a key named devops-guru-rds and a key +// named DevOps-Guru-RDS, and these act as two different keys. Possible key/value +// pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. type TagCollection struct { _ struct{} `type:"structure"` @@ -12501,11 +12567,12 @@ type TagCollection struct { // and analysis boundary. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. // // AppBoundaryKey is a required field @@ -12584,11 +12651,12 @@ type TagCollectionFilter struct { // and analysis boundary. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. // // AppBoundaryKey is a required field @@ -12653,11 +12721,12 @@ type TagCostEstimationResourceCollectionFilter struct { // and analysis boundary. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. // // AppBoundaryKey is a required field @@ -12738,11 +12807,12 @@ type TagHealth struct { // and analysis boundary. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. AppBoundaryKey *string `min:"1" type:"string"` @@ -13033,11 +13103,12 @@ type UpdateResourceCollectionFilter struct { // Together these are known as key-value pairs. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. Tags []*UpdateTagCollectionFilter `type:"list"` } @@ -13305,11 +13376,12 @@ type UpdateTagCollectionFilter struct { // and analysis boundary. // // The string used for a key in a tag that you use to define your resource coverage - // must begin with the prefix Devops-guru-. The tag key might be Devops-guru-deployment-application - // or Devops-guru-rds-application. While keys are case-sensitive, the case of - // key characters don't matter to DevOps Guru. For example, DevOps Guru works - // with a key named devops-guru-rds and a key named DevOps-Guru-RDS. Possible - // key/value pairs in your application might be Devops-Guru-production-application/RDS + // must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application + // or devops-guru-rds-application. When you create a key, the case of characters + // in the key can be whatever you choose. After you create a key, it is case-sensitive. + // For example, DevOps Guru works with a key named devops-guru-rds and a key + // named DevOps-Guru-RDS, and these act as two different keys. Possible key/value + // pairs in your application might be Devops-Guru-production-application/RDS // or Devops-Guru-production-application/containers. // // AppBoundaryKey is a required field @@ -13870,6 +13942,34 @@ func LogAnomalyType_Values() []string { } } +const ( + // NotificationMessageTypeNewInsight is a NotificationMessageType enum value + NotificationMessageTypeNewInsight = "NEW_INSIGHT" + + // NotificationMessageTypeClosedInsight is a NotificationMessageType enum value + NotificationMessageTypeClosedInsight = "CLOSED_INSIGHT" + + // NotificationMessageTypeNewAssociation is a NotificationMessageType enum value + NotificationMessageTypeNewAssociation = "NEW_ASSOCIATION" + + // NotificationMessageTypeSeverityUpgraded is a NotificationMessageType enum value + NotificationMessageTypeSeverityUpgraded = "SEVERITY_UPGRADED" + + // NotificationMessageTypeNewRecommendation is a NotificationMessageType enum value + NotificationMessageTypeNewRecommendation = "NEW_RECOMMENDATION" +) + +// NotificationMessageType_Values returns all elements of the NotificationMessageType enum +func NotificationMessageType_Values() []string { + return []string{ + NotificationMessageTypeNewInsight, + NotificationMessageTypeClosedInsight, + NotificationMessageTypeNewAssociation, + NotificationMessageTypeSeverityUpgraded, + NotificationMessageTypeNewRecommendation, + } +} + // Specifies if DevOps Guru is enabled to create an Amazon Web Services Systems // Manager OpsItem for each created insight. const ( diff --git a/service/dlm/api.go b/service/dlm/api.go index a0dbaa4d7a..930cd7fb3e 100644 --- a/service/dlm/api.go +++ b/service/dlm/api.go @@ -146,6 +146,9 @@ func (c *DLM) DeleteLifecyclePolicyRequest(input *DeleteLifecyclePolicyInput) (r // Deletes the specified lifecycle policy and halts the automated operations // that the policy specified. // +// For more information about deleting a policy, see Delete lifecycle policies +// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#delete). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -664,6 +667,9 @@ func (c *DLM) UpdateLifecyclePolicyRequest(input *UpdateLifecyclePolicyInput) (r // // Updates the specified lifecycle policy. // +// For more information about updating a policy, see Modify lifecycle policies +// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#modify). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -778,6 +784,112 @@ func (s *Action) SetName(v string) *Action { return s } +// [Snapshot policies only] Specifies information about the archive storage +// tier retention period. +type ArchiveRetainRule struct { + _ struct{} `type:"structure"` + + // Information about retention period in the Amazon EBS Snapshots Archive. For + // more information, see Archive Amazon EBS snapshots (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/snapshot-archive.html). + // + // RetentionArchiveTier is a required field + RetentionArchiveTier *RetentionArchiveTier `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ArchiveRetainRule) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ArchiveRetainRule) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ArchiveRetainRule) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ArchiveRetainRule"} + if s.RetentionArchiveTier == nil { + invalidParams.Add(request.NewErrParamRequired("RetentionArchiveTier")) + } + if s.RetentionArchiveTier != nil { + if err := s.RetentionArchiveTier.Validate(); err != nil { + invalidParams.AddNested("RetentionArchiveTier", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetRetentionArchiveTier sets the RetentionArchiveTier field's value. +func (s *ArchiveRetainRule) SetRetentionArchiveTier(v *RetentionArchiveTier) *ArchiveRetainRule { + s.RetentionArchiveTier = v + return s +} + +// [Snapshot policies only] Specifies a snapshot archiving rule for a schedule. +type ArchiveRule struct { + _ struct{} `type:"structure"` + + // Information about the retention period for the snapshot archiving rule. + // + // RetainRule is a required field + RetainRule *ArchiveRetainRule `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ArchiveRule) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ArchiveRule) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ArchiveRule) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ArchiveRule"} + if s.RetainRule == nil { + invalidParams.Add(request.NewErrParamRequired("RetainRule")) + } + if s.RetainRule != nil { + if err := s.RetainRule.Validate(); err != nil { + invalidParams.AddNested("RetainRule", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetRetainRule sets the RetainRule field's value. +func (s *ArchiveRule) SetRetainRule(v *ArchiveRetainRule) *ArchiveRule { + s.RetainRule = v + return s +} + type CreateLifecyclePolicyInput struct { _ struct{} `type:"structure"` @@ -919,8 +1031,11 @@ func (s *CreateLifecyclePolicyOutput) SetPolicyId(v string) *CreateLifecyclePoli // [Snapshot and AMI policies only] Specifies when the policy should create // snapshots or AMIs. // -// You must specify either a Cron expression or an interval, interval unit, -// and start time. You cannot specify both. +// - You must specify either CronExpression, or Interval, IntervalUnit, and +// Times. +// +// - If you need to specify an ArchiveRule for the schedule, then you must +// specify a creation frequency of at least 28 days. type CreateRule struct { _ struct{} `type:"structure"` @@ -950,8 +1065,8 @@ type CreateRule struct { // The time, in UTC, to start the operation. The supported format is hh:mm. // // The operation occurs within a one-hour window following the specified time. - // If you do not specify a time, Amazon DLM selects a time within the next 24 - // hours. + // If you do not specify a time, Amazon Data Lifecycle Manager selects a time + // within the next 24 hours. Times []*string `type:"list"` } @@ -1709,7 +1824,7 @@ func (s *EventSource) SetType(v string) *EventSource { } // [Snapshot policies only] Specifies a rule for enabling fast snapshot restore -// for snapshots created by snaspshot policies. You can enable fast snapshot +// for snapshots created by snapshot policies. You can enable fast snapshot // restore based on either a count or a time interval. type FastRestoreRule struct { _ struct{} `type:"structure"` @@ -2475,9 +2590,9 @@ func (s *ListTagsForResourceOutput) SetTags(v map[string]*string) *ListTagsForRe // // If you choose to exclude boot volumes and you specify tags that consequently // exclude all of the additional data volumes attached to an instance, then -// Amazon DLM will not create any snapshots for the affected instance, and it -// will emit a SnapshotsCreateFailed Amazon CloudWatch metric. For more information, -// see Monitor your policies using Amazon CloudWatch (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitor-dlm-cw-metrics.html). +// Amazon Data Lifecycle Manager will not create any snapshots for the affected +// instance, and it will emit a SnapshotsCreateFailed Amazon CloudWatch metric. +// For more information, see Monitor your policies using Amazon CloudWatch (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitor-dlm-cw-metrics.html). type Parameters struct { _ struct{} `type:"structure"` @@ -2819,21 +2934,45 @@ func (s *ResourceNotFoundException) RequestID() string { } // [Snapshot and AMI policies only] Specifies a retention rule for snapshots -// created by snapshot policies or for AMIs created by AMI policies. You can -// retain snapshots based on either a count or a time interval. +// created by snapshot policies, or for AMIs created by AMI policies. +// +// For snapshot policies that have an ArchiveRule, this retention rule applies +// to standard tier retention. When the retention threshold is met, snapshots +// are moved from the standard to the archive tier. +// +// For snapshot policies that do not have an ArchiveRule, snapshots are permanently +// deleted when this retention threshold is met. +// +// You can retain snapshots based on either a count or a time interval. +// +// - Count-based retention You must specify Count. If you specify an ArchiveRule +// for the schedule, then you can specify a retention count of 0 to archive +// snapshots immediately after creation. If you specify a FastRestoreRule, +// ShareRule, or a CrossRegionCopyRule, then you must specify a retention +// count of 1 or more. // -// You must specify either Count, or Interval and IntervalUnit. +// - Age-based retention You must specify Interval and IntervalUnit. If you +// specify an ArchiveRule for the schedule, then you can specify a retention +// interval of 0 days to archive snapshots immediately after creation. If +// you specify a FastRestoreRule, ShareRule, or a CrossRegionCopyRule, then +// you must specify a retention interval of 1 day or more. type RetainRule struct { _ struct{} `type:"structure"` // The number of snapshots to retain for each volume, up to a maximum of 1000. - Count *int64 `min:"1" type:"integer"` + // For example if you want to retain a maximum of three snapshots, specify 3. + // When the fourth snapshot is created, the oldest retained snapshot is deleted, + // or it is moved to the archive tier if you have specified an ArchiveRule. + Count *int64 `type:"integer"` // The amount of time to retain each snapshot. The maximum is 100 years. This // is equivalent to 1200 months, 5200 weeks, or 36500 days. - Interval *int64 `min:"1" type:"integer"` + Interval *int64 `type:"integer"` - // The unit of time for time-based retention. + // The unit of time for time-based retention. For example, to retain snapshots + // for 3 months, specify Interval=3 and IntervalUnit=MONTHS. Once the snapshot + // has been retained for 3 months, it is deleted, or it is moved to the archive + // tier if you have specified an ArchiveRule. IntervalUnit *string `type:"string" enum:"RetentionIntervalUnitValues"` } @@ -2855,9 +2994,76 @@ func (s RetainRule) GoString() string { return s.String() } +// SetCount sets the Count field's value. +func (s *RetainRule) SetCount(v int64) *RetainRule { + s.Count = &v + return s +} + +// SetInterval sets the Interval field's value. +func (s *RetainRule) SetInterval(v int64) *RetainRule { + s.Interval = &v + return s +} + +// SetIntervalUnit sets the IntervalUnit field's value. +func (s *RetainRule) SetIntervalUnit(v string) *RetainRule { + s.IntervalUnit = &v + return s +} + +// [Snapshot policies only] Describes the retention rule for archived snapshots. +// Once the archive retention threshold is met, the snapshots are permanently +// deleted from the archive tier. +// +// The archive retention rule must retain snapshots in the archive tier for +// a minimum of 90 days. +// +// For count-based schedules, you must specify Count. For age-based schedules, +// you must specify Interval and IntervalUnit. +// +// For more information about using snapshot archiving, see Considerations for +// snapshot lifecycle policies (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-ami-policy.html#dlm-archive). +type RetentionArchiveTier struct { + _ struct{} `type:"structure"` + + // The maximum number of snapshots to retain in the archive storage tier for + // each volume. The count must ensure that each snapshot remains in the archive + // tier for at least 90 days. For example, if the schedule creates snapshots + // every 30 days, you must specify a count of 3 or more to ensure that each + // snapshot is archived for at least 90 days. + Count *int64 `min:"1" type:"integer"` + + // Specifies the period of time to retain snapshots in the archive tier. After + // this period expires, the snapshot is permanently deleted. + Interval *int64 `min:"1" type:"integer"` + + // The unit of time in which to measure the Interval. For example, to retain + // a snapshots in the archive tier for 6 months, specify Interval=6 and IntervalUnit=MONTHS. + IntervalUnit *string `type:"string" enum:"RetentionIntervalUnitValues"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s RetentionArchiveTier) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s RetentionArchiveTier) GoString() string { + return s.String() +} + // Validate inspects the fields of the type to determine if they are valid. -func (s *RetainRule) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "RetainRule"} +func (s *RetentionArchiveTier) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "RetentionArchiveTier"} if s.Count != nil && *s.Count < 1 { invalidParams.Add(request.NewErrParamMinValue("Count", 1)) } @@ -2872,19 +3078,19 @@ func (s *RetainRule) Validate() error { } // SetCount sets the Count field's value. -func (s *RetainRule) SetCount(v int64) *RetainRule { +func (s *RetentionArchiveTier) SetCount(v int64) *RetentionArchiveTier { s.Count = &v return s } // SetInterval sets the Interval field's value. -func (s *RetainRule) SetInterval(v int64) *RetainRule { +func (s *RetentionArchiveTier) SetInterval(v int64) *RetentionArchiveTier { s.Interval = &v return s } // SetIntervalUnit sets the IntervalUnit field's value. -func (s *RetainRule) SetIntervalUnit(v string) *RetainRule { +func (s *RetentionArchiveTier) SetIntervalUnit(v string) *RetentionArchiveTier { s.IntervalUnit = &v return s } @@ -2894,6 +3100,16 @@ func (s *RetainRule) SetIntervalUnit(v string) *RetainRule { type Schedule struct { _ struct{} `type:"structure"` + // [Snapshot policies that target volumes only] The snapshot archiving rule + // for the schedule. When you specify an archiving rule, snapshots are automatically + // moved from the standard tier to the archive tier once the schedule's retention + // threshold is met. Snapshots are then retained in the archive tier for the + // archive retention period that you specify. + // + // For more information about using snapshot archiving, see Considerations for + // snapshot lifecycle policies (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-ami-policy.html#dlm-archive). + ArchiveRule *ArchiveRule `type:"structure"` + // Copy all user-defined tags on a source volume to snapshots of the volume // created by this policy. CopyTags *bool `type:"boolean"` @@ -2957,6 +3173,11 @@ func (s Schedule) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *Schedule) Validate() error { invalidParams := request.ErrInvalidParams{Context: "Schedule"} + if s.ArchiveRule != nil { + if err := s.ArchiveRule.Validate(); err != nil { + invalidParams.AddNested("ArchiveRule", err.(request.ErrInvalidParams)) + } + } if s.CreateRule != nil { if err := s.CreateRule.Validate(); err != nil { invalidParams.AddNested("CreateRule", err.(request.ErrInvalidParams)) @@ -2982,11 +3203,6 @@ func (s *Schedule) Validate() error { invalidParams.AddNested("FastRestoreRule", err.(request.ErrInvalidParams)) } } - if s.RetainRule != nil { - if err := s.RetainRule.Validate(); err != nil { - invalidParams.AddNested("RetainRule", err.(request.ErrInvalidParams)) - } - } if s.ShareRules != nil { for i, v := range s.ShareRules { if v == nil { @@ -3024,6 +3240,12 @@ func (s *Schedule) Validate() error { return nil } +// SetArchiveRule sets the ArchiveRule field's value. +func (s *Schedule) SetArchiveRule(v *ArchiveRule) *Schedule { + s.ArchiveRule = v + return s +} + // SetCopyTags sets the CopyTags field's value. func (s *Schedule) SetCopyTags(v bool) *Schedule { s.CopyTags = &v diff --git a/service/dlm/doc.go b/service/dlm/doc.go index fed64595cd..d22bb8bf5f 100644 --- a/service/dlm/doc.go +++ b/service/dlm/doc.go @@ -7,9 +7,9 @@ // Amazon Web Services resources. You create lifecycle policies, which are used // to automate operations on the specified resources. // -// Amazon DLM supports Amazon EBS volumes and snapshots. For information about -// using Amazon DLM with Amazon EBS, see Automating the Amazon EBS Snapshot -// Lifecycle (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html) +// Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. +// For information about using Amazon Data Lifecycle Manager with Amazon EBS, +// see Amazon Data Lifecycle Manager (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html) // in the Amazon EC2 User Guide. // // See https://docs.aws.amazon.com/goto/WebAPI/dlm-2018-01-12 for more information on this service. diff --git a/service/sagemaker/api.go b/service/sagemaker/api.go index e5375b1390..374d6867fa 100644 --- a/service/sagemaker/api.go +++ b/service/sagemaker/api.go @@ -30225,6 +30225,564 @@ func (s *ClarifyCheckStepMetadata) SetViolationReport(v string) *ClarifyCheckSte return s } +// The configuration parameters for the SageMaker Clarify explainer. +type ClarifyExplainerConfig struct { + _ struct{} `type:"structure"` + + // A JMESPath boolean expression used to filter which records to explain. Explanations + // are activated by default. See EnableExplanations (https://docs.aws.amazon.com/sagemaker-dg/src/AWSIronmanApiDoc/build/server-root/sagemaker/latest/dg/clarify-online-explainability-create-endpoint.html#clarify-online-explainability-create-endpoint-enable)for + // additional information. + EnableExplanations *string `min:"1" type:"string"` + + // The inference configuration parameter for the model container. + InferenceConfig *ClarifyInferenceConfig `type:"structure"` + + // The configuration for SHAP analysis. + // + // ShapConfig is a required field + ShapConfig *ClarifyShapConfig `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyExplainerConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyExplainerConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ClarifyExplainerConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ClarifyExplainerConfig"} + if s.EnableExplanations != nil && len(*s.EnableExplanations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("EnableExplanations", 1)) + } + if s.ShapConfig == nil { + invalidParams.Add(request.NewErrParamRequired("ShapConfig")) + } + if s.InferenceConfig != nil { + if err := s.InferenceConfig.Validate(); err != nil { + invalidParams.AddNested("InferenceConfig", err.(request.ErrInvalidParams)) + } + } + if s.ShapConfig != nil { + if err := s.ShapConfig.Validate(); err != nil { + invalidParams.AddNested("ShapConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEnableExplanations sets the EnableExplanations field's value. +func (s *ClarifyExplainerConfig) SetEnableExplanations(v string) *ClarifyExplainerConfig { + s.EnableExplanations = &v + return s +} + +// SetInferenceConfig sets the InferenceConfig field's value. +func (s *ClarifyExplainerConfig) SetInferenceConfig(v *ClarifyInferenceConfig) *ClarifyExplainerConfig { + s.InferenceConfig = v + return s +} + +// SetShapConfig sets the ShapConfig field's value. +func (s *ClarifyExplainerConfig) SetShapConfig(v *ClarifyShapConfig) *ClarifyExplainerConfig { + s.ShapConfig = v + return s +} + +// The inference configuration parameter for the model container. +type ClarifyInferenceConfig struct { + _ struct{} `type:"structure"` + + // A template string used to format a JSON record into an acceptable model container + // input. For example, a ContentTemplate string '{"myfeatures":$features}' will + // format a list of features [1,2,3] into the record string '{"myfeatures":[1,2,3]}'. + // Required only when the model container input is in JSON Lines format. + ContentTemplate *string `min:"1" type:"string"` + + // The names of the features. If provided, these are included in the endpoint + // response payload to help readability of the InvokeEndpoint output. See the + // Response (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-invoke-endpoint.html#clarify-online-explainability-response) + // section under Invoke the endpoint in the Developer Guide for more information. + FeatureHeaders []*string `min:"1" type:"list"` + + // A list of data types of the features (optional). Applicable only to NLP explainability. + // If provided, FeatureTypes must have at least one 'text' string (for example, + // ['text']). If FeatureTypes is not provided, the explainer infers the feature + // types based on the baseline data. The feature types are included in the endpoint + // response payload. For additional information see the response (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-invoke-endpoint.html#clarify-online-explainability-response) + // section under Invoke the endpoint in the Developer Guide for more information. + FeatureTypes []*string `min:"1" type:"list" enum:"ClarifyFeatureType"` + + // Provides the JMESPath expression to extract the features from a model container + // input in JSON Lines format. For example, if FeaturesAttribute is the JMESPath + // expression 'myfeatures', it extracts a list of features [1,2,3] from request + // data '{"myfeatures":[1,2,3}'. + FeaturesAttribute *string `min:"1" type:"string"` + + // A JMESPath expression used to locate the list of label headers in the model + // container output. + // + // Example: If the model container output of a batch request is '{"labels":["cat","dog","fish"],"probability":[0.6,0.3,0.1]}', + // then set LabelAttribute to 'labels' to extract the list of label headers + // ["cat","dog","fish"] + LabelAttribute *string `min:"1" type:"string"` + + // For multiclass classification problems, the label headers are the names of + // the classes. Otherwise, the label header is the name of the predicted label. + // These are used to help readability for the output of the InvokeEndpoint API. + // See the response (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-invoke-endpoint.html#clarify-online-explainability-response) + // section under Invoke the endpoint in the Developer Guide for more information. + // If there are no label headers in the model container output, provide them + // manually using this parameter. + LabelHeaders []*string `min:"1" type:"list"` + + // A zero-based index used to extract a label header or list of label headers + // from model container output in CSV format. + // + // Example for a multiclass model: If the model container output consists of + // label headers followed by probabilities: '"[\'cat\',\'dog\',\'fish\']","[0.1,0.6,0.3]"', + // set LabelIndex to 0 to select the label headers ['cat','dog','fish']. + LabelIndex *int64 `type:"integer"` + + // The maximum payload size (MB) allowed of a request from the explainer to + // the model container. Defaults to 6 MB. + MaxPayloadInMB *int64 `min:"1" type:"integer"` + + // The maximum number of records in a request that the model container can process + // when querying the model container for the predictions of a synthetic dataset + // (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-create-endpoint.html#clarify-online-explainability-create-endpoint-synthetic). + // A record is a unit of input data that inference can be made on, for example, + // a single line in CSV data. If MaxRecordCount is 1, the model container expects + // one record per request. A value of 2 or greater means that the model expects + // batch requests, which can reduce overhead and speed up the inferencing process. + // If this parameter is not provided, the explainer will tune the record count + // per request according to the model container's capacity at runtime. + MaxRecordCount *int64 `min:"1" type:"integer"` + + // A JMESPath expression used to extract the probability (or score) from the + // model container output if the model container is in JSON Lines format. + // + // Example: If the model container output of a single request is '{"predicted_label":1,"probability":0.6}', + // then set ProbabilityAttribute to 'probability'. + ProbabilityAttribute *string `min:"1" type:"string"` + + // A zero-based index used to extract a probability value (score) or list from + // model container output in CSV format. If this value is not provided, the + // entire model container output will be treated as a probability value (score) + // or list. + // + // Example for a single class model: If the model container output consists + // of a string-formatted prediction label followed by its probability: '1,0.6', + // set ProbabilityIndex to 1 to select the probability value 0.6. + // + // Example for a multiclass model: If the model container output consists of + // a string-formatted prediction label followed by its probability: '"[\'cat\',\'dog\',\'fish\']","[0.1,0.6,0.3]"', + // set ProbabilityIndex to 1 to select the probability values [0.1,0.6,0.3]. + ProbabilityIndex *int64 `type:"integer"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyInferenceConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyInferenceConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ClarifyInferenceConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ClarifyInferenceConfig"} + if s.ContentTemplate != nil && len(*s.ContentTemplate) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ContentTemplate", 1)) + } + if s.FeatureHeaders != nil && len(s.FeatureHeaders) < 1 { + invalidParams.Add(request.NewErrParamMinLen("FeatureHeaders", 1)) + } + if s.FeatureTypes != nil && len(s.FeatureTypes) < 1 { + invalidParams.Add(request.NewErrParamMinLen("FeatureTypes", 1)) + } + if s.FeaturesAttribute != nil && len(*s.FeaturesAttribute) < 1 { + invalidParams.Add(request.NewErrParamMinLen("FeaturesAttribute", 1)) + } + if s.LabelAttribute != nil && len(*s.LabelAttribute) < 1 { + invalidParams.Add(request.NewErrParamMinLen("LabelAttribute", 1)) + } + if s.LabelHeaders != nil && len(s.LabelHeaders) < 1 { + invalidParams.Add(request.NewErrParamMinLen("LabelHeaders", 1)) + } + if s.MaxPayloadInMB != nil && *s.MaxPayloadInMB < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxPayloadInMB", 1)) + } + if s.MaxRecordCount != nil && *s.MaxRecordCount < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxRecordCount", 1)) + } + if s.ProbabilityAttribute != nil && len(*s.ProbabilityAttribute) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProbabilityAttribute", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetContentTemplate sets the ContentTemplate field's value. +func (s *ClarifyInferenceConfig) SetContentTemplate(v string) *ClarifyInferenceConfig { + s.ContentTemplate = &v + return s +} + +// SetFeatureHeaders sets the FeatureHeaders field's value. +func (s *ClarifyInferenceConfig) SetFeatureHeaders(v []*string) *ClarifyInferenceConfig { + s.FeatureHeaders = v + return s +} + +// SetFeatureTypes sets the FeatureTypes field's value. +func (s *ClarifyInferenceConfig) SetFeatureTypes(v []*string) *ClarifyInferenceConfig { + s.FeatureTypes = v + return s +} + +// SetFeaturesAttribute sets the FeaturesAttribute field's value. +func (s *ClarifyInferenceConfig) SetFeaturesAttribute(v string) *ClarifyInferenceConfig { + s.FeaturesAttribute = &v + return s +} + +// SetLabelAttribute sets the LabelAttribute field's value. +func (s *ClarifyInferenceConfig) SetLabelAttribute(v string) *ClarifyInferenceConfig { + s.LabelAttribute = &v + return s +} + +// SetLabelHeaders sets the LabelHeaders field's value. +func (s *ClarifyInferenceConfig) SetLabelHeaders(v []*string) *ClarifyInferenceConfig { + s.LabelHeaders = v + return s +} + +// SetLabelIndex sets the LabelIndex field's value. +func (s *ClarifyInferenceConfig) SetLabelIndex(v int64) *ClarifyInferenceConfig { + s.LabelIndex = &v + return s +} + +// SetMaxPayloadInMB sets the MaxPayloadInMB field's value. +func (s *ClarifyInferenceConfig) SetMaxPayloadInMB(v int64) *ClarifyInferenceConfig { + s.MaxPayloadInMB = &v + return s +} + +// SetMaxRecordCount sets the MaxRecordCount field's value. +func (s *ClarifyInferenceConfig) SetMaxRecordCount(v int64) *ClarifyInferenceConfig { + s.MaxRecordCount = &v + return s +} + +// SetProbabilityAttribute sets the ProbabilityAttribute field's value. +func (s *ClarifyInferenceConfig) SetProbabilityAttribute(v string) *ClarifyInferenceConfig { + s.ProbabilityAttribute = &v + return s +} + +// SetProbabilityIndex sets the ProbabilityIndex field's value. +func (s *ClarifyInferenceConfig) SetProbabilityIndex(v int64) *ClarifyInferenceConfig { + s.ProbabilityIndex = &v + return s +} + +// The configuration for the SHAP baseline (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-feature-attribute-shap-baselines.html) +// (also called the background or reference dataset) of the Kernal SHAP algorithm. +// +// - The number of records in the baseline data determines the size of the +// synthetic dataset, which has an impact on latency of explainability requests. +// For more information, see the Synthetic data of Configure and create an +// endpoint (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-create-endpoint.html). +// +// - ShapBaseline and ShapBaselineUri are mutually exclusive parameters. +// One or the either is required to configure a SHAP baseline. +type ClarifyShapBaselineConfig struct { + _ struct{} `type:"structure"` + + // The MIME type of the baseline data. Choose from 'text/csv' or 'application/jsonlines'. + // Defaults to 'text/csv'. + MimeType *string `type:"string"` + + // The inline SHAP baseline data in string format. ShapBaseline can have one + // or multiple records to be used as the baseline dataset. The format of the + // SHAP baseline file should be the same format as the training dataset. For + // example, if the training dataset is in CSV format and each record contains + // four features, and all features are numerical, then the format of the baseline + // data should also share these characteristics. For natural language processing + // (NLP) of text columns, the baseline value should be the value used to replace + // the unit of text specified by the Granularity of the TextConfig parameter. + // The size limit for ShapBasline is 4 KB. Use the ShapBaselineUri parameter + // if you want to provide more than 4 KB of baseline data. + ShapBaseline *string `min:"1" type:"string"` + + // The uniform resource identifier (URI) of the S3 bucket where the SHAP baseline + // file is stored. The format of the SHAP baseline file should be the same format + // as the format of the training dataset. For example, if the training dataset + // is in CSV format, and each record in the training dataset has four features, + // and all features are numerical, then the baseline file should also have this + // same format. Each record should contain only the features. If you are using + // a virtual private cloud (VPC), the ShapBaselineUri should be accessible to + // the VPC. For more information about setting up endpoints with Amazon Virtual + // Private Cloud, see Give SageMaker access to Resources in your Amazon Virtual + // Private Cloud (https://docs.aws.amazon.com/sagemaker/latest/dg/infrastructure-give-access.html). + ShapBaselineUri *string `type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyShapBaselineConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyShapBaselineConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ClarifyShapBaselineConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ClarifyShapBaselineConfig"} + if s.ShapBaseline != nil && len(*s.ShapBaseline) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ShapBaseline", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMimeType sets the MimeType field's value. +func (s *ClarifyShapBaselineConfig) SetMimeType(v string) *ClarifyShapBaselineConfig { + s.MimeType = &v + return s +} + +// SetShapBaseline sets the ShapBaseline field's value. +func (s *ClarifyShapBaselineConfig) SetShapBaseline(v string) *ClarifyShapBaselineConfig { + s.ShapBaseline = &v + return s +} + +// SetShapBaselineUri sets the ShapBaselineUri field's value. +func (s *ClarifyShapBaselineConfig) SetShapBaselineUri(v string) *ClarifyShapBaselineConfig { + s.ShapBaselineUri = &v + return s +} + +// The configuration for SHAP analysis using SageMaker Clarify Explainer. +type ClarifyShapConfig struct { + _ struct{} `type:"structure"` + + // The number of samples to be used for analysis by the Kernal SHAP algorithm. + // + // The number of samples determines the size of the synthetic dataset, which + // has an impact on latency of explainability requests. For more information, + // see the Synthetic data of Configure and create an endpoint (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-create-endpoint.html). + NumberOfSamples *int64 `min:"1" type:"integer"` + + // The starting value used to initialize the random number generator in the + // explainer. Provide a value for this parameter to obtain a deterministic SHAP + // result. + Seed *int64 `type:"integer"` + + // The configuration for the SHAP baseline of the Kernal SHAP algorithm. + // + // ShapBaselineConfig is a required field + ShapBaselineConfig *ClarifyShapBaselineConfig `type:"structure" required:"true"` + + // A parameter that indicates if text features are treated as text and explanations + // are provided for individual units of text. Required for natural language + // processing (NLP) explainability only. + TextConfig *ClarifyTextConfig `type:"structure"` + + // A Boolean toggle to indicate if you want to use the logit function (true) + // or log-odds units (false) for model predictions. Defaults to false. + UseLogit *bool `type:"boolean"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyShapConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyShapConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ClarifyShapConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ClarifyShapConfig"} + if s.NumberOfSamples != nil && *s.NumberOfSamples < 1 { + invalidParams.Add(request.NewErrParamMinValue("NumberOfSamples", 1)) + } + if s.ShapBaselineConfig == nil { + invalidParams.Add(request.NewErrParamRequired("ShapBaselineConfig")) + } + if s.ShapBaselineConfig != nil { + if err := s.ShapBaselineConfig.Validate(); err != nil { + invalidParams.AddNested("ShapBaselineConfig", err.(request.ErrInvalidParams)) + } + } + if s.TextConfig != nil { + if err := s.TextConfig.Validate(); err != nil { + invalidParams.AddNested("TextConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetNumberOfSamples sets the NumberOfSamples field's value. +func (s *ClarifyShapConfig) SetNumberOfSamples(v int64) *ClarifyShapConfig { + s.NumberOfSamples = &v + return s +} + +// SetSeed sets the Seed field's value. +func (s *ClarifyShapConfig) SetSeed(v int64) *ClarifyShapConfig { + s.Seed = &v + return s +} + +// SetShapBaselineConfig sets the ShapBaselineConfig field's value. +func (s *ClarifyShapConfig) SetShapBaselineConfig(v *ClarifyShapBaselineConfig) *ClarifyShapConfig { + s.ShapBaselineConfig = v + return s +} + +// SetTextConfig sets the TextConfig field's value. +func (s *ClarifyShapConfig) SetTextConfig(v *ClarifyTextConfig) *ClarifyShapConfig { + s.TextConfig = v + return s +} + +// SetUseLogit sets the UseLogit field's value. +func (s *ClarifyShapConfig) SetUseLogit(v bool) *ClarifyShapConfig { + s.UseLogit = &v + return s +} + +// A parameter used to configure the SageMaker Clarify explainer to treat text +// features as text so that explanations are provided for individual units of +// text. Required only for natural language processing (NLP) explainability. +type ClarifyTextConfig struct { + _ struct{} `type:"structure"` + + // The unit of granularity for the analysis of text features. For example, if + // the unit is 'token', then each token (like a word in English) of the text + // is treated as a feature. SHAP values are computed for each unit/feature. + // + // Granularity is a required field + Granularity *string `type:"string" required:"true" enum:"ClarifyTextGranularity"` + + // Specifies the language of the text features in ISO 639-1 (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) + // or ISO 639-3 (https://en.wikipedia.org/wiki/ISO_639-3) code of a supported + // language. + // + // For a mix of multiple languages, use code 'xx'. + // + // Language is a required field + Language *string `type:"string" required:"true" enum:"ClarifyTextLanguage"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyTextConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ClarifyTextConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ClarifyTextConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ClarifyTextConfig"} + if s.Granularity == nil { + invalidParams.Add(request.NewErrParamRequired("Granularity")) + } + if s.Language == nil { + invalidParams.Add(request.NewErrParamRequired("Language")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetGranularity sets the Granularity field's value. +func (s *ClarifyTextConfig) SetGranularity(v string) *ClarifyTextConfig { + s.Granularity = &v + return s +} + +// SetLanguage sets the Language field's value. +func (s *ClarifyTextConfig) SetLanguage(v string) *ClarifyTextConfig { + s.Language = &v + return s +} + // Specifies summary information about a Git repository. type CodeRepositorySummary struct { _ struct{} `type:"structure"` @@ -33844,6 +34402,9 @@ type CreateEndpointConfigInput struct { // EndpointConfigName is a required field EndpointConfigName *string `type:"string" required:"true"` + // A member of CreateEndpointConfig that enables explainers. + ExplainerConfig *ExplainerConfig `type:"structure"` + // The Amazon Resource Name (ARN) of a Amazon Web Services Key Management Service // key that SageMaker uses to encrypt data on the storage volume attached to // the ML compute instance that hosts the endpoint. @@ -33932,6 +34493,11 @@ func (s *CreateEndpointConfigInput) Validate() error { invalidParams.AddNested("DataCaptureConfig", err.(request.ErrInvalidParams)) } } + if s.ExplainerConfig != nil { + if err := s.ExplainerConfig.Validate(); err != nil { + invalidParams.AddNested("ExplainerConfig", err.(request.ErrInvalidParams)) + } + } if s.ProductionVariants != nil { for i, v := range s.ProductionVariants { if v == nil { @@ -33977,6 +34543,12 @@ func (s *CreateEndpointConfigInput) SetEndpointConfigName(v string) *CreateEndpo return s } +// SetExplainerConfig sets the ExplainerConfig field's value. +func (s *CreateEndpointConfigInput) SetExplainerConfig(v *ExplainerConfig) *CreateEndpointConfigInput { + s.ExplainerConfig = v + return s +} + // SetKmsKeyId sets the KmsKeyId field's value. func (s *CreateEndpointConfigInput) SetKmsKeyId(v string) *CreateEndpointConfigInput { s.KmsKeyId = &v @@ -47854,6 +48426,9 @@ type DescribeEndpointConfigOutput struct { // EndpointConfigName is a required field EndpointConfigName *string `type:"string" required:"true"` + // The configuration parameters for an explainer. + ExplainerConfig *ExplainerConfig `type:"structure"` + // Amazon Web Services KMS key ID Amazon SageMaker uses to encrypt data when // storing it on the ML storage volume attached to the instance. KmsKeyId *string `type:"string"` @@ -47913,6 +48488,12 @@ func (s *DescribeEndpointConfigOutput) SetEndpointConfigName(v string) *Describe return s } +// SetExplainerConfig sets the ExplainerConfig field's value. +func (s *DescribeEndpointConfigOutput) SetExplainerConfig(v *ExplainerConfig) *DescribeEndpointConfigOutput { + s.ExplainerConfig = v + return s +} + // SetKmsKeyId sets the KmsKeyId field's value. func (s *DescribeEndpointConfigOutput) SetKmsKeyId(v string) *DescribeEndpointConfigOutput { s.KmsKeyId = &v @@ -48034,6 +48615,9 @@ type DescribeEndpointOutput struct { // EndpointStatus is a required field EndpointStatus *string `type:"string" required:"true" enum:"EndpointStatus"` + // The configuration parameters for an explainer. + ExplainerConfig *ExplainerConfig `type:"structure"` + // If the status of the endpoint is Failed, the reason why it failed. FailureReason *string `type:"string"` @@ -48114,6 +48698,12 @@ func (s *DescribeEndpointOutput) SetEndpointStatus(v string) *DescribeEndpointOu return s } +// SetExplainerConfig sets the ExplainerConfig field's value. +func (s *DescribeEndpointOutput) SetExplainerConfig(v *ExplainerConfig) *DescribeEndpointOutput { + s.ExplainerConfig = v + return s +} + // SetFailureReason sets the FailureReason field's value. func (s *DescribeEndpointOutput) SetFailureReason(v string) *DescribeEndpointOutput { s.FailureReason = &v @@ -58067,6 +58657,54 @@ func (s *Explainability) SetReport(v *MetricsSource) *Explainability { return s } +// A parameter to activate explainers. +type ExplainerConfig struct { + _ struct{} `type:"structure"` + + // A member of ExplainerConfig that contains configuration parameters for the + // SageMaker Clarify explainer. + ClarifyExplainerConfig *ClarifyExplainerConfig `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ExplainerConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ExplainerConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ExplainerConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ExplainerConfig"} + if s.ClarifyExplainerConfig != nil { + if err := s.ClarifyExplainerConfig.Validate(); err != nil { + invalidParams.AddNested("ClarifyExplainerConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetClarifyExplainerConfig sets the ClarifyExplainerConfig field's value. +func (s *ExplainerConfig) SetClarifyExplainerConfig(v *ClarifyExplainerConfig) *ExplainerConfig { + s.ClarifyExplainerConfig = v + return s +} + // The container for the metadata for Fail step. type FailStepMetadata struct { _ struct{} `type:"structure"` @@ -99518,6 +100156,294 @@ func CaptureStatus_Values() []string { } } +const ( + // ClarifyFeatureTypeNumerical is a ClarifyFeatureType enum value + ClarifyFeatureTypeNumerical = "numerical" + + // ClarifyFeatureTypeCategorical is a ClarifyFeatureType enum value + ClarifyFeatureTypeCategorical = "categorical" + + // ClarifyFeatureTypeText is a ClarifyFeatureType enum value + ClarifyFeatureTypeText = "text" +) + +// ClarifyFeatureType_Values returns all elements of the ClarifyFeatureType enum +func ClarifyFeatureType_Values() []string { + return []string{ + ClarifyFeatureTypeNumerical, + ClarifyFeatureTypeCategorical, + ClarifyFeatureTypeText, + } +} + +const ( + // ClarifyTextGranularityToken is a ClarifyTextGranularity enum value + ClarifyTextGranularityToken = "token" + + // ClarifyTextGranularitySentence is a ClarifyTextGranularity enum value + ClarifyTextGranularitySentence = "sentence" + + // ClarifyTextGranularityParagraph is a ClarifyTextGranularity enum value + ClarifyTextGranularityParagraph = "paragraph" +) + +// ClarifyTextGranularity_Values returns all elements of the ClarifyTextGranularity enum +func ClarifyTextGranularity_Values() []string { + return []string{ + ClarifyTextGranularityToken, + ClarifyTextGranularitySentence, + ClarifyTextGranularityParagraph, + } +} + +const ( + // ClarifyTextLanguageAf is a ClarifyTextLanguage enum value + ClarifyTextLanguageAf = "af" + + // ClarifyTextLanguageSq is a ClarifyTextLanguage enum value + ClarifyTextLanguageSq = "sq" + + // ClarifyTextLanguageAr is a ClarifyTextLanguage enum value + ClarifyTextLanguageAr = "ar" + + // ClarifyTextLanguageHy is a ClarifyTextLanguage enum value + ClarifyTextLanguageHy = "hy" + + // ClarifyTextLanguageEu is a ClarifyTextLanguage enum value + ClarifyTextLanguageEu = "eu" + + // ClarifyTextLanguageBn is a ClarifyTextLanguage enum value + ClarifyTextLanguageBn = "bn" + + // ClarifyTextLanguageBg is a ClarifyTextLanguage enum value + ClarifyTextLanguageBg = "bg" + + // ClarifyTextLanguageCa is a ClarifyTextLanguage enum value + ClarifyTextLanguageCa = "ca" + + // ClarifyTextLanguageZh is a ClarifyTextLanguage enum value + ClarifyTextLanguageZh = "zh" + + // ClarifyTextLanguageHr is a ClarifyTextLanguage enum value + ClarifyTextLanguageHr = "hr" + + // ClarifyTextLanguageCs is a ClarifyTextLanguage enum value + ClarifyTextLanguageCs = "cs" + + // ClarifyTextLanguageDa is a ClarifyTextLanguage enum value + ClarifyTextLanguageDa = "da" + + // ClarifyTextLanguageNl is a ClarifyTextLanguage enum value + ClarifyTextLanguageNl = "nl" + + // ClarifyTextLanguageEn is a ClarifyTextLanguage enum value + ClarifyTextLanguageEn = "en" + + // ClarifyTextLanguageEt is a ClarifyTextLanguage enum value + ClarifyTextLanguageEt = "et" + + // ClarifyTextLanguageFi is a ClarifyTextLanguage enum value + ClarifyTextLanguageFi = "fi" + + // ClarifyTextLanguageFr is a ClarifyTextLanguage enum value + ClarifyTextLanguageFr = "fr" + + // ClarifyTextLanguageDe is a ClarifyTextLanguage enum value + ClarifyTextLanguageDe = "de" + + // ClarifyTextLanguageEl is a ClarifyTextLanguage enum value + ClarifyTextLanguageEl = "el" + + // ClarifyTextLanguageGu is a ClarifyTextLanguage enum value + ClarifyTextLanguageGu = "gu" + + // ClarifyTextLanguageHe is a ClarifyTextLanguage enum value + ClarifyTextLanguageHe = "he" + + // ClarifyTextLanguageHi is a ClarifyTextLanguage enum value + ClarifyTextLanguageHi = "hi" + + // ClarifyTextLanguageHu is a ClarifyTextLanguage enum value + ClarifyTextLanguageHu = "hu" + + // ClarifyTextLanguageIs is a ClarifyTextLanguage enum value + ClarifyTextLanguageIs = "is" + + // ClarifyTextLanguageId is a ClarifyTextLanguage enum value + ClarifyTextLanguageId = "id" + + // ClarifyTextLanguageGa is a ClarifyTextLanguage enum value + ClarifyTextLanguageGa = "ga" + + // ClarifyTextLanguageIt is a ClarifyTextLanguage enum value + ClarifyTextLanguageIt = "it" + + // ClarifyTextLanguageKn is a ClarifyTextLanguage enum value + ClarifyTextLanguageKn = "kn" + + // ClarifyTextLanguageKy is a ClarifyTextLanguage enum value + ClarifyTextLanguageKy = "ky" + + // ClarifyTextLanguageLv is a ClarifyTextLanguage enum value + ClarifyTextLanguageLv = "lv" + + // ClarifyTextLanguageLt is a ClarifyTextLanguage enum value + ClarifyTextLanguageLt = "lt" + + // ClarifyTextLanguageLb is a ClarifyTextLanguage enum value + ClarifyTextLanguageLb = "lb" + + // ClarifyTextLanguageMk is a ClarifyTextLanguage enum value + ClarifyTextLanguageMk = "mk" + + // ClarifyTextLanguageMl is a ClarifyTextLanguage enum value + ClarifyTextLanguageMl = "ml" + + // ClarifyTextLanguageMr is a ClarifyTextLanguage enum value + ClarifyTextLanguageMr = "mr" + + // ClarifyTextLanguageNe is a ClarifyTextLanguage enum value + ClarifyTextLanguageNe = "ne" + + // ClarifyTextLanguageNb is a ClarifyTextLanguage enum value + ClarifyTextLanguageNb = "nb" + + // ClarifyTextLanguageFa is a ClarifyTextLanguage enum value + ClarifyTextLanguageFa = "fa" + + // ClarifyTextLanguagePl is a ClarifyTextLanguage enum value + ClarifyTextLanguagePl = "pl" + + // ClarifyTextLanguagePt is a ClarifyTextLanguage enum value + ClarifyTextLanguagePt = "pt" + + // ClarifyTextLanguageRo is a ClarifyTextLanguage enum value + ClarifyTextLanguageRo = "ro" + + // ClarifyTextLanguageRu is a ClarifyTextLanguage enum value + ClarifyTextLanguageRu = "ru" + + // ClarifyTextLanguageSa is a ClarifyTextLanguage enum value + ClarifyTextLanguageSa = "sa" + + // ClarifyTextLanguageSr is a ClarifyTextLanguage enum value + ClarifyTextLanguageSr = "sr" + + // ClarifyTextLanguageTn is a ClarifyTextLanguage enum value + ClarifyTextLanguageTn = "tn" + + // ClarifyTextLanguageSi is a ClarifyTextLanguage enum value + ClarifyTextLanguageSi = "si" + + // ClarifyTextLanguageSk is a ClarifyTextLanguage enum value + ClarifyTextLanguageSk = "sk" + + // ClarifyTextLanguageSl is a ClarifyTextLanguage enum value + ClarifyTextLanguageSl = "sl" + + // ClarifyTextLanguageEs is a ClarifyTextLanguage enum value + ClarifyTextLanguageEs = "es" + + // ClarifyTextLanguageSv is a ClarifyTextLanguage enum value + ClarifyTextLanguageSv = "sv" + + // ClarifyTextLanguageTl is a ClarifyTextLanguage enum value + ClarifyTextLanguageTl = "tl" + + // ClarifyTextLanguageTa is a ClarifyTextLanguage enum value + ClarifyTextLanguageTa = "ta" + + // ClarifyTextLanguageTt is a ClarifyTextLanguage enum value + ClarifyTextLanguageTt = "tt" + + // ClarifyTextLanguageTe is a ClarifyTextLanguage enum value + ClarifyTextLanguageTe = "te" + + // ClarifyTextLanguageTr is a ClarifyTextLanguage enum value + ClarifyTextLanguageTr = "tr" + + // ClarifyTextLanguageUk is a ClarifyTextLanguage enum value + ClarifyTextLanguageUk = "uk" + + // ClarifyTextLanguageUr is a ClarifyTextLanguage enum value + ClarifyTextLanguageUr = "ur" + + // ClarifyTextLanguageYo is a ClarifyTextLanguage enum value + ClarifyTextLanguageYo = "yo" + + // ClarifyTextLanguageLij is a ClarifyTextLanguage enum value + ClarifyTextLanguageLij = "lij" + + // ClarifyTextLanguageXx is a ClarifyTextLanguage enum value + ClarifyTextLanguageXx = "xx" +) + +// ClarifyTextLanguage_Values returns all elements of the ClarifyTextLanguage enum +func ClarifyTextLanguage_Values() []string { + return []string{ + ClarifyTextLanguageAf, + ClarifyTextLanguageSq, + ClarifyTextLanguageAr, + ClarifyTextLanguageHy, + ClarifyTextLanguageEu, + ClarifyTextLanguageBn, + ClarifyTextLanguageBg, + ClarifyTextLanguageCa, + ClarifyTextLanguageZh, + ClarifyTextLanguageHr, + ClarifyTextLanguageCs, + ClarifyTextLanguageDa, + ClarifyTextLanguageNl, + ClarifyTextLanguageEn, + ClarifyTextLanguageEt, + ClarifyTextLanguageFi, + ClarifyTextLanguageFr, + ClarifyTextLanguageDe, + ClarifyTextLanguageEl, + ClarifyTextLanguageGu, + ClarifyTextLanguageHe, + ClarifyTextLanguageHi, + ClarifyTextLanguageHu, + ClarifyTextLanguageIs, + ClarifyTextLanguageId, + ClarifyTextLanguageGa, + ClarifyTextLanguageIt, + ClarifyTextLanguageKn, + ClarifyTextLanguageKy, + ClarifyTextLanguageLv, + ClarifyTextLanguageLt, + ClarifyTextLanguageLb, + ClarifyTextLanguageMk, + ClarifyTextLanguageMl, + ClarifyTextLanguageMr, + ClarifyTextLanguageNe, + ClarifyTextLanguageNb, + ClarifyTextLanguageFa, + ClarifyTextLanguagePl, + ClarifyTextLanguagePt, + ClarifyTextLanguageRo, + ClarifyTextLanguageRu, + ClarifyTextLanguageSa, + ClarifyTextLanguageSr, + ClarifyTextLanguageTn, + ClarifyTextLanguageSi, + ClarifyTextLanguageSk, + ClarifyTextLanguageSl, + ClarifyTextLanguageEs, + ClarifyTextLanguageSv, + ClarifyTextLanguageTl, + ClarifyTextLanguageTa, + ClarifyTextLanguageTt, + ClarifyTextLanguageTe, + ClarifyTextLanguageTr, + ClarifyTextLanguageUk, + ClarifyTextLanguageUr, + ClarifyTextLanguageYo, + ClarifyTextLanguageLij, + ClarifyTextLanguageXx, + } +} + const ( // CodeRepositorySortByName is a CodeRepositorySortBy enum value CodeRepositorySortByName = "Name" diff --git a/service/sagemakerruntime/api.go b/service/sagemakerruntime/api.go index e54db522b5..42ebc0c14b 100644 --- a/service/sagemakerruntime/api.go +++ b/service/sagemakerruntime/api.go @@ -590,6 +590,11 @@ type InvokeEndpointInput struct { // String and GoString methods. CustomAttributes *string `location:"header" locationName:"X-Amzn-SageMaker-Custom-Attributes" type:"string" sensitive:"true"` + // An optional JMESPath expression used to override the EnableExplanations parameter + // of the ClarifyExplainerConfig API. See the EnableExplanations (https://docs.aws.amazon.com/clarify-online-explainability-create-endpoint.html#clarify-online-exaplainability-create-endpoint-enable) + // section in the developer guide for more information. + EnableExplanations *string `location:"header" locationName:"X-Amzn-SageMaker-Enable-Explanations" min:"1" type:"string"` + // The name of the endpoint that you specified when you created the endpoint // using the CreateEndpoint (https://docs.aws.amazon.com/sagemaker/latest/dg/API_CreateEndpoint.html) // API. @@ -643,6 +648,9 @@ func (s *InvokeEndpointInput) Validate() error { if s.Body == nil { invalidParams.Add(request.NewErrParamRequired("Body")) } + if s.EnableExplanations != nil && len(*s.EnableExplanations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("EnableExplanations", 1)) + } if s.EndpointName == nil { invalidParams.Add(request.NewErrParamRequired("EndpointName")) } @@ -686,6 +694,12 @@ func (s *InvokeEndpointInput) SetCustomAttributes(v string) *InvokeEndpointInput return s } +// SetEnableExplanations sets the EnableExplanations field's value. +func (s *InvokeEndpointInput) SetEnableExplanations(v string) *InvokeEndpointInput { + s.EnableExplanations = &v + return s +} + // SetEndpointName sets the EndpointName field's value. func (s *InvokeEndpointInput) SetEndpointName(v string) *InvokeEndpointInput { s.EndpointName = &v @@ -724,6 +738,11 @@ type InvokeEndpointOutput struct { // For information about the format of the response body, see Common Data Formats-Inference // (https://docs.aws.amazon.com/sagemaker/latest/dg/cdf-inference.html). // + // If the explainer is activated, the body includes the explanations provided + // by the model. For more information, see the Response section under Invoke + // the Endpoint (https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-online-explainability-invoke-endpoint.html#clarify-online-explainability-response) + // in the Developer Guide. + // // Body is a sensitive parameter and its value will be // replaced with "sensitive" in string returned by InvokeEndpointOutput's // String and GoString methods. diff --git a/service/ssooidc/api.go b/service/ssooidc/api.go index 8b0ab4f7c1..c743913c57 100644 --- a/service/ssooidc/api.go +++ b/service/ssooidc/api.go @@ -177,8 +177,9 @@ func (c *SSOOIDC) RegisterClientRequest(input *RegisterClientInput) (req *reques // RegisterClient API operation for AWS SSO OIDC. // -// Registers a client with AWS SSO. This allows clients to initiate device authorization. -// The output should be persisted for reuse through many authentication requests. +// Registers a client with IAM Identity Center. This allows clients to initiate +// device authorization. The output should be persisted for reuse through many +// authentication requests. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -487,8 +488,13 @@ type CreateTokenInput struct { // an in-memory reference to the result of the StartDeviceAuthorization API. DeviceCode *string `locationName:"deviceCode" type:"string"` - // Supports grant types for authorization code, refresh token, and device code - // request. + // Supports grant types for the authorization code, refresh token, and device + // code request. For device code requests, specify the following value: + // + // urn:ietf:params:oauth:grant-type:device_code + // + // For information about how to obtain the device code, see the StartDeviceAuthorization + // topic. // // GrantType is a required field GrantType *string `locationName:"grantType" type:"string" required:"true"` @@ -497,8 +503,13 @@ type CreateTokenInput struct { // Users authorize the service to send the request to this location. RedirectUri *string `locationName:"redirectUri" type:"string"` + // Currently, refreshToken is not yet implemented and is not supported. For + // more information about the features and limitations of the current IAM Identity + // Center OIDC implementation, see Considerations for Using this Guide in the + // IAM Identity Center OIDC API Reference (https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html). + // // The token used to obtain an access token in the event that the access token - // is invalid or expired. This token is not issued by the service. + // is invalid or expired. RefreshToken *string `locationName:"refreshToken" type:"string"` // The list of scopes that is defined by the client. Upon authorization, this @@ -594,15 +605,25 @@ func (s *CreateTokenInput) SetScope(v []*string) *CreateTokenInput { type CreateTokenOutput struct { _ struct{} `type:"structure"` - // An opaque token to access AWS SSO resources assigned to a user. + // An opaque token to access IAM Identity Center resources assigned to a user. AccessToken *string `locationName:"accessToken" type:"string"` // Indicates the time in seconds when an access token will expire. ExpiresIn *int64 `locationName:"expiresIn" type:"integer"` + // Currently, idToken is not yet implemented and is not supported. For more + // information about the features and limitations of the current IAM Identity + // Center OIDC implementation, see Considerations for Using this Guide in the + // IAM Identity Center OIDC API Reference (https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html). + // // The identifier of the user that associated with the access token, if present. IdToken *string `locationName:"idToken" type:"string"` + // Currently, refreshToken is not yet implemented and is not supported. For + // more information about the features and limitations of the current IAM Identity + // Center OIDC implementation, see Considerations for Using this Guide in the + // IAM Identity Center OIDC API Reference (https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html). + // // A token that, if present, can be used to refresh a previously issued access // token that might have expired. RefreshToken *string `locationName:"refreshToken" type:"string"` @@ -1364,9 +1385,9 @@ func (s *SlowDownException) RequestID() string { type StartDeviceAuthorizationInput struct { _ struct{} `type:"structure"` - // The unique identifier string for the client that is registered with AWS SSO. - // This value should come from the persisted result of the RegisterClient API - // operation. + // The unique identifier string for the client that is registered with IAM Identity + // Center. This value should come from the persisted result of the RegisterClient + // API operation. // // ClientId is a required field ClientId *string `locationName:"clientId" type:"string" required:"true"` @@ -1377,9 +1398,9 @@ type StartDeviceAuthorizationInput struct { // ClientSecret is a required field ClientSecret *string `locationName:"clientSecret" type:"string" required:"true"` - // The URL for the AWS SSO user portal. For more information, see Using the - // User Portal (https://docs.aws.amazon.com/singlesignon/latest/userguide/using-the-portal.html) - // in the AWS Single Sign-On User Guide. + // The URL for the AWS access portal. For more information, see Using the AWS + // access portal (https://docs.aws.amazon.com/singlesignon/latest/userguide/using-the-portal.html) + // in the IAM Identity Center User Guide. // // StartUrl is a required field StartUrl *string `locationName:"startUrl" type:"string" required:"true"` diff --git a/service/ssooidc/doc.go b/service/ssooidc/doc.go index bb388083a1..8b5ee6019a 100644 --- a/service/ssooidc/doc.go +++ b/service/ssooidc/doc.go @@ -3,25 +3,45 @@ // Package ssooidc provides the client and types for making API // requests to AWS SSO OIDC. // -// AWS Single Sign-On (SSO) OpenID Connect (OIDC) is a web service that enables -// a client (such as AWS CLI or a native application) to register with AWS SSO. -// The service also enables the client to fetch the user’s access token upon -// successful authentication and authorization with AWS SSO. This service conforms -// with the OAuth 2.0 based implementation of the device authorization grant -// standard (https://tools.ietf.org/html/rfc8628 (https://tools.ietf.org/html/rfc8628)). -// -// For general information about AWS SSO, see What is AWS Single Sign-On? (https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) -// in the AWS SSO User Guide. -// -// This API reference guide describes the AWS SSO OIDC operations that you can -// call programatically and includes detailed information on data types and -// errors. -// -// AWS provides SDKs that consist of libraries and sample code for various programming -// languages and platforms such as Java, Ruby, .Net, iOS, and Android. The SDKs -// provide a convenient way to create programmatic access to AWS SSO and other -// AWS services. For more information about the AWS SDKs, including how to download -// and install them, see Tools for Amazon Web Services (http://aws.amazon.com/tools/). +// AWS IAM Identity Center (successor to AWS Single Sign-On) OpenID Connect +// (OIDC) is a web service that enables a client (such as AWS CLI or a native +// application) to register with IAM Identity Center. The service also enables +// the client to fetch the user’s access token upon successful authentication +// and authorization with IAM Identity Center. +// +// Although AWS Single Sign-On was renamed, the sso and identitystore API namespaces +// will continue to retain their original name for backward compatibility purposes. +// For more information, see IAM Identity Center rename (https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html#renamed). +// +// # Considerations for Using This Guide +// +// Before you begin using this guide, we recommend that you first review the +// following important information about how the IAM Identity Center OIDC service +// works. +// +// - The IAM Identity Center OIDC service currently implements only the portions +// of the OAuth 2.0 Device Authorization Grant standard (https://tools.ietf.org/html/rfc8628 +// (https://tools.ietf.org/html/rfc8628)) that are necessary to enable single +// sign-on authentication with the AWS CLI. Support for other OIDC flows +// frequently needed for native applications, such as Authorization Code +// Flow (+ PKCE), will be addressed in future releases. +// +// - The service emits only OIDC access tokens, such that obtaining a new +// token (For example, token refresh) requires explicit user re-authentication. +// +// - The access tokens provided by this service grant access to all AWS account +// entitlements assigned to an IAM Identity Center user, not just a particular +// application. +// +// - The documentation in this guide does not describe the mechanism to convert +// the access token into AWS Auth (“sigv4”) credentials for use with +// IAM-protected AWS service endpoints. For more information, see GetRoleCredentials +// (https://docs.aws.amazon.com/singlesignon/latest/PortalAPIReference/API_GetRoleCredentials.html) +// in the IAM Identity Center Portal API Reference Guide. +// +// For general information about IAM Identity Center, see What is IAM Identity +// Center? (https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) +// in the IAM Identity Center User Guide. // // See https://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10 for more information on this service. //