Amazon DevOps Guru is a fully managed service that helps you identify anomalous behavior in business critical operational applications. You specify the Amazon Web Services resources that you want DevOps Guru to cover, then the Amazon CloudWatch metrics and Amazon Web Services CloudTrail events related to those resources are analyzed. When anomalous behavior is detected, DevOps Guru creates an insight that includes recommendations, related events, and related metrics that can help you improve your operational applications. For more information, see What is Amazon DevOps Guru.
You can specify 1 or 2 Amazon Simple Notification Service topics so you are notified every time a new insight is created. You can also enable DevOps Guru to generate an OpsItem in Amazon Web Services Systems Manager for each insight to help you manage and track your work addressing insights.
To learn about the DevOps Guru workflow, see How DevOps Guru works. To learn about DevOps Guru concepts, see Concepts in DevOps Guru.
", "operations": { - "AddNotificationChannel": "Adds a notification channel to DevOps Guru. A notification channel is used to notify you about important DevOps Guru events, such as when an insight is generated.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
", + "AddNotificationChannel": "Adds a notification channel to DevOps Guru. A notification channel is used to notify you about important DevOps Guru events, such as when an insight is generated.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
", + "DeleteInsight": "Deletes the insight along with the associated anomalies, events and recommendations.
", "DescribeAccountHealth": "Returns the number of open reactive insights, the number of open proactive insights, and the number of metrics analyzed in your Amazon Web Services account. Use these numbers to gauge the health of operations in your Amazon Web Services account.
", "DescribeAccountOverview": "For the time range passed in, returns the number of open reactive insight that were created, the number of open proactive insights that were created, and the Mean Time to Recover (MTTR) for all closed reactive insights.
", "DescribeAnomaly": "Returns details about an anomaly that you specify using its ID.
", - "DescribeEventSourcesConfig": "This operation lists details about a DevOps Guru event source that is shared with your account.
", + "DescribeEventSourcesConfig": "Returns the integration status of services that are integrated with DevOps Guru as Consumer via EventBridge. The one service that can be integrated with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive recommendations which can be stored and viewed in DevOps Guru.
", "DescribeFeedback": "Returns the most recent feedback submitted in the current Amazon Web Services account and Region.
", "DescribeInsight": "Returns details about an insight that you specify using its ID.
", "DescribeOrganizationHealth": "Returns active insights, predictive insights, and resource hours analyzed in last hour.
", @@ -27,7 +28,7 @@ "SearchInsights": " Returns a list of insights in your Amazon Web Services account. You can specify which insights are returned by their start time, one or more statuses (ONGOING, CLOSED, and CLOSED), one or more severities (LOW, MEDIUM, and HIGH), and type (REACTIVE or PROACTIVE).
Use the Filters parameter to specify status and severity search parameters. Use the Type parameter to specify REACTIVE or PROACTIVE in your search.
Returns a list of insights in your organization. You can specify which insights are returned by their start time, one or more statuses (ONGOING, CLOSED, and CLOSED), one or more severities (LOW, MEDIUM, and HIGH), and type (REACTIVE or PROACTIVE).
Use the Filters parameter to specify status and severity search parameters. Use the Type parameter to specify REACTIVE or PROACTIVE in your search.
Starts the creation of an estimate of the monthly cost to analyze your Amazon Web Services resources.
", - "UpdateEventSourcesConfig": "Updates the event source configuration.
", + "UpdateEventSourcesConfig": "Enables or disables integration with a service that can be integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive recommendations which can be stored and viewed in DevOps Guru.
", "UpdateResourceCollection": "Updates the collection of resources that DevOps Guru analyzes. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks. This method also creates the IAM role required for you to use DevOps Guru.
", "UpdateServiceIntegration": "Enables or disables integration with a service that can be integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon Web Services Systems Manager, which can be used to create an OpsItem for each generated insight.
" }, @@ -74,9 +75,9 @@ } }, "AmazonCodeGuruProfilerIntegration": { - "base": "Information about your account's integration with Amazon CodeGuru Profiler.
", + "base": "Information about your account's integration with Amazon CodeGuru Profiler. This returns whether DevOps Guru is configured to consume recommendations generated from Amazon CodeGuru Profiler.
", "refs": { - "EventSourcesConfig$AmazonCodeGuruProfiler": "" + "EventSourcesConfig$AmazonCodeGuruProfiler": "Information about whether DevOps Guru is configured to consume recommendations which are generated from AWS CodeGuru Profiler.
" } }, "AnomalyDescription": { @@ -162,10 +163,10 @@ } }, "AnomalySourceMetadata": { - "base": "Metadata about an anomaly. The anomaly is detected using analysis of the metric data over a period of time
", + "base": "Metadata about the detection source that generates proactive anomalies. The anomaly is detected using analysis of the metric data over a period of time
", "refs": { "ProactiveAnomaly$SourceMetadata": "The metadata for the anomaly.
", - "ProactiveAnomalySummary$SourceMetadata": "Returns the metadata of the source.
" + "ProactiveAnomalySummary$SourceMetadata": "The metadata of the source which detects proactive anomalies.
" } }, "AnomalyStatus": { @@ -403,6 +404,16 @@ "GetCostEstimationResponse$TimeRange": "The start and end time of the cost estimation.
" } }, + "DeleteInsightRequest": { + "base": null, + "refs": { + } + }, + "DeleteInsightResponse": { + "base": null, + "refs": { + } + }, "DescribeAccountHealthRequest": { "base": null, "refs": { @@ -622,14 +633,14 @@ "EventSourceOptInStatus": { "base": null, "refs": { - "AmazonCodeGuruProfilerIntegration$Status": "The status of the CodeGuru Profiler integration.
" + "AmazonCodeGuruProfilerIntegration$Status": "The status of the CodeGuru Profiler integration. Specifies if DevOps Guru is enabled to consume recommendations that are generated from Amazon CodeGuru Profiler.
" } }, "EventSourcesConfig": { - "base": "Describes the event sources.
", + "base": "Information about the integration of DevOps Guru as consumer with another AWS service, such as AWS CodeGuru Profiler via EventBridge.
", "refs": { - "DescribeEventSourcesConfigResponse$EventSources": "The name of the event source.
", - "UpdateEventSourcesConfigRequest$EventSources": "The name of the event source.
" + "DescribeEventSourcesConfigResponse$EventSources": "Lists the event sources in the configuration.
", + "UpdateEventSourcesConfigRequest$EventSources": "Configuration information about the integration of DevOps Guru as the Consumer via EventBridge with another AWS Service.
" } }, "EventTimeRange": { @@ -694,6 +705,7 @@ "InsightId": { "base": null, "refs": { + "DeleteInsightRequest$Id": "The ID of the insight.
", "DescribeFeedbackRequest$InsightId": "The ID of the insight for which the feedback was provided.
", "DescribeInsightRequest$Id": "The ID of the insight.
", "InsightFeedback$Id": "The insight feedback ID.
", @@ -929,7 +941,7 @@ } }, "NotificationChannel": { - "base": "Information about a notification channel. A notification channel is used to notify you when DevOps Guru creates an insight. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
", + "base": "Information about a notification channel. A notification channel is used to notify you when DevOps Guru creates an insight. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
", "refs": { "Channels$member": null } @@ -1674,9 +1686,9 @@ } }, "SnsChannelConfig": { - "base": "Contains the Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
", + "base": "Contains the Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
", "refs": { - "NotificationChannelConfig$Sns": "Information about a notification channel configured in DevOps Guru to send notifications when insights are created.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
" + "NotificationChannelConfig$Sns": "Information about a notification channel configured in DevOps Guru to send notifications when insights are created.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
" } }, "SsmOpsItemId": { diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index 29ff8e14627..4f293d69a65 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -24131,7 +24131,29 @@ "z1d.3xlarge", "z1d.6xlarge", "z1d.12xlarge", - "z1d.metal" + "z1d.metal", + "x2idn.16xlarge", + "x2idn.24xlarge", + "x2idn.32xlarge", + "x2iedn.xlarge", + "x2iedn.2xlarge", + "x2iedn.4xlarge", + "x2iedn.8xlarge", + "x2iedn.16xlarge", + "x2iedn.24xlarge", + "x2iedn.32xlarge", + "c6a.large", + "c6a.xlarge", + "c6a.2xlarge", + "c6a.4xlarge", + "c6a.8xlarge", + "c6a.12xlarge", + "c6a.16xlarge", + "c6a.24xlarge", + "c6a.32xlarge", + "c6a.48xlarge", + "c6a.metal", + "m6a.metal" ] }, "InstanceTypeHypervisor":{ diff --git a/models/apis/elasticfilesystem/2015-02-01/api-2.json b/models/apis/elasticfilesystem/2015-02-01/api-2.json index 665f579db7b..548a9ac96b1 100644 --- a/models/apis/elasticfilesystem/2015-02-01/api-2.json +++ b/models/apis/elasticfilesystem/2015-02-01/api-2.json @@ -26,7 +26,8 @@ {"shape":"IncorrectFileSystemLifeCycleState"}, {"shape":"InternalServerError"}, {"shape":"FileSystemNotFound"}, - {"shape":"AccessPointLimitExceeded"} + {"shape":"AccessPointLimitExceeded"}, + {"shape":"ThrottlingException"} ] }, "CreateFileSystem":{ @@ -1720,6 +1721,15 @@ "type":"list", "member":{"shape":"Tag"} }, + "ThrottlingException":{ + "type":"structure", + "members":{ + "ErrorCode":{"shape":"ErrorCode"}, + "Message":{"shape":"ErrorMessage"} + }, + "error":{"httpStatusCode":429}, + "exception":true + }, "ThroughputLimitExceeded":{ "type":"structure", "required":["ErrorCode"], diff --git a/models/apis/elasticfilesystem/2015-02-01/docs-2.json b/models/apis/elasticfilesystem/2015-02-01/docs-2.json index fab6925aadc..8247c085c1f 100644 --- a/models/apis/elasticfilesystem/2015-02-01/docs-2.json +++ b/models/apis/elasticfilesystem/2015-02-01/docs-2.json @@ -1,41 +1,41 @@ { "version": "2.0", - "service": "Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage for use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you add and remove files, so your applications have the storage they need, when they need it. For more information, see the Amazon Elastic File System API Reference and the Amazon Elastic File System User Guide.
", + "service": "Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage for use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you add and remove files, so that your applications have the storage they need, when they need it. For more information, see the Amazon Elastic File System API Reference and the Amazon Elastic File System User Guide.
", "operations": { - "CreateAccessPoint": "Creates an EFS access point. An access point is an application-specific view into an EFS file system that applies an operating system user and group, and a file system path, to any file system request made through the access point. The operating system user and group override any identity information provided by the NFS client. The file system path is exposed as the access point's root directory. Applications using the access point can only access data in its own directory and below. To learn more, see Mounting a file system using EFS access points.
This operation requires permissions for the elasticfilesystem:CreateAccessPoint action.
Creates an EFS access point. An access point is an application-specific view into an EFS file system that applies an operating system user and group, and a file system path, to any file system request made through the access point. The operating system user and group override any identity information provided by the NFS client. The file system path is exposed as the access point's root directory. Applications using the access point can only access data in the application's own directory and any subdirectories. To learn more, see Mounting a file system using EFS access points.
This operation requires permissions for the elasticfilesystem:CreateAccessPoint action.
Creates a new, empty file system. The operation requires a creation token in the request that Amazon EFS uses to ensure idempotent creation (calling the operation with same creation token has no effect). If a file system does not currently exist that is owned by the caller's Amazon Web Services account with the specified creation token, this operation does the following:
Creates a new, empty file system. The file system will have an Amazon EFS assigned ID, and an initial lifecycle state creating.
Returns with the description of the created file system.
Otherwise, this operation returns a FileSystemAlreadyExists error with the ID of the existing file system.
For basic use cases, you can use a randomly generated UUID for the creation token.
The idempotent operation allows you to retry a CreateFileSystem call without risk of creating an extra file system. This can happen when an initial call fails in a way that leaves it uncertain whether or not a file system was actually created. An example might be that a transport level timeout occurred or your connection was reset. As long as you use the same creation token, if the initial call had succeeded in creating a file system, the client can learn of its existence from the FileSystemAlreadyExists error.
For more information, see Creating a file system in the Amazon EFS User Guide.
The CreateFileSystem call returns while the file system's lifecycle state is still creating. You can check the file system creation status by calling the DescribeFileSystems operation, which among other things returns the file system state.
This operation accepts an optional PerformanceMode parameter that you choose for your file system. We recommend generalPurpose performance mode for most file systems. File systems using the maxIO performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. For more information, see Amazon EFS performance modes.
You can set the throughput mode for the file system using the ThroughputMode parameter.
After the file system is fully created, Amazon EFS sets its lifecycle state to available, at which point you can create one or more mount targets for the file system in your VPC. For more information, see CreateMountTarget. You mount your Amazon EFS file system on an EC2 instances in your VPC by using the mount target. For more information, see Amazon EFS: How it Works.
This operation requires permissions for the elasticfilesystem:CreateFileSystem action.
Creates a mount target for a file system. You can then mount the file system on EC2 instances by using the mount target.
You can create one mount target in each Availability Zone in your VPC. All EC2 instances in a VPC within a given Availability Zone share a single mount target for a given file system. If you have multiple subnets in an Availability Zone, you create a mount target in one of the subnets. EC2 instances do not need to be in the same subnet as the mount target in order to access their file system.
You can create only one mount target for an EFS file system using One Zone storage classes. You must create that mount target in the same Availability Zone in which the file system is located. Use the AvailabilityZoneName and AvailabiltyZoneId properties in the DescribeFileSystems response object to get this information. Use the subnetId associated with the file system's Availability Zone when creating the mount target.
For more information, see Amazon EFS: How it Works.
To create a mount target for a file system, the file system's lifecycle state must be available. For more information, see DescribeFileSystems.
In the request, provide the following:
The file system ID for which you are creating the mount target.
A subnet ID, which determines the following:
The VPC in which Amazon EFS creates the mount target
The Availability Zone in which Amazon EFS creates the mount target
The IP address range from which Amazon EFS selects the IP address of the mount target (if you don't specify an IP address in the request)
After creating the mount target, Amazon EFS returns a response that includes, a MountTargetId and an IpAddress. You use this IP address when mounting the file system in an EC2 instance. You can also use the mount target's DNS name when mounting the file system. The EC2 instance on which you mount the file system by using the mount target can resolve the mount target's DNS name to its IP address. For more information, see How it Works: Implementation Overview.
Note that you can create mount targets for a file system in only one VPC, and there can be only one mount target per Availability Zone. That is, if the file system already has one or more mount targets created for it, the subnet specified in the request to add another mount target must meet the following requirements:
Must belong to the same VPC as the subnets of the existing mount targets
Must not be in the same Availability Zone as any of the subnets of the existing mount targets
If the request satisfies the requirements, Amazon EFS does the following:
Creates a new mount target in the specified subnet.
Also creates a new network interface in the subnet as follows:
If the request provides an IpAddress, Amazon EFS assigns that IP address to the network interface. Otherwise, Amazon EFS assigns a free address in the subnet (in the same way that the Amazon EC2 CreateNetworkInterface call does when a request does not specify a primary private IP address).
If the request provides SecurityGroups, this network interface is associated with those security groups. Otherwise, it belongs to the default security group for the subnet's VPC.
Assigns the description Mount target fsmt-id for file system fs-id where fsmt-id is the mount target ID, and fs-id is the FileSystemId.
Sets the requesterManaged property of the network interface to true, and the requesterId value to EFS.
Each Amazon EFS mount target has one corresponding requester-managed EC2 network interface. After the network interface is created, Amazon EFS sets the NetworkInterfaceId field in the mount target's description to the network interface ID, and the IpAddress field to its address. If network interface creation fails, the entire CreateMountTarget operation fails.
The CreateMountTarget call returns only after creating the network interface, but while the mount target state is still creating, you can check the mount target creation status by calling the DescribeMountTargets operation, which among other things returns the mount target state.
We recommend that you create a mount target in each of the Availability Zones. There are cost considerations for using a file system in an Availability Zone through a mount target created in another Availability Zone. For more information, see Amazon EFS. In addition, by always using a mount target local to the instance's Availability Zone, you eliminate a partial failure scenario. If the Availability Zone in which your mount target is created goes down, then you can't access your file system through that mount target.
This operation requires permissions for the following action on the file system:
elasticfilesystem:CreateMountTarget
This operation also requires permissions for the following Amazon EC2 actions:
ec2:DescribeSubnets
ec2:DescribeNetworkInterfaces
ec2:CreateNetworkInterface
Creates a replication configuration that replicates an existing EFS file system to a new, read-only file system. For more information, see Amazon EFS replication. The replication configuration specifies the following:
Source file system - an existing EFS file system that you want replicated. The source file system cannot be a destination file system in an existing replication configuration.
Destination file system configuration - the configuration of the destination file system to which the source file system will be replicated. There can only be one destination file system in a replication configuration.
Amazon Web Services Region - The Amazon Web Services Region in which the destination file system is created. EFS Replication is available in all Amazon Web Services Region that Amazon EFS is available in, except the following regions: Asia Pacific (Hong Kong) Europe (Milan), Middle East (Bahrain), Africa (Cape Town), and Asia Pacific (Jakarta).
Availability zone - If you want the destination file system to use One Zone availability and durability, you must specify the Availability Zone to create the file system in. For more information about EFS storage classes, see Amazon EFS storage classes in the Amazon EFS User Guide.
Encryption - All destination file systems are created with encryption at rest enabled. You can specify the KMS key that is used to encrypt the destination file system. Your service-managed KMS key for Amazon EFS is used if you don't specify a KMS key. You cannot change this after the file system is created.
The following properties are set by default:
Performance mode - The destination file system's performance mode will match that of the source file system, unless the destination file system uses One Zone storage. In that case, the General Purpose performance mode is used. The Performance mode cannot be changed.
Throughput mode - The destination file system use the Bursting throughput mode by default. You can modify the throughput mode once the file system is created.
The following properties are turned off by default:
Lifecycle management - EFS lifecycle management and intelligent tiering are not enabled on the destination file system. You can enable EFS lifecycle management and intelligent tiering after the destination file system is created.
Automatic backups - Automatic daily backups not enabled on the destination file system. You can change this setting after the file system is created.
For more information, see Amazon EFS replication.
", - "CreateTags": "DEPRECATED - CreateTags is deprecated and not maintained. Please use the API action to create tags for EFS resources.
Creates or overwrites tags associated with a file system. Each tag is a key-value pair. If a tag key specified in the request already exists on the file system, this operation overwrites its value with the value provided in the request. If you add the Name tag to your file system, Amazon EFS returns it in the response to the DescribeFileSystems operation.
This operation requires permission for the elasticfilesystem:CreateTags action.
Creates a replication configuration that replicates an existing EFS file system to a new, read-only file system. For more information, see Amazon EFS replication in the Amazon EFS User Guide. The replication configuration specifies the following:
Source file system - An existing EFS file system that you want replicated. The source file system cannot be a destination file system in an existing replication configuration.
Destination file system configuration - The configuration of the destination file system to which the source file system will be replicated. There can only be one destination file system in a replication configuration. The destination file system configuration consists of the following properties:
Amazon Web Services Region - The Amazon Web Services Region in which the destination file system is created. Amazon EFS replication is available in all Amazon Web Services Regions that Amazon EFS is available in, except Africa (Cape Town), Asia Pacific (Hong Kong), Asia Pacific (Jakarta), Europe (Milan), and Middle East (Bahrain).
Availability Zone - If you want the destination file system to use EFS One Zone availability and durability, you must specify the Availability Zone to create the file system in. For more information about EFS storage classes, see Amazon EFS storage classes in the Amazon EFS User Guide.
Encryption - All destination file systems are created with encryption at rest enabled. You can specify the Key Management Service (KMS) key that is used to encrypt the destination file system. If you don't specify a KMS key, your service-managed KMS key for Amazon EFS is used.
After the file system is created, you cannot change the KMS key.
The following properties are set by default:
Performance mode - The destination file system's performance mode matches that of the source file system, unless the destination file system uses EFS One Zone storage. In that case, the General Purpose performance mode is used. The performance mode cannot be changed.
Throughput mode - The destination file system uses the Bursting Throughput mode by default. After the file system is created, you can modify the throughput mode.
The following properties are turned off by default:
Lifecycle management - EFS lifecycle management and EFS Intelligent-Tiering are not enabled on the destination file system. After the destination file system is created, you can enable EFS lifecycle management and EFS Intelligent-Tiering.
Automatic backups - Automatic daily backups not enabled on the destination file system. After the file system is created, you can change this setting.
For more information, see Amazon EFS replication in the Amazon EFS User Guide.
", + "CreateTags": "DEPRECATED - CreateTags is deprecated and not maintained. To create tags for EFS resources, use the API action.
Creates or overwrites tags associated with a file system. Each tag is a key-value pair. If a tag key specified in the request already exists on the file system, this operation overwrites its value with the value provided in the request. If you add the Name tag to your file system, Amazon EFS returns it in the response to the DescribeFileSystems operation.
This operation requires permission for the elasticfilesystem:CreateTags action.
Deletes the specified access point. After deletion is complete, new clients can no longer connect to the access points. Clients connected to the access point at the time of deletion will continue to function until they terminate their connection.
This operation requires permissions for the elasticfilesystem:DeleteAccessPoint action.
Deletes a file system, permanently severing access to its contents. Upon return, the file system no longer exists and you can't access any contents of the deleted file system.
You can't delete a file system that is in use. That is, if the file system has any mount targets, you must first delete them. For more information, see DescribeMountTargets and DeleteMountTarget.
The DeleteFileSystem call returns while the file system state is still deleting. You can check the file system deletion status by calling the DescribeFileSystems operation, which returns a list of file systems in your account. If you pass file system ID or creation token for the deleted file system, the DescribeFileSystems returns a 404 FileSystemNotFound error.
This operation requires permissions for the elasticfilesystem:DeleteFileSystem action.
Deletes a file system, permanently severing access to its contents. Upon return, the file system no longer exists and you can't access any contents of the deleted file system.
You need to manually delete mount targets attached to a file system before you can delete an EFS file system. This step is performed for you when you use the Amazon Web Services console to delete a file system.
You cannot delete a file system that is part of an EFS Replication configuration. You need to delete the replication configuration first.
You can't delete a file system that is in use. That is, if the file system has any mount targets, you must first delete them. For more information, see DescribeMountTargets and DeleteMountTarget.
The DeleteFileSystem call returns while the file system state is still deleting. You can check the file system deletion status by calling the DescribeFileSystems operation, which returns a list of file systems in your account. If you pass file system ID or creation token for the deleted file system, the DescribeFileSystems returns a 404 FileSystemNotFound error.
This operation requires permissions for the elasticfilesystem:DeleteFileSystem action.
Deletes the FileSystemPolicy for the specified file system. The default FileSystemPolicy goes into effect once the existing policy is deleted. For more information about the default file system policy, see Using Resource-based Policies with EFS.
This operation requires permissions for the elasticfilesystem:DeleteFileSystemPolicy action.
Deletes the specified mount target.
This operation forcibly breaks any mounts of the file system by using the mount target that is being deleted, which might disrupt instances or applications using those mounts. To avoid applications getting cut off abruptly, you might consider unmounting any mounts of the mount target, if feasible. The operation also deletes the associated network interface. Uncommitted writes might be lost, but breaking a mount target using this operation does not corrupt the file system itself. The file system you created remains. You can mount an EC2 instance in your VPC by using another mount target.
This operation requires permissions for the following action on the file system:
elasticfilesystem:DeleteMountTarget
The DeleteMountTarget call returns while the mount target state is still deleting. You can check the mount target deletion by calling the DescribeMountTargets operation, which returns a list of mount target descriptions for the given file system.
The operation also requires permissions for the following Amazon EC2 action on the mount target's network interface:
ec2:DeleteNetworkInterface
Deletes an existing replication configuration. To delete a replication configuration, you must make the request from the Amazon Web Services Region in which the destination file system is located. Deleting a replication configuration ends the replication process. You can write to the destination file system once it's status becomes Writeable.
DEPRECATED - DeleteTags is deprecated and not maintained. Please use the API action to remove tags from EFS resources.
Deletes the specified tags from a file system. If the DeleteTags request includes a tag key that doesn't exist, Amazon EFS ignores it and doesn't cause an error. For more information about tags and related restrictions, see Tag restrictions in the Billing and Cost Management User Guide.
This operation requires permissions for the elasticfilesystem:DeleteTags action.
Deletes an existing replication configuration. To delete a replication configuration, you must make the request from the Amazon Web Services Region in which the destination file system is located. Deleting a replication configuration ends the replication process. After a replication configuration is deleted, the destination file system is no longer read-only. You can write to the destination file system after its status becomes Writeable.
DEPRECATED - DeleteTags is deprecated and not maintained. To remove tags from EFS resources, use the API action.
Deletes the specified tags from a file system. If the DeleteTags request includes a tag key that doesn't exist, Amazon EFS ignores it and doesn't cause an error. For more information about tags and related restrictions, see Tag restrictions in the Billing and Cost Management User Guide.
This operation requires permissions for the elasticfilesystem:DeleteTags action.
Returns the description of a specific Amazon EFS access point if the AccessPointId is provided. If you provide an EFS FileSystemId, it returns descriptions of all access points for that file system. You can provide either an AccessPointId or a FileSystemId in the request, but not both.
This operation requires permissions for the elasticfilesystem:DescribeAccessPoints action.
Returns the account preferences settings for the Amazon Web Services account associated with the user making the request, in the current Amazon Web Services Region. For more information, see Managing Amazon EFS resource IDs.
", "DescribeBackupPolicy": "Returns the backup policy for the specified EFS file system.
", "DescribeFileSystemPolicy": "Returns the FileSystemPolicy for the specified EFS file system.
This operation requires permissions for the elasticfilesystem:DescribeFileSystemPolicy action.
Returns the description of a specific Amazon EFS file system if either the file system CreationToken or the FileSystemId is provided. Otherwise, it returns descriptions of all file systems owned by the caller's Amazon Web Services account in the Amazon Web Services Region of the endpoint that you're calling.
When retrieving all file system descriptions, you can optionally specify the MaxItems parameter to limit the number of descriptions in a response. Currently, this number is automatically set to 10. If more file system descriptions remain, Amazon EFS returns a NextMarker, an opaque token, in the response. In this case, you should send a subsequent request with the Marker request parameter set to the value of NextMarker.
To retrieve a list of your file system descriptions, this operation is used in an iterative process, where DescribeFileSystems is called first without the Marker and then the operation continues to call it with the Marker parameter set to the value of the NextMarker from the previous response until the response has no NextMarker.
The order of file systems returned in the response of one DescribeFileSystems call and the order of file systems returned across the responses of a multi-call iteration is unspecified.
This operation requires permissions for the elasticfilesystem:DescribeFileSystems action.
Returns the current LifecycleConfiguration object for the specified Amazon EFS file system. EFS lifecycle management uses the LifecycleConfiguration object to identify which files to move to the EFS Infrequent Access (IA) storage class. For a file system without a LifecycleConfiguration object, the call returns an empty array in the response.
When EFS Intelligent Tiering is enabled, TransitionToPrimaryStorageClass has a value of AFTER_1_ACCESS.
This operation requires permissions for the elasticfilesystem:DescribeLifecycleConfiguration operation.
Returns the current LifecycleConfiguration object for the specified Amazon EFS file system. EFS lifecycle management uses the LifecycleConfiguration object to identify which files to move to the EFS Infrequent Access (IA) storage class. For a file system without a LifecycleConfiguration object, the call returns an empty array in the response.
When EFS Intelligent-Tiering is enabled, TransitionToPrimaryStorageClass has a value of AFTER_1_ACCESS.
This operation requires permissions for the elasticfilesystem:DescribeLifecycleConfiguration operation.
Returns the security groups currently in effect for a mount target. This operation requires that the network interface of the mount target has been created and the lifecycle state of the mount target is not deleted.
This operation requires permissions for the following actions:
elasticfilesystem:DescribeMountTargetSecurityGroups action on the mount target's file system.
ec2:DescribeNetworkInterfaceAttribute action on the mount target's network interface.
Returns the descriptions of all the current mount targets, or a specific mount target, for a file system. When requesting all of the current mount targets, the order of mount targets returned in the response is unspecified.
This operation requires permissions for the elasticfilesystem:DescribeMountTargets action, on either the file system ID that you specify in FileSystemId, or on the file system of the mount target that you specify in MountTargetId.
Retrieves the replication configurations for either a specific file system, or all configurations for the Amazon Web Services account in an Amazon Web Services Region if a file system is not specified.
", - "DescribeTags": "DEPRECATED - The DeleteTags action is deprecated and not maintained. Please use the API action to remove tags from EFS resources.
Returns the tags associated with a file system. The order of tags returned in the response of one DescribeTags call and the order of tags returned across the responses of a multiple-call iteration (when using pagination) is unspecified.
This operation requires permissions for the elasticfilesystem:DescribeTags action.
Retrieves the replication configuration for a specific file system. If a file system is not specified, all of the replication configurations for the Amazon Web Services account in an Amazon Web Services Region are retrieved.
", + "DescribeTags": "DEPRECATED - The DescribeTags action is deprecated and not maintained. To view tags associated with EFS resources, use the ListTagsForResource API action.
Returns the tags associated with a file system. The order of tags returned in the response of one DescribeTags call and the order of tags returned across the responses of a multiple-call iteration (when using pagination) is unspecified.
This operation requires permissions for the elasticfilesystem:DescribeTags action.
Lists all tags for a top-level EFS resource. You must provide the ID of the resource that you want to retrieve the tags for.
This operation requires permissions for the elasticfilesystem:DescribeAccessPoints action.
Modifies the set of security groups in effect for a mount target.
When you create a mount target, Amazon EFS also creates a new network interface. For more information, see CreateMountTarget. This operation replaces the security groups in effect for the network interface associated with a mount target, with the SecurityGroups provided in the request. This operation requires that the network interface of the mount target has been created and the lifecycle state of the mount target is not deleted.
The operation requires permissions for the following actions:
elasticfilesystem:ModifyMountTargetSecurityGroups action on the mount target's file system.
ec2:ModifyNetworkInterfaceAttribute action on the mount target's network interface.
Use this operation to set the account preference in the current Amazon Web Services Region to use long 17 character (63 bit) or short 8 character (32 bit) resource IDs for new EFS file system and mount target resources. All existing resource IDs are not affected by any changes you make. You can set the ID preference during the opt-in period as EFS transitions to long resource IDs. For more information, see Managing Amazon EFS resource IDs.
Starting in October, 2021, you will receive an error if you try to set the account preference to use the short 8 character format resource ID. Contact Amazon Web Services support if you receive an error and need to use short IDs for file system and mount target resources.
Use this operation to set the account preference in the current Amazon Web Services Region to use long 17 character (63 bit) or short 8 character (32 bit) resource IDs for new EFS file system and mount target resources. All existing resource IDs are not affected by any changes you make. You can set the ID preference during the opt-in period as EFS transitions to long resource IDs. For more information, see Managing Amazon EFS resource IDs.
Starting in October, 2021, you will receive an error if you try to set the account preference to use the short 8 character format resource ID. Contact Amazon Web Services support if you receive an error and must use short IDs for file system and mount target resources.
Updates the file system's backup policy. Use this action to start or stop automatic backups of the file system.
", "PutFileSystemPolicy": "Applies an Amazon EFS FileSystemPolicy to an Amazon EFS file system. A file system policy is an IAM resource-based policy and can contain multiple policy statements. A file system always has exactly one file system policy, which can be the default policy or an explicit policy set or updated using this API operation. EFS file system policies have a 20,000 character limit. When an explicit policy is set, it overrides the default policy. For more information about the default file system policy, see Default EFS File System Policy.
EFS file system policies have a 20,000 character limit.
This operation requires permissions for the elasticfilesystem:PutFileSystemPolicy action.
Enables lifecycle management by creating a new LifecycleConfiguration object. A LifecycleConfiguration object defines when files in an Amazon EFS file system are automatically transitioned to the lower-cost EFS Infrequent Access (IA) storage class. To enable EFS Intelligent Tiering, set the value of TransitionToPrimaryStorageClass to AFTER_1_ACCESS. For more information, see EFS Lifecycle Management.
Each Amazon EFS file system supports one lifecycle configuration, which applies to all files in the file system. If a LifecycleConfiguration object already exists for the specified file system, a PutLifecycleConfiguration call modifies the existing configuration. A PutLifecycleConfiguration call with an empty LifecyclePolicies array in the request body deletes any existing LifecycleConfiguration and turns off lifecycle management for the file system.
In the request, specify the following:
The ID for the file system for which you are enabling, disabling, or modifying lifecycle management.
A LifecyclePolicies array of LifecyclePolicy objects that define when files are moved to the IA storage class. Amazon EFS requires that each LifecyclePolicy object have only have a single transition, so the LifecyclePolicies array needs to be structured with separate LifecyclePolicy objects. See the example requests in the following section for more information.
This operation requires permissions for the elasticfilesystem:PutLifecycleConfiguration operation.
To apply a LifecycleConfiguration object to an encrypted file system, you need the same Key Management Service permissions as when you created the encrypted file system.
Use this action to manage EFS lifecycle management and intelligent tiering. A LifecycleConfiguration consists of one or more LifecyclePolicy objects that define the following:
EFS Lifecycle management - When Amazon EFS automatically transitions files in a file system into the lower-cost Infrequent Access (IA) storage class.
To enable EFS Lifecycle management, set the value of TransitionToIA to one of the available options.
EFS Intelligent tiering - When Amazon EFS automatically transitions files from IA back into the file system's primary storage class (Standard or One Zone Standard.
To enable EFS Intelligent Tiering, set the value of TransitionToPrimaryStorageClass to AFTER_1_ACCESS.
For more information, see EFS Lifecycle Management.
Each Amazon EFS file system supports one lifecycle configuration, which applies to all files in the file system. If a LifecycleConfiguration object already exists for the specified file system, a PutLifecycleConfiguration call modifies the existing configuration. A PutLifecycleConfiguration call with an empty LifecyclePolicies array in the request body deletes any existing LifecycleConfiguration and turns off lifecycle management and intelligent tiering for the file system.
In the request, specify the following:
The ID for the file system for which you are enabling, disabling, or modifying lifecycle management and intelligent tiering.
A LifecyclePolicies array of LifecyclePolicy objects that define when files are moved into IA storage, and when they are moved back to Standard storage.
Amazon EFS requires that each LifecyclePolicy object have only have a single transition, so the LifecyclePolicies array needs to be structured with separate LifecyclePolicy objects. See the example requests in the following section for more information.
This operation requires permissions for the elasticfilesystem:PutLifecycleConfiguration operation.
To apply a LifecycleConfiguration object to an encrypted file system, you need the same Key Management Service permissions as when you created the encrypted file system.
Creates a tag for an EFS resource. You can create tags for EFS file systems and access points using this API operation.
This operation requires permissions for the elasticfilesystem:TagResource action.
Removes tags from an EFS resource. You can remove tags from EFS file systems and access points using this API operation.
This operation requires permissions for the elasticfilesystem:UntagResource action.
Updates the throughput mode or the amount of provisioned throughput of an existing file system.
" }, "shapes": { "AccessPointAlreadyExists": { - "base": "Returned if the access point you are trying to create already exists, with the creation token you provided in the request.
", + "base": "Returned if the access point that you are trying to create already exists, with the creation token you provided in the request.
", "refs": { } }, @@ -68,7 +68,7 @@ } }, "AccessPointLimitExceeded": { - "base": "Returned if the Amazon Web Services account has already created the maximum number of access points allowed per file system.
", + "base": "Returned if the Amazon Web Services account has already created the maximum number of access points allowed per file system. For more informaton, see https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region.
", "refs": { } }, @@ -88,13 +88,13 @@ "base": null, "refs": { "CreateFileSystemRequest$AvailabilityZoneName": "Used to create a file system that uses One Zone storage classes. It specifies the Amazon Web Services Availability Zone in which to create the file system. Use the format us-east-1a to specify the Availability Zone. For more information about One Zone storage classes, see Using EFS storage classes in the Amazon EFS User Guide.
One Zone storage classes are not available in all Availability Zones in Amazon Web Services Regions where Amazon EFS is available.
To create a file system that uses One Zone storage, specify the name of the Availability Zone in which to create the destination file system.
", + "DestinationToCreate$AvailabilityZoneName": "To create a file system that uses EFS One Zone storage, specify the name of the Availability Zone in which to create the destination file system.
", "FileSystemDescription$AvailabilityZoneName": "Describes the Amazon Web Services Availability Zone in which the file system is located, and is valid only for file systems using One Zone storage classes. For more information, see Using EFS storage classes in the Amazon EFS User Guide.
", "MountTargetDescription$AvailabilityZoneName": "The name of the Availability Zone in which the mount target is located. Availability Zones are independently mapped to names for each Amazon Web Services account. For example, the Availability Zone us-east-1a for your Amazon Web Services account might not be the same location as us-east-1a for another Amazon Web Services account.
Returned if the Availability Zone that was specified for a mount target is different from the Availability Zone that was specified for One Zone storage classes. For more information, see Regional and One Zone storage redundancy.
", + "base": "Returned if the Availability Zone that was specified for a mount target is different from the Availability Zone that was specified for One Zone storage. For more information, see Regional and One Zone storage redundancy.
", "refs": { } }, @@ -115,7 +115,7 @@ "BackupPolicy": { "base": "The backup policy for the file system used to create automatic daily backups. If status has a value of ENABLED, the file system is being automatically backed up. For more information, see Automatic backups.
Describes the file system's backup policy, indicating whether automatic backups are turned on or off..
", + "BackupPolicyDescription$BackupPolicy": "Describes the file system's backup policy, indicating whether automatic backups are turned on or off.
", "PutBackupPolicyRequest$BackupPolicy": "The backup policy included in the PutBackupPolicy request.
(Optional) A flag to indicate whether to bypass the FileSystemPolicy lockout safety check. The policy lockout safety check determines whether the policy in the request will prevent the principal making the request will be locked out from making future PutFileSystemPolicy requests on the file system. Set BypassPolicyLockoutSafetyCheck to True only when you intend to prevent the principal that is making the request from making a subsequent PutFileSystemPolicy request on the file system. The default value is False.
(Optional) A boolean that specifies whether or not to bypass the FileSystemPolicy lockout safety check. The lockout safety check determines whether the policy in the request will lock out, or prevent, the IAM principal that is making the request from making future PutFileSystemPolicy requests on this file system. Set BypassPolicyLockoutSafetyCheck to True only when you intend to prevent the IAM principal that is making the request from making subsequent PutFileSystemPolicy requests on this file system. The default value is False.
Array of destination objects. Only one destination object is supported.
" + "ReplicationConfigurationDescription$Destinations": "An array of destination objects. Only one destination object is supported.
" } }, "DestinationsToCreate": { @@ -360,6 +360,7 @@ "SecurityGroupLimitExceeded$ErrorCode": null, "SecurityGroupNotFound$ErrorCode": null, "SubnetNotFound$ErrorCode": null, + "ThrottlingException$ErrorCode": null, "ThroughputLimitExceeded$ErrorCode": null, "TooManyRequests$ErrorCode": null, "UnsupportedAvailabilityZone$ErrorCode": null, @@ -394,6 +395,7 @@ "SecurityGroupLimitExceeded$Message": null, "SecurityGroupNotFound$Message": null, "SubnetNotFound$Message": null, + "ThrottlingException$Message": null, "ThroughputLimitExceeded$Message": null, "TooManyRequests$Message": null, "UnsupportedAvailabilityZone$Message": null, @@ -409,7 +411,7 @@ "base": null, "refs": { "FileSystemDescription$FileSystemArn": "The Amazon Resource Name (ARN) for the EFS file system, in the format arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id . Example with sample data: arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567
The ARN of the current source file system in the replication configuration.
", + "ReplicationConfigurationDescription$SourceFileSystemArn": "The Amazon Resource Name (ARN) of the current source file system in the replication configuration.
", "ReplicationConfigurationDescription$OriginalSourceFileSystemArn": "The Amazon Resource Name (ARN) of the original source Amazon EFS file system in the replication configuration.
" } }, @@ -443,7 +445,7 @@ "DescribeFileSystemsRequest$FileSystemId": "(Optional) ID of the file system whose description you want to retrieve (String).
", "DescribeLifecycleConfigurationRequest$FileSystemId": "The ID of the file system whose LifecycleConfiguration object you want to retrieve (String).
(Optional) ID of the file system whose mount targets you want to list (String). It must be included in your request if an AccessPointId or MountTargetId is not included. Accepts either a file system ID or ARN as input.
You can retrieve replication configurations for a specific file system by providing a file system ID.
", + "DescribeReplicationConfigurationsRequest$FileSystemId": "You can retrieve the replication configuration for a specific file system by providing its file system ID.
", "DescribeTagsRequest$FileSystemId": "The ID of the file system whose tag set you want to retrieve.
", "Destination$FileSystemId": "The ID of the destination Amazon EFS file system.
", "FileSystemAlreadyExists$FileSystemId": null, @@ -514,7 +516,7 @@ } }, "InsufficientThroughputCapacity": { - "base": "Returned if there's not enough capacity to provision additional throughput. This value might be returned when you try to create a file system in provisioned throughput mode, when you attempt to increase the provisioned throughput of an existing file system, or when you attempt to change an existing file system from bursting to provisioned throughput mode. Try again later.
", + "base": "Returned if there's not enough capacity to provision additional throughput. This value might be returned when you try to create a file system in provisioned throughput mode, when you attempt to increase the provisioned throughput of an existing file system, or when you attempt to change an existing file system from Bursting Throughput to Provisioned Throughput mode. Try again later.
", "refs": { } }, @@ -524,7 +526,7 @@ } }, "InvalidPolicyException": { - "base": "Returned if the FileSystemPolicy is is malformed or contains an error such as an invalid parameter value or a missing required parameter. Returned in the case of a policy lockout safety check error.
Returned if the FileSystemPolicy is malformed or contains an error such as a parameter value that is not valid or a missing required parameter. Returned in the case of a policy lockout safety check error.
The ID of the KMS key that you want to use to protect the encrypted file system. This parameter is only required if you want to use a non-default KMS key. If this parameter is not specified, the default KMS key for Amazon EFS is used. You can specify a KMS key ID using the following formats:
Key ID - A unique identifier of the key, for example 1234abcd-12ab-34cd-56ef-1234567890ab.
ARN - An Amazon Resource Name (ARN) for the key, for example arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
Key alias - A previously created display name for a key, for example alias/projectKey1.
Key alias ARN - An ARN for a key alias, for example arn:aws:kms:us-west-2:444455556666:alias/projectKey1.
If you use KmsKeyId, you must set the CreateFileSystemRequest$Encrypted parameter to true.
EFS accepts only symmetric KMS keys. You cannot use asymmetric KMS keys with Amazon EFS file systems.
Specifies the KMS key you want to use to encrypt the destination file system. If you do not specify a KMS key, EFS uses your default KMS key for Amazon EFS, /aws/elasticfilesystem. This ID can be in one of the following formats:
Key ID - A unique identifier of the key, for example 1234abcd-12ab-34cd-56ef-1234567890ab.
ARN - An Amazon Resource Name (ARN) for the key, for example arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
Key alias - A previously created display name for a key, for example alias/projectKey1.
Key alias ARN - An ARN for a key alias, for example arn:aws:kms:us-west-2:444455556666:alias/projectKey1.
The ID of the KMS key that you want to use to protect the encrypted file system. This parameter is required only if you want to use a non-default KMS key. If this parameter is not specified, the default KMS key for Amazon EFS is used. You can specify a KMS key ID using the following formats:
Key ID - A unique identifier of the key, for example 1234abcd-12ab-34cd-56ef-1234567890ab.
ARN - An Amazon Resource Name (ARN) for the key, for example arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
Key alias - A previously created display name for a key, for example alias/projectKey1.
Key alias ARN - An ARN for a key alias, for example arn:aws:kms:us-west-2:444455556666:alias/projectKey1.
If you use KmsKeyId, you must set the CreateFileSystemRequest$Encrypted parameter to true.
EFS accepts only symmetric KMS keys. You cannot use asymmetric KMS keys with Amazon EFS file systems.
Specifies the Key Management Service (KMS) key that you want to use to encrypt the destination file system. If you do not specify a KMS key, Amazon EFS uses your default KMS key for Amazon EFS, /aws/elasticfilesystem. This ID can be in one of the following formats:
Key ID - The unique identifier of the key, for example 1234abcd-12ab-34cd-56ef-1234567890ab.
ARN - The Amazon Resource Name (ARN) for the key, for example arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
Key alias - A previously created display name for a key, for example alias/projectKey1.
Key alias ARN - The ARN for a key alias, for example arn:aws:kms:us-west-2:444455556666:alias/projectKey1.
The ID of an KMS key used to protect the encrypted file system.
" } }, @@ -565,11 +567,11 @@ "base": null, "refs": { "LifecycleConfigurationDescription$LifecyclePolicies": "An array of lifecycle management policies. EFS supports a maximum of one policy per file system.
", - "PutLifecycleConfigurationRequest$LifecyclePolicies": "An array of LifecyclePolicy objects that define the file system's LifecycleConfiguration object. A LifecycleConfiguration object informs EFS lifecycle management and intelligent tiering of the following:
When to move files in the file system from primary storage to the IA storage class.
When to move files that are in IA storage to primary storage.
When using the put-lifecycle-configuration CLI command or the PutLifecycleConfiguration API action, Amazon EFS requires that each LifecyclePolicy object have only a single transition. This means that in a request body, LifecyclePolicies needs to be structured as an array of LifecyclePolicy objects, one object for each transition, TransitionToIA, TransitionToPrimaryStorageClass. See the example requests in the following section for more information.
An array of LifecyclePolicy objects that define the file system's LifecycleConfiguration object. A LifecycleConfiguration object informs EFS lifecycle management and EFS Intelligent-Tiering of the following:
When to move files in the file system from primary storage to the IA storage class.
When to move files that are in IA storage to primary storage.
When using the put-lifecycle-configuration CLI command or the PutLifecycleConfiguration API action, Amazon EFS requires that each LifecyclePolicy object have only a single transition. This means that in a request body, LifecyclePolicies must be structured as an array of LifecyclePolicy objects, one object for each transition, TransitionToIA, TransitionToPrimaryStorageClass. See the example requests in the following section for more information.
Describes a policy used by EFS lifecycle management and EFS intelligent tiering that specifies when to transition files into and out of the file system's Infrequent Access (IA) storage class. For more information, see EFS Intelligent‐Tiering and EFS Lifecycle Management.
When using the put-lifecycle-configuration CLI command or the PutLifecycleConfiguration API action, Amazon EFS requires that each LifecyclePolicy object have only a single transition. This means that in a request body, LifecyclePolicies needs to be structured as an array of LifecyclePolicy objects, one object for each transition, TransitionToIA, TransitionToPrimaryStorageClass. For more information, see the request examples in PutLifecycleConfiguration.
Describes a policy used by EFS lifecycle management and EFS Intelligent-Tiering that specifies when to transition files into and out of the file system's Infrequent Access (IA) storage class. For more information, see EFS Intelligent‐Tiering and EFS Lifecycle Management.
When using the put-lifecycle-configuration CLI command or the PutLifecycleConfiguration API action, Amazon EFS requires that each LifecyclePolicy object have only a single transition. This means that in a request body, LifecyclePolicies must be structured as an array of LifecyclePolicy objects, one object for each transition, TransitionToIA, TransitionToPrimaryStorageClass. For more information, see the request examples in PutLifecycleConfiguration.
(Optional) When retrieving all access points for a file system, you can optionally specify the MaxItems parameter to limit the number of objects returned in a response. The default value is 100.
(Optional) When retrieving account preferences, you can optionally specify the MaxItems parameter to limit the number of objects returned in a response. The default value is 100.
(Optional) You can optionally specify the MaxItems parameter to limit the number of objects returned in a response. The default value is 100.
(Optional) To limit the number of objects returned in a response, you can specify the MaxItems parameter. The default value is 100.
(Optional) Specifies the maximum number of tag objects to return in the response. The default value is 100.
" } }, @@ -671,7 +673,7 @@ } }, "NetworkInterfaceLimitExceeded": { - "base": "The calling account has reached the limit for elastic network interfaces for the specific Amazon Web Services Region. The client should try to delete some elastic network interfaces or get the account limit raised. For more information, see Amazon VPC Limits in the Amazon VPC User Guide (see the Network interfaces per VPC entry in the table).
", + "base": "The calling account has reached the limit for elastic network interfaces for the specific Amazon Web Services Region. Either delete some network interfaces or request that the account quota be raised. For more information, see Amazon VPC Quotas in the Amazon VPC User Guide (see the Network interfaces per Region entry in the Network interfaces table).
", "refs": { } }, @@ -767,7 +769,7 @@ "base": null, "refs": { "Destination$Region": "The Amazon Web Services Region in which the destination file system is located.
", - "DestinationToCreate$Region": "To create a file system that uses regional storage, specify the Amazon Web Services Region in which to create the destination file system.
", + "DestinationToCreate$Region": "To create a file system that uses Regional storage, specify the Amazon Web Services Region in which to create the destination file system.
", "ReplicationConfigurationDescription$SourceFileSystemRegion": "The Amazon Web Services Region in which the source Amazon EFS file system is located.
" } }, @@ -780,18 +782,18 @@ "ReplicationConfigurationDescriptions": { "base": null, "refs": { - "DescribeReplicationConfigurationsResponse$Replications": "The collection of replication configurations returned.
" + "DescribeReplicationConfigurationsResponse$Replications": "The collection of replication configurations that is returned.
" } }, "ReplicationNotFound": { - "base": "Returned if the specified file system did not have a replication configuration.
", + "base": "Returned if the specified file system does not have a replication configuration.
", "refs": { } }, "ReplicationStatus": { "base": null, "refs": { - "Destination$Status": "Describes the status of the destination Amazon EFS file system.
" + "Destination$Status": "Describes the status of the destination Amazon EFS file system. If the status is ERROR, the destination file system in the replication configuration is in a failed state and is unrecoverable. To access the file system data, restore a backup of the failed file system to a new file system.
Specifies the EFS resource ID preference to set for the user's Amazon Web Services account, in the current Amazon Web Services Region, either LONG_ID (17 characters), or SHORT_ID (8 characters).
Starting in October, 2021, you will receive an error when setting the account preference to SHORT_ID. Contact Amazon Web Services support if you receive an error and need to use short IDs for file system and mount target resources.
Specifies the EFS resource ID preference to set for the user's Amazon Web Services account, in the current Amazon Web Services Region, either LONG_ID (17 characters), or SHORT_ID (8 characters).
Starting in October, 2021, you will receive an error when setting the account preference to SHORT_ID. Contact Amazon Web Services support if you receive an error and must use short IDs for file system and mount target resources.
Identifies the EFS resource ID preference, either LONG_ID (17 characters) or SHORT_ID (8 characters).
Specifies the directory on the Amazon EFS file system that the access point provides access to. The access point exposes the specified file system path as the root directory of your file system to applications using the access point. NFS clients using the access point can only access data in the access point's RootDirectory and it's subdirectories.
The directory on the Amazon EFS file system that the access point exposes as the root directory to NFS clients using the access point.
", - "CreateAccessPointRequest$RootDirectory": "Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory > Path specified does not exist, EFS creates it and applies the CreationInfo settings when a client connects to an access point. When specifying a RootDirectory, you need to provide the Path, and the CreationInfo.
Amazon EFS creates a root directory only if you have provided the CreationInfo: OwnUid, OwnGID, and permissions for the directory. If you do not provide this information, Amazon EFS does not create the root directory. If the root directory does not exist, attempts to mount using the access point will fail.
" + "CreateAccessPointRequest$RootDirectory": "Specifies the directory on the Amazon EFS file system that the access point exposes as the root directory of your file system to NFS clients using the access point. The clients using the access point can only access the root directory and below. If the RootDirectory > Path specified does not exist, EFS creates it and applies the CreationInfo settings when a client connects to an access point. When specifying a RootDirectory, you must provide the Path, and the CreationInfo.
Amazon EFS creates a root directory only if you have provided the CreationInfo: OwnUid, OwnGID, and permissions for the directory. If you do not provide this information, Amazon EFS does not create the root directory. If the root directory does not exist, attempts to mount using the access point will fail.
" } }, "SecondaryGids": { @@ -853,7 +855,7 @@ } }, "SecurityGroupNotFound": { - "base": "Returned if one of the specified security groups doesn't exist in the subnet's VPC.
", + "base": "Returned if one of the specified security groups doesn't exist in the subnet's virtual private cloud (VPC).
", "refs": { } }, @@ -868,7 +870,7 @@ "Status": { "base": null, "refs": { - "BackupPolicy$Status": "Describes the status of the file system's backup policy.
ENABLED - EFS is automatically backing up the file system.
ENABLING - EFS is turning on automatic backups for the file system.
DISABLED - automatic back ups are turned off for the file system.
DISABLING - EFS is turning off automatic backups for the file system.
Describes the status of the file system's backup policy.
ENABLED - EFS is automatically backing up the file system.
ENABLING - EFS is turning on automatic backups for the file system.
DISABLED - Automatic back ups are turned off for the file system.
DISABLING - EFS is turning off automatic backups for the file system.
An array of Tag objects to add. Each Tag object is a key-value pair.
Returned when the CreateAccessPoint API action is called too quickly and the number of Access Points in the account is nearing the limit of 120.
Returned if the throughput mode or amount of provisioned throughput can't be changed because the throughput limit of 1024 MiB/s has been reached.
", "refs": { @@ -944,7 +951,7 @@ "Timestamp": { "base": null, "refs": { - "Destination$LastReplicatedTimestamp": "The time when the most recent sync successfully completed on the destination file system. Any changes to data on the source file system that occurred prior to this time were successfully replicated to the destination file system. Any changes that occurred after this time might not be fully replicated.
", + "Destination$LastReplicatedTimestamp": "The time when the most recent sync was successfully completed on the destination file system. Any changes to data on the source file system that occurred before this time have been successfully replicated to the destination file system. Any changes that occurred after this time might not be fully replicated.
", "FileSystemDescription$CreationTime": "The time that the file system was created, in seconds (since 1970-01-01T00:00:00Z).
", "FileSystemSize$Timestamp": "The time at which the size of data, returned in the Value field, was determined. The value is the integer number of seconds since 1970-01-01T00:00:00Z.
Describes when the replication configuration was created.
" @@ -957,14 +964,14 @@ "DescribeAccessPointsResponse$NextToken": "Present if there are more access points than returned in the response. You can use the NextMarker in the subsequent request to fetch the additional descriptions.
", "DescribeAccountPreferencesRequest$NextToken": "(Optional) You can use NextToken in a subsequent request to fetch the next page of Amazon Web Services account preferences if the response payload was paginated.
Present if there are more records than returned in the response. You can use the NextToken in the subsequent request to fetch the additional descriptions.
NextToken is present if the response is paginated. You can use NextMarker in a subsequent request to fetch the next page of output.
NextToken is present if the response is paginated. You can use NextToken in a subsequent request to fetch the next page of output.
You can use the NextToken from the previous response in a subsequent request to fetch the additional descriptions.
(Optional) You can use NextToken in a subsequent request to fetch the next page of access point descriptions if the response payload was paginated.
NextToken is present if the response payload is paginated. You can use NextToken in a subsequent request to fetch the next page of access point descriptions.
Returned if you don’t wait at least 24 hours before changing the throughput mode, or decreasing the Provisioned Throughput value.
", + "base": "Returned if you don’t wait at least 24 hours before either changing the throughput mode, or decreasing the Provisioned Throughput value.
", "refs": { } }, diff --git a/models/apis/iottwinmaker/2021-11-29/api-2.json b/models/apis/iottwinmaker/2021-11-29/api-2.json index b27225fe03a..1c15f63e4ba 100644 --- a/models/apis/iottwinmaker/2021-11-29/api-2.json +++ b/models/apis/iottwinmaker/2021-11-29/api-2.json @@ -1160,15 +1160,18 @@ "GetPropertyValueHistoryRequest":{ "type":"structure", "required":[ - "endDateTime", "selectedProperties", - "startDateTime", "workspaceId" ], "members":{ "componentName":{"shape":"Name"}, "componentTypeId":{"shape":"ComponentTypeId"}, - "endDateTime":{"shape":"Timestamp"}, + "endDateTime":{ + "shape":"Timestamp", + "deprecated":true, + "deprecatedMessage":"This field is deprecated and will throw an error in the future. Use endTime instead." + }, + "endTime":{"shape":"Time"}, "entityId":{"shape":"EntityId"}, "interpolation":{"shape":"InterpolationParameters"}, "maxResults":{"shape":"MaxResults"}, @@ -1176,7 +1179,12 @@ "orderByTime":{"shape":"OrderByTime"}, "propertyFilters":{"shape":"PropertyFilters"}, "selectedProperties":{"shape":"SelectedPropertyList"}, - "startDateTime":{"shape":"Timestamp"}, + "startDateTime":{ + "shape":"Timestamp", + "deprecated":true, + "deprecatedMessage":"This field is deprecated and will throw an error in the future. Use startTime instead." + }, + "startTime":{"shape":"Time"}, "workspaceId":{ "shape":"Id", "location":"uri", @@ -1385,6 +1393,7 @@ "type":"structure", "members":{ "componentTypeId":{"shape":"ComponentTypeId"}, + "externalId":{"shape":"String"}, "parentEntityId":{"shape":"ParentEntityId"} }, "union":true @@ -1617,17 +1626,20 @@ "type":"string", "enum":[ "UPDATE", - "DELETE" + "DELETE", + "CREATE" ] }, "PropertyValue":{ "type":"structure", - "required":[ - "timestamp", - "value" - ], + "required":["value"], "members":{ - "timestamp":{"shape":"Timestamp"}, + "time":{"shape":"Time"}, + "timestamp":{ + "shape":"Timestamp", + "deprecated":true, + "deprecatedMessage":"This field is deprecated and will throw an error in the future. Use time instead." + }, "value":{"shape":"DataValue"} } }, @@ -1692,7 +1704,12 @@ "min":20, "pattern":"arn:((aws)|(aws-cn)|(aws-us-gov)):iam::[0-9]{12}:role/.*" }, - "S3Location":{"type":"string"}, + "S3Location":{ + "type":"string", + "max":1024, + "min":0, + "pattern":".*(^arn:((aws)|(aws-cn)|(aws-us-gov)):s3:::)([a-zA-Z0-9_-]+$).*" + }, "S3Url":{ "type":"string", "max":256, @@ -1832,6 +1849,11 @@ }, "exception":true }, + "Time":{ + "type":"string", + "max":35, + "min":20 + }, "Timestamp":{"type":"timestamp"}, "TooManyTagsException":{ "type":"structure", @@ -2022,9 +2044,7 @@ }, "Value":{ "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z_\\-0-9]+" + "pattern":".*" }, "Values":{ "type":"list", diff --git a/models/apis/iottwinmaker/2021-11-29/docs-2.json b/models/apis/iottwinmaker/2021-11-29/docs-2.json index 97c218ca2b7..6890734ae4d 100644 --- a/models/apis/iottwinmaker/2021-11-29/docs-2.json +++ b/models/apis/iottwinmaker/2021-11-29/docs-2.json @@ -1,9 +1,9 @@ { "version": "2.0", - "service": "TwinMaker is in public preview and is subject to change.
IoT TwinMaker is a service that enables you to build operational digital twins of physical systems. IoT TwinMaker overlays measurements and analysis from real-world sensors, cameras, and enterprise applications so you can create data visualizations to monitor your physical factory, building, or industrial plant. You can use this real-world data to monitor operations and diagnose and repair errors.
", + "service": "IoT TwinMaker is a service that enables you to build operational digital twins of physical systems. IoT TwinMaker overlays measurements and analysis from real-world sensors, cameras, and enterprise applications so you can create data visualizations to monitor your physical factory, building, or industrial plant. You can use this real-world data to monitor operations and diagnose and repair errors.
", "operations": { "BatchPutPropertyValues": "Sets values for multiple time series properties.
", - "CreateComponentType": "Creates a component type.
TwinMaker is in public preview and is subject to change.
Creates a component type.
", "CreateEntity": "Creates an entity.
", "CreateScene": "Creates a scene.
", "CreateWorkspace": "Creates a workplace.
", @@ -61,7 +61,7 @@ "base": null, "refs": { "CreateComponentTypeRequest$isSingleton": "A Boolean value that specifies whether an entity can have more than one component of this type.
", - "DataConnector$isNative": "A Boolean value that specifies whether the data connector is native to TwinMaker.
", + "DataConnector$isNative": "A Boolean value that specifies whether the data connector is native to IoT TwinMaker.
", "DataValue$booleanValue": "A Boolean value.
", "DeleteEntityRequest$isRecursive": "A Boolean value that specifies whether the operation deletes child entities.
", "EntitySummary$hasChildEntities": "A Boolean value that specifies whether the entity has child entities or not.
", @@ -1022,6 +1022,7 @@ "ExternalIdProperty$key": null, "ExternalIdProperty$value": null, "ListComponentTypesFilter$namespace": "The namespace to which the component types in the list belong.
", + "ListEntitiesFilter$externalId": "The external-Id property of a component. The external-Id property is the primary key of an external storage system.
", "PropertyFilter$operator": "The operator associated with this property filter.
", "PropertyFilter$propertyName": "The property name associated with this property filter.
", "Relationship$relationshipType": "The type of the relationship.
", @@ -1073,8 +1074,16 @@ "refs": { } }, + "Time": { + "base": "Timestamp represented in ISO 8601 format
", + "refs": { + "GetPropertyValueHistoryRequest$endTime": null, + "GetPropertyValueHistoryRequest$startTime": null, + "PropertyValue$time": null + } + }, "Timestamp": { - "base": null, + "base": "supports epoch seconds value
", "refs": { "ComponentTypeSummary$creationDateTime": "The date and time when the component type was created.
", "ComponentTypeSummary$updateDateTime": "The date and time when the component type was last updated.
", diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index c5d7d5d33bd..c0a2b1a500a 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -17860,6 +17860,14 @@ "us-iso-west-1" : { } } }, + "eks" : { + "defaults" : { + "protocols" : [ "http", "https" ] + }, + "endpoints" : { + "us-iso-east-1" : { } + } + }, "elasticache" : { "endpoints" : { "us-iso-east-1" : { }, @@ -18322,6 +18330,14 @@ "us-isob-east-1" : { } } }, + "eks" : { + "defaults" : { + "protocols" : [ "http", "https" ] + }, + "endpoints" : { + "us-isob-east-1" : { } + } + }, "elasticache" : { "endpoints" : { "us-isob-east-1" : { } diff --git a/service/devopsguru/api.go b/service/devopsguru/api.go index a071a9ca2ec..1f3e1109b5f 100644 --- a/service/devopsguru/api.go +++ b/service/devopsguru/api.go @@ -64,8 +64,14 @@ func (c *DevOpsGuru) AddNotificationChannelRequest(input *AddNotificationChannel // If you use an Amazon SNS topic in another account, you must attach a policy // to it that grants DevOps Guru permission to it notifications. DevOps Guru // adds the required policy on your behalf to send notifications using Amazon +// SNS in your account. DevOps Guru only supports standard SNS topics. For more +// information, see Permissions for cross account Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). +// +// If you use an Amazon SNS topic in another account, you must attach a policy +// to it that grants DevOps Guru permission to it notifications. DevOps Guru +// adds the required policy on your behalf to send notifications using Amazon // SNS in your account. For more information, see Permissions for cross account -// Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). +// Amazon SNS topics. // // If you use an Amazon SNS topic that is encrypted by an Amazon Web Services // Key Management Service customer-managed key (CMK), then you must add permissions @@ -128,6 +134,106 @@ func (c *DevOpsGuru) AddNotificationChannelWithContext(ctx aws.Context, input *A return out, req.Send() } +const opDeleteInsight = "DeleteInsight" + +// DeleteInsightRequest generates a "aws/request.Request" representing the +// client's request for the DeleteInsight 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 DeleteInsight for more information on using the DeleteInsight +// 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 DeleteInsightRequest method. +// req, resp := client.DeleteInsightRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DeleteInsight +func (c *DevOpsGuru) DeleteInsightRequest(input *DeleteInsightInput) (req *request.Request, output *DeleteInsightOutput) { + op := &request.Operation{ + Name: opDeleteInsight, + HTTPMethod: "DELETE", + HTTPPath: "/insights/{Id}", + } + + if input == nil { + input = &DeleteInsightInput{} + } + + output = &DeleteInsightOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteInsight API operation for Amazon DevOps Guru. +// +// Deletes the insight along with the associated anomalies, events and recommendations. +// +// 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 DevOps Guru's +// API operation DeleteInsight for usage and error information. +// +// Returned Error Types: +// * AccessDeniedException +// You don't have permissions to perform the requested operation. The user or +// role that is making the request must have at least one IAM permissions policy +// attached that grants the required permissions. For more information, see +// Access Management (https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) +// in the IAM User Guide. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// +// * ResourceNotFoundException +// A requested resource could not be found +// +// * ConflictException +// An exception that is thrown when a conflict occurs. +// +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DeleteInsight +func (c *DevOpsGuru) DeleteInsight(input *DeleteInsightInput) (*DeleteInsightOutput, error) { + req, out := c.DeleteInsightRequest(input) + return out, req.Send() +} + +// DeleteInsightWithContext is the same as DeleteInsight with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteInsight 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 *DevOpsGuru) DeleteInsightWithContext(ctx aws.Context, input *DeleteInsightInput, opts ...request.Option) (*DeleteInsightOutput, error) { + req, out := c.DeleteInsightRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeAccountHealth = "DescribeAccountHealth" // DescribeAccountHealthRequest generates a "aws/request.Request" representing the @@ -459,8 +565,10 @@ func (c *DevOpsGuru) DescribeEventSourcesConfigRequest(input *DescribeEventSourc // DescribeEventSourcesConfig API operation for Amazon DevOps Guru. // -// This operation lists details about a DevOps Guru event source that is shared -// with your account. +// Returns the integration status of services that are integrated with DevOps +// Guru as Consumer via EventBridge. The one service that can be integrated +// with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive +// recommendations which can be stored and viewed in DevOps Guru. // // 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 @@ -3201,7 +3309,10 @@ func (c *DevOpsGuru) UpdateEventSourcesConfigRequest(input *UpdateEventSourcesCo // UpdateEventSourcesConfig API operation for Amazon DevOps Guru. // -// Updates the event source configuration. +// Enables or disables integration with a service that can be integrated with +// DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon +// CodeGuru Profiler, which can produce proactive recommendations which can +// be stored and viewed in DevOps Guru. // // 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 @@ -3699,10 +3810,14 @@ func (s *AddNotificationChannelOutput) SetId(v string) *AddNotificationChannelOu } // Information about your account's integration with Amazon CodeGuru Profiler. +// This returns whether DevOps Guru is configured to consume recommendations +// generated from Amazon CodeGuru Profiler. type AmazonCodeGuruProfilerIntegration struct { _ struct{} `type:"structure"` - // The status of the CodeGuru Profiler integration. + // The status of the CodeGuru Profiler integration. Specifies if DevOps Guru + // is enabled to consume recommendations that are generated from Amazon CodeGuru + // Profiler. Status *string `type:"string" enum:"EventSourceOptInStatus"` } @@ -3863,8 +3978,8 @@ func (s *AnomalySourceDetails) SetPerformanceInsightsMetrics(v []*PerformanceIns return s } -// Metadata about an anomaly. The anomaly is detected using analysis of the -// metric data over a period of time +// Metadata about the detection source that generates proactive anomalies. The +// anomaly is detected using analysis of the metric data over a period of time type AnomalySourceMetadata struct { _ struct{} `type:"structure"` @@ -4516,6 +4631,77 @@ func (s *CostEstimationTimeRange) SetStartTime(v time.Time) *CostEstimationTimeR return s } +type DeleteInsightInput struct { + _ struct{} `type:"structure" nopayload:"true"` + + // The ID of the insight. + // + // Id is a required field + Id *string `location:"uri" locationName:"Id" min:"1" 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 DeleteInsightInput) 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 DeleteInsightInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteInsightInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteInsightInput"} + if s.Id == nil { + invalidParams.Add(request.NewErrParamRequired("Id")) + } + if s.Id != nil && len(*s.Id) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Id", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetId sets the Id field's value. +func (s *DeleteInsightInput) SetId(v string) *DeleteInsightInput { + s.Id = &v + return s +} + +type DeleteInsightOutput struct { + _ struct{} `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 DeleteInsightOutput) 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 DeleteInsightOutput) GoString() string { + return s.String() +} + type DescribeAccountHealthInput struct { _ struct{} `type:"structure" nopayload:"true"` } @@ -4851,7 +5037,7 @@ func (s DescribeEventSourcesConfigInput) GoString() string { type DescribeEventSourcesConfigOutput struct { _ struct{} `type:"structure"` - // The name of the event source. + // Lists the event sources in the configuration. EventSources *EventSourcesConfig `type:"structure"` } @@ -5889,11 +6075,13 @@ func (s *EventResource) SetType(v string) *EventResource { return s } -// Describes the event sources. +// Information about the integration of DevOps Guru as consumer with another +// AWS service, such as AWS CodeGuru Profiler via EventBridge. type EventSourcesConfig struct { _ struct{} `type:"structure"` - // Information about your account's integration with Amazon CodeGuru Profiler. + // Information about whether DevOps Guru is configured to consume recommendations + // which are generated from AWS CodeGuru Profiler. AmazonCodeGuruProfiler *AmazonCodeGuruProfilerIntegration `type:"structure"` } @@ -7570,8 +7758,14 @@ func (s *ListRecommendationsOutput) SetRecommendations(v []*Recommendation) *Lis // If you use an Amazon SNS topic in another account, you must attach a policy // to it that grants DevOps Guru permission to it notifications. DevOps Guru // adds the required policy on your behalf to send notifications using Amazon +// SNS in your account. DevOps Guru only supports standard SNS topics. For more +// information, see Permissions for cross account Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). +// +// If you use an Amazon SNS topic in another account, you must attach a policy +// to it that grants DevOps Guru permission to it notifications. DevOps Guru +// adds the required policy on your behalf to send notifications using Amazon // SNS in your account. For more information, see Permissions for cross account -// Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). +// Amazon SNS topics. // // If you use an Amazon SNS topic that is encrypted by an Amazon Web Services // Key Management Service customer-managed key (CMK), then you must add permissions @@ -7630,8 +7824,14 @@ type NotificationChannelConfig struct { // If you use an Amazon SNS topic in another account, you must attach a policy // to it that grants DevOps Guru permission to it notifications. DevOps Guru // adds the required policy on your behalf to send notifications using Amazon + // SNS in your account. DevOps Guru only supports standard SNS topics. For more + // information, see Permissions for cross account Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). + // + // If you use an Amazon SNS topic in another account, you must attach a policy + // to it that grants DevOps Guru permission to it notifications. DevOps Guru + // adds the required policy on your behalf to send notifications using Amazon // SNS in your account. For more information, see Permissions for cross account - // Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). + // Amazon SNS topics. // // If you use an Amazon SNS topic that is encrypted by an Amazon Web Services // Key Management Service customer-managed key (CMK), then you must add permissions @@ -8529,7 +8729,7 @@ type ProactiveAnomalySummary struct { // the anomaly. The one supported source is Amazon CloudWatch metrics. SourceDetails *AnomalySourceDetails `type:"structure"` - // Returns the metadata of the source. + // The metadata of the source which detects proactive anomalies. SourceMetadata *AnomalySourceMetadata `type:"structure"` // The status of the anomaly. @@ -11151,8 +11351,14 @@ func (s *ServiceResourceCost) SetUnitCost(v float64) *ServiceResourceCost { // If you use an Amazon SNS topic in another account, you must attach a policy // to it that grants DevOps Guru permission to it notifications. DevOps Guru // adds the required policy on your behalf to send notifications using Amazon +// SNS in your account. DevOps Guru only supports standard SNS topics. For more +// information, see Permissions for cross account Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). +// +// If you use an Amazon SNS topic in another account, you must attach a policy +// to it that grants DevOps Guru permission to it notifications. DevOps Guru +// adds the required policy on your behalf to send notifications using Amazon // SNS in your account. For more information, see Permissions for cross account -// Amazon SNS topics (https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html). +// Amazon SNS topics. // // If you use an Amazon SNS topic that is encrypted by an Amazon Web Services // Key Management Service customer-managed key (CMK), then you must add permissions @@ -11816,7 +12022,8 @@ func (s *UpdateCloudFormationCollectionFilter) SetStackNames(v []*string) *Updat type UpdateEventSourcesConfigInput struct { _ struct{} `type:"structure"` - // The name of the event source. + // Configuration information about the integration of DevOps Guru as the Consumer + // via EventBridge with another AWS Service. EventSources *EventSourcesConfig `type:"structure"` } diff --git a/service/devopsguru/devopsguruiface/interface.go b/service/devopsguru/devopsguruiface/interface.go index 1b95c79aae1..aa7ff6835b0 100644 --- a/service/devopsguru/devopsguruiface/interface.go +++ b/service/devopsguru/devopsguruiface/interface.go @@ -64,6 +64,10 @@ type DevOpsGuruAPI interface { AddNotificationChannelWithContext(aws.Context, *devopsguru.AddNotificationChannelInput, ...request.Option) (*devopsguru.AddNotificationChannelOutput, error) AddNotificationChannelRequest(*devopsguru.AddNotificationChannelInput) (*request.Request, *devopsguru.AddNotificationChannelOutput) + DeleteInsight(*devopsguru.DeleteInsightInput) (*devopsguru.DeleteInsightOutput, error) + DeleteInsightWithContext(aws.Context, *devopsguru.DeleteInsightInput, ...request.Option) (*devopsguru.DeleteInsightOutput, error) + DeleteInsightRequest(*devopsguru.DeleteInsightInput) (*request.Request, *devopsguru.DeleteInsightOutput) + DescribeAccountHealth(*devopsguru.DescribeAccountHealthInput) (*devopsguru.DescribeAccountHealthOutput, error) DescribeAccountHealthWithContext(aws.Context, *devopsguru.DescribeAccountHealthInput, ...request.Option) (*devopsguru.DescribeAccountHealthOutput, error) DescribeAccountHealthRequest(*devopsguru.DescribeAccountHealthInput) (*request.Request, *devopsguru.DescribeAccountHealthOutput) diff --git a/service/ec2/api.go b/service/ec2/api.go index e2df8586434..4b1c1ce8f49 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -164530,6 +164530,72 @@ const ( // InstanceTypeZ1dMetal is a InstanceType enum value InstanceTypeZ1dMetal = "z1d.metal" + + // InstanceTypeX2idn16xlarge is a InstanceType enum value + InstanceTypeX2idn16xlarge = "x2idn.16xlarge" + + // InstanceTypeX2idn24xlarge is a InstanceType enum value + InstanceTypeX2idn24xlarge = "x2idn.24xlarge" + + // InstanceTypeX2idn32xlarge is a InstanceType enum value + InstanceTypeX2idn32xlarge = "x2idn.32xlarge" + + // InstanceTypeX2iednXlarge is a InstanceType enum value + InstanceTypeX2iednXlarge = "x2iedn.xlarge" + + // InstanceTypeX2iedn2xlarge is a InstanceType enum value + InstanceTypeX2iedn2xlarge = "x2iedn.2xlarge" + + // InstanceTypeX2iedn4xlarge is a InstanceType enum value + InstanceTypeX2iedn4xlarge = "x2iedn.4xlarge" + + // InstanceTypeX2iedn8xlarge is a InstanceType enum value + InstanceTypeX2iedn8xlarge = "x2iedn.8xlarge" + + // InstanceTypeX2iedn16xlarge is a InstanceType enum value + InstanceTypeX2iedn16xlarge = "x2iedn.16xlarge" + + // InstanceTypeX2iedn24xlarge is a InstanceType enum value + InstanceTypeX2iedn24xlarge = "x2iedn.24xlarge" + + // InstanceTypeX2iedn32xlarge is a InstanceType enum value + InstanceTypeX2iedn32xlarge = "x2iedn.32xlarge" + + // InstanceTypeC6aLarge is a InstanceType enum value + InstanceTypeC6aLarge = "c6a.large" + + // InstanceTypeC6aXlarge is a InstanceType enum value + InstanceTypeC6aXlarge = "c6a.xlarge" + + // InstanceTypeC6a2xlarge is a InstanceType enum value + InstanceTypeC6a2xlarge = "c6a.2xlarge" + + // InstanceTypeC6a4xlarge is a InstanceType enum value + InstanceTypeC6a4xlarge = "c6a.4xlarge" + + // InstanceTypeC6a8xlarge is a InstanceType enum value + InstanceTypeC6a8xlarge = "c6a.8xlarge" + + // InstanceTypeC6a12xlarge is a InstanceType enum value + InstanceTypeC6a12xlarge = "c6a.12xlarge" + + // InstanceTypeC6a16xlarge is a InstanceType enum value + InstanceTypeC6a16xlarge = "c6a.16xlarge" + + // InstanceTypeC6a24xlarge is a InstanceType enum value + InstanceTypeC6a24xlarge = "c6a.24xlarge" + + // InstanceTypeC6a32xlarge is a InstanceType enum value + InstanceTypeC6a32xlarge = "c6a.32xlarge" + + // InstanceTypeC6a48xlarge is a InstanceType enum value + InstanceTypeC6a48xlarge = "c6a.48xlarge" + + // InstanceTypeC6aMetal is a InstanceType enum value + InstanceTypeC6aMetal = "c6a.metal" + + // InstanceTypeM6aMetal is a InstanceType enum value + InstanceTypeM6aMetal = "m6a.metal" ) // InstanceType_Values returns all elements of the InstanceType enum @@ -165020,6 +165086,28 @@ func InstanceType_Values() []string { InstanceTypeZ1d6xlarge, InstanceTypeZ1d12xlarge, InstanceTypeZ1dMetal, + InstanceTypeX2idn16xlarge, + InstanceTypeX2idn24xlarge, + InstanceTypeX2idn32xlarge, + InstanceTypeX2iednXlarge, + InstanceTypeX2iedn2xlarge, + InstanceTypeX2iedn4xlarge, + InstanceTypeX2iedn8xlarge, + InstanceTypeX2iedn16xlarge, + InstanceTypeX2iedn24xlarge, + InstanceTypeX2iedn32xlarge, + InstanceTypeC6aLarge, + InstanceTypeC6aXlarge, + InstanceTypeC6a2xlarge, + InstanceTypeC6a4xlarge, + InstanceTypeC6a8xlarge, + InstanceTypeC6a12xlarge, + InstanceTypeC6a16xlarge, + InstanceTypeC6a24xlarge, + InstanceTypeC6a32xlarge, + InstanceTypeC6a48xlarge, + InstanceTypeC6aMetal, + InstanceTypeM6aMetal, } } diff --git a/service/efs/api.go b/service/efs/api.go index fdf420b9b1e..60f6841cf5c 100644 --- a/service/efs/api.go +++ b/service/efs/api.go @@ -63,8 +63,8 @@ func (c *EFS) CreateAccessPointRequest(input *CreateAccessPointInput) (req *requ // point. The operating system user and group override any identity information // provided by the NFS client. The file system path is exposed as the access // point's root directory. Applications using the access point can only access -// data in its own directory and below. To learn more, see Mounting a file system -// using EFS access points (https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html). +// data in the application's own directory and any subdirectories. To learn +// more, see Mounting a file system using EFS access points (https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html). // // This operation requires permissions for the elasticfilesystem:CreateAccessPoint // action. @@ -82,8 +82,8 @@ func (c *EFS) CreateAccessPointRequest(input *CreateAccessPointInput) (req *requ // parameter value or a missing required parameter. // // * AccessPointAlreadyExists -// Returned if the access point you are trying to create already exists, with -// the creation token you provided in the request. +// Returned if the access point that you are trying to create already exists, +// with the creation token you provided in the request. // // * IncorrectFileSystemLifeCycleState // Returned if the file system's lifecycle state is not "available". @@ -97,7 +97,13 @@ func (c *EFS) CreateAccessPointRequest(input *CreateAccessPointInput) (req *requ // // * AccessPointLimitExceeded // Returned if the Amazon Web Services account has already created the maximum -// number of access points allowed per file system. +// number of access points allowed per file system. For more informaton, see +// https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region +// (https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). +// +// * ThrottlingException +// Returned when the CreateAccessPoint API action is called too quickly and +// the number of Access Points in the account is nearing the limit of 120. // // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateAccessPoint func (c *EFS) CreateAccessPoint(input *CreateAccessPointInput) (*CreateAccessPointOutput, error) { @@ -247,7 +253,8 @@ func (c *EFS) CreateFileSystemRequest(input *CreateFileSystemInput) (req *reques // This value might be returned when you try to create a file system in provisioned // throughput mode, when you attempt to increase the provisioned throughput // of an existing file system, or when you attempt to change an existing file -// system from bursting to provisioned throughput mode. Try again later. +// system from Bursting Throughput to Provisioned Throughput mode. Try again +// later. // // * ThroughputLimitExceeded // Returned if the throughput mode or amount of provisioned throughput can't @@ -461,11 +468,11 @@ func (c *EFS) CreateMountTargetRequest(input *CreateMountTargetInput) (req *requ // // * NetworkInterfaceLimitExceeded // The calling account has reached the limit for elastic network interfaces -// for the specific Amazon Web Services Region. The client should try to delete -// some elastic network interfaces or get the account limit raised. For more -// information, see Amazon VPC Limits (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html) -// in the Amazon VPC User Guide (see the Network interfaces per VPC entry in -// the table). +// for the specific Amazon Web Services Region. Either delete some network interfaces +// or request that the account quota be raised. For more information, see Amazon +// VPC Quotas (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html) +// in the Amazon VPC User Guide (see the Network interfaces per Region entry +// in the Network interfaces table). // // * SecurityGroupLimitExceeded // Returned if the size of SecurityGroups specified in the request is greater @@ -473,7 +480,7 @@ func (c *EFS) CreateMountTargetRequest(input *CreateMountTargetInput) (req *requ // // * SecurityGroupNotFound // Returned if one of the specified security groups doesn't exist in the subnet's -// VPC. +// virtual private cloud (VPC). // // * UnsupportedAvailabilityZone // Returned if the requested Amazon EFS functionality is not available in the @@ -481,9 +488,8 @@ func (c *EFS) CreateMountTargetRequest(input *CreateMountTargetInput) (req *requ // // * AvailabilityZonesMismatch // Returned if the Availability Zone that was specified for a mount target is -// different from the Availability Zone that was specified for One Zone storage -// classes. For more information, see Regional and One Zone storage redundancy -// (https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html). +// different from the Availability Zone that was specified for One Zone storage. +// For more information, see Regional and One Zone storage redundancy (https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html). // // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateMountTarget func (c *EFS) CreateMountTarget(input *CreateMountTargetInput) (*MountTargetDescription, error) { @@ -553,53 +559,57 @@ func (c *EFS) CreateReplicationConfigurationRequest(input *CreateReplicationConf // // Creates a replication configuration that replicates an existing EFS file // system to a new, read-only file system. For more information, see Amazon -// EFS replication (https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html). -// The replication configuration specifies the following: +// EFS replication (https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) +// in the Amazon EFS User Guide. The replication configuration specifies the +// following: // -// * Source file system - an existing EFS file system that you want replicated. +// * Source file system - An existing EFS file system that you want replicated. // The source file system cannot be a destination file system in an existing // replication configuration. // -// * Destination file system configuration - the configuration of the destination +// * Destination file system configuration - The configuration of the destination // file system to which the source file system will be replicated. There // can only be one destination file system in a replication configuration. +// The destination file system configuration consists of the following properties: // Amazon Web Services Region - The Amazon Web Services Region in which the -// destination file system is created. EFS Replication is available in all -// Amazon Web Services Region that Amazon EFS is available in, except the -// following regions: Asia Pacific (Hong Kong) Europe (Milan), Middle East -// (Bahrain), Africa (Cape Town), and Asia Pacific (Jakarta). Availability -// zone - If you want the destination file system to use One Zone availability -// and durability, you must specify the Availability Zone to create the file +// destination file system is created. Amazon EFS replication is available +// in all Amazon Web Services Regions that Amazon EFS is available in, except +// Africa (Cape Town), Asia Pacific (Hong Kong), Asia Pacific (Jakarta), +// Europe (Milan), and Middle East (Bahrain). Availability Zone - If you +// want the destination file system to use EFS One Zone availability and +// durability, you must specify the Availability Zone to create the file // system in. For more information about EFS storage classes, see Amazon // EFS storage classes (https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) // in the Amazon EFS User Guide. Encryption - All destination file systems -// are created with encryption at rest enabled. You can specify the KMS key -// that is used to encrypt the destination file system. Your service-managed -// KMS key for Amazon EFS is used if you don't specify a KMS key. You cannot -// change this after the file system is created. +// are created with encryption at rest enabled. You can specify the Key Management +// Service (KMS) key that is used to encrypt the destination file system. +// If you don't specify a KMS key, your service-managed KMS key for Amazon +// EFS is used. After the file system is created, you cannot change the KMS +// key. // // The following properties are set by default: // -// * Performance mode - The destination file system's performance mode will -// match that of the source file system, unless the destination file system -// uses One Zone storage. In that case, the General Purpose performance mode -// is used. The Performance mode cannot be changed. +// * Performance mode - The destination file system's performance mode matches +// that of the source file system, unless the destination file system uses +// EFS One Zone storage. In that case, the General Purpose performance mode +// is used. The performance mode cannot be changed. // -// * Throughput mode - The destination file system use the Bursting throughput -// mode by default. You can modify the throughput mode once the file system -// is created. +// * Throughput mode - The destination file system uses the Bursting Throughput +// mode by default. After the file system is created, you can modify the +// throughput mode. // // The following properties are turned off by default: // -// * Lifecycle management - EFS lifecycle management and intelligent tiering -// are not enabled on the destination file system. You can enable EFS lifecycle -// management and intelligent tiering after the destination file system is -// created. +// * Lifecycle management - EFS lifecycle management and EFS Intelligent-Tiering +// are not enabled on the destination file system. After the destination +// file system is created, you can enable EFS lifecycle management and EFS +// Intelligent-Tiering. // // * Automatic backups - Automatic daily backups not enabled on the destination -// file system. You can change this setting after the file system is created. +// file system. After the file system is created, you can change this setting. // -// For more information, see Amazon EFS replication (https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html). +// For more information, see Amazon EFS replication (https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) +// in the Amazon EFS User Guide. // // 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 @@ -621,7 +631,7 @@ func (c *EFS) CreateReplicationConfigurationRequest(input *CreateReplicationConf // Region in which the request was made. // // * ReplicationNotFound -// Returned if the specified file system did not have a replication configuration. +// Returned if the specified file system does not have a replication configuration. // // * FileSystemNotFound // Returned if the specified FileSystemId value doesn't exist in the requester's @@ -640,7 +650,8 @@ func (c *EFS) CreateReplicationConfigurationRequest(input *CreateReplicationConf // This value might be returned when you try to create a file system in provisioned // throughput mode, when you attempt to increase the provisioned throughput // of an existing file system, or when you attempt to change an existing file -// system from bursting to provisioned throughput mode. Try again later. +// system from Bursting Throughput to Provisioned Throughput mode. Try again +// later. // // * ThroughputLimitExceeded // Returned if the throughput mode or amount of provisioned throughput can't @@ -722,8 +733,8 @@ func (c *EFS) CreateTagsRequest(input *CreateTagsInput) (req *request.Request, o // CreateTags API operation for Amazon Elastic File System. // // -// DEPRECATED - CreateTags is deprecated and not maintained. Please use the -// API action to create tags for EFS resources. +// DEPRECATED - CreateTags is deprecated and not maintained. To create tags +// for EFS resources, use the API action. // // Creates or overwrites tags associated with a file system. Each tag is a key-value // pair. If a tag key specified in the request already exists on the file system, @@ -921,6 +932,13 @@ func (c *EFS) DeleteFileSystemRequest(input *DeleteFileSystemInput) (req *reques // return, the file system no longer exists and you can't access any contents // of the deleted file system. // +// You need to manually delete mount targets attached to a file system before +// you can delete an EFS file system. This step is performed for you when you +// use the Amazon Web Services console to delete a file system. +// +// You cannot delete a file system that is part of an EFS Replication configuration. +// You need to delete the replication configuration first. +// // You can't delete a file system that is in use. That is, if the file system // has any mount targets, you must first delete them. For more information, // see DescribeMountTargets and DeleteMountTarget. @@ -1239,8 +1257,9 @@ func (c *EFS) DeleteReplicationConfigurationRequest(input *DeleteReplicationConf // Deletes an existing replication configuration. To delete a replication configuration, // you must make the request from the Amazon Web Services Region in which the // destination file system is located. Deleting a replication configuration -// ends the replication process. You can write to the destination file system -// once it's status becomes Writeable. +// ends the replication process. After a replication configuration is deleted, +// the destination file system is no longer read-only. You can write to the +// destination file system after its status becomes Writeable. // // 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 @@ -1262,7 +1281,7 @@ func (c *EFS) DeleteReplicationConfigurationRequest(input *DeleteReplicationConf // Amazon Web Services account. // // * ReplicationNotFound -// Returned if the specified file system did not have a replication configuration. +// Returned if the specified file system does not have a replication configuration. // // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration func (c *EFS) DeleteReplicationConfiguration(input *DeleteReplicationConfigurationInput) (*DeleteReplicationConfigurationOutput, error) { @@ -1337,8 +1356,8 @@ func (c *EFS) DeleteTagsRequest(input *DeleteTagsInput) (req *request.Request, o // DeleteTags API operation for Amazon Elastic File System. // // -// DEPRECATED - DeleteTags is deprecated and not maintained. Please use the -// API action to remove tags from EFS resources. +// DEPRECATED - DeleteTags is deprecated and not maintained. To remove tags +// from EFS resources, use the API action. // // Deletes the specified tags from a file system. If the DeleteTags request // includes a tag key that doesn't exist, Amazon EFS ignores it and doesn't @@ -2038,7 +2057,7 @@ func (c *EFS) DescribeLifecycleConfigurationRequest(input *DescribeLifecycleConf // storage class. For a file system without a LifecycleConfiguration object, // the call returns an empty array in the response. // -// When EFS Intelligent Tiering is enabled, TransitionToPrimaryStorageClass +// When EFS Intelligent-Tiering is enabled, TransitionToPrimaryStorageClass // has a value of AFTER_1_ACCESS. // // This operation requires permissions for the elasticfilesystem:DescribeLifecycleConfiguration @@ -2330,9 +2349,9 @@ func (c *EFS) DescribeReplicationConfigurationsRequest(input *DescribeReplicatio // DescribeReplicationConfigurations API operation for Amazon Elastic File System. // -// Retrieves the replication configurations for either a specific file system, -// or all configurations for the Amazon Web Services account in an Amazon Web -// Services Region if a file system is not specified. +// Retrieves the replication configuration for a specific file system. If a +// file system is not specified, all of the replication configurations for the +// Amazon Web Services account in an Amazon Web Services Region are retrieved. // // 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 @@ -2354,7 +2373,7 @@ func (c *EFS) DescribeReplicationConfigurationsRequest(input *DescribeReplicatio // Returned if an error occurred on the server side. // // * ReplicationNotFound -// Returned if the specified file system did not have a replication configuration. +// Returned if the specified file system does not have a replication configuration. // // * ValidationException // Returned if the Backup service is not available in the Amazon Web Services @@ -2438,8 +2457,9 @@ func (c *EFS) DescribeTagsRequest(input *DescribeTagsInput) (req *request.Reques // DescribeTags API operation for Amazon Elastic File System. // // -// DEPRECATED - The DeleteTags action is deprecated and not maintained. Please -// use the API action to remove tags from EFS resources. +// DEPRECATED - The DescribeTags action is deprecated and not maintained. To +// view tags associated with EFS resources, use the ListTagsForResource API +// action. // // Returns the tags associated with a file system. The order of tags returned // in the response of one DescribeTags call and the order of tags returned across @@ -2792,7 +2812,7 @@ func (c *EFS) ModifyMountTargetSecurityGroupsRequest(input *ModifyMountTargetSec // // * SecurityGroupNotFound // Returned if one of the specified security groups doesn't exist in the subnet's -// VPC. +// virtual private cloud (VPC). // // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups func (c *EFS) ModifyMountTargetSecurityGroups(input *ModifyMountTargetSecurityGroupsInput) (*ModifyMountTargetSecurityGroupsOutput, error) { @@ -2869,8 +2889,8 @@ func (c *EFS) PutAccountPreferencesRequest(input *PutAccountPreferencesInput) (r // // Starting in October, 2021, you will receive an error if you try to set the // account preference to use the short 8 character format resource ID. Contact -// Amazon Web Services support if you receive an error and need to use short -// IDs for file system and mount target resources. +// Amazon Web Services support if you receive an error and must use short IDs +// for file system and mount target resources. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3082,9 +3102,9 @@ func (c *EFS) PutFileSystemPolicyRequest(input *PutFileSystemPolicyInput) (req * // Amazon Web Services account. // // * InvalidPolicyException -// Returned if the FileSystemPolicy is is malformed or contains an error such -// as an invalid parameter value or a missing required parameter. Returned in -// the case of a policy lockout safety check error. +// Returned if the FileSystemPolicy is malformed or contains an error such as +// a parameter value that is not valid or a missing required parameter. Returned +// in the case of a policy lockout safety check error. // // * IncorrectFileSystemLifeCycleState // Returned if the file system's lifecycle state is not "available". @@ -3155,29 +3175,40 @@ func (c *EFS) PutLifecycleConfigurationRequest(input *PutLifecycleConfigurationI // PutLifecycleConfiguration API operation for Amazon Elastic File System. // -// Enables lifecycle management by creating a new LifecycleConfiguration object. -// A LifecycleConfiguration object defines when files in an Amazon EFS file -// system are automatically transitioned to the lower-cost EFS Infrequent Access -// (IA) storage class. To enable EFS Intelligent Tiering, set the value of TransitionToPrimaryStorageClass -// to AFTER_1_ACCESS. For more information, see EFS Lifecycle Management (https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). +// Use this action to manage EFS lifecycle management and intelligent tiering. +// A LifecycleConfiguration consists of one or more LifecyclePolicy objects +// that define the following: +// +// * EFS Lifecycle management - When Amazon EFS automatically transitions +// files in a file system into the lower-cost Infrequent Access (IA) storage +// class. To enable EFS Lifecycle management, set the value of TransitionToIA +// to one of the available options. +// +// * EFS Intelligent tiering - When Amazon EFS automatically transitions +// files from IA back into the file system's primary storage class (Standard +// or One Zone Standard. To enable EFS Intelligent Tiering, set the value +// of TransitionToPrimaryStorageClass to AFTER_1_ACCESS. +// +// For more information, see EFS Lifecycle Management (https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). // // Each Amazon EFS file system supports one lifecycle configuration, which applies // to all files in the file system. If a LifecycleConfiguration object already // exists for the specified file system, a PutLifecycleConfiguration call modifies // the existing configuration. A PutLifecycleConfiguration call with an empty // LifecyclePolicies array in the request body deletes any existing LifecycleConfiguration -// and turns off lifecycle management for the file system. +// and turns off lifecycle management and intelligent tiering for the file system. // // In the request, specify the following: // // * The ID for the file system for which you are enabling, disabling, or -// modifying lifecycle management. +// modifying lifecycle management and intelligent tiering. // // * A LifecyclePolicies array of LifecyclePolicy objects that define when -// files are moved to the IA storage class. Amazon EFS requires that each -// LifecyclePolicy object have only have a single transition, so the LifecyclePolicies -// array needs to be structured with separate LifecyclePolicy objects. See -// the example requests in the following section for more information. +// files are moved into IA storage, and when they are moved back to Standard +// storage. Amazon EFS requires that each LifecyclePolicy object have only +// have a single transition, so the LifecyclePolicies array needs to be structured +// with separate LifecyclePolicy objects. See the example requests in the +// following section for more information. // // This operation requires permissions for the elasticfilesystem:PutLifecycleConfiguration // operation. @@ -3493,7 +3524,8 @@ func (c *EFS) UpdateFileSystemRequest(input *UpdateFileSystemInput) (req *reques // This value might be returned when you try to create a file system in provisioned // throughput mode, when you attempt to increase the provisioned throughput // of an existing file system, or when you attempt to change an existing file -// system from bursting to provisioned throughput mode. Try again later. +// system from Bursting Throughput to Provisioned Throughput mode. Try again +// later. // // * InternalServerError // Returned if an error occurred on the server side. @@ -3503,8 +3535,8 @@ func (c *EFS) UpdateFileSystemRequest(input *UpdateFileSystemInput) (req *reques // be changed because the throughput limit of 1024 MiB/s has been reached. // // * TooManyRequests -// Returned if you don’t wait at least 24 hours before changing the throughput -// mode, or decreasing the Provisioned Throughput value. +// Returned if you don’t wait at least 24 hours before either changing the +// throughput mode, or decreasing the Provisioned Throughput value. // // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/UpdateFileSystem func (c *EFS) UpdateFileSystem(input *UpdateFileSystemInput) (*UpdateFileSystemOutput, error) { @@ -3528,8 +3560,8 @@ func (c *EFS) UpdateFileSystemWithContext(ctx aws.Context, input *UpdateFileSyst return out, req.Send() } -// Returned if the access point you are trying to create already exists, with -// the creation token you provided in the request. +// Returned if the access point that you are trying to create already exists, +// with the creation token you provided in the request. type AccessPointAlreadyExists struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -3726,7 +3758,9 @@ func (s *AccessPointDescription) SetTags(v []*Tag) *AccessPointDescription { } // Returned if the Amazon Web Services account has already created the maximum -// number of access points allowed per file system. +// number of access points allowed per file system. For more informaton, see +// https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region +// (https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). type AccessPointLimitExceeded struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -3882,9 +3916,8 @@ func (s *AccessPointNotFound) RequestID() string { } // Returned if the Availability Zone that was specified for a mount target is -// different from the Availability Zone that was specified for One Zone storage -// classes. For more information, see Regional and One Zone storage redundancy -// (https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html). +// different from the Availability Zone that was specified for One Zone storage. +// For more information, see Regional and One Zone storage redundancy (https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html). type AvailabilityZonesMismatch struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -3971,7 +4004,7 @@ type BackupPolicy struct { // // * ENABLING - EFS is turning on automatic backups for the file system. // - // * DISABLED - automatic back ups are turned off for the file system. + // * DISABLED - Automatic back ups are turned off for the file system. // // * DISABLING - EFS is turning off automatic backups for the file system. // @@ -4115,8 +4148,8 @@ type CreateAccessPointInput struct { // access point. The clients using the access point can only access the root // directory and below. If the RootDirectory > Path specified does not exist, // EFS creates it and applies the CreationInfo settings when a client connects - // to an access point. When specifying a RootDirectory, you need to provide - // the Path, and the CreationInfo. + // to an access point. When specifying a RootDirectory, you must provide the + // Path, and the CreationInfo. // // Amazon EFS creates a root directory only if you have provided the CreationInfo: // OwnUid, OwnGID, and permissions for the directory. If you do not provide @@ -4369,7 +4402,7 @@ type CreateFileSystemInput struct { Encrypted *bool `type:"boolean"` // The ID of the KMS key that you want to use to protect the encrypted file - // system. This parameter is only required if you want to use a non-default + // system. This parameter is required only if you want to use a non-default // KMS key. If this parameter is not specified, the default KMS key for Amazon // EFS is used. You can specify a KMS key ID using the following formats: // @@ -4698,7 +4731,7 @@ type CreateReplicationConfigurationOutput struct { // CreationTime is a required field CreationTime *time.Time `type:"timestamp" required:"true"` - // Array of destination objects. Only one destination object is supported. + // An array of destination objects. Only one destination object is supported. // // Destinations is a required field Destinations []*Destination `type:"list" required:"true"` @@ -4709,7 +4742,8 @@ type CreateReplicationConfigurationOutput struct { // OriginalSourceFileSystemArn is a required field OriginalSourceFileSystemArn *string `type:"string" required:"true"` - // The ARN of the current source file system in the replication configuration. + // The Amazon Resource Name (ARN) of the current source file system in the replication + // configuration. // // SourceFileSystemArn is a required field SourceFileSystemArn *string `type:"string" required:"true"` @@ -5767,7 +5801,7 @@ type DescribeBackupPolicyOutput struct { _ struct{} `type:"structure"` // Describes the file system's backup policy, indicating whether automatic backups - // are turned on or off.. + // are turned on or off. BackupPolicy *BackupPolicy `type:"structure"` } @@ -6334,15 +6368,15 @@ func (s *DescribeMountTargetsOutput) SetNextMarker(v string) *DescribeMountTarge type DescribeReplicationConfigurationsInput struct { _ struct{} `type:"structure" nopayload:"true"` - // You can retrieve replication configurations for a specific file system by - // providing a file system ID. + // You can retrieve the replication configuration for a specific file system + // by providing its file system ID. FileSystemId *string `location:"querystring" locationName:"FileSystemId" type:"string"` - // (Optional) You can optionally specify the MaxItems parameter to limit the - // number of objects returned in a response. The default value is 100. + // (Optional) To limit the number of objects returned in a response, you can + // specify the MaxItems parameter. The default value is 100. MaxResults *int64 `location:"querystring" locationName:"MaxResults" min:"1" type:"integer"` - // NextToken is present if the response is paginated. You can use NextMarker + // NextToken is present if the response is paginated. You can use NextToken // in a subsequent request to fetch the next page of output. NextToken *string `location:"querystring" locationName:"NextToken" min:"1" type:"string"` } @@ -6406,7 +6440,7 @@ type DescribeReplicationConfigurationsOutput struct { // to fetch the additional descriptions. NextToken *string `min:"1" type:"string"` - // The collection of replication configurations returned. + // The collection of replication configurations that is returned. Replications []*ReplicationConfigurationDescription `type:"list"` } @@ -6581,10 +6615,10 @@ type Destination struct { // FileSystemId is a required field FileSystemId *string `type:"string" required:"true"` - // The time when the most recent sync successfully completed on the destination + // The time when the most recent sync was successfully completed on the destination // file system. Any changes to data on the source file system that occurred - // prior to this time were successfully replicated to the destination file system. - // Any changes that occurred after this time might not be fully replicated. + // before this time have been successfully replicated to the destination file + // system. Any changes that occurred after this time might not be fully replicated. LastReplicatedTimestamp *time.Time `type:"timestamp"` // The Amazon Web Services Region in which the destination file system is located. @@ -6592,7 +6626,10 @@ type Destination struct { // Region is a required field Region *string `min:"1" type:"string" required:"true"` - // Describes the status of the destination Amazon EFS file system. + // Describes the status of the destination Amazon EFS file system. If the status + // is ERROR, the destination file system in the replication configuration is + // in a failed state and is unrecoverable. To access the file system data, restore + // a backup of the failed file system to a new file system. // // Status is a required field Status *string `type:"string" required:"true" enum:"ReplicationStatus"` @@ -6644,25 +6681,26 @@ func (s *Destination) SetStatus(v string) *Destination { type DestinationToCreate struct { _ struct{} `type:"structure"` - // To create a file system that uses One Zone storage, specify the name of the - // Availability Zone in which to create the destination file system. + // To create a file system that uses EFS One Zone storage, specify the name + // of the Availability Zone in which to create the destination file system. AvailabilityZoneName *string `min:"1" type:"string"` - // Specifies the KMS key you want to use to encrypt the destination file system. - // If you do not specify a KMS key, EFS uses your default KMS key for Amazon - // EFS, /aws/elasticfilesystem. This ID can be in one of the following formats: + // Specifies the Key Management Service (KMS) key that you want to use to encrypt + // the destination file system. If you do not specify a KMS key, Amazon EFS + // uses your default KMS key for Amazon EFS, /aws/elasticfilesystem. This ID + // can be in one of the following formats: // - // * Key ID - A unique identifier of the key, for example 1234abcd-12ab-34cd-56ef-1234567890ab. + // * Key ID - The unique identifier of the key, for example 1234abcd-12ab-34cd-56ef-1234567890ab. // - // * ARN - An Amazon Resource Name (ARN) for the key, for example arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab. + // * ARN - The Amazon Resource Name (ARN) for the key, for example arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab. // // * Key alias - A previously created display name for a key, for example // alias/projectKey1. // - // * Key alias ARN - An ARN for a key alias, for example arn:aws:kms:us-west-2:444455556666:alias/projectKey1. + // * Key alias ARN - The ARN for a key alias, for example arn:aws:kms:us-west-2:444455556666:alias/projectKey1. KmsKeyId *string `type:"string"` - // To create a file system that uses regional storage, specify the Amazon Web + // To create a file system that uses Regional storage, specify the Amazon Web // Services Region in which to create the destination file system. Region *string `min:"1" type:"string"` } @@ -7479,7 +7517,8 @@ func (s *IncorrectMountTargetState) RequestID() string { // This value might be returned when you try to create a file system in provisioned // throughput mode, when you attempt to increase the provisioned throughput // of an existing file system, or when you attempt to change an existing file -// system from bursting to provisioned throughput mode. Try again later. +// system from Bursting Throughput to Provisioned Throughput mode. Try again +// later. type InsufficientThroughputCapacity struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -7633,9 +7672,9 @@ func (s *InternalServerError) RequestID() string { return s.RespMetadata.RequestID } -// Returned if the FileSystemPolicy is is malformed or contains an error such -// as an invalid parameter value or a missing required parameter. Returned in -// the case of a policy lockout safety check error. +// Returned if the FileSystemPolicy is malformed or contains an error such as +// a parameter value that is not valid or a missing required parameter. Returned +// in the case of a policy lockout safety check error. type InvalidPolicyException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -7788,7 +7827,7 @@ func (s *IpAddressInUse) RequestID() string { return s.RespMetadata.RequestID } -// Describes a policy used by EFS lifecycle management and EFS intelligent tiering +// Describes a policy used by EFS lifecycle management and EFS Intelligent-Tiering // that specifies when to transition files into and out of the file system's // Infrequent Access (IA) storage class. For more information, see EFS Intelligent‐Tiering // and EFS Lifecycle Management (https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). @@ -7796,9 +7835,9 @@ func (s *IpAddressInUse) RequestID() string { // When using the put-lifecycle-configuration CLI command or the PutLifecycleConfiguration // API action, Amazon EFS requires that each LifecyclePolicy object have only // a single transition. This means that in a request body, LifecyclePolicies -// needs to be structured as an array of LifecyclePolicy objects, one object -// for each transition, TransitionToIA, TransitionToPrimaryStorageClass. For -// more information, see the request examples in PutLifecycleConfiguration. +// must be structured as an array of LifecyclePolicy objects, one object for +// each transition, TransitionToIA, TransitionToPrimaryStorageClass. For more +// information, see the request examples in PutLifecycleConfiguration. type LifecyclePolicy struct { _ struct{} `type:"structure"` @@ -8325,11 +8364,11 @@ func (s *MountTargetNotFound) RequestID() string { } // The calling account has reached the limit for elastic network interfaces -// for the specific Amazon Web Services Region. The client should try to delete -// some elastic network interfaces or get the account limit raised. For more -// information, see Amazon VPC Limits (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html) -// in the Amazon VPC User Guide (see the Network interfaces per VPC entry in -// the table). +// for the specific Amazon Web Services Region. Either delete some network interfaces +// or request that the account quota be raised. For more information, see Amazon +// VPC Quotas (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html) +// in the Amazon VPC User Guide (see the Network interfaces per Region entry +// in the Network interfaces table). type NetworkInterfaceLimitExceeded struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -8643,7 +8682,7 @@ type PutAccountPreferencesInput struct { // // Starting in October, 2021, you will receive an error when setting the account // preference to SHORT_ID. Contact Amazon Web Services support if you receive - // an error and need to use short IDs for file system and mount target resources. + // an error and must use short IDs for file system and mount target resources. // // ResourceIdType is a required field ResourceIdType *string `type:"string" required:"true" enum:"ResourceIdType"` @@ -8790,7 +8829,7 @@ type PutBackupPolicyOutput struct { _ struct{} `type:"structure"` // Describes the file system's backup policy, indicating whether automatic backups - // are turned on or off.. + // are turned on or off. BackupPolicy *BackupPolicy `type:"structure"` } @@ -8821,13 +8860,13 @@ func (s *PutBackupPolicyOutput) SetBackupPolicy(v *BackupPolicy) *PutBackupPolic type PutFileSystemPolicyInput struct { _ struct{} `type:"structure"` - // (Optional) A flag to indicate whether to bypass the FileSystemPolicy lockout - // safety check. The policy lockout safety check determines whether the policy - // in the request will prevent the principal making the request will be locked - // out from making future PutFileSystemPolicy requests on the file system. Set - // BypassPolicyLockoutSafetyCheck to True only when you intend to prevent the - // principal that is making the request from making a subsequent PutFileSystemPolicy - // request on the file system. The default value is False. + // (Optional) A boolean that specifies whether or not to bypass the FileSystemPolicy + // lockout safety check. The lockout safety check determines whether the policy + // in the request will lock out, or prevent, the IAM principal that is making + // the request from making future PutFileSystemPolicy requests on this file + // system. Set BypassPolicyLockoutSafetyCheck to True only when you intend to + // prevent the IAM principal that is making the request from making subsequent + // PutFileSystemPolicy requests on this file system. The default value is False. BypassPolicyLockoutSafetyCheck *bool `type:"boolean"` // The ID of the EFS file system that you want to create or update the FileSystemPolicy @@ -8954,7 +8993,7 @@ type PutLifecycleConfigurationInput struct { // An array of LifecyclePolicy objects that define the file system's LifecycleConfiguration // object. A LifecycleConfiguration object informs EFS lifecycle management - // and intelligent tiering of the following: + // and EFS Intelligent-Tiering of the following: // // * When to move files in the file system from primary storage to the IA // storage class. @@ -8964,9 +9003,9 @@ type PutLifecycleConfigurationInput struct { // When using the put-lifecycle-configuration CLI command or the PutLifecycleConfiguration // API action, Amazon EFS requires that each LifecyclePolicy object have only // a single transition. This means that in a request body, LifecyclePolicies - // needs to be structured as an array of LifecyclePolicy objects, one object - // for each transition, TransitionToIA, TransitionToPrimaryStorageClass. See - // the example requests in the following section for more information. + // must be structured as an array of LifecyclePolicy objects, one object for + // each transition, TransitionToIA, TransitionToPrimaryStorageClass. See the + // example requests in the following section for more information. // // LifecyclePolicies is a required field LifecyclePolicies []*LifecyclePolicy `type:"list" required:"true"` @@ -9061,7 +9100,7 @@ type ReplicationConfigurationDescription struct { // CreationTime is a required field CreationTime *time.Time `type:"timestamp" required:"true"` - // Array of destination objects. Only one destination object is supported. + // An array of destination objects. Only one destination object is supported. // // Destinations is a required field Destinations []*Destination `type:"list" required:"true"` @@ -9072,7 +9111,8 @@ type ReplicationConfigurationDescription struct { // OriginalSourceFileSystemArn is a required field OriginalSourceFileSystemArn *string `type:"string" required:"true"` - // The ARN of the current source file system in the replication configuration. + // The Amazon Resource Name (ARN) of the current source file system in the replication + // configuration. // // SourceFileSystemArn is a required field SourceFileSystemArn *string `type:"string" required:"true"` @@ -9143,7 +9183,7 @@ func (s *ReplicationConfigurationDescription) SetSourceFileSystemRegion(v string return s } -// Returned if the specified file system did not have a replication configuration. +// Returned if the specified file system does not have a replication configuration. type ReplicationNotFound struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -9413,7 +9453,7 @@ func (s *SecurityGroupLimitExceeded) RequestID() string { } // Returned if one of the specified security groups doesn't exist in the subnet's -// VPC. +// virtual private cloud (VPC). type SecurityGroupNotFound struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -9728,6 +9768,82 @@ func (s TagResourceOutput) GoString() string { return s.String() } +// Returned when the CreateAccessPoint API action is called too quickly and +// the number of Access Points in the account is nearing the limit of 120. +type ThrottlingException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + // The error code is a string that uniquely identifies an error condition. It + // is meant to be read and understood by programs that detect and handle errors + // by type. + ErrorCode *string `min:"1" type:"string"` + + // The error message contains a generic description of the error condition in + // English. It is intended for a human audience. Simple programs display the + // message directly to the end user if they encounter an error condition they + // don't know how or don't care to handle. Sophisticated programs with more + // exhaustive error handling and proper internationalization are more likely + // to ignore the error message. + Message_ *string `locationName:"Message" 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 ThrottlingException) 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 ThrottlingException) GoString() string { + return s.String() +} + +func newErrorThrottlingException(v protocol.ResponseMetadata) error { + return &ThrottlingException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *ThrottlingException) Code() string { + return "ThrottlingException" +} + +// Message returns the exception's message. +func (s *ThrottlingException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *ThrottlingException) OrigErr() error { + return nil +} + +func (s *ThrottlingException) Error() string { + return fmt.Sprintf("%s: %s\n%s", s.Code(), s.Message(), s.String()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *ThrottlingException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *ThrottlingException) RequestID() string { + return s.RespMetadata.RequestID +} + // Returned if the throughput mode or amount of provisioned throughput can't // be changed because the throughput limit of 1024 MiB/s has been reached. type ThroughputLimitExceeded struct { @@ -9806,8 +9922,8 @@ func (s *ThroughputLimitExceeded) RequestID() string { return s.RespMetadata.RequestID } -// Returned if you don’t wait at least 24 hours before changing the throughput -// mode, or decreasing the Provisioned Throughput value. +// Returned if you don’t wait at least 24 hours before either changing the +// throughput mode, or decreasing the Provisioned Throughput value. type TooManyRequests struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` diff --git a/service/efs/doc.go b/service/efs/doc.go index 0686cc0e421..2184ca29b98 100644 --- a/service/efs/doc.go +++ b/service/efs/doc.go @@ -6,8 +6,8 @@ // Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage // for use with Amazon EC2 Linux and Mac instances in the Amazon Web Services // Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking -// automatically as you add and remove files, so your applications have the -// storage they need, when they need it. For more information, see the Amazon +// automatically as you add and remove files, so that your applications have +// the storage they need, when they need it. For more information, see the Amazon // Elastic File System API Reference (https://docs.aws.amazon.com/efs/latest/ug/api-reference.html) // and the Amazon Elastic File System User Guide (https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html). // diff --git a/service/efs/errors.go b/service/efs/errors.go index 1f689e302b9..f351ce9c8c6 100644 --- a/service/efs/errors.go +++ b/service/efs/errors.go @@ -11,15 +11,17 @@ const ( // ErrCodeAccessPointAlreadyExists for service response error code // "AccessPointAlreadyExists". // - // Returned if the access point you are trying to create already exists, with - // the creation token you provided in the request. + // Returned if the access point that you are trying to create already exists, + // with the creation token you provided in the request. ErrCodeAccessPointAlreadyExists = "AccessPointAlreadyExists" // ErrCodeAccessPointLimitExceeded for service response error code // "AccessPointLimitExceeded". // // Returned if the Amazon Web Services account has already created the maximum - // number of access points allowed per file system. + // number of access points allowed per file system. For more informaton, see + // https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region + // (https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ErrCodeAccessPointLimitExceeded = "AccessPointLimitExceeded" // ErrCodeAccessPointNotFound for service response error code @@ -33,9 +35,8 @@ const ( // "AvailabilityZonesMismatch". // // Returned if the Availability Zone that was specified for a mount target is - // different from the Availability Zone that was specified for One Zone storage - // classes. For more information, see Regional and One Zone storage redundancy - // (https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html). + // different from the Availability Zone that was specified for One Zone storage. + // For more information, see Regional and One Zone storage redundancy (https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html). ErrCodeAvailabilityZonesMismatch = "AvailabilityZonesMismatch" // ErrCodeBadRequest for service response error code @@ -98,7 +99,8 @@ const ( // This value might be returned when you try to create a file system in provisioned // throughput mode, when you attempt to increase the provisioned throughput // of an existing file system, or when you attempt to change an existing file - // system from bursting to provisioned throughput mode. Try again later. + // system from Bursting Throughput to Provisioned Throughput mode. Try again + // later. ErrCodeInsufficientThroughputCapacity = "InsufficientThroughputCapacity" // ErrCodeInternalServerError for service response error code @@ -110,9 +112,9 @@ const ( // ErrCodeInvalidPolicyException for service response error code // "InvalidPolicyException". // - // Returned if the FileSystemPolicy is is malformed or contains an error such - // as an invalid parameter value or a missing required parameter. Returned in - // the case of a policy lockout safety check error. + // Returned if the FileSystemPolicy is malformed or contains an error such as + // a parameter value that is not valid or a missing required parameter. Returned + // in the case of a policy lockout safety check error. ErrCodeInvalidPolicyException = "InvalidPolicyException" // ErrCodeIpAddressInUse for service response error code @@ -140,11 +142,11 @@ const ( // "NetworkInterfaceLimitExceeded". // // The calling account has reached the limit for elastic network interfaces - // for the specific Amazon Web Services Region. The client should try to delete - // some elastic network interfaces or get the account limit raised. For more - // information, see Amazon VPC Limits (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html) - // in the Amazon VPC User Guide (see the Network interfaces per VPC entry in - // the table). + // for the specific Amazon Web Services Region. Either delete some network interfaces + // or request that the account quota be raised. For more information, see Amazon + // VPC Quotas (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html) + // in the Amazon VPC User Guide (see the Network interfaces per Region entry + // in the Network interfaces table). ErrCodeNetworkInterfaceLimitExceeded = "NetworkInterfaceLimitExceeded" // ErrCodeNoFreeAddressesInSubnet for service response error code @@ -164,7 +166,7 @@ const ( // ErrCodeReplicationNotFound for service response error code // "ReplicationNotFound". // - // Returned if the specified file system did not have a replication configuration. + // Returned if the specified file system does not have a replication configuration. ErrCodeReplicationNotFound = "ReplicationNotFound" // ErrCodeSecurityGroupLimitExceeded for service response error code @@ -178,7 +180,7 @@ const ( // "SecurityGroupNotFound". // // Returned if one of the specified security groups doesn't exist in the subnet's - // VPC. + // virtual private cloud (VPC). ErrCodeSecurityGroupNotFound = "SecurityGroupNotFound" // ErrCodeSubnetNotFound for service response error code @@ -187,6 +189,13 @@ const ( // Returned if there is no subnet with ID SubnetId provided in the request. ErrCodeSubnetNotFound = "SubnetNotFound" + // ErrCodeThrottlingException for service response error code + // "ThrottlingException". + // + // Returned when the CreateAccessPoint API action is called too quickly and + // the number of Access Points in the account is nearing the limit of 120. + ErrCodeThrottlingException = "ThrottlingException" + // ErrCodeThroughputLimitExceeded for service response error code // "ThroughputLimitExceeded". // @@ -197,8 +206,8 @@ const ( // ErrCodeTooManyRequests for service response error code // "TooManyRequests". // - // Returned if you don’t wait at least 24 hours before changing the throughput - // mode, or decreasing the Provisioned Throughput value. + // Returned if you don’t wait at least 24 hours before either changing the + // throughput mode, or decreasing the Provisioned Throughput value. ErrCodeTooManyRequests = "TooManyRequests" // ErrCodeUnsupportedAvailabilityZone for service response error code @@ -242,6 +251,7 @@ var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ "SecurityGroupLimitExceeded": newErrorSecurityGroupLimitExceeded, "SecurityGroupNotFound": newErrorSecurityGroupNotFound, "SubnetNotFound": newErrorSubnetNotFound, + "ThrottlingException": newErrorThrottlingException, "ThroughputLimitExceeded": newErrorThroughputLimitExceeded, "TooManyRequests": newErrorTooManyRequests, "UnsupportedAvailabilityZone": newErrorUnsupportedAvailabilityZone, diff --git a/service/iottwinmaker/api.go b/service/iottwinmaker/api.go index c8b01664d99..7985f5f6947 100644 --- a/service/iottwinmaker/api.go +++ b/service/iottwinmaker/api.go @@ -151,8 +151,6 @@ func (c *IoTTwinMaker) CreateComponentTypeRequest(input *CreateComponentTypeInpu // // Creates a component type. // -// TwinMaker is in public preview and is subject to change. -// // 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. @@ -4199,7 +4197,8 @@ func (s *CreateWorkspaceOutput) SetCreationDateTime(v time.Time) *CreateWorkspac type DataConnector struct { _ struct{} `type:"structure"` - // A Boolean value that specifies whether the data connector is native to TwinMaker. + // A Boolean value that specifies whether the data connector is native to IoT + // TwinMaker. IsNative *bool `locationName:"isNative" type:"boolean"` // The Lambda function associated with this data connector. @@ -5669,8 +5668,11 @@ type GetPropertyValueHistoryInput struct { // The date and time of the latest property value to return. // - // EndDateTime is a required field - EndDateTime *time.Time `locationName:"endDateTime" type:"timestamp" required:"true"` + // Deprecated: This field is deprecated and will throw an error in the future. Use endTime instead. + EndDateTime *time.Time `locationName:"endDateTime" deprecated:"true" type:"timestamp"` + + // Timestamp represented in ISO 8601 format + EndTime *string `locationName:"endTime" min:"20" type:"string"` // The ID of the entity. EntityId *string `locationName:"entityId" min:"1" type:"string"` @@ -5698,8 +5700,11 @@ type GetPropertyValueHistoryInput struct { // The date and time of the earliest property value to return. // - // StartDateTime is a required field - StartDateTime *time.Time `locationName:"startDateTime" type:"timestamp" required:"true"` + // Deprecated: This field is deprecated and will throw an error in the future. Use startTime instead. + StartDateTime *time.Time `locationName:"startDateTime" deprecated:"true" type:"timestamp"` + + // Timestamp represented in ISO 8601 format + StartTime *string `locationName:"startTime" min:"20" type:"string"` // The ID of the workspace. // @@ -5734,8 +5739,8 @@ func (s *GetPropertyValueHistoryInput) Validate() error { if s.ComponentTypeId != nil && len(*s.ComponentTypeId) < 1 { invalidParams.Add(request.NewErrParamMinLen("ComponentTypeId", 1)) } - if s.EndDateTime == nil { - invalidParams.Add(request.NewErrParamRequired("EndDateTime")) + if s.EndTime != nil && len(*s.EndTime) < 20 { + invalidParams.Add(request.NewErrParamMinLen("EndTime", 20)) } if s.EntityId != nil && len(*s.EntityId) < 1 { invalidParams.Add(request.NewErrParamMinLen("EntityId", 1)) @@ -5749,8 +5754,8 @@ func (s *GetPropertyValueHistoryInput) Validate() error { if s.SelectedProperties != nil && len(s.SelectedProperties) < 1 { invalidParams.Add(request.NewErrParamMinLen("SelectedProperties", 1)) } - if s.StartDateTime == nil { - invalidParams.Add(request.NewErrParamRequired("StartDateTime")) + if s.StartTime != nil && len(*s.StartTime) < 20 { + invalidParams.Add(request.NewErrParamMinLen("StartTime", 20)) } if s.WorkspaceId == nil { invalidParams.Add(request.NewErrParamRequired("WorkspaceId")) @@ -5793,6 +5798,12 @@ func (s *GetPropertyValueHistoryInput) SetEndDateTime(v time.Time) *GetPropertyV return s } +// SetEndTime sets the EndTime field's value. +func (s *GetPropertyValueHistoryInput) SetEndTime(v string) *GetPropertyValueHistoryInput { + s.EndTime = &v + return s +} + // SetEntityId sets the EntityId field's value. func (s *GetPropertyValueHistoryInput) SetEntityId(v string) *GetPropertyValueHistoryInput { s.EntityId = &v @@ -5841,6 +5852,12 @@ func (s *GetPropertyValueHistoryInput) SetStartDateTime(v time.Time) *GetPropert return s } +// SetStartTime sets the StartTime field's value. +func (s *GetPropertyValueHistoryInput) SetStartTime(v string) *GetPropertyValueHistoryInput { + s.StartTime = &v + return s +} + // SetWorkspaceId sets the WorkspaceId field's value. func (s *GetPropertyValueHistoryInput) SetWorkspaceId(v string) *GetPropertyValueHistoryInput { s.WorkspaceId = &v @@ -6722,6 +6739,10 @@ type ListEntitiesFilter struct { // The ID of the component type in the entities in the list. ComponentTypeId *string `locationName:"componentTypeId" min:"1" type:"string"` + // The external-Id property of a component. The external-Id property is the + // primary key of an external storage system. + ExternalId *string `locationName:"externalId" min:"1" type:"string"` + // The parent of the entities in the list. ParentEntityId *string `locationName:"parentEntityId" min:"1" type:"string"` } @@ -6750,6 +6771,9 @@ func (s *ListEntitiesFilter) Validate() error { if s.ComponentTypeId != nil && len(*s.ComponentTypeId) < 1 { invalidParams.Add(request.NewErrParamMinLen("ComponentTypeId", 1)) } + if s.ExternalId != nil && len(*s.ExternalId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ExternalId", 1)) + } if s.ParentEntityId != nil && len(*s.ParentEntityId) < 1 { invalidParams.Add(request.NewErrParamMinLen("ParentEntityId", 1)) } @@ -6766,6 +6790,12 @@ func (s *ListEntitiesFilter) SetComponentTypeId(v string) *ListEntitiesFilter { return s } +// SetExternalId sets the ExternalId field's value. +func (s *ListEntitiesFilter) SetExternalId(v string) *ListEntitiesFilter { + s.ExternalId = &v + return s +} + // SetParentEntityId sets the ParentEntityId field's value. func (s *ListEntitiesFilter) SetParentEntityId(v string) *ListEntitiesFilter { s.ParentEntityId = &v @@ -7723,10 +7753,13 @@ func (s *PropertyResponse) SetValue(v *DataValue) *PropertyResponse { type PropertyValue struct { _ struct{} `type:"structure"` + // Timestamp represented in ISO 8601 format + Time *string `locationName:"time" min:"20" type:"string"` + // The timestamp of a value for a time series property. // - // Timestamp is a required field - Timestamp *time.Time `locationName:"timestamp" type:"timestamp" required:"true"` + // Deprecated: This field is deprecated and will throw an error in the future. Use time instead. + Timestamp *time.Time `locationName:"timestamp" deprecated:"true" type:"timestamp"` // An object that specifies a value for a time series property. // @@ -7755,8 +7788,8 @@ func (s PropertyValue) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *PropertyValue) Validate() error { invalidParams := request.ErrInvalidParams{Context: "PropertyValue"} - if s.Timestamp == nil { - invalidParams.Add(request.NewErrParamRequired("Timestamp")) + if s.Time != nil && len(*s.Time) < 20 { + invalidParams.Add(request.NewErrParamMinLen("Time", 20)) } if s.Value == nil { invalidParams.Add(request.NewErrParamRequired("Value")) @@ -7773,6 +7806,12 @@ func (s *PropertyValue) Validate() error { return nil } +// SetTime sets the Time field's value. +func (s *PropertyValue) SetTime(v string) *PropertyValue { + s.Time = &v + return s +} + // SetTimestamp sets the Timestamp field's value. func (s *PropertyValue) SetTimestamp(v time.Time) *PropertyValue { s.Timestamp = &v @@ -9393,6 +9432,9 @@ const ( // PropertyUpdateTypeDelete is a PropertyUpdateType enum value PropertyUpdateTypeDelete = "DELETE" + + // PropertyUpdateTypeCreate is a PropertyUpdateType enum value + PropertyUpdateTypeCreate = "CREATE" ) // PropertyUpdateType_Values returns all elements of the PropertyUpdateType enum @@ -9400,6 +9442,7 @@ func PropertyUpdateType_Values() []string { return []string{ PropertyUpdateTypeUpdate, PropertyUpdateTypeDelete, + PropertyUpdateTypeCreate, } } diff --git a/service/iottwinmaker/doc.go b/service/iottwinmaker/doc.go index 3fe367323fa..e2766d6d88a 100644 --- a/service/iottwinmaker/doc.go +++ b/service/iottwinmaker/doc.go @@ -3,9 +3,6 @@ // Package iottwinmaker provides the client and types for making API // requests to AWS IoT TwinMaker. // -// -// TwinMaker is in public preview and is subject to change. -// // IoT TwinMaker is a service that enables you to build operational digital // twins of physical systems. IoT TwinMaker overlays measurements and analysis // from real-world sensors, cameras, and enterprise applications so you can