Using Batch, you can run batch computing workloads on the Amazon Web Services Cloud. Batch computing is a common means for developers, scientists, and engineers to access large amounts of compute resources. Batch uses the advantages of the batch computing to remove the undifferentiated heavy lifting of configuring and managing required infrastructure. At the same time, it also adopts a familiar batch computing software approach. You can use Batch to efficiently provision resources d, and work toward eliminating capacity constraints, reducing your overall compute costs, and delivering results more quickly.
As a fully managed service, Batch can run batch computing workloads of any scale. Batch automatically provisions compute resources and optimizes workload distribution based on the quantity and scale of your specific workloads. With Batch, there's no need to install or manage batch computing software. This means that you can focus on analyzing results and solving your specific problems instead.
", "operations": { "CancelJob": "Cancels a job in an Batch job queue. Jobs that are in the SUBMITTED or PENDING are canceled. A job inRUNNABLE remains in RUNNABLE until it reaches the head of the job queue. Then the job status is updated to FAILED.
A PENDING job is canceled after all dependency jobs are completed. Therefore, it may take longer than expected to cancel a job in PENDING status.
When you try to cancel an array parent job in PENDING, Batch attempts to cancel all child jobs. The array parent job is canceled when all child jobs are completed.
Jobs that progressed to the STARTING or RUNNING state aren't canceled. However, the API operation still succeeds, even if no job is canceled. These jobs must be terminated with the TerminateJob operation.
Creates an Batch compute environment. You can create MANAGED or UNMANAGED compute environments. MANAGED compute environments can use Amazon EC2 or Fargate resources. UNMANAGED compute environments can only use EC2 resources.
In a managed compute environment, Batch manages the capacity and instance types of the compute resources within the environment. This is based on the compute resource specification that you define or the launch template that you specify when you create the compute environment. Either, you can choose to use EC2 On-Demand Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch when the Spot Instance price is less than a specified percentage of the On-Demand price.
Multi-node parallel jobs aren't supported on Spot Instances.
In an unmanaged compute environment, you can manage your own EC2 compute resources and have flexibility with how you configure your compute resources. For example, you can use custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance AMI specification. For more information, see container instance AMIs in the Amazon Elastic Container Service Developer Guide. After you created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that's associated with it. Then, launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS container instance in the Amazon Elastic Container Service Developer Guide.
To create a compute environment that uses EKS resources, the caller must have permissions to call eks:DescribeCluster.
Batch doesn't automatically upgrade the AMIs in a compute environment after it's created. For example, it also doesn't update the AMIs in your compute environment when a newer version of the Amazon ECS optimized AMI is available. You're responsible for the management of the guest operating system. This includes any updates and security patches. You're also responsible for any additional application software or utilities that you install on the compute resources. There are two ways to use a new AMI for your Batch jobs. The original method is to complete these steps:
Create a new compute environment with the new AMI.
Add the compute environment to an existing job queue.
Remove the earlier compute environment from your job queue.
Delete the earlier compute environment.
In April 2022, Batch added enhanced support for updating compute environments. For more information, see Updating compute environments. To use the enhanced updating of compute environments to update AMIs, follow these rules:
Either don't set the service role (serviceRole) parameter or set it to the AWSBatchServiceRole service-linked role.
Set the allocation strategy (allocationStrategy) parameter to BEST_FIT_PROGRESSIVE or SPOT_CAPACITY_OPTIMIZED.
Set the update to latest image version (updateToLatestImageVersion) parameter to true. The updateToLatestImageVersion parameter is used when you update a compute environment. This parameter is ignored when you create a compute environment.
Don't specify an AMI ID in imageId, imageIdOverride (in ec2Configuration ), or in the launch template (launchTemplate). In that case, Batch selects the latest Amazon ECS optimized AMI that's supported by Batch at the time the infrastructure update is initiated. Alternatively, you can specify the AMI ID in the imageId or imageIdOverride parameters, or the launch template identified by the LaunchTemplate properties. Changing any of these properties starts an infrastructure update. If the AMI ID is specified in the launch template, it can't be replaced by specifying an AMI ID in either the imageId or imageIdOverride parameters. It can only be replaced by specifying a different launch template, or if the launch template version is set to $Default or $Latest, by setting either a new default version for the launch template (if $Default) or by adding a new version to the launch template (if $Latest).
If these rules are followed, any update that starts an infrastructure update causes the AMI ID to be re-selected. If the version setting in the launch template (launchTemplate) is set to $Latest or $Default, the latest or default version of the launch template is evaluated up at the time of the infrastructure update, even if the launchTemplate wasn't updated.
Creates an Batch compute environment. You can create MANAGED or UNMANAGED compute environments. MANAGED compute environments can use Amazon EC2 or Fargate resources. UNMANAGED compute environments can only use EC2 resources.
In a managed compute environment, Batch manages the capacity and instance types of the compute resources within the environment. This is based on the compute resource specification that you define or the launch template that you specify when you create the compute environment. Either, you can choose to use EC2 On-Demand Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch when the Spot Instance price is less than a specified percentage of the On-Demand price.
Multi-node parallel jobs aren't supported on Spot Instances.
In an unmanaged compute environment, you can manage your own EC2 compute resources and have flexibility with how you configure your compute resources. For example, you can use custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance AMI specification. For more information, see container instance AMIs in the Amazon Elastic Container Service Developer Guide. After you created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that's associated with it. Then, launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS container instance in the Amazon Elastic Container Service Developer Guide.
To create a compute environment that uses EKS resources, the caller must have permissions to call eks:DescribeCluster.
Batch doesn't automatically upgrade the AMIs in a compute environment after it's created. For example, it also doesn't update the AMIs in your compute environment when a newer version of the Amazon ECS optimized AMI is available. You're responsible for the management of the guest operating system. This includes any updates and security patches. You're also responsible for any additional application software or utilities that you install on the compute resources. There are two ways to use a new AMI for your Batch jobs. The original method is to complete these steps:
Create a new compute environment with the new AMI.
Add the compute environment to an existing job queue.
Remove the earlier compute environment from your job queue.
Delete the earlier compute environment.
In April 2022, Batch added enhanced support for updating compute environments. For more information, see Updating compute environments. To use the enhanced updating of compute environments to update AMIs, follow these rules:
Either don't set the service role (serviceRole) parameter or set it to the AWSBatchServiceRole service-linked role.
Set the allocation strategy (allocationStrategy) parameter to BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED, or SPOT_PRICE_CAPACITY_OPTIMIZED.
Set the update to latest image version (updateToLatestImageVersion) parameter to true. The updateToLatestImageVersion parameter is used when you update a compute environment. This parameter is ignored when you create a compute environment.
Don't specify an AMI ID in imageId, imageIdOverride (in ec2Configuration ), or in the launch template (launchTemplate). In that case, Batch selects the latest Amazon ECS optimized AMI that's supported by Batch at the time the infrastructure update is initiated. Alternatively, you can specify the AMI ID in the imageId or imageIdOverride parameters, or the launch template identified by the LaunchTemplate properties. Changing any of these properties starts an infrastructure update. If the AMI ID is specified in the launch template, it can't be replaced by specifying an AMI ID in either the imageId or imageIdOverride parameters. It can only be replaced by specifying a different launch template, or if the launch template version is set to $Default or $Latest, by setting either a new default version for the launch template (if $Default) or by adding a new version to the launch template (if $Latest).
If these rules are followed, any update that starts an infrastructure update causes the AMI ID to be re-selected. If the version setting in the launch template (launchTemplate) is set to $Latest or $Default, the latest or default version of the launch template is evaluated up at the time of the infrastructure update, even if the launchTemplate wasn't updated.
Creates an Batch job queue. When you create a job queue, you associate one or more compute environments to the queue and assign an order of preference for the compute environments.
You also set a priority to the job queue that determines the order that the Batch scheduler places jobs onto its associated compute environments. For example, if a compute environment is associated with more than one job queue, the job queue with a higher priority is given preference for scheduling jobs to that compute environment.
", "CreateSchedulingPolicy": "Creates an Batch scheduling policy.
", "DeleteComputeEnvironment": "Deletes an Batch compute environment.
Before you can delete a compute environment, you must set its state to DISABLED with the UpdateComputeEnvironment API operation and disassociate it from any job queues with the UpdateJobQueue API operation. Compute environments that use Fargate resources must terminate all active jobs on that compute environment before deleting the compute environment. If this isn't done, the compute environment enters an invalid state.
The allocation strategy to use for the compute resource if not enough instances of the best fitting instance type can be allocated. This might be because of availability of the instance type in the Region or Amazon EC2 service limits. For more information, see Allocation strategies in the Batch User Guide.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
Batch selects an instance type that best fits the needs of the jobs with a preference for the lowest-cost instance type. If additional instances of the selected instance type aren't available, Batch waits for the additional instances to be available. If there aren't enough instances available or the user is reaching Amazon EC2 service limits, additional jobs aren't run until the currently running jobs are completed. This allocation strategy keeps costs lower but can limit scaling. If you're using Spot Fleets with BEST_FIT, the Spot Fleet IAM Role must be specified. Compute resources that use a BEST_FIT allocation strategy don't support infrastructure updates and can't update some parameters. For more information, see Updating compute environments in the Batch User Guide.
Batch selects additional instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types with lower cost vCPUs. If additional instances of the previously selected instance types aren't available, Batch selects new instance types.
Batch selects one or more instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types that are less likely to be interrupted. This allocation strategy is only available for Spot Instance compute resources.
With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance.
The allocation strategy to use for the compute resource if not enough instances of the best fitting instance type can be allocated. This might be because of availability of the instance type in the Region or Amazon EC2 service limits. For more information, see Allocation strategies in the Batch User Guide.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
Batch selects an instance type that best fits the needs of the jobs with a preference for the lowest-cost instance type. If additional instances of the selected instance type aren't available, Batch waits for the additional instances to be available. If there aren't enough instances available or the user is reaching Amazon EC2 service limits, additional jobs aren't run until the currently running jobs are completed. This allocation strategy keeps costs lower but can limit scaling. If you're using Spot Fleets with BEST_FIT, the Spot Fleet IAM Role must be specified. Compute resources that use a BEST_FIT allocation strategy don't support infrastructure updates and can't update some parameters. For more information, see Updating compute environments in the Batch User Guide.
Batch selects additional instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types with lower cost vCPUs. If additional instances of the previously selected instance types aren't available, Batch selects new instance types.
Batch selects one or more instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types that are less likely to be interrupted. This allocation strategy is only available for Spot Instance compute resources.
The price and capacity optimized allocation strategy looks at both price and capacity to select the Spot Instance pools that are the least likely to be interrupted and have the lowest possible price. This allocation strategy is only available for Spot Instance compute resources.
With BEST_FIT_PROGRESSIVE,SPOT_CAPACITY_OPTIMIZED and SPOT_PRICE_CAPACITY_OPTIMIZED strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance.
The allocation strategy to use for the compute resource if there's not enough instances of the best fitting instance type that can be allocated. This might be because of availability of the instance type in the Region or Amazon EC2 service limits. For more information, see Allocation strategies in the Batch User Guide.
When updating a compute environment, changing the allocation strategy requires an infrastructure update of the compute environment. For more information, see Updating compute environments in the Batch User Guide. BEST_FIT isn't supported when updating a compute environment.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
Batch selects additional instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types with lower cost vCPUs. If additional instances of the previously selected instance types aren't available, Batch selects new instance types.
Batch selects one or more instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types that are less likely to be interrupted. This allocation strategy is only available for Spot Instance compute resources.
With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance.
The allocation strategy to use for the compute resource if there's not enough instances of the best fitting instance type that can be allocated. This might be because of availability of the instance type in the Region or Amazon EC2 service limits. For more information, see Allocation strategies in the Batch User Guide.
When updating a compute environment, changing the allocation strategy requires an infrastructure update of the compute environment. For more information, see Updating compute environments in the Batch User Guide. BEST_FIT isn't supported when updating a compute environment.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
Batch selects additional instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types with lower cost vCPUs. If additional instances of the previously selected instance types aren't available, Batch selects new instance types.
Batch selects one or more instance types that are large enough to meet the requirements of the jobs in the queue. Its preference is for instance types that are less likely to be interrupted. This allocation strategy is only available for Spot Instance compute resources.
The price and capacity optimized allocation strategy looks at both price and capacity to select the Spot Instance pools that are the least likely to be interrupted and have the lowest possible price. This allocation strategy is only available for Spot Instance compute resources.
With both BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED, and SPOT_PRICE_CAPACITY_OPTIMIZED strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance.
The maximum number of VCPUs expected to be used for an unmanaged compute environment.
", "ComputeEnvironmentOrder$order": "The order of the compute environment. Compute environments are tried in ascending order. For example, if two compute environments are associated with a job queue, the compute environment with a lower order integer value is tried for job placement first.
The minimum number of vCPUs that a compute environment should maintain (even if the compute environment is DISABLED).
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
The maximum number of vCPUs that a compute environment can support.
With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED allocation strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance. For example, no more than a single instance from among those specified in your compute environment is allocated.
The maximum number of vCPUs that a compute environment can support.
With BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED and SPOT_PRICE_CAPACITY_OPTIMIZED allocation strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance. For example, no more than a single instance from among those specified in your compute environment is allocated.
The desired number of vCPUS in the compute environment. Batch modifies this value between the minimum and maximum values based on job queue demand.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
The maximum percentage that a Spot Instance price can be when compared with the On-Demand price for that instance type before instances are launched. For example, if your maximum percentage is 20%, then the Spot price must be less than 20% of the current On-Demand price for that Amazon EC2 instance. You always pay the lowest (market) price and never more than your maximum percentage. If you leave this field empty, the default value is 100% of the On-Demand price. For most use cases, we recommend leaving this field empty.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
The minimum number of vCPUs that an environment should maintain (even if the compute environment is DISABLED).
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
The maximum number of Amazon EC2 vCPUs that an environment can reach.
With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED allocation strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance. That is, no more than a single instance from among those specified in your compute environment.
The maximum number of Amazon EC2 vCPUs that an environment can reach.
With BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED, and SPOT_PRICE_CAPACITY_OPTIMIZED allocation strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, Batch might need to exceed maxvCpus to meet your capacity requirements. In this event, Batch never exceeds maxvCpus by more than a single instance. That is, no more than a single instance from among those specified in your compute environment.
The desired number of vCPUS in the compute environment. Batch modifies this value between the minimum and maximum values based on job queue demand.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
Batch doesn't support changing the desired number of vCPUs of an existing compute environment. Don't specify this parameter for compute environments using Amazon EKS clusters.
When you update the desiredvCpus setting, the value must be between the minvCpus and maxvCpus values.
Additionally, the updated desiredvCpus value must be greater than or equal to the current desiredvCpus value. For more information, see Troubleshooting Batch in the Batch User Guide.
The maximum percentage that a Spot Instance price can be when compared with the On-Demand price for that instance type before instances are launched. For example, if your maximum percentage is 20%, the Spot price must be less than 20% of the current On-Demand price for that Amazon EC2 instance. You always pay the lowest (market) price and never more than your maximum percentage. For most use cases, we recommend leaving this field empty.
When updating a compute environment, changing the bid percentage requires an infrastructure update of the compute environment. For more information, see Updating compute environments in the Batch User Guide.
This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.
The number of vCPUs reserved for the container. For jobs that run on EC2 resources, you can specify the vCPU requirement for the job using resourceRequirements, but you can't specify the vCPU requirements in both the vcpus and resourceRequirements object. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. You must specify at least one vCPU. This is required but can be specified in several places. It must be specified for each node at least once.
This parameter isn't applicable to jobs that run on Fargate resources. For jobs that run on Fargate resources, you must specify the vCPU requirement for the job using resourceRequirements.
The Amazon Resource Name (ARN) of the job definition.
", "ResourceRequirement$value": "The quantity of the specified resource to reserve for the container. The values vary based on the type specified.
The number of physical GPUs to reserve for the container. Make sure that the number of GPUs reserved for all containers in a job doesn't exceed the number of available GPUs on the compute resource that the job is launched on.
GPUs aren't available for jobs that are running on Fargate resources.
The memory hard limit (in MiB) present to the container. This parameter is supported for jobs that are running on EC2 resources. If your container attempts to exceed the memory specified, the container is terminated. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run. You must specify at least 4 MiB of memory for a job. This is required but can be specified in several places for multi-node parallel (MNP) jobs. It must be specified for each node at least once. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.
If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide.
For jobs that are running on Fargate resources, then value is the hard limit (in MiB), and must match one of the supported values and the VCPU values must be one of the values supported for that memory value.
VCPU = 0.25
VCPU = 0.25 or 0.5
VCPU = 0.25, 0.5, or 1
VCPU = 0.5, or 1
VCPU = 0.5, 1, or 2
VCPU = 1 or 2
VCPU = 1, 2, or 4
VCPU = 2 or 4
VCPU = 2, 4, or 8
VCPU = 4
VCPU = 4 or 8
VCPU = 8
VCPU = 8 or 16
VCPU = 16
The number of vCPUs reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. For EC2 resources, you must specify at least one vCPU. This is required but can be specified in several places; it must be specified for each node at least once.
The default for the Fargate On-Demand vCPU resource count quota is 6 vCPUs. For more information about Fargate quotas, see Fargate quotas in the Amazon Web Services General Reference.
For jobs that are running on Fargate resources, then value must match one of the supported values and the MEMORY values must be one of the values supported for that VCPU value. The supported values are 0.25, 0.5, 1, 2, 4, 8, and 16
MEMORY = 512, 1024, or 2048
MEMORY = 1024, 2048, 3072, or 4096
MEMORY = 2048, 3072, 4096, 5120, 6144, 7168, or 8192
MEMORY = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, or 16384
MEMORY = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696, or 30720
MEMORY = 16384, 20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344, or 61440
MEMORY = 32768, 40960, 49152, 57344, 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880
The operating system for the compute environment. Valid values are: LINUX (default), WINDOWS_SERVER_2019_CORE, WINDOWS_SERVER_2019_FULL, WINDOWS_SERVER_2022_CORE, and WINDOWS_SERVER_2022_FULL.
The following parameters can’t be set for Windows containers: linuxParameters, privileged, user, ulimits, readonlyRootFilesystem, and efsVolumeConfiguration.
The Batch Scheduler checks before registering a task definition with Fargate. If the job requires a Windows container and the first compute environment is LINUX, the compute environment is skipped and the next is checked until a Windows-based compute environment is found.
Fargate Spot is not supported for Windows-based containers on Fargate. A job queue will be blocked if a Fargate Windows job is submitted to a job queue with only Fargate Spot compute environments. However, you can attach both FARGATE and FARGATE_SPOT compute environments to the same job queue.
The vCPU architecture. The default value is X86_64. Valid values are X86_64 and ARM64.
This parameter must be set to X86_64 for Windows containers.
The vCPU architecture. The default value is X86_64. Valid values are X86_64 and ARM64.
This parameter must be set to X86_64 for Windows containers.
The name of the scheduling policy.
", "SchedulingPolicyDetail$arn": "The Amazon Resource Name (ARN) of the scheduling policy. An example is arn:aws:batch:us-east-1:123456789012:scheduling-policy/HighPriority .
Amazon Resource Name (ARN) of the scheduling policy.
", diff --git a/models/apis/dms/2016-01-01/api-2.json b/models/apis/dms/2016-01-01/api-2.json index 973ab60c630..fb7dafb5efc 100644 --- a/models/apis/dms/2016-01-01/api-2.json +++ b/models/apis/dms/2016-01-01/api-2.json @@ -415,6 +415,15 @@ {"shape":"ResourceNotFoundFault"} ] }, + "DescribeEngineVersions":{ + "name":"DescribeEngineVersions", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeEngineVersionsMessage"}, + "output":{"shape":"DescribeEngineVersionsResponse"} + }, "DescribeEventCategories":{ "name":"DescribeEventCategories", "http":{ @@ -1154,6 +1163,10 @@ "type":"list", "member":{"shape":"String"} }, + "AvailableUpgradesList":{ + "type":"list", + "member":{"shape":"String"} + }, "BatchStartRecommendationsErrorEntry":{ "type":"structure", "members":{ @@ -1852,6 +1865,20 @@ "Endpoints":{"shape":"EndpointList"} } }, + "DescribeEngineVersionsMessage":{ + "type":"structure", + "members":{ + "MaxRecords":{"shape":"IntegerOptional"}, + "Marker":{"shape":"String"} + } + }, + "DescribeEngineVersionsResponse":{ + "type":"structure", + "members":{ + "EngineVersions":{"shape":"EngineVersionList"}, + "Marker":{"shape":"String"} + } + }, "DescribeEventCategoriesMessage":{ "type":"structure", "members":{ @@ -2387,6 +2414,23 @@ "type":"list", "member":{"shape":"EndpointSetting"} }, + "EngineVersion":{ + "type":"structure", + "members":{ + "Version":{"shape":"String"}, + "Lifecycle":{"shape":"String"}, + "ReleaseStatus":{"shape":"ReleaseStatusValues"}, + "LaunchDate":{"shape":"TStamp"}, + "AutoUpgradeDate":{"shape":"TStamp"}, + "DeprecationDate":{"shape":"TStamp"}, + "ForceUpgradeDate":{"shape":"TStamp"}, + "AvailableUpgrades":{"shape":"AvailableUpgradesList"} + } + }, + "EngineVersionList":{ + "type":"list", + "member":{"shape":"EngineVersion"} + }, "Event":{ "type":"structure", "members":{ diff --git a/models/apis/dms/2016-01-01/docs-2.json b/models/apis/dms/2016-01-01/docs-2.json index 02cdfecdc3d..9d20710631e 100644 --- a/models/apis/dms/2016-01-01/docs-2.json +++ b/models/apis/dms/2016-01-01/docs-2.json @@ -31,6 +31,7 @@ "DescribeEndpointSettings": "Returns information about the possible endpoint settings available when you create an endpoint for a specific database engine.
", "DescribeEndpointTypes": "Returns information about the type of endpoints available.
", "DescribeEndpoints": "Returns information about the endpoints for your account in the current region.
", + "DescribeEngineVersions": "Returns information about the replication instance versions used in the project.
", "DescribeEventCategories": "Lists categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in Working with Events and Notifications in the Database Migration Service User Guide.
", "DescribeEventSubscriptions": "Lists all the event subscriptions for a customer account. The description of a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.
If you specify SubscriptionName, this action lists the description for that subscription.
Lists events for a given source identifier and source type. You can also specify a start and end time. For more information on DMS events, see Working with Events and Notifications in the Database Migration Service User Guide.
", @@ -149,6 +150,12 @@ "OrderableReplicationInstance$AvailabilityZones": "List of Availability Zones for this replication instance.
" } }, + "AvailableUpgradesList": { + "base": null, + "refs": { + "EngineVersion$AvailableUpgrades": "The list of valid replication instance versions that you can upgrade to.
" + } + }, "BatchStartRecommendationsErrorEntry": { "base": "Provides information about the errors that occurred during the analysis of the source database.
", "refs": { @@ -488,7 +495,7 @@ "DatabaseMode": { "base": null, "refs": { - "PostgreSQLSettings$DatabaseMode": "Specifies whether to use default or custom replication behavior for PostgreSQL-compatible endpoints. You can use this setting to specify replication behavior for endpoints that require additional configuration, such as Babelfish endpoints.
" + "PostgreSQLSettings$DatabaseMode": "Specifies the default behavior of the replication's handling of PostgreSQL- compatible endpoints that require some additional configuration, such as Babelfish endpoints.
" } }, "DatabaseResponse": { @@ -690,6 +697,16 @@ "refs": { } }, + "DescribeEngineVersionsMessage": { + "base": null, + "refs": { + } + }, + "DescribeEngineVersionsResponse": { + "base": null, + "refs": { + } + }, "DescribeEventCategoriesMessage": { "base": "", "refs": { @@ -1042,6 +1059,18 @@ "DescribeEndpointSettingsResponse$EndpointSettings": "Descriptions of the endpoint settings available for your source or target database engine.
" } }, + "EngineVersion": { + "base": "Provides information about a replication instance version.
", + "refs": { + "EngineVersionList$member": null + } + }, + "EngineVersionList": { + "base": null, + "refs": { + "DescribeEngineVersionsResponse$EngineVersions": "Returned EngineVersion objects that describe the replication instance engine versions used in the project.
Describes an identifiable significant activity that affects a replication instance or task. This object can provide the message, the available event categories, the date and source of the event, and the DMS resource type.
", "refs": { @@ -1287,6 +1316,7 @@ "DescribeEndpointSettingsMessage$MaxRecords": "The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.
The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.
Default: 100
Constraints: Minimum 20, maximum 100.
", "DescribeEndpointsMessage$MaxRecords": " The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.
Default: 100
Constraints: Minimum 20, maximum 100.
", + "DescribeEngineVersionsMessage$MaxRecords": "The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.
The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.
Default: 100
Constraints: Minimum 20, maximum 100.
", "DescribeEventsMessage$Duration": "The duration of the events to be listed.
", "DescribeEventsMessage$MaxRecords": " The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.
Default: 100
Constraints: Minimum 20, maximum 100.
", @@ -1834,6 +1864,7 @@ "ReleaseStatusValues": { "base": null, "refs": { + "EngineVersion$ReleaseStatus": "The release status of the replication instance version.
", "OrderableReplicationInstance$ReleaseStatus": "The value returned when the specified EngineVersion of the replication instance is in Beta or test mode. This indicates some features might not work as expected.
DMS supports the ReleaseStatus parameter in versions 3.1.4 and later.
The name of the Availability Zone.
", "AvailabilityZonesList$member": null, + "AvailableUpgradesList$member": null, "BatchStartRecommendationsErrorEntry$DatabaseId": "The identifier of the source database.
", "BatchStartRecommendationsErrorEntry$Message": "The information about the error.
", "BatchStartRecommendationsErrorEntry$Code": "The code of an error that occurred during the analysis of the source database.
", @@ -2426,6 +2458,8 @@ "DescribeEndpointTypesResponse$Marker": " An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The type of DMS resource that generates events.
Valid values: replication-instance | replication-task
", "DescribeEventSubscriptionsMessage$SubscriptionName": "The name of the DMS event subscription to be described.
", "DescribeEventSubscriptionsMessage$Marker": " An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The relevance or validity of an endpoint setting for an engine name and its endpoint type.
", "EndpointSetting$DefaultValue": "The default value of the endpoint setting if no value is specified using CreateEndpoint or ModifyEndpoint.
The version number of the replication instance.
", + "EngineVersion$Lifecycle": "The lifecycle status of the replication instance version. Valid values are DEPRECATED, DEFAULT_VERSION, and ACTIVE.
The identifier of an event source.
", "Event$Message": "The event message.
", "EventCategoriesList$member": null, @@ -2919,6 +2955,10 @@ "CreateReplicationTaskMessage$CdcStartTime": "Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.
Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”
", "DescribeEventsMessage$StartTime": "The start time for the events to be listed.
", "DescribeEventsMessage$EndTime": "The end time for the events to be listed.
", + "EngineVersion$LaunchDate": "The date when the replication instance version became publicly available.
", + "EngineVersion$AutoUpgradeDate": "The date when the replication instance will be automatically upgraded. This setting only applies if the auto-minor-version setting is enabled.
The date when the replication instance version will be deprecated and can no longer be requested.
", + "EngineVersion$ForceUpgradeDate": "The date when the replication instance will have a version upgrade forced.
", "Event$Date": "The date of the event.
", "ModifyReplicationTaskMessage$CdcStartTime": "Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.
Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”
", "PendingMaintenanceAction$AutoAppliedAfterDate": "The date of the maintenance window when the action is to be applied. The maintenance action is applied to the resource during its first maintenance window after this date. If this date is specified, any next-maintenance opt-in requests are ignored.
Amazon CloudWatch Internet Monitor provides visibility into how internet issues impact the performance and availability between your applications hosted on Amazon Web Services and your end users. It reduces the time it takes for you to diagnose internet issues from days to minutes. Internet Monitor uses the connectivity data that Amazon Web Services captures from its global networking footprint to calculate a baseline of performance and availability for internet traffic. This is the same data that Amazon Web Services uses to monitor internet uptime and availability. With those measurements as a baseline, Internet Monitor raises awareness for you when there are significant problems for your end users in the different geographic locations where your application runs.
Internet Monitor publishes internet measurements to CloudWatch Logs and CloudWatch Metrics, to easily support using CloudWatch tools with health information for geographies and networks specific to your application. Internet Monitor sends health events to Amazon EventBridge so that you can set up notifications. If an issue is caused by the Amazon Web Services network, you also automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem.
To use Internet Monitor, you create a monitor and associate your application's resources with it, VPCs, CloudFront distributions, or WorkSpaces directories, to enable Internet Monitor to know where your application's internet traffic is. Internet Monitor then provides internet measurements from Amazon Web Services that are specific to the locations and networks that communicate with your application.
For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.
", + "service": "Amazon CloudWatch Internet Monitor provides visibility into how internet issues impact the performance and availability between your applications hosted on Amazon Web Services and your end users. It can reduce the time it takes for you to diagnose internet issues from days to minutes. Internet Monitor uses the connectivity data that Amazon Web Services captures from its global networking footprint to calculate a baseline of performance and availability for internet traffic. This is the same data that Amazon Web Services uses to monitor internet uptime and availability. With those measurements as a baseline, Internet Monitor raises awareness for you when there are significant problems for your end users in the different geographic locations where your application runs.
Internet Monitor publishes internet measurements to CloudWatch Logs and CloudWatch Metrics, to easily support using CloudWatch tools with health information for geographies and networks specific to your application. Internet Monitor sends health events to Amazon EventBridge so that you can set up notifications. If an issue is caused by the Amazon Web Services network, you also automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem.
To use Internet Monitor, you create a monitor and associate your application's resources with it - VPCs, NLBs, CloudFront distributions, or WorkSpaces directories - so Internet Monitor can determine where your application's internet traffic is. Internet Monitor then provides internet measurements from Amazon Web Services that are specific to the locations and ASNs (typically, internet service providers or ISPs) that communicate with your application.
For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.
", "operations": { - "CreateMonitor": "Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces directories. Internet Monitor then publishes internet measurements from Amazon Web Services that are specific to the city-networks, that is, the locations and ASNs (typically internet service providers or ISPs), where clients access your application. For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.
When you create a monitor, you set a maximum limit for the number of city-networks where client traffic is monitored. The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. You can change the maximum at any time by updating your monitor. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.
", + "CreateMonitor": "Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: VPCs, Network Load Balancers (NLBs), Amazon CloudFront distributions, and Amazon WorkSpaces directories. Internet Monitor then publishes internet measurements from Amazon Web Services that are specific to the city-networks. That is, the locations and ASNs (typically internet service providers or ISPs), where clients access your application. For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.
When you create a monitor, you choose the percentage of traffic that you want to monitor. You can also set a maximum limit for the number of city-networks where client traffic is monitored, that caps the total traffic that Internet Monitor monitors. A city-network maximum is the limit of city-networks, but you only pay for the number of city-networks that are actually monitored. You can update your monitor at any time to change the percentage of traffic to monitor or the city-networks maximum. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.
", "DeleteMonitor": "Deletes a monitor in Amazon CloudWatch Internet Monitor.
", - "GetHealthEvent": "Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all of the information related to the event by location.
The information returned includes the performance, availability, and round-trip time impact, information about the network providers, the event type, and so on.
Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.
", + "GetHealthEvent": "Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all the information related to the event, by location.
The information returned includes the impact on performance, availability, and round-trip time, information about the network providers (ASNs), the event type, and so on.
Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.
", "GetMonitor": "Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name. The information returned includes the Amazon Resource Name (ARN), create time, modified time, resources included in the monitor, and status information.
", - "ListHealthEvents": "Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns all information for health events including the client location information the network cause and status, event start and end time, percentage of total traffic impacted, and status.
Health events that have start times during the time frame that is requested are not included in the list of health events.
Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end time and the status.
Health events that have start times during the time frame that is requested are not included in the list of health events.
Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.
", "ListTagsForResource": "Lists the tags for a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor.
", "TagResource": "Adds a tag to a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor. You can add a maximum of 50 tags in Internet Monitor.
A minimum of one tag is required for this call. It returns an error if you use the TagResource request with 0 tags.
Removes a tag from a resource.
", - "UpdateMonitor": "Updates a monitor. You can update a monitor to change the maximum number of city-networks (locations and ASNs or internet service providers), to add or remove resources, or to change the status of the monitor. Note that you can't change the name of a monitor.
The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.
" + "UpdateMonitor": "Updates a monitor. You can update a monitor to change the percentage of traffic to monitor or the maximum number of city-networks (locations and ASNs), to add or remove resources, or to change the status of the monitor. Note that you can't change the name of a monitor.
The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.
" }, "shapes": { "AccessDeniedException": { @@ -28,7 +28,7 @@ } }, "AvailabilityMeasurement": { - "base": "Measurements about the availability for your application on the internet, calculated by Amazon CloudWatch Internet Monitor. Amazon Web Services has substantial historical data about internet performance and availability between Amazon Web Services services and different network providers and geographies. By applying statistical analysis to the data, Internet Monitor can detect when the performance and availability for your application has dropped, compared to an estimated baseline that's already calculated. To make it easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.
Availability in Internet Monitor represents the estimated percentage of traffic that is not seeing an availability drop. For example, an availability score of 99% for an end user and service location pair is equivalent to 1% of the traffic experiencing an availability drop for that pair.
For more information, see How Internet Monitor calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.
", + "base": "Amazon CloudWatch Internet Monitor calculates measurements about the availability for your application's internet traffic between client locations and Amazon Web Services. Amazon Web Services has substantial historical data about internet performance and availability between Amazon Web Services services and different network providers and geographies. By applying statistical analysis to the data, Internet Monitor can detect when the performance and availability for your application has dropped, compared to an estimated baseline that's already calculated. To make it easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.
Availability in Internet Monitor represents the estimated percentage of traffic that is not seeing an availability drop. For example, an availability score of 99% for an end user and service location pair is equivalent to 1% of the traffic experiencing an availability drop for that pair.
For more information, see How Internet Monitor calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.
", "refs": { "InternetHealth$Availability": "Availability in Internet Monitor represents the estimated percentage of traffic that is not seeing an availability drop. For example, an availability score of 99% for an end user and service location pair is equivalent to 1% of the traffic experiencing an availability drop for that pair.
For more information, see How Internet Monitor calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
" } @@ -67,14 +67,14 @@ "base": null, "refs": { "AvailabilityMeasurement$ExperienceScore": "Experience scores, or health scores are calculated for different geographic and network provider combinations (that is, different granularities) and also summed into global scores. If you view performance or availability scores without filtering for any specific geography or service provider, Amazon CloudWatch Internet Monitor provides global health scores.
The Amazon CloudWatch Internet Monitor chapter in the CloudWatch User Guide includes detailed information about how Internet Monitor calculates health scores, including performance and availability scores, and when it creates and resolves health events. For more information, see How Amazon Web Services calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", - "AvailabilityMeasurement$PercentOfTotalTrafficImpacted": "The percentage of impact caused by a health event for total traffic globally.
For information about how Internet Monitor calculates impact, see Inside Internet Monitor in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.
", + "AvailabilityMeasurement$PercentOfTotalTrafficImpacted": "The impact on total traffic that a health event has, in increased latency or reduced availability. This is the percentage of how much latency has increased or availability has decreased during the event, compared to what is typical for traffic from this client location to the Amazon Web Services location using this client network.
For information about how Internet Monitor calculates impact, see How Internet Monitor works in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.
", "AvailabilityMeasurement$PercentOfClientLocationImpacted": "The percentage of impact caused by a health event for client location traffic globally.
For information about how Internet Monitor calculates impact, see Inside Internet Monitor in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.
", - "GetHealthEventOutput$PercentOfTotalTrafficImpacted": "The impact on total traffic that a health event has.
", - "HealthEvent$PercentOfTotalTrafficImpacted": "The impact on global traffic monitored by this monitor for this health event.
", + "GetHealthEventOutput$PercentOfTotalTrafficImpacted": "The impact on total traffic that a health event has, in increased latency or reduced availability. This is the percentage of how much latency has increased or availability has decreased during the event, compared to what is typical for traffic from this client location to the Amazon Web Services location using this client network.
", + "HealthEvent$PercentOfTotalTrafficImpacted": "The impact on total traffic that a health event has, in increased latency or reduced availability. This is the percentage of how much latency has increased or availability has decreased during the event, compared to what is typical for traffic from this client location to the Amazon Web Services location using this client network.
", "ImpactedLocation$Latitude": "The latitude where the health event is located.
", "ImpactedLocation$Longitude": "The longitude where the health event is located.
", "PerformanceMeasurement$ExperienceScore": "Experience scores, or health scores, are calculated for different geographic and network provider combinations (that is, different granularities) and also totaled into global scores. If you view performance or availability scores without filtering for any specific geography or service provider, Amazon CloudWatch Internet Monitor provides global health scores.
The Amazon CloudWatch Internet Monitor chapter in the CloudWatch User Guide includes detailed information about how Internet Monitor calculates health scores, including performance and availability scores, and when it creates and resolves health events. For more information, see How Amazon Web Services calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", - "PerformanceMeasurement$PercentOfTotalTrafficImpacted": "How much performance impact was caused by a health event for total traffic globally. For performance, this is the percentage of how much latency increased during the event compared to typical performance for your application traffic globally.
For more information, see When Amazon Web Services creates and resolves health events in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", + "PerformanceMeasurement$PercentOfTotalTrafficImpacted": "The impact on total traffic that a health event has, in increased latency or reduced availability. This is the percentage of how much latency has increased or availability has decreased during the event, compared to what is typical for traffic from this client location to the Amazon Web Services location using this client network.
For more information, see When Amazon Web Services creates and resolves health events in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", "PerformanceMeasurement$PercentOfClientLocationImpacted": "How much performance impact was caused by a health event at a client location. For performance, this is the percentage of how much latency increased during the event compared to typical performance for traffic, from this client location to an Amazon Web Services location, using a specific client network.
For more information, see When Amazon Web Services creates and resolves health events in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", "RoundTripTime$P50": "RTT at the 50th percentile (p50).
", "RoundTripTime$P90": "RTT at the 90th percentile (p90).
", @@ -138,11 +138,11 @@ } }, "HealthEventsConfig": { - "base": "A complex type for the configuration. Defines the health event threshold percentages, for performance score and availability score. Amazon CloudWatch Internet Monitor creates a health event when there's an internet issue that affects your application end users where a health score percentage is at or below a set threshold. If you don't set a health event threshold, the default value is 95%.
", + "base": "A complex type with the configuration information that determines the threshold and other conditions for when Internet Monitor creates a health event for an overall performance or availability issue, across an application's geographies.
Defines the percentages, for overall performance scores and availability scores for an application, that are the thresholds for when Amazon CloudWatch Internet Monitor creates a health event. You can override the defaults to set a custom threshold for overall performance or availability scores, or both.
You can also set thresholds for local health scores,, where Internet Monitor creates a health event when scores cross a threshold for one or more city-networks, in addition to creating an event when an overall score crosses a threshold.
If you don't set a health event threshold, the default value is 95%.
For local thresholds, you also set a minimum percentage of overall traffic that is impacted by an issue before Internet Monitor creates an event. In addition, you can disable local thresholds, for performance scores, availability scores, or both.
For more information, see Change health event thresholds in the Internet Monitor section of the CloudWatch User Guide.
", "refs": { - "CreateMonitorInput$HealthEventsConfig": "Defines the health event threshold percentages, for performance score and availability score. Internet Monitor creates a health event when there's an internet issue that affects your application end users where a health score percentage is at or below a set threshold. If you don't set a health event threshold, the default calue is 95%.
", - "GetMonitorOutput$HealthEventsConfig": "The list of health event thresholds. A health event threshold percentage, for performance and availability, determines the level of impact at which Amazon CloudWatch Internet Monitor creates a health event when there's an internet issue that affects your application end users.
", - "UpdateMonitorInput$HealthEventsConfig": "The list of health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users.
" + "CreateMonitorInput$HealthEventsConfig": "Defines the threshold percentages and other configuration information for when Amazon CloudWatch Internet Monitor creates a health event. Internet Monitor creates a health event when an internet issue that affects your application end users has a health score percentage that is at or below a specific threshold, and, sometimes, when other criteria are met.
If you don't set a health event threshold, the default value is 95%.
For more information, see Change health event thresholds in the Internet Monitor section of the CloudWatch User Guide.
", + "GetMonitorOutput$HealthEventsConfig": "The list of health event threshold configurations. The threshold percentage for a health score determines, along with other configuration information, when Internet Monitor creates a health event when there's an internet issue that affects your application end users.
For more information, see Change health event thresholds in the Internet Monitor section of the CloudWatch User Guide.
", + "UpdateMonitorInput$HealthEventsConfig": "The list of health score thresholds. A threshold percentage for health scores, along with other configuration information, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users.
For more information, see Change health event thresholds in the Internet Monitor section of the CloudWatch User Guide.
" } }, "ImpactedLocation": { @@ -169,7 +169,7 @@ } }, "InternetHealth": { - "base": "Internet health includes measurements calculated by Amazon CloudWatch Internet Monitor about the performance and availability for your application on the internet. Amazon Web Services has substantial historical data about internet performance and availability between Amazon Web Services services and different network providers and geographies. By applying statistical analysis to the data, Internet Monitor can detect when the performance and availability for your application has dropped, compared to an estimated baseline that's already calculated. To make it easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.
", + "base": "Internet health includes measurements calculated by Amazon CloudWatch Internet Monitor about the performance and availability for your application on the internet. Amazon Web Services has substantial historical data about internet performance and availability between Amazon Web Services services and different network providers and geographies. By applying statistical analysis to the data, Internet Monitor can detect when the performance and availability for your application has dropped, compared to an estimated baseline that's already calculated. To make it easier to see those drops, Internet Monitor reports the information to you in the form of health scores: a performance score and an availability score.
", "refs": { "ImpactedLocation$InternetHealth": "The calculated health at a specific location.
" } @@ -217,6 +217,19 @@ "refs": { } }, + "LocalHealthEventsConfig": { + "base": "A complex type with the configuration information that determines the threshold and other conditions for when Internet Monitor creates a health event for a local performance or availability issue, when scores cross a threshold for one or more city-networks.
Defines the percentages, for performance scores or availability scores, that are the local thresholds for when Amazon CloudWatch Internet Monitor creates a health event. Also defines whether a local threshold is enabled or disabled, and the minimum percentage of overall traffic that must be impacted by an issue before Internet Monitor creates an event when a threshold is crossed for a local health score.
For more information, see Change health event thresholds in the Internet Monitor section of the CloudWatch User Guide.
", + "refs": { + "HealthEventsConfig$AvailabilityLocalHealthEventsConfig": "The configuration that determines the threshold and other conditions for when Internet Monitor creates a health event for a local availability issue.
", + "HealthEventsConfig$PerformanceLocalHealthEventsConfig": "The configuration that determines the threshold and other conditions for when Internet Monitor creates a health event for a local performance issue.
" + } + }, + "LocalHealthEventsConfigStatus": { + "base": null, + "refs": { + "LocalHealthEventsConfig$Status": "The status of whether Internet Monitor creates a health event based on a threshold percentage set for a local health score. The status can be ENABLED or DISABLED.
The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
To learn more, see Choosing a city-network maximum value in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", - "GetMonitorOutput$MaxCityNetworksToMonitor": "The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
To learn more, see Choosing a city-network maximum value in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", - "UpdateMonitorInput$MaxCityNetworksToMonitor": "The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider, that clients access the resources through.
" + "CreateMonitorInput$MaxCityNetworksToMonitor": "The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the ASN or network provider, such as an internet service provider (ISP), that clients access the resources through. Setting this limit can help control billing costs.
To learn more, see Choosing a city-network maximum value in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", + "GetMonitorOutput$MaxCityNetworksToMonitor": "The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the ASN or network provider, such as an internet service provider (ISP), that clients access the resources through. This limit can help control billing costs.
To learn more, see Choosing a city-network maximum value in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", + "UpdateMonitorInput$MaxCityNetworksToMonitor": "The maximum number of city-networks to monitor for your application. A city-network is the location (city) where clients access your application resources from and the ASN or network provider, such as an internet service provider (ISP), that clients access the resources through. Setting this limit can help control billing costs.
" } }, "MaxResults": { @@ -313,14 +326,16 @@ "Percentage": { "base": null, "refs": { - "GetHealthEventOutput$HealthScoreThreshold": "The threshold percentage for health events when Amazon CloudWatch Internet Monitor creates a health event.
", + "GetHealthEventOutput$HealthScoreThreshold": "The threshold percentage for a health score that determines, along with other configuration information, when Internet Monitor creates a health event when there's an internet issue that affects your application end users.
", "HealthEvent$HealthScoreThreshold": "The value of the threshold percentage for performance or availability that was configured when Amazon CloudWatch Internet Monitor created the health event.
", "HealthEventsConfig$AvailabilityScoreThreshold": "The health event threshold percentage set for availability scores.
", - "HealthEventsConfig$PerformanceScoreThreshold": "The health event threshold percentage set for performance scores.
" + "HealthEventsConfig$PerformanceScoreThreshold": "The health event threshold percentage set for performance scores.
", + "LocalHealthEventsConfig$HealthScoreThreshold": "The health event threshold percentage set for a local health score.
", + "LocalHealthEventsConfig$MinTrafficImpact": "The minimum percentage of overall traffic for an application that must be impacted by an issue before Internet Monitor creates an event when a threshold is crossed for a local health score.
" } }, "PerformanceMeasurement": { - "base": "Measurements about the performance for your application on the internet calculated by Amazon CloudWatch Internet Monitor. Amazon Web Services has substantial historical data about internet performance and availability between Amazon Web Services services and different network providers and geographies. By applying statistical analysis to the data, Internet Monitor can detect when the performance and availability for your application has dropped, compared to an estimated baseline that's already calculated. To make it easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.
Performance in Internet Monitor represents the estimated percentage of traffic that is not seeing a performance drop. For example, a performance score of 99% for an end user and service location pair is equivalent to 1% of the traffic experiencing a performance drop for that pair.
For more information, see How Internet Monitor calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", + "base": "Amazon CloudWatch Internet Monitor calculates measurements about the performance for your application's internet traffic between client locations and Amazon Web Services. Amazon Web Services has substantial historical data about internet performance and availability between Amazon Web Services services and different network providers and geographies. By applying statistical analysis to the data, Internet Monitor can detect when the performance and availability for your application has dropped, compared to an estimated baseline that's already calculated. To make it easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.
Performance in Internet Monitor represents the estimated percentage of traffic that is not seeing a performance drop. For example, a performance score of 99% for an end user and service location pair is equivalent to 1% of the traffic experiencing a performance drop for that pair.
For more information, see How Internet Monitor calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", "refs": { "InternetHealth$Performance": "Performance in Internet Monitor represents the estimated percentage of traffic that is not seeing a performance drop. For example, a performance score of 99% for an end user and service location pair is equivalent to 1% of the traffic experiencing a performance drop for that pair.
For more information, see How Internet Monitor calculates performance and availability scores in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
" } @@ -364,9 +379,9 @@ "SetOfARNs": { "base": null, "refs": { - "CreateMonitorInput$Resources": "The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
You can add a combination of Amazon Virtual Private Clouds (VPCs) and Amazon CloudFront distributions, or you can add Amazon WorkSpaces directories. You can't add all three types of resources.
If you add only VPC resources, at least one VPC must have an Internet Gateway attached to it, to make sure that it has internet connectivity.
The resources that have been added for the monitor. Resources are listed by their Amazon Resource Names (ARNs).
", - "UpdateMonitorInput$ResourcesToAdd": "The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
You can add a combination of Amazon Virtual Private Clouds (VPCs) and Amazon CloudFront distributions, or you can add Amazon WorkSpaces directories. You can't add all three types of resources.
If you add only VPC resources, at least one VPC must have an Internet Gateway attached to it, to make sure that it has internet connectivity.
The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon CloudFront distributions, or Amazon WorkSpaces directories.
You can add a combination of VPCs and CloudFront distributions, or you can add WorkSpaces directories, or you can add NLBs. You can't add NLBs or WorkSpaces directories together with any other resources.
If you add only Amazon VPC resources, at least one VPC must have an Internet Gateway attached to it, to make sure that it has internet connectivity.
The resources monitored by the monitor. Resources are listed by their Amazon Resource Names (ARNs).
", + "UpdateMonitorInput$ResourcesToAdd": "The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon CloudFront distributions, or Amazon WorkSpaces directories.
You can add a combination of VPCs and CloudFront distributions, or you can add WorkSpaces directories, or you can add NLBs. You can't add NLBs or WorkSpaces directories together with any other resources.
If you add only Amazon Virtual Private Clouds resources, at least one VPC must have an Internet Gateway attached to it, to make sure that it has internet connectivity.
The resources to remove from a monitor, which you provide as a set of Amazon Resource Names (ARNs).
" } }, @@ -472,9 +487,9 @@ "TrafficPercentageToMonitor": { "base": null, "refs": { - "CreateMonitorInput$TrafficPercentageToMonitor": "The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
", - "GetMonitorOutput$TrafficPercentageToMonitor": "The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
", - "UpdateMonitorInput$TrafficPercentageToMonitor": "The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
" + "CreateMonitorInput$TrafficPercentageToMonitor": "The percentage of the internet-facing traffic for your application that you want to monitor with this monitor. If you set a city-networks maximum, that limit overrides the traffic percentage that you set.
To learn more, see Choosing an application traffic percentage to monitor in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", + "GetMonitorOutput$TrafficPercentageToMonitor": "The percentage of the internet-facing traffic for your application to monitor with this monitor. If you set a city-networks maximum, that limit overrides the traffic percentage that you set.
To learn more, see Choosing an application traffic percentage to monitor in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
", + "UpdateMonitorInput$TrafficPercentageToMonitor": "The percentage of the internet-facing traffic for your application that you want to monitor with this monitor. If you set a city-networks maximum, that limit overrides the traffic percentage that you set.
To learn more, see Choosing an application traffic percentage to monitor in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.
" } }, "TriangulationEventType": { diff --git a/models/apis/internetmonitor/2021-06-03/endpoint-rule-set-1.json b/models/apis/internetmonitor/2021-06-03/endpoint-rule-set-1.json index 25b3af24f3a..3de3fac3112 100644 --- a/models/apis/internetmonitor/2021-06-03/endpoint-rule-set-1.json +++ b/models/apis/internetmonitor/2021-06-03/endpoint-rule-set-1.json @@ -64,18 +64,28 @@ ] }, { - "conditions": [], + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Region" + } + ] + } + ], "type": "tree", "rules": [ { "conditions": [ { - "fn": "isSet", + "fn": "aws.partition", "argv": [ { "ref": "Region" } - ] + ], + "assign": "PartitionResult" } ], "type": "tree", @@ -83,19 +93,35 @@ { "conditions": [ { - "fn": "aws.partition", + "fn": "booleanEquals", "argv": [ + true, { - "ref": "Region" + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsDualStack" + ] } - ], - "assign": "PartitionResult" + ] } ], "type": "tree", "rules": [ { - "conditions": [], + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], "type": "tree", "rules": [ { @@ -110,7 +136,7 @@ { "ref": "PartitionResult" }, - "supportsDualStack" + "supportsFIPS" ] } ] @@ -118,62 +144,10 @@ ], "type": "tree", "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseFIPS" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://internetmonitor-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - }, - { - "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" - } - ] - }, { "conditions": [], "endpoint": { - "url": "https://internetmonitor.{Region}.{PartitionResult#dualStackDnsSuffix}", + "url": "https://internetmonitor-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, @@ -183,95 +157,91 @@ }, { "conditions": [], - "type": "tree", - "rules": [ + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" + } + ] + }, + { + "conditions": [], + "endpoint": { + "url": "https://internetmonitor.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseFIPS" - }, - true - ] - } - ], - "type": "tree", - "rules": [ + "fn": "getAttr", + "argv": [ { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://internetmonitor-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - } - ] + "ref": "PartitionResult" }, - { - "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" - } - ] - }, - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://internetmonitor.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "supportsFIPS" ] } ] } + ], + "type": "tree", + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://internetmonitor-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } ] + }, + { + "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" } ] + }, + { + "conditions": [], + "endpoint": { + "url": "https://internetmonitor.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] - }, - { - "conditions": [], - "error": "Invalid Configuration: Missing Region", - "type": "error" } ] + }, + { + "conditions": [], + "error": "Invalid Configuration: Missing Region", + "type": "error" } ] } \ No newline at end of file diff --git a/models/apis/medialive/2017-10-14/api-2.json b/models/apis/medialive/2017-10-14/api-2.json index 0b1575eae46..19c853c7ee0 100644 --- a/models/apis/medialive/2017-10-14/api-2.json +++ b/models/apis/medialive/2017-10-14/api-2.json @@ -5067,9 +5067,13 @@ "shape": "InputDeviceUhdSettings", "locationName": "uhdDeviceSettings" }, - "Tags": { + "Tags": { "shape": "Tags", "locationName": "tags" + }, + "AvailabilityZone": { + "shape": "__string", + "locationName": "availabilityZone" } } }, @@ -8142,9 +8146,13 @@ "shape": "InputDeviceUhdSettings", "locationName": "uhdDeviceSettings" }, - "Tags": { + "Tags": { "shape": "Tags", "locationName": "tags" + }, + "AvailabilityZone": { + "shape": "__string", + "locationName": "availabilityZone" } } }, @@ -8356,9 +8364,13 @@ "shape": "InputDeviceUhdSettings", "locationName": "uhdDeviceSettings" }, - "Tags": { + "Tags": { "shape": "Tags", "locationName": "tags" + }, + "AvailabilityZone": { + "shape": "__string", + "locationName": "availabilityZone" } } }, @@ -13138,6 +13150,10 @@ "UhdDeviceSettings": { "shape": "InputDeviceConfigurableSettings", "locationName": "uhdDeviceSettings" + }, + "AvailabilityZone": { + "shape": "__string", + "locationName": "availabilityZone" } } }, @@ -13160,6 +13176,10 @@ "UhdDeviceSettings": { "shape": "InputDeviceConfigurableSettings", "locationName": "uhdDeviceSettings" + }, + "AvailabilityZone": { + "shape": "__string", + "locationName": "availabilityZone" } }, "required": [ @@ -13217,9 +13237,13 @@ "shape": "InputDeviceUhdSettings", "locationName": "uhdDeviceSettings" }, - "Tags": { + "Tags": { "shape": "Tags", "locationName": "tags" + }, + "AvailabilityZone": { + "shape": "__string", + "locationName": "availabilityZone" } } }, diff --git a/models/apis/medialive/2017-10-14/docs-2.json b/models/apis/medialive/2017-10-14/docs-2.json index dc20f9f3cd0..166b39ff314 100644 --- a/models/apis/medialive/2017-10-14/docs-2.json +++ b/models/apis/medialive/2017-10-14/docs-2.json @@ -4617,6 +4617,7 @@ "InputDestinationVpc$AvailabilityZone": "The availability zone of the Input destination.\n", "InputDestinationVpc$NetworkInterfaceId": "The network interface ID of the Input destination in the VPC.\n", "InputDevice$Arn": "The unique ARN of the input device.", + "InputDevice$AvailabilityZone": "The Availability Zone associated with this input device.", "InputDevice$Id": "The unique ID of the input device.", "InputDevice$MacAddress": "The network MAC address of the input device.", "InputDevice$Name": "A name that you specify for the input device.", @@ -4628,6 +4629,7 @@ "InputDeviceRequest$Id": "The unique ID for the device.", "InputDeviceSettings$Id": "The unique ID for the device.", "InputDeviceSummary$Arn": "The unique ARN of the input device.", + "InputDeviceSummary$AvailabilityZone": "The Availability Zone associated with this input device.", "InputDeviceSummary$Id": "The unique ID of the input device.", "InputDeviceSummary$MacAddress": "The network MAC address of the input device.", "InputDeviceSummary$Name": "A name that you specify for the input device.", @@ -4761,6 +4763,7 @@ "UpdateChannel$RoleArn": "An optional Amazon Resource Name (ARN) of the role to assume when running the Channel. If you do not specify this on an update call but the role was previously set that role will be removed.", "UpdateInput$Name": "Name of the input.", "UpdateInput$RoleArn": "The Amazon Resource Name (ARN) of the role this input assumes during and after creation.", + "UpdateInputDevice$AvailabilityZone": "The Availability Zone you want associated with this input device.", "UpdateInputDevice$Name": "The name that you assigned to this input device (not the unique ID).", "UpdateMultiplex$Name": "Name of the multiplex.", "UpdateReservation$Name": "Name of the reservation", diff --git a/models/apis/polly/2016-06-10/api-2.json b/models/apis/polly/2016-06-10/api-2.json index ddda560128b..948fbcbc704 100644 --- a/models/apis/polly/2016-06-10/api-2.json +++ b/models/apis/polly/2016-06-10/api-2.json @@ -383,7 +383,8 @@ "ar-AE", "fi-FI", "en-IE", - "nl-BE" + "nl-BE", + "fr-BE" ] }, "LanguageCodeList":{ @@ -862,7 +863,8 @@ "Tomoko", "Niamh", "Sofie", - "Lisa" + "Lisa", + "Isabelle" ] }, "VoiceList":{ diff --git a/models/apis/rds/2014-10-31/api-2.json b/models/apis/rds/2014-10-31/api-2.json index 90026ecd68b..caf39366e5c 100644 --- a/models/apis/rds/2014-10-31/api-2.json +++ b/models/apis/rds/2014-10-31/api-2.json @@ -641,7 +641,24 @@ {"shape":"InvalidDBClusterStateFault"}, {"shape":"DBClusterSnapshotAlreadyExistsFault"}, {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"} + {"shape":"InvalidDBClusterSnapshotStateFault"}, + {"shape":"DBClusterAutomatedBackupQuotaExceededFault"} + ] + }, + "DeleteDBClusterAutomatedBackup":{ + "name":"DeleteDBClusterAutomatedBackup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteDBClusterAutomatedBackupMessage"}, + "output":{ + "shape":"DeleteDBClusterAutomatedBackupResult", + "resultWrapper":"DeleteDBClusterAutomatedBackupResult" + }, + "errors":[ + {"shape":"InvalidDBClusterAutomatedBackupStateFault"}, + {"shape":"DBClusterAutomatedBackupNotFoundFault"} ] }, "DeleteDBClusterEndpoint":{ @@ -914,6 +931,21 @@ {"shape":"CertificateNotFoundFault"} ] }, + "DescribeDBClusterAutomatedBackups":{ + "name":"DescribeDBClusterAutomatedBackups", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeDBClusterAutomatedBackupsMessage"}, + "output":{ + "shape":"DBClusterAutomatedBackupMessage", + "resultWrapper":"DescribeDBClusterAutomatedBackupsResult" + }, + "errors":[ + {"shape":"DBClusterAutomatedBackupNotFoundFault"} + ] + }, "DescribeDBClusterBacktracks":{ "name":"DescribeDBClusterBacktracks", "http":{ @@ -2165,7 +2197,8 @@ {"shape":"OptionGroupNotFoundFault"}, {"shape":"StorageQuotaExceededFault"}, {"shape":"DomainNotFoundFault"}, - {"shape":"DBClusterParameterGroupNotFoundFault"} + {"shape":"DBClusterParameterGroupNotFoundFault"}, + {"shape":"DBClusterAutomatedBackupNotFoundFault"} ] }, "RestoreDBInstanceFromDBSnapshot":{ @@ -3723,6 +3756,71 @@ }, "exception":true }, + "DBClusterAutomatedBackup":{ + "type":"structure", + "members":{ + "Engine":{"shape":"String"}, + "VpcId":{"shape":"String"}, + "DBClusterAutomatedBackupsArn":{"shape":"String"}, + "DBClusterIdentifier":{"shape":"String"}, + "RestoreWindow":{"shape":"RestoreWindow"}, + "MasterUsername":{"shape":"String"}, + "DbClusterResourceId":{"shape":"String"}, + "Region":{"shape":"String"}, + "LicenseModel":{"shape":"String"}, + "Status":{"shape":"String"}, + "IAMDatabaseAuthenticationEnabled":{"shape":"Boolean"}, + "ClusterCreateTime":{"shape":"TStamp"}, + "StorageEncrypted":{"shape":"Boolean"}, + "AllocatedStorage":{"shape":"Integer"}, + "EngineVersion":{"shape":"String"}, + "DBClusterArn":{"shape":"String"}, + "BackupRetentionPeriod":{"shape":"IntegerOptional"}, + "EngineMode":{"shape":"String"}, + "AvailabilityZones":{"shape":"AvailabilityZones"}, + "Port":{"shape":"Integer"}, + "KmsKeyId":{"shape":"String"}, + "StorageType":{"shape":"String"}, + "Iops":{"shape":"IntegerOptional"} + }, + "wrapper":true + }, + "DBClusterAutomatedBackupList":{ + "type":"list", + "member":{ + "shape":"DBClusterAutomatedBackup", + "locationName":"DBClusterAutomatedBackup" + } + }, + "DBClusterAutomatedBackupMessage":{ + "type":"structure", + "members":{ + "Marker":{"shape":"String"}, + "DBClusterAutomatedBackups":{"shape":"DBClusterAutomatedBackupList"} + } + }, + "DBClusterAutomatedBackupNotFoundFault":{ + "type":"structure", + "members":{ + }, + "error":{ + "code":"DBClusterAutomatedBackupNotFoundFault", + "httpStatusCode":404, + "senderFault":true + }, + "exception":true + }, + "DBClusterAutomatedBackupQuotaExceededFault":{ + "type":"structure", + "members":{ + }, + "error":{ + "code":"DBClusterAutomatedBackupQuotaExceededFault", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "DBClusterBacktrack":{ "type":"structure", "members":{ @@ -4026,7 +4124,8 @@ "IAMDatabaseAuthenticationEnabled":{"shape":"Boolean"}, "TagList":{"shape":"TagList"}, "DBSystemId":{"shape":"String"}, - "StorageType":{"shape":"String"} + "StorageType":{"shape":"String"}, + "DbClusterResourceId":{"shape":"String"} }, "wrapper":true }, @@ -5044,6 +5143,19 @@ "EngineVersion":{"shape":"CustomEngineVersion"} } }, + "DeleteDBClusterAutomatedBackupMessage":{ + "type":"structure", + "required":["DbClusterResourceId"], + "members":{ + "DbClusterResourceId":{"shape":"String"} + } + }, + "DeleteDBClusterAutomatedBackupResult":{ + "type":"structure", + "members":{ + "DBClusterAutomatedBackup":{"shape":"DBClusterAutomatedBackup"} + } + }, "DeleteDBClusterEndpointMessage":{ "type":"structure", "required":["DBClusterEndpointIdentifier"], @@ -5057,7 +5169,8 @@ "members":{ "DBClusterIdentifier":{"shape":"String"}, "SkipFinalSnapshot":{"shape":"Boolean"}, - "FinalDBSnapshotIdentifier":{"shape":"String"} + "FinalDBSnapshotIdentifier":{"shape":"String"}, + "DeleteAutomatedBackups":{"shape":"BooleanOptional"} } }, "DeleteDBClusterParameterGroupMessage":{ @@ -5253,6 +5366,16 @@ "Marker":{"shape":"String"} } }, + "DescribeDBClusterAutomatedBackupsMessage":{ + "type":"structure", + "members":{ + "DbClusterResourceId":{"shape":"String"}, + "DBClusterIdentifier":{"shape":"String"}, + "Filters":{"shape":"FilterList"}, + "MaxRecords":{"shape":"IntegerOptional"}, + "Marker":{"shape":"String"} + } + }, "DescribeDBClusterBacktracksMessage":{ "type":"structure", "required":["DBClusterIdentifier"], @@ -5317,7 +5440,8 @@ "MaxRecords":{"shape":"IntegerOptional"}, "Marker":{"shape":"String"}, "IncludeShared":{"shape":"Boolean"}, - "IncludePublic":{"shape":"Boolean"} + "IncludePublic":{"shape":"Boolean"}, + "DbClusterResourceId":{"shape":"String"} } }, "DescribeDBClustersMessage":{ @@ -6288,6 +6412,17 @@ }, "exception":true }, + "InvalidDBClusterAutomatedBackupStateFault":{ + "type":"structure", + "members":{ + }, + "error":{ + "code":"InvalidDBClusterAutomatedBackupStateFault", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "InvalidDBClusterCapacityFault":{ "type":"structure", "members":{ @@ -7901,10 +8036,7 @@ }, "RestoreDBClusterToPointInTimeMessage":{ "type":"structure", - "required":[ - "DBClusterIdentifier", - "SourceDBClusterIdentifier" - ], + "required":["DBClusterIdentifier"], "members":{ "DBClusterIdentifier":{"shape":"String"}, "RestoreType":{"shape":"String"}, @@ -7932,7 +8064,8 @@ "PubliclyAccessible":{"shape":"BooleanOptional"}, "Iops":{"shape":"IntegerOptional"}, "ServerlessV2ScalingConfiguration":{"shape":"ServerlessV2ScalingConfiguration"}, - "NetworkType":{"shape":"String"} + "NetworkType":{"shape":"String"}, + "SourceDbClusterResourceId":{"shape":"String"} } }, "RestoreDBClusterToPointInTimeResult":{ diff --git a/models/apis/rds/2014-10-31/docs-2.json b/models/apis/rds/2014-10-31/docs-2.json index 9f8f0fae144..749c8660490 100644 --- a/models/apis/rds/2014-10-31/docs-2.json +++ b/models/apis/rds/2014-10-31/docs-2.json @@ -35,6 +35,7 @@ "DeleteBlueGreenDeployment": "Deletes a blue/green deployment.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
", "DeleteCustomDBEngineVersion": "Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:
The CEV must not be the default for RDS Custom. If it is, change the default before running this command.
The CEV must not be associated with an RDS Custom DB instance, RDS Custom instance snapshot, or automated backup of your RDS Custom instance.
Typically, deletion takes a few minutes.
The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the DeleteCustomDbEngineVersion event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for the DeleteCustomDbEngineVersion event.
For more information, see Deleting a CEV in the Amazon RDS User Guide.
", "DeleteDBCluster": "The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.
If you're deleting a Multi-AZ DB cluster with read replicas, all cluster members are terminated and read replicas are promoted to standalone instances.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
", + "DeleteDBClusterAutomatedBackup": "Deletes automated backups using the DbClusterResourceId value of the source DB cluster or the Amazon Resource Name (ARN) of the automated backups.
Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
", "DeleteDBClusterSnapshot": "Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB cluster snapshot must be in the available state to be deleted.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
", @@ -53,6 +54,7 @@ "DescribeAccountAttributes": "Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.
This command doesn't take any parameters.
", "DescribeBlueGreenDeployments": "Describes one or more blue/green deployments.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
", "DescribeCertificates": "Lists the set of CA certificates provided by Amazon RDS for this Amazon Web Services account.
For more information, see Using SSL/TLS to encrypt a connection to a DB instance in the Amazon RDS User Guide and Using SSL/TLS to encrypt a connection to a DB cluster in the Amazon Aurora User Guide.
", + "DescribeDBClusterAutomatedBackups": "Displays backups for both current and deleted DB clusters. For example, use this operation to find details about automated backups for previously deleted clusters. Current clusters are returned for both the DescribeDBClusterAutomatedBackups and DescribeDBClusters operations.
All parameters are optional.
", "DescribeDBClusterBacktracks": "Returns information about backtracks for a DB cluster.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This action only applies to Aurora MySQL DB clusters.
Returns information about endpoints for an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list will contain only the description of the specified DB cluster parameter group.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
", @@ -311,6 +313,7 @@ "refs": { "CreateDBClusterMessage$AvailabilityZones": "A list of Availability Zones (AZs) where DB instances in the DB cluster can be created.
For information on Amazon Web Services Regions and Availability Zones, see Choosing the Regions and Availability Zones in the Amazon Aurora User Guide.
Valid for Cluster Type: Aurora DB clusters only
", "DBCluster$AvailabilityZones": "The list of Availability Zones (AZs) where instances in the DB cluster can be created.
", + "DBClusterAutomatedBackup$AvailabilityZones": "The Availability Zones where instances in the DB cluster can be created. For information on Amazon Web Services Regions and Availability Zones, see Regions and Availability Zones.
", "DBClusterSnapshot$AvailabilityZones": "Provides the list of Availability Zones (AZs) where instances in the DB cluster snapshot can be restored.
", "RestoreDBClusterFromS3Message$AvailabilityZones": "A list of Availability Zones (AZs) where instances in the restored DB cluster can be created.
", "RestoreDBClusterFromSnapshotMessage$AvailabilityZones": "Provides the list of Availability Zones (AZs) where instances in the restored DB cluster can be created.
Valid for: Aurora DB clusters only
" @@ -429,6 +432,8 @@ "CreateDBProxyRequest$DebugLogging": "Whether the proxy includes detailed information about SQL statements in its logs. This information helps you to debug issues involving SQL behavior or the performance and scalability of the proxy connections. The debug information includes the text of SQL statements that you submit through the proxy. Thus, only enable this setting when needed for debugging, and only when you have security measures in place to safeguard any sensitive information that appears in the logs.
", "DBCluster$StorageEncrypted": "Indicates whether the DB cluster is encrypted.
", "DBCluster$AutoMinorVersionUpgrade": "Indicates whether minor version patches are applied automatically.
This setting is only for non-Aurora Multi-AZ DB clusters.
", + "DBClusterAutomatedBackup$IAMDatabaseAuthenticationEnabled": "True if mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
", + "DBClusterAutomatedBackup$StorageEncrypted": "Specifies whether the source DB cluster is encrypted.
", "DBClusterMember$IsClusterWriter": "Value that is true if the cluster member is the primary instance for the DB cluster and false otherwise.
Specifies whether the DB cluster snapshot is encrypted.
", "DBClusterSnapshot$IAMDatabaseAuthenticationEnabled": "True if mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
", @@ -567,6 +572,7 @@ "DBInstance$CustomerOwnedIpEnabled": "Indicates whether a customer-owned IP address (CoIP) is enabled for an RDS on Outposts DB instance.
A CoIP provides local or external connectivity to resources in your Outpost subnets through your on-premises network. For some use cases, a CoIP can provide lower latency for connections to the DB instance from outside of its virtual private cloud (VPC) on your local network.
For more information about RDS on Outposts, see Working with Amazon RDS on Amazon Web Services Outposts in the Amazon RDS User Guide.
For more information about CoIPs, see Customer-owned IP addresses in the Amazon Web Services Outposts User Guide.
", "DBInstance$ActivityStreamEngineNativeAuditFieldsIncluded": "Indicates whether engine-native audit fields are included in the database activity stream.
", "DeleteBlueGreenDeploymentRequest$DeleteTarget": "Specifies whether to delete the resources in the green environment. You can't specify this option if the blue/green deployment status is SWITCHOVER_COMPLETED.
A value that indicates whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted.
", "DeleteDBInstanceMessage$DeleteAutomatedBackups": "A value that indicates whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted.
", "DescribeDBEngineVersionsMessage$ListSupportedCharacterSets": "A value that indicates whether to list the supported character sets for each engine version.
If this parameter is enabled and the requested engine supports the CharacterSetName parameter for CreateDBInstance, the response includes a list of supported character sets for each engine version.
For RDS Custom, the default is not to list supported character sets. If you set ListSupportedCharacterSets to true, RDS Custom returns no results.
A value that indicates whether to list the supported time zones for each engine version.
If this parameter is enabled and the requested engine supports the TimeZone parameter for CreateDBInstance, the response includes a list of supported time zones for each engine version.
For RDS Custom, the default is not to list supported time zones. If you set ListSupportedTimezones to true, RDS Custom returns no results.
An automated backup of a DB cluster. It consists of system backups, transaction logs, and the database cluster properties that existed at the time you deleted the source cluster.
", + "refs": { + "DBClusterAutomatedBackupList$member": null, + "DeleteDBClusterAutomatedBackupResult$DBClusterAutomatedBackup": null + } + }, + "DBClusterAutomatedBackupList": { + "base": null, + "refs": { + "DBClusterAutomatedBackupMessage$DBClusterAutomatedBackups": "A list of DBClusterAutomatedBackup backups.
No automated backup for this DB cluster was found.
", + "refs": { + } + }, + "DBClusterAutomatedBackupQuotaExceededFault": { + "base": "The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB cluster quota.
", + "refs": { + } + }, "DBClusterBacktrack": { "base": "This data type is used as a response element in the DescribeDBClusterBacktracks action.
The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB Instance quota.
", + "base": "The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB instance quota.
", "refs": { } }, @@ -1776,6 +1810,16 @@ "refs": { } }, + "DeleteDBClusterAutomatedBackupMessage": { + "base": null, + "refs": { + } + }, + "DeleteDBClusterAutomatedBackupResult": { + "base": null, + "refs": { + } + }, "DeleteDBClusterEndpointMessage": { "base": null, "refs": { @@ -1926,6 +1970,11 @@ "refs": { } }, + "DescribeDBClusterAutomatedBackupsMessage": { + "base": null, + "refs": { + } + }, "DescribeDBClusterBacktracksMessage": { "base": "", "refs": { @@ -2442,6 +2491,7 @@ "refs": { "DescribeBlueGreenDeploymentsRequest$Filters": "A filter that specifies one or more blue/green deployments to describe.
Valid Values:
blue-green-deployment-identifier - Accepts system-generated identifiers for blue/green deployments. The results list only includes information about the blue/green deployments with the specified identifiers.
blue-green-deployment-name - Accepts user-supplied names for blue/green deployments. The results list only includes information about the blue/green deployments with the specified names.
source - Accepts source databases for a blue/green deployment. The results list only includes information about the blue/green deployments with the specified source databases.
target - Accepts target databases for a blue/green deployment. The results list only includes information about the blue/green deployments with the specified target databases.
This parameter isn't currently supported.
", + "DescribeDBClusterAutomatedBackupsMessage$Filters": "A filter that specifies which resources to return based on status.
Supported filters are the following:
status
retained - Automated backups for deleted clusters and after backup replication is stopped.
db-cluster-id - Accepts DB cluster identifiers and Amazon Resource Names (ARNs). The results list includes only information about the DB cluster automated backups identified by these ARNs.
db-cluster-resource-id - Accepts DB resource identifiers and Amazon Resource Names (ARNs). The results list includes only information about the DB cluster resources identified by these ARNs.
Returns all resources by default. The status for each resource is specified in the response.
", "DescribeDBClusterBacktracksMessage$Filters": "A filter that specifies one or more DB clusters to describe. Supported filters include the following:
db-cluster-backtrack-id - Accepts backtrack identifiers. The results list includes information about only the backtracks identified by these identifiers.
db-cluster-backtrack-status - Accepts any of the following backtrack status values:
applying
completed
failed
pending
The results list includes information about only the backtracks identified by these values.
A set of name-value pairs that define which endpoints to include in the output. The filters are specified as name-value pairs, in the format Name=endpoint_type,Values=endpoint_type1,endpoint_type2,.... Name can be one of: db-cluster-endpoint-type, db-cluster-endpoint-custom-type, db-cluster-endpoint-id, db-cluster-endpoint-status. Values for the db-cluster-endpoint-type filter can be one or more of: reader, writer, custom. Values for the db-cluster-endpoint-custom-type filter can be one or more of: reader, any. Values for the db-cluster-endpoint-status filter can be one or more of: available, creating, deleting, inactive, modifying.
This parameter isn't currently supported.
", @@ -2449,7 +2499,7 @@ "DescribeDBClusterSnapshotsMessage$Filters": "A filter that specifies one or more DB cluster snapshots to describe.
Supported filters:
db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs).
db-cluster-snapshot-id - Accepts DB cluster snapshot identifiers.
snapshot-type - Accepts types of DB cluster snapshots.
engine - Accepts names of database engines.
A filter that specifies one or more DB clusters to describe.
Supported Filters:
clone-group-id - Accepts clone group identifiers. The results list only includes information about the DB clusters associated with these clone groups.
db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list only includes information about the DB clusters identified by these ARNs.
db-cluster-resource-id - Accepts DB cluster resource identifiers. The results list will only include information about the DB clusters identified by these DB cluster resource identifiers.
domain - Accepts Active Directory directory IDs. The results list only includes information about the DB clusters associated with these domains.
engine - Accepts engine names. The results list only includes information about the DB clusters for these engines.
A filter that specifies one or more DB engine versions to describe.
Supported filters:
db-parameter-group-family - Accepts parameter groups family names. The results list only includes information about the DB engine versions for these parameter group families.
engine - Accepts engine names. The results list only includes information about the DB engine versions for these engines.
engine-mode - Accepts DB engine modes. The results list only includes information about the DB engine versions for these engine modes. Valid DB engine modes are the following:
global
multimaster
parallelquery
provisioned
serverless
engine-version - Accepts engine versions. The results list only includes information about the DB engine versions for these engine versions.
status - Accepts engine version statuses. The results list only includes information about the DB engine versions for these statuses. Valid statuses are the following:
available
deprecated
A filter that specifies which resources to return based on status.
Supported filters are the following:
status
active - automated backups for current instances
retained - automated backups for deleted instances and after backup replication is stopped
creating - automated backups that are waiting for the first automated snapshot to be available
db-instance-id - Accepts DB instance identifiers and Amazon Resource Names (ARNs). The results list includes only information about the DB instance automated backups identified by these ARNs.
dbi-resource-id - Accepts DB resource identifiers and Amazon Resource Names (ARNs). The results list includes only information about the DB instance resources identified by these ARNs.
Returns all resources by default. The status for each resource is specified in the response.
", + "DescribeDBInstanceAutomatedBackupsMessage$Filters": "A filter that specifies which resources to return based on status.
Supported filters are the following:
status
active - Automated backups for current instances.
creating - Automated backups that are waiting for the first automated snapshot to be available.
retained - Automated backups for deleted instances and after backup replication is stopped.
db-instance-id - Accepts DB instance identifiers and Amazon Resource Names (ARNs). The results list includes only information about the DB instance automated backups identified by these ARNs.
dbi-resource-id - Accepts DB resource identifiers and Amazon Resource Names (ARNs). The results list includes only information about the DB instance resources identified by these ARNs.
Returns all resources by default. The status for each resource is specified in the response.
", "DescribeDBInstancesMessage$Filters": "A filter that specifies one or more DB instances to describe.
Supported Filters:
db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list only includes information about the DB instances associated with the DB clusters identified by these ARNs.
db-instance-id - Accepts DB instance identifiers and DB instance Amazon Resource Names (ARNs). The results list only includes information about the DB instances identified by these ARNs.
dbi-resource-id - Accepts DB instance resource identifiers. The results list only includes information about the DB instances identified by these DB instance resource identifiers.
domain - Accepts Active Directory directory IDs. The results list only includes information about the DB instances associated with these domains.
engine - Accepts engine names. The results list only includes information about the DB instances for these engines.
This parameter isn't currently supported.
", "DescribeDBParameterGroupsMessage$Filters": "This parameter isn't currently supported.
", @@ -2599,6 +2649,8 @@ "ConnectionPoolConfigurationInfo$MaxConnectionsPercent": "The maximum size of the connection pool for each target in a target group. The value is expressed as a percentage of the max_connections setting for the RDS DB instance or Aurora DB cluster used by the target group.
Controls how actively the proxy closes idle database connections in the connection pool. The value is expressed as a percentage of the max_connections setting for the RDS DB instance or Aurora DB cluster used by the target group. With a high value, the proxy leaves a high percentage of idle database connections open. A low value causes the proxy to close more idle connections and return them to the database.
The number of seconds for a proxy to wait for a connection to become available in the connection pool. Only applies when the proxy has opened its maximum number of connections and all connections are busy with client sessions.
", + "DBClusterAutomatedBackup$AllocatedStorage": "For all database engines except Amazon Aurora, AllocatedStorage specifies the allocated storage size in gibibytes (GiB). For Aurora, AllocatedStorage always returns 1, because Aurora DB cluster storage size isn't fixed, but instead automatically adjusts as needed.
The port number that the automated backup used for connections.
Default: Inherits from the source DB cluster
Valid Values: 1150-65535
Specifies the allocated storage size in gibibytes (GiB).
", "DBClusterSnapshot$Port": "Specifies the port that the DB cluster was listening on at the time of the snapshot.
", "DBClusterSnapshot$PercentProgress": "Specifies the percentage of the estimated data that has been transferred.
", @@ -2662,6 +2714,8 @@ "DBCluster$Iops": "The Provisioned IOPS (I/O operations per second) value.
This setting is only for non-Aurora Multi-AZ DB clusters.
", "DBCluster$MonitoringInterval": "The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster.
This setting is only for non-Aurora Multi-AZ DB clusters.
", "DBCluster$PerformanceInsightsRetentionPeriod": "The number of days to retain Performance Insights data.
This setting is only for non-Aurora Multi-AZ DB clusters.
Valid Values:
7
month * 31, where month is a number of months from 1-23. Examples: 93 (3 months * 31), 341 (11 months * 31), 589 (19 months * 31)
731
Default: 7 days
The retention period for the automated backups.
", + "DBClusterAutomatedBackup$Iops": "The IOPS (I/O operations per second) value for the automated backup.
This setting is only for non-Aurora Multi-AZ DB clusters.
", "DBClusterCapacityInfo$PendingCapacity": "A value that specifies the capacity that the DB cluster scales to next.
", "DBClusterCapacityInfo$CurrentCapacity": "The current capacity of the DB cluster.
", "DBClusterCapacityInfo$SecondsBeforeTimeout": "The number of seconds before a call to ModifyCurrentDBClusterCapacity times out.
Specifies the Provisioned IOPS (I/O operations per second) value of the DB instance at the time of the snapshot.
", "DBSnapshot$StorageThroughput": "Specifies the storage throughput for the DB snapshot.
", "DescribeCertificatesMessage$MaxRecords": "The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.
", + "DescribeDBClusterAutomatedBackupsMessage$MaxRecords": "The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that you can retrieve the remaining results.
The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.
", "DescribeDBClusterEndpointsMessage$MaxRecords": "The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.
", "DescribeDBClusterParameterGroupsMessage$MaxRecords": "The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.
", @@ -2786,6 +2841,11 @@ "refs": { } }, + "InvalidDBClusterAutomatedBackupStateFault": { + "base": "The automated backup is in an invalid state. For example, this automated backup is associated with an active cluster.
", + "refs": { + } + }, "InvalidDBClusterCapacityFault": { "base": " Capacity isn't a valid Aurora Serverless DB cluster capacity. Valid capacity values are 2, 4, 8, 16, 32, 64, 128, and 256.
Earliest and latest time an instance can be restored to:
", "refs": { + "DBClusterAutomatedBackup$RestoreWindow": null, "DBInstanceAutomatedBackup$RestoreWindow": "Earliest and latest time an instance can be restored to.
" } }, @@ -4150,6 +4211,21 @@ "DBCluster$PerformanceInsightsKMSKeyId": "The Amazon Web Services KMS key identifier for encryption of Performance Insights data.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
This setting is only for non-Aurora Multi-AZ DB clusters.
", "DBCluster$NetworkType": "The network type of the DB instance.
The network type is determined by the DBSubnetGroup specified for the DB cluster. A DBSubnetGroup can support only the IPv4 protocol or the IPv4 and the IPv6 protocols (DUAL).
For more information, see Working with a DB instance in a VPC in the Amazon Aurora User Guide.
This setting is only for Aurora DB clusters.
Valid Values: IPV4 | DUAL
Reserved for future use.
", + "DBClusterAutomatedBackup$Engine": "The name of the database engine for this automated backup.
", + "DBClusterAutomatedBackup$VpcId": "The VPC ID associated with the DB cluster.
", + "DBClusterAutomatedBackup$DBClusterAutomatedBackupsArn": "The Amazon Resource Name (ARN) for the automated backups.
", + "DBClusterAutomatedBackup$DBClusterIdentifier": "The identifier for the source DB cluster, which can't be changed and which is unique to an Amazon Web Services Region.
", + "DBClusterAutomatedBackup$MasterUsername": "The master user name of the automated backup.
", + "DBClusterAutomatedBackup$DbClusterResourceId": "The resource ID for the source DB cluster, which can't be changed and which is unique to an Amazon Web Services Region.
", + "DBClusterAutomatedBackup$Region": "The Amazon Web Services Region associated with the automated backup.
", + "DBClusterAutomatedBackup$LicenseModel": "The license model information for this DB cluster automated backup.
", + "DBClusterAutomatedBackup$Status": "A list of status information for an automated backup:
retained - Automated backups for deleted clusters.
The version of the database engine for the automated backup.
", + "DBClusterAutomatedBackup$DBClusterArn": "The Amazon Resource Name (ARN) for the source DB cluster.
", + "DBClusterAutomatedBackup$EngineMode": "The engine mode of the database engine for the automated backup.
", + "DBClusterAutomatedBackup$KmsKeyId": "The Amazon Web Services KMS key ID for an automated backup.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
", + "DBClusterAutomatedBackup$StorageType": "The storage type associated with the DB cluster.
This setting is only for non-Aurora Multi-AZ DB clusters.
", + "DBClusterAutomatedBackupMessage$Marker": "The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.
Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.
", "DBClusterBacktrack$BacktrackIdentifier": "Contains the backtrack identifier.
", "DBClusterBacktrack$Status": "The status of the backtrack. This property returns one of the following values:
applying - The backtrack is currently being applied to or rolled back from the DB cluster.
completed - The backtrack has successfully been applied to or rolled back from the DB cluster.
failed - An error occurred while the backtrack was applied to or rolled back from the DB cluster.
pending - The backtrack is currently pending application to or rollback from the DB cluster.
Provides the license model information for this DB cluster snapshot.
", "DBClusterSnapshot$SnapshotType": "Provides the type of the DB cluster snapshot.
", "DBClusterSnapshot$KmsKeyId": "If StorageEncrypted is true, the Amazon Web Services KMS key identifier for the encrypted DB cluster snapshot.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
", - "DBClusterSnapshot$DBClusterSnapshotArn": "The Amazon Resource Name (ARN) for the DB cluster snapshot.
", + "DBClusterSnapshot$DBClusterSnapshotArn": "Specifies the Amazon Resource Name (ARN) for the DB cluster snapshot.
", "DBClusterSnapshot$SourceDBClusterSnapshotArn": "If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.
", "DBClusterSnapshot$DBSystemId": "Reserved for future use.
", "DBClusterSnapshot$StorageType": "The storage type associated with the DB cluster snapshot.
This setting is only for Aurora DB clusters.
", + "DBClusterSnapshot$DbClusterResourceId": "Specifies the resource ID of the DB cluster that this DB cluster snapshot was created from.
", "DBClusterSnapshotAttribute$AttributeName": "The name of the manual DB cluster snapshot attribute.
The attribute named restore refers to the list of Amazon Web Services accounts that have permission to copy or restore the manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.
The identifier of the manual DB cluster snapshot that the attributes apply to.
", "DBClusterSnapshotMessage$Marker": "An optional pagination token provided by a previous DescribeDBClusterSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The identifier of the source DB cluster if this DB instance is a read replica.
", "DBInstance$PercentProgress": "The progress of the storage optimization operation as a percentage.
", "DBInstanceAutomatedBackup$DBInstanceArn": "The Amazon Resource Name (ARN) for the automated backups.
", - "DBInstanceAutomatedBackup$DbiResourceId": "The identifier for the source DB instance, which can't be changed and which is unique to an Amazon Web Services Region.
", + "DBInstanceAutomatedBackup$DbiResourceId": "The resource ID for the source DB instance, which can't be changed and which is unique to an Amazon Web Services Region.
", "DBInstanceAutomatedBackup$Region": "The Amazon Web Services Region associated with the automated backup.
", - "DBInstanceAutomatedBackup$DBInstanceIdentifier": "The customer id of the instance that is/was associated with the automated backup.
", - "DBInstanceAutomatedBackup$Status": "Provides a list of status information for an automated backup:
active - automated backups for current instances
retained - automated backups for deleted instances
creating - automated backups that are waiting for the first automated snapshot to be available.
The identifier for the source DB instance, which can't be changed and which is unique to an Amazon Web Services Region.
", + "DBInstanceAutomatedBackup$Status": "Provides a list of status information for an automated backup:
active - Automated backups for current instances.
retained - Automated backups for deleted instances.
creating - Automated backups that are waiting for the first automated snapshot to be available.
The Availability Zone that the automated backup was created in. For information on Amazon Web Services Regions and Availability Zones, see Regions and Availability Zones.
", "DBInstanceAutomatedBackup$VpcId": "Provides the VPC ID associated with the DB instance.
", - "DBInstanceAutomatedBackup$MasterUsername": "The license model of an automated backup.
", + "DBInstanceAutomatedBackup$MasterUsername": "The master user name of an automated backup.
", "DBInstanceAutomatedBackup$Engine": "The name of the database engine for this automated backup.
", "DBInstanceAutomatedBackup$EngineVersion": "The version of the database engine for the automated backup.
", "DBInstanceAutomatedBackup$LicenseModel": "License model information for the automated backup.
", @@ -4340,6 +4417,7 @@ "DBSubnetGroup$SubnetGroupStatus": "Provides the status of the DB subnet group.
", "DBSubnetGroup$DBSubnetGroupArn": "The Amazon Resource Name (ARN) for the DB subnet group.
", "DBSubnetGroupMessage$Marker": "An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The identifier for the source DB cluster, which can't be changed and which is unique to an Amazon Web Services Region.
", "DeleteDBClusterEndpointMessage$DBClusterEndpointIdentifier": "The identifier associated with the custom endpoint. This parameter is stored as a lowercase string.
", "DeleteDBClusterMessage$DBClusterIdentifier": "The DB cluster identifier for the DB cluster to be deleted. This parameter isn't case-sensitive.
Constraints:
Must match an existing DBClusterIdentifier.
The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is disabled.
Specifying this parameter and also skipping the creation of a final DB cluster snapshot with the SkipFinalShapshot parameter results in an error.
Constraints:
Must be 1 to 255 letters, numbers, or hyphens.
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
A pagination token that can be used in a later DescribeBlueGreenDeployments request.
The user-supplied certificate identifier. If this parameter is specified, information for only the identified certificate is returned. This parameter isn't case-sensitive.
Constraints:
Must match an existing CertificateIdentifier.
An optional pagination token provided by a previous DescribeCertificates request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The resource ID of the DB cluster that is the source of the automated backup. This parameter isn't case-sensitive.
", + "DescribeDBClusterAutomatedBackupsMessage$DBClusterIdentifier": "(Optional) The user-supplied DB cluster identifier. If this parameter is specified, it must match the identifier of an existing DB cluster. It returns information from the specific DB cluster's automated backup. This parameter isn't case-sensitive.
", + "DescribeDBClusterAutomatedBackupsMessage$Marker": "The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.
The DB cluster identifier of the DB cluster to be described. This parameter is stored as a lowercase string.
Constraints:
Must contain from 1 to 63 alphanumeric characters or hyphens.
First character must be a letter.
Can't end with a hyphen or contain two consecutive hyphens.
Example: my-cluster1
If specified, this value is the backtrack identifier of the backtrack to be described.
Constraints:
Must contain a valid universally unique identifier (UUID). For more information about UUIDs, see Universally unique identifier.
Example: 123e4567-e89b-12d3-a456-426655440000
An optional pagination token provided by a previous DescribeDBClusterBacktracks request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
A specific DB cluster snapshot identifier to describe. This parameter can't be used in conjunction with the DBClusterIdentifier parameter. This value is stored as a lowercase string.
Constraints:
If supplied, must match the identifier of an existing DBClusterSnapshot.
If this identifier is for an automated snapshot, the SnapshotType parameter must also be specified.
The type of DB cluster snapshots to be returned. You can specify one of the following values:
automated - Return all DB cluster snapshots that have been automatically taken by Amazon RDS for my Amazon Web Services account.
manual - Return all DB cluster snapshots that have been taken by my Amazon Web Services account.
shared - Return all manual DB cluster snapshots that have been shared to my Amazon Web Services account.
public - Return all DB cluster snapshots that have been marked as public.
If you don't specify a SnapshotType value, then both automated and manual DB cluster snapshots are returned. You can include shared DB cluster snapshots with these results by enabling the IncludeShared parameter. You can include public DB cluster snapshots with these results by enabling the IncludePublic parameter.
The IncludeShared and IncludePublic parameters don't apply for SnapshotType values of manual or automated. The IncludePublic parameter doesn't apply when SnapshotType is set to shared. The IncludeShared parameter doesn't apply when SnapshotType is set to public.
An optional pagination token provided by a previous DescribeDBClusterSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
A specific DB cluster resource ID to describe.
", "DescribeDBClustersMessage$DBClusterIdentifier": "The user-supplied DB cluster identifier or the Amazon Resource Name (ARN) of the DB cluster. If this parameter is specified, information for only the specific DB cluster is returned. This parameter isn't case-sensitive.
Constraints:
If supplied, must match an existing DB cluster identifier.
An optional pagination token provided by a previous DescribeDBClusters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The database engine to return.
Valid Values:
aurora-mysql
aurora-postgresql
custom-oracle-ee
mariadb
mysql
oracle-ee
oracle-ee-cdb
oracle-se2
oracle-se2-cdb
postgres
sqlserver-ee
sqlserver-se
sqlserver-ex
sqlserver-web
The name of a specific DB parameter group family to return details for.
Constraints:
If supplied, must match an existing DBParameterGroupFamily.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
The resource ID of the DB instance that is the source of the automated backup. This parameter isn't case-sensitive.
", - "DescribeDBInstanceAutomatedBackupsMessage$DBInstanceIdentifier": "(Optional) The user-supplied instance identifier. If this parameter is specified, it must match the identifier of an existing DB instance. It returns information from the specific DB instance' automated backup. This parameter isn't case-sensitive.
", + "DescribeDBInstanceAutomatedBackupsMessage$DBInstanceIdentifier": "(Optional) The user-supplied instance identifier. If this parameter is specified, it must match the identifier of an existing DB instance. It returns information from the specific DB instance's automated backup. This parameter isn't case-sensitive.
", "DescribeDBInstanceAutomatedBackupsMessage$Marker": "The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.
The Amazon Resource Name (ARN) of the replicated automated backups, for example, arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE.
This setting doesn't apply to RDS Custom.
", "DescribeDBInstancesMessage$DBInstanceIdentifier": "The user-supplied instance identifier or the Amazon Resource Name (ARN) of the DB instance. If this parameter is specified, information from only the specific DB instance is returned. This parameter isn't case-sensitive.
Constraints:
If supplied, must match the identifier of an existing DB instance.
The compute and memory capacity of the each DB instance in the Multi-AZ DB cluster, for example db.m6gd.xlarge. Not all DB instance classes are available in all Amazon Web Services Regions, or for all database engines.
For the full list of DB instance classes, and availability for your engine, see DB instance class in the Amazon RDS User Guide.
Valid for: Multi-AZ DB clusters only
", "RestoreDBClusterToPointInTimeMessage$StorageType": "Specifies the storage type to be associated with the DB cluster.
When specified for a Multi-AZ DB cluster, a value for the Iops parameter is required.
Valid values: aurora, aurora-iopt1 (Aurora DB clusters); io1 (Multi-AZ DB clusters)
Default: aurora (Aurora DB clusters); io1 (Multi-AZ DB clusters)
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", "RestoreDBClusterToPointInTimeMessage$NetworkType": "The network type of the DB cluster.
Valid values:
IPV4
DUAL
The network type is determined by the DBSubnetGroup specified for the DB cluster. A DBSubnetGroup can support only the IPv4 protocol or the IPv4 and the IPv6 protocols (DUAL).
For more information, see Working with a DB instance in a VPC in the Amazon Aurora User Guide.
Valid for: Aurora DB clusters only
", + "RestoreDBClusterToPointInTimeMessage$SourceDbClusterResourceId": "The resource ID of the source DB cluster from which to restore.
", "RestoreDBInstanceFromDBSnapshotMessage$DBInstanceIdentifier": "Name of the DB instance to create from the DB snapshot. This parameter isn't case-sensitive.
Constraints:
Must contain from 1 to 63 numbers, letters, or hyphens
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
Example: my-snapshot-id
The identifier for the DB snapshot to restore from.
Constraints:
Must match the identifier of an existing DBSnapshot.
Can't be specified when DBClusterSnapshotIdentifier is specified.
Must be specified when DBClusterSnapshotIdentifier isn't specified.
If you are restoring from a shared manual DB snapshot, the DBSnapshotIdentifier must be the ARN of the shared DB snapshot.
The compute and memory capacity of the Amazon RDS DB instance, for example db.m4.large. Not all DB instance classes are available in all Amazon Web Services Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.
Default: The same DBInstanceClass as the original DB instance.
", @@ -5064,6 +5147,7 @@ "DBCluster$ClusterCreateTime": "The time when the DB cluster was created, in Universal Coordinated Time (UTC).
", "DBCluster$EarliestBacktrackTime": "The earliest time to which a DB cluster can be backtracked.
", "DBCluster$IOOptimizedNextAllowedModificationTime": "The next time you can modify the DB cluster to use the aurora-iopt1 storage type.
This setting is only for Aurora DB clusters.
", + "DBClusterAutomatedBackup$ClusterCreateTime": "The time when the DB cluster was created, in Universal Coordinated Time (UTC).
", "DBClusterBacktrack$BacktrackTo": "The timestamp of the time to which the DB cluster was backtracked.
", "DBClusterBacktrack$BacktrackedFrom": "The timestamp of the time from which the DB cluster was backtracked.
", "DBClusterBacktrack$BacktrackRequestCreationTime": "The timestamp of the time at which the backtrack was requested.
", diff --git a/models/apis/rds/2014-10-31/endpoint-rule-set-1.json b/models/apis/rds/2014-10-31/endpoint-rule-set-1.json index b9aff9f06c8..00bd15c3610 100644 --- a/models/apis/rds/2014-10-31/endpoint-rule-set-1.json +++ b/models/apis/rds/2014-10-31/endpoint-rule-set-1.json @@ -58,52 +58,56 @@ "type": "error" }, { - "conditions": [], - "type": "tree", - "rules": [ + "conditions": [ { - "conditions": [ + "fn": "booleanEquals", + "argv": [ { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" - }, - true - ] - } - ], - "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", - "type": "error" - }, - { - "conditions": [], - "endpoint": { - "url": { - "ref": "Endpoint" + "ref": "UseDualStack" }, - "properties": {}, - "headers": {} - }, - "type": "endpoint" + true + ] } - ] + ], + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], + "endpoint": { + "url": { + "ref": "Endpoint" + }, + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, { - "conditions": [], + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Region" + } + ] + } + ], "type": "tree", "rules": [ { "conditions": [ { - "fn": "isSet", + "fn": "aws.partition", "argv": [ { "ref": "Region" } - ] + ], + "assign": "PartitionResult" } ], "type": "tree", @@ -111,13 +115,22 @@ { "conditions": [ { - "fn": "aws.partition", + "fn": "booleanEquals", "argv": [ { - "ref": "Region" - } - ], - "assign": "PartitionResult" + "ref": "UseFIPS" + }, + true + ] + }, + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] } ], "type": "tree", @@ -127,92 +140,83 @@ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } ] }, { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - }, - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://rds-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, + } + ], + "type": "tree", + "rules": [ { "conditions": [], - "error": "FIPS and DualStack are enabled, but this partition does not support one or both", - "type": "error" + "endpoint": { + "url": "https://rds-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, + { + "conditions": [], + "error": "FIPS and DualStack are enabled, but this partition does not support one or both", + "type": "error" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "type": "tree", + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } ] } ], @@ -221,155 +225,115 @@ { "conditions": [ { - "fn": "booleanEquals", + "fn": "stringEquals", "argv": [ - true, + "aws-us-gov", { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, - "supportsFIPS" + "name" ] } ] } ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "stringEquals", - "argv": [ - "aws-us-gov", - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "name" - ] - } - ] - } - ], - "endpoint": { - "url": "https://rds.{Region}.amazonaws.com", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - }, - { - "conditions": [], - "endpoint": { - "url": "https://rds-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - } - ] + "endpoint": { + "url": "https://rds.{Region}.amazonaws.com", + "properties": {}, + "headers": {} + }, + "type": "endpoint" }, { "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" + "endpoint": { + "url": "https://rds-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, + { + "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "type": "tree", + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://rds.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, - { - "conditions": [], - "error": "DualStack is enabled but this partition does not support DualStack", - "type": "error" } - ] - }, - { - "conditions": [], + ], "type": "tree", "rules": [ { "conditions": [], "endpoint": { - "url": "https://rds.{Region}.{PartitionResult#dnsSuffix}", + "url": "https://rds.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ] + }, + { + "conditions": [], + "error": "DualStack is enabled but this partition does not support DualStack", + "type": "error" } ] + }, + { + "conditions": [], + "endpoint": { + "url": "https://rds.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] - }, - { - "conditions": [], - "error": "Invalid Configuration: Missing Region", - "type": "error" } ] + }, + { + "conditions": [], + "error": "Invalid Configuration: Missing Region", + "type": "error" } ] } \ No newline at end of file diff --git a/models/apis/sagemaker/2017-07-24/api-2.json b/models/apis/sagemaker/2017-07-24/api-2.json index 21716888db3..c7618c2b9ae 100644 --- a/models/apis/sagemaker/2017-07-24/api-2.json +++ b/models/apis/sagemaker/2017-07-24/api-2.json @@ -10800,6 +10800,13 @@ "max":40, "min":0 }, + "FlatInvocations":{ + "type":"string", + "enum":[ + "Continue", + "Stop" + ] + }, "Float":{"type":"float"}, "FlowDefinitionArn":{ "type":"string", @@ -16155,6 +16162,10 @@ "max":9, "min":1 }, + "NumberOfSteps":{ + "type":"integer", + "min":1 + }, "ObjectiveStatus":{ "type":"string", "enum":[ @@ -17808,7 +17819,8 @@ "type":"structure", "members":{ "MaxInvocations":{"shape":"Integer"}, - "ModelLatencyThresholds":{"shape":"ModelLatencyThresholds"} + "ModelLatencyThresholds":{"shape":"ModelLatencyThresholds"}, + "FlatInvocations":{"shape":"FlatInvocations"} } }, "RecommendationJobSupportedContentTypes":{ @@ -18937,6 +18949,14 @@ "STOPPED" ] }, + "Stairs":{ + "type":"structure", + "members":{ + "DurationInSeconds":{"shape":"TrafficDurationInSeconds"}, + "NumberOfSteps":{"shape":"NumberOfSteps"}, + "UsersPerStep":{"shape":"UsersPerStep"} + } + }, "StartEdgeDeploymentStageRequest":{ "type":"structure", "required":[ @@ -19606,7 +19626,8 @@ "type":"structure", "members":{ "TrafficType":{"shape":"TrafficType"}, - "Phases":{"shape":"Phases"} + "Phases":{"shape":"Phases"}, + "Stairs":{"shape":"Stairs"} } }, "TrafficRoutingConfig":{ @@ -19632,7 +19653,10 @@ }, "TrafficType":{ "type":"string", - "enum":["PHASES"] + "enum":[ + "PHASES", + "STAIRS" + ] }, "TrainingContainerArgument":{ "type":"string", @@ -21073,6 +21097,11 @@ "CanvasAppSettings":{"shape":"CanvasAppSettings"} } }, + "UsersPerStep":{ + "type":"integer", + "max":3, + "min":1 + }, "UtilizationMetric":{ "type":"float", "min":0.0 diff --git a/models/apis/sagemaker/2017-07-24/docs-2.json b/models/apis/sagemaker/2017-07-24/docs-2.json index 6e696d856da..90ca213706c 100644 --- a/models/apis/sagemaker/2017-07-24/docs-2.json +++ b/models/apis/sagemaker/2017-07-24/docs-2.json @@ -4769,7 +4769,7 @@ "EndpointStatus": { "base": null, "refs": { - "DescribeEndpointOutput$EndpointStatus": "The status of the endpoint.
OutOfService: Endpoint is not available to take incoming requests.
Creating: CreateEndpoint is executing.
Updating: UpdateEndpoint or UpdateEndpointWeightsAndCapacities is executing.
SystemUpdating: Endpoint is undergoing maintenance and cannot be updated or deleted or re-scaled until it has completed. This maintenance operation does not change any customer-specified values such as VPC config, KMS encryption, model, instance type, or instance count.
RollingBack: Endpoint fails to scale up or down or change its variant weight and is in the process of rolling back to its previous configuration. Once the rollback completes, endpoint returns to an InService status. This transitional status only applies to an endpoint that has autoscaling enabled and is undergoing variant weight or capacity changes as part of an UpdateEndpointWeightsAndCapacities call or when the UpdateEndpointWeightsAndCapacities operation is called explicitly.
InService: Endpoint is available to process incoming requests.
Deleting: DeleteEndpoint is executing.
Failed: Endpoint could not be created, updated, or re-scaled. Use the FailureReason value returned by DescribeEndpoint for information about the failure. DeleteEndpoint is the only operation that can be performed on a failed endpoint.
The status of the endpoint.
OutOfService: Endpoint is not available to take incoming requests.
Creating: CreateEndpoint is executing.
Updating: UpdateEndpoint or UpdateEndpointWeightsAndCapacities is executing.
SystemUpdating: Endpoint is undergoing maintenance and cannot be updated or deleted or re-scaled until it has completed. This maintenance operation does not change any customer-specified values such as VPC config, KMS encryption, model, instance type, or instance count.
RollingBack: Endpoint fails to scale up or down or change its variant weight and is in the process of rolling back to its previous configuration. Once the rollback completes, endpoint returns to an InService status. This transitional status only applies to an endpoint that has autoscaling enabled and is undergoing variant weight or capacity changes as part of an UpdateEndpointWeightsAndCapacities call or when the UpdateEndpointWeightsAndCapacities operation is called explicitly.
InService: Endpoint is available to process incoming requests.
Deleting: DeleteEndpoint is executing.
Failed: Endpoint could not be created, updated, or re-scaled. Use the FailureReason value returned by DescribeEndpoint for information about the failure. DeleteEndpoint is the only operation that can be performed on a failed endpoint.
UpdateRollbackFailed: Both the rolling deployment and auto-rollback failed. Your endpoint is in service with a mix of the old and new endpoint configurations. For information about how to remedy this issue and restore the endpoint's status to InService, see Rolling Deployments.
The status of the endpoint.
", "EndpointMetadata$EndpointStatus": "The status of the endpoint. For possible values of the status of an endpoint, see EndpointSummary.
", "EndpointSummary$EndpointStatus": "The status of the endpoint.
OutOfService: Endpoint is not available to take incoming requests.
Creating: CreateEndpoint is executing.
Updating: UpdateEndpoint or UpdateEndpointWeightsAndCapacities is executing.
SystemUpdating: Endpoint is undergoing maintenance and cannot be updated or deleted or re-scaled until it has completed. This maintenance operation does not change any customer-specified values such as VPC config, KMS encryption, model, instance type, or instance count.
RollingBack: Endpoint fails to scale up or down or change its variant weight and is in the process of rolling back to its previous configuration. Once the rollback completes, endpoint returns to an InService status. This transitional status only applies to an endpoint that has autoscaling enabled and is undergoing variant weight or capacity changes as part of an UpdateEndpointWeightsAndCapacities call or when the UpdateEndpointWeightsAndCapacities operation is called explicitly.
InService: Endpoint is available to process incoming requests.
Deleting: DeleteEndpoint is executing.
Failed: Endpoint could not be created, updated, or re-scaled. Use DescribeEndpointOutput$FailureReason for information about the failure. DeleteEndpoint is the only operation that can be performed on a failed endpoint.
To get a list of endpoints with a specified status, use the StatusEquals filter with a call to ListEndpoints.
A list of final metric values that are set when the training job completes. Used only if the training job was configured to use metrics.
" } }, + "FlatInvocations": { + "base": null, + "refs": { + "RecommendationJobStoppingConditions$FlatInvocations": "Stops a load test when the number of invocations (TPS) peaks and flattens, which means that the instance has reached capacity. The default value is Stop. If you want the load test to continue after invocations have flattened, set the value to Continue.
Specifies how many concurrent users to start with.
" + "Phase$InitialNumberOfUsers": "Specifies how many concurrent users to start with. The value should be between 1 and 3.
" } }, "InitialTaskCount": { @@ -6944,7 +6950,7 @@ "JobDurationInSeconds": { "base": null, "refs": { - "RecommendationJobInputConfig$JobDurationInSeconds": "Specifies the maximum duration of the job, in seconds.>
" + "RecommendationJobInputConfig$JobDurationInSeconds": "Specifies the maximum duration of the job, in seconds. The maximum value is 7200.
" } }, "JobReferenceCode": { @@ -9695,7 +9701,7 @@ "base": null, "refs": { "BatchTransformInput$StartTimeOffset": "If specified, monitoring jobs substract this time from the start time. For information about using offsets for scheduling monitoring jobs, see Schedule Model Quality Monitoring Jobs.
", - "BatchTransformInput$EndTimeOffset": "If specified, monitoring jobs substract this time from the end time. For information about using offsets for scheduling monitoring jobs, see Schedule Model Quality Monitoring Jobs.
", + "BatchTransformInput$EndTimeOffset": "If specified, monitoring jobs subtract this time from the end time. For information about using offsets for scheduling monitoring jobs, see Schedule Model Quality Monitoring Jobs.
", "EndpointInput$StartTimeOffset": "If specified, monitoring jobs substract this time from the start time. For information about using offsets for scheduling monitoring jobs, see Schedule Model Quality Monitoring Jobs.
", "EndpointInput$EndTimeOffset": "If specified, monitoring jobs substract this time from the end time. For information about using offsets for scheduling monitoring jobs, see Schedule Model Quality Monitoring Jobs.
" } @@ -10155,6 +10161,12 @@ "LabelingJobForWorkteamSummary$NumberOfHumanWorkersPerDataObject": "The configured number of workers per data object.
" } }, + "NumberOfSteps": { + "base": null, + "refs": { + "Stairs$NumberOfSteps": "Specifies how many steps to perform during traffic.
" + } + }, "ObjectiveStatus": { "base": null, "refs": { @@ -12682,6 +12694,12 @@ "EdgeDeploymentStatus$StageStatus": "The general status of the current stage.
" } }, + "Stairs": { + "base": "Defines the stairs traffic pattern for an Inference Recommender load test. This pattern type consists of multiple steps where the number of users increases at each step.
Specify either the stairs or phases traffic pattern.
", + "refs": { + "TrafficPattern$Stairs": "Defines the stairs traffic pattern.
" + } + }, "StartEdgeDeploymentStageRequest": { "base": null, "refs": { @@ -13033,7 +13051,7 @@ "refs": { "ActionSummary$ActionType": "The type of the action.
", "CategoricalParameter$Name": "The Name of the environment variable.
", - "ModelLatencyThreshold$Percentile": "The model latency percentile threshold.
" + "ModelLatencyThreshold$Percentile": "The model latency percentile threshold. For custom load tests, specify the value as P95.
Specifies how long traffic phase should be.
" + "Phase$DurationInSeconds": "Specifies how long a traffic phase should be. For custom load tests, the value should be between 120 and 3600. This value should not exceed JobDurationInSeconds.
Defines how long each traffic step should be.
" } }, "TrafficPattern": { @@ -13891,7 +13910,7 @@ "TrafficType": { "base": null, "refs": { - "TrafficPattern$TrafficType": "Defines the traffic patterns.
" + "TrafficPattern$TrafficType": "Defines the traffic patterns. Choose either PHASES or STAIRS.
A collection of settings.
" } }, + "UsersPerStep": { + "base": null, + "refs": { + "Stairs$UsersPerStep": "Specifies how many new users to spawn in each step.
" + } + }, "UtilizationMetric": { "base": null, "refs": { diff --git a/models/apis/sagemaker/2017-07-24/endpoint-rule-set-1.json b/models/apis/sagemaker/2017-07-24/endpoint-rule-set-1.json index 9d96d35d2d6..c7c60ddc19f 100644 --- a/models/apis/sagemaker/2017-07-24/endpoint-rule-set-1.json +++ b/models/apis/sagemaker/2017-07-24/endpoint-rule-set-1.json @@ -58,52 +58,56 @@ "type": "error" }, { - "conditions": [], - "type": "tree", - "rules": [ + "conditions": [ { - "conditions": [ + "fn": "booleanEquals", + "argv": [ { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" - }, - true - ] - } - ], - "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", - "type": "error" - }, - { - "conditions": [], - "endpoint": { - "url": { - "ref": "Endpoint" + "ref": "UseDualStack" }, - "properties": {}, - "headers": {} - }, - "type": "endpoint" + true + ] } - ] + ], + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], + "endpoint": { + "url": { + "ref": "Endpoint" + }, + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, { - "conditions": [], + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Region" + } + ] + } + ], "type": "tree", "rules": [ { "conditions": [ { - "fn": "isSet", + "fn": "aws.partition", "argv": [ { "ref": "Region" } - ] + ], + "assign": "PartitionResult" } ], "type": "tree", @@ -111,13 +115,22 @@ { "conditions": [ { - "fn": "aws.partition", + "fn": "booleanEquals", "argv": [ { - "ref": "Region" - } - ], - "assign": "PartitionResult" + "ref": "UseFIPS" + }, + true + ] + }, + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] } ], "type": "tree", @@ -127,92 +140,83 @@ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } ] }, { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - }, - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://api.sagemaker-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, + } + ], + "type": "tree", + "rules": [ { "conditions": [], - "error": "FIPS and DualStack are enabled, but this partition does not support one or both", - "type": "error" + "endpoint": { + "url": "https://api.sagemaker-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, + { + "conditions": [], + "error": "FIPS and DualStack are enabled, but this partition does not support one or both", + "type": "error" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "type": "tree", + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } ] } ], @@ -221,180 +225,140 @@ { "conditions": [ { - "fn": "booleanEquals", + "fn": "stringEquals", "argv": [ - true, + "aws", { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, - "supportsFIPS" + "name" ] } ] } ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "stringEquals", - "argv": [ - "aws", - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "name" - ] - } - ] - } - ], - "endpoint": { - "url": "https://api-fips.sagemaker.{Region}.amazonaws.com", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - }, - { - "conditions": [ - { - "fn": "stringEquals", - "argv": [ - "aws-us-gov", - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "name" - ] - } - ] - } - ], - "endpoint": { - "url": "https://api-fips.sagemaker.{Region}.amazonaws.com", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - }, - { - "conditions": [], - "endpoint": { - "url": "https://api.sagemaker-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - } - ] + "endpoint": { + "url": "https://api-fips.sagemaker.{Region}.amazonaws.com", + "properties": {}, + "headers": {} + }, + "type": "endpoint" }, - { - "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" - } - ] - }, - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ { "conditions": [ { - "fn": "booleanEquals", + "fn": "stringEquals", "argv": [ - true, + "aws-us-gov", { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, - "supportsDualStack" + "name" ] } ] } ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://api.sagemaker.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - } - ] + "endpoint": { + "url": "https://api-fips.sagemaker.{Region}.amazonaws.com", + "properties": {}, + "headers": {} + }, + "type": "endpoint" }, { "conditions": [], - "error": "DualStack is enabled but this partition does not support DualStack", - "type": "error" + "endpoint": { + "url": "https://api.sagemaker-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, { "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsDualStack" + ] + } + ] + } + ], "type": "tree", "rules": [ { "conditions": [], "endpoint": { - "url": "https://api.sagemaker.{Region}.{PartitionResult#dnsSuffix}", + "url": "https://api.sagemaker.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ] + }, + { + "conditions": [], + "error": "DualStack is enabled but this partition does not support DualStack", + "type": "error" } ] + }, + { + "conditions": [], + "endpoint": { + "url": "https://api.sagemaker.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] - }, - { - "conditions": [], - "error": "Invalid Configuration: Missing Region", - "type": "error" } ] + }, + { + "conditions": [], + "error": "Invalid Configuration: Missing Region", + "type": "error" } ] } \ No newline at end of file diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index aa5b95cb3f9..77b5d0162f2 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -21,7 +21,7 @@ "dnsSuffix" : "amazonaws.com", "partition" : "aws", "partitionName" : "AWS Standard", - "regionRegex" : "^(us|eu|ap|sa|ca|me|af)\\-\\w+\\-\\d+$", + "regionRegex" : "^(us|eu|ap|sa|ca|me|af|il)\\-\\w+\\-\\d+$", "regions" : { "af-south-1" : { "description" : "Africa (Cape Town)" @@ -83,6 +83,9 @@ "eu-west-3" : { "description" : "Europe (Paris)" }, + "il-central-1" : { + "description" : "Israel (Tel Aviv)" + }, "me-central-1" : { "description" : "Middle East (UAE)" }, @@ -173,6 +176,7 @@ "deprecated" : true, "hostname" : "access-analyzer-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -248,6 +252,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -796,6 +801,12 @@ "deprecated" : true, "hostname" : "ecr-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { + "credentialScope" : { + "region" : "il-central-1" + }, + "hostname" : "api.ecr.il-central-1.amazonaws.com" + }, "me-central-1" : { "credentialScope" : { "region" : "me-central-1" @@ -1086,6 +1097,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -1294,6 +1306,7 @@ "deprecated" : true, "hostname" : "apigateway-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -1359,6 +1372,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -1390,6 +1404,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -1444,6 +1459,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -1859,6 +1875,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -1906,6 +1923,12 @@ "tags" : [ "dualstack" ] } ] }, + "ap-south-2" : { + "variants" : [ { + "hostname" : "athena.ap-south-2.api.aws", + "tags" : [ "dualstack" ] + } ] + }, "ap-southeast-1" : { "variants" : [ { "hostname" : "athena.ap-southeast-1.api.aws", @@ -1924,6 +1947,12 @@ "tags" : [ "dualstack" ] } ] }, + "ap-southeast-4" : { + "variants" : [ { + "hostname" : "athena.ap-southeast-4.api.aws", + "tags" : [ "dualstack" ] + } ] + }, "ca-central-1" : { "variants" : [ { "hostname" : "athena.ca-central-1.api.aws", @@ -1936,6 +1965,12 @@ "tags" : [ "dualstack" ] } ] }, + "eu-central-2" : { + "variants" : [ { + "hostname" : "athena.eu-central-2.api.aws", + "tags" : [ "dualstack" ] + } ] + }, "eu-north-1" : { "variants" : [ { "hostname" : "athena.eu-north-1.api.aws", @@ -1948,6 +1983,12 @@ "tags" : [ "dualstack" ] } ] }, + "eu-south-2" : { + "variants" : [ { + "hostname" : "athena.eu-south-2.api.aws", + "tags" : [ "dualstack" ] + } ] + }, "eu-west-1" : { "variants" : [ { "hostname" : "athena.eu-west-1.api.aws", @@ -2103,6 +2144,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -2551,6 +2593,7 @@ "deprecated" : true, "hostname" : "cloudcontrolapi-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -2615,6 +2658,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -2714,6 +2758,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -2787,6 +2832,7 @@ "deprecated" : true, "hostname" : "cloudtrail-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -2881,6 +2927,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -3064,6 +3111,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -3717,6 +3765,7 @@ "deprecated" : true, "hostname" : "config-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -3821,6 +3870,8 @@ "endpoints" : { "ap-northeast-1" : { }, "ap-northeast-2" : { }, + "ap-south-1" : { }, + "ap-southeast-1" : { }, "ap-southeast-2" : { }, "ca-central-1" : { }, "eu-central-1" : { }, @@ -4533,6 +4584,7 @@ "deprecated" : true, "hostname" : "directconnect-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -4581,6 +4633,7 @@ "ap-northeast-2" : { }, "ap-northeast-3" : { }, "ap-south-1" : { }, + "ap-south-2" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, "ap-southeast-3" : { }, @@ -4642,6 +4695,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -4880,6 +4934,7 @@ "deprecated" : true, "hostname" : "ds-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -4946,6 +5001,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "local" : { "credentialScope" : { "region" : "us-east-1" @@ -5072,6 +5128,7 @@ "deprecated" : true, "hostname" : "ebs-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -5176,6 +5233,7 @@ "deprecated" : true, "hostname" : "ec2-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { @@ -5269,6 +5327,7 @@ "deprecated" : true, "hostname" : "ecs-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -5365,6 +5424,7 @@ "deprecated" : true, "hostname" : "fips.eks.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -5423,6 +5483,7 @@ "deprecated" : true, "hostname" : "elasticache-fips.us-west-1.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -5526,6 +5587,7 @@ "deprecated" : true, "hostname" : "elasticbeanstalk-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, "us-east-1" : { @@ -5962,6 +6024,7 @@ "deprecated" : true, "hostname" : "elasticloadbalancing-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -6059,6 +6122,7 @@ "deprecated" : true, "hostname" : "elasticmapreduce-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -6167,6 +6231,7 @@ }, "eu-central-1" : { }, "eu-north-1" : { }, + "eu-south-1" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, @@ -6354,6 +6419,7 @@ "deprecated" : true, "hostname" : "es-fips.us-west-1.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -6461,6 +6527,7 @@ "deprecated" : true, "hostname" : "events-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -6589,6 +6656,7 @@ "deprecated" : true, "hostname" : "firehose-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -7353,6 +7421,7 @@ "deprecated" : true, "hostname" : "glue-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -8016,6 +8085,9 @@ "eu-west-3" : { "hostname" : "internetmonitor.eu-west-3.api.aws" }, + "il-central-1" : { + "hostname" : "internetmonitor.il-central-1.api.aws" + }, "me-central-1" : { "hostname" : "internetmonitor.me-central-1.api.aws" }, @@ -8923,6 +8995,9 @@ "eu-west-3" : { "hostname" : "kendra-ranking.eu-west-3.api.aws" }, + "il-central-1" : { + "hostname" : "kendra-ranking.il-central-1.api.aws" + }, "me-central-1" : { "hostname" : "kendra-ranking.me-central-1.api.aws" }, @@ -9008,6 +9083,7 @@ "deprecated" : true, "hostname" : "kinesis-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -9357,10 +9433,17 @@ "deprecated" : true, "hostname" : "kms-fips.eu-west-3.amazonaws.com" }, + "il-central-1" : { + "variants" : [ { + "hostname" : "kms-fips.il-central-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, "il-central-1-fips" : { "credentialScope" : { "region" : "il-central-1" }, + "deprecated" : true, "hostname" : "kms-fips.il-central-1.amazonaws.com" }, "me-central-1" : { @@ -9683,6 +9766,12 @@ "deprecated" : true, "hostname" : "lambda-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { + "variants" : [ { + "hostname" : "lambda.il-central-1.api.aws", + "tags" : [ "dualstack" ] + } ] + }, "me-central-1" : { "variants" : [ { "hostname" : "lambda.me-central-1.api.aws", @@ -10033,6 +10122,7 @@ "deprecated" : true, "hostname" : "logs-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -10639,6 +10729,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -10670,6 +10761,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -10909,6 +11001,7 @@ "deprecated" : true, "hostname" : "monitoring-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -11278,6 +11371,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -11715,6 +11809,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -12264,6 +12359,7 @@ "deprecated" : true, "hostname" : "ram-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -12355,6 +12451,7 @@ "deprecated" : true, "hostname" : "rbin-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -12418,6 +12515,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "rds-fips.ca-central-1" : { @@ -12689,6 +12787,7 @@ "deprecated" : true, "hostname" : "redshift-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -12978,6 +13077,9 @@ "eu-west-3" : { "hostname" : "resource-explorer-2.eu-west-3.api.aws" }, + "il-central-1" : { + "hostname" : "resource-explorer-2.il-central-1.api.aws" + }, "sa-east-1" : { "hostname" : "resource-explorer-2.sa-east-1.api.aws" }, @@ -13045,6 +13147,7 @@ "deprecated" : true, "hostname" : "resource-groups-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -13285,6 +13388,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -13533,6 +13637,12 @@ "deprecated" : true, "hostname" : "s3-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { + "variants" : [ { + "hostname" : "s3.dualstack.il-central-1.amazonaws.com", + "tags" : [ "dualstack" ] + } ] + }, "me-central-1" : { "variants" : [ { "hostname" : "s3.dualstack.me-central-1.amazonaws.com", @@ -14074,6 +14184,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -14589,6 +14700,12 @@ "tags" : [ "dualstack" ] } ] }, + "il-central-1" : { + "variants" : [ { + "hostname" : "servicediscovery.il-central-1.api.aws", + "tags" : [ "dualstack" ] + } ] + }, "me-central-1" : { "variants" : [ { "hostname" : "servicediscovery.me-central-1.api.aws", @@ -15219,6 +15336,7 @@ "deprecated" : true, "hostname" : "sns-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -15302,6 +15420,7 @@ "deprecated" : true, "hostname" : "sqs-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -15394,6 +15513,7 @@ "deprecated" : true, "hostname" : "ssm-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -15733,6 +15853,7 @@ "deprecated" : true, "hostname" : "states-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -15881,6 +16002,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "local" : { "credentialScope" : { "region" : "us-east-1" @@ -15925,6 +16047,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -16051,6 +16174,7 @@ "deprecated" : true, "hostname" : "swf-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -16130,6 +16254,7 @@ "deprecated" : true, "hostname" : "synthetics-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -16181,6 +16306,7 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, @@ -17118,6 +17244,7 @@ "credentialScope" : { "region" : "il-central-1" }, + "deprecated" : true, "hostname" : "waf-regional-fips.il-central-1.amazonaws.com" }, "fips-me-central-1" : { @@ -17169,6 +17296,16 @@ "deprecated" : true, "hostname" : "waf-regional-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { + "credentialScope" : { + "region" : "il-central-1" + }, + "hostname" : "waf-regional.il-central-1.amazonaws.com", + "variants" : [ { + "hostname" : "waf-regional-fips.il-central-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, "me-central-1" : { "credentialScope" : { "region" : "me-central-1" @@ -17587,6 +17724,7 @@ "credentialScope" : { "region" : "il-central-1" }, + "deprecated" : true, "hostname" : "wafv2-fips.il-central-1.amazonaws.com" }, "fips-me-central-1" : { @@ -17638,6 +17776,16 @@ "deprecated" : true, "hostname" : "wafv2-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { + "credentialScope" : { + "region" : "il-central-1" + }, + "hostname" : "wafv2.il-central-1.amazonaws.com", + "variants" : [ { + "hostname" : "wafv2-fips.il-central-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, "me-central-1" : { "credentialScope" : { "region" : "me-central-1" @@ -17911,6 +18059,7 @@ "deprecated" : true, "hostname" : "xray-fips.us-west-2.amazonaws.com" }, + "il-central-1" : { }, "me-central-1" : { }, "me-south-1" : { }, "sa-east-1" : { }, diff --git a/service/batch/api.go b/service/batch/api.go index fecbceef57d..7f442061172 100644 --- a/service/batch/api.go +++ b/service/batch/api.go @@ -210,8 +210,8 @@ func (c *Batch) CreateComputeEnvironmentRequest(input *CreateComputeEnvironmentI // - Either don't set the service role (serviceRole) parameter or set it // to the AWSBatchServiceRole service-linked role. // -// - Set the allocation strategy (allocationStrategy) parameter to BEST_FIT_PROGRESSIVE -// or SPOT_CAPACITY_OPTIMIZED. +// - Set the allocation strategy (allocationStrategy) parameter to BEST_FIT_PROGRESSIVE, +// SPOT_CAPACITY_OPTIMIZED, or SPOT_PRICE_CAPACITY_OPTIMIZED. // // - Set the update to latest image version (updateToLatestImageVersion) // parameter to true. The updateToLatestImageVersion parameter is used when @@ -3250,10 +3250,18 @@ type ComputeResource struct { // that are less likely to be interrupted. This allocation strategy is only // available for Spot Instance compute resources. // - // With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED strategies using - // On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, - // Batch might need to exceed maxvCpus to meet your capacity requirements. In - // this event, Batch never exceeds maxvCpus by more than a single instance. + // SPOT_PRICE_CAPACITY_OPTIMIZED + // + // The price and capacity optimized allocation strategy looks at both price + // and capacity to select the Spot Instance pools that are the least likely + // to be interrupted and have the lowest possible price. This allocation strategy + // is only available for Spot Instance compute resources. + // + // With BEST_FIT_PROGRESSIVE,SPOT_CAPACITY_OPTIMIZED and SPOT_PRICE_CAPACITY_OPTIMIZED + // strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using + // Spot Instances, Batch might need to exceed maxvCpus to meet your capacity + // requirements. In this event, Batch never exceeds maxvCpus by more than a + // single instance. AllocationStrategy *string `locationName:"allocationStrategy" type:"string" enum:"CRAllocationStrategy"` // The maximum percentage that a Spot Instance price can be when compared with @@ -3351,12 +3359,12 @@ type ComputeResource struct { // The maximum number of vCPUs that a compute environment can support. // - // With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED allocation strategies - // using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, - // Batch might need to exceed maxvCpus to meet your capacity requirements. In - // this event, Batch never exceeds maxvCpus by more than a single instance. - // For example, no more than a single instance from among those specified in - // your compute environment is allocated. + // With BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED and SPOT_PRICE_CAPACITY_OPTIMIZED + // allocation strategies using On-Demand or Spot Instances, and the BEST_FIT + // strategy using Spot Instances, Batch might need to exceed maxvCpus to meet + // your capacity requirements. In this event, Batch never exceeds maxvCpus by + // more than a single instance. For example, no more than a single instance + // from among those specified in your compute environment is allocated. // // MaxvCpus is a required field MaxvCpus *int64 `locationName:"maxvCpus" type:"integer" required:"true"` @@ -3636,10 +3644,18 @@ type ComputeResourceUpdate struct { // that are less likely to be interrupted. This allocation strategy is only // available for Spot Instance compute resources. // - // With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED strategies using - // On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, - // Batch might need to exceed maxvCpus to meet your capacity requirements. In - // this event, Batch never exceeds maxvCpus by more than a single instance. + // SPOT_PRICE_CAPACITY_OPTIMIZED + // + // The price and capacity optimized allocation strategy looks at both price + // and capacity to select the Spot Instance pools that are the least likely + // to be interrupted and have the lowest possible price. This allocation strategy + // is only available for Spot Instance compute resources. + // + // With both BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED, and SPOT_PRICE_CAPACITY_OPTIMIZED + // strategies using On-Demand or Spot Instances, and the BEST_FIT strategy using + // Spot Instances, Batch might need to exceed maxvCpus to meet your capacity + // requirements. In this event, Batch never exceeds maxvCpus by more than a + // single instance. AllocationStrategy *string `locationName:"allocationStrategy" type:"string" enum:"CRUpdateAllocationStrategy"` // The maximum percentage that a Spot Instance price can be when compared with @@ -3787,12 +3803,12 @@ type ComputeResourceUpdate struct { // The maximum number of Amazon EC2 vCPUs that an environment can reach. // - // With both BEST_FIT_PROGRESSIVE and SPOT_CAPACITY_OPTIMIZED allocation strategies - // using On-Demand or Spot Instances, and the BEST_FIT strategy using Spot Instances, - // Batch might need to exceed maxvCpus to meet your capacity requirements. In - // this event, Batch never exceeds maxvCpus by more than a single instance. - // That is, no more than a single instance from among those specified in your - // compute environment. + // With BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED, and SPOT_PRICE_CAPACITY_OPTIMIZED + // allocation strategies using On-Demand or Spot Instances, and the BEST_FIT + // strategy using Spot Instances, Batch might need to exceed maxvCpus to meet + // your capacity requirements. In this event, Batch never exceeds maxvCpus by + // more than a single instance. That is, no more than a single instance from + // among those specified in your compute environment. MaxvCpus *int64 `locationName:"maxvCpus" type:"integer"` // The minimum number of vCPUs that an environment should maintain (even if @@ -13268,6 +13284,9 @@ const ( // CRAllocationStrategySpotCapacityOptimized is a CRAllocationStrategy enum value CRAllocationStrategySpotCapacityOptimized = "SPOT_CAPACITY_OPTIMIZED" + + // CRAllocationStrategySpotPriceCapacityOptimized is a CRAllocationStrategy enum value + CRAllocationStrategySpotPriceCapacityOptimized = "SPOT_PRICE_CAPACITY_OPTIMIZED" ) // CRAllocationStrategy_Values returns all elements of the CRAllocationStrategy enum @@ -13276,6 +13295,7 @@ func CRAllocationStrategy_Values() []string { CRAllocationStrategyBestFit, CRAllocationStrategyBestFitProgressive, CRAllocationStrategySpotCapacityOptimized, + CRAllocationStrategySpotPriceCapacityOptimized, } } @@ -13309,6 +13329,9 @@ const ( // CRUpdateAllocationStrategySpotCapacityOptimized is a CRUpdateAllocationStrategy enum value CRUpdateAllocationStrategySpotCapacityOptimized = "SPOT_CAPACITY_OPTIMIZED" + + // CRUpdateAllocationStrategySpotPriceCapacityOptimized is a CRUpdateAllocationStrategy enum value + CRUpdateAllocationStrategySpotPriceCapacityOptimized = "SPOT_PRICE_CAPACITY_OPTIMIZED" ) // CRUpdateAllocationStrategy_Values returns all elements of the CRUpdateAllocationStrategy enum @@ -13316,6 +13339,7 @@ func CRUpdateAllocationStrategy_Values() []string { return []string{ CRUpdateAllocationStrategyBestFitProgressive, CRUpdateAllocationStrategySpotCapacityOptimized, + CRUpdateAllocationStrategySpotPriceCapacityOptimized, } } diff --git a/service/databasemigrationservice/api.go b/service/databasemigrationservice/api.go index 072f4a36d99..a43d4976b31 100644 --- a/service/databasemigrationservice/api.go +++ b/service/databasemigrationservice/api.go @@ -2946,6 +2946,136 @@ func (c *DatabaseMigrationService) DescribeEndpointsPagesWithContext(ctx aws.Con return p.Err() } +const opDescribeEngineVersions = "DescribeEngineVersions" + +// DescribeEngineVersionsRequest generates a "aws/request.Request" representing the +// client's request for the DescribeEngineVersions operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DescribeEngineVersions for more information on using the DescribeEngineVersions +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the DescribeEngineVersionsRequest method. +// req, resp := client.DescribeEngineVersionsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeEngineVersions +func (c *DatabaseMigrationService) DescribeEngineVersionsRequest(input *DescribeEngineVersionsInput) (req *request.Request, output *DescribeEngineVersionsOutput) { + op := &request.Operation{ + Name: opDescribeEngineVersions, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"Marker"}, + OutputTokens: []string{"Marker"}, + LimitToken: "MaxRecords", + TruncationToken: "", + }, + } + + if input == nil { + input = &DescribeEngineVersionsInput{} + } + + output = &DescribeEngineVersionsOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeEngineVersions API operation for AWS Database Migration Service. +// +// Returns information about the replication instance versions used in the project. +// +// 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. +// +// See the AWS API reference guide for AWS Database Migration Service's +// API operation DescribeEngineVersions for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeEngineVersions +func (c *DatabaseMigrationService) DescribeEngineVersions(input *DescribeEngineVersionsInput) (*DescribeEngineVersionsOutput, error) { + req, out := c.DescribeEngineVersionsRequest(input) + return out, req.Send() +} + +// DescribeEngineVersionsWithContext is the same as DescribeEngineVersions with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeEngineVersions for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *DatabaseMigrationService) DescribeEngineVersionsWithContext(ctx aws.Context, input *DescribeEngineVersionsInput, opts ...request.Option) (*DescribeEngineVersionsOutput, error) { + req, out := c.DescribeEngineVersionsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// DescribeEngineVersionsPages iterates over the pages of a DescribeEngineVersions operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See DescribeEngineVersions method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a DescribeEngineVersions operation. +// pageNum := 0 +// err := client.DescribeEngineVersionsPages(params, +// func(page *databasemigrationservice.DescribeEngineVersionsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +func (c *DatabaseMigrationService) DescribeEngineVersionsPages(input *DescribeEngineVersionsInput, fn func(*DescribeEngineVersionsOutput, bool) bool) error { + return c.DescribeEngineVersionsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// DescribeEngineVersionsPagesWithContext same as DescribeEngineVersionsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *DatabaseMigrationService) DescribeEngineVersionsPagesWithContext(ctx aws.Context, input *DescribeEngineVersionsInput, fn func(*DescribeEngineVersionsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *DescribeEngineVersionsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.DescribeEngineVersionsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*DescribeEngineVersionsOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + const opDescribeEventCategories = "DescribeEventCategories" // DescribeEventCategoriesRequest generates a "aws/request.Request" representing the @@ -13306,6 +13436,93 @@ func (s *DescribeEndpointsOutput) SetMarker(v string) *DescribeEndpointsOutput { return s } +type DescribeEngineVersionsInput struct { + _ struct{} `type:"structure"` + + // An optional pagination token provided by a previous request. If this parameter + // is specified, the response includes only records beyond the marker, up to + // the value specified by MaxRecords. + Marker *string `type:"string"` + + // The maximum number of records to include in the response. If more records + // exist than the specified MaxRecords value, a pagination token called a marker + // is included in the response so that the remaining results can be retrieved. + MaxRecords *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 DescribeEngineVersionsInput) 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 DescribeEngineVersionsInput) GoString() string { + return s.String() +} + +// SetMarker sets the Marker field's value. +func (s *DescribeEngineVersionsInput) SetMarker(v string) *DescribeEngineVersionsInput { + s.Marker = &v + return s +} + +// SetMaxRecords sets the MaxRecords field's value. +func (s *DescribeEngineVersionsInput) SetMaxRecords(v int64) *DescribeEngineVersionsInput { + s.MaxRecords = &v + return s +} + +type DescribeEngineVersionsOutput struct { + _ struct{} `type:"structure"` + + // Returned EngineVersion objects that describe the replication instance engine + // versions used in the project. + EngineVersions []*EngineVersion `type:"list"` + + // An optional pagination token provided by a previous request. If this parameter + // is specified, the response includes only records beyond the marker, up to + // the value specified by MaxRecords. + Marker *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 DescribeEngineVersionsOutput) 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 DescribeEngineVersionsOutput) GoString() string { + return s.String() +} + +// SetEngineVersions sets the EngineVersions field's value. +func (s *DescribeEngineVersionsOutput) SetEngineVersions(v []*EngineVersion) *DescribeEngineVersionsOutput { + s.EngineVersions = v + return s +} + +// SetMarker sets the Marker field's value. +func (s *DescribeEngineVersionsOutput) SetMarker(v string) *DescribeEngineVersionsOutput { + s.Marker = &v + return s +} + type DescribeEventCategoriesInput struct { _ struct{} `type:"structure"` @@ -17186,6 +17403,104 @@ func (s *EndpointSetting) SetUnits(v string) *EndpointSetting { return s } +// Provides information about a replication instance version. +type EngineVersion struct { + _ struct{} `type:"structure"` + + // The date when the replication instance will be automatically upgraded. This + // setting only applies if the auto-minor-version setting is enabled. + AutoUpgradeDate *time.Time `type:"timestamp"` + + // The list of valid replication instance versions that you can upgrade to. + AvailableUpgrades []*string `type:"list"` + + // The date when the replication instance version will be deprecated and can + // no longer be requested. + DeprecationDate *time.Time `type:"timestamp"` + + // The date when the replication instance will have a version upgrade forced. + ForceUpgradeDate *time.Time `type:"timestamp"` + + // The date when the replication instance version became publicly available. + LaunchDate *time.Time `type:"timestamp"` + + // The lifecycle status of the replication instance version. Valid values are + // DEPRECATED, DEFAULT_VERSION, and ACTIVE. + Lifecycle *string `type:"string"` + + // The release status of the replication instance version. + ReleaseStatus *string `type:"string" enum:"ReleaseStatusValues"` + + // The version number of the replication instance. + Version *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 EngineVersion) 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 EngineVersion) GoString() string { + return s.String() +} + +// SetAutoUpgradeDate sets the AutoUpgradeDate field's value. +func (s *EngineVersion) SetAutoUpgradeDate(v time.Time) *EngineVersion { + s.AutoUpgradeDate = &v + return s +} + +// SetAvailableUpgrades sets the AvailableUpgrades field's value. +func (s *EngineVersion) SetAvailableUpgrades(v []*string) *EngineVersion { + s.AvailableUpgrades = v + return s +} + +// SetDeprecationDate sets the DeprecationDate field's value. +func (s *EngineVersion) SetDeprecationDate(v time.Time) *EngineVersion { + s.DeprecationDate = &v + return s +} + +// SetForceUpgradeDate sets the ForceUpgradeDate field's value. +func (s *EngineVersion) SetForceUpgradeDate(v time.Time) *EngineVersion { + s.ForceUpgradeDate = &v + return s +} + +// SetLaunchDate sets the LaunchDate field's value. +func (s *EngineVersion) SetLaunchDate(v time.Time) *EngineVersion { + s.LaunchDate = &v + return s +} + +// SetLifecycle sets the Lifecycle field's value. +func (s *EngineVersion) SetLifecycle(v string) *EngineVersion { + s.Lifecycle = &v + return s +} + +// SetReleaseStatus sets the ReleaseStatus field's value. +func (s *EngineVersion) SetReleaseStatus(v string) *EngineVersion { + s.ReleaseStatus = &v + return s +} + +// SetVersion sets the Version field's value. +func (s *EngineVersion) SetVersion(v string) *EngineVersion { + s.Version = &v + return s +} + // Describes an identifiable significant activity that affects a replication // instance or task. This object can provide the message, the available event // categories, the date and source of the event, and the DMS resource type. @@ -22392,9 +22707,9 @@ type PostgreSQLSettings struct { // the source database. CaptureDdls *bool `type:"boolean"` - // Specifies whether to use default or custom replication behavior for PostgreSQL-compatible - // endpoints. You can use this setting to specify replication behavior for endpoints - // that require additional configuration, such as Babelfish endpoints. + // Specifies the default behavior of the replication's handling of PostgreSQL- + // compatible endpoints that require some additional configuration, such as + // Babelfish endpoints. DatabaseMode *string `type:"string" enum:"DatabaseMode"` // Database name for the endpoint. diff --git a/service/databasemigrationservice/databasemigrationserviceiface/interface.go b/service/databasemigrationservice/databasemigrationserviceiface/interface.go index dff5adbee60..969d047d308 100644 --- a/service/databasemigrationservice/databasemigrationserviceiface/interface.go +++ b/service/databasemigrationservice/databasemigrationserviceiface/interface.go @@ -194,6 +194,13 @@ type DatabaseMigrationServiceAPI interface { DescribeEndpointsPages(*databasemigrationservice.DescribeEndpointsInput, func(*databasemigrationservice.DescribeEndpointsOutput, bool) bool) error DescribeEndpointsPagesWithContext(aws.Context, *databasemigrationservice.DescribeEndpointsInput, func(*databasemigrationservice.DescribeEndpointsOutput, bool) bool, ...request.Option) error + DescribeEngineVersions(*databasemigrationservice.DescribeEngineVersionsInput) (*databasemigrationservice.DescribeEngineVersionsOutput, error) + DescribeEngineVersionsWithContext(aws.Context, *databasemigrationservice.DescribeEngineVersionsInput, ...request.Option) (*databasemigrationservice.DescribeEngineVersionsOutput, error) + DescribeEngineVersionsRequest(*databasemigrationservice.DescribeEngineVersionsInput) (*request.Request, *databasemigrationservice.DescribeEngineVersionsOutput) + + DescribeEngineVersionsPages(*databasemigrationservice.DescribeEngineVersionsInput, func(*databasemigrationservice.DescribeEngineVersionsOutput, bool) bool) error + DescribeEngineVersionsPagesWithContext(aws.Context, *databasemigrationservice.DescribeEngineVersionsInput, func(*databasemigrationservice.DescribeEngineVersionsOutput, bool) bool, ...request.Option) error + DescribeEventCategories(*databasemigrationservice.DescribeEventCategoriesInput) (*databasemigrationservice.DescribeEventCategoriesOutput, error) DescribeEventCategoriesWithContext(aws.Context, *databasemigrationservice.DescribeEventCategoriesInput, ...request.Option) (*databasemigrationservice.DescribeEventCategoriesOutput, error) DescribeEventCategoriesRequest(*databasemigrationservice.DescribeEventCategoriesInput) (*request.Request, *databasemigrationservice.DescribeEventCategoriesOutput) diff --git a/service/internetmonitor/api.go b/service/internetmonitor/api.go index 8a97ff46710..815f50c78ef 100644 --- a/service/internetmonitor/api.go +++ b/service/internetmonitor/api.go @@ -57,20 +57,23 @@ func (c *InternetMonitor) CreateMonitorRequest(input *CreateMonitorInput) (req * // CreateMonitor API operation for Amazon CloudWatch Internet Monitor. // // Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built -// based on information from the application resources that you add: Amazon -// Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces +// based on information from the application resources that you add: VPCs, Network +// Load Balancers (NLBs), Amazon CloudFront distributions, and Amazon WorkSpaces // directories. Internet Monitor then publishes internet measurements from Amazon -// Web Services that are specific to the city-networks, that is, the locations +// Web Services that are specific to the city-networks. That is, the locations // and ASNs (typically internet service providers or ISPs), where clients access // your application. For more information, see Using Amazon CloudWatch Internet // Monitor (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html) // in the Amazon CloudWatch User Guide. // -// When you create a monitor, you set a maximum limit for the number of city-networks -// where client traffic is monitored. The city-network maximum that you choose -// is the limit, but you only pay for the number of city-networks that are actually -// monitored. You can change the maximum at any time by updating your monitor. -// For more information, see Choosing a city-network maximum value (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) +// When you create a monitor, you choose the percentage of traffic that you +// want to monitor. You can also set a maximum limit for the number of city-networks +// where client traffic is monitored, that caps the total traffic that Internet +// Monitor monitors. A city-network maximum is the limit of city-networks, but +// you only pay for the number of city-networks that are actually monitored. +// You can update your monitor at any time to change the percentage of traffic +// to monitor or the city-networks maximum. For more information, see Choosing +// a city-network maximum value (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) // in the Amazon CloudWatch User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -256,11 +259,11 @@ func (c *InternetMonitor) GetHealthEventRequest(input *GetHealthEventInput) (req // // Gets information the Amazon CloudWatch Internet Monitor has created and stored // about a health event for a specified monitor. This information includes the -// impacted locations, and all of the information related to the event by location. +// impacted locations, and all the information related to the event, by location. // -// The information returned includes the performance, availability, and round-trip -// time impact, information about the network providers, the event type, and -// so on. +// The information returned includes the impact on performance, availability, +// and round-trip time, information about the network providers (ASNs), the +// event type, and so on. // // Information rolled up at the global traffic level is also returned, including // the impact type and total traffic impact. @@ -449,9 +452,8 @@ func (c *InternetMonitor) ListHealthEventsRequest(input *ListHealthEventsInput) // ListHealthEvents API operation for Amazon CloudWatch Internet Monitor. // // Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. -// Returns all information for health events including the client location information -// the network cause and status, event start and end time, percentage of total -// traffic impacted, and status. +// Returns information for health events including the event start and end time +// and the status. // // Health events that have start times during the time frame that is requested // are not included in the list of health events. @@ -1020,10 +1022,10 @@ func (c *InternetMonitor) UpdateMonitorRequest(input *UpdateMonitorInput) (req * // UpdateMonitor API operation for Amazon CloudWatch Internet Monitor. // -// Updates a monitor. You can update a monitor to change the maximum number -// of city-networks (locations and ASNs or internet service providers), to add -// or remove resources, or to change the status of the monitor. Note that you -// can't change the name of a monitor. +// Updates a monitor. You can update a monitor to change the percentage of traffic +// to monitor or the maximum number of city-networks (locations and ASNs), to +// add or remove resources, or to change the status of the monitor. Note that +// you can't change the name of a monitor. // // The city-network maximum that you choose is the limit, but you only pay for // the number of city-networks that are actually monitored. For more information, @@ -1143,15 +1145,16 @@ func (s *AccessDeniedException) RequestID() string { return s.RespMetadata.RequestID } -// Measurements about the availability for your application on the internet, -// calculated by Amazon CloudWatch Internet Monitor. Amazon Web Services has -// substantial historical data about internet performance and availability between -// Amazon Web Services services and different network providers and geographies. -// By applying statistical analysis to the data, Internet Monitor can detect -// when the performance and availability for your application has dropped, compared -// to an estimated baseline that's already calculated. To make it easier to -// see those drops, we report that information to you in the form of health -// scores: a performance score and an availability score. +// Amazon CloudWatch Internet Monitor calculates measurements about the availability +// for your application's internet traffic between client locations and Amazon +// Web Services. Amazon Web Services has substantial historical data about internet +// performance and availability between Amazon Web Services services and different +// network providers and geographies. By applying statistical analysis to the +// data, Internet Monitor can detect when the performance and availability for +// your application has dropped, compared to an estimated baseline that's already +// calculated. To make it easier to see those drops, we report that information +// to you in the form of health scores: a performance score and an availability +// score. // // Availability in Internet Monitor represents the estimated percentage of traffic // that is not seeing an availability drop. For example, an availability score @@ -1189,10 +1192,14 @@ type AvailabilityMeasurement struct { // User Guide. PercentOfClientLocationImpacted *float64 `type:"double"` - // The percentage of impact caused by a health event for total traffic globally. + // The impact on total traffic that a health event has, in increased latency + // or reduced availability. This is the percentage of how much latency has increased + // or availability has decreased during the event, compared to what is typical + // for traffic from this client location to the Amazon Web Services location + // using this client network. // - // For information about how Internet Monitor calculates impact, see Inside - // Internet Monitor (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html) + // For information about how Internet Monitor calculates impact, see How Internet + // Monitor works (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html) // in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch // User Guide. PercentOfTotalTrafficImpacted *float64 `type:"double"` @@ -1370,11 +1377,16 @@ type CreateMonitorInput struct { // other API requests. ClientToken *string `type:"string" idempotencyToken:"true"` - // Defines the health event threshold percentages, for performance score and - // availability score. Internet Monitor creates a health event when there's - // an internet issue that affects your application end users where a health - // score percentage is at or below a set threshold. If you don't set a health - // event threshold, the default calue is 95%. + // Defines the threshold percentages and other configuration information for + // when Amazon CloudWatch Internet Monitor creates a health event. Internet + // Monitor creates a health event when an internet issue that affects your application + // end users has a health score percentage that is at or below a specific threshold, + // and, sometimes, when other criteria are met. + // + // If you don't set a health event threshold, the default value is 95%. + // + // For more information, see Change health event thresholds (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview) + // in the Internet Monitor section of the CloudWatch User Guide. HealthEventsConfig *HealthEventsConfig `type:"structure"` // Publish internet measurements for Internet Monitor to an Amazon S3 bucket @@ -1383,8 +1395,9 @@ type CreateMonitorInput struct { // The maximum number of city-networks to monitor for your resources. A city-network // is the location (city) where clients access your application resources from - // and the network or ASN, such as an internet service provider (ISP), that - // clients access the resources through. This limit helps control billing costs. + // and the ASN or network provider, such as an internet service provider (ISP), + // that clients access the resources through. Setting this limit can help control + // billing costs. // // To learn more, see Choosing a city-network maximum value (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User @@ -1397,21 +1410,28 @@ type CreateMonitorInput struct { MonitorName *string `min:"1" type:"string" required:"true"` // The resources to include in a monitor, which you provide as a set of Amazon - // Resource Names (ARNs). + // Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon CloudFront distributions, + // or Amazon WorkSpaces directories. // - // You can add a combination of Amazon Virtual Private Clouds (VPCs) and Amazon - // CloudFront distributions, or you can add Amazon WorkSpaces directories. You - // can't add all three types of resources. + // You can add a combination of VPCs and CloudFront distributions, or you can + // add WorkSpaces directories, or you can add NLBs. You can't add NLBs or WorkSpaces + // directories together with any other resources. // - // If you add only VPC resources, at least one VPC must have an Internet Gateway - // attached to it, to make sure that it has internet connectivity. + // If you add only Amazon VPC resources, at least one VPC must have an Internet + // Gateway attached to it, to make sure that it has internet connectivity. Resources []*string `type:"list"` // The tags for a monitor. You can add a maximum of 50 tags in Internet Monitor. Tags map[string]*string `type:"map"` // The percentage of the internet-facing traffic for your application that you - // want to monitor with this monitor. + // want to monitor with this monitor. If you set a city-networks maximum, that + // limit overrides the traffic percentage that you set. + // + // To learn more, see Choosing an application traffic percentage to monitor + // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html) + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User + // Guide. TrafficPercentageToMonitor *int64 `min:"1" type:"integer"` } @@ -1711,8 +1731,9 @@ type GetHealthEventOutput struct { // EventId is a required field EventId *string `min:"1" type:"string" required:"true"` - // The threshold percentage for health events when Amazon CloudWatch Internet - // Monitor creates a health event. + // The threshold percentage for a health score that determines, along with other + // configuration information, when Internet Monitor creates a health event when + // there's an internet issue that affects your application end users. HealthScoreThreshold *float64 `type:"double"` // The type of impairment of a specific health event. @@ -1730,7 +1751,11 @@ type GetHealthEventOutput struct { // LastUpdatedAt is a required field LastUpdatedAt *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` - // The impact on total traffic that a health event has. + // The impact on total traffic that a health event has, in increased latency + // or reduced availability. This is the percentage of how much latency has increased + // or availability has decreased during the event, compared to what is typical + // for traffic from this client location to the Amazon Web Services location + // using this client network. PercentOfTotalTrafficImpacted *float64 `type:"double"` // The time when a health event started. @@ -1885,10 +1910,13 @@ type GetMonitorOutput struct { // CreatedAt is a required field CreatedAt *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` - // The list of health event thresholds. A health event threshold percentage, - // for performance and availability, determines the level of impact at which - // Amazon CloudWatch Internet Monitor creates a health event when there's an - // internet issue that affects your application end users. + // The list of health event threshold configurations. The threshold percentage + // for a health score determines, along with other configuration information, + // when Internet Monitor creates a health event when there's an internet issue + // that affects your application end users. + // + // For more information, see Change health event thresholds (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview) + // in the Internet Monitor section of the CloudWatch User Guide. HealthEventsConfig *HealthEventsConfig `type:"structure"` // Publish internet measurements for Internet Monitor to another location, such @@ -1898,8 +1926,9 @@ type GetMonitorOutput struct { // The maximum number of city-networks to monitor for your resources. A city-network // is the location (city) where clients access your application resources from - // and the network or ASN, such as an internet service provider (ISP), that - // clients access the resources through. This limit helps control billing costs. + // and the ASN or network provider, such as an internet service provider (ISP), + // that clients access the resources through. This limit can help control billing + // costs. // // To learn more, see Choosing a city-network maximum value (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User @@ -1927,8 +1956,8 @@ type GetMonitorOutput struct { // Additional information about the health of the data processing for the monitor. ProcessingStatusInfo *string `type:"string"` - // The resources that have been added for the monitor. Resources are listed - // by their Amazon Resource Names (ARNs). + // The resources monitored by the monitor. Resources are listed by their Amazon + // Resource Names (ARNs). // // Resources is a required field Resources []*string `type:"list" required:"true"` @@ -1941,8 +1970,14 @@ type GetMonitorOutput struct { // The tags that have been added to monitor. Tags map[string]*string `type:"map"` - // The percentage of the internet-facing traffic for your application that you - // want to monitor with this monitor. + // The percentage of the internet-facing traffic for your application to monitor + // with this monitor. If you set a city-networks maximum, that limit overrides + // the traffic percentage that you set. + // + // To learn more, see Choosing an application traffic percentage to monitor + // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html) + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User + // Guide. TrafficPercentageToMonitor *int64 `min:"1" type:"integer"` } @@ -2085,7 +2120,11 @@ type HealthEvent struct { // LastUpdatedAt is a required field LastUpdatedAt *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` - // The impact on global traffic monitored by this monitor for this health event. + // The impact on total traffic that a health event has, in increased latency + // or reduced availability. This is the percentage of how much latency has increased + // or availability has decreased during the event, compared to what is typical + // for traffic from this client location to the Amazon Web Services location + // using this client network. PercentOfTotalTrafficImpacted *float64 `type:"double"` // When a health event started. @@ -2183,18 +2222,43 @@ func (s *HealthEvent) SetStatus(v string) *HealthEvent { return s } -// A complex type for the configuration. Defines the health event threshold -// percentages, for performance score and availability score. Amazon CloudWatch -// Internet Monitor creates a health event when there's an internet issue that -// affects your application end users where a health score percentage is at -// or below a set threshold. If you don't set a health event threshold, the -// default value is 95%. +// A complex type with the configuration information that determines the threshold +// and other conditions for when Internet Monitor creates a health event for +// an overall performance or availability issue, across an application's geographies. +// +// Defines the percentages, for overall performance scores and availability +// scores for an application, that are the thresholds for when Amazon CloudWatch +// Internet Monitor creates a health event. You can override the defaults to +// set a custom threshold for overall performance or availability scores, or +// both. +// +// You can also set thresholds for local health scores,, where Internet Monitor +// creates a health event when scores cross a threshold for one or more city-networks, +// in addition to creating an event when an overall score crosses a threshold. +// +// If you don't set a health event threshold, the default value is 95%. +// +// For local thresholds, you also set a minimum percentage of overall traffic +// that is impacted by an issue before Internet Monitor creates an event. In +// addition, you can disable local thresholds, for performance scores, availability +// scores, or both. +// +// For more information, see Change health event thresholds (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview) +// in the Internet Monitor section of the CloudWatch User Guide. type HealthEventsConfig struct { _ struct{} `type:"structure"` + // The configuration that determines the threshold and other conditions for + // when Internet Monitor creates a health event for a local availability issue. + AvailabilityLocalHealthEventsConfig *LocalHealthEventsConfig `type:"structure"` + // The health event threshold percentage set for availability scores. AvailabilityScoreThreshold *float64 `type:"double"` + // The configuration that determines the threshold and other conditions for + // when Internet Monitor creates a health event for a local performance issue. + PerformanceLocalHealthEventsConfig *LocalHealthEventsConfig `type:"structure"` + // The health event threshold percentage set for performance scores. PerformanceScoreThreshold *float64 `type:"double"` } @@ -2217,12 +2281,24 @@ func (s HealthEventsConfig) GoString() string { return s.String() } +// SetAvailabilityLocalHealthEventsConfig sets the AvailabilityLocalHealthEventsConfig field's value. +func (s *HealthEventsConfig) SetAvailabilityLocalHealthEventsConfig(v *LocalHealthEventsConfig) *HealthEventsConfig { + s.AvailabilityLocalHealthEventsConfig = v + return s +} + // SetAvailabilityScoreThreshold sets the AvailabilityScoreThreshold field's value. func (s *HealthEventsConfig) SetAvailabilityScoreThreshold(v float64) *HealthEventsConfig { s.AvailabilityScoreThreshold = &v return s } +// SetPerformanceLocalHealthEventsConfig sets the PerformanceLocalHealthEventsConfig field's value. +func (s *HealthEventsConfig) SetPerformanceLocalHealthEventsConfig(v *LocalHealthEventsConfig) *HealthEventsConfig { + s.PerformanceLocalHealthEventsConfig = v + return s +} + // SetPerformanceScoreThreshold sets the PerformanceScoreThreshold field's value. func (s *HealthEventsConfig) SetPerformanceScoreThreshold(v float64) *HealthEventsConfig { s.PerformanceScoreThreshold = &v @@ -2539,9 +2615,9 @@ func (s *InternalServerException) RequestID() string { // network providers and geographies. By applying statistical analysis to the // data, Internet Monitor can detect when the performance and availability for // your application has dropped, compared to an estimated baseline that's already -// calculated. To make it easier to see those drops, we report that information -// to you in the form of health scores: a performance score and an availability -// score. +// calculated. To make it easier to see those drops, Internet Monitor reports +// the information to you in the form of health scores: a performance score +// and an availability score. type InternetHealth struct { _ struct{} `type:"structure"` @@ -3045,6 +3121,73 @@ func (s *ListTagsForResourceOutput) SetTags(v map[string]*string) *ListTagsForRe return s } +// A complex type with the configuration information that determines the threshold +// and other conditions for when Internet Monitor creates a health event for +// a local performance or availability issue, when scores cross a threshold +// for one or more city-networks. +// +// Defines the percentages, for performance scores or availability scores, that +// are the local thresholds for when Amazon CloudWatch Internet Monitor creates +// a health event. Also defines whether a local threshold is enabled or disabled, +// and the minimum percentage of overall traffic that must be impacted by an +// issue before Internet Monitor creates an event when a threshold is crossed +// for a local health score. +// +// For more information, see Change health event thresholds (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview) +// in the Internet Monitor section of the CloudWatch User Guide. +type LocalHealthEventsConfig struct { + _ struct{} `type:"structure"` + + // The health event threshold percentage set for a local health score. + HealthScoreThreshold *float64 `type:"double"` + + // The minimum percentage of overall traffic for an application that must be + // impacted by an issue before Internet Monitor creates an event when a threshold + // is crossed for a local health score. + MinTrafficImpact *float64 `type:"double"` + + // The status of whether Internet Monitor creates a health event based on a + // threshold percentage set for a local health score. The status can be ENABLED + // or DISABLED. + Status *string `type:"string" enum:"LocalHealthEventsConfigStatus"` +} + +// 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 LocalHealthEventsConfig) 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 LocalHealthEventsConfig) GoString() string { + return s.String() +} + +// SetHealthScoreThreshold sets the HealthScoreThreshold field's value. +func (s *LocalHealthEventsConfig) SetHealthScoreThreshold(v float64) *LocalHealthEventsConfig { + s.HealthScoreThreshold = &v + return s +} + +// SetMinTrafficImpact sets the MinTrafficImpact field's value. +func (s *LocalHealthEventsConfig) SetMinTrafficImpact(v float64) *LocalHealthEventsConfig { + s.MinTrafficImpact = &v + return s +} + +// SetStatus sets the Status field's value. +func (s *LocalHealthEventsConfig) SetStatus(v string) *LocalHealthEventsConfig { + s.Status = &v + return s +} + // The description of and information about a monitor in Amazon CloudWatch Internet // Monitor. type Monitor struct { @@ -3279,15 +3422,16 @@ func (s *NotFoundException) RequestID() string { return s.RespMetadata.RequestID } -// Measurements about the performance for your application on the internet calculated -// by Amazon CloudWatch Internet Monitor. Amazon Web Services has substantial -// historical data about internet performance and availability between Amazon -// Web Services services and different network providers and geographies. By -// applying statistical analysis to the data, Internet Monitor can detect when -// the performance and availability for your application has dropped, compared -// to an estimated baseline that's already calculated. To make it easier to -// see those drops, we report that information to you in the form of health -// scores: a performance score and an availability score. +// Amazon CloudWatch Internet Monitor calculates measurements about the performance +// for your application's internet traffic between client locations and Amazon +// Web Services. Amazon Web Services has substantial historical data about internet +// performance and availability between Amazon Web Services services and different +// network providers and geographies. By applying statistical analysis to the +// data, Internet Monitor can detect when the performance and availability for +// your application has dropped, compared to an estimated baseline that's already +// calculated. To make it easier to see those drops, we report that information +// to you in the form of health scores: a performance score and an availability +// score. // // Performance in Internet Monitor represents the estimated percentage of traffic // that is not seeing a performance drop. For example, a performance score of @@ -3327,10 +3471,11 @@ type PerformanceMeasurement struct { // Guide. PercentOfClientLocationImpacted *float64 `type:"double"` - // How much performance impact was caused by a health event for total traffic - // globally. For performance, this is the percentage of how much latency increased - // during the event compared to typical performance for your application traffic - // globally. + // The impact on total traffic that a health event has, in increased latency + // or reduced availability. This is the percentage of how much latency has increased + // or availability has decreased during the event, compared to what is typical + // for traffic from this client location to the Amazon Web Services location + // using this client network. // // For more information, see When Amazon Web Services creates and resolves health // events (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop) @@ -3882,10 +4027,13 @@ type UpdateMonitorInput struct { // for other API requests. ClientToken *string `type:"string" idempotencyToken:"true"` - // The list of health event thresholds. A health event threshold percentage, - // for performance and availability, determines when Internet Monitor creates - // a health event when there's an internet issue that affects your application + // The list of health score thresholds. A threshold percentage for health scores, + // along with other configuration information, determines when Internet Monitor + // creates a health event when there's an internet issue that affects your application // end users. + // + // For more information, see Change health event thresholds (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview) + // in the Internet Monitor section of the CloudWatch User Guide. HealthEventsConfig *HealthEventsConfig `type:"structure"` // Publish internet measurements for Internet Monitor to another location, such @@ -3893,10 +4041,11 @@ type UpdateMonitorInput struct { // Logs. InternetMeasurementsLogDelivery *InternetMeasurementsLogDelivery `type:"structure"` - // The maximum number of city-networks to monitor for your resources. A city-network + // The maximum number of city-networks to monitor for your application. A city-network // is the location (city) where clients access your application resources from - // and the network or ASN, such as an internet service provider, that clients - // access the resources through. + // and the ASN or network provider, such as an internet service provider (ISP), + // that clients access the resources through. Setting this limit can help control + // billing costs. MaxCityNetworksToMonitor *int64 `min:"1" type:"integer"` // The name of the monitor. @@ -3905,14 +4054,16 @@ type UpdateMonitorInput struct { MonitorName *string `location:"uri" locationName:"MonitorName" min:"1" type:"string" required:"true"` // The resources to include in a monitor, which you provide as a set of Amazon - // Resource Names (ARNs). + // Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon CloudFront distributions, + // or Amazon WorkSpaces directories. // - // You can add a combination of Amazon Virtual Private Clouds (VPCs) and Amazon - // CloudFront distributions, or you can add Amazon WorkSpaces directories. You - // can't add all three types of resources. + // You can add a combination of VPCs and CloudFront distributions, or you can + // add WorkSpaces directories, or you can add NLBs. You can't add NLBs or WorkSpaces + // directories together with any other resources. // - // If you add only VPC resources, at least one VPC must have an Internet Gateway - // attached to it, to make sure that it has internet connectivity. + // If you add only Amazon Virtual Private Clouds resources, at least one VPC + // must have an Internet Gateway attached to it, to make sure that it has internet + // connectivity. ResourcesToAdd []*string `type:"list"` // The resources to remove from a monitor, which you provide as a set of Amazon @@ -3925,7 +4076,13 @@ type UpdateMonitorInput struct { Status *string `type:"string" enum:"MonitorConfigState"` // The percentage of the internet-facing traffic for your application that you - // want to monitor with this monitor. + // want to monitor with this monitor. If you set a city-networks maximum, that + // limit overrides the traffic percentage that you set. + // + // To learn more, see Choosing an application traffic percentage to monitor + // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html) + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User + // Guide. TrafficPercentageToMonitor *int64 `min:"1" type:"integer"` } @@ -4142,6 +4299,12 @@ const ( // HealthEventImpactTypePerformance is a HealthEventImpactType enum value HealthEventImpactTypePerformance = "PERFORMANCE" + + // HealthEventImpactTypeLocalAvailability is a HealthEventImpactType enum value + HealthEventImpactTypeLocalAvailability = "LOCAL_AVAILABILITY" + + // HealthEventImpactTypeLocalPerformance is a HealthEventImpactType enum value + HealthEventImpactTypeLocalPerformance = "LOCAL_PERFORMANCE" ) // HealthEventImpactType_Values returns all elements of the HealthEventImpactType enum @@ -4149,6 +4312,8 @@ func HealthEventImpactType_Values() []string { return []string{ HealthEventImpactTypeAvailability, HealthEventImpactTypePerformance, + HealthEventImpactTypeLocalAvailability, + HealthEventImpactTypeLocalPerformance, } } @@ -4168,6 +4333,22 @@ func HealthEventStatus_Values() []string { } } +const ( + // LocalHealthEventsConfigStatusEnabled is a LocalHealthEventsConfigStatus enum value + LocalHealthEventsConfigStatusEnabled = "ENABLED" + + // LocalHealthEventsConfigStatusDisabled is a LocalHealthEventsConfigStatus enum value + LocalHealthEventsConfigStatusDisabled = "DISABLED" +) + +// LocalHealthEventsConfigStatus_Values returns all elements of the LocalHealthEventsConfigStatus enum +func LocalHealthEventsConfigStatus_Values() []string { + return []string{ + LocalHealthEventsConfigStatusEnabled, + LocalHealthEventsConfigStatusDisabled, + } +} + const ( // LogDeliveryStatusEnabled is a LogDeliveryStatus enum value LogDeliveryStatusEnabled = "ENABLED" diff --git a/service/internetmonitor/doc.go b/service/internetmonitor/doc.go index 643e68dbd65..8359c64060c 100644 --- a/service/internetmonitor/doc.go +++ b/service/internetmonitor/doc.go @@ -5,8 +5,8 @@ // // Amazon CloudWatch Internet Monitor provides visibility into how internet // issues impact the performance and availability between your applications -// hosted on Amazon Web Services and your end users. It reduces the time it -// takes for you to diagnose internet issues from days to minutes. Internet +// hosted on Amazon Web Services and your end users. It can reduce the time +// it takes for you to diagnose internet issues from days to minutes. Internet // Monitor uses the connectivity data that Amazon Web Services captures from // its global networking footprint to calculate a baseline of performance and // availability for internet traffic. This is the same data that Amazon Web @@ -24,11 +24,11 @@ // that Amazon Web Services is taking to mitigate the problem. // // To use Internet Monitor, you create a monitor and associate your application's -// resources with it, VPCs, CloudFront distributions, or WorkSpaces directories, -// to enable Internet Monitor to know where your application's internet traffic +// resources with it - VPCs, NLBs, CloudFront distributions, or WorkSpaces directories +// - so Internet Monitor can determine where your application's internet traffic // is. Internet Monitor then provides internet measurements from Amazon Web -// Services that are specific to the locations and networks that communicate -// with your application. +// Services that are specific to the locations and ASNs (typically, internet +// service providers or ISPs) that communicate with your application. // // For more information, see Using Amazon CloudWatch Internet Monitor (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html) // in the Amazon CloudWatch User Guide. diff --git a/service/medialive/api.go b/service/medialive/api.go index 7564ceace58..3b27dab60d2 100644 --- a/service/medialive/api.go +++ b/service/medialive/api.go @@ -12869,6 +12869,8 @@ type DescribeInputDeviceOutput struct { Arn *string `locationName:"arn" type:"string"` + AvailabilityZone *string `locationName:"availabilityZone" type:"string"` + // The state of the connection between the input device and AWS. ConnectionState *string `locationName:"connectionState" type:"string" enum:"InputDeviceConnectionState"` @@ -12932,6 +12934,12 @@ func (s *DescribeInputDeviceOutput) SetArn(v string) *DescribeInputDeviceOutput return s } +// SetAvailabilityZone sets the AvailabilityZone field's value. +func (s *DescribeInputDeviceOutput) SetAvailabilityZone(v string) *DescribeInputDeviceOutput { + s.AvailabilityZone = &v + return s +} + // SetConnectionState sets the ConnectionState field's value. func (s *DescribeInputDeviceOutput) SetConnectionState(v string) *DescribeInputDeviceOutput { s.ConnectionState = &v @@ -19934,6 +19942,9 @@ type InputDeviceSummary struct { // The unique ARN of the input device. Arn *string `locationName:"arn" type:"string"` + // The Availability Zone associated with this input device. + AvailabilityZone *string `locationName:"availabilityZone" type:"string"` + // The state of the connection between the input device and AWS. ConnectionState *string `locationName:"connectionState" type:"string" enum:"InputDeviceConnectionState"` @@ -19999,6 +20010,12 @@ func (s *InputDeviceSummary) SetArn(v string) *InputDeviceSummary { return s } +// SetAvailabilityZone sets the AvailabilityZone field's value. +func (s *InputDeviceSummary) SetAvailabilityZone(v string) *InputDeviceSummary { + s.AvailabilityZone = &v + return s +} + // SetConnectionState sets the ConnectionState field's value. func (s *InputDeviceSummary) SetConnectionState(v string) *InputDeviceSummary { s.ConnectionState = &v @@ -31241,6 +31258,8 @@ func (s *UpdateChannelOutput) SetChannel(v *Channel) *UpdateChannelOutput { type UpdateInputDeviceInput struct { _ struct{} `type:"structure"` + AvailabilityZone *string `locationName:"availabilityZone" type:"string"` + // Configurable settings for the input device. HdDeviceSettings *InputDeviceConfigurableSettings `locationName:"hdDeviceSettings" type:"structure"` @@ -31287,6 +31306,12 @@ func (s *UpdateInputDeviceInput) Validate() error { return nil } +// SetAvailabilityZone sets the AvailabilityZone field's value. +func (s *UpdateInputDeviceInput) SetAvailabilityZone(v string) *UpdateInputDeviceInput { + s.AvailabilityZone = &v + return s +} + // SetHdDeviceSettings sets the HdDeviceSettings field's value. func (s *UpdateInputDeviceInput) SetHdDeviceSettings(v *InputDeviceConfigurableSettings) *UpdateInputDeviceInput { s.HdDeviceSettings = v @@ -31316,6 +31341,8 @@ type UpdateInputDeviceOutput struct { Arn *string `locationName:"arn" type:"string"` + AvailabilityZone *string `locationName:"availabilityZone" type:"string"` + // The state of the connection between the input device and AWS. ConnectionState *string `locationName:"connectionState" type:"string" enum:"InputDeviceConnectionState"` @@ -31379,6 +31406,12 @@ func (s *UpdateInputDeviceOutput) SetArn(v string) *UpdateInputDeviceOutput { return s } +// SetAvailabilityZone sets the AvailabilityZone field's value. +func (s *UpdateInputDeviceOutput) SetAvailabilityZone(v string) *UpdateInputDeviceOutput { + s.AvailabilityZone = &v + return s +} + // SetConnectionState sets the ConnectionState field's value. func (s *UpdateInputDeviceOutput) SetConnectionState(v string) *UpdateInputDeviceOutput { s.ConnectionState = &v diff --git a/service/polly/api.go b/service/polly/api.go index 22780960e85..6aa496ebb36 100644 --- a/service/polly/api.go +++ b/service/polly/api.go @@ -3998,6 +3998,9 @@ const ( // LanguageCodeNlBe is a LanguageCode enum value LanguageCodeNlBe = "nl-BE" + + // LanguageCodeFrBe is a LanguageCode enum value + LanguageCodeFrBe = "fr-BE" ) // LanguageCode_Values returns all elements of the LanguageCode enum @@ -4041,6 +4044,7 @@ func LanguageCode_Values() []string { LanguageCodeFiFi, LanguageCodeEnIe, LanguageCodeNlBe, + LanguageCodeFrBe, } } @@ -4405,6 +4409,9 @@ const ( // VoiceIdLisa is a VoiceId enum value VoiceIdLisa = "Lisa" + + // VoiceIdIsabelle is a VoiceId enum value + VoiceIdIsabelle = "Isabelle" ) // VoiceId_Values returns all elements of the VoiceId enum @@ -4501,5 +4508,6 @@ func VoiceId_Values() []string { VoiceIdNiamh, VoiceIdSofie, VoiceIdLisa, + VoiceIdIsabelle, } } diff --git a/service/rds/api.go b/service/rds/api.go index 3d9051fb765..9efbe0557f7 100644 --- a/service/rds/api.go +++ b/service/rds/api.go @@ -3423,6 +3423,11 @@ func (c *RDS) DeleteDBClusterRequest(input *DeleteDBClusterInput) (req *request. // - ErrCodeInvalidDBClusterSnapshotStateFault "InvalidDBClusterSnapshotStateFault" // The supplied value isn't a valid DB cluster snapshot state. // +// - ErrCodeDBClusterAutomatedBackupQuotaExceededFault "DBClusterAutomatedBackupQuotaExceededFault" +// The quota for retained automated backups was exceeded. This prevents you +// from retaining any additional automated backups. The retained automated backups +// quota is the same as your DB cluster quota. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBCluster func (c *RDS) DeleteDBCluster(input *DeleteDBClusterInput) (*DeleteDBClusterOutput, error) { req, out := c.DeleteDBClusterRequest(input) @@ -3445,6 +3450,90 @@ func (c *RDS) DeleteDBClusterWithContext(ctx aws.Context, input *DeleteDBCluster return out, req.Send() } +const opDeleteDBClusterAutomatedBackup = "DeleteDBClusterAutomatedBackup" + +// DeleteDBClusterAutomatedBackupRequest generates a "aws/request.Request" representing the +// client's request for the DeleteDBClusterAutomatedBackup operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeleteDBClusterAutomatedBackup for more information on using the DeleteDBClusterAutomatedBackup +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the DeleteDBClusterAutomatedBackupRequest method. +// req, resp := client.DeleteDBClusterAutomatedBackupRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterAutomatedBackup +func (c *RDS) DeleteDBClusterAutomatedBackupRequest(input *DeleteDBClusterAutomatedBackupInput) (req *request.Request, output *DeleteDBClusterAutomatedBackupOutput) { + op := &request.Operation{ + Name: opDeleteDBClusterAutomatedBackup, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteDBClusterAutomatedBackupInput{} + } + + output = &DeleteDBClusterAutomatedBackupOutput{} + req = c.newRequest(op, input, output) + return +} + +// DeleteDBClusterAutomatedBackup API operation for Amazon Relational Database Service. +// +// Deletes automated backups using the DbClusterResourceId value of the source +// DB cluster or the Amazon Resource Name (ARN) of the automated backups. +// +// 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. +// +// See the AWS API reference guide for Amazon Relational Database Service's +// API operation DeleteDBClusterAutomatedBackup for usage and error information. +// +// Returned Error Codes: +// +// - ErrCodeInvalidDBClusterAutomatedBackupStateFault "InvalidDBClusterAutomatedBackupStateFault" +// The automated backup is in an invalid state. For example, this automated +// backup is associated with an active cluster. +// +// - ErrCodeDBClusterAutomatedBackupNotFoundFault "DBClusterAutomatedBackupNotFoundFault" +// No automated backup for this DB cluster was found. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterAutomatedBackup +func (c *RDS) DeleteDBClusterAutomatedBackup(input *DeleteDBClusterAutomatedBackupInput) (*DeleteDBClusterAutomatedBackupOutput, error) { + req, out := c.DeleteDBClusterAutomatedBackupRequest(input) + return out, req.Send() +} + +// DeleteDBClusterAutomatedBackupWithContext is the same as DeleteDBClusterAutomatedBackup with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteDBClusterAutomatedBackup for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *RDS) DeleteDBClusterAutomatedBackupWithContext(ctx aws.Context, input *DeleteDBClusterAutomatedBackupInput, opts ...request.Option) (*DeleteDBClusterAutomatedBackupOutput, error) { + req, out := c.DeleteDBClusterAutomatedBackupRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteDBClusterEndpoint = "DeleteDBClusterEndpoint" // DeleteDBClusterEndpointRequest generates a "aws/request.Request" representing the @@ -3814,7 +3903,7 @@ func (c *RDS) DeleteDBInstanceRequest(input *DeleteDBInstanceInput) (req *reques // - ErrCodeDBInstanceAutomatedBackupQuotaExceededFault "DBInstanceAutomatedBackupQuotaExceeded" // The quota for retained automated backups was exceeded. This prevents you // from retaining any additional automated backups. The retained automated backups -// quota is the same as your DB Instance quota. +// quota is the same as your DB instance quota. // // See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance func (c *RDS) DeleteDBInstance(input *DeleteDBInstanceInput) (*DeleteDBInstanceOutput, error) { @@ -5151,6 +5240,89 @@ func (c *RDS) DescribeCertificatesPagesWithContext(ctx aws.Context, input *Descr return p.Err() } +const opDescribeDBClusterAutomatedBackups = "DescribeDBClusterAutomatedBackups" + +// DescribeDBClusterAutomatedBackupsRequest generates a "aws/request.Request" representing the +// client's request for the DescribeDBClusterAutomatedBackups operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DescribeDBClusterAutomatedBackups for more information on using the DescribeDBClusterAutomatedBackups +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the DescribeDBClusterAutomatedBackupsRequest method. +// req, resp := client.DescribeDBClusterAutomatedBackupsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterAutomatedBackups +func (c *RDS) DescribeDBClusterAutomatedBackupsRequest(input *DescribeDBClusterAutomatedBackupsInput) (req *request.Request, output *DescribeDBClusterAutomatedBackupsOutput) { + op := &request.Operation{ + Name: opDescribeDBClusterAutomatedBackups, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeDBClusterAutomatedBackupsInput{} + } + + output = &DescribeDBClusterAutomatedBackupsOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeDBClusterAutomatedBackups API operation for Amazon Relational Database Service. +// +// Displays backups for both current and deleted DB clusters. For example, use +// this operation to find details about automated backups for previously deleted +// clusters. Current clusters are returned for both the DescribeDBClusterAutomatedBackups +// and DescribeDBClusters operations. +// +// All parameters are optional. +// +// 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. +// +// See the AWS API reference guide for Amazon Relational Database Service's +// API operation DescribeDBClusterAutomatedBackups for usage and error information. +// +// Returned Error Codes: +// - ErrCodeDBClusterAutomatedBackupNotFoundFault "DBClusterAutomatedBackupNotFoundFault" +// No automated backup for this DB cluster was found. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterAutomatedBackups +func (c *RDS) DescribeDBClusterAutomatedBackups(input *DescribeDBClusterAutomatedBackupsInput) (*DescribeDBClusterAutomatedBackupsOutput, error) { + req, out := c.DescribeDBClusterAutomatedBackupsRequest(input) + return out, req.Send() +} + +// DescribeDBClusterAutomatedBackupsWithContext is the same as DescribeDBClusterAutomatedBackups with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeDBClusterAutomatedBackups for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *RDS) DescribeDBClusterAutomatedBackupsWithContext(ctx aws.Context, input *DescribeDBClusterAutomatedBackupsInput, opts ...request.Option) (*DescribeDBClusterAutomatedBackupsOutput, error) { + req, out := c.DescribeDBClusterAutomatedBackupsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeDBClusterBacktracks = "DescribeDBClusterBacktracks" // DescribeDBClusterBacktracksRequest generates a "aws/request.Request" representing the @@ -13895,6 +14067,9 @@ func (c *RDS) RestoreDBClusterToPointInTimeRequest(input *RestoreDBClusterToPoin // DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter // group. // +// - ErrCodeDBClusterAutomatedBackupNotFoundFault "DBClusterAutomatedBackupNotFoundFault" +// No automated backup for this DB cluster was found. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterToPointInTime func (c *RDS) RestoreDBClusterToPointInTime(input *RestoreDBClusterToPointInTimeInput) (*RestoreDBClusterToPointInTimeOutput, error) { req, out := c.RestoreDBClusterToPointInTimeRequest(input) @@ -14895,7 +15070,7 @@ func (c *RDS) StartDBInstanceAutomatedBackupsReplicationRequest(input *StartDBIn // - ErrCodeDBInstanceAutomatedBackupQuotaExceededFault "DBInstanceAutomatedBackupQuotaExceeded" // The quota for retained automated backups was exceeded. This prevents you // from retaining any additional automated backups. The retained automated backups -// quota is the same as your DB Instance quota. +// quota is the same as your DB instance quota. // // - ErrCodeStorageTypeNotSupportedFault "StorageTypeNotSupported" // The specified StorageType can't be associated with the DB instance. @@ -25544,6 +25719,259 @@ func (s *DBCluster) SetVpcSecurityGroups(v []*VpcSecurityGroupMembership) *DBClu return s } +// An automated backup of a DB cluster. It consists of system backups, transaction +// logs, and the database cluster properties that existed at the time you deleted +// the source cluster. +type DBClusterAutomatedBackup struct { + _ struct{} `type:"structure"` + + // For all database engines except Amazon Aurora, AllocatedStorage specifies + // the allocated storage size in gibibytes (GiB). For Aurora, AllocatedStorage + // always returns 1, because Aurora DB cluster storage size isn't fixed, but + // instead automatically adjusts as needed. + AllocatedStorage *int64 `type:"integer"` + + // The Availability Zones where instances in the DB cluster can be created. + // For information on Amazon Web Services Regions and Availability Zones, see + // Regions and Availability Zones (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html). + AvailabilityZones []*string `locationNameList:"AvailabilityZone" type:"list"` + + // The retention period for the automated backups. + BackupRetentionPeriod *int64 `type:"integer"` + + // The time when the DB cluster was created, in Universal Coordinated Time (UTC). + ClusterCreateTime *time.Time `type:"timestamp"` + + // The Amazon Resource Name (ARN) for the source DB cluster. + DBClusterArn *string `type:"string"` + + // The Amazon Resource Name (ARN) for the automated backups. + DBClusterAutomatedBackupsArn *string `type:"string"` + + // The identifier for the source DB cluster, which can't be changed and which + // is unique to an Amazon Web Services Region. + DBClusterIdentifier *string `type:"string"` + + // The resource ID for the source DB cluster, which can't be changed and which + // is unique to an Amazon Web Services Region. + DbClusterResourceId *string `type:"string"` + + // The name of the database engine for this automated backup. + Engine *string `type:"string"` + + // The engine mode of the database engine for the automated backup. + EngineMode *string `type:"string"` + + // The version of the database engine for the automated backup. + EngineVersion *string `type:"string"` + + // True if mapping of Amazon Web Services Identity and Access Management (IAM) + // accounts to database accounts is enabled, and otherwise false. + IAMDatabaseAuthenticationEnabled *bool `type:"boolean"` + + // The IOPS (I/O operations per second) value for the automated backup. + // + // This setting is only for non-Aurora Multi-AZ DB clusters. + Iops *int64 `type:"integer"` + + // The Amazon Web Services KMS key ID for an automated backup. + // + // The Amazon Web Services KMS key identifier is the key ARN, key ID, alias + // ARN, or alias name for the KMS key. + KmsKeyId *string `type:"string"` + + // The license model information for this DB cluster automated backup. + LicenseModel *string `type:"string"` + + // The master user name of the automated backup. + MasterUsername *string `type:"string"` + + // The port number that the automated backup used for connections. + // + // Default: Inherits from the source DB cluster + // + // Valid Values: 1150-65535 + Port *int64 `type:"integer"` + + // The Amazon Web Services Region associated with the automated backup. + Region *string `type:"string"` + + // Earliest and latest time an instance can be restored to: + RestoreWindow *RestoreWindow `type:"structure"` + + // A list of status information for an automated backup: + // + // * retained - Automated backups for deleted clusters. + Status *string `type:"string"` + + // Specifies whether the source DB cluster is encrypted. + StorageEncrypted *bool `type:"boolean"` + + // The storage type associated with the DB cluster. + // + // This setting is only for non-Aurora Multi-AZ DB clusters. + StorageType *string `type:"string"` + + // The VPC ID associated with the DB cluster. + VpcId *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 DBClusterAutomatedBackup) 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 DBClusterAutomatedBackup) GoString() string { + return s.String() +} + +// SetAllocatedStorage sets the AllocatedStorage field's value. +func (s *DBClusterAutomatedBackup) SetAllocatedStorage(v int64) *DBClusterAutomatedBackup { + s.AllocatedStorage = &v + return s +} + +// SetAvailabilityZones sets the AvailabilityZones field's value. +func (s *DBClusterAutomatedBackup) SetAvailabilityZones(v []*string) *DBClusterAutomatedBackup { + s.AvailabilityZones = v + return s +} + +// SetBackupRetentionPeriod sets the BackupRetentionPeriod field's value. +func (s *DBClusterAutomatedBackup) SetBackupRetentionPeriod(v int64) *DBClusterAutomatedBackup { + s.BackupRetentionPeriod = &v + return s +} + +// SetClusterCreateTime sets the ClusterCreateTime field's value. +func (s *DBClusterAutomatedBackup) SetClusterCreateTime(v time.Time) *DBClusterAutomatedBackup { + s.ClusterCreateTime = &v + return s +} + +// SetDBClusterArn sets the DBClusterArn field's value. +func (s *DBClusterAutomatedBackup) SetDBClusterArn(v string) *DBClusterAutomatedBackup { + s.DBClusterArn = &v + return s +} + +// SetDBClusterAutomatedBackupsArn sets the DBClusterAutomatedBackupsArn field's value. +func (s *DBClusterAutomatedBackup) SetDBClusterAutomatedBackupsArn(v string) *DBClusterAutomatedBackup { + s.DBClusterAutomatedBackupsArn = &v + return s +} + +// SetDBClusterIdentifier sets the DBClusterIdentifier field's value. +func (s *DBClusterAutomatedBackup) SetDBClusterIdentifier(v string) *DBClusterAutomatedBackup { + s.DBClusterIdentifier = &v + return s +} + +// SetDbClusterResourceId sets the DbClusterResourceId field's value. +func (s *DBClusterAutomatedBackup) SetDbClusterResourceId(v string) *DBClusterAutomatedBackup { + s.DbClusterResourceId = &v + return s +} + +// SetEngine sets the Engine field's value. +func (s *DBClusterAutomatedBackup) SetEngine(v string) *DBClusterAutomatedBackup { + s.Engine = &v + return s +} + +// SetEngineMode sets the EngineMode field's value. +func (s *DBClusterAutomatedBackup) SetEngineMode(v string) *DBClusterAutomatedBackup { + s.EngineMode = &v + return s +} + +// SetEngineVersion sets the EngineVersion field's value. +func (s *DBClusterAutomatedBackup) SetEngineVersion(v string) *DBClusterAutomatedBackup { + s.EngineVersion = &v + return s +} + +// SetIAMDatabaseAuthenticationEnabled sets the IAMDatabaseAuthenticationEnabled field's value. +func (s *DBClusterAutomatedBackup) SetIAMDatabaseAuthenticationEnabled(v bool) *DBClusterAutomatedBackup { + s.IAMDatabaseAuthenticationEnabled = &v + return s +} + +// SetIops sets the Iops field's value. +func (s *DBClusterAutomatedBackup) SetIops(v int64) *DBClusterAutomatedBackup { + s.Iops = &v + return s +} + +// SetKmsKeyId sets the KmsKeyId field's value. +func (s *DBClusterAutomatedBackup) SetKmsKeyId(v string) *DBClusterAutomatedBackup { + s.KmsKeyId = &v + return s +} + +// SetLicenseModel sets the LicenseModel field's value. +func (s *DBClusterAutomatedBackup) SetLicenseModel(v string) *DBClusterAutomatedBackup { + s.LicenseModel = &v + return s +} + +// SetMasterUsername sets the MasterUsername field's value. +func (s *DBClusterAutomatedBackup) SetMasterUsername(v string) *DBClusterAutomatedBackup { + s.MasterUsername = &v + return s +} + +// SetPort sets the Port field's value. +func (s *DBClusterAutomatedBackup) SetPort(v int64) *DBClusterAutomatedBackup { + s.Port = &v + return s +} + +// SetRegion sets the Region field's value. +func (s *DBClusterAutomatedBackup) SetRegion(v string) *DBClusterAutomatedBackup { + s.Region = &v + return s +} + +// SetRestoreWindow sets the RestoreWindow field's value. +func (s *DBClusterAutomatedBackup) SetRestoreWindow(v *RestoreWindow) *DBClusterAutomatedBackup { + s.RestoreWindow = v + return s +} + +// SetStatus sets the Status field's value. +func (s *DBClusterAutomatedBackup) SetStatus(v string) *DBClusterAutomatedBackup { + s.Status = &v + return s +} + +// SetStorageEncrypted sets the StorageEncrypted field's value. +func (s *DBClusterAutomatedBackup) SetStorageEncrypted(v bool) *DBClusterAutomatedBackup { + s.StorageEncrypted = &v + return s +} + +// SetStorageType sets the StorageType field's value. +func (s *DBClusterAutomatedBackup) SetStorageType(v string) *DBClusterAutomatedBackup { + s.StorageType = &v + return s +} + +// SetVpcId sets the VpcId field's value. +func (s *DBClusterAutomatedBackup) SetVpcId(v string) *DBClusterAutomatedBackup { + s.VpcId = &v + return s +} + // This data type represents the information you need to connect to an Amazon // Aurora DB cluster. This data type is used as a response element in the following // actions: @@ -25974,7 +26402,7 @@ type DBClusterSnapshot struct { // snapshot was created from. DBClusterIdentifier *string `type:"string"` - // The Amazon Resource Name (ARN) for the DB cluster snapshot. + // Specifies the Amazon Resource Name (ARN) for the DB cluster snapshot. DBClusterSnapshotArn *string `type:"string"` // Specifies the identifier for the DB cluster snapshot. @@ -25983,6 +26411,10 @@ type DBClusterSnapshot struct { // Reserved for future use. DBSystemId *string `type:"string"` + // Specifies the resource ID of the DB cluster that this DB cluster snapshot + // was created from. + DbClusterResourceId *string `type:"string"` + // Specifies the name of the database engine for this DB cluster snapshot. Engine *string `type:"string"` @@ -26114,6 +26546,12 @@ func (s *DBClusterSnapshot) SetDBSystemId(v string) *DBClusterSnapshot { return s } +// SetDbClusterResourceId sets the DbClusterResourceId field's value. +func (s *DBClusterSnapshot) SetDbClusterResourceId(v string) *DBClusterSnapshot { + s.DbClusterResourceId = &v + return s +} + // SetEngine sets the Engine field's value. func (s *DBClusterSnapshot) SetEngine(v string) *DBClusterSnapshot { s.Engine = &v @@ -27636,11 +28074,11 @@ type DBInstanceAutomatedBackup struct { // with the automated backup. DBInstanceAutomatedBackupsReplications []*DBInstanceAutomatedBackupsReplication `locationNameList:"DBInstanceAutomatedBackupsReplication" type:"list"` - // The customer id of the instance that is/was associated with the automated - // backup. + // The identifier for the source DB instance, which can't be changed and which + // is unique to an Amazon Web Services Region. DBInstanceIdentifier *string `type:"string"` - // The identifier for the source DB instance, which can't be changed and which + // The resource ID for the source DB instance, which can't be changed and which // is unique to an Amazon Web Services Region. DbiResourceId *string `type:"string"` @@ -27672,7 +28110,7 @@ type DBInstanceAutomatedBackup struct { // License model information for the automated backup. LicenseModel *string `type:"string"` - // The license model of an automated backup. + // The master user name of an automated backup. MasterUsername *string `type:"string"` // The option group the automated backup is associated with. If omitted, the @@ -27694,11 +28132,11 @@ type DBInstanceAutomatedBackup struct { // Provides a list of status information for an automated backup: // - // * active - automated backups for current instances + // * active - Automated backups for current instances. // - // * retained - automated backups for deleted instances + // * retained - Automated backups for deleted instances. // - // * creating - automated backups that are waiting for the first automated + // * creating - Automated backups that are waiting for the first automated // snapshot to be available. Status *string `type:"string"` @@ -29989,6 +30427,86 @@ func (s *DeleteCustomDBEngineVersionOutput) SetValidUpgradeTarget(v []*UpgradeTa return s } +type DeleteDBClusterAutomatedBackupInput struct { + _ struct{} `type:"structure"` + + // The identifier for the source DB cluster, which can't be changed and which + // is unique to an Amazon Web Services Region. + // + // DbClusterResourceId is a required field + DbClusterResourceId *string `type:"string" 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 DeleteDBClusterAutomatedBackupInput) 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 DeleteDBClusterAutomatedBackupInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteDBClusterAutomatedBackupInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteDBClusterAutomatedBackupInput"} + if s.DbClusterResourceId == nil { + invalidParams.Add(request.NewErrParamRequired("DbClusterResourceId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDbClusterResourceId sets the DbClusterResourceId field's value. +func (s *DeleteDBClusterAutomatedBackupInput) SetDbClusterResourceId(v string) *DeleteDBClusterAutomatedBackupInput { + s.DbClusterResourceId = &v + return s +} + +type DeleteDBClusterAutomatedBackupOutput struct { + _ struct{} `type:"structure"` + + // An automated backup of a DB cluster. It consists of system backups, transaction + // logs, and the database cluster properties that existed at the time you deleted + // the source cluster. + DBClusterAutomatedBackup *DBClusterAutomatedBackup `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 DeleteDBClusterAutomatedBackupOutput) 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 DeleteDBClusterAutomatedBackupOutput) GoString() string { + return s.String() +} + +// SetDBClusterAutomatedBackup sets the DBClusterAutomatedBackup field's value. +func (s *DeleteDBClusterAutomatedBackupOutput) SetDBClusterAutomatedBackup(v *DBClusterAutomatedBackup) *DeleteDBClusterAutomatedBackupOutput { + s.DBClusterAutomatedBackup = v + return s +} + type DeleteDBClusterEndpointInput struct { _ struct{} `type:"structure"` @@ -30183,6 +30701,11 @@ type DeleteDBClusterInput struct { // DBClusterIdentifier is a required field DBClusterIdentifier *string `type:"string" required:"true"` + // A value that indicates whether to remove automated backups immediately after + // the DB cluster is deleted. This parameter isn't case-sensitive. The default + // is to remove automated backups immediately after the DB cluster is deleted. + DeleteAutomatedBackups *bool `type:"boolean"` + // The DB cluster snapshot identifier of the new DB cluster snapshot created // when SkipFinalSnapshot is disabled. // @@ -30246,6 +30769,12 @@ func (s *DeleteDBClusterInput) SetDBClusterIdentifier(v string) *DeleteDBCluster return s } +// SetDeleteAutomatedBackups sets the DeleteAutomatedBackups field's value. +func (s *DeleteDBClusterInput) SetDeleteAutomatedBackups(v bool) *DeleteDBClusterInput { + s.DeleteAutomatedBackups = &v + return s +} + // SetFinalDBSnapshotIdentifier sets the FinalDBSnapshotIdentifier field's value. func (s *DeleteDBClusterInput) SetFinalDBSnapshotIdentifier(v string) *DeleteDBClusterInput { s.FinalDBSnapshotIdentifier = &v @@ -31834,6 +32363,159 @@ func (s *DescribeCertificatesOutput) SetMarker(v string) *DescribeCertificatesOu return s } +type DescribeDBClusterAutomatedBackupsInput struct { + _ struct{} `type:"structure"` + + // (Optional) The user-supplied DB cluster identifier. If this parameter is + // specified, it must match the identifier of an existing DB cluster. It returns + // information from the specific DB cluster's automated backup. This parameter + // isn't case-sensitive. + DBClusterIdentifier *string `type:"string"` + + // The resource ID of the DB cluster that is the source of the automated backup. + // This parameter isn't case-sensitive. + DbClusterResourceId *string `type:"string"` + + // A filter that specifies which resources to return based on status. + // + // Supported filters are the following: + // + // * status retained - Automated backups for deleted clusters and after backup + // replication is stopped. + // + // * db-cluster-id - Accepts DB cluster identifiers and Amazon Resource Names + // (ARNs). The results list includes only information about the DB cluster + // automated backups identified by these ARNs. + // + // * db-cluster-resource-id - Accepts DB resource identifiers and Amazon + // Resource Names (ARNs). The results list includes only information about + // the DB cluster resources identified by these ARNs. + // + // Returns all resources by default. The status for each resource is specified + // in the response. + Filters []*Filter `locationNameList:"Filter" type:"list"` + + // The pagination token provided in the previous request. If this parameter + // is specified the response includes only records beyond the marker, up to + // MaxRecords. + Marker *string `type:"string"` + + // The maximum number of records to include in the response. If more records + // exist than the specified MaxRecords value, a pagination token called a marker + // is included in the response so that you can retrieve the remaining results. + MaxRecords *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 DescribeDBClusterAutomatedBackupsInput) 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 DescribeDBClusterAutomatedBackupsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeDBClusterAutomatedBackupsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeDBClusterAutomatedBackupsInput"} + if s.Filters != nil { + for i, v := range s.Filters { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Filters", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDBClusterIdentifier sets the DBClusterIdentifier field's value. +func (s *DescribeDBClusterAutomatedBackupsInput) SetDBClusterIdentifier(v string) *DescribeDBClusterAutomatedBackupsInput { + s.DBClusterIdentifier = &v + return s +} + +// SetDbClusterResourceId sets the DbClusterResourceId field's value. +func (s *DescribeDBClusterAutomatedBackupsInput) SetDbClusterResourceId(v string) *DescribeDBClusterAutomatedBackupsInput { + s.DbClusterResourceId = &v + return s +} + +// SetFilters sets the Filters field's value. +func (s *DescribeDBClusterAutomatedBackupsInput) SetFilters(v []*Filter) *DescribeDBClusterAutomatedBackupsInput { + s.Filters = v + return s +} + +// SetMarker sets the Marker field's value. +func (s *DescribeDBClusterAutomatedBackupsInput) SetMarker(v string) *DescribeDBClusterAutomatedBackupsInput { + s.Marker = &v + return s +} + +// SetMaxRecords sets the MaxRecords field's value. +func (s *DescribeDBClusterAutomatedBackupsInput) SetMaxRecords(v int64) *DescribeDBClusterAutomatedBackupsInput { + s.MaxRecords = &v + return s +} + +type DescribeDBClusterAutomatedBackupsOutput struct { + _ struct{} `type:"structure"` + + // A list of DBClusterAutomatedBackup backups. + DBClusterAutomatedBackups []*DBClusterAutomatedBackup `locationNameList:"DBClusterAutomatedBackup" type:"list"` + + // The pagination token provided in the previous request. If this parameter + // is specified the response includes only records beyond the marker, up to + // MaxRecords. + Marker *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 DescribeDBClusterAutomatedBackupsOutput) 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 DescribeDBClusterAutomatedBackupsOutput) GoString() string { + return s.String() +} + +// SetDBClusterAutomatedBackups sets the DBClusterAutomatedBackups field's value. +func (s *DescribeDBClusterAutomatedBackupsOutput) SetDBClusterAutomatedBackups(v []*DBClusterAutomatedBackup) *DescribeDBClusterAutomatedBackupsOutput { + s.DBClusterAutomatedBackups = v + return s +} + +// SetMarker sets the Marker field's value. +func (s *DescribeDBClusterAutomatedBackupsOutput) SetMarker(v string) *DescribeDBClusterAutomatedBackupsOutput { + s.Marker = &v + return s +} + type DescribeDBClusterBacktracksInput struct { _ struct{} `type:"structure"` @@ -32539,6 +33221,9 @@ type DescribeDBClusterSnapshotsInput struct { // must also be specified. DBClusterSnapshotIdentifier *string `type:"string"` + // A specific DB cluster resource ID to describe. + DbClusterResourceId *string `type:"string"` + // A filter that specifies one or more DB cluster snapshots to describe. // // Supported filters: @@ -32662,6 +33347,12 @@ func (s *DescribeDBClusterSnapshotsInput) SetDBClusterSnapshotIdentifier(v strin return s } +// SetDbClusterResourceId sets the DbClusterResourceId field's value. +func (s *DescribeDBClusterSnapshotsInput) SetDbClusterResourceId(v string) *DescribeDBClusterSnapshotsInput { + s.DbClusterResourceId = &v + return s +} + // SetFilters sets the Filters field's value. func (s *DescribeDBClusterSnapshotsInput) SetFilters(v []*Filter) *DescribeDBClusterSnapshotsInput { s.Filters = v @@ -33177,7 +33868,7 @@ type DescribeDBInstanceAutomatedBackupsInput struct { // (Optional) The user-supplied instance identifier. If this parameter is specified, // it must match the identifier of an existing DB instance. It returns information - // from the specific DB instance' automated backup. This parameter isn't case-sensitive. + // from the specific DB instance's automated backup. This parameter isn't case-sensitive. DBInstanceIdentifier *string `type:"string"` // The resource ID of the DB instance that is the source of the automated backup. @@ -33188,10 +33879,10 @@ type DescribeDBInstanceAutomatedBackupsInput struct { // // Supported filters are the following: // - // * status active - automated backups for current instances retained - automated - // backups for deleted instances and after backup replication is stopped - // creating - automated backups that are waiting for the first automated - // snapshot to be available + // * status active - Automated backups for current instances. creating - + // Automated backups that are waiting for the first automated snapshot to + // be available. retained - Automated backups for deleted instances and after + // backup replication is stopped. // // * db-instance-id - Accepts DB instance identifiers and Amazon Resource // Names (ARNs). The results list includes only information about the DB @@ -48930,9 +49621,10 @@ type RestoreDBClusterToPointInTimeInput struct { // * Must match the identifier of an existing DBCluster. // // Valid for: Aurora DB clusters and Multi-AZ DB clusters - // - // SourceDBClusterIdentifier is a required field - SourceDBClusterIdentifier *string `type:"string" required:"true"` + SourceDBClusterIdentifier *string `type:"string"` + + // The resource ID of the source DB cluster from which to restore. + SourceDbClusterResourceId *string `type:"string"` // Specifies the storage type to be associated with the DB cluster. // @@ -48990,9 +49682,6 @@ func (s *RestoreDBClusterToPointInTimeInput) Validate() error { if s.DBClusterIdentifier == nil { invalidParams.Add(request.NewErrParamRequired("DBClusterIdentifier")) } - if s.SourceDBClusterIdentifier == nil { - invalidParams.Add(request.NewErrParamRequired("SourceDBClusterIdentifier")) - } if invalidParams.Len() > 0 { return invalidParams @@ -49138,6 +49827,12 @@ func (s *RestoreDBClusterToPointInTimeInput) SetSourceDBClusterIdentifier(v stri return s } +// SetSourceDbClusterResourceId sets the SourceDbClusterResourceId field's value. +func (s *RestoreDBClusterToPointInTimeInput) SetSourceDbClusterResourceId(v string) *RestoreDBClusterToPointInTimeInput { + s.SourceDbClusterResourceId = &v + return s +} + // SetStorageType sets the StorageType field's value. func (s *RestoreDBClusterToPointInTimeInput) SetStorageType(v string) *RestoreDBClusterToPointInTimeInput { s.StorageType = &v diff --git a/service/rds/errors.go b/service/rds/errors.go index 60916d59e0f..8529f9287a3 100644 --- a/service/rds/errors.go +++ b/service/rds/errors.go @@ -86,6 +86,20 @@ const ( // The user already has a DB cluster with the given identifier. ErrCodeDBClusterAlreadyExistsFault = "DBClusterAlreadyExistsFault" + // ErrCodeDBClusterAutomatedBackupNotFoundFault for service response error code + // "DBClusterAutomatedBackupNotFoundFault". + // + // No automated backup for this DB cluster was found. + ErrCodeDBClusterAutomatedBackupNotFoundFault = "DBClusterAutomatedBackupNotFoundFault" + + // ErrCodeDBClusterAutomatedBackupQuotaExceededFault for service response error code + // "DBClusterAutomatedBackupQuotaExceededFault". + // + // The quota for retained automated backups was exceeded. This prevents you + // from retaining any additional automated backups. The retained automated backups + // quota is the same as your DB cluster quota. + ErrCodeDBClusterAutomatedBackupQuotaExceededFault = "DBClusterAutomatedBackupQuotaExceededFault" + // ErrCodeDBClusterBacktrackNotFoundFault for service response error code // "DBClusterBacktrackNotFoundFault". // @@ -180,7 +194,7 @@ const ( // // The quota for retained automated backups was exceeded. This prevents you // from retaining any additional automated backups. The retained automated backups - // quota is the same as your DB Instance quota. + // quota is the same as your DB instance quota. ErrCodeDBInstanceAutomatedBackupQuotaExceededFault = "DBInstanceAutomatedBackupQuotaExceeded" // ErrCodeDBInstanceNotFoundFault for service response error code @@ -493,6 +507,13 @@ const ( // You can't delete the CEV. ErrCodeInvalidCustomDBEngineVersionStateFault = "InvalidCustomDBEngineVersionStateFault" + // ErrCodeInvalidDBClusterAutomatedBackupStateFault for service response error code + // "InvalidDBClusterAutomatedBackupStateFault". + // + // The automated backup is in an invalid state. For example, this automated + // backup is associated with an active cluster. + ErrCodeInvalidDBClusterAutomatedBackupStateFault = "InvalidDBClusterAutomatedBackupStateFault" + // ErrCodeInvalidDBClusterCapacityFault for service response error code // "InvalidDBClusterCapacityFault". // diff --git a/service/rds/examples_test.go b/service/rds/examples_test.go index 8c387837d1e..f8e53136546 100644 --- a/service/rds/examples_test.go +++ b/service/rds/examples_test.go @@ -1304,6 +1304,8 @@ func ExampleRDS_DeleteDBCluster_shared00() { fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterSnapshotStateFault, aerr.Error()) + case rds.ErrCodeDBClusterAutomatedBackupQuotaExceededFault: + fmt.Println(rds.ErrCodeDBClusterAutomatedBackupQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } @@ -3963,6 +3965,8 @@ func ExampleRDS_RestoreDBClusterToPointInTime_shared00() { fmt.Println(rds.ErrCodeDomainNotFoundFault, aerr.Error()) case rds.ErrCodeDBClusterParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBClusterParameterGroupNotFoundFault, aerr.Error()) + case rds.ErrCodeDBClusterAutomatedBackupNotFoundFault: + fmt.Println(rds.ErrCodeDBClusterAutomatedBackupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } diff --git a/service/rds/rdsiface/interface.go b/service/rds/rdsiface/interface.go index 8125a00b4c6..f071c18a666 100644 --- a/service/rds/rdsiface/interface.go +++ b/service/rds/rdsiface/interface.go @@ -192,6 +192,10 @@ type RDSAPI interface { DeleteDBClusterWithContext(aws.Context, *rds.DeleteDBClusterInput, ...request.Option) (*rds.DeleteDBClusterOutput, error) DeleteDBClusterRequest(*rds.DeleteDBClusterInput) (*request.Request, *rds.DeleteDBClusterOutput) + DeleteDBClusterAutomatedBackup(*rds.DeleteDBClusterAutomatedBackupInput) (*rds.DeleteDBClusterAutomatedBackupOutput, error) + DeleteDBClusterAutomatedBackupWithContext(aws.Context, *rds.DeleteDBClusterAutomatedBackupInput, ...request.Option) (*rds.DeleteDBClusterAutomatedBackupOutput, error) + DeleteDBClusterAutomatedBackupRequest(*rds.DeleteDBClusterAutomatedBackupInput) (*request.Request, *rds.DeleteDBClusterAutomatedBackupOutput) + DeleteDBClusterEndpoint(*rds.DeleteDBClusterEndpointInput) (*rds.DeleteDBClusterEndpointOutput, error) DeleteDBClusterEndpointWithContext(aws.Context, *rds.DeleteDBClusterEndpointInput, ...request.Option) (*rds.DeleteDBClusterEndpointOutput, error) DeleteDBClusterEndpointRequest(*rds.DeleteDBClusterEndpointInput) (*request.Request, *rds.DeleteDBClusterEndpointOutput) @@ -270,6 +274,10 @@ type RDSAPI interface { DescribeCertificatesPages(*rds.DescribeCertificatesInput, func(*rds.DescribeCertificatesOutput, bool) bool) error DescribeCertificatesPagesWithContext(aws.Context, *rds.DescribeCertificatesInput, func(*rds.DescribeCertificatesOutput, bool) bool, ...request.Option) error + DescribeDBClusterAutomatedBackups(*rds.DescribeDBClusterAutomatedBackupsInput) (*rds.DescribeDBClusterAutomatedBackupsOutput, error) + DescribeDBClusterAutomatedBackupsWithContext(aws.Context, *rds.DescribeDBClusterAutomatedBackupsInput, ...request.Option) (*rds.DescribeDBClusterAutomatedBackupsOutput, error) + DescribeDBClusterAutomatedBackupsRequest(*rds.DescribeDBClusterAutomatedBackupsInput) (*request.Request, *rds.DescribeDBClusterAutomatedBackupsOutput) + DescribeDBClusterBacktracks(*rds.DescribeDBClusterBacktracksInput) (*rds.DescribeDBClusterBacktracksOutput, error) DescribeDBClusterBacktracksWithContext(aws.Context, *rds.DescribeDBClusterBacktracksInput, ...request.Option) (*rds.DescribeDBClusterBacktracksOutput, error) DescribeDBClusterBacktracksRequest(*rds.DescribeDBClusterBacktracksInput) (*request.Request, *rds.DescribeDBClusterBacktracksOutput) diff --git a/service/sagemaker/api.go b/service/sagemaker/api.go index a2d1e3e4188..03a66b90e88 100644 --- a/service/sagemaker/api.go +++ b/service/sagemaker/api.go @@ -33705,9 +33705,9 @@ type BatchTransformInput_ struct { // DatasetFormat is a required field DatasetFormat *MonitoringDatasetFormat `type:"structure" required:"true"` - // If specified, monitoring jobs substract this time from the end time. For - // information about using offsets for scheduling monitoring jobs, see Schedule - // Model Quality Monitoring Jobs (https://docs.aws.amazon.com/sagemaker/latest/dg/model-monitor-model-quality-schedule.html). + // If specified, monitoring jobs subtract this time from the end time. For information + // about using offsets for scheduling monitoring jobs, see Schedule Model Quality + // Monitoring Jobs (https://docs.aws.amazon.com/sagemaker/latest/dg/model-monitor-model-quality-schedule.html). EndTimeOffset *string `min:"1" type:"string"` // The attributes of the input data that are the input features. @@ -55911,6 +55911,11 @@ type DescribeEndpointOutput struct { // for information about the failure. DeleteEndpoint (https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteEndpoint.html) // is the only operation that can be performed on a failed endpoint. // + // * UpdateRollbackFailed: Both the rolling deployment and auto-rollback + // failed. Your endpoint is in service with a mix of the old and new endpoint + // configurations. For information about how to remedy this issue and restore + // the endpoint's status to InService, see Rolling Deployments (https://docs.aws.amazon.com/sagemaker/latest/dg/deployment-guardrails-rolling.html). + // // EndpointStatus is a required field EndpointStatus *string `type:"string" required:"true" enum:"EndpointStatus"` @@ -90026,7 +90031,8 @@ func (s *ModelInput_) SetDataInputConfig(v string) *ModelInput_ { type ModelLatencyThreshold struct { _ struct{} `type:"structure"` - // The model latency percentile threshold. + // The model latency percentile threshold. For custom load tests, specify the + // value as P95. Percentile *string `type:"string"` // The model latency percentile value in milliseconds. @@ -95990,10 +95996,12 @@ func (s *PendingProductionVariantSummary) SetVariantStatus(v []*ProductionVarian type Phase struct { _ struct{} `type:"structure"` - // Specifies how long traffic phase should be. + // Specifies how long a traffic phase should be. For custom load tests, the + // value should be between 120 and 3600. This value should not exceed JobDurationInSeconds. DurationInSeconds *int64 `min:"1" type:"integer"` - // Specifies how many concurrent users to start with. + // Specifies how many concurrent users to start with. The value should be between + // 1 and 3. InitialNumberOfUsers *int64 `min:"1" type:"integer"` // Specified how many new users to spawn in a minute. @@ -100695,7 +100703,8 @@ type RecommendationJobInputConfig struct { // Existing customer endpoints on which to run an Inference Recommender job. Endpoints []*EndpointInfo `type:"list"` - // Specifies the maximum duration of the job, in seconds.> + // Specifies the maximum duration of the job, in seconds. The maximum value + // is 7200. JobDurationInSeconds *int64 `min:"1" type:"integer"` // The name of the created model. @@ -101042,6 +101051,12 @@ func (s *RecommendationJobResourceLimit) SetMaxParallelOfTests(v int64) *Recomme type RecommendationJobStoppingConditions struct { _ struct{} `type:"structure"` + // Stops a load test when the number of invocations (TPS) peaks and flattens, + // which means that the instance has reached capacity. The default value is + // Stop. If you want the load test to continue after invocations have flattened, + // set the value to Continue. + FlatInvocations *string `type:"string" enum:"FlatInvocations"` + // The maximum number of requests per minute expected for the endpoint. MaxInvocations *int64 `type:"integer"` @@ -101083,6 +101098,12 @@ func (s *RecommendationJobStoppingConditions) Validate() error { return nil } +// SetFlatInvocations sets the FlatInvocations field's value. +func (s *RecommendationJobStoppingConditions) SetFlatInvocations(v string) *RecommendationJobStoppingConditions { + s.FlatInvocations = &v + return s +} + // SetMaxInvocations sets the MaxInvocations field's value. func (s *RecommendationJobStoppingConditions) SetMaxInvocations(v int64) *RecommendationJobStoppingConditions { s.MaxInvocations = &v @@ -105042,6 +105063,79 @@ func (s *SpaceSettings) SetKernelGatewayAppSettings(v *KernelGatewayAppSettings) return s } +// Defines the stairs traffic pattern for an Inference Recommender load test. +// This pattern type consists of multiple steps where the number of users increases +// at each step. +// +// Specify either the stairs or phases traffic pattern. +type Stairs struct { + _ struct{} `type:"structure"` + + // Defines how long each traffic step should be. + DurationInSeconds *int64 `min:"1" type:"integer"` + + // Specifies how many steps to perform during traffic. + NumberOfSteps *int64 `min:"1" type:"integer"` + + // Specifies how many new users to spawn in each step. + UsersPerStep *int64 `min:"1" 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 Stairs) 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 Stairs) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *Stairs) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "Stairs"} + if s.DurationInSeconds != nil && *s.DurationInSeconds < 1 { + invalidParams.Add(request.NewErrParamMinValue("DurationInSeconds", 1)) + } + if s.NumberOfSteps != nil && *s.NumberOfSteps < 1 { + invalidParams.Add(request.NewErrParamMinValue("NumberOfSteps", 1)) + } + if s.UsersPerStep != nil && *s.UsersPerStep < 1 { + invalidParams.Add(request.NewErrParamMinValue("UsersPerStep", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDurationInSeconds sets the DurationInSeconds field's value. +func (s *Stairs) SetDurationInSeconds(v int64) *Stairs { + s.DurationInSeconds = &v + return s +} + +// SetNumberOfSteps sets the NumberOfSteps field's value. +func (s *Stairs) SetNumberOfSteps(v int64) *Stairs { + s.NumberOfSteps = &v + return s +} + +// SetUsersPerStep sets the UsersPerStep field's value. +func (s *Stairs) SetUsersPerStep(v int64) *Stairs { + s.UsersPerStep = &v + return s +} + type StartEdgeDeploymentStageInput struct { _ struct{} `type:"structure"` @@ -107919,7 +108013,10 @@ type TrafficPattern struct { // Defines the phases traffic specification. Phases []*Phase `min:"1" type:"list"` - // Defines the traffic patterns. + // Defines the stairs traffic pattern. + Stairs *Stairs `type:"structure"` + + // Defines the traffic patterns. Choose either PHASES or STAIRS. TrafficType *string `type:"string" enum:"TrafficType"` } @@ -107957,6 +108054,11 @@ func (s *TrafficPattern) Validate() error { } } } + if s.Stairs != nil { + if err := s.Stairs.Validate(); err != nil { + invalidParams.AddNested("Stairs", err.(request.ErrInvalidParams)) + } + } if invalidParams.Len() > 0 { return invalidParams @@ -107970,6 +108072,12 @@ func (s *TrafficPattern) SetPhases(v []*Phase) *TrafficPattern { return s } +// SetStairs sets the Stairs field's value. +func (s *TrafficPattern) SetStairs(v *Stairs) *TrafficPattern { + s.Stairs = v + return s +} + // SetTrafficType sets the TrafficType field's value. func (s *TrafficPattern) SetTrafficType(v string) *TrafficPattern { s.TrafficType = &v @@ -119193,6 +119301,22 @@ func FillingType_Values() []string { } } +const ( + // FlatInvocationsContinue is a FlatInvocations enum value + FlatInvocationsContinue = "Continue" + + // FlatInvocationsStop is a FlatInvocations enum value + FlatInvocationsStop = "Stop" +) + +// FlatInvocations_Values returns all elements of the FlatInvocations enum +func FlatInvocations_Values() []string { + return []string{ + FlatInvocationsContinue, + FlatInvocationsStop, + } +} + const ( // FlowDefinitionStatusInitializing is a FlowDefinitionStatus enum value FlowDefinitionStatusInitializing = "Initializing" @@ -123529,12 +123653,16 @@ func TrafficRoutingConfigType_Values() []string { const ( // TrafficTypePhases is a TrafficType enum value TrafficTypePhases = "PHASES" + + // TrafficTypeStairs is a TrafficType enum value + TrafficTypeStairs = "STAIRS" ) // TrafficType_Values returns all elements of the TrafficType enum func TrafficType_Values() []string { return []string{ TrafficTypePhases, + TrafficTypeStairs, } }