From 96ef35081030e7257a5b57cc5536b5fa88720008 Mon Sep 17 00:00:00 2001 From: AWS SDK for Go v2 automation user Date: Fri, 31 Mar 2023 18:13:31 +0000 Subject: [PATCH] Regenerated Clients --- .../2dc9fba6d49d4a05bcf78d1a4daa689b.json | 8 + .../5e1218250e9244bda046ab112d5ff028.json | 8 + .../7e4456b418b6488dbda1b4d1fe92f526.json | 8 + .../91a7e21b17f741ae912ce70e307cdf3b.json | 8 + .../d3e5a716746049b4bdf3b78e4f960473.json | 8 + .../ff32ac085f4b4d98877afdf99570f12e.json | 8 + .../acmpca/internal/endpoints/endpoints.go | 9 ++ .../api_op_GetGroupsForCapacityReservation.go | 4 +- service/ec2/api_op_RunInstances.go | 9 +- .../internal/endpoints/endpoints.go | 60 +++++++ .../internal/endpoints/endpoints.go | 60 +++++++ .../internetmonitor/api_op_CreateMonitor.go | 34 +++- service/internetmonitor/api_op_GetMonitor.go | 14 +- .../internetmonitor/api_op_UpdateMonitor.go | 21 ++- service/internetmonitor/deserializers.go | 99 ++++++++++++ service/internetmonitor/doc.go | 43 +++-- service/internetmonitor/serializers.go | 51 ++++++ service/internetmonitor/types/enums.go | 18 +++ service/internetmonitor/types/types.go | 68 +++++--- .../internal/endpoints/endpoints.go | 45 ++++++ ...i_op_AddDraftAppVersionResourceMappings.go | 8 +- service/resiliencehub/api_op_CreateApp.go | 12 +- .../api_op_CreateAppVersionAppComponent.go | 10 +- .../api_op_CreateAppVersionResource.go | 14 +- service/resiliencehub/api_op_DeleteApp.go | 8 +- .../api_op_DeleteAppInputSource.go | 8 +- .../api_op_DeleteAppVersionAppComponent.go | 10 +- .../api_op_DeleteAppVersionResource.go | 10 +- service/resiliencehub/api_op_DescribeApp.go | 4 +- .../api_op_DescribeAppVersion.go | 17 +- .../api_op_DescribeAppVersionAppComponent.go | 12 +- .../api_op_DescribeAppVersionResource.go | 12 +- ...ribeAppVersionResourcesResolutionStatus.go | 8 +- .../api_op_DescribeAppVersionTemplate.go | 101 +++++++----- ...ibeDraftAppVersionResourcesImportStatus.go | 8 +- ...api_op_ImportResourcesToDraftAppVersion.go | 8 +- .../api_op_ListAppAssessments.go | 4 +- .../api_op_ListAppInputSources.go | 6 +- .../api_op_ListAppVersionAppComponents.go | 14 +- .../api_op_ListAppVersionResourceMappings.go | 4 +- .../api_op_ListAppVersionResources.go | 4 +- .../resiliencehub/api_op_ListAppVersions.go | 4 +- service/resiliencehub/api_op_ListApps.go | 4 +- ...i_op_ListUnsupportedAppVersionResources.go | 4 +- .../resiliencehub/api_op_PublishAppVersion.go | 8 +- .../api_op_PutDraftAppVersionTemplate.go | 101 +++++++----- ...p_RemoveDraftAppVersionResourceMappings.go | 8 +- .../api_op_ResolveAppVersionResources.go | 8 +- .../api_op_StartAppAssessment.go | 4 +- service/resiliencehub/api_op_UpdateApp.go | 4 +- .../resiliencehub/api_op_UpdateAppVersion.go | 20 ++- .../api_op_UpdateAppVersionAppComponent.go | 10 +- .../api_op_UpdateAppVersionResource.go | 14 +- service/resiliencehub/types/types.go | 36 +++-- service/s3/api_op_AbortMultipartUpload.go | 14 +- service/s3/api_op_CompleteMultipartUpload.go | 52 +++--- service/s3/api_op_CopyObject.go | 115 +++++++------ service/s3/api_op_CreateMultipartUpload.go | 128 ++++++++------- service/s3/api_op_DeleteBucketEncryption.go | 7 +- ...api_op_DeleteBucketMetricsConfiguration.go | 3 +- service/s3/api_op_DeleteObject.go | 30 ++-- service/s3/api_op_DeleteObjectTagging.go | 16 +- service/s3/api_op_DeleteObjects.go | 14 +- service/s3/api_op_GetBucketAcl.go | 11 +- service/s3/api_op_GetBucketCors.go | 5 +- service/s3/api_op_GetBucketEncryption.go | 16 +- service/s3/api_op_GetBucketLocation.go | 9 +- service/s3/api_op_GetBucketLogging.go | 4 +- .../api_op_GetBucketMetricsConfiguration.go | 3 +- ...i_op_GetBucketNotificationConfiguration.go | 7 +- service/s3/api_op_GetBucketPolicy.go | 5 +- service/s3/api_op_GetObject.go | 39 ++--- service/s3/api_op_GetObjectAttributes.go | 55 ++++--- service/s3/api_op_GetObjectTagging.go | 14 +- service/s3/api_op_GetObjectTorrent.go | 13 +- service/s3/api_op_HeadBucket.go | 24 +-- service/s3/api_op_HeadObject.go | 35 ++-- service/s3/api_op_ListBuckets.go | 5 +- service/s3/api_op_ListMultipartUploads.go | 14 +- service/s3/api_op_ListObjects.go | 14 +- service/s3/api_op_ListObjectsV2.go | 32 ++-- service/s3/api_op_ListParts.go | 14 +- service/s3/api_op_PutBucketAcl.go | 12 +- service/s3/api_op_PutBucketEncryption.go | 24 +-- .../api_op_PutBucketInventoryConfiguration.go | 20 ++- .../api_op_PutBucketMetricsConfiguration.go | 3 +- service/s3/api_op_PutObject.go | 153 +++++++++--------- service/s3/api_op_PutObjectAcl.go | 14 +- service/s3/api_op_PutObjectTagging.go | 14 +- service/s3/api_op_RestoreObject.go | 144 +++++++---------- service/s3/api_op_SelectObjectContent.go | 11 +- service/s3/api_op_UploadPart.go | 47 +++--- service/s3/api_op_UploadPartCopy.go | 18 +-- service/s3/api_op_WriteGetObjectResponse.go | 4 +- service/s3/types/enums.go | 31 ++++ service/s3/types/types.go | 76 ++++++--- .../api_op_DeleteRecord.go | 25 ++- .../serializers.go | 4 + .../types/enums.go | 18 +++ .../types/types.go | 6 +- .../internal/endpoints/endpoints.go | 12 ++ 101 files changed, 1562 insertions(+), 862 deletions(-) create mode 100644 .changelog/2dc9fba6d49d4a05bcf78d1a4daa689b.json create mode 100644 .changelog/5e1218250e9244bda046ab112d5ff028.json create mode 100644 .changelog/7e4456b418b6488dbda1b4d1fe92f526.json create mode 100644 .changelog/91a7e21b17f741ae912ce70e307cdf3b.json create mode 100644 .changelog/d3e5a716746049b4bdf3b78e4f960473.json create mode 100644 .changelog/ff32ac085f4b4d98877afdf99570f12e.json diff --git a/.changelog/2dc9fba6d49d4a05bcf78d1a4daa689b.json b/.changelog/2dc9fba6d49d4a05bcf78d1a4daa689b.json new file mode 100644 index 00000000000..65c8418bacf --- /dev/null +++ b/.changelog/2dc9fba6d49d4a05bcf78d1a4daa689b.json @@ -0,0 +1,8 @@ +{ + "id": "2dc9fba6-d49d-4a05-bcf7-8d1a4daa689b", + "type": "documentation", + "description": "Documentation updates for Amazon S3", + "modules": [ + "service/s3" + ] +} \ No newline at end of file diff --git a/.changelog/5e1218250e9244bda046ab112d5ff028.json b/.changelog/5e1218250e9244bda046ab112d5ff028.json new file mode 100644 index 00000000000..8d2cf16ee76 --- /dev/null +++ b/.changelog/5e1218250e9244bda046ab112d5ff028.json @@ -0,0 +1,8 @@ +{ + "id": "5e121825-0e92-44bd-a046-ab112d5ff028", + "type": "feature", + "description": "Deprecating AWS Server Migration Service.", + "modules": [ + "service/sms" + ] +} \ No newline at end of file diff --git a/.changelog/7e4456b418b6488dbda1b4d1fe92f526.json b/.changelog/7e4456b418b6488dbda1b4d1fe92f526.json new file mode 100644 index 00000000000..4c17c5e6c51 --- /dev/null +++ b/.changelog/7e4456b418b6488dbda1b4d1fe92f526.json @@ -0,0 +1,8 @@ +{ + "id": "7e4456b4-18b6-488d-bda1-b4d1fe92f526", + "type": "documentation", + "description": "Documentation updates for EC2 On Demand Capacity Reservations", + "modules": [ + "service/ec2" + ] +} \ No newline at end of file diff --git a/.changelog/91a7e21b17f741ae912ce70e307cdf3b.json b/.changelog/91a7e21b17f741ae912ce70e307cdf3b.json new file mode 100644 index 00000000000..ac8517dc503 --- /dev/null +++ b/.changelog/91a7e21b17f741ae912ce70e307cdf3b.json @@ -0,0 +1,8 @@ +{ + "id": "91a7e21b-17f7-41ae-912c-e70e307cdf3b", + "type": "documentation", + "description": "Adding EKS related documentation for appTemplateBody", + "modules": [ + "service/resiliencehub" + ] +} \ No newline at end of file diff --git a/.changelog/d3e5a716746049b4bdf3b78e4f960473.json b/.changelog/d3e5a716746049b4bdf3b78e4f960473.json new file mode 100644 index 00000000000..e8061159b8e --- /dev/null +++ b/.changelog/d3e5a716746049b4bdf3b78e4f960473.json @@ -0,0 +1,8 @@ +{ + "id": "d3e5a716-7460-49b4-bdf3-b78e4f960473", + "type": "feature", + "description": "In this release, you can now chose between soft delete and hard delete when calling the DeleteRecord API, so you have more flexibility when it comes to managing online store data.", + "modules": [ + "service/sagemakerfeaturestoreruntime" + ] +} \ No newline at end of file diff --git a/.changelog/ff32ac085f4b4d98877afdf99570f12e.json b/.changelog/ff32ac085f4b4d98877afdf99570f12e.json new file mode 100644 index 00000000000..cc6a814cf5a --- /dev/null +++ b/.changelog/ff32ac085f4b4d98877afdf99570f12e.json @@ -0,0 +1,8 @@ +{ + "id": "ff32ac08-5f4b-4d98-877a-fdf99570f12e", + "type": "feature", + "description": "This release adds a new feature for Amazon CloudWatch Internet Monitor that enables customers to deliver internet measurements to Amazon S3 buckets as well as CloudWatch Logs.", + "modules": [ + "service/internetmonitor" + ] +} \ No newline at end of file diff --git a/service/acmpca/internal/endpoints/endpoints.go b/service/acmpca/internal/endpoints/endpoints.go index 81e88b4fa83..b9bbc9b6b9a 100644 --- a/service/acmpca/internal/endpoints/endpoints.go +++ b/service/acmpca/internal/endpoints/endpoints.go @@ -153,6 +153,9 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ap-south-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ap-south-2", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "ap-southeast-1", }: endpoints.Endpoint{}, @@ -174,12 +177,18 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "eu-central-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "eu-central-2", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-north-1", }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-south-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "eu-south-2", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-west-1", }: endpoints.Endpoint{}, diff --git a/service/ec2/api_op_GetGroupsForCapacityReservation.go b/service/ec2/api_op_GetGroupsForCapacityReservation.go index eef46474be4..321abfdfa79 100644 --- a/service/ec2/api_op_GetGroupsForCapacityReservation.go +++ b/service/ec2/api_op_GetGroupsForCapacityReservation.go @@ -30,7 +30,9 @@ func (c *Client) GetGroupsForCapacityReservation(ctx context.Context, params *Ge type GetGroupsForCapacityReservationInput struct { - // The ID of the Capacity Reservation. + // The ID of the Capacity Reservation. If you specify a Capacity Reservation that + // is shared with you, the operation returns only Capacity Reservation groups that + // you own. // // This member is required. CapacityReservationId *string diff --git a/service/ec2/api_op_RunInstances.go b/service/ec2/api_op_RunInstances.go index d311d881e3b..8e4e475695f 100644 --- a/service/ec2/api_op_RunInstances.go +++ b/service/ec2/api_op_RunInstances.go @@ -191,7 +191,14 @@ type RunInstancesInput struct { // An elastic inference accelerator to associate with the instance. Elastic // inference accelerators are a resource you can attach to your Amazon EC2 // instances to accelerate your Deep Learning (DL) inference workloads. You cannot - // specify accelerators from different generations in the same request. + // specify accelerators from different generations in the same request. Starting + // April 15, 2023, Amazon Web Services will not onboard new customers to Amazon + // Elastic Inference (EI), and will help current customers migrate their workloads + // to options that offer better price and performance. After April 15, 2023, new + // customers will not be able to launch instances with Amazon EI accelerators in + // Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used + // Amazon EI at least once during the past 30-day period are considered current + // customers and will be able to continue using the service. ElasticInferenceAccelerators []types.ElasticInferenceAccelerator // Indicates whether the instance is enabled for Amazon Web Services Nitro diff --git a/service/greengrass/internal/endpoints/endpoints.go b/service/greengrass/internal/endpoints/endpoints.go index b4076322d0e..da60a63ddff 100644 --- a/service/greengrass/internal/endpoints/endpoints.go +++ b/service/greengrass/internal/endpoints/endpoints.go @@ -153,6 +153,12 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ca-central-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ca-central-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.ca-central-1.amazonaws.com", + }, endpoints.EndpointKey{ Region: "eu-central-1", }: endpoints.Endpoint{}, @@ -162,15 +168,69 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "eu-west-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "fips-ca-central-1", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.ca-central-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "ca-central-1", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-east-1", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.us-east-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-east-1", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-east-2", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.us-east-2.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-east-2", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-west-2", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.us-west-2.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-west-2", + }, + Deprecated: aws.TrueTernary, + }, endpoints.EndpointKey{ Region: "us-east-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-east-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.us-east-1.amazonaws.com", + }, endpoints.EndpointKey{ Region: "us-east-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-east-2", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.us-east-2.amazonaws.com", + }, endpoints.EndpointKey{ Region: "us-west-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-west-2", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.us-west-2.amazonaws.com", + }, }, }, { diff --git a/service/greengrassv2/internal/endpoints/endpoints.go b/service/greengrassv2/internal/endpoints/endpoints.go index 3edfb13165a..daa887bfdd5 100644 --- a/service/greengrassv2/internal/endpoints/endpoints.go +++ b/service/greengrassv2/internal/endpoints/endpoints.go @@ -153,6 +153,12 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ca-central-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ca-central-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.ca-central-1.amazonaws.com", + }, endpoints.EndpointKey{ Region: "eu-central-1", }: endpoints.Endpoint{}, @@ -162,15 +168,69 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "eu-west-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "fips-ca-central-1", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.ca-central-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "ca-central-1", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-east-1", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.us-east-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-east-1", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-east-2", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.us-east-2.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-east-2", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-west-2", + }: endpoints.Endpoint{ + Hostname: "greengrass-fips.us-west-2.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-west-2", + }, + Deprecated: aws.TrueTernary, + }, endpoints.EndpointKey{ Region: "us-east-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-east-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.us-east-1.amazonaws.com", + }, endpoints.EndpointKey{ Region: "us-east-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-east-2", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.us-east-2.amazonaws.com", + }, endpoints.EndpointKey{ Region: "us-west-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-west-2", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "greengrass-fips.us-west-2.amazonaws.com", + }, }, }, { diff --git a/service/internetmonitor/api_op_CreateMonitor.go b/service/internetmonitor/api_op_CreateMonitor.go index 124563ff2b8..47401353b8d 100644 --- a/service/internetmonitor/api_op_CreateMonitor.go +++ b/service/internetmonitor/api_op_CreateMonitor.go @@ -13,13 +13,21 @@ import ( ) // Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built -// based on information from the application resources that you add: Virtual +// based on information from the application resources that you add: Amazon Virtual // Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces -// directories. After you create a monitor, you can view the internet performance -// for your application, scoped to a location, as well as any health events that -// are impairing traffic. Internet Monitor can also diagnose whether the impairment -// is on the Amazon Web Services network or is an issue with an internet service -// provider (ISP). +// directories. Internet Monitor then publishes internet measurements from Amazon +// Web Services that are specific to the city-networks, that is, the locations and +// ASNs (typically internet service providers or ISPs), where clients access your +// application. For more information, see Using Amazon CloudWatch Internet Monitor +// (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html) +// in the Amazon CloudWatch User Guide. When you create a monitor, you set a +// maximum limit for the number of city-networks where client traffic is monitored. +// The city-network maximum that you choose is the limit, but you only pay for the +// number of city-networks that are actually monitored. You can change the maximum +// at any time by updating your monitor. For more information, see Choosing a +// city-network maximum value +// (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) +// in the Amazon CloudWatch User Guide. func (c *Client) CreateMonitor(ctx context.Context, params *CreateMonitorInput, optFns ...func(*Options)) (*CreateMonitorOutput, error) { if params == nil { params = &CreateMonitorInput{} @@ -37,8 +45,13 @@ func (c *Client) CreateMonitor(ctx context.Context, params *CreateMonitorInput, type CreateMonitorInput struct { - // The maximum number of city-network combinations (that is, combinations of a city - // location and network, such as an ISP) to be monitored for your resources. + // The maximum number of city-networks to monitor for your resources. A + // city-network is the location (city) where clients access your application + // resources from and the network or ASN, such as an internet service provider + // (ISP), that clients access the resources through. This limit helps control + // billing costs. To learn more, see Choosing a city-network maximum value + // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. // // This member is required. MaxCityNetworksToMonitor int32 @@ -53,6 +66,11 @@ type CreateMonitorInput struct { // requests. ClientToken *string + // Publish internet measurements for Internet Monitor to another location, such as + // an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch + // Logs. + InternetMeasurementsLogDelivery *types.InternetMeasurementsLogDelivery + // The resources to include in a monitor, which you provide as a set of Amazon // Resource Names (ARNs). You can add a combination of Amazon Virtual Private // Clouds (VPCs) and Amazon CloudFront distributions, or you can add Amazon diff --git a/service/internetmonitor/api_op_GetMonitor.go b/service/internetmonitor/api_op_GetMonitor.go index 8f829216119..8c69ccc68af 100644 --- a/service/internetmonitor/api_op_GetMonitor.go +++ b/service/internetmonitor/api_op_GetMonitor.go @@ -48,8 +48,13 @@ type GetMonitorOutput struct { // This member is required. CreatedAt *time.Time - // The maximum number of city-network combinations (that is, combinations of a city - // location and network, such as an ISP) to be monitored for your resources. + // The maximum number of city-networks to monitor for your resources. A + // city-network is the location (city) where clients access your application + // resources from and the network or ASN, such as an internet service provider + // (ISP), that clients access the resources through. This limit helps control + // billing costs. To learn more, see Choosing a city-network maximum value + // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. // // This member is required. MaxCityNetworksToMonitor int32 @@ -80,6 +85,11 @@ type GetMonitorOutput struct { // This member is required. Status types.MonitorConfigState + // Publish internet measurements for Internet Monitor to another location, such as + // an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch + // Logs. + InternetMeasurementsLogDelivery *types.InternetMeasurementsLogDelivery + // The health of the data processing for the monitor. ProcessingStatus types.MonitorProcessingStatusCode diff --git a/service/internetmonitor/api_op_UpdateMonitor.go b/service/internetmonitor/api_op_UpdateMonitor.go index 2df17b7fcd2..ef1d169689b 100644 --- a/service/internetmonitor/api_op_UpdateMonitor.go +++ b/service/internetmonitor/api_op_UpdateMonitor.go @@ -12,8 +12,14 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Updates a monitor. You can update a monitor to add or remove resources, or to -// change the status of the monitor. You can't change the name of a monitor. +// Updates a monitor. You can update a monitor to change the maximum number of +// city-networks (locations and ASNs or internet service providers), to add or +// remove resources, or to change the status of the monitor. Note that you can't +// change the name of a monitor. The city-network maximum that you choose is the +// limit, but you only pay for the number of city-networks that are actually +// monitored. For more information, see Choosing a city-network maximum value +// (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html) +// in the Amazon CloudWatch User Guide. func (c *Client) UpdateMonitor(ctx context.Context, params *UpdateMonitorInput, optFns ...func(*Options)) (*UpdateMonitorOutput, error) { if params == nil { params = &UpdateMonitorInput{} @@ -41,8 +47,15 @@ type UpdateMonitorInput struct { // other API requests. ClientToken *string - // The maximum number of city-network combinations (that is, combinations of a city - // location and network, such as an ISP) to be monitored for your resources. + // Publish internet measurements for Internet Monitor to another location, such as + // an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch + // Logs. + InternetMeasurementsLogDelivery *types.InternetMeasurementsLogDelivery + + // The maximum number of city-networks to monitor for your resources. A + // city-network is the location (city) where clients access your application + // resources from and the network or ASN, such as an internet service provider, + // that clients access the resources through. MaxCityNetworksToMonitor int32 // The resources to include in a monitor, which you provide as a set of Amazon diff --git a/service/internetmonitor/deserializers.go b/service/internetmonitor/deserializers.go index 92a9b33c2ba..a989ac71e65 100644 --- a/service/internetmonitor/deserializers.go +++ b/service/internetmonitor/deserializers.go @@ -720,6 +720,11 @@ func awsRestjson1_deserializeOpDocumentGetMonitorOutput(v **GetMonitorOutput, va sv.CreatedAt = ptr.Time(t) } + case "InternetMeasurementsLogDelivery": + if err := awsRestjson1_deserializeDocumentInternetMeasurementsLogDelivery(&sv.InternetMeasurementsLogDelivery, value); err != nil { + return err + } + case "MaxCityNetworksToMonitor": if value != nil { jtv, ok := value.(json.Number) @@ -2863,6 +2868,42 @@ func awsRestjson1_deserializeDocumentInternetHealth(v **types.InternetHealth, va return nil } +func awsRestjson1_deserializeDocumentInternetMeasurementsLogDelivery(v **types.InternetMeasurementsLogDelivery, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *types.InternetMeasurementsLogDelivery + if *v == nil { + sv = &types.InternetMeasurementsLogDelivery{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "S3Config": + if err := awsRestjson1_deserializeDocumentS3Config(&sv.S3Config, value); err != nil { + return err + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + func awsRestjson1_deserializeDocumentLimitExceededException(v **types.LimitExceededException, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) @@ -3492,6 +3533,64 @@ func awsRestjson1_deserializeDocumentRoundTripTime(v **types.RoundTripTime, valu return nil } +func awsRestjson1_deserializeDocumentS3Config(v **types.S3Config, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *types.S3Config + if *v == nil { + sv = &types.S3Config{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "BucketName": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected String to be of type string, got %T instead", value) + } + sv.BucketName = ptr.String(jtv) + } + + case "BucketPrefix": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected String to be of type string, got %T instead", value) + } + sv.BucketPrefix = ptr.String(jtv) + } + + case "LogDeliveryStatus": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected LogDeliveryStatus to be of type string, got %T instead", value) + } + sv.LogDeliveryStatus = types.LogDeliveryStatus(jtv) + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + func awsRestjson1_deserializeDocumentSetOfARNs(v *[]string, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) diff --git a/service/internetmonitor/doc.go b/service/internetmonitor/doc.go index cab2479283c..937a9cd3f2d 100644 --- a/service/internetmonitor/doc.go +++ b/service/internetmonitor/doc.go @@ -5,28 +5,27 @@ // // Amazon CloudWatch Internet Monitor provides visibility into how internet issues // impact the performance and availability between your applications hosted on -// Amazon Web Services and your end users, reducing the time it takes for you to -// diagnose these issues, from days to minutes. You can explore internet -// measurements for different time frames and at different geographic -// granularities, and quickly visualize the impact of issues, and then take action -// to improve your end users' experience, for example, by switching to other Amazon -// Web Services services or rerouting traffic to your workload through -// differentAmazon Web Services Regions. If the issue is caused by the Amazon Web -// Services network, you'll automatically receive an Amazon Web Services Health -// Dashboard notification with the steps that Amazon Web Services is taking to -// mitigate the problem. To support integrating health information for geographies -// and networks specific to your application, Internet Monitor delivers -// measurements to CloudWatch Logs and CloudWatch Metrics. Internet Monitor also -// sends health events to Amazon EventBridge, so you can set up notifications. -// Internet Monitor monitors internet connectivity for your application through -// Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and -// Amazon WorkSpaces directories. To use Internet Monitor, you create a monitor and -// add resources to it, Virtual Private Clouds (VPCs), Amazon CloudFront -// distributions, or WorkSpaces directories that show where your application's -// internet traffic is. Internet Monitor then provides internet measurements from -// Amazon Web Services that are specific to the locations and networks that -// communicate with your application. For more information, see Using Amazon -// CloudWatch Internet Monitor +// Amazon Web Services and your end users. It reduces the time it takes for you to +// diagnose internet issues from days to minutes. Internet Monitor uses the +// connectivity data that Amazon Web Services captures from its global networking +// footprint to calculate a baseline of performance and availability for internet +// traffic. This is the same data that Amazon Web Services uses to monitor internet +// uptime and availability. With those measurements as a baseline, Internet Monitor +// raises awareness for you when there are significant problems for your end users +// in the different geographic locations where your application runs. Internet +// Monitor publishes internet measurements to CloudWatch Logs and CloudWatch +// Metrics, to easily support using CloudWatch tools with health information for +// geographies and networks specific to your application. Internet Monitor sends +// health events to Amazon EventBridge so that you can set up notifications. If an +// issue is caused by the Amazon Web Services network, you also automatically +// receive an Amazon Web Services Health Dashboard notification with the steps that +// Amazon Web Services is taking to mitigate the problem. To use Internet Monitor, +// you create a monitor and associate your application's resources with it, VPCs, +// CloudFront distributions, or WorkSpaces directories, to enable Internet Monitor +// to know where your application's internet traffic is. Internet Monitor then +// provides internet measurements from Amazon Web Services that are specific to the +// locations and networks that communicate with your application. For more +// information, see Using Amazon CloudWatch Internet Monitor // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html) // in the Amazon CloudWatch User Guide. package internetmonitor diff --git a/service/internetmonitor/serializers.go b/service/internetmonitor/serializers.go index f505d8cd7c8..a69552390d4 100644 --- a/service/internetmonitor/serializers.go +++ b/service/internetmonitor/serializers.go @@ -6,6 +6,7 @@ import ( "bytes" "context" "fmt" + "github.com/aws/aws-sdk-go-v2/service/internetmonitor/types" smithy "github.com/aws/smithy-go" "github.com/aws/smithy-go/encoding/httpbinding" smithyjson "github.com/aws/smithy-go/encoding/json" @@ -79,6 +80,13 @@ func awsRestjson1_serializeOpDocumentCreateMonitorInput(v *CreateMonitorInput, v ok.String(*v.ClientToken) } + if v.InternetMeasurementsLogDelivery != nil { + ok := object.Key("InternetMeasurementsLogDelivery") + if err := awsRestjson1_serializeDocumentInternetMeasurementsLogDelivery(v.InternetMeasurementsLogDelivery, ok); err != nil { + return err + } + } + { ok := object.Key("MaxCityNetworksToMonitor") ok.Integer(v.MaxCityNetworksToMonitor) @@ -711,6 +719,13 @@ func awsRestjson1_serializeOpDocumentUpdateMonitorInput(v *UpdateMonitorInput, v ok.String(*v.ClientToken) } + if v.InternetMeasurementsLogDelivery != nil { + ok := object.Key("InternetMeasurementsLogDelivery") + if err := awsRestjson1_serializeDocumentInternetMeasurementsLogDelivery(v.InternetMeasurementsLogDelivery, ok); err != nil { + return err + } + } + if v.MaxCityNetworksToMonitor != 0 { ok := object.Key("MaxCityNetworksToMonitor") ok.Integer(v.MaxCityNetworksToMonitor) @@ -738,6 +753,42 @@ func awsRestjson1_serializeOpDocumentUpdateMonitorInput(v *UpdateMonitorInput, v return nil } +func awsRestjson1_serializeDocumentInternetMeasurementsLogDelivery(v *types.InternetMeasurementsLogDelivery, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.S3Config != nil { + ok := object.Key("S3Config") + if err := awsRestjson1_serializeDocumentS3Config(v.S3Config, ok); err != nil { + return err + } + } + + return nil +} + +func awsRestjson1_serializeDocumentS3Config(v *types.S3Config, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.BucketName != nil { + ok := object.Key("BucketName") + ok.String(*v.BucketName) + } + + if v.BucketPrefix != nil { + ok := object.Key("BucketPrefix") + ok.String(*v.BucketPrefix) + } + + if len(v.LogDeliveryStatus) > 0 { + ok := object.Key("LogDeliveryStatus") + ok.String(string(v.LogDeliveryStatus)) + } + + return nil +} + func awsRestjson1_serializeDocumentSetOfARNs(v []string, value smithyjson.Value) error { array := value.Array() defer array.Close() diff --git a/service/internetmonitor/types/enums.go b/service/internetmonitor/types/enums.go index da31a570db9..c2463600032 100644 --- a/service/internetmonitor/types/enums.go +++ b/service/internetmonitor/types/enums.go @@ -38,6 +38,24 @@ func (HealthEventStatus) Values() []HealthEventStatus { } } +type LogDeliveryStatus string + +// Enum values for LogDeliveryStatus +const ( + LogDeliveryStatusEnabled LogDeliveryStatus = "ENABLED" + LogDeliveryStatusDisabled LogDeliveryStatus = "DISABLED" +) + +// Values returns all known values for LogDeliveryStatus. Note that this can be +// expanded in the future, and so it is only as up to date as the client. The +// ordering of this slice is not guaranteed to be stable across updates. +func (LogDeliveryStatus) Values() []LogDeliveryStatus { + return []LogDeliveryStatus{ + "ENABLED", + "DISABLED", + } +} + type MonitorConfigState string // Enum values for MonitorConfigState diff --git a/service/internetmonitor/types/types.go b/service/internetmonitor/types/types.go index aceaba3a3d7..8003283a903 100644 --- a/service/internetmonitor/types/types.go +++ b/service/internetmonitor/types/types.go @@ -19,7 +19,7 @@ import ( // represents the estimated percentage of traffic that is not seeing an // availability drop. For example, an availability score of 99% for an end user and // service location pair is equivalent to 1% of the traffic experiencing an -// availability drop for that pair. For more information, see How Internet Monitor +// availability drop for that pair. For more information, see How Internet Monitor // calculates performance and availability scores // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores) // in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User @@ -34,8 +34,8 @@ type AvailabilityMeasurement struct { // Monitor chapter in the CloudWatch User Guide includes detailed information about // how Internet Monitor calculates health scores, including performance and // availability scores, and when it creates and resolves health events. For more - // information, see How Amazon Web Services calculates performance and - // availability scores + // information, see How Amazon Web Services calculates performance and availability + // scores // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. ExperienceScore *float64 @@ -49,7 +49,7 @@ type AvailabilityMeasurement struct { PercentOfClientLocationImpacted *float64 // The percentage of impact caused by a health event for total traffic globally. - // For information about how Internet Monitor calculates impact, see Inside + // For information about how Internet Monitor calculates impact, see Inside // Internet Monitor // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html) // in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User @@ -196,26 +196,39 @@ type InternetHealth struct { // Availability in Internet Monitor represents the estimated percentage of traffic // that is not seeing an availability drop. For example, an availability score of // 99% for an end user and service location pair is equivalent to 1% of the traffic - // experiencing an availability drop for that pair. For more information, see How + // experiencing an availability drop for that pair. For more information, see How // Internet Monitor calculates performance and availability scores // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores) - // in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User - // Guide. + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. Availability *AvailabilityMeasurement // Performance in Internet Monitor represents the estimated percentage of traffic // that is not seeing a performance drop. For example, a performance score of 99% // for an end user and service location pair is equivalent to 1% of the traffic - // experiencing a performance drop for that pair. For more information, see How + // experiencing a performance drop for that pair. For more information, see How // Internet Monitor calculates performance and availability scores // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores) - // in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User - // Guide. + // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. Performance *PerformanceMeasurement noSmithyDocumentSerde } +// Configuration information for other locations that you choose to publish Amazon +// CloudWatch Internet Monitor internet measurements to, such as Amazon S3. The +// measurements are also published to Amazon CloudWatch Logs. +type InternetMeasurementsLogDelivery struct { + + // The configuration information for publishing Internet Monitor internet + // measurements to Amazon S3. The configuration includes the bucket name and + // (optionally) prefix for the S3 bucket to store the measurements, and the + // delivery status. The delivery status is ENABLED or DISABLED, depending on + // whether you choose to deliver internet measurements to S3 logs. + S3Config *S3Config + + noSmithyDocumentSerde +} + // The description of and information about a monitor in Amazon CloudWatch Internet // Monitor. type Monitor struct { @@ -293,11 +306,10 @@ type NetworkImpairment struct { // represents the estimated percentage of traffic that is not seeing a performance // drop. For example, a performance score of 99% for an end user and service // location pair is equivalent to 1% of the traffic experiencing a performance drop -// for that pair. For more information, see How Internet Monitor calculates +// for that pair. For more information, see How Internet Monitor calculates // performance and availability scores // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores) -// in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User -// Guide. +// in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. type PerformanceMeasurement struct { // Experience scores, or health scores, are calculated for different geographic and @@ -308,8 +320,8 @@ type PerformanceMeasurement struct { // Internet Monitor chapter in the CloudWatch User Guide includes detailed // information about how Internet Monitor calculates health scores, including // performance and availability scores, and when it creates and resolves health - // events. For more information, see How Amazon Web Services calculates - // performance and availability scores + // events. For more information, see How Amazon Web Services calculates performance + // and availability scores // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. ExperienceScore *float64 @@ -318,7 +330,7 @@ type PerformanceMeasurement struct { // For performance, this is the percentage of how much latency increased during the // event compared to typical performance for traffic, from this client location to // an Amazon Web Services location, using a specific client network. For more - // information, see When Amazon Web Services creates and resolves health events + // information, see When Amazon Web Services creates and resolves health events // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. PercentOfClientLocationImpacted *float64 @@ -326,7 +338,7 @@ type PerformanceMeasurement struct { // How much performance impact was caused by a health event for total traffic // globally. For performance, this is the percentage of how much latency increased // during the event compared to typical performance for your application traffic - // globally. For more information, see When Amazon Web Services creates and + // globally. For more information, see When Amazon Web Services creates and // resolves health events // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. @@ -334,7 +346,7 @@ type PerformanceMeasurement struct { // This is the percentage of how much round-trip time increased during the event // compared to typical round-trip time for your application for traffic. For more - // information, see When Amazon Web Services creates and resolves health events + // information, see When Amazon Web Services creates and resolves health events // (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop) // in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide. RoundTripTime *RoundTripTime @@ -359,4 +371,24 @@ type RoundTripTime struct { noSmithyDocumentSerde } +// The configuration for publishing Amazon CloudWatch Internet Monitor internet +// measurements to Amazon S3. The configuration includes the bucket name and +// (optionally) prefix for the S3 bucket to store the measurements, and the +// delivery status. The delivery status is ENABLED or DISABLED, depending on +// whether you choose to deliver internet measurements to S3 logs. +type S3Config struct { + + // The Amazon S3 bucket name. + BucketName *string + + // The Amazon S3 bucket prefix. + BucketPrefix *string + + // The status of publishing Internet Monitor internet measurements to an Amazon S3 + // bucket. + LogDeliveryStatus LogDeliveryStatus + + noSmithyDocumentSerde +} + type noSmithyDocumentSerde = smithydocument.NoSerde diff --git a/service/iottwinmaker/internal/endpoints/endpoints.go b/service/iottwinmaker/internal/endpoints/endpoints.go index 725f2f32869..5f4a833fdc5 100644 --- a/service/iottwinmaker/internal/endpoints/endpoints.go +++ b/service/iottwinmaker/internal/endpoints/endpoints.go @@ -147,12 +147,42 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "eu-west-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "fips-us-east-1", + }: endpoints.Endpoint{ + Hostname: "iottwinmaker-fips.us-east-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-east-1", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-us-west-2", + }: endpoints.Endpoint{ + Hostname: "iottwinmaker-fips.us-west-2.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-west-2", + }, + Deprecated: aws.TrueTernary, + }, endpoints.EndpointKey{ Region: "us-east-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-east-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "iottwinmaker-fips.us-east-1.amazonaws.com", + }, endpoints.EndpointKey{ Region: "us-west-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-west-2", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "iottwinmaker-fips.us-west-2.amazonaws.com", + }, }, }, { @@ -267,9 +297,24 @@ var defaultPartitions = endpoints.Partitions{ RegionRegex: partitionRegexp.AwsUsGov, IsRegionalized: true, Endpoints: endpoints.Endpoints{ + endpoints.EndpointKey{ + Region: "fips-us-gov-west-1", + }: endpoints.Endpoint{ + Hostname: "iottwinmaker-fips.us-gov-west-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "us-gov-west-1", + }, + Deprecated: aws.TrueTernary, + }, endpoints.EndpointKey{ Region: "us-gov-west-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-gov-west-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "iottwinmaker-fips.us-gov-west-1.amazonaws.com", + }, }, }, } diff --git a/service/resiliencehub/api_op_AddDraftAppVersionResourceMappings.go b/service/resiliencehub/api_op_AddDraftAppVersionResourceMappings.go index a21e988ad62..1565b2c38a9 100644 --- a/service/resiliencehub/api_op_AddDraftAppVersionResourceMappings.go +++ b/service/resiliencehub/api_op_AddDraftAppVersionResourceMappings.go @@ -30,8 +30,8 @@ func (c *Client) AddDraftAppVersionResourceMappings(ctx context.Context, params type AddDraftAppVersionResourceMappingsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -53,8 +53,8 @@ type AddDraftAppVersionResourceMappingsInput struct { type AddDraftAppVersionResourceMappingsOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_CreateApp.go b/service/resiliencehub/api_op_CreateApp.go index 06af387e830..e29baacf516 100644 --- a/service/resiliencehub/api_op_CreateApp.go +++ b/service/resiliencehub/api_op_CreateApp.go @@ -16,12 +16,12 @@ import ( // collection of Amazon Web Services resources structured to prevent and recover // Amazon Web Services application disruptions. To describe a Resilience Hub // application, you provide an application name, resources from one or more–up to -// five–CloudFormation stacks, and an appropriate resiliency policy. After you -// create an Resilience Hub application, you publish it so that you can run a -// resiliency assessment on it. You can then use recommendations from the -// assessment to improve resiliency by running another assessment, comparing -// results, and then iterating the process until you achieve your goals for -// recovery time objective (RTO) and recovery point objective (RPO). +// 20–CloudFormation stacks, and an appropriate resiliency policy. After you create +// an Resilience Hub application, you publish it so that you can run a resiliency +// assessment on it. You can then use recommendations from the assessment to +// improve resiliency by running another assessment, comparing results, and then +// iterating the process until you achieve your goals for recovery time objective +// (RTO) and recovery point objective (RPO). func (c *Client) CreateApp(ctx context.Context, params *CreateAppInput, optFns ...func(*Options)) (*CreateAppOutput, error) { if params == nil { params = &CreateAppInput{} diff --git a/service/resiliencehub/api_op_CreateAppVersionAppComponent.go b/service/resiliencehub/api_op_CreateAppVersionAppComponent.go index 0c66307a2b5..2b897603770 100644 --- a/service/resiliencehub/api_op_CreateAppVersionAppComponent.go +++ b/service/resiliencehub/api_op_CreateAppVersionAppComponent.go @@ -33,8 +33,8 @@ func (c *Client) CreateAppVersionAppComponent(ctx context.Context, params *Creat type CreateAppVersionAppComponentInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -71,8 +71,8 @@ type CreateAppVersionAppComponentInput struct { type CreateAppVersionAppComponentOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -80,7 +80,7 @@ type CreateAppVersionAppComponentOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_CreateAppVersionResource.go b/service/resiliencehub/api_op_CreateAppVersionResource.go index eab1b0ae1fe..0c76ca2c4b6 100644 --- a/service/resiliencehub/api_op_CreateAppVersionResource.go +++ b/service/resiliencehub/api_op_CreateAppVersionResource.go @@ -43,8 +43,8 @@ func (c *Client) CreateAppVersionResource(ctx context.Context, params *CreateApp type CreateAppVersionResourceInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -53,8 +53,8 @@ type CreateAppVersionResourceInput struct { AppArn *string // The list of Application Components that this resource belongs to. If an - // Application Component is not part of the AWS Resilience Hub application, it will - // be added. + // Application Component is not part of the Resilience Hub application, it will be + // added. // // This member is required. AppComponents []string @@ -98,8 +98,8 @@ type CreateAppVersionResourceInput struct { type CreateAppVersionResourceOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -107,7 +107,7 @@ type CreateAppVersionResourceOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_DeleteApp.go b/service/resiliencehub/api_op_DeleteApp.go index 8d130d0b1ee..f6584b48c83 100644 --- a/service/resiliencehub/api_op_DeleteApp.go +++ b/service/resiliencehub/api_op_DeleteApp.go @@ -30,8 +30,8 @@ func (c *Client) DeleteApp(ctx context.Context, params *DeleteAppInput, optFns . type DeleteAppInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -52,8 +52,8 @@ type DeleteAppInput struct { type DeleteAppOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_DeleteAppInputSource.go b/service/resiliencehub/api_op_DeleteAppInputSource.go index 429a97b279b..2fe347948ef 100644 --- a/service/resiliencehub/api_op_DeleteAppInputSource.go +++ b/service/resiliencehub/api_op_DeleteAppInputSource.go @@ -31,8 +31,8 @@ func (c *Client) DeleteAppInputSource(ctx context.Context, params *DeleteAppInpu type DeleteAppInputSourceInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -65,8 +65,8 @@ type DeleteAppInputSourceInput struct { type DeleteAppInputSourceOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_DeleteAppVersionAppComponent.go b/service/resiliencehub/api_op_DeleteAppVersionAppComponent.go index b7599877852..0b9ffc2c445 100644 --- a/service/resiliencehub/api_op_DeleteAppVersionAppComponent.go +++ b/service/resiliencehub/api_op_DeleteAppVersionAppComponent.go @@ -38,8 +38,8 @@ func (c *Client) DeleteAppVersionAppComponent(ctx context.Context, params *Delet type DeleteAppVersionAppComponentInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -62,8 +62,8 @@ type DeleteAppVersionAppComponentInput struct { type DeleteAppVersionAppComponentOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -71,7 +71,7 @@ type DeleteAppVersionAppComponentOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_DeleteAppVersionResource.go b/service/resiliencehub/api_op_DeleteAppVersionResource.go index f4d090ee260..90fcf267490 100644 --- a/service/resiliencehub/api_op_DeleteAppVersionResource.go +++ b/service/resiliencehub/api_op_DeleteAppVersionResource.go @@ -41,8 +41,8 @@ func (c *Client) DeleteAppVersionResource(ctx context.Context, params *DeleteApp type DeleteAppVersionResourceInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -75,8 +75,8 @@ type DeleteAppVersionResourceInput struct { type DeleteAppVersionResourceOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -84,7 +84,7 @@ type DeleteAppVersionResourceOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_DescribeApp.go b/service/resiliencehub/api_op_DescribeApp.go index 9d9ff7a1cd9..9a961a5f71a 100644 --- a/service/resiliencehub/api_op_DescribeApp.go +++ b/service/resiliencehub/api_op_DescribeApp.go @@ -29,8 +29,8 @@ func (c *Client) DescribeApp(ctx context.Context, params *DescribeAppInput, optF type DescribeAppInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_DescribeAppVersion.go b/service/resiliencehub/api_op_DescribeAppVersion.go index f55d68a51dd..b9fea50d1ed 100644 --- a/service/resiliencehub/api_op_DescribeAppVersion.go +++ b/service/resiliencehub/api_op_DescribeAppVersion.go @@ -28,8 +28,8 @@ func (c *Client) DescribeAppVersion(ctx context.Context, params *DescribeAppVers type DescribeAppVersionInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -37,7 +37,7 @@ type DescribeAppVersionInput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string @@ -47,8 +47,8 @@ type DescribeAppVersionInput struct { type DescribeAppVersionOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -56,12 +56,15 @@ type DescribeAppVersionOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter supports only failover region and account. AdditionalInfo map[string][]string diff --git a/service/resiliencehub/api_op_DescribeAppVersionAppComponent.go b/service/resiliencehub/api_op_DescribeAppVersionAppComponent.go index beb92272350..f189c2c2a17 100644 --- a/service/resiliencehub/api_op_DescribeAppVersionAppComponent.go +++ b/service/resiliencehub/api_op_DescribeAppVersionAppComponent.go @@ -29,8 +29,8 @@ func (c *Client) DescribeAppVersionAppComponent(ctx context.Context, params *Des type DescribeAppVersionAppComponentInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -38,7 +38,7 @@ type DescribeAppVersionAppComponentInput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string @@ -53,8 +53,8 @@ type DescribeAppVersionAppComponentInput struct { type DescribeAppVersionAppComponentOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -62,7 +62,7 @@ type DescribeAppVersionAppComponentOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_DescribeAppVersionResource.go b/service/resiliencehub/api_op_DescribeAppVersionResource.go index d349a397f8f..46de9edf5e7 100644 --- a/service/resiliencehub/api_op_DescribeAppVersionResource.go +++ b/service/resiliencehub/api_op_DescribeAppVersionResource.go @@ -38,8 +38,8 @@ func (c *Client) DescribeAppVersionResource(ctx context.Context, params *Describ type DescribeAppVersionResourceInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -47,7 +47,7 @@ type DescribeAppVersionResourceInput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string @@ -72,8 +72,8 @@ type DescribeAppVersionResourceInput struct { type DescribeAppVersionResourceOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -81,7 +81,7 @@ type DescribeAppVersionResourceOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_DescribeAppVersionResourcesResolutionStatus.go b/service/resiliencehub/api_op_DescribeAppVersionResourcesResolutionStatus.go index ed3e5dc7ed0..b020fb59b43 100644 --- a/service/resiliencehub/api_op_DescribeAppVersionResourcesResolutionStatus.go +++ b/service/resiliencehub/api_op_DescribeAppVersionResourcesResolutionStatus.go @@ -31,8 +31,8 @@ func (c *Client) DescribeAppVersionResourcesResolutionStatus(ctx context.Context type DescribeAppVersionResourcesResolutionStatusInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -53,8 +53,8 @@ type DescribeAppVersionResourcesResolutionStatusInput struct { type DescribeAppVersionResourcesResolutionStatusOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_DescribeAppVersionTemplate.go b/service/resiliencehub/api_op_DescribeAppVersionTemplate.go index d2f12d353c5..1e4c07b89b8 100644 --- a/service/resiliencehub/api_op_DescribeAppVersionTemplate.go +++ b/service/resiliencehub/api_op_DescribeAppVersionTemplate.go @@ -28,8 +28,8 @@ func (c *Client) DescribeAppVersionTemplate(ctx context.Context, params *Describ type DescribeAppVersionTemplateInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -47,8 +47,8 @@ type DescribeAppVersionTemplateInput struct { type DescribeAppVersionTemplateOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -61,8 +61,8 @@ type DescribeAppVersionTemplateOutput struct { // in the Examples section. The appTemplateBody JSON string has the following // structure: // - // * resources The list of logical resources that needs to be included - // in the Resilience Hub application. Type: Array Don't add the resources that you + // * resources The list of logical resources that must be included in + // the Resilience Hub application. Type: Array Don't add the resources that you // want to exclude. Each resources array item includes the following fields: // // * @@ -82,28 +82,36 @@ type DescribeAppVersionTemplateOutput struct { // terraformSourceName The name of the Terraform S3 state file this resource // belongs to. Type: String // - // * type The type of resource. Type: string + // * eksSourceName The name of the Amazon Elastic + // Kubernetes Service cluster and namespace this resource belongs to. This + // parameter accepts values in "eks-cluster/namespace" format. Type: String // - // * name The - // name of the resource. Type: String + // * type + // The type of resource. Type: string // - // * additionalInfo Additional configuration - // parameters for an AWS Resilience Hub application. Currently, this parameter - // accepts a key-value mapping (in a string format) of only one failover region and - // one associated account. Key: "failover-regions" Value: "[{"region":"", - // "accounts":[{"id":""}]}]" + // * name The name of the resource. Type: + // String // - // * appComponents The list of Application - // Components that this resource belongs to. If an Application Component is not - // part of the AWS Resilience Hub application, it will be added. Type: Array Each - // appComponents array item includes the following fields: + // * additionalInfo Additional configuration parameters for an Resilience + // Hub application. If you want to implement additionalInfo through the Resilience + // Hub console rather than using an API call, see Configure the application + // configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). + // Currently, this parameter accepts a key-value mapping (in a string format) of + // only one failover region and one associated account. Key: "failover-regions" + // Value: "[{"region":"", "accounts":[{"id":""}]}]" // - // * name The name of the - // Application Component. Type: String + // * + // appComponents The list of Application Components that this resource belongs to. + // If an Application Component is not part of the Resilience Hub application, it + // will be added. Type: Array Each appComponents array item includes the following + // fields: + // + // * name The name of the Application Component. Type: String // - // * type The type of Application Component. - // For more information about the types of Application Component, see Grouping - // resources in an AppComponent + // * type The + // type of Application Component. For more information about the types of + // Application Component, see Grouping resources in an AppComponent // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html). // Type: String // @@ -111,7 +119,10 @@ type DescribeAppVersionTemplateOutput struct { // to the Application Component. Type: Array of strings // // * additionalInfo - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter accepts a key-value mapping (in a string format) of // only one failover region and one associated account. Key: "failover-regions" // Value: "[{"region":"", "accounts":[{"id":""}]}]" @@ -132,29 +143,39 @@ type DescribeAppVersionTemplateOutput struct { // // * terraformSourceName // - // Each logicalResourceIds object - // includes the following fields: + // * eksSourceName // - // * identifier The identifier of the resource. - // Type: String + // Each + // logicalResourceIds object includes the following fields: // - // * logicalStackName The name of the CloudFormation stack this - // resource belongs to. Type: String + // * identifier The + // identifier of the resource. Type: String // - // * resourceGroupName The name of the resource - // group this resource belongs to. Type: String + // * logicalStackName The name of the + // CloudFormation stack this resource belongs to. Type: String // - // * terraformSourceName The name of - // the Terraform S3 state file this resource belongs to. Type: String + // * resourceGroupName + // The name of the resource group this resource belongs to. Type: String + // + // * + // terraformSourceName The name of the Terraform S3 state file this resource + // belongs to. Type: String // - // * version - // The AWS Resilience Hub application version. + // * eksSourceName The name of the Amazon Elastic + // Kubernetes Service cluster and namespace this resource belongs to. This + // parameter accepts values in "eks-cluster/namespace" format. Type: String + // + // * + // version The Resilience Hub application version. // // * additionalInfo Additional - // configuration parameters for an AWS Resilience Hub application. Currently, this - // parameter accepts a key-value mapping (in a string format) of only one failover - // region and one associated account. Key: "failover-regions" Value: - // "[{"region":"", "accounts":[{"id":""}]}]" + // configuration parameters for an Resilience Hub application. If you want to + // implement additionalInfo through the Resilience Hub console rather than using an + // API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). + // Currently, this parameter accepts a key-value mapping (in a string format) of + // only one failover region and one associated account. Key: "failover-regions" + // Value: "[{"region":"", "accounts":[{"id":""}]}]" // // This member is required. AppTemplateBody *string diff --git a/service/resiliencehub/api_op_DescribeDraftAppVersionResourcesImportStatus.go b/service/resiliencehub/api_op_DescribeDraftAppVersionResourcesImportStatus.go index 950cefef2bc..c5be29ecc04 100644 --- a/service/resiliencehub/api_op_DescribeDraftAppVersionResourcesImportStatus.go +++ b/service/resiliencehub/api_op_DescribeDraftAppVersionResourcesImportStatus.go @@ -33,8 +33,8 @@ func (c *Client) DescribeDraftAppVersionResourcesImportStatus(ctx context.Contex type DescribeDraftAppVersionResourcesImportStatusInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -47,8 +47,8 @@ type DescribeDraftAppVersionResourcesImportStatusInput struct { type DescribeDraftAppVersionResourcesImportStatusOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ImportResourcesToDraftAppVersion.go b/service/resiliencehub/api_op_ImportResourcesToDraftAppVersion.go index 3b52d08c457..8b377b81692 100644 --- a/service/resiliencehub/api_op_ImportResourcesToDraftAppVersion.go +++ b/service/resiliencehub/api_op_ImportResourcesToDraftAppVersion.go @@ -33,8 +33,8 @@ func (c *Client) ImportResourcesToDraftAppVersion(ctx context.Context, params *I type ImportResourcesToDraftAppVersionInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -61,8 +61,8 @@ type ImportResourcesToDraftAppVersionInput struct { type ImportResourcesToDraftAppVersionOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ListAppAssessments.go b/service/resiliencehub/api_op_ListAppAssessments.go index 7f110ee6fe4..117c593cdbb 100644 --- a/service/resiliencehub/api_op_ListAppAssessments.go +++ b/service/resiliencehub/api_op_ListAppAssessments.go @@ -31,8 +31,8 @@ func (c *Client) ListAppAssessments(ctx context.Context, params *ListAppAssessme type ListAppAssessmentsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ListAppInputSources.go b/service/resiliencehub/api_op_ListAppInputSources.go index af8858fefd3..07ee5756a25 100644 --- a/service/resiliencehub/api_op_ListAppInputSources.go +++ b/service/resiliencehub/api_op_ListAppInputSources.go @@ -33,8 +33,8 @@ func (c *Client) ListAppInputSources(ctx context.Context, params *ListAppInputSo type ListAppInputSourcesInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -42,7 +42,7 @@ type ListAppInputSourcesInput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_ListAppVersionAppComponents.go b/service/resiliencehub/api_op_ListAppVersionAppComponents.go index 52ea20937aa..333118f85b7 100644 --- a/service/resiliencehub/api_op_ListAppVersionAppComponents.go +++ b/service/resiliencehub/api_op_ListAppVersionAppComponents.go @@ -30,8 +30,8 @@ func (c *Client) ListAppVersionAppComponents(ctx context.Context, params *ListAp type ListAppVersionAppComponentsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -44,7 +44,7 @@ type ListAppVersionAppComponentsInput struct { // This member is required. AppVersion *string - // Maximum number of Application Components to be displayed per AWS Resilience Hub + // Maximum number of Application Components to be displayed per Resilience Hub // application version. MaxResults *int32 @@ -56,8 +56,8 @@ type ListAppVersionAppComponentsInput struct { type ListAppVersionAppComponentsOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -65,7 +65,7 @@ type ListAppVersionAppComponentsOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string @@ -156,7 +156,7 @@ var _ ListAppVersionAppComponentsAPIClient = (*Client)(nil) // ListAppVersionAppComponentsPaginatorOptions is the paginator options for // ListAppVersionAppComponents type ListAppVersionAppComponentsPaginatorOptions struct { - // Maximum number of Application Components to be displayed per AWS Resilience Hub + // Maximum number of Application Components to be displayed per Resilience Hub // application version. Limit int32 diff --git a/service/resiliencehub/api_op_ListAppVersionResourceMappings.go b/service/resiliencehub/api_op_ListAppVersionResourceMappings.go index dce6910acbd..8b11ce81a73 100644 --- a/service/resiliencehub/api_op_ListAppVersionResourceMappings.go +++ b/service/resiliencehub/api_op_ListAppVersionResourceMappings.go @@ -32,8 +32,8 @@ func (c *Client) ListAppVersionResourceMappings(ctx context.Context, params *Lis type ListAppVersionResourceMappingsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ListAppVersionResources.go b/service/resiliencehub/api_op_ListAppVersionResources.go index b0d7eddc885..2974d765c79 100644 --- a/service/resiliencehub/api_op_ListAppVersionResources.go +++ b/service/resiliencehub/api_op_ListAppVersionResources.go @@ -30,8 +30,8 @@ func (c *Client) ListAppVersionResources(ctx context.Context, params *ListAppVer type ListAppVersionResourcesInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ListAppVersions.go b/service/resiliencehub/api_op_ListAppVersions.go index 48aa684d470..5bfb375fd0c 100644 --- a/service/resiliencehub/api_op_ListAppVersions.go +++ b/service/resiliencehub/api_op_ListAppVersions.go @@ -30,8 +30,8 @@ func (c *Client) ListAppVersions(ctx context.Context, params *ListAppVersionsInp type ListAppVersionsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ListApps.go b/service/resiliencehub/api_op_ListApps.go index 7f681140c6e..057dab49a2b 100644 --- a/service/resiliencehub/api_op_ListApps.go +++ b/service/resiliencehub/api_op_ListApps.go @@ -34,8 +34,8 @@ func (c *Client) ListApps(ctx context.Context, params *ListAppsInput, optFns ... type ListAppsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ListUnsupportedAppVersionResources.go b/service/resiliencehub/api_op_ListUnsupportedAppVersionResources.go index 57004ce7d55..89ae9c169bd 100644 --- a/service/resiliencehub/api_op_ListUnsupportedAppVersionResources.go +++ b/service/resiliencehub/api_op_ListUnsupportedAppVersionResources.go @@ -32,8 +32,8 @@ func (c *Client) ListUnsupportedAppVersionResources(ctx context.Context, params type ListUnsupportedAppVersionResourcesInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_PublishAppVersion.go b/service/resiliencehub/api_op_PublishAppVersion.go index f08a8322d27..650885c19b1 100644 --- a/service/resiliencehub/api_op_PublishAppVersion.go +++ b/service/resiliencehub/api_op_PublishAppVersion.go @@ -28,8 +28,8 @@ func (c *Client) PublishAppVersion(ctx context.Context, params *PublishAppVersio type PublishAppVersionInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -42,8 +42,8 @@ type PublishAppVersionInput struct { type PublishAppVersionOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_PutDraftAppVersionTemplate.go b/service/resiliencehub/api_op_PutDraftAppVersionTemplate.go index dab80d719c9..b2c586e246f 100644 --- a/service/resiliencehub/api_op_PutDraftAppVersionTemplate.go +++ b/service/resiliencehub/api_op_PutDraftAppVersionTemplate.go @@ -29,8 +29,8 @@ func (c *Client) PutDraftAppVersionTemplate(ctx context.Context, params *PutDraf type PutDraftAppVersionTemplateInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -43,8 +43,8 @@ type PutDraftAppVersionTemplateInput struct { // in the Examples section. The appTemplateBody JSON string has the following // structure: // - // * resources The list of logical resources that needs to be included - // in the Resilience Hub application. Type: Array Don't add the resources that you + // * resources The list of logical resources that must be included in + // the Resilience Hub application. Type: Array Don't add the resources that you // want to exclude. Each resources array item includes the following fields: // // * @@ -64,28 +64,36 @@ type PutDraftAppVersionTemplateInput struct { // terraformSourceName The name of the Terraform S3 state file this resource // belongs to. Type: String // - // * type The type of resource. Type: string + // * eksSourceName The name of the Amazon Elastic + // Kubernetes Service cluster and namespace this resource belongs to. This + // parameter accepts values in "eks-cluster/namespace" format. Type: String // - // * name The - // name of the resource. Type: String + // * type + // The type of resource. Type: string // - // * additionalInfo Additional configuration - // parameters for an AWS Resilience Hub application. Currently, this parameter - // accepts a key-value mapping (in a string format) of only one failover region and - // one associated account. Key: "failover-regions" Value: "[{"region":"", - // "accounts":[{"id":""}]}]" + // * name The name of the resource. Type: + // String // - // * appComponents The list of Application - // Components that this resource belongs to. If an Application Component is not - // part of the AWS Resilience Hub application, it will be added. Type: Array Each - // appComponents array item includes the following fields: + // * additionalInfo Additional configuration parameters for an Resilience + // Hub application. If you want to implement additionalInfo through the Resilience + // Hub console rather than using an API call, see Configure the application + // configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). + // Currently, this parameter accepts a key-value mapping (in a string format) of + // only one failover region and one associated account. Key: "failover-regions" + // Value: "[{"region":"", "accounts":[{"id":""}]}]" // - // * name The name of the - // Application Component. Type: String + // * + // appComponents The list of Application Components that this resource belongs to. + // If an Application Component is not part of the Resilience Hub application, it + // will be added. Type: Array Each appComponents array item includes the following + // fields: + // + // * name The name of the Application Component. Type: String // - // * type The type of Application Component. - // For more information about the types of Application Component, see Grouping - // resources in an AppComponent + // * type The + // type of Application Component. For more information about the types of + // Application Component, see Grouping resources in an AppComponent // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html). // Type: String // @@ -93,7 +101,10 @@ type PutDraftAppVersionTemplateInput struct { // to the Application Component. Type: Array of strings // // * additionalInfo - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter accepts a key-value mapping (in a string format) of // only one failover region and one associated account. Key: "failover-regions" // Value: "[{"region":"", "accounts":[{"id":""}]}]" @@ -114,29 +125,39 @@ type PutDraftAppVersionTemplateInput struct { // // * terraformSourceName // - // Each logicalResourceIds object - // includes the following fields: + // * eksSourceName // - // * identifier The identifier of the resource. - // Type: String + // Each + // logicalResourceIds object includes the following fields: // - // * logicalStackName The name of the CloudFormation stack this - // resource belongs to. Type: String + // * identifier The + // identifier of the resource. Type: String // - // * resourceGroupName The name of the resource - // group this resource belongs to. Type: String + // * logicalStackName The name of the + // CloudFormation stack this resource belongs to. Type: String // - // * terraformSourceName The name of - // the Terraform S3 state file this resource belongs to. Type: String + // * resourceGroupName + // The name of the resource group this resource belongs to. Type: String + // + // * + // terraformSourceName The name of the Terraform S3 state file this resource + // belongs to. Type: String // - // * version - // The AWS Resilience Hub application version. + // * eksSourceName The name of the Amazon Elastic + // Kubernetes Service cluster and namespace this resource belongs to. This + // parameter accepts values in "eks-cluster/namespace" format. Type: String + // + // * + // version The Resilience Hub application version. // // * additionalInfo Additional - // configuration parameters for an AWS Resilience Hub application. Currently, this - // parameter accepts a key-value mapping (in a string format) of only one failover - // region and one associated account. Key: "failover-regions" Value: - // "[{"region":"", "accounts":[{"id":""}]}]" + // configuration parameters for an Resilience Hub application. If you want to + // implement additionalInfo through the Resilience Hub console rather than using an + // API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). + // Currently, this parameter accepts a key-value mapping (in a string format) of + // only one failover region and one associated account. Key: "failover-regions" + // Value: "[{"region":"", "accounts":[{"id":""}]}]" // // This member is required. AppTemplateBody *string @@ -146,8 +167,8 @@ type PutDraftAppVersionTemplateInput struct { type PutDraftAppVersionTemplateOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_RemoveDraftAppVersionResourceMappings.go b/service/resiliencehub/api_op_RemoveDraftAppVersionResourceMappings.go index 7c6156c8ada..413a78101cb 100644 --- a/service/resiliencehub/api_op_RemoveDraftAppVersionResourceMappings.go +++ b/service/resiliencehub/api_op_RemoveDraftAppVersionResourceMappings.go @@ -28,8 +28,8 @@ func (c *Client) RemoveDraftAppVersionResourceMappings(ctx context.Context, para type RemoveDraftAppVersionResourceMappingsInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -65,8 +65,8 @@ type RemoveDraftAppVersionResourceMappingsInput struct { type RemoveDraftAppVersionResourceMappingsOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_ResolveAppVersionResources.go b/service/resiliencehub/api_op_ResolveAppVersionResources.go index deec49b1cb1..e6132cef400 100644 --- a/service/resiliencehub/api_op_ResolveAppVersionResources.go +++ b/service/resiliencehub/api_op_ResolveAppVersionResources.go @@ -29,8 +29,8 @@ func (c *Client) ResolveAppVersionResources(ctx context.Context, params *Resolve type ResolveAppVersionResourcesInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -48,8 +48,8 @@ type ResolveAppVersionResourcesInput struct { type ResolveAppVersionResourcesOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_StartAppAssessment.go b/service/resiliencehub/api_op_StartAppAssessment.go index 8a38185ed1b..33b658cd168 100644 --- a/service/resiliencehub/api_op_StartAppAssessment.go +++ b/service/resiliencehub/api_op_StartAppAssessment.go @@ -30,8 +30,8 @@ func (c *Client) StartAppAssessment(ctx context.Context, params *StartAppAssessm type StartAppAssessmentInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_UpdateApp.go b/service/resiliencehub/api_op_UpdateApp.go index 02bd89b35ad..3ced151afd4 100644 --- a/service/resiliencehub/api_op_UpdateApp.go +++ b/service/resiliencehub/api_op_UpdateApp.go @@ -29,8 +29,8 @@ func (c *Client) UpdateApp(ctx context.Context, params *UpdateAppInput, optFns . type UpdateAppInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. diff --git a/service/resiliencehub/api_op_UpdateAppVersion.go b/service/resiliencehub/api_op_UpdateAppVersion.go index 77a2a7cccaf..a96690f6b39 100644 --- a/service/resiliencehub/api_op_UpdateAppVersion.go +++ b/service/resiliencehub/api_op_UpdateAppVersion.go @@ -31,8 +31,8 @@ func (c *Client) UpdateAppVersion(ctx context.Context, params *UpdateAppVersionI type UpdateAppVersionInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -40,7 +40,10 @@ type UpdateAppVersionInput struct { // This member is required. AppArn *string - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter accepts a key-value mapping (in a string format) of // only one failover region and one associated account. Key: "failover-regions" // Value: "[{"region":"", "accounts":[{"id":""}]}]" @@ -51,8 +54,8 @@ type UpdateAppVersionInput struct { type UpdateAppVersionOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -60,12 +63,15 @@ type UpdateAppVersionOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter supports only failover region and account. AdditionalInfo map[string][]string diff --git a/service/resiliencehub/api_op_UpdateAppVersionAppComponent.go b/service/resiliencehub/api_op_UpdateAppVersionAppComponent.go index 9d019c36947..12ff13a01a9 100644 --- a/service/resiliencehub/api_op_UpdateAppVersionAppComponent.go +++ b/service/resiliencehub/api_op_UpdateAppVersionAppComponent.go @@ -32,8 +32,8 @@ func (c *Client) UpdateAppVersionAppComponent(ctx context.Context, params *Updat type UpdateAppVersionAppComponentInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -63,8 +63,8 @@ type UpdateAppVersionAppComponentInput struct { type UpdateAppVersionAppComponentOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -72,7 +72,7 @@ type UpdateAppVersionAppComponentOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/api_op_UpdateAppVersionResource.go b/service/resiliencehub/api_op_UpdateAppVersionResource.go index aedcb27d181..ecf72ed7cf1 100644 --- a/service/resiliencehub/api_op_UpdateAppVersionResource.go +++ b/service/resiliencehub/api_op_UpdateAppVersionResource.go @@ -40,8 +40,8 @@ func (c *Client) UpdateAppVersionResource(ctx context.Context, params *UpdateApp type UpdateAppVersionResourceInput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -53,8 +53,8 @@ type UpdateAppVersionResourceInput struct { AdditionalInfo map[string][]string // The list of Application Components that this resource belongs to. If an - // Application Component is not part of the AWS Resilience Hub application, it will - // be added. + // Application Component is not part of the Resilience Hub application, it will be + // added. AppComponents []string // The Amazon Web Services account that owns the physical resource. @@ -84,8 +84,8 @@ type UpdateAppVersionResourceInput struct { type UpdateAppVersionResourceOutput struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -93,7 +93,7 @@ type UpdateAppVersionResourceOutput struct { // This member is required. AppArn *string - // The AWS Resilience Hub application version. + // The Resilience Hub application version. // // This member is required. AppVersion *string diff --git a/service/resiliencehub/types/types.go b/service/resiliencehub/types/types.go index e2400d8761e..6b5fea2ff68 100644 --- a/service/resiliencehub/types/types.go +++ b/service/resiliencehub/types/types.go @@ -48,8 +48,8 @@ type AlarmRecommendation struct { // Defines an Resilience Hub application. type App struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -124,8 +124,8 @@ type AppAssessment struct { // This member is required. Invoker AssessmentInvoker - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -189,8 +189,8 @@ type AppAssessmentSummary struct { // This member is required. AssessmentStatus AssessmentStatus - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -239,7 +239,10 @@ type AppComponent struct { // This member is required. Type *string - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter accepts a key-value mapping (in a string format) of // only one failover region and one associated account. Key: "failover-regions" // Value: "[{"region":"", "accounts":[{"id":""}]}]" @@ -308,8 +311,8 @@ type AppInputSource struct { // Defines an application summary. type AppSummary struct { - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -586,7 +589,10 @@ type PhysicalResource struct { // This member is required. ResourceType *string - // Additional configuration parameters for an AWS Resilience Hub application. + // Additional configuration parameters for an Resilience Hub application. If you + // want to implement additionalInfo through the Resilience Hub console rather than + // using an API call, see Configure the application configuration parameters + // (https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html). // Currently, this parameter accepts a key-value mapping (in a string format) of // only one failover region and one associated account. Key: "failover-regions" // Value: "[{"region":"", "accounts":[{"id":""}]}]" @@ -713,8 +719,8 @@ type RecommendationTemplate struct { // This member is required. Status RecommendationTemplateStatus - // The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format - // for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more + // The Amazon Resource Name (ARN) of the Resilience Hub application. The format for + // this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more // information about ARNs, see Amazon Resource Names (ARNs) // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in // the AWS General Reference guide. @@ -838,8 +844,8 @@ type ResourceMapping struct { // stack. The name of the CloudFormation stack is contained in the logicalStackName // property. Resource The resource is mapped to another resource. The name of the // resource is contained in the resourceName property. ResourceGroup The resource - // is mapped to an Resource Groups. The name of the resource group is contained in - // the resourceGroupName property. + // is mapped to Resource Groups. The name of the resource group is contained in the + // resourceGroupName property. // // This member is required. MappingType ResourceMappingType @@ -991,7 +997,7 @@ type UnsupportedResource struct { // This member is required. ResourceType *string - // The status of unsupported resource. + // The status of the unsupported resource. UnsupportedResourceStatus *string noSmithyDocumentSerde diff --git a/service/s3/api_op_AbortMultipartUpload.go b/service/s3/api_op_AbortMultipartUpload.go index 042e848a387..5825cdbb8f8 100644 --- a/service/s3/api_op_AbortMultipartUpload.go +++ b/service/s3/api_op_AbortMultipartUpload.go @@ -70,13 +70,13 @@ type AbortMultipartUploadInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_CompleteMultipartUpload.go b/service/s3/api_op_CompleteMultipartUpload.go index 95ff6496863..8ff31909850 100644 --- a/service/s3/api_op_CompleteMultipartUpload.go +++ b/service/s3/api_op_CompleteMultipartUpload.go @@ -26,10 +26,16 @@ import ( // minutes to complete. After Amazon S3 begins processing the request, it sends an // HTTP response header that specifies a 200 OK response. While processing is in // progress, Amazon S3 periodically sends white space characters to keep the -// connection from timing out. Because a request could fail after the initial 200 -// OK response has been sent, it is important that you check the response body to -// determine whether the request succeeded. Note that if CompleteMultipartUpload -// fails, applications should be prepared to retry the failed requests. For more +// connection from timing out. A request could fail after the initial 200 OK +// response has been sent. This means that a 200 OK response can contain either a +// success or an error. If you call the S3 API directly, make sure to design your +// application to parse the contents of the response and handle it appropriately. +// If you use Amazon Web Services SDKs, SDKs handle this condition. The SDKs detect +// the embedded error and apply error handling per your configuration settings +// (including automatically retrying the request as appropriate). If the condition +// persists, the SDKs throws an exception (or, for the SDKs that don't use +// exceptions, they return the error). Note that if CompleteMultipartUpload fails, +// applications should be prepared to retry the failed requests. For more // information, see Amazon S3 Error Best Practices // (https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html). You // cannot use Content-Type: application/x-www-form-urlencoded with Complete @@ -123,13 +129,13 @@ type CompleteMultipartUploadInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -229,13 +235,13 @@ type CompleteMultipartUploadOutput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. Bucket *string @@ -302,14 +308,12 @@ type CompleteMultipartUploadOutput struct { RequestCharged types.RequestCharged // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for the object. SSEKMSKeyId *string - // If you specified server-side encryption either with an Amazon S3-managed - // encryption key or an Amazon Web Services KMS key in your initiate multipart - // upload request, the response includes this header. It confirms the encryption - // algorithm that Amazon S3 used to encrypt the object. + // The server-side encryption algorithm used when storing this object in Amazon S3 + // (for example, AES256, aws:kms). ServerSideEncryption types.ServerSideEncryption // Version ID of the newly created object, in case the bucket has versioning turned diff --git a/service/s3/api_op_CopyObject.go b/service/s3/api_op_CopyObject.go index 477900778d7..dc10efb7929 100644 --- a/service/s3/api_op_CopyObject.go +++ b/service/s3/api_op_CopyObject.go @@ -30,10 +30,15 @@ import ( // the files. If the error occurs before the copy action starts, you receive a // standard Amazon S3 error. If the error occurs during the copy operation, the // error response is embedded in the 200 OK response. This means that a 200 OK -// response can contain either a success or an error. Design your application to -// parse the contents of the response and handle it appropriately. If the copy is -// successful, you receive a response with information about the copied object. If -// the request is an HTTP 1.1 request, the response is chunk encoded. If it were +// response can contain either a success or an error. If you call the S3 API +// directly, make sure to design your application to parse the contents of the +// response and handle it appropriately. If you use Amazon Web Services SDKs, SDKs +// handle this condition. The SDKs detect the embedded error and apply error +// handling per your configuration settings (including automatically retrying the +// request as appropriate). If the condition persists, the SDKs throws an exception +// (or, for the SDKs that don't use exceptions, they return the error). If the copy +// is successful, you receive a response with information about the copied object. +// If the request is an HTTP 1.1 request, the response is chunk encoded. If it were // not, it would not contain the content-length, and you would need to read the // entire body. The copy request charge is based on the storage class and Region // that you specify for the destination object. For pricing information, see Amazon @@ -57,50 +62,66 @@ import ( // the Amazon S3 User Guide. For a complete list of Amazon S3-specific condition // keys, see Actions, Resources, and Condition Keys for Amazon S3 // (https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html). -// x-amz-copy-source-if Headers To only copy an object under certain conditions, -// such as whether the Etag matches or whether the object was modified before or -// after a specified date, use the following request parameters: +// x-amz-website-redirect-location is unique to each object and must be specified +// in the request headers to copy the value. x-amz-copy-source-if Headers To only +// copy an object under certain conditions, such as whether the Etag matches or +// whether the object was modified before or after a specified date, use the +// following request parameters: +// +// * x-amz-copy-source-if-match // // * -// x-amz-copy-source-if-match +// x-amz-copy-source-if-none-match // -// * x-amz-copy-source-if-none-match +// * x-amz-copy-source-if-unmodified-since // // * -// x-amz-copy-source-if-unmodified-since -// -// * x-amz-copy-source-if-modified-since +// x-amz-copy-source-if-modified-since // -// If -// both the x-amz-copy-source-if-match and x-amz-copy-source-if-unmodified-since -// headers are present in the request and evaluate as follows, Amazon S3 returns -// 200 OK and copies the data: +// If both the x-amz-copy-source-if-match and +// x-amz-copy-source-if-unmodified-since headers are present in the request and +// evaluate as follows, Amazon S3 returns 200 OK and copies the data: // -// * x-amz-copy-source-if-match condition evaluates to -// true +// * +// x-amz-copy-source-if-match condition evaluates to true // -// * x-amz-copy-source-if-unmodified-since condition evaluates to false +// * +// x-amz-copy-source-if-unmodified-since condition evaluates to false // -// If -// both the x-amz-copy-source-if-none-match and x-amz-copy-source-if-modified-since -// headers are present in the request and evaluate as follows, Amazon S3 returns -// the 412 Precondition Failed response code: +// If both the +// x-amz-copy-source-if-none-match and x-amz-copy-source-if-modified-since headers +// are present in the request and evaluate as follows, Amazon S3 returns the 412 +// Precondition Failed response code: // -// * x-amz-copy-source-if-none-match -// condition evaluates to false +// * x-amz-copy-source-if-none-match condition +// evaluates to false // -// * x-amz-copy-source-if-modified-since condition -// evaluates to true +// * x-amz-copy-source-if-modified-since condition evaluates to +// true // -// All headers with the x-amz- prefix, including -// x-amz-copy-source, must be signed. Server-side encryption When you perform a -// CopyObject operation, you can optionally use the appropriate encryption-related -// headers to encrypt the object using server-side encryption with Amazon Web -// Services managed encryption keys (SSE-S3 or SSE-KMS) or a customer-provided -// encryption key. With server-side encryption, Amazon S3 encrypts your data as it -// writes it to disks in its data centers and decrypts the data when you access it. -// For more information about server-side encryption, see Using Server-Side -// Encryption +// All headers with the x-amz- prefix, including x-amz-copy-source, must be +// signed. Server-side encryption Amazon S3 automatically encrypts all new objects +// that are copied to an S3 bucket. When copying an object, if you don't specify +// encryption information in your copy request, the encryption setting of the +// target object is set to the default encryption configuration of the destination +// bucket. By default, all buckets have a base level of encryption configuration +// that uses server-side encryption with Amazon S3 managed keys (SSE-S3). If the +// destination bucket has a default encryption configuration that uses server-side +// encryption with an Key Management Service (KMS) key (SSE-KMS), or a +// customer-provided encryption key (SSE-C), Amazon S3 uses the corresponding KMS +// key, or a customer-provided key to encrypt the target object copy. When you +// perform a CopyObject operation, if you want to use a different type of +// encryption setting for the target object, you can use other appropriate +// encryption-related headers to encrypt the target object with a KMS key, an +// Amazon S3 managed key, or a customer-provided key. With server-side encryption, +// Amazon S3 encrypts your data as it writes it to disks in its data centers and +// decrypts the data when you access it. If the encryption setting in your request +// is different from the default encryption configuration of the destination +// bucket, the encryption setting in your request takes precedence. If the source +// object for the copy is stored in Amazon S3 using SSE-C, you must provide the +// necessary encryption information in your request so that Amazon S3 can decrypt +// the object for copying. For more information about server-side encryption, see +// Using Server-Side Encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html). If // a target object uses SSE-KMS, you can enable an S3 Bucket Key for the object. // For more information, see Amazon S3 Bucket Keys @@ -182,13 +203,13 @@ type CopyObjectInput struct { // SDKs, you provide the access point ARN in place of the bucket name. For more // information about access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -404,7 +425,9 @@ type CopyObjectInput struct { // If the bucket is configured as a website, redirects requests for this object to // another object in the same bucket or to an external URL. Amazon S3 stores the - // value of this header in the object metadata. + // value of this header in the object metadata. This value is unique to each object + // and is not copied when using the x-amz-metadata-directive header. Instead, you + // may opt to provide this header in combination with the directive. WebsiteRedirectLocation *string noSmithyDocumentSerde @@ -444,8 +467,8 @@ type CopyObjectOutput struct { SSEKMSEncryptionContext *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for the object. SSEKMSKeyId *string // The server-side encryption algorithm used when storing this object in Amazon S3 diff --git a/service/s3/api_op_CreateMultipartUpload.go b/service/s3/api_op_CreateMultipartUpload.go index 825feebd2c8..c971649ce1f 100644 --- a/service/s3/api_op_CreateMultipartUpload.go +++ b/service/s3/api_op_CreateMultipartUpload.go @@ -42,23 +42,41 @@ import ( // being charged for storing the uploaded parts, you must either complete or abort // the multipart upload. Amazon S3 frees up the space used to store the parts and // stop charging you for storing them only after you either complete or abort a -// multipart upload. You can optionally request server-side encryption. For -// server-side encryption, Amazon S3 encrypts your data as it writes it to disks in -// its data centers and decrypts it when you access it. You can provide your own -// encryption key, or use Amazon Web Services KMS keys or Amazon S3-managed -// encryption keys. If you choose to provide your own encryption key, the request -// headers you provide in UploadPart +// multipart upload. Server-side encryption is for data encryption at rest. Amazon +// S3 encrypts your data as it writes it to disks in its data centers and decrypts +// it when you access it. Amazon S3 automatically encrypts all new objects that are +// uploaded to an S3 bucket. When doing a multipart upload, if you don't specify +// encryption information in your request, the encryption setting of the uploaded +// parts is set to the default encryption configuration of the destination bucket. +// By default, all buckets have a base level of encryption configuration that uses +// server-side encryption with Amazon S3 managed keys (SSE-S3). If the destination +// bucket has a default encryption configuration that uses server-side encryption +// with an Key Management Service (KMS) key (SSE-KMS), or a customer-provided +// encryption key (SSE-C), Amazon S3 uses the corresponding KMS key, or a +// customer-provided key to encrypt the uploaded parts. When you perform a +// CreateMultipartUpload operation, if you want to use a different type of +// encryption setting for the uploaded parts, you can request that Amazon S3 +// encrypts the object with a KMS key, an Amazon S3 managed key, or a +// customer-provided key. If the encryption setting in your request is different +// from the default encryption configuration of the destination bucket, the +// encryption setting in your request takes precedence. If you choose to provide +// your own encryption key, the request headers you provide in UploadPart // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) and // UploadPartCopy // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html) // requests must match the headers you used in the request to initiate the upload -// by using CreateMultipartUpload. To perform a multipart upload with encryption -// using an Amazon Web Services KMS key, the requester must have permission to the +// by using CreateMultipartUpload. you can request that Amazon S3 save the uploaded +// parts encrypted with server-side encryption with an Amazon S3 managed key +// (SSE-S3), an Key Management Service (KMS) key (SSE-KMS), or a customer-provided +// encryption key (SSE-C). To perform a multipart upload with encryption by using +// an Amazon Web Services KMS key, the requester must have permission to the // kms:Decrypt and kms:GenerateDataKey* actions on the key. These permissions are // required because Amazon S3 must decrypt and read data from the encrypted file // parts before it completes the multipart upload. For more information, see // Multipart upload API and permissions // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions) +// and Protecting data using server-side encryption with Amazon Web Services KMS +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html) // in the Amazon S3 User Guide. If your Identity and Access Management (IAM) user // or role is in the same Amazon Web Services account as the KMS key, then you must // have these permissions on the key policy. If your IAM user or role belongs to a @@ -84,23 +102,24 @@ import ( // // You can // use either a canned ACL or specify access permissions explicitly. You cannot do -// both. Server-Side- Encryption-Specific Request Headers You can optionally tell -// Amazon S3 to encrypt data at rest using server-side encryption. Server-side -// encryption is for data encryption at rest. Amazon S3 encrypts your data as it -// writes it to disks in its data centers and decrypts it when you access it. The -// option you use depends on whether you want to use Amazon Web Services managed -// encryption keys or provide your own encryption key. -// -// * Use encryption keys -// managed by Amazon S3 or customer managed key stored in Amazon Web Services Key -// Management Service (Amazon Web Services KMS) – If you want Amazon Web Services -// to manage the keys used to encrypt data, specify the following headers in the -// request. -// -// * x-amz-server-side-encryption +// both. Server-Side- Encryption-Specific Request Headers Amazon S3 encrypts data +// by using server-side encryption with an Amazon S3 managed key (SSE-S3) by +// default. Server-side encryption is for data encryption at rest. Amazon S3 +// encrypts your data as it writes it to disks in its data centers and decrypts it +// when you access it. You can request that Amazon S3 encrypts data at rest by +// using server-side encryption with other key options. The option you use depends +// on whether you want to use KMS keys (SSE-KMS) or provide your own encryption +// keys (SSE-C). +// +// * Use KMS keys (SSE-KMS) that include the Amazon Web Services +// managed key (aws/s3) and KMS customer managed keys stored in Key Management +// Service (KMS) – If you want Amazon Web Services to manage the keys used to +// encrypt data, specify the following headers in the request. // // * -// x-amz-server-side-encryption-aws-kms-key-id +// x-amz-server-side-encryption +// +// * x-amz-server-side-encryption-aws-kms-key-id // // * // x-amz-server-side-encryption-context @@ -108,15 +127,15 @@ import ( // If you specify // x-amz-server-side-encryption:aws:kms, but don't provide // x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses the Amazon Web -// Services managed key in Amazon Web Services KMS to protect the data. All GET and -// PUT requests for an object protected by Amazon Web Services KMS fail if you -// don't make them with SSL or by using SigV4. For more information about -// server-side encryption with KMS key (SSE-KMS), see Protecting Data Using -// Server-Side Encryption with KMS keys -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html). +// Services managed key (aws/s3 key) in KMS to protect the data. All GET and PUT +// requests for an object protected by KMS fail if you don't make them by using +// Secure Sockets Layer (SSL), Transport Layer Security (TLS), or Signature Version +// 4. For more information about server-side encryption with KMS keys (SSE-KMS), +// see Protecting Data Using Server-Side Encryption with KMS keys +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html). // // * -// Use customer-provided encryption keys – If you want to manage your own +// Use customer-provided encryption keys (SSE-C) – If you want to manage your own // encryption keys, provide all the following headers in the request. // // * @@ -129,9 +148,10 @@ import ( // x-amz-server-side-encryption-customer-key-MD5 // // For more information about -// server-side encryption with KMS keys (SSE-KMS), see Protecting Data Using -// Server-Side Encryption with KMS keys -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html). +// server-side encryption with customer-provided encryption keys (SSE-C), see +// Protecting data using server-side encryption with customer-provided encryption +// keys (SSE-C) +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html). // // Access-Control-List // (ACL)-Specific Request Headers You also can use the following access @@ -258,13 +278,13 @@ type CreateMultipartUploadInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -375,11 +395,11 @@ type CreateMultipartUploadInput struct { // JSON with the encryption context key-value pairs. SSEKMSEncryptionContext *string - // Specifies the ID of the symmetric customer managed key to use for object - // encryption. All GET and PUT requests for an object protected by Amazon Web - // Services KMS will fail if not made via SSL or using SigV4. For information about - // configuring using any of the officially supported Amazon Web Services SDKs and - // Amazon Web Services CLI, see Specifying the Signature Version in Request + // Specifies the ID of the symmetric encryption customer managed key to use for + // object encryption. All GET and PUT requests for an object protected by Amazon + // Web Services KMS will fail if not made via SSL or using SigV4. For information + // about configuring using any of the officially supported Amazon Web Services SDKs + // and Amazon Web Services CLI, see Specifying the Signature Version in Request // Authentication // (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version) // in the Amazon S3 User Guide. @@ -436,13 +456,13 @@ type CreateMultipartUploadOutput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. Bucket *string @@ -476,8 +496,8 @@ type CreateMultipartUploadOutput struct { SSEKMSEncryptionContext *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for the object. SSEKMSKeyId *string // The server-side encryption algorithm used when storing this object in Amazon S3 diff --git a/service/s3/api_op_DeleteBucketEncryption.go b/service/s3/api_op_DeleteBucketEncryption.go index 9c3201f6ded..9f5084dc320 100644 --- a/service/s3/api_op_DeleteBucketEncryption.go +++ b/service/s3/api_op_DeleteBucketEncryption.go @@ -11,9 +11,10 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// This implementation of the DELETE action removes default encryption from the -// bucket. For information about the Amazon S3 default encryption feature, see -// Amazon S3 Default Bucket Encryption +// This implementation of the DELETE action resets the default encryption for the +// bucket as server-side encryption with Amazon S3 managed keys (SSE-S3). For +// information about the bucket default encryption feature, see Amazon S3 Bucket +// Default Encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) in the // Amazon S3 User Guide. To use this operation, you must have permissions to // perform the s3:PutEncryptionConfiguration action. The bucket owner has this diff --git a/service/s3/api_op_DeleteBucketMetricsConfiguration.go b/service/s3/api_op_DeleteBucketMetricsConfiguration.go index cc08f04b787..54bfa8cb86b 100644 --- a/service/s3/api_op_DeleteBucketMetricsConfiguration.go +++ b/service/s3/api_op_DeleteBucketMetricsConfiguration.go @@ -63,7 +63,8 @@ type DeleteBucketMetricsConfigurationInput struct { // This member is required. Bucket *string - // The ID used to identify the metrics configuration. + // The ID used to identify the metrics configuration. The ID has a 64 character + // limit and can only contain letters, numbers, periods, dashes, and underscores. // // This member is required. Id *string diff --git a/service/s3/api_op_DeleteObject.go b/service/s3/api_op_DeleteObject.go index 4b4f12127eb..5c421af11aa 100644 --- a/service/s3/api_op_DeleteObject.go +++ b/service/s3/api_op_DeleteObject.go @@ -15,14 +15,14 @@ import ( // Removes the null version (if there is one) of an object and inserts a delete // marker, which becomes the latest version of the object. If there isn't a null // version, Amazon S3 does not remove any objects but will still respond that the -// command was successful. To remove a specific version, you must be the bucket -// owner and you must use the version Id subresource. Using this subresource -// permanently deletes the version. If the object deleted is a delete marker, -// Amazon S3 sets the response header, x-amz-delete-marker, to true. If the object -// you want to delete is in a bucket where the bucket versioning configuration is -// MFA Delete enabled, you must include the x-amz-mfa request header in the DELETE -// versionId request. Requests that include x-amz-mfa must use HTTPS. For more -// information about MFA Delete, see Using MFA Delete +// command was successful. To remove a specific version, you must use the version +// Id subresource. Using this subresource permanently deletes the version. If the +// object deleted is a delete marker, Amazon S3 sets the response header, +// x-amz-delete-marker, to true. If the object you want to delete is in a bucket +// where the bucket versioning configuration is MFA Delete enabled, you must +// include the x-amz-mfa request header in the DELETE versionId request. Requests +// that include x-amz-mfa must use HTTPS. For more information about MFA Delete, +// see Using MFA Delete // (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html). To see // sample requests that use versioning, see Sample Request // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete). @@ -61,13 +61,13 @@ type DeleteObjectInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_DeleteObjectTagging.go b/service/s3/api_op_DeleteObjectTagging.go index 0d1bb73994f..64877b5b3d2 100644 --- a/service/s3/api_op_DeleteObjectTagging.go +++ b/service/s3/api_op_DeleteObjectTagging.go @@ -18,7 +18,7 @@ import ( // action. To delete tags of a specific object version, add the versionId query // parameter in the request. You will need permission for the // s3:DeleteObjectVersionTagging action. The following operations are related to -// DeleteBucketMetricsConfiguration: +// DeleteObjectTagging: // // * PutObjectTagging // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) @@ -51,13 +51,13 @@ type DeleteObjectTaggingInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_DeleteObjects.go b/service/s3/api_op_DeleteObjects.go index 50078da53bc..fb0e4bdce09 100644 --- a/service/s3/api_op_DeleteObjects.go +++ b/service/s3/api_op_DeleteObjects.go @@ -83,13 +83,13 @@ type DeleteObjectsInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_GetBucketAcl.go b/service/s3/api_op_GetBucketAcl.go index 610762883aa..2064c614da4 100644 --- a/service/s3/api_op_GetBucketAcl.go +++ b/service/s3/api_op_GetBucketAcl.go @@ -16,11 +16,12 @@ import ( // access control list (ACL) of a bucket. To use GET to return the ACL of the // bucket, you must have READ_ACP access to the bucket. If READ_ACP permission is // granted to the anonymous user, you can return the ACL of the bucket without -// using an authorization header. If your bucket uses the bucket owner enforced -// setting for S3 Object Ownership, requests to read ACLs are still supported and -// return the bucket-owner-full-control ACL with the owner being the account that -// created the bucket. For more information, see Controlling object ownership and -// disabling ACLs +// using an authorization header. To use this API against an access point, provide +// the alias of the access point in place of the bucket name. If your bucket uses +// the bucket owner enforced setting for S3 Object Ownership, requests to read ACLs +// are still supported and return the bucket-owner-full-control ACL with the owner +// being the account that created the bucket. For more information, see +// Controlling object ownership and disabling ACLs // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) // in the Amazon S3 User Guide. Related Resources // diff --git a/service/s3/api_op_GetBucketCors.go b/service/s3/api_op_GetBucketCors.go index 0ed61273a75..b6004fdbbcc 100644 --- a/service/s3/api_op_GetBucketCors.go +++ b/service/s3/api_op_GetBucketCors.go @@ -15,8 +15,9 @@ import ( // Returns the Cross-Origin Resource Sharing (CORS) configuration information set // for the bucket. To use this operation, you must have permission to perform the // s3:GetBucketCORS action. By default, the bucket owner has this permission and -// can grant it to others. For more information about CORS, see Enabling -// Cross-Origin Resource Sharing +// can grant it to others. To use this API against an access point, provide the +// alias of the access point in place of the bucket name. For more information +// about CORS, see Enabling Cross-Origin Resource Sharing // (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html). The following // operations are related to GetBucketCors: // diff --git a/service/s3/api_op_GetBucketEncryption.go b/service/s3/api_op_GetBucketEncryption.go index 7fa92fc5fd2..526faa8c25b 100644 --- a/service/s3/api_op_GetBucketEncryption.go +++ b/service/s3/api_op_GetBucketEncryption.go @@ -12,15 +12,15 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Returns the default encryption configuration for an Amazon S3 bucket. If the -// bucket does not have a default encryption configuration, GetBucketEncryption -// returns ServerSideEncryptionConfigurationNotFoundError. For information about -// the Amazon S3 default encryption feature, see Amazon S3 Default Bucket +// Returns the default encryption configuration for an Amazon S3 bucket. By +// default, all buckets have a default encryption configuration that uses +// server-side encryption with Amazon S3 managed keys (SSE-S3). For information +// about the bucket default encryption feature, see Amazon S3 Bucket Default // Encryption -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html). To use -// this operation, you must have permission to perform the -// s3:GetEncryptionConfiguration action. The bucket owner has this permission by -// default. The bucket owner can grant this permission to others. For more +// (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) in the +// Amazon S3 User Guide. To use this operation, you must have permission to perform +// the s3:GetEncryptionConfiguration action. The bucket owner has this permission +// by default. The bucket owner can grant this permission to others. For more // information about permissions, see Permissions Related to Bucket Subresource // Operations // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) diff --git a/service/s3/api_op_GetBucketLocation.go b/service/s3/api_op_GetBucketLocation.go index fb8ff30fd41..38f287beffd 100644 --- a/service/s3/api_op_GetBucketLocation.go +++ b/service/s3/api_op_GetBucketLocation.go @@ -25,10 +25,13 @@ import ( // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html). To use // this implementation of the operation, you must be the bucket owner. To use this // API against an access point, provide the alias of the access point in place of -// the bucket name. The following operations are related to GetBucketLocation: +// the bucket name. For requests made using Amazon Web Services Signature Version 4 +// (SigV4), we recommend that you use HeadBucket +// (https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html) to return +// the bucket Region instead of GetBucketLocation. The following operations are +// related to GetBucketLocation: // -// * -// GetObject +// * GetObject // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) // // * diff --git a/service/s3/api_op_GetBucketLogging.go b/service/s3/api_op_GetBucketLogging.go index ca115886d50..0a1c6389547 100644 --- a/service/s3/api_op_GetBucketLogging.go +++ b/service/s3/api_op_GetBucketLogging.go @@ -13,8 +13,8 @@ import ( ) // Returns the logging status of a bucket and the permissions users have to view -// and modify that status. To use GET, you must be the bucket owner. The following -// operations are related to GetBucketLogging: +// and modify that status. The following operations are related to +// GetBucketLogging: // // * CreateBucket // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) diff --git a/service/s3/api_op_GetBucketMetricsConfiguration.go b/service/s3/api_op_GetBucketMetricsConfiguration.go index 22cf389cd88..c1883a434a1 100644 --- a/service/s3/api_op_GetBucketMetricsConfiguration.go +++ b/service/s3/api_op_GetBucketMetricsConfiguration.go @@ -64,7 +64,8 @@ type GetBucketMetricsConfigurationInput struct { // This member is required. Bucket *string - // The ID used to identify the metrics configuration. + // The ID used to identify the metrics configuration. The ID has a 64 character + // limit and can only contain letters, numbers, periods, dashes, and underscores. // // This member is required. Id *string diff --git a/service/s3/api_op_GetBucketNotificationConfiguration.go b/service/s3/api_op_GetBucketNotificationConfiguration.go index cbf103a7fd1..c2e1df60c71 100644 --- a/service/s3/api_op_GetBucketNotificationConfiguration.go +++ b/service/s3/api_op_GetBucketNotificationConfiguration.go @@ -17,9 +17,10 @@ import ( // element. By default, you must be the bucket owner to read the notification // configuration of a bucket. However, the bucket owner can use a bucket policy to // grant permission to other users to read this configuration with the -// s3:GetBucketNotification permission. For more information about setting and -// reading the notification configuration on a bucket, see Setting Up Notification -// of Bucket Events +// s3:GetBucketNotification permission. To use this API against an access point, +// provide the alias of the access point in place of the bucket name. For more +// information about setting and reading the notification configuration on a +// bucket, see Setting Up Notification of Bucket Events // (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html). For // more information about bucket policies, see Using Bucket Policies // (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html). The diff --git a/service/s3/api_op_GetBucketPolicy.go b/service/s3/api_op_GetBucketPolicy.go index f16c84cddf1..5a7df8f3e0f 100644 --- a/service/s3/api_op_GetBucketPolicy.go +++ b/service/s3/api_op_GetBucketPolicy.go @@ -21,8 +21,9 @@ import ( // Method Not Allowed error. As a security precaution, the root user of the Amazon // Web Services account that owns a bucket can always use this operation, even if // the policy explicitly denies the root user the ability to perform this action. -// For more information about bucket policies, see Using Bucket Policies and User -// Policies +// To use this API against an access point, provide the alias of the access point +// in place of the bucket name. For more information about bucket policies, see +// Using Bucket Policies and User Policies // (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html). The // following action is related to GetBucketPolicy: // diff --git a/service/s3/api_op_GetObject.go b/service/s3/api_op_GetObject.go index 92c38bed815..9647cbd5bc2 100644 --- a/service/s3/api_op_GetObject.go +++ b/service/s3/api_op_GetObject.go @@ -37,7 +37,7 @@ import ( // Archive tiers, before you can retrieve the object you must first restore a copy // using RestoreObject // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html). -// Otherwise, this action returns an InvalidObjectStateError error. For information +// Otherwise, this action returns an InvalidObjectState error. For information // about restoring archived objects, see Restoring Archived Objects // (https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html). // Encryption request headers, like x-amz-server-side-encryption, should not be @@ -85,14 +85,16 @@ import ( // * If you // supply a versionId, you need the s3:GetObjectVersion permission to access a // specific version of an object. If you request a specific version, you do not -// need to have the s3:GetObject permission. +// need to have the s3:GetObject permission. If you request the current version +// without a specific version ID, only s3:GetObject permission is required. +// s3:GetObjectVersion permission won't be required. // -// * If the current version of the -// object is a delete marker, Amazon S3 behaves as if the object was deleted and -// includes x-amz-delete-marker: true in the response. +// * If the current version of +// the object is a delete marker, Amazon S3 behaves as if the object was deleted +// and includes x-amz-delete-marker: true in the response. // -// For more information about -// versioning, see PutBucketVersioning +// For more information +// about versioning, see PutBucketVersioning // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketVersioning.html). // Overriding Response Header Values There are times when you want to override // certain response header values in a GET response. For example, you might @@ -167,13 +169,13 @@ type GetObjectInput struct { // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) // in the Amazon S3 User Guide. When using an Object Lambda access point the // hostname takes the form - // AccessPointName-AccountId.s3-object-lambda.Region.amazonaws.com. When using this - // action with Amazon S3 on Outposts, you must direct requests to the S3 on + // AccessPointName-AccountId.s3-object-lambda.Region.amazonaws.com. When you use + // this action with Amazon S3 on Outposts, you must direct requests to the S3 on // Outposts hostname. The S3 on Outposts hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -215,10 +217,9 @@ type GetObjectInput struct { PartNumber int32 // Downloads the specified range bytes of an object. For more information about the - // HTTP Range header, see - // https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35 - // (https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). Amazon S3 - // doesn't support retrieving multiple ranges of data per GET request. + // HTTP Range header, see https://www.rfc-editor.org/rfc/rfc9110.html#name-range + // (https://www.rfc-editor.org/rfc/rfc9110.html#name-range). Amazon S3 doesn't + // support retrieving multiple ranges of data per GET request. Range *string // Confirms that the requester knows that they will be charged for the request. @@ -403,8 +404,8 @@ type GetObjectOutput struct { SSECustomerKeyMD5 *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for the object. SSEKMSKeyId *string // The server-side encryption algorithm used when storing this object in Amazon S3 diff --git a/service/s3/api_op_GetObjectAttributes.go b/service/s3/api_op_GetObjectAttributes.go index fb1683e7d2d..7743abc0fb0 100644 --- a/service/s3/api_op_GetObjectAttributes.go +++ b/service/s3/api_op_GetObjectAttributes.go @@ -16,16 +16,15 @@ import ( // Retrieves all the metadata from an object without returning the object itself. // This action is useful if you're interested only in an object's metadata. To use // GetObjectAttributes, you must have READ access to the object. -// GetObjectAttributes combines the functionality of GetObjectAcl, -// GetObjectLegalHold, GetObjectLockConfiguration, GetObjectRetention, -// GetObjectTagging, HeadObject, and ListParts. All of the data returned with each -// of those individual calls can be returned with a single call to -// GetObjectAttributes. If you encrypt an object by using server-side encryption -// with customer-provided encryption keys (SSE-C) when you store the object in -// Amazon S3, then when you retrieve the metadata from the object, you must use the -// following headers: +// GetObjectAttributes combines the functionality of HeadObject and ListParts. All +// of the data returned with each of those individual calls can be returned with a +// single call to GetObjectAttributes. If you encrypt an object by using +// server-side encryption with customer-provided encryption keys (SSE-C) when you +// store the object in Amazon S3, then when you retrieve the metadata from the +// object, you must use the following headers: // -// * x-amz-server-side-encryption-customer-algorithm +// * +// x-amz-server-side-encryption-customer-algorithm // // * // x-amz-server-side-encryption-customer-key @@ -42,23 +41,23 @@ import ( // x-amz-server-side-encryption, should not be sent for GET requests if your object // uses server-side encryption with Amazon Web Services KMS keys stored in Amazon // Web Services Key Management Service (SSE-KMS) or server-side encryption with -// Amazon S3 managed encryption keys (SSE-S3). If your object does use these types -// of keys, you'll get an HTTP 400 Bad Request error. +// Amazon S3 managed keys (SSE-S3). If your object does use these types of keys, +// you'll get an HTTP 400 Bad Request error. // -// * The last modified property -// in this case is the creation date of the object. +// * The last modified property in this +// case is the creation date of the object. // -// Consider the following when -// using request headers: +// Consider the following when using +// request headers: // -// * If both of the If-Match and If-Unmodified-Since -// headers are present in the request as follows, then Amazon S3 returns the HTTP -// status code 200 OK and the data requested: +// * If both of the If-Match and If-Unmodified-Since headers are +// present in the request as follows, then Amazon S3 returns the HTTP status code +// 200 OK and the data requested: // -// * If-Match condition evaluates to -// true. +// * If-Match condition evaluates to true. // -// * If-Unmodified-Since condition evaluates to false. +// * +// If-Unmodified-Since condition evaluates to false. // // * If both of the // If-None-Match and If-Modified-Since headers are present in the request as @@ -146,13 +145,13 @@ type GetObjectAttributesInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_GetObjectTagging.go b/service/s3/api_op_GetObjectTagging.go index cec5210c243..7786affd220 100644 --- a/service/s3/api_op_GetObjectTagging.go +++ b/service/s3/api_op_GetObjectTagging.go @@ -59,13 +59,13 @@ type GetObjectTaggingInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_GetObjectTorrent.go b/service/s3/api_op_GetObjectTorrent.go index fa71442c286..a63f4606593 100644 --- a/service/s3/api_op_GetObjectTorrent.go +++ b/service/s3/api_op_GetObjectTorrent.go @@ -14,14 +14,11 @@ import ( ) // Returns torrent files from a bucket. BitTorrent can save you bandwidth when -// you're distributing large files. For more information about BitTorrent, see -// Using BitTorrent with Amazon S3 -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html). You can get -// torrent only for objects that are less than 5 GB in size, and that are not -// encrypted using server-side encryption with a customer-provided encryption key. -// To use GET, you must have READ access to the object. This action is not -// supported by Amazon S3 on Outposts. The following action is related to -// GetObjectTorrent: +// you're distributing large files. You can get torrent only for objects that are +// less than 5 GB in size, and that are not encrypted using server-side encryption +// with a customer-provided encryption key. To use GET, you must have READ access +// to the object. This action is not supported by Amazon S3 on Outposts. The +// following action is related to GetObjectTorrent: // // * GetObject // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) diff --git a/service/s3/api_op_HeadBucket.go b/service/s3/api_op_HeadBucket.go index c3d9a16f25c..9214bb87375 100644 --- a/service/s3/api_op_HeadBucket.go +++ b/service/s3/api_op_HeadBucket.go @@ -20,11 +20,11 @@ import ( // This action is useful to determine if a bucket exists and you have permission to // access it. The action returns a 200 OK if the bucket exists and you have // permission to access it. If the bucket does not exist or you do not have -// permission to access it, the HEAD request returns a generic 404 Not Found or 403 -// Forbidden code. A message body is not included, so you cannot determine the -// exception beyond these error codes. To use this operation, you must have -// permissions to perform the s3:ListBucket action. The bucket owner has this -// permission by default and can grant this permission to others. For more +// permission to access it, the HEAD request returns a generic 400 Bad Request, 403 +// Forbidden or 404 Not Found code. A message body is not included, so you cannot +// determine the exception beyond these error codes. To use this operation, you +// must have permissions to perform the s3:ListBucket action. The bucket owner has +// this permission by default and can grant this permission to others. For more // information about permissions, see Permissions Related to Bucket Subresource // Operations // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) @@ -62,13 +62,13 @@ type HeadBucketInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_HeadObject.go b/service/s3/api_op_HeadObject.go index 1e745a7e5ce..a9dd06b8e40 100644 --- a/service/s3/api_op_HeadObject.go +++ b/service/s3/api_op_HeadObject.go @@ -23,9 +23,9 @@ import ( // To use HEAD, you must have READ access to the object. A HEAD request has the // same options as a GET action on an object. The response is identical to the GET // response except that there is no response body. Because of this, if the HEAD -// request generates an error, it returns a generic 404 Not Found or 403 Forbidden -// code. It is not possible to retrieve the exact exception beyond these error -// codes. If you encrypt an object by using server-side encryption with +// request generates an error, it returns a generic 400 Bad Request, 403 Forbidden +// or 404 Not Found code. It is not possible to retrieve the exact exception beyond +// these error codes. If you encrypt an object by using server-side encryption with // customer-provided encryption keys (SSE-C) when you store the object in Amazon // S3, then when you retrieve the metadata from the object, you must use the // following headers: @@ -130,13 +130,13 @@ type HeadObjectInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -181,8 +181,9 @@ type HeadObjectInput struct { // object. PartNumber int32 - // Because HeadObject returns only the metadata for an object, this parameter has - // no effect. + // HeadObject returns only the metadata for an object. If the Range is satisfiable, + // only the ContentLength is affected in the response. If the Range is not + // satisfiable, S3 returns a 416 - Requested Range Not Satisfiable error. Range *string // Confirms that the requester knows that they will be charged for the request. @@ -393,14 +394,12 @@ type HeadObjectOutput struct { SSECustomerKeyMD5 *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for the object. SSEKMSKeyId *string - // If the object is stored using server-side encryption either with an Amazon Web - // Services KMS key or an Amazon S3-managed encryption key, the response includes - // this header with the value of the server-side encryption algorithm used when - // storing this object in Amazon S3 (for example, AES256, aws:kms). + // The server-side encryption algorithm used when storing this object in Amazon S3 + // (for example, AES256, aws:kms). ServerSideEncryption types.ServerSideEncryption // Provides storage class information of the object. Amazon S3 returns this header diff --git a/service/s3/api_op_ListBuckets.go b/service/s3/api_op_ListBuckets.go index 7a3de38f428..2c90f4e38e6 100644 --- a/service/s3/api_op_ListBuckets.go +++ b/service/s3/api_op_ListBuckets.go @@ -13,7 +13,10 @@ import ( ) // Returns a list of all buckets owned by the authenticated sender of the request. -// To use this operation, you must have the s3:ListAllMyBuckets permission. +// To use this operation, you must have the s3:ListAllMyBuckets permission. For +// information about Amazon S3 buckets, see Creating, configuring, and working with +// Amazon S3 buckets +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html). func (c *Client) ListBuckets(ctx context.Context, params *ListBucketsInput, optFns ...func(*Options)) (*ListBucketsOutput, error) { if params == nil { params = &ListBucketsInput{} diff --git a/service/s3/api_op_ListMultipartUploads.go b/service/s3/api_op_ListMultipartUploads.go index af281a25287..31f97fdc14e 100644 --- a/service/s3/api_op_ListMultipartUploads.go +++ b/service/s3/api_op_ListMultipartUploads.go @@ -77,13 +77,13 @@ type ListMultipartUploadsInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_ListObjects.go b/service/s3/api_op_ListObjects.go index b2d83ff7468..7fadd42d4a1 100644 --- a/service/s3/api_op_ListObjects.go +++ b/service/s3/api_op_ListObjects.go @@ -66,13 +66,13 @@ type ListObjectsInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_ListObjectsV2.go b/service/s3/api_op_ListObjectsV2.go index 6214d24716f..3a9bc1b6ce2 100644 --- a/service/s3/api_op_ListObjectsV2.go +++ b/service/s3/api_op_ListObjectsV2.go @@ -72,13 +72,13 @@ type ListObjectsV2Input struct { // provide the access point ARN in place of the bucket name. For more information // about access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -162,8 +162,8 @@ type ListObjectsV2Output struct { IsTruncated bool // KeyCount is the number of keys returned with this request. KeyCount will always - // be less than or equals to MaxKeys field. Say you ask for 50 keys, your result - // will include less than equals 50 keys + // be less than or equal to the MaxKeys field. Say you ask for 50 keys, your result + // will include 50 keys or fewer. KeyCount int32 // Sets the maximum number of keys returned in the response. By default the action @@ -178,13 +178,13 @@ type ListObjectsV2Output struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. Name *string diff --git a/service/s3/api_op_ListParts.go b/service/s3/api_op_ListParts.go index 36675dcd74c..90ac3651005 100644 --- a/service/s3/api_op_ListParts.go +++ b/service/s3/api_op_ListParts.go @@ -81,13 +81,13 @@ type ListPartsInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_PutBucketAcl.go b/service/s3/api_op_PutBucketAcl.go index bc28a996004..4cd032d3433 100644 --- a/service/s3/api_op_PutBucketAcl.go +++ b/service/s3/api_op_PutBucketAcl.go @@ -113,15 +113,15 @@ import ( // <>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<> // // * By Email -// address: <>Grantees@email.com<>lt;/Grantee> The grantee is resolved to the -// CanonicalUser and, in a response to a GET Object acl request, appears as the -// CanonicalUser. Using email addresses to specify a grantee is only supported in -// the following Amazon Web Services Regions: +// address: <>Grantees@email.com<>& The grantee is resolved to the CanonicalUser +// and, in a response to a GET Object acl request, appears as the CanonicalUser. +// Using email addresses to specify a grantee is only supported in the following +// Amazon Web Services Regions: // // * US East (N. Virginia) // -// * US West -// (N. California) +// * US West (N. +// California) // // * US West (Oregon) // diff --git a/service/s3/api_op_PutBucketEncryption.go b/service/s3/api_op_PutBucketEncryption.go index 184f0cd3118..02c6f8e2787 100644 --- a/service/s3/api_op_PutBucketEncryption.go +++ b/service/s3/api_op_PutBucketEncryption.go @@ -14,14 +14,13 @@ import ( ) // This action uses the encryption subresource to configure default encryption and -// Amazon S3 Bucket Key for an existing bucket. Default encryption for a bucket can -// use server-side encryption with Amazon S3-managed keys (SSE-S3) or customer -// managed keys (SSE-KMS). If you specify default encryption using SSE-KMS, you can -// also configure Amazon S3 Bucket Key. When the default encryption is SSE-KMS, if -// you upload an object to the bucket and do not specify the KMS key to use for -// encryption, Amazon S3 uses the default Amazon Web Services managed KMS key for -// your account. For information about default encryption, see Amazon S3 default -// bucket encryption +// Amazon S3 Bucket Keys for an existing bucket. By default, all buckets have a +// default encryption configuration that uses server-side encryption with Amazon S3 +// managed keys (SSE-S3). You can optionally configure default encryption for a +// bucket by using server-side encryption with an Amazon Web Services KMS key +// (SSE-KMS) or a customer-provided key (SSE-C). If you specify default encryption +// by using SSE-KMS, you can also configure Amazon S3 Bucket Keys. For information +// about bucket default encryption, see Amazon S3 bucket default encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) in the // Amazon S3 User Guide. For more information about S3 Bucket Keys, see Amazon S3 // Bucket Keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html) in @@ -63,9 +62,12 @@ func (c *Client) PutBucketEncryption(ctx context.Context, params *PutBucketEncry type PutBucketEncryptionInput struct { // Specifies default encryption for a bucket using server-side encryption with - // Amazon S3-managed keys (SSE-S3) or customer managed keys (SSE-KMS). For - // information about the Amazon S3 default encryption feature, see Amazon S3 - // Default Bucket Encryption + // different key options. By default, all buckets have a default encryption + // configuration that uses server-side encryption with Amazon S3 managed keys + // (SSE-S3). You can optionally configure default encryption for a bucket by using + // server-side encryption with an Amazon Web Services KMS key (SSE-KMS) or a + // customer-provided key (SSE-C). For information about the bucket default + // encryption feature, see Amazon S3 Bucket Default Encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_PutBucketInventoryConfiguration.go b/service/s3/api_op_PutBucketInventoryConfiguration.go index bb1a903b5a8..11fe26d50a1 100644 --- a/service/s3/api_op_PutBucketInventoryConfiguration.go +++ b/service/s3/api_op_PutBucketInventoryConfiguration.go @@ -31,12 +31,24 @@ import ( // location. For an example policy, see Granting Permissions for Amazon S3 // Inventory and Storage Class Analysis // (https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9). -// To use this operation, you must have permissions to perform the +// Permissions To use this operation, you must have permission to perform the // s3:PutInventoryConfiguration action. The bucket owner has this permission by -// default and can grant this permission to others. For more information about -// permissions, see Permissions Related to Bucket Subresource Operations +// default and can grant this permission to others. The +// s3:PutInventoryConfiguration permission allows a user to create an S3 Inventory +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html) +// report that includes all object metadata fields available and to specify the +// destination bucket to store the inventory. A user with read access to objects in +// the destination bucket can also access all object metadata fields that are +// available in the inventory report. To restrict access to an inventory report, +// see Restricting access to an Amazon S3 Inventory report +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html#example-bucket-policies-use-case-10) +// in the Amazon S3 User Guide. For more information about the metadata fields +// available in S3 Inventory, see Amazon S3 Inventory lists +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html#storage-inventory-contents) +// in the Amazon S3 User Guide. For more information about permissions, see +// Permissions related to bucket subresource operations // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) -// and Managing Access Permissions to Your Amazon S3 Resources +// and Identity and access management in Amazon S3 // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) // in the Amazon S3 User Guide. Special Errors // diff --git a/service/s3/api_op_PutBucketMetricsConfiguration.go b/service/s3/api_op_PutBucketMetricsConfiguration.go index 6f0c6facd5e..4b989185aff 100644 --- a/service/s3/api_op_PutBucketMetricsConfiguration.go +++ b/service/s3/api_op_PutBucketMetricsConfiguration.go @@ -73,7 +73,8 @@ type PutBucketMetricsConfigurationInput struct { // This member is required. Bucket *string - // The ID used to identify the metrics configuration. + // The ID used to identify the metrics configuration. The ID has a 64 character + // limit and can only contain letters, numbers, periods, dashes, and underscores. // // This member is required. Id *string diff --git a/service/s3/api_op_PutObject.go b/service/s3/api_op_PutObject.go index aa13f0e775d..ff037df7515 100644 --- a/service/s3/api_op_PutObject.go +++ b/service/s3/api_op_PutObject.go @@ -18,22 +18,29 @@ import ( // Adds an object to a bucket. You must have WRITE permissions on a bucket to add // an object to it. Amazon S3 never adds partial objects; if you receive a success -// response, Amazon S3 added the entire object to the bucket. Amazon S3 is a -// distributed system. If it receives multiple write requests for the same object -// simultaneously, it overwrites all but the last object written. Amazon S3 does -// not provide object locking; if you need this, make sure to build it into your -// application layer or use versioning instead. To ensure that data is not -// corrupted traversing the network, use the Content-MD5 header. When you use this -// header, Amazon S3 checks the object against the provided MD5 value and, if they -// do not match, returns an error. Additionally, you can calculate the MD5 while -// putting an object to Amazon S3 and compare the returned ETag to the calculated -// MD5 value. +// response, Amazon S3 added the entire object to the bucket. You cannot use +// PutObject to only update a single piece of metadata for an existing object. You +// must put the entire object with updated metadata if you want to update some +// values. Amazon S3 is a distributed system. If it receives multiple write +// requests for the same object simultaneously, it overwrites all but the last +// object written. To prevent objects from being deleted or overwritten, you can +// use Amazon S3 Object Lock +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html). To +// ensure that data is not corrupted traversing the network, use the Content-MD5 +// header. When you use this header, Amazon S3 checks the object against the +// provided MD5 value and, if they do not match, returns an error. Additionally, +// you can calculate the MD5 while putting an object to Amazon S3 and compare the +// returned ETag to the calculated MD5 value. // -// * To successfully complete the PutObject request, you must have the -// s3:PutObject in your IAM permissions. +// * To successfully complete the +// PutObject request, you must have the s3:PutObject in your IAM permissions. // -// * To successfully change the objects acl -// of your PutObject request, you must have the s3:PutObjectAcl in your IAM +// * To +// successfully change the objects acl of your PutObject request, you must have the +// s3:PutObjectAcl in your IAM permissions. +// +// * To successfully set the tag-set with +// your PutObject request, you must have the s3:PutObjectTagging in your IAM // permissions. // // * The Content-MD5 header is required for any request to upload an @@ -42,23 +49,21 @@ import ( // (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html) in // the Amazon S3 User Guide. // -// Server-side Encryption You can optionally request -// server-side encryption. With server-side encryption, Amazon S3 encrypts your -// data as it writes it to disks in its data centers and decrypts the data when you -// access it. You have the option to provide your own encryption key or use Amazon -// Web Services managed encryption keys (SSE-S3 or SSE-KMS). For more information, -// see Using Server-Side Encryption +// You have three mutually exclusive options to protect +// data using server-side encryption in Amazon S3, depending on how you choose to +// manage the encryption keys. Specifically, the encryption key options are Amazon +// S3 managed keys (SSE-S3), Amazon Web Services KMS keys (SSE-KMS), and +// customer-provided keys (SSE-C). Amazon S3 encrypts data with server-side +// encryption by using Amazon S3 managed keys (SSE-S3) by default. You can +// optionally tell Amazon S3 to encrypt data at by rest using server-side +// encryption with other key options. For more information, see Using Server-Side +// Encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html). -// If you request server-side encryption using Amazon Web Services Key Management -// Service (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For more -// information, see Amazon S3 Bucket Keys -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html) in the Amazon -// S3 User Guide. Access Control List (ACL)-Specific Request Headers You can use -// headers to grant ACL- based permissions. By default, all objects are private. -// Only the owner has full access control. When adding a new object, you can grant -// permissions to individual Amazon Web Services accounts or to predefined groups -// defined by Amazon S3. These permissions are then added to the ACL on the object. -// For more information, see Access Control List (ACL) Overview +// When adding a new object, you can use headers to grant ACL-based permissions to +// individual Amazon Web Services accounts or to predefined groups defined by +// Amazon S3. These permissions are then added to the ACL on the object. By +// default, all objects are private. Only the owner has full access control. For +// more information, see Access Control List (ACL) Overview // (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html) and Managing // ACLs Using the REST API // (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html). If @@ -74,26 +79,26 @@ import ( // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) // in the Amazon S3 User Guide. If your bucket uses the bucket owner enforced // setting for Object Ownership, all objects written to the bucket by any account -// will be owned by the bucket owner. Storage Class Options By default, Amazon S3 -// uses the STANDARD Storage Class to store newly created objects. The STANDARD -// storage class provides high durability and high availability. Depending on -// performance needs, you can specify a different Storage Class. Amazon S3 on -// Outposts only uses the OUTPOSTS Storage Class. For more information, see Storage -// Classes +// will be owned by the bucket owner. By default, Amazon S3 uses the STANDARD +// Storage Class to store newly created objects. The STANDARD storage class +// provides high durability and high availability. Depending on performance needs, +// you can specify a different Storage Class. Amazon S3 on Outposts only uses the +// OUTPOSTS Storage Class. For more information, see Storage Classes // (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html) in -// the Amazon S3 User Guide. Versioning If you enable versioning for a bucket, -// Amazon S3 automatically generates a unique version ID for the object being -// stored. Amazon S3 returns this ID in the response. When you enable versioning -// for a bucket, if Amazon S3 receives multiple write requests for the same object -// simultaneously, it stores all of the objects. For more information about -// versioning, see Adding Objects to Versioning Enabled Buckets +// the Amazon S3 User Guide. If you enable versioning for a bucket, Amazon S3 +// automatically generates a unique version ID for the object being stored. Amazon +// S3 returns this ID in the response. When you enable versioning for a bucket, if +// Amazon S3 receives multiple write requests for the same object simultaneously, +// it stores all of the objects. For more information about versioning, see Adding +// Objects to Versioning Enabled Buckets // (https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html). // For information about returning the versioning state of a bucket, see // GetBucketVersioning // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html). -// Related Resources +// For more information about related Amazon S3 APIs, see the following: // -// * CopyObject +// * +// CopyObject // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) // // * @@ -124,13 +129,13 @@ type PutObjectInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -206,15 +211,15 @@ type PutObjectInput struct { ChecksumSHA256 *string // Specifies presentational information for the object. For more information, see - // http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1 - // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1). + // https://www.rfc-editor.org/rfc/rfc6266#section-4 + // (https://www.rfc-editor.org/rfc/rfc6266#section-4). ContentDisposition *string // Specifies what content encodings have been applied to the object and thus what // decoding mechanisms must be applied to obtain the media-type referenced by the // Content-Type header field. For more information, see - // http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11 - // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11). + // https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding + // (https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding). ContentEncoding *string // The language the content is in. @@ -222,8 +227,8 @@ type PutObjectInput struct { // Size of the body in bytes. This parameter is useful when the size of the body // cannot be determined automatically. For more information, see - // http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13 - // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13). + // https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length + // (https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length). ContentLength int64 // The base64-encoded 128-bit MD5 digest of the message (without the headers) @@ -236,8 +241,8 @@ type PutObjectInput struct { ContentMD5 *string // A standard MIME type describing the format of the contents. For more - // information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17 - // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17). + // information, see https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type + // (https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type). ContentType *string // The account ID of the expected bucket owner. If the bucket is owned by a @@ -246,8 +251,8 @@ type PutObjectInput struct { ExpectedBucketOwner *string // The date and time at which the object is no longer cacheable. For more - // information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21 - // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21). + // information, see https://www.rfc-editor.org/rfc/rfc7234#section-5.3 + // (https://www.rfc-editor.org/rfc/rfc7234#section-5.3). Expires *time.Time // Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object. This @@ -307,12 +312,14 @@ type PutObjectInput struct { // Specifies the Amazon Web Services KMS Encryption Context to use for object // encryption. The value of this header is a base64-encoded UTF-8 string holding - // JSON with the encryption context key-value pairs. + // JSON with the encryption context key-value pairs. This value is stored as object + // metadata and automatically gets passed on to Amazon Web Services KMS for future + // GetObject or CopyObject operations on this object. SSEKMSEncryptionContext *string - // If x-amz-server-side-encryption is present and has the value of aws:kms, this - // header specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetrical customer managed key that was used for the + // If x-amz-server-side-encryption has a valid value of aws:kms, this header + // specifies the ID of the Amazon Web Services Key Management Service (Amazon Web + // Services KMS) symmetric encryption customer managed key that was used for the // object. If you specify x-amz-server-side-encryption:aws:kms, but do not provide // x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses the Amazon Web // Services managed key to protect the data. If the KMS key does not exist in the @@ -419,19 +426,19 @@ type PutObjectOutput struct { // If present, specifies the Amazon Web Services KMS Encryption Context to use for // object encryption. The value of this header is a base64-encoded UTF-8 string - // holding JSON with the encryption context key-value pairs. + // holding JSON with the encryption context key-value pairs. This value is stored + // as object metadata and automatically gets passed on to Amazon Web Services KMS + // for future GetObject or CopyObject operations on this object. SSEKMSEncryptionContext *string - // If x-amz-server-side-encryption is present and has the value of aws:kms, this - // header specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the + // If x-amz-server-side-encryption is has a valid value of aws:kms, this header + // specifies the ID of the Amazon Web Services Key Management Service (Amazon Web + // Services KMS) symmetric encryption customer managed key that was used for the // object. SSEKMSKeyId *string - // If you specified server-side encryption either with an Amazon Web Services KMS - // key or Amazon S3-managed encryption key in your PUT request, the response - // includes this header. It confirms the encryption algorithm that Amazon S3 used - // to encrypt the object. + // The server-side encryption algorithm used when storing this object in Amazon S3 + // (for example, AES256, aws:kms). ServerSideEncryption types.ServerSideEncryption // Version of the object. diff --git a/service/s3/api_op_PutObjectAcl.go b/service/s3/api_op_PutObjectAcl.go index 05a377b5bc6..e93a34f63fa 100644 --- a/service/s3/api_op_PutObjectAcl.go +++ b/service/s3/api_op_PutObjectAcl.go @@ -185,13 +185,13 @@ type PutObjectAclInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_PutObjectTagging.go b/service/s3/api_op_PutObjectTagging.go index 43effb9eb9a..6a638e676c6 100644 --- a/service/s3/api_op_PutObjectTagging.go +++ b/service/s3/api_op_PutObjectTagging.go @@ -88,13 +88,13 @@ type PutObjectTaggingInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_RestoreObject.go b/service/s3/api_op_RestoreObject.go index 45a2aee6af7..0ad916d0345 100644 --- a/service/s3/api_op_RestoreObject.go +++ b/service/s3/api_op_RestoreObject.go @@ -30,24 +30,6 @@ import ( // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) // and Managing Access Permissions to Your Amazon S3 Resources // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) -// in the Amazon S3 User Guide. Querying Archives with Select Requests You use a -// select type of request to perform SQL queries on archived objects. The archived -// objects that are being queried by the select request must be formatted as -// uncompressed comma-separated values (CSV) files. You can run queries and custom -// analytics on your archived data without having to restore your data to a hotter -// Amazon S3 tier. For an overview about select requests, see Querying Archived -// Objects -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html) -// in the Amazon S3 User Guide. When making a select request, do the following: -// -// * -// Define an output location for the select query's output. This must be an Amazon -// S3 bucket in the same Amazon Web Services Region as the bucket that contains the -// archive object that is being queried. The Amazon Web Services account that -// initiates the job must have permissions to write to the S3 bucket. You can -// specify the storage class and encryption for the output objects stored in the -// bucket. For more information about output, see Querying Archived Objects -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html) // in the Amazon S3 User Guide. For more information about the S3 structure in the // request body, see the following: // @@ -81,15 +63,11 @@ import ( // query.) You cannot mix ordinal positions with header column names. SELECT s.Id, // s.FirstName, s.SSN FROM S3Object s // -// For more information about using SQL with S3 -// Glacier Select restore, see SQL Reference for Amazon S3 Select and S3 Glacier -// Select -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html) -// in the Amazon S3 User Guide. When making a select request, you can also do the -// following: +// When making a select request, you can also +// do the following: // -// * To expedite your queries, specify the Expedited tier. For more -// information about tiers, see "Restoring Archives," later in this topic. +// * To expedite your queries, specify the Expedited tier. For +// more information about tiers, see "Restoring Archives," later in this topic. // // * // Specify details about the data serialization format of both the input object @@ -104,59 +82,62 @@ import ( // lifecycle policy. // // * You can issue more than one select request on the same -// Amazon S3 object. Amazon S3 doesn't deduplicate requests, so avoid issuing +// Amazon S3 object. Amazon S3 doesn't duplicate requests, so avoid issuing // duplicate requests. // // * Amazon S3 accepts a select request even if the object has // already been restored. A select request doesn’t return error response // 409. // -// Restoring objects Objects that you archive to the S3 Glacier or S3 Glacier -// Deep Archive storage class, and S3 Intelligent-Tiering Archive or S3 -// Intelligent-Tiering Deep Archive tiers are not accessible in real time. For -// objects in Archive Access or Deep Archive Access tiers you must first initiate a -// restore request, and then wait until the object is moved into the Frequent -// Access tier. For objects in S3 Glacier or S3 Glacier Deep Archive storage -// classes you must first initiate a restore request, and then wait until a -// temporary copy of the object is available. To access an archived object, you -// must restore the object for the duration (number of days) that you specify. To -// restore a specific object version, you can provide a version ID. If you don't -// provide a version ID, Amazon S3 restores the current version. When restoring an -// archived object (or using a select request), you can specify one of the -// following data access tier options in the Tier element of the request body: -// -// * -// Expedited - Expedited retrievals allow you to quickly access your data stored in -// the S3 Glacier storage class or S3 Intelligent-Tiering Archive tier when -// occasional urgent requests for a subset of archives are required. For all but -// the largest archived objects (250 MB+), data accessed using Expedited retrievals -// is typically made available within 1–5 minutes. Provisioned capacity ensures -// that retrieval capacity for Expedited retrievals is available when you need it. -// Expedited retrievals and provisioned capacity are not available for objects -// stored in the S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering -// Deep Archive tier. -// -// * Standard - Standard retrievals allow you to access any of -// your archived objects within several hours. This is the default option for -// retrieval requests that do not specify the retrieval option. Standard retrievals -// typically finish within 3–5 hours for objects stored in the S3 Glacier storage -// class or S3 Intelligent-Tiering Archive tier. They typically finish within 12 -// hours for objects stored in the S3 Glacier Deep Archive storage class or S3 -// Intelligent-Tiering Deep Archive tier. Standard retrievals are free for objects -// stored in S3 Intelligent-Tiering. -// -// * Bulk - Bulk retrievals are the lowest-cost -// retrieval option in S3 Glacier, enabling you to retrieve large amounts, even -// petabytes, of data inexpensively. Bulk retrievals typically finish within 5–12 -// hours for objects stored in the S3 Glacier storage class or S3 -// Intelligent-Tiering Archive tier. They typically finish within 48 hours for +// Restoring objects Objects that you archive to the S3 Glacier Flexible +// Retrieval or S3 Glacier Deep Archive storage class, and S3 Intelligent-Tiering +// Archive or S3 Intelligent-Tiering Deep Archive tiers, are not accessible in real +// time. For objects in the S3 Glacier Flexible Retrieval or S3 Glacier Deep +// Archive storage classes, you must first initiate a restore request, and then +// wait until a temporary copy of the object is available. If you want a permanent +// copy of the object, create a copy of it in the Amazon S3 Standard storage class +// in your S3 bucket. To access an archived object, you must restore the object for +// the duration (number of days) that you specify. For objects in the Archive +// Access or Deep Archive Access tiers of S3 Intelligent-Tiering, you must first +// initiate a restore request, and then wait until the object is moved into the +// Frequent Access tier. To restore a specific object version, you can provide a +// version ID. If you don't provide a version ID, Amazon S3 restores the current +// version. When restoring an archived object, you can specify one of the following +// data access tier options in the Tier element of the request body: +// +// * Expedited - +// Expedited retrievals allow you to quickly access your data stored in the S3 +// Glacier Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier +// when occasional urgent requests for a subset of archives are required. For all +// but the largest archived objects (250 MB+), data accessed using Expedited +// retrievals is typically made available within 1–5 minutes. Provisioned capacity +// ensures that retrieval capacity for Expedited retrievals is available when you +// need it. Expedited retrievals and provisioned capacity are not available for // objects stored in the S3 Glacier Deep Archive storage class or S3 -// Intelligent-Tiering Deep Archive tier. Bulk retrievals are free for objects -// stored in S3 Intelligent-Tiering. -// -// For more information about archive retrieval -// options and provisioned capacity for Expedited data access, see Restoring -// Archived Objects +// Intelligent-Tiering Deep Archive tier. +// +// * Standard - Standard retrievals allow +// you to access any of your archived objects within several hours. This is the +// default option for retrieval requests that do not specify the retrieval option. +// Standard retrievals typically finish within 3–5 hours for objects stored in the +// S3 Glacier Flexible Retrieval storage class or S3 Intelligent-Tiering Archive +// tier. They typically finish within 12 hours for objects stored in the S3 Glacier +// Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier. Standard +// retrievals are free for objects stored in S3 Intelligent-Tiering. +// +// * Bulk - Bulk +// retrievals free for objects stored in the S3 Glacier Flexible Retrieval and S3 +// Intelligent-Tiering storage classes, enabling you to retrieve large amounts, +// even petabytes, of data at no cost. Bulk retrievals typically finish within 5–12 +// hours for objects stored in the S3 Glacier Flexible Retrieval storage class or +// S3 Intelligent-Tiering Archive tier. Bulk retrievals are also the lowest-cost +// retrieval option when restoring objects from S3 Glacier Deep Archive. They +// typically finish within 48 hours for objects stored in the S3 Glacier Deep +// Archive storage class or S3 Intelligent-Tiering Deep Archive tier. +// +// For more +// information about archive retrieval options and provisioned capacity for +// Expedited data access, see Restoring Archived Objects // (https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html) in the // Amazon S3 User Guide. You can use Amazon S3 restore speed upgrade to change the // restore speed to a faster speed while it is in progress. For more information, @@ -226,11 +207,6 @@ import ( // * // GetBucketNotificationConfiguration // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html) -// -// * -// SQL Reference for Amazon S3 Select and S3 Glacier Select -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html) -// in the Amazon S3 User Guide func (c *Client) RestoreObject(ctx context.Context, params *RestoreObjectInput, optFns ...func(*Options)) (*RestoreObjectOutput, error) { if params == nil { params = &RestoreObjectInput{} @@ -256,13 +232,13 @@ type RestoreObjectInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // diff --git a/service/s3/api_op_SelectObjectContent.go b/service/s3/api_op_SelectObjectContent.go index 1b9dbc7bcda..0ed1ba263be 100644 --- a/service/s3/api_op_SelectObjectContent.go +++ b/service/s3/api_op_SelectObjectContent.go @@ -25,9 +25,6 @@ import ( // (https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html) // and SELECT Command // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html) -// in the Amazon S3 User Guide. For more information about using SQL with Amazon S3 -// Select, see SQL Reference for Amazon S3 Select and S3 Glacier Select -// (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html) // in the Amazon S3 User Guide. Permissions You must have s3:GetObject permission // for this operation. Amazon S3 Select does not support anonymous access. For more // information about permissions, see Specifying Permissions in a Policy @@ -57,10 +54,10 @@ import ( // Encryption Keys) // (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html) // in the Amazon S3 User Guide. For objects that are encrypted with Amazon S3 -// managed encryption keys (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS), -// server-side encryption is handled transparently, so you don't need to specify -// anything. For more information about server-side encryption, including SSE-S3 -// and SSE-KMS, see Protecting Data Using Server-Side Encryption +// managed keys (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS), server-side +// encryption is handled transparently, so you don't need to specify anything. For +// more information about server-side encryption, including SSE-S3 and SSE-KMS, see +// Protecting Data Using Server-Side Encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html) in // the Amazon S3 User Guide. // diff --git a/service/s3/api_op_UploadPart.go b/service/s3/api_op_UploadPart.go index 18d30a10f08..801bab8d1bd 100644 --- a/service/s3/api_op_UploadPart.go +++ b/service/s3/api_op_UploadPart.go @@ -49,26 +49,33 @@ import ( // the Amazon S3 User Guide . For information on the permissions required to use // the multipart upload API, go to Multipart Upload and Permissions // (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html) in the -// Amazon S3 User Guide. You can optionally request server-side encryption where +// Amazon S3 User Guide. Server-side encryption is for data encryption at rest. // Amazon S3 encrypts your data as it writes it to disks in its data centers and -// decrypts it for you when you access it. You have the option of providing your -// own encryption key, or you can use the Amazon Web Services managed encryption -// keys. If you choose to provide your own encryption key, the request headers you -// provide in the request must match the headers you used in the request to -// initiate the upload by using CreateMultipartUpload +// decrypts it when you access it. You have three mutually exclusive options to +// protect data using server-side encryption in Amazon S3, depending on how you +// choose to manage the encryption keys. Specifically, the encryption key options +// are Amazon S3 managed keys (SSE-S3), Amazon Web Services KMS keys (SSE-KMS), and +// Customer-Provided Keys (SSE-C). Amazon S3 encrypts data with server-side +// encryption using Amazon S3 managed keys (SSE-S3) by default. You can optionally +// tell Amazon S3 to encrypt data at rest using server-side encryption with other +// key options. The option you use depends on whether you want to use KMS keys +// (SSE-KMS) or provide your own encryption key (SSE-C). If you choose to provide +// your own encryption key, the request headers you provide in the request must +// match the headers you used in the request to initiate the upload by using +// CreateMultipartUpload // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html). // For more information, go to Using Server-Side Encryption // (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) // in the Amazon S3 User Guide. Server-side encryption is supported by the S3 // Multipart Upload actions. Unless you are using a customer-provided encryption -// key, you don't need to specify the encryption parameters in each UploadPart -// request. Instead, you only need to specify the server-side encryption parameters -// in the initial Initiate Multipart request. For more information, see +// key (SSE-C), you don't need to specify the encryption parameters in each +// UploadPart request. Instead, you only need to specify the server-side encryption +// parameters in the initial Initiate Multipart request. For more information, see // CreateMultipartUpload // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html). // If you requested server-side encryption using a customer-provided encryption key -// in your initiate multipart upload request, you must provide identical encryption -// information in each part upload using the following headers. +// (SSE-C) in your initiate multipart upload request, you must provide identical +// encryption information in each part upload using the following headers. // // * // x-amz-server-side-encryption-customer-algorithm @@ -138,13 +145,13 @@ type UploadPartInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -312,8 +319,8 @@ type UploadPartOutput struct { SSECustomerKeyMD5 *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key was used for + // the object. SSEKMSKeyId *string // The server-side encryption algorithm used when storing this object in Amazon S3 diff --git a/service/s3/api_op_UploadPartCopy.go b/service/s3/api_op_UploadPartCopy.go index f1fa1395471..85c3da20c9f 100644 --- a/service/s3/api_op_UploadPartCopy.go +++ b/service/s3/api_op_UploadPartCopy.go @@ -145,13 +145,13 @@ type UploadPartCopyInput struct { // the access point ARN in place of the bucket name. For more information about // access point ARNs, see Using access points // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) - // in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts, - // you must direct requests to the S3 on Outposts hostname. The S3 on Outposts - // hostname takes the form - // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using - // this action with S3 on Outposts through the Amazon Web Services SDKs, you - // provide the Outposts bucket ARN in place of the bucket name. For more - // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts + // in the Amazon S3 User Guide. When you use this action with Amazon S3 on + // Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on + // Outposts hostname takes the form + // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you + // use this action with S3 on Outposts through the Amazon Web Services SDKs, you + // provide the Outposts access point ARN in place of the bucket name. For more + // information about S3 on Outposts ARNs, see What is S3 on Outposts // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the // Amazon S3 User Guide. // @@ -309,8 +309,8 @@ type UploadPartCopyOutput struct { SSECustomerKeyMD5 *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for the - // object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for the object. SSEKMSKeyId *string // The server-side encryption algorithm used when storing this object in Amazon S3 diff --git a/service/s3/api_op_WriteGetObjectResponse.go b/service/s3/api_op_WriteGetObjectResponse.go index 78eeadd45a1..6d3e9225dc2 100644 --- a/service/s3/api_op_WriteGetObjectResponse.go +++ b/service/s3/api_op_WriteGetObjectResponse.go @@ -243,8 +243,8 @@ type WriteGetObjectResponseInput struct { SSECustomerKeyMD5 *string // If present, specifies the ID of the Amazon Web Services Key Management Service - // (Amazon Web Services KMS) symmetric customer managed key that was used for - // stored in Amazon S3 object. + // (Amazon Web Services KMS) symmetric encryption customer managed key that was + // used for stored in Amazon S3 object. SSEKMSKeyId *string // The server-side encryption algorithm used when storing requested object in diff --git a/service/s3/types/enums.go b/service/s3/types/enums.go index 79c5e688d39..456565f3083 100644 --- a/service/s3/types/enums.go +++ b/service/s3/types/enums.go @@ -275,6 +275,37 @@ func (EncodingType) Values() []EncodingType { type Event string +// Enum values for Event +const ( + EventS3ReducedRedundancyLostObject Event = "s3:ReducedRedundancyLostObject" + EventS3ObjectCreated Event = "s3:ObjectCreated:*" + EventS3ObjectCreatedPut Event = "s3:ObjectCreated:Put" + EventS3ObjectCreatedPost Event = "s3:ObjectCreated:Post" + EventS3ObjectCreatedCopy Event = "s3:ObjectCreated:Copy" + EventS3ObjectCreatedCompleteMultipartUpload Event = "s3:ObjectCreated:CompleteMultipartUpload" + EventS3ObjectRemoved Event = "s3:ObjectRemoved:*" + EventS3ObjectRemovedDelete Event = "s3:ObjectRemoved:Delete" + EventS3ObjectRemovedDeleteMarkerCreated Event = "s3:ObjectRemoved:DeleteMarkerCreated" + EventS3ObjectRestore Event = "s3:ObjectRestore:*" + EventS3ObjectRestorePost Event = "s3:ObjectRestore:Post" + EventS3ObjectRestoreCompleted Event = "s3:ObjectRestore:Completed" + EventS3Replication Event = "s3:Replication:*" + EventS3ReplicationOperationFailedReplication Event = "s3:Replication:OperationFailedReplication" + EventS3ReplicationOperationNotTracked Event = "s3:Replication:OperationNotTracked" + EventS3ReplicationOperationMissedThreshold Event = "s3:Replication:OperationMissedThreshold" + EventS3ReplicationOperationReplicatedAfterThreshold Event = "s3:Replication:OperationReplicatedAfterThreshold" + EventS3ObjectRestoreDelete Event = "s3:ObjectRestore:Delete" + EventS3LifecycleTransition Event = "s3:LifecycleTransition" + EventS3IntelligentTiering Event = "s3:IntelligentTiering" + EventS3ObjectAclPut Event = "s3:ObjectAcl:Put" + EventS3LifecycleExpiration Event = "s3:LifecycleExpiration:*" + EventS3LifecycleExpirationDelete Event = "s3:LifecycleExpiration:Delete" + EventS3LifecycleExpirationDeleteMarkerCreated Event = "s3:LifecycleExpiration:DeleteMarkerCreated" + EventS3ObjectTagging Event = "s3:ObjectTagging:*" + EventS3ObjectTaggingPut Event = "s3:ObjectTagging:Put" + EventS3ObjectTaggingDelete Event = "s3:ObjectTagging:Delete" +) + // Values returns all known values for Event. Note that this can be expanded in the // future, and so it is only as up to date as the client. The ordering of this // slice is not guaranteed to be stable across updates. diff --git a/service/s3/types/types.go b/service/s3/types/types.go index bcef62cec1a..eaa10d91a0e 100644 --- a/service/s3/types/types.go +++ b/service/s3/types/types.go @@ -512,7 +512,7 @@ type CSVInput struct { // A single character used to indicate that a row should be ignored when the // character is present at the start of that row. You can specify any character to - // indicate a comment line. + // indicate a comment line. The default character is #. Default: # Comments *string // A single character used to separate individual fields in a record. You can @@ -755,9 +755,9 @@ type Encryption struct { KMSContext *string // If the encryption type is aws:kms, this optional value specifies the ID of the - // symmetric customer managed key to use for encryption of job results. Amazon S3 - // only supports symmetric keys. For more information, see Using symmetric and - // asymmetric keys + // symmetric encryption customer managed key to use for encryption of job results. + // Amazon S3 only supports symmetric encryption KMS keys. For more information, see + // Asymmetric keys in Amazon Web Services KMS // (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) // in the Amazon Web Services Key Management Service Developer Guide. KMSKeyId *string @@ -772,8 +772,8 @@ type EncryptionConfiguration struct { // Specifies the ID (Key ARN or Alias ARN) of the customer managed Amazon Web // Services KMS key stored in Amazon Web Services Key Management Service (KMS) for // the destination bucket. Amazon S3 uses this key to encrypt replica objects. - // Amazon S3 only supports symmetric, customer managed KMS keys. For more - // information, see Using symmetric and asymmetric keys + // Amazon S3 only supports symmetric encryption KMS keys. For more information, see + // Asymmetric keys in Amazon Web Services KMS // (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) // in the Amazon Web Services Key Management Service Developer Guide. ReplicaKmsKeyID *string @@ -1643,20 +1643,20 @@ type Error struct { // * // Code: ServiceUnavailable // - // * Description: Reduce your request rate. + // * Description: Service is unable to handle request. // - // * HTTP - // Status Code: 503 Service Unavailable + // * + // HTTP Status Code: 503 Service Unavailable // // * SOAP Fault Code Prefix: Server // - // * Code: - // SlowDown + // * + // Code: SlowDown // // * Description: Reduce your request rate. // - // * HTTP Status Code: 503 Slow - // Down + // * HTTP Status Code: + // 503 Slow Down // // * SOAP Fault Code Prefix: Server // @@ -1766,7 +1766,7 @@ type EventBridgeConfiguration struct { // in the Amazon S3 User Guide. type ExistingObjectReplication struct { - // + // Specifies whether Amazon S3 replicates existing source bucket objects. // // This member is required. Status ExistingObjectReplicationStatus @@ -2180,7 +2180,10 @@ type LambdaFunctionConfiguration struct { noSmithyDocumentSerde } -// Container for the expiration for the lifecycle of the object. +// Container for the expiration for the lifecycle of the object. For more +// information see, Managing your storage lifecycle +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) +// in the Amazon S3 User Guide. type LifecycleExpiration struct { // Indicates at what date the object is to be moved or deleted. Should be in GMT @@ -2200,7 +2203,10 @@ type LifecycleExpiration struct { noSmithyDocumentSerde } -// A lifecycle rule for individual objects in an Amazon S3 bucket. +// A lifecycle rule for individual objects in an Amazon S3 bucket. For more +// information see, Managing your storage lifecycle +// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) +// in the Amazon S3 User Guide. type LifecycleRule struct { // If 'Enabled', the rule is currently being applied. If 'Disabled', the rule is @@ -2430,7 +2436,8 @@ type MetricsAndOperator struct { // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html). type MetricsConfiguration struct { - // The ID used to identify the metrics configuration. + // The ID used to identify the metrics configuration. The ID has a 64 character + // limit and can only contain letters, numbers, periods, dashes, and underscores. // // This member is required. Id *string @@ -2831,7 +2838,27 @@ type OutputSerialization struct { // Container for the owner's display name and ID. type Owner struct { - // Container for the display name of the owner. + // Container for the display name of the owner. This value is only supported in the + // following Amazon Web Services Regions: + // + // * US East (N. Virginia) + // + // * US West (N. + // California) + // + // * US West (Oregon) + // + // * Asia Pacific (Singapore) + // + // * Asia Pacific + // (Sydney) + // + // * Asia Pacific (Tokyo) + // + // * Europe (Ireland) + // + // * South America (São + // Paulo) DisplayName *string // Container for the ID of the owner. @@ -3171,7 +3198,10 @@ type ReplicationRule struct { // (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations). DeleteMarkerReplication *DeleteMarkerReplication - // + // Optional configuration to replicate existing source bucket objects. For more + // information, see Replicating Existing Objects + // (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication) + // in the Amazon S3 User Guide. ExistingObjectReplication *ExistingObjectReplication // A filter that identifies the subset of objects to which the replication rule @@ -3568,8 +3598,8 @@ type ServerSideEncryptionByDefault struct { // arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab // // Amazon - // S3 only supports symmetric KMS keys and not asymmetric KMS keys. For more - // information, see Using symmetric and asymmetric keys + // S3 only supports symmetric encryption KMS keys. For more information, see + // Asymmetric keys in Amazon Web Services KMS // (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) // in the Amazon Web Services Key Management Service Developer Guide. KMSMasterKeyID *string @@ -3637,8 +3667,8 @@ type SourceSelectionCriteria struct { type SSEKMS struct { // Specifies the ID of the Amazon Web Services Key Management Service (Amazon Web - // Services KMS) symmetric customer managed key to use for encrypting inventory - // reports. + // Services KMS) symmetric encryption customer managed key to use for encrypting + // inventory reports. // // This member is required. KeyId *string diff --git a/service/sagemakerfeaturestoreruntime/api_op_DeleteRecord.go b/service/sagemakerfeaturestoreruntime/api_op_DeleteRecord.go index d625c1a850e..e079c5ec59b 100644 --- a/service/sagemakerfeaturestoreruntime/api_op_DeleteRecord.go +++ b/service/sagemakerfeaturestoreruntime/api_op_DeleteRecord.go @@ -11,9 +11,24 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Deletes a Record from a FeatureGroup. When the DeleteRecord API is called a new -// record will be added to the OfflineStore and the Record will be removed from the -// OnlineStore. This record will have a value of True in the is_deleted column. +// Deletes a Record from a FeatureGroup in the OnlineStore. Feature Store supports +// both SOFT_DELETE and HARD_DELETE. For SOFT_DELETE (default), feature columns are +// set to null and the record is no longer retrievable by GetRecord or +// BatchGetRecord. For HARD_DELETE, the complete Record is removed from the +// OnlineStore. In both cases, Feature Store appends the deleted record marker to +// the OfflineStore with feature values set to null, is_deleted value set to True, +// and EventTime set to the delete input EventTime. Note that the EventTime +// specified in DeleteRecord should be set later than the EventTime of the existing +// record in the OnlineStore for that RecordIdentifer. If it is not, the deletion +// does not occur: +// +// * For SOFT_DELETE, the existing (undeleted) record remains in +// the OnlineStore, though the delete record marker is still written to the +// OfflineStore. +// +// * HARD_DELETE returns EventTime: 400 ValidationException to +// indicate that the delete operation failed. No delete record marker is written to +// the OfflineStore. func (c *Client) DeleteRecord(ctx context.Context, params *DeleteRecordInput, optFns ...func(*Options)) (*DeleteRecordOutput, error) { if params == nil { params = &DeleteRecordInput{} @@ -48,6 +63,10 @@ type DeleteRecordInput struct { // This member is required. RecordIdentifierValueAsString *string + // The name of the deletion mode for deleting the record. By default, the deletion + // mode is set to SoftDelete. + DeletionMode types.DeletionMode + // A list of stores from which you're deleting the record. By default, Feature // Store deletes the record from all of the stores that you're using for the // FeatureGroup. diff --git a/service/sagemakerfeaturestoreruntime/serializers.go b/service/sagemakerfeaturestoreruntime/serializers.go index b305fcd70e1..7eba18035b4 100644 --- a/service/sagemakerfeaturestoreruntime/serializers.go +++ b/service/sagemakerfeaturestoreruntime/serializers.go @@ -130,6 +130,10 @@ func awsRestjson1_serializeOpHttpBindingsDeleteRecordInput(v *DeleteRecordInput, return fmt.Errorf("unsupported serialization of nil %T", v) } + if len(v.DeletionMode) > 0 { + encoder.SetQuery("DeletionMode").String(string(v.DeletionMode)) + } + if v.EventTime != nil { encoder.SetQuery("EventTime").String(*v.EventTime) } diff --git a/service/sagemakerfeaturestoreruntime/types/enums.go b/service/sagemakerfeaturestoreruntime/types/enums.go index 97fa5604392..09dd3360c20 100644 --- a/service/sagemakerfeaturestoreruntime/types/enums.go +++ b/service/sagemakerfeaturestoreruntime/types/enums.go @@ -2,6 +2,24 @@ package types +type DeletionMode string + +// Enum values for DeletionMode +const ( + DeletionModeSoftDelete DeletionMode = "SoftDelete" + DeletionModeHardDelete DeletionMode = "HardDelete" +) + +// Values returns all known values for DeletionMode. Note that this can be expanded +// in the future, and so it is only as up to date as the client. The ordering of +// this slice is not guaranteed to be stable across updates. +func (DeletionMode) Values() []DeletionMode { + return []DeletionMode{ + "SoftDelete", + "HardDelete", + } +} + type TargetStore string // Enum values for TargetStore diff --git a/service/sagemakerfeaturestoreruntime/types/types.go b/service/sagemakerfeaturestoreruntime/types/types.go index ecc6c34f3fb..522902d7d13 100644 --- a/service/sagemakerfeaturestoreruntime/types/types.go +++ b/service/sagemakerfeaturestoreruntime/types/types.go @@ -9,14 +9,14 @@ import ( // The error that has occurred when attempting to retrieve a batch of Records. type BatchGetRecordError struct { - // The error code of an error that has occured when attempting to retrieve a batch + // The error code of an error that has occurred when attempting to retrieve a batch // of Records. For more information on errors, see Errors // (https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_GetRecord.html#API_feature_store_GetRecord_Errors). // // This member is required. ErrorCode *string - // The error message of an error that has occured when attempting to retrieve a + // The error message of an error that has occurred when attempting to retrieve a // record in the batch. // // This member is required. @@ -70,7 +70,7 @@ type BatchGetRecordResultDetail struct { // This member is required. Record []FeatureValue - // The value of the record identifer in string format. + // The value of the record identifier in string format. // // This member is required. RecordIdentifierValueAsString *string diff --git a/service/servicequotas/internal/endpoints/endpoints.go b/service/servicequotas/internal/endpoints/endpoints.go index c1b7ddae53c..f86a427d26c 100644 --- a/service/servicequotas/internal/endpoints/endpoints.go +++ b/service/servicequotas/internal/endpoints/endpoints.go @@ -153,6 +153,9 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ap-south-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ap-south-2", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "ap-southeast-1", }: endpoints.Endpoint{}, @@ -162,18 +165,27 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ap-southeast-3", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ap-southeast-4", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "ca-central-1", }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-central-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "eu-central-2", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-north-1", }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-south-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "eu-south-2", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-west-1", }: endpoints.Endpoint{},