From 533662cdfefcf595d426bb25511e2bf39b62fca5 Mon Sep 17 00:00:00 2001 From: awssdkgo Date: Mon, 31 Aug 2020 18:26:25 +0000 Subject: [PATCH] Release v1.34.14 (2020-08-31) === ### Service Client Updates * `service/backup`: Updates service documentation * `service/cloudfront`: Updates service API and documentation * CloudFront now supports real-time logging for CloudFront distributions. CloudFront real-time logs are more detailed, configurable, and are available in real time. * `service/ec2`: Updates service API and documentation * Amazon EC2 and Spot Fleet now support modification of launch template configs for a running fleet enabling instance type, instance weight, AZ, and AMI updates without losing the current fleet ID. * `service/sqs`: Updates service documentation * Documentation updates for SQS. ### SDK Bugs * `aws/ec2metadata`: Add support for EC2 IMDS endpoint from environment variable ([#3504](https://github.com/aws/aws-sdk-go/pull/3504)) * Adds support for specifying a custom EC2 IMDS endpoint from the environment variable, `AWS_EC2_METADATA_SERVICE_ENDPOINT`. * The `aws/session#Options` struct also has a new field, `EC2IMDSEndpoint`. This field can be used to configure the custom endpoint of the EC2 IMDS client. The option only applies to EC2 IMDS clients created after the Session with `EC2IMDSEndpoint` is specified. --- CHANGELOG.md | 17 + CHANGELOG_PENDING.md | 3 - aws/endpoints/defaults.go | 7 +- aws/version.go | 2 +- models/apis/backup/2018-11-15/docs-2.json | 10 +- models/apis/cloudfront/2020-05-31/api-2.json | 294 +++- models/apis/cloudfront/2020-05-31/docs-2.json | 167 +- models/apis/ec2/2016-11-15/api-2.json | 9 + models/apis/ec2/2016-11-15/docs-2.json | 4 +- models/apis/sqs/2012-11-05/docs-2.json | 28 +- models/endpoints/endpoints.json | 7 +- service/backup/api.go | 14 +- service/cloudfront/api.go | 1385 ++++++++++++++++- .../cloudfront/cloudfrontiface/interface.go | 24 + service/cloudfront/errors.go | 28 + service/ec2/api.go | 45 + service/sqs/api.go | 51 +- service/sqs/doc.go | 6 +- 18 files changed, 2011 insertions(+), 90 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index dca33f0584a..e3cfe5bc4db 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,20 @@ +Release v1.34.14 (2020-08-31) +=== + +### Service Client Updates +* `service/backup`: Updates service documentation +* `service/cloudfront`: Updates service API and documentation + * CloudFront now supports real-time logging for CloudFront distributions. CloudFront real-time logs are more detailed, configurable, and are available in real time. +* `service/ec2`: Updates service API and documentation + * Amazon EC2 and Spot Fleet now support modification of launch template configs for a running fleet enabling instance type, instance weight, AZ, and AMI updates without losing the current fleet ID. +* `service/sqs`: Updates service documentation + * Documentation updates for SQS. + +### SDK Bugs +* `aws/ec2metadata`: Add support for EC2 IMDS endpoint from environment variable ([#3504](https://github.com/aws/aws-sdk-go/pull/3504)) + * Adds support for specifying a custom EC2 IMDS endpoint from the environment variable, `AWS_EC2_METADATA_SERVICE_ENDPOINT`. + * The `aws/session#Options` struct also has a new field, `EC2IMDSEndpoint`. This field can be used to configure the custom endpoint of the EC2 IMDS client. The option only applies to EC2 IMDS clients created after the Session with `EC2IMDSEndpoint` is specified. + Release v1.34.13 (2020-08-28) === diff --git a/CHANGELOG_PENDING.md b/CHANGELOG_PENDING.md index 37916bb84d8..8a1927a39ca 100644 --- a/CHANGELOG_PENDING.md +++ b/CHANGELOG_PENDING.md @@ -3,6 +3,3 @@ ### SDK Enhancements ### SDK Bugs -* `aws/ec2metadata`: Add support for EC2 IMDS endpoint from environment variable ([#3504](https://github.com/aws/aws-sdk-go/pull/3504)) - * Adds support for specifying a custom EC2 IMDS endpoint from the environment variable, `AWS_EC2_METADATA_SERVICE_ENDPOINT`. - * The `aws/session#Options` struct also has a new field, `EC2IMDSEndpoint`. This field can be used to configure the custom endpoint of the EC2 IMDS client. The option only applies to EC2 IMDS clients created after the Session with `EC2IMDSEndpoint` is specified. diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index 46583cd25f7..a496df4846f 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -292,6 +292,7 @@ var awsPartition = partition{ Protocols: []string{"https"}, }, Endpoints: endpoints{ + "af-south-1": endpoint{}, "ap-east-1": endpoint{}, "ap-northeast-1": endpoint{}, "ap-northeast-2": endpoint{}, @@ -301,6 +302,7 @@ var awsPartition = partition{ "ca-central-1": endpoint{}, "eu-central-1": endpoint{}, "eu-north-1": endpoint{}, + "eu-south-1": endpoint{}, "eu-west-1": endpoint{}, "eu-west-2": endpoint{}, "eu-west-3": endpoint{}, @@ -3718,7 +3720,6 @@ var awsPartition = partition{ "ap-northeast-2": endpoint{}, "ap-southeast-1": endpoint{}, "eu-west-1": endpoint{}, - "eu-west-2": endpoint{}, "us-east-1": endpoint{}, }, }, @@ -7898,13 +7899,13 @@ var awsusgovPartition = partition{ Endpoints: endpoints{ "fips-us-gov-east-1": endpoint{ - Hostname: "elasticloadbalancing-fips.us-gov-east-1.amazonaws.com", + Hostname: "elasticloadbalancing.us-gov-east-1.amazonaws.com", CredentialScope: credentialScope{ Region: "us-gov-east-1", }, }, "fips-us-gov-west-1": endpoint{ - Hostname: "elasticloadbalancing-fips.us-gov-west-1.amazonaws.com", + Hostname: "elasticloadbalancing.us-gov-west-1.amazonaws.com", CredentialScope: credentialScope{ Region: "us-gov-west-1", }, diff --git a/aws/version.go b/aws/version.go index 950238ec221..1d19f8ad33b 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.34.13" +const SDKVersion = "1.34.14" diff --git a/models/apis/backup/2018-11-15/docs-2.json b/models/apis/backup/2018-11-15/docs-2.json index 0c51fa9099a..53a414d328e 100644 --- a/models/apis/backup/2018-11-15/docs-2.json +++ b/models/apis/backup/2018-11-15/docs-2.json @@ -3,7 +3,7 @@ "service": "AWS Backup

AWS Backup is a unified backup service designed to protect AWS services and their associated data. AWS Backup simplifies the creation, migration, restoration, and deletion of backups, while also providing reporting and auditing.

", "operations": { "CreateBackupPlan": "

Backup plans are documents that contain information that AWS Backup uses to schedule tasks that create recovery points of resources.

If you call CreateBackupPlan with a plan that already exists, an AlreadyExistsException is returned.

", - "CreateBackupSelection": "

Creates a JSON document that specifies a set of resources to assign to a backup plan. Resources can be included by specifying patterns for a ListOfTags and selected Resources.

For example, consider the following patterns:

Using these patterns would back up all Amazon Elastic Block Store (Amazon EBS) volumes that are tagged as \"department=finance\", \"importance=critical\", in addition to an EBS volume with the specified volume Id.

Resources and conditions are additive in that all resources that match the pattern are selected. This shouldn't be confused with a logical AND, where all conditions must match. The matching patterns are logically 'put together using the OR operator. In other words, all patterns that match are selected for backup.

", + "CreateBackupSelection": "

Creates a JSON document that specifies a set of resources to assign to a backup plan. Resources can be included by specifying patterns for a ListOfTags and selected Resources.

For example, consider the following patterns:

Using these patterns would back up all Amazon Elastic Block Store (Amazon EBS) volumes that are tagged as \"department=finance\", \"importance=critical\", in addition to an EBS volume with the specified volume Id.

Resources and conditions are additive in that all resources that match the pattern are selected. This shouldn't be confused with a logical AND, where all conditions must match. The matching patterns are logically 'put together using the OR operator. In other words, all patterns that match are selected for backup.

", "CreateBackupVault": "

Creates a logical container where backups are stored. A CreateBackupVault request includes a name, optionally one or more resource tags, an encryption key, and a request ID.

Sensitive data, such as passport numbers, should not be included the name of a backup vault.

", "DeleteBackupPlan": "

Deletes a backup plan. A backup plan can only be deleted after all associated selections of resources have been deleted. Deleting a backup plan deletes the current version of a backup plan. Previous versions, if any, will still exist.

", "DeleteBackupSelection": "

Deletes the resource selection associated with a backup plan that is specified by the SelectionId.

", @@ -343,7 +343,7 @@ } }, "Condition": { - "base": "

Contains an array of triplets made up of a condition type (such as STRINGEQUALS), a key, and a value. Conditions are used to filter resources in a selection that is assigned to a backup plan.

", + "base": "

Contains an array of triplets made up of a condition type (such as StringEquals), a key, and a value. Conditions are used to filter resources in a selection that is assigned to a backup plan.

", "refs": { "ListOfTags$member": null } @@ -357,7 +357,7 @@ "ConditionType": { "base": null, "refs": { - "Condition$ConditionType": "

An operation, such as STRINGEQUALS, that is applied to a key-value pair used to filter resources in a selection.

" + "Condition$ConditionType": "

An operation, such as StringEquals, that is applied to a key-value pair used to filter resources in a selection.

" } }, "ConditionValue": { @@ -642,7 +642,7 @@ "base": null, "refs": { "BackupJob$IamRoleArn": "

Specifies the IAM role ARN used to create the target recovery point; for example, arn:aws:iam::123456789012:role/S3Access.

", - "BackupSelection$IamRoleArn": "

The ARN of the IAM role that AWS Backup uses to authenticate when restoring the target resource; for example, arn:aws:iam::123456789012:role/S3Access.

", + "BackupSelection$IamRoleArn": "

The ARN of the IAM role that AWS Backup uses to authenticate when backing up the target resource; for example, arn:aws:iam::123456789012:role/S3Access.

", "BackupSelectionsListMember$IamRoleArn": "

Specifies the IAM role Amazon Resource Name (ARN) to create the target recovery point; for example, arn:aws:iam::123456789012:role/S3Access.

", "CopyJob$IamRoleArn": "

Specifies the IAM role ARN used to copy the target recovery point; for example, arn:aws:iam::123456789012:role/S3Access.

", "DescribeBackupJobOutput$IamRoleArn": "

Specifies the IAM role ARN used to create the target recovery point; for example, arn:aws:iam::123456789012:role/S3Access.

", @@ -763,7 +763,7 @@ "ListOfTags": { "base": null, "refs": { - "BackupSelection$ListOfTags": "

An array of conditions used to specify a set of resources to assign to a backup plan; for example, \"STRINGEQUALS\": {\"ec2:ResourceTag/Department\": \"accounting\".

" + "BackupSelection$ListOfTags": "

An array of conditions used to specify a set of resources to assign to a backup plan; for example, \"StringEquals\": {\"ec2:ResourceTag/Department\": \"accounting\".

" } }, "ListProtectedResourcesInput": { diff --git a/models/apis/cloudfront/2020-05-31/api-2.json b/models/apis/cloudfront/2020-05-31/api-2.json index 638304f8f51..9a5d9f49d95 100644 --- a/models/apis/cloudfront/2020-05-31/api-2.json +++ b/models/apis/cloudfront/2020-05-31/api-2.json @@ -279,6 +279,25 @@ {"shape":"TooManyPublicKeys"} ] }, + "CreateRealtimeLogConfig":{ + "name":"CreateRealtimeLogConfig2020_05_31", + "http":{ + "method":"POST", + "requestUri":"/2020-05-31/realtime-log-config", + "responseCode":201 + }, + "input":{ + "shape":"CreateRealtimeLogConfigRequest", + "locationName":"CreateRealtimeLogConfigRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "output":{"shape":"CreateRealtimeLogConfigResult"}, + "errors":[ + {"shape":"RealtimeLogConfigAlreadyExists"}, + {"shape":"TooManyRealtimeLogConfigs"}, + {"shape":"InvalidArgument"} + ] + }, "CreateStreamingDistribution":{ "name":"CreateStreamingDistribution2020_05_31", "http":{ @@ -455,6 +474,24 @@ {"shape":"PreconditionFailed"} ] }, + "DeleteRealtimeLogConfig":{ + "name":"DeleteRealtimeLogConfig2020_05_31", + "http":{ + "method":"POST", + "requestUri":"/2020-05-31/delete-realtime-log-config/", + "responseCode":204 + }, + "input":{ + "shape":"DeleteRealtimeLogConfigRequest", + "locationName":"DeleteRealtimeLogConfigRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "errors":[ + {"shape":"NoSuchRealtimeLogConfig"}, + {"shape":"RealtimeLogConfigInUse"}, + {"shape":"InvalidArgument"} + ] + }, "DeleteStreamingDistribution":{ "name":"DeleteStreamingDistribution2020_05_31", "http":{ @@ -680,6 +717,23 @@ {"shape":"NoSuchPublicKey"} ] }, + "GetRealtimeLogConfig":{ + "name":"GetRealtimeLogConfig2020_05_31", + "http":{ + "method":"POST", + "requestUri":"/2020-05-31/get-realtime-log-config/" + }, + "input":{ + "shape":"GetRealtimeLogConfigRequest", + "locationName":"GetRealtimeLogConfigRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "output":{"shape":"GetRealtimeLogConfigResult"}, + "errors":[ + {"shape":"NoSuchRealtimeLogConfig"}, + {"shape":"InvalidArgument"} + ] + }, "GetStreamingDistribution":{ "name":"GetStreamingDistribution2020_05_31", "http":{ @@ -772,6 +826,22 @@ {"shape":"AccessDenied"} ] }, + "ListDistributionsByRealtimeLogConfig":{ + "name":"ListDistributionsByRealtimeLogConfig2020_05_31", + "http":{ + "method":"POST", + "requestUri":"/2020-05-31/distributionsByRealtimeLogConfig/" + }, + "input":{ + "shape":"ListDistributionsByRealtimeLogConfigRequest", + "locationName":"ListDistributionsByRealtimeLogConfigRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "output":{"shape":"ListDistributionsByRealtimeLogConfigResult"}, + "errors":[ + {"shape":"InvalidArgument"} + ] + }, "ListDistributionsByWebACLId":{ "name":"ListDistributionsByWebACLId2020_05_31", "http":{ @@ -849,6 +919,15 @@ {"shape":"InvalidArgument"} ] }, + "ListRealtimeLogConfigs":{ + "name":"ListRealtimeLogConfigs2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/realtime-log-config" + }, + "input":{"shape":"ListRealtimeLogConfigsRequest"}, + "output":{"shape":"ListRealtimeLogConfigsResult"} + }, "ListStreamingDistributions":{ "name":"ListStreamingDistributions2020_05_31", "http":{ @@ -1092,6 +1171,23 @@ {"shape":"PreconditionFailed"} ] }, + "UpdateRealtimeLogConfig":{ + "name":"UpdateRealtimeLogConfig2020_05_31", + "http":{ + "method":"PUT", + "requestUri":"/2020-05-31/realtime-log-config/" + }, + "input":{ + "shape":"UpdateRealtimeLogConfigRequest", + "locationName":"UpdateRealtimeLogConfigRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "output":{"shape":"UpdateRealtimeLogConfigResult"}, + "errors":[ + {"shape":"NoSuchRealtimeLogConfig"}, + {"shape":"InvalidArgument"} + ] + }, "UpdateStreamingDistribution":{ "name":"UpdateStreamingDistribution2020_05_31", "http":{ @@ -1220,6 +1316,7 @@ "Compress":{"shape":"boolean"}, "LambdaFunctionAssociations":{"shape":"LambdaFunctionAssociations"}, "FieldLevelEncryptionId":{"shape":"string"}, + "RealtimeLogConfigArn":{"shape":"string"}, "CachePolicyId":{"shape":"string"}, "OriginRequestPolicyId":{"shape":"string"}, "ForwardedValues":{ @@ -1842,6 +1939,27 @@ }, "payload":"PublicKey" }, + "CreateRealtimeLogConfigRequest":{ + "type":"structure", + "required":[ + "EndPoints", + "Fields", + "Name", + "SamplingRate" + ], + "members":{ + "EndPoints":{"shape":"EndPointList"}, + "Fields":{"shape":"FieldList"}, + "Name":{"shape":"string"}, + "SamplingRate":{"shape":"long"} + } + }, + "CreateRealtimeLogConfigResult":{ + "type":"structure", + "members":{ + "RealtimeLogConfig":{"shape":"RealtimeLogConfig"} + } + }, "CreateStreamingDistributionRequest":{ "type":"structure", "required":["StreamingDistributionConfig"], @@ -1965,6 +2083,7 @@ "Compress":{"shape":"boolean"}, "LambdaFunctionAssociations":{"shape":"LambdaFunctionAssociations"}, "FieldLevelEncryptionId":{"shape":"string"}, + "RealtimeLogConfigArn":{"shape":"string"}, "CachePolicyId":{"shape":"string"}, "OriginRequestPolicyId":{"shape":"string"}, "ForwardedValues":{ @@ -2113,6 +2232,13 @@ } } }, + "DeleteRealtimeLogConfigRequest":{ + "type":"structure", + "members":{ + "Name":{"shape":"string"}, + "ARN":{"shape":"string"} + } + }, "DeleteStreamingDistributionRequest":{ "type":"structure", "required":["Id"], @@ -2330,6 +2456,18 @@ "locationName":"EncryptionEntity" } }, + "EndPoint":{ + "type":"structure", + "required":["StreamType"], + "members":{ + "StreamType":{"shape":"string"}, + "KinesisStreamConfig":{"shape":"KinesisStreamConfig"} + } + }, + "EndPointList":{ + "type":"list", + "member":{"shape":"EndPoint"} + }, "EventType":{ "type":"string", "enum":[ @@ -2499,6 +2637,13 @@ "locationName":"FieldLevelEncryptionSummary" } }, + "FieldList":{ + "type":"list", + "member":{ + "shape":"string", + "locationName":"Field" + } + }, "FieldPatternList":{ "type":"list", "member":{ @@ -2917,6 +3062,19 @@ }, "payload":"PublicKey" }, + "GetRealtimeLogConfigRequest":{ + "type":"structure", + "members":{ + "Name":{"shape":"string"}, + "ARN":{"shape":"string"} + } + }, + "GetRealtimeLogConfigResult":{ + "type":"structure", + "members":{ + "RealtimeLogConfig":{"shape":"RealtimeLogConfig"} + } + }, "GetStreamingDistributionConfigRequest":{ "type":"structure", "required":["Id"], @@ -3295,6 +3453,17 @@ "Items":{"shape":"KeyPairIdList"} } }, + "KinesisStreamConfig":{ + "type":"structure", + "required":[ + "RoleARN", + "StreamARN" + ], + "members":{ + "RoleARN":{"shape":"string"}, + "StreamARN":{"shape":"string"} + } + }, "LambdaFunctionARN":{"type":"string"}, "LambdaFunctionAssociation":{ "type":"structure", @@ -3428,6 +3597,22 @@ }, "payload":"DistributionIdList" }, + "ListDistributionsByRealtimeLogConfigRequest":{ + "type":"structure", + "members":{ + "Marker":{"shape":"string"}, + "MaxItems":{"shape":"string"}, + "RealtimeLogConfigName":{"shape":"string"}, + "RealtimeLogConfigArn":{"shape":"string"} + } + }, + "ListDistributionsByRealtimeLogConfigResult":{ + "type":"structure", + "members":{ + "DistributionList":{"shape":"DistributionList"} + }, + "payload":"DistributionList" + }, "ListDistributionsByWebACLIdRequest":{ "type":"structure", "required":["WebACLId"], @@ -3599,6 +3784,28 @@ }, "payload":"PublicKeyList" }, + "ListRealtimeLogConfigsRequest":{ + "type":"structure", + "members":{ + "MaxItems":{ + "shape":"string", + "location":"querystring", + "locationName":"MaxItems" + }, + "Marker":{ + "shape":"string", + "location":"querystring", + "locationName":"Marker" + } + } + }, + "ListRealtimeLogConfigsResult":{ + "type":"structure", + "members":{ + "RealtimeLogConfigs":{"shape":"RealtimeLogConfigs"} + }, + "payload":"RealtimeLogConfigs" + }, "ListStreamingDistributionsRequest":{ "type":"structure", "members":{ @@ -3778,6 +3985,14 @@ "error":{"httpStatusCode":404}, "exception":true }, + "NoSuchRealtimeLogConfig":{ + "type":"structure", + "members":{ + "Message":{"shape":"string"} + }, + "error":{"httpStatusCode":404}, + "exception":true + }, "NoSuchResource":{ "type":"structure", "members":{ @@ -4258,6 +4473,58 @@ "locationName":"Name" } }, + "RealtimeLogConfig":{ + "type":"structure", + "required":[ + "ARN", + "Name", + "SamplingRate", + "EndPoints", + "Fields" + ], + "members":{ + "ARN":{"shape":"string"}, + "Name":{"shape":"string"}, + "SamplingRate":{"shape":"long"}, + "EndPoints":{"shape":"EndPointList"}, + "Fields":{"shape":"FieldList"} + } + }, + "RealtimeLogConfigAlreadyExists":{ + "type":"structure", + "members":{ + "Message":{"shape":"string"} + }, + "error":{"httpStatusCode":409}, + "exception":true + }, + "RealtimeLogConfigInUse":{ + "type":"structure", + "members":{ + "Message":{"shape":"string"} + }, + "error":{"httpStatusCode":400}, + "exception":true + }, + "RealtimeLogConfigList":{ + "type":"list", + "member":{"shape":"RealtimeLogConfig"} + }, + "RealtimeLogConfigs":{ + "type":"structure", + "required":[ + "MaxItems", + "IsTruncated", + "Marker" + ], + "members":{ + "MaxItems":{"shape":"integer"}, + "Items":{"shape":"RealtimeLogConfigList"}, + "IsTruncated":{"shape":"boolean"}, + "Marker":{"shape":"string"}, + "NextMarker":{"shape":"string"} + } + }, "RealtimeMetricsSubscriptionConfig":{ "type":"structure", "required":["RealtimeMetricsSubscriptionStatus"], @@ -4305,7 +4572,8 @@ "type":"string", "enum":[ "sni-only", - "vip" + "vip", + "static-ip" ] }, "Signer":{ @@ -4820,6 +5088,14 @@ "error":{"httpStatusCode":400}, "exception":true }, + "TooManyRealtimeLogConfigs":{ + "type":"structure", + "members":{ + "Message":{"shape":"string"} + }, + "error":{"httpStatusCode":400}, + "exception":true + }, "TooManyStreamingDistributionCNAMEs":{ "type":"structure", "members":{ @@ -5143,6 +5419,22 @@ }, "payload":"PublicKey" }, + "UpdateRealtimeLogConfigRequest":{ + "type":"structure", + "members":{ + "EndPoints":{"shape":"EndPointList"}, + "Fields":{"shape":"FieldList"}, + "Name":{"shape":"string"}, + "ARN":{"shape":"string"}, + "SamplingRate":{"shape":"long"} + } + }, + "UpdateRealtimeLogConfigResult":{ + "type":"structure", + "members":{ + "RealtimeLogConfig":{"shape":"RealtimeLogConfig"} + } + }, "UpdateStreamingDistributionRequest":{ "type":"structure", "required":[ diff --git a/models/apis/cloudfront/2020-05-31/docs-2.json b/models/apis/cloudfront/2020-05-31/docs-2.json index d0293e75afe..33e83e824fb 100644 --- a/models/apis/cloudfront/2020-05-31/docs-2.json +++ b/models/apis/cloudfront/2020-05-31/docs-2.json @@ -12,6 +12,7 @@ "CreateMonitoringSubscription": "

Enables additional CloudWatch metrics for the specified CloudFront distribution. The additional metrics incur an additional cost.

For more information, see Viewing additional CloudFront distribution metrics in the Amazon CloudFront Developer Guide.

", "CreateOriginRequestPolicy": "

Creates an origin request policy.

After you create an origin request policy, you can attach it to one or more cache behaviors. When it’s attached to a cache behavior, the origin request policy determines the values that CloudFront includes in requests that it sends to the origin. Each request that CloudFront sends to the origin includes the following:

CloudFront sends a request when it can’t find a valid object in its cache that matches the request. If you want to send values to the origin and also include them in the cache key, use CreateCachePolicy.

For more information about origin request policies, see Controlling origin requests in the Amazon CloudFront Developer Guide.

", "CreatePublicKey": "

Add a new public key to CloudFront to use, for example, for field-level encryption. You can add a maximum of 10 public keys with one AWS account.

", + "CreateRealtimeLogConfig": "

Creates a real-time log configuration.

After you create a real-time log configuration, you can attach it to one or more cache behaviors to send real-time log data to the specified Amazon Kinesis data stream.

For more information about real-time log configurations, see Real-time logs in the Amazon CloudFront Developer Guide.

", "CreateStreamingDistribution": "

Creates a new RTMP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

", "CreateStreamingDistributionWithTags": "

Create a new streaming distribution with tags.

", "DeleteCachePolicy": "

Deletes a cache policy.

You cannot delete a cache policy if it’s attached to a cache behavior. First update your distributions to remove the cache policy from all cache behaviors, then delete the cache policy.

To delete a cache policy, you must provide the policy’s identifier and version. To get these values, you can use ListCachePolicies or GetCachePolicy.

", @@ -22,6 +23,7 @@ "DeleteMonitoringSubscription": "

Disables additional CloudWatch metrics for the specified CloudFront distribution.

", "DeleteOriginRequestPolicy": "

Deletes an origin request policy.

You cannot delete an origin request policy if it’s attached to any cache behaviors. First update your distributions to remove the origin request policy from all cache behaviors, then delete the origin request policy.

To delete an origin request policy, you must provide the policy’s identifier and version. To get the identifier, you can use ListOriginRequestPolicies or GetOriginRequestPolicy.

", "DeletePublicKey": "

Remove a public key you previously added to CloudFront.

", + "DeleteRealtimeLogConfig": "

Deletes a real-time log configuration.

You cannot delete a real-time log configuration if it’s attached to a cache behavior. First update your distributions to remove the real-time log configuration from all cache behaviors, then delete the real-time log configuration.

To delete a real-time log configuration, you can provide the configuration’s name or its Amazon Resource Name (ARN). You must provide at least one. If you provide both, CloudFront uses the name to identify the real-time log configuration to delete.

", "DeleteStreamingDistribution": "

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

  1. Disable the RTMP distribution.

  2. Submit a GET Streaming Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Streaming Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  5. Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Streaming Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  8. Review the response to your DELETE Streaming Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

", "GetCachePolicy": "

Gets a cache policy, including the following metadata:

To get a cache policy, you must provide the policy’s identifier. If the cache policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the cache policy is not attached to a cache behavior, you can get the identifier using ListCachePolicies.

", "GetCachePolicyConfig": "

Gets a cache policy configuration.

To get a cache policy configuration, you must provide the policy’s identifier. If the cache policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the cache policy is not attached to a cache behavior, you can get the identifier using ListCachePolicies.

", @@ -39,6 +41,7 @@ "GetOriginRequestPolicyConfig": "

Gets an origin request policy configuration.

To get an origin request policy configuration, you must provide the policy’s identifier. If the origin request policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the origin request policy is not attached to a cache behavior, you can get the identifier using ListOriginRequestPolicies.

", "GetPublicKey": "

Get the public key information.

", "GetPublicKeyConfig": "

Return public key configuration informaation

", + "GetRealtimeLogConfig": "

Gets a real-time log configuration.

To get a real-time log configuration, you can provide the configuration’s name or its Amazon Resource Name (ARN). You must provide at least one. If you provide both, CloudFront uses the name to identify the real-time log configuration to get.

", "GetStreamingDistribution": "

Gets information about a specified RTMP distribution, including the distribution configuration.

", "GetStreamingDistributionConfig": "

Get the configuration information about a streaming distribution.

", "ListCachePolicies": "

Gets a list of cache policies.

You can optionally apply a filter to return only the managed policies created by AWS, or only the custom policies created in your AWS account.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

", @@ -46,12 +49,14 @@ "ListDistributions": "

List CloudFront distributions.

", "ListDistributionsByCachePolicyId": "

Gets a list of distribution IDs for distributions that have a cache behavior that’s associated with the specified cache policy.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

", "ListDistributionsByOriginRequestPolicyId": "

Gets a list of distribution IDs for distributions that have a cache behavior that’s associated with the specified origin request policy.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

", + "ListDistributionsByRealtimeLogConfig": "

Gets a list of distribution that have a cache behavior that’s associated with the specified real-time log configuration.

You can specify the real-time log configuration by its name or its Amazon Resource Name (ARN). You must provide at least one. If you provide both, CloudFront uses the name to identify the real-time log configuration to list distributions for.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

", "ListDistributionsByWebACLId": "

List the distributions that are associated with a specified AWS WAF web ACL.

", "ListFieldLevelEncryptionConfigs": "

List all field-level encryption configurations that have been created in CloudFront for this account.

", "ListFieldLevelEncryptionProfiles": "

Request a list of field-level encryption profiles that have been created in CloudFront for this account.

", "ListInvalidations": "

Lists invalidation batches.

", "ListOriginRequestPolicies": "

Gets a list of origin request policies.

You can optionally apply a filter to return only the managed policies created by AWS, or only the custom policies created in your AWS account.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

", "ListPublicKeys": "

List all public keys that have been added to CloudFront for this account.

", + "ListRealtimeLogConfigs": "

Gets a list of real-time log configurations.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

", "ListStreamingDistributions": "

List streaming distributions.

", "ListTagsForResource": "

List tags for a CloudFront resource.

", "TagResource": "

Add tags to a CloudFront resource.

", @@ -63,6 +68,7 @@ "UpdateFieldLevelEncryptionProfile": "

Update a field-level encryption profile.

", "UpdateOriginRequestPolicy": "

Updates an origin request policy configuration.

When you update an origin request policy configuration, all the fields are updated with the values provided in the request. You cannot update some fields independent of others. To update an origin request policy configuration:

  1. Use GetOriginRequestPolicyConfig to get the current configuration.

  2. Locally modify the fields in the origin request policy configuration that you want to update.

  3. Call UpdateOriginRequestPolicy by providing the entire origin request policy configuration, including the fields that you modified and those that you didn’t.

", "UpdatePublicKey": "

Update public key information. Note that the only value you can change is the comment.

", + "UpdateRealtimeLogConfig": "

Updates a real-time log configuration.

When you update a real-time log configuration, all the parameters are updated with the values provided in the request. You cannot update some parameters independent of others. To update a real-time log configuration:

  1. Call GetRealtimeLogConfig to get the current real-time log configuration.

  2. Locally modify the parameters in the real-time log configuration that you want to update.

  3. Call this API (UpdateRealtimeLogConfig) by providing the entire real-time log configuration, including the parameters that you modified and those that you didn’t.

You cannot update a real-time log configuration’s Name or ARN.

", "UpdateStreamingDistribution": "

Update a streaming distribution.

" }, "shapes": { @@ -450,6 +456,16 @@ "refs": { } }, + "CreateRealtimeLogConfigRequest": { + "base": null, + "refs": { + } + }, + "CreateRealtimeLogConfigResult": { + "base": null, + "refs": { + } + }, "CreateStreamingDistributionRequest": { "base": "

The request to create a new streaming distribution.

", "refs": { @@ -553,6 +569,11 @@ "refs": { } }, + "DeleteRealtimeLogConfigRequest": { + "base": null, + "refs": { + } + }, "DeleteStreamingDistributionRequest": { "base": "

The request to delete a streaming distribution.

", "refs": { @@ -604,6 +625,7 @@ "DistributionList": { "base": "

A distribution list.

", "refs": { + "ListDistributionsByRealtimeLogConfigResult$DistributionList": null, "ListDistributionsByWebACLIdResult$DistributionList": "

The DistributionList type.

", "ListDistributionsResult$DistributionList": "

The DistributionList type.

" } @@ -644,6 +666,20 @@ "EncryptionEntities$Items": "

An array of field patterns in a field-level encryption content type-profile mapping.

" } }, + "EndPoint": { + "base": "

Contains information about the Amazon Kinesis data stream where you are sending real-time log data in a real-time log configuration.

", + "refs": { + "EndPointList$member": null + } + }, + "EndPointList": { + "base": null, + "refs": { + "CreateRealtimeLogConfigRequest$EndPoints": "

Contains information about the Amazon Kinesis data stream where you are sending real-time log data.

", + "RealtimeLogConfig$EndPoints": "

Contains information about the Amazon Kinesis data stream where you are sending real-time log data for this real-time log configuration.

", + "UpdateRealtimeLogConfigRequest$EndPoints": "

Contains information about the Amazon Kinesis data stream where you are sending real-time log data.

" + } + }, "EventType": { "base": null, "refs": { @@ -745,6 +781,14 @@ "FieldLevelEncryptionList$Items": "

An array of field-level encryption items.

" } }, + "FieldList": { + "base": null, + "refs": { + "CreateRealtimeLogConfigRequest$Fields": "

A list of fields to include in each real-time log record.

For more information about fields, see Real-time log configuration fields in the Amazon CloudFront Developer Guide.

", + "RealtimeLogConfig$Fields": "

A list of fields that are included in each real-time log record. In an API response, the fields are provided in the same order in which they are sent to the Amazon Kinesis data stream.

For more information about fields, see Real-time log configuration fields in the Amazon CloudFront Developer Guide.

", + "UpdateRealtimeLogConfigRequest$Fields": "

A list of fields to include in each real-time log record.

For more information about fields, see Real-time log configuration fields in the Amazon CloudFront Developer Guide.

" + } + }, "FieldPatternList": { "base": null, "refs": { @@ -942,6 +986,16 @@ "refs": { } }, + "GetRealtimeLogConfigRequest": { + "base": null, + "refs": { + } + }, + "GetRealtimeLogConfigResult": { + "base": null, + "refs": { + } + }, "GetStreamingDistributionConfigRequest": { "base": "

To request to get a streaming distribution configuration.

", "refs": { @@ -1174,6 +1228,12 @@ "Signer$KeyPairIds": "

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

" } }, + "KinesisStreamConfig": { + "base": "

Contains information about the Amazon Kinesis data stream where you are sending real-time log data.

", + "refs": { + "EndPoint$KinesisStreamConfig": "

Contains information about the Amazon Kinesis data stream where you are sending real-time log data.

" + } + }, "LambdaFunctionARN": { "base": null, "refs": { @@ -1239,6 +1299,16 @@ "refs": { } }, + "ListDistributionsByRealtimeLogConfigRequest": { + "base": null, + "refs": { + } + }, + "ListDistributionsByRealtimeLogConfigResult": { + "base": null, + "refs": { + } + }, "ListDistributionsByWebACLIdRequest": { "base": "

The request to list distributions that are associated with a specified AWS WAF web ACL.

", "refs": { @@ -1309,6 +1379,16 @@ "refs": { } }, + "ListRealtimeLogConfigsRequest": { + "base": null, + "refs": { + } + }, + "ListRealtimeLogConfigsResult": { + "base": null, + "refs": { + } + }, "ListStreamingDistributionsRequest": { "base": "

The request to list your streaming distributions.

", "refs": { @@ -1418,6 +1498,11 @@ "refs": { } }, + "NoSuchRealtimeLogConfig": { + "base": "

The real-time log configuration does not exist.

", + "refs": { + } + }, "NoSuchResource": { "base": "

A resource that was specified is not valid.

", "refs": { @@ -1735,6 +1820,37 @@ "QueryStringNames$Items": "

A list of query string names.

" } }, + "RealtimeLogConfig": { + "base": "

A real-time log configuration.

", + "refs": { + "CreateRealtimeLogConfigResult$RealtimeLogConfig": "

A real-time log configuration.

", + "GetRealtimeLogConfigResult$RealtimeLogConfig": "

A real-time log configuration.

", + "RealtimeLogConfigList$member": null, + "UpdateRealtimeLogConfigResult$RealtimeLogConfig": "

A real-time log configuration.

" + } + }, + "RealtimeLogConfigAlreadyExists": { + "base": "

A real-time log configuration with this name already exists. You must provide a unique name. To modify an existing real-time log configuration, use UpdateRealtimeLogConfig.

", + "refs": { + } + }, + "RealtimeLogConfigInUse": { + "base": "

Cannot delete the real-time log configuration because it is attached to one or more cache behaviors.

", + "refs": { + } + }, + "RealtimeLogConfigList": { + "base": null, + "refs": { + "RealtimeLogConfigs$Items": "

Contains the list of real-time log configurations.

" + } + }, + "RealtimeLogConfigs": { + "base": "

A list of real-time log configurations.

", + "refs": { + "ListRealtimeLogConfigsResult$RealtimeLogConfigs": "

A list of real-time log configurations.

" + } + }, "RealtimeMetricsSubscriptionConfig": { "base": "

A subscription configuration for additional CloudWatch metrics.

", "refs": { @@ -1778,7 +1894,7 @@ "SSLSupportMethod": { "base": null, "refs": { - "ViewerCertificate$SSLSupportMethod": "

If the distribution uses Aliases (alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.

If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, don’t set a value for this field.

" + "ViewerCertificate$SSLSupportMethod": "

If the distribution uses Aliases (alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.

If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, don’t set a value for this field.

" } }, "Signer": { @@ -2092,6 +2208,11 @@ "refs": { } }, + "TooManyRealtimeLogConfigs": { + "base": "

You have reached the maximum number of real-time log configurations for this AWS account. For more information, see Quotas (formerly known as limits) in the Amazon CloudFront Developer Guide.

", + "refs": { + } + }, "TooManyStreamingDistributionCNAMEs": { "base": "

Your request contains more CNAMEs than are allowed per distribution.

", "refs": { @@ -2196,6 +2317,16 @@ "refs": { } }, + "UpdateRealtimeLogConfigRequest": { + "base": null, + "refs": { + } + }, + "UpdateRealtimeLogConfigResult": { + "base": null, + "refs": { + } + }, "UpdateStreamingDistributionRequest": { "base": "

The request to update a streaming distribution.

", "refs": { @@ -2243,6 +2374,7 @@ "LoggingConfig$IncludeCookies": "

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

", "ParametersInCacheKeyAndForwardedToOrigin$EnableAcceptEncodingGzip": "

A flag that determines whether the Accept-Encoding HTTP header is included in the cache key and included in requests that CloudFront sends to the origin.

If this field is true and the viewer request includes the Accept-Encoding header, then CloudFront normalizes the value of the viewer’s Accept-Encoding header to one of the following:

CloudFront includes the normalized header in the cache key and includes it in requests that CloudFront sends to the origin.

If this field is false, then CloudFront treats the Accept-Encoding header the same as any other HTTP header in the viewer request. By default, it’s not included in the cache key and it’s not included in origin requests. You can manually add Accept-Encoding to the headers whitelist like any other HTTP header.

When this field is true, you should not whitelist the Accept-Encoding header in the cache policy or in an origin request policy attached to the same cache behavior.

For more information, see Cache compressed objects in the Amazon CloudFront Developer Guide.

", "QueryArgProfileConfig$ForwardWhenQueryArgProfileIsUnknown": "

Flag to set if you want a request to be forwarded to the origin even if the profile specified by the field-level encryption query argument, fle-profile, is unknown.

", + "RealtimeLogConfigs$IsTruncated": "

A flag that indicates whether there are more real-time log configurations than are contained in this list.

", "StreamingDistributionConfig$Enabled": "

Whether the streaming distribution is enabled to accept user requests for content.

", "StreamingDistributionList$IsTruncated": "

A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

", "StreamingDistributionSummary$Enabled": "

Whether the distribution is enabled to accept end user requests for content.

", @@ -2303,6 +2435,7 @@ "QueryArgProfiles$Quantity": "

Number of profiles for query argument-profile mapping for field-level encryption.

", "QueryStringCacheKeys$Quantity": "

The number of whitelisted query string parameters for a cache behavior.

", "QueryStringNames$Quantity": "

The number of query string names in the Items list.

", + "RealtimeLogConfigs$MaxItems": "

The maximum number of real-time log configurations requested.

", "StatusCodeList$member": null, "StatusCodes$Quantity": "

The number of status codes.

", "StreamingDistributionList$MaxItems": "

The value you provided for the MaxItems request parameter.

", @@ -2319,10 +2452,13 @@ "CachePolicyConfig$DefaultTTL": "

The default amount of time, in seconds, that you want objects to stay in the CloudFront cache before CloudFront sends another request to the origin to see if the object has been updated. CloudFront uses this value as the object’s time to live (TTL) only when the origin does not send Cache-Control or Expires headers with the object. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

The default value for this field is 86400 seconds (one day). If the value of MinTTL is more than 86400 seconds, then the default value for this field is the same as the value of MinTTL.

", "CachePolicyConfig$MaxTTL": "

The maximum amount of time, in seconds, that objects stay in the CloudFront cache before CloudFront sends another request to the origin to see if the object has been updated. CloudFront uses this value only when the origin sends Cache-Control or Expires headers with the object. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

The default value for this field is 31536000 seconds (one year). If the value of MinTTL or DefaultTTL is more than 31536000 seconds, then the default value for this field is the same as the value of DefaultTTL.

", "CachePolicyConfig$MinTTL": "

The minimum amount of time, in seconds, that you want objects to stay in the CloudFront cache before CloudFront sends another request to the origin to see if the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

", + "CreateRealtimeLogConfigRequest$SamplingRate": "

The sampling rate for this real-time log configuration. The sampling rate determines the percentage of viewer requests that are represented in the real-time log data. You must provide an integer between 1 and 100, inclusive.

", "CustomErrorResponse$ErrorCachingMinTTL": "

The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available.

For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

", "DefaultCacheBehavior$MinTTL": "

This field is deprecated. We recommend that you use the MinTTL field in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

", "DefaultCacheBehavior$DefaultTTL": "

This field is deprecated. We recommend that you use the DefaultTTL field in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

", - "DefaultCacheBehavior$MaxTTL": "

This field is deprecated. We recommend that you use the MaxTTL field in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" + "DefaultCacheBehavior$MaxTTL": "

This field is deprecated. We recommend that you use the MaxTTL field in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

", + "RealtimeLogConfig$SamplingRate": "

The sampling rate for this real-time log configuration. The sampling rate determines the percentage of viewer requests that are represented in the real-time log data. The sampling rate is an integer between 1 and 100, inclusive.

", + "UpdateRealtimeLogConfigRequest$SamplingRate": "

The sampling rate for this real-time log configuration. The sampling rate determines the percentage of viewer requests that are represented in the real-time log data. You must provide an integer between 1 and 100, inclusive.

" } }, "string": { @@ -2337,6 +2473,7 @@ "CacheBehavior$PathPattern": "

The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution.

You can optionally include a slash (/) at the beginning of the path pattern. For example, /images/*.jpg. CloudFront behavior is the same with or without the leading /.

The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior.

For more information, see Path Pattern in the Amazon CloudFront Developer Guide.

", "CacheBehavior$TargetOriginId": "

The value of ID for the origin that you want CloudFront to route requests to when they match this cache behavior.

", "CacheBehavior$FieldLevelEncryptionId": "

The value of ID for the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.

", + "CacheBehavior$RealtimeLogConfigArn": "

The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.

", "CacheBehavior$CachePolicyId": "

The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

", "CacheBehavior$OriginRequestPolicyId": "

The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.

", "CachePolicy$Id": "

The unique identifier for the cache policy.

", @@ -2379,6 +2516,7 @@ "CreateOriginRequestPolicyResult$ETag": "

The current version of the origin request policy.

", "CreatePublicKeyResult$Location": "

The fully qualified URI of the new public key resource just created.

", "CreatePublicKeyResult$ETag": "

The current version of the public key. For example: E2QWRUHAPOMQZL.

", + "CreateRealtimeLogConfigRequest$Name": "

A unique name to identify this real-time log configuration.

", "CreateStreamingDistributionResult$Location": "

The fully qualified URI of the new streaming distribution resource just created.

", "CreateStreamingDistributionResult$ETag": "

The current version of the streaming distribution created.

", "CreateStreamingDistributionWithTagsResult$Location": "

The fully qualified URI of the new streaming distribution resource just created.

", @@ -2387,6 +2525,7 @@ "CustomErrorResponse$ResponseCode": "

The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example:

If you specify a value for ResponseCode, you must also specify a value for ResponsePagePath.

", "DefaultCacheBehavior$TargetOriginId": "

The value of ID for the origin that you want CloudFront to route requests to when they use the default cache behavior.

", "DefaultCacheBehavior$FieldLevelEncryptionId": "

The value of ID for the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.

", + "DefaultCacheBehavior$RealtimeLogConfigArn": "

The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.

", "DefaultCacheBehavior$CachePolicyId": "

The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

", "DefaultCacheBehavior$OriginRequestPolicyId": "

The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.

", "DeleteCachePolicyRequest$Id": "

The unique identifier for the cache policy that you are deleting. To get the identifier, you can use ListCachePolicies.

", @@ -2404,6 +2543,8 @@ "DeleteOriginRequestPolicyRequest$IfMatch": "

The version of the origin request policy that you are deleting. The version is the origin request policy’s ETag value, which you can get using ListOriginRequestPolicies, GetOriginRequestPolicy, or GetOriginRequestPolicyConfig.

", "DeletePublicKeyRequest$Id": "

The ID of the public key you want to remove from CloudFront.

", "DeletePublicKeyRequest$IfMatch": "

The value of the ETag header that you received when retrieving the public key identity to delete. For example: E2QWRUHAPOMQZL.

", + "DeleteRealtimeLogConfigRequest$Name": "

The name of the real-time log configuration to delete.

", + "DeleteRealtimeLogConfigRequest$ARN": "

The Amazon Resource Name (ARN) of the real-time log configuration to delete.

", "DeleteStreamingDistributionRequest$Id": "

The distribution ID.

", "DeleteStreamingDistributionRequest$IfMatch": "

The value of the ETag header that you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.

", "Distribution$Id": "

The identifier for the distribution. For example: EDFDVBD632BHDS5.

", @@ -2428,6 +2569,7 @@ "DistributionSummary$WebACLId": "

The Web ACL Id (if any) associated with the distribution.

", "EncryptionEntity$PublicKeyId": "

The public key associated with a set of field-level encryption patterns, to be used when encrypting the fields that match the patterns.

", "EncryptionEntity$ProviderId": "

The provider associated with the public key being used for encryption. This value must also be provided with the private key for applications to be able to decrypt data.

", + "EndPoint$StreamType": "

The type of data stream where you are sending real-time log data. The only valid value is Kinesis.

", "FieldLevelEncryption$Id": "

The configuration ID for a field-level encryption configuration which includes a set of profiles that specify certain selected data fields to be encrypted by specific public keys.

", "FieldLevelEncryptionConfig$CallerReference": "

A unique number that ensures the request can't be replayed.

", "FieldLevelEncryptionConfig$Comment": "

An optional comment about the configuration.

", @@ -2447,6 +2589,7 @@ "FieldLevelEncryptionProfileSummary$Comment": "

An optional comment for the field-level encryption profile summary.

", "FieldLevelEncryptionSummary$Id": "

The unique ID of a field-level encryption item.

", "FieldLevelEncryptionSummary$Comment": "

An optional comment about the field-level encryption item.

", + "FieldList$member": null, "FieldPatternList$member": null, "GetCachePolicyConfigRequest$Id": "

The unique identifier for the cache policy. If the cache policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the cache policy is not attached to a cache behavior, you can get the identifier using ListCachePolicies.

", "GetCachePolicyConfigResult$ETag": "

The current version of the cache policy.

", @@ -2479,6 +2622,8 @@ "GetPublicKeyConfigResult$ETag": "

The current version of the public key configuration. For example: E2QWRUHAPOMQZL.

", "GetPublicKeyRequest$Id": "

Request the ID for the public key.

", "GetPublicKeyResult$ETag": "

The current version of the public key. For example: E2QWRUHAPOMQZL.

", + "GetRealtimeLogConfigRequest$Name": "

The name of the real-time log configuration to get.

", + "GetRealtimeLogConfigRequest$ARN": "

The Amazon Resource Name (ARN) of the real-time log configuration to get.

", "GetStreamingDistributionConfigRequest$Id": "

The streaming distribution's ID.

", "GetStreamingDistributionConfigResult$ETag": "

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", "GetStreamingDistributionRequest$Id": "

The streaming distribution's ID.

", @@ -2519,6 +2664,8 @@ "InvalidationSummary$Id": "

The unique ID for an invalidation request.

", "InvalidationSummary$Status": "

The status of an invalidation request.

", "KeyPairIdList$member": null, + "KinesisStreamConfig$RoleARN": "

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that CloudFront can use to send real-time log data to your Kinesis data stream.

For more information the IAM role, see Real-time log configuration IAM role in the Amazon CloudFront Developer Guide.

", + "KinesisStreamConfig$StreamARN": "

The Amazon Resource Name (ARN) of the Kinesis data stream where you are sending real-time log data.

", "ListCachePoliciesRequest$Marker": "

Use this field when paginating results to indicate where to begin in your list of cache policies. The response includes cache policies in the list that occur after the marker. To get the next page of the list, set this field’s value to the value of NextMarker from the current page’s response.

", "ListCachePoliciesRequest$MaxItems": "

The maximum number of cache policies that you want in the response.

", "ListCloudFrontOriginAccessIdentitiesRequest$Marker": "

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

", @@ -2529,6 +2676,10 @@ "ListDistributionsByOriginRequestPolicyIdRequest$Marker": "

Use this field when paginating results to indicate where to begin in your list of distribution IDs. The response includes distribution IDs in the list that occur after the marker. To get the next page of the list, set this field’s value to the value of NextMarker from the current page’s response.

", "ListDistributionsByOriginRequestPolicyIdRequest$MaxItems": "

The maximum number of distribution IDs that you want in the response.

", "ListDistributionsByOriginRequestPolicyIdRequest$OriginRequestPolicyId": "

The ID of the origin request policy whose associated distribution IDs you want to list.

", + "ListDistributionsByRealtimeLogConfigRequest$Marker": "

Use this field when paginating results to indicate where to begin in your list of distributions. The response includes distributions in the list that occur after the marker. To get the next page of the list, set this field’s value to the value of NextMarker from the current page’s response.

", + "ListDistributionsByRealtimeLogConfigRequest$MaxItems": "

The maximum number of distributions that you want in the response.

", + "ListDistributionsByRealtimeLogConfigRequest$RealtimeLogConfigName": "

The name of the real-time log configuration whose associated distributions you want to list.

", + "ListDistributionsByRealtimeLogConfigRequest$RealtimeLogConfigArn": "

The Amazon Resource Name (ARN) of the real-time log configuration whose associated distributions you want to list.

", "ListDistributionsByWebACLIdRequest$Marker": "

Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)

", "ListDistributionsByWebACLIdRequest$MaxItems": "

The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.

", "ListDistributionsByWebACLIdRequest$WebACLId": "

The ID of the AWS WAF web ACL that you want to list the associated distributions. If you specify \"null\" for the ID, the request returns a list of the distributions that aren't associated with a web ACL.

", @@ -2545,6 +2696,8 @@ "ListOriginRequestPoliciesRequest$MaxItems": "

The maximum number of origin request policies that you want in the response.

", "ListPublicKeysRequest$Marker": "

Use this when paginating results to indicate where to begin in your list of public keys. The results include public keys in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last public key on that page).

", "ListPublicKeysRequest$MaxItems": "

The maximum number of public keys you want in the response body.

", + "ListRealtimeLogConfigsRequest$MaxItems": "

The maximum number of real-time log configurations that you want in the response.

", + "ListRealtimeLogConfigsRequest$Marker": "

Use this field when paginating results to indicate where to begin in your list of real-time log configurations. The response includes real-time log configurations in the list that occur after the marker. To get the next page of the list, set this field’s value to the value of NextMarker from the current page’s response.

", "ListStreamingDistributionsRequest$Marker": "

The value that you provided for the Marker request parameter.

", "ListStreamingDistributionsRequest$MaxItems": "

The value that you provided for the MaxItems request parameter.

", "LocationList$member": null, @@ -2560,6 +2713,7 @@ "NoSuchOrigin$Message": null, "NoSuchOriginRequestPolicy$Message": null, "NoSuchPublicKey$Message": null, + "NoSuchRealtimeLogConfig$Message": null, "NoSuchResource$Message": null, "NoSuchStreamingDistribution$Message": null, "Origin$Id": "

A unique identifier for the origin. This value must be unique within the distribution.

Use this value to specify the TargetOriginId in a CacheBehavior or DefaultCacheBehavior.

", @@ -2594,6 +2748,12 @@ "QueryArgProfileEmpty$Message": null, "QueryStringCacheKeysList$member": null, "QueryStringNamesList$member": null, + "RealtimeLogConfig$ARN": "

The Amazon Resource Name (ARN) of this real-time log configuration.

", + "RealtimeLogConfig$Name": "

The unique name of this real-time log configuration.

", + "RealtimeLogConfigAlreadyExists$Message": null, + "RealtimeLogConfigInUse$Message": null, + "RealtimeLogConfigs$Marker": "

This parameter indicates where this list of real-time log configurations begins. This list includes real-time log configurations that occur after the marker.

", + "RealtimeLogConfigs$NextMarker": "

If there are more items in the list than are in this response, this element is present. It contains the value that you should use in the Marker field of a subsequent request to continue listing real-time log configurations where you left off.

", "S3Origin$DomainName": "

The DNS name of the Amazon S3 origin.

", "S3Origin$OriginAccessIdentity": "

The CloudFront origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an Amazon S3 bucket through CloudFront.

If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content in the Amazon CloudFront Developer Guide.

", "S3OriginConfig$OriginAccessIdentity": "

The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:

origin-access-identity/cloudfront/ID-of-origin-access-identity

where ID-of-origin-access-identity is the value that CloudFront returned in the ID element when you created the origin access identity.

If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

", @@ -2648,6 +2808,7 @@ "TooManyQueryStringParameters$Message": null, "TooManyQueryStringsInCachePolicy$Message": null, "TooManyQueryStringsInOriginRequestPolicy$Message": null, + "TooManyRealtimeLogConfigs$Message": null, "TooManyStreamingDistributionCNAMEs$Message": null, "TooManyStreamingDistributions$Message": null, "TooManyTrustedSigners$Message": null, @@ -2673,6 +2834,8 @@ "UpdatePublicKeyRequest$Id": "

ID of the public key to be updated.

", "UpdatePublicKeyRequest$IfMatch": "

The value of the ETag header that you received when retrieving the public key to update. For example: E2QWRUHAPOMQZL.

", "UpdatePublicKeyResult$ETag": "

The current version of the update public key result. For example: E2QWRUHAPOMQZL.

", + "UpdateRealtimeLogConfigRequest$Name": "

The name for this real-time log configuration.

", + "UpdateRealtimeLogConfigRequest$ARN": "

The Amazon Resource Name (ARN) for this real-time log configuration.

", "UpdateStreamingDistributionRequest$Id": "

The streaming distribution's id.

", "UpdateStreamingDistributionRequest$IfMatch": "

The value of the ETag header that you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.

", "UpdateStreamingDistributionResult$ETag": "

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index ab8733d5e87..99f429e57d4 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -20813,6 +20813,10 @@ "members":{ "DryRun":{"shape":"Boolean"}, "ExcessCapacityTerminationPolicy":{"shape":"FleetExcessCapacityTerminationPolicy"}, + "LaunchTemplateConfigs":{ + "shape":"FleetLaunchTemplateConfigListRequest", + "locationName":"LaunchTemplateConfig" + }, "FleetId":{"shape":"FleetId"}, "TargetCapacitySpecification":{"shape":"TargetCapacitySpecificationRequest"} } @@ -21284,6 +21288,10 @@ "shape":"ExcessCapacityTerminationPolicy", "locationName":"excessCapacityTerminationPolicy" }, + "LaunchTemplateConfigs":{ + "shape":"LaunchTemplateConfigList", + "locationName":"LaunchTemplateConfig" + }, "SpotFleetRequestId":{ "shape":"SpotFleetRequestId", "locationName":"spotFleetRequestId" @@ -25108,6 +25116,7 @@ "customer-gateway", "dedicated-host", "dhcp-options", + "egress-only-internet-gateway", "elastic-ip", "elastic-gpu", "export-image-task", diff --git a/models/apis/ec2/2016-11-15/docs-2.json b/models/apis/ec2/2016-11-15/docs-2.json index 56c0dfa45fb..ebebdfa1722 100755 --- a/models/apis/ec2/2016-11-15/docs-2.json +++ b/models/apis/ec2/2016-11-15/docs-2.json @@ -6377,7 +6377,8 @@ "FleetLaunchTemplateConfigListRequest": { "base": null, "refs": { - "CreateFleetRequest$LaunchTemplateConfigs": "

The configuration for the EC2 Fleet.

" + "CreateFleetRequest$LaunchTemplateConfigs": "

The configuration for the EC2 Fleet.

", + "ModifyFleetRequest$LaunchTemplateConfigs": "

The launch template and overrides.

" } }, "FleetLaunchTemplateConfigRequest": { @@ -8566,6 +8567,7 @@ "LaunchTemplateConfigList": { "base": null, "refs": { + "ModifySpotFleetRequestRequest$LaunchTemplateConfigs": "

The launch template and overrides. You can only use this parameter if you specified a launch template (LaunchTemplateConfigs) in your Spot Fleet request. If you specified LaunchSpecifications in your Spot Fleet request, then omit this parameter.

", "SpotFleetRequestConfigData$LaunchTemplateConfigs": "

The launch template and overrides. If you specify LaunchTemplateConfigs, you can't specify LaunchSpecifications. If you include On-Demand capacity in your request, you must use LaunchTemplateConfigs.

" } }, diff --git a/models/apis/sqs/2012-11-05/docs-2.json b/models/apis/sqs/2012-11-05/docs-2.json index 63920c0c2d2..56609e2dc8b 100644 --- a/models/apis/sqs/2012-11-05/docs-2.json +++ b/models/apis/sqs/2012-11-05/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "

Welcome to the Amazon Simple Queue Service API Reference.

Amazon Simple Queue Service (Amazon SQS) is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.

You can use AWS SDKs to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:

Additional Information

", + "service": "

Welcome to the Amazon Simple Queue Service API Reference.

Amazon Simple Queue Service (Amazon SQS) is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.

For information on the permissions you need to use this API, see Identity and access management in the Amazon Simple Queue Service Developer Guide.

You can use AWS SDKs to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:

Additional Information

", "operations": { "AddPermission": "

Adds a permission to a queue for a specific principal. This allows sharing access to the queue.

When you create a queue, you have full control access rights for the queue. Only you, the owner of the queue, can grant or deny permissions to the queue. For more information about these permissions, see Allow Developers to Write Messages to a Shared Queue in the Amazon Simple Queue Service Developer Guide.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&AttributeName.1=first

&AttributeName.2=second

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

", "ChangeMessageVisibility": "

Changes the visibility timeout of a specified message in a queue to a new value. The default visibility timeout for a message is 30 seconds. The minimum is 0 seconds. The maximum is 12 hours. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

For example, you have a message with a visibility timeout of 5 minutes. After 3 minutes, you call ChangeMessageVisibility with a timeout of 10 minutes. You can continue to call ChangeMessageVisibility to extend the visibility timeout to the maximum allowed time. If you try to extend the visibility timeout beyond the maximum, your request is rejected.

An Amazon SQS message has three basic states:

  1. Sent to a queue by a producer.

  2. Received from the queue by a consumer.

  3. Deleted from the queue.

A message is considered to be stored after it is sent to a queue by a producer, but not yet received from the queue by a consumer (that is, between states 1 and 2). There is no limit to the number of stored messages. A message is considered to be in flight after it is received from a queue by a consumer, but not yet deleted from the queue (that is, between states 2 and 3). There is a limit to the number of inflight messages.

Limits that apply to inflight messages are unrelated to the unlimited number of stored messages.

For most standard queues (depending on queue traffic and message backlog), there can be a maximum of approximately 120,000 inflight messages (received from a queue by a consumer, but not yet deleted from the queue). If you reach this limit, Amazon SQS returns the OverLimit error message. To avoid reaching the limit, you should delete messages from the queue after they're processed. You can also increase the number of queues you use to process your messages. To request a limit increase, file a support request.

For FIFO queues, there can be a maximum of 20,000 inflight messages (received from a queue by a consumer, but not yet deleted from the queue). If you reach this limit, Amazon SQS returns no error messages.

If you attempt to set the VisibilityTimeout to a value greater than the maximum time left, Amazon SQS returns an error. Amazon SQS doesn't automatically recalculate and increase the timeout to the maximum remaining time.

Unlike with a queue, when you change the visibility timeout for a specific message the timeout value is applied immediately but isn't saved in memory for that message. If you don't delete a message after it is received, the visibility timeout for the message reverts to the original timeout value (not to the value you set using the ChangeMessageVisibility action) the next time the message is received.

", @@ -11,9 +11,9 @@ "DeleteQueue": "

Deletes the queue specified by the QueueUrl, regardless of the queue's contents.

Be careful with the DeleteQueue action: When you delete a queue, any messages in the queue are no longer available.

When you delete a queue, the deletion process takes up to 60 seconds. Requests you send involving that queue during the 60 seconds might succeed. For example, a SendMessage request might succeed, but after 60 seconds the queue and the message you sent no longer exist.

When you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

", "GetQueueAttributes": "

Gets attributes for the specified queue.

To determine whether a queue is FIFO, you can check whether QueueName ends with the .fifo suffix.

", "GetQueueUrl": "

Returns the URL of an existing Amazon SQS queue.

To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId parameter to specify the account ID of the queue's owner. The queue's owner must grant you permission to access the queue. For more information about shared queue access, see AddPermission or see Allow Developers to Write Messages to a Shared Queue in the Amazon Simple Queue Service Developer Guide.

", - "ListDeadLetterSourceQueues": "

Returns a list of your queues that have the RedrivePolicy queue attribute configured with a dead-letter queue.

For more information about using dead-letter queues, see Using Amazon SQS Dead-Letter Queues in the Amazon Simple Queue Service Developer Guide.

", + "ListDeadLetterSourceQueues": "

Returns a list of your queues that have the RedrivePolicy queue attribute configured with a dead-letter queue.

The ListDeadLetterSourceQueues methods supports pagination. Set parameter MaxResults in the request to specify the maximum number of results to be returned in the response. If you do not set MaxResults, the response includes a maximum of 1,000 results. If you set MaxResults and there are additional results to display, the response includes a value for NextToken. Use NextToken as a parameter in your next request to ListDeadLetterSourceQueues to receive the next page of results.

For more information about using dead-letter queues, see Using Amazon SQS Dead-Letter Queues in the Amazon Simple Queue Service Developer Guide.

", "ListQueueTags": "

List all cost allocation tags added to the specified Amazon SQS queue. For an overview, see Tagging Your Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

", - "ListQueues": "

Returns a list of your queues. The maximum number of queues that can be returned is 1,000. If you specify a value for the optional QueueNamePrefix parameter, only queues with a name that begins with the specified value are returned.

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

", + "ListQueues": "

Returns a list of your queues in the current region. The response includes a maximum of 1,000 results. If you specify a value for the optional QueueNamePrefix parameter, only queues with a name that begins with the specified value are returned.

The listQueues methods supports pagination. Set parameter MaxResults in the request to specify the maximum number of results to be returned in the response. If you do not set MaxResults, the response includes a maximum of 1,000 results. If you set MaxResults and there are additional results to display, the response includes a value for NextToken. Use NextToken as a parameter in your next request to listQueues to receive the next page of results.

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

", "PurgeQueue": "

Deletes the messages in a queue specified by the QueueURL parameter.

When you use the PurgeQueue action, you can't retrieve any messages deleted from a queue.

The message deletion process takes up to 60 seconds. We recommend waiting for 60 seconds regardless of your queue's size.

Messages sent to the queue before you call PurgeQueue might be received but are deleted within the next minute.

Messages sent to the queue after you call PurgeQueue might be deleted while the queue is being purged.

", "ReceiveMessage": "

Retrieves one or more messages (up to 10), from the specified queue. Using the WaitTimeSeconds parameter enables long-poll support. For more information, see Amazon SQS Long Polling in the Amazon Simple Queue Service Developer Guide.

Short poll is the default behavior where a weighted random set of machines is sampled on a ReceiveMessage call. Thus, only the messages on the sampled machines are returned. If the number of messages in the queue is small (fewer than 1,000), you most likely get fewer messages than you requested per ReceiveMessage call. If the number of messages in the queue is extremely small, you might not receive any messages in a particular ReceiveMessage response. If this happens, repeat the request.

For each message returned, the response includes the following:

The receipt handle is the identifier you must provide when deleting the message. For more information, see Queue and Message Identifiers in the Amazon Simple Queue Service Developer Guide.

You can provide the VisibilityTimeout parameter in your request. The parameter is applied to the messages that Amazon SQS returns in the response. If you don't include the parameter, the overall visibility timeout for the queue is used for the returned messages. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

A message that isn't deleted or a message whose visibility isn't extended before the visibility timeout expires counts as a failed receive. Depending on the configuration of the queue, the message might be sent to the dead-letter queue.

In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.

", "RemovePermission": "

Revokes any permissions in the queue policy that matches the specified Label parameter.

", @@ -96,8 +96,8 @@ "BoxedInteger": { "base": null, "refs": { - "ListDeadLetterSourceQueuesRequest$MaxResults": "

Maximum number of results to include in the response.

", - "ListQueuesRequest$MaxResults": "

Maximum number of results to include in the response.

" + "ListDeadLetterSourceQueuesRequest$MaxResults": "

Maximum number of results to include in the response. Value range is 1 to 1000. You must set MaxResults to receive a value for NextToken in the response.

", + "ListQueuesRequest$MaxResults": "

Maximum number of results to include in the response. Value range is 1 to 1000. You must set MaxResults to receive a value for NextToken in the response.

" } }, "ChangeMessageVisibilityBatchRequest": { @@ -222,7 +222,7 @@ "base": null, "refs": { "ChangeMessageVisibilityBatchRequestEntry$VisibilityTimeout": "

The new value (in seconds) for the message's visibility timeout.

", - "ChangeMessageVisibilityRequest$VisibilityTimeout": "

The new value for the message's visibility timeout (in seconds). Values values: 0 to 43200. Maximum: 12 hours.

", + "ChangeMessageVisibilityRequest$VisibilityTimeout": "

The new value for the message's visibility timeout (in seconds). Values range: 0 to 43200. Maximum: 12 hours.

", "ReceiveMessageRequest$MaxNumberOfMessages": "

The maximum number of messages to return. Amazon SQS never returns more messages than this value (however, fewer messages might be returned). Valid values: 1 to 10. Default: 1.

", "ReceiveMessageRequest$VisibilityTimeout": "

The duration (in seconds) that the received messages are hidden from subsequent retrieve requests after being retrieved by a ReceiveMessage request.

", "ReceiveMessageRequest$WaitTimeSeconds": "

The duration (in seconds) for which the call waits for a message to arrive in the queue before returning. If a message is available, the call returns sooner than WaitTimeSeconds. If no messages are available and the wait time expires, the call returns successfully with an empty list of messages.

To avoid HTTP errors, ensure that the HTTP response timeout for ReceiveMessage requests is longer than the WaitTimeSeconds parameter. For example, with the Java SDK, you can set HTTP transport settings using the NettyNioAsyncHttpClient for asynchronous clients, or the ApacheHttpClient for synchronous clients.

", @@ -307,9 +307,9 @@ "MessageBodyAttributeMap": { "base": null, "refs": { - "Message$MessageAttributes": "

Each message attribute consists of a Name, Type, and Value. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", - "SendMessageBatchRequestEntry$MessageAttributes": "

Each message attribute consists of a Name, Type, and Value. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", - "SendMessageRequest$MessageAttributes": "

Each message attribute consists of a Name, Type, and Value. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

" + "Message$MessageAttributes": "

Each message attribute consists of a Name, Type, and Value. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", + "SendMessageBatchRequestEntry$MessageAttributes": "

Each message attribute consists of a Name, Type, and Value. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", + "SendMessageRequest$MessageAttributes": "

Each message attribute consists of a Name, Type, and Value. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

" } }, "MessageBodySystemAttributeMap": { @@ -513,11 +513,11 @@ "Message$Body": "

The message's contents (not URL-encoded).

", "Message$MD5OfMessageAttributes": "

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

", "MessageAttributeValue$StringValue": "

Strings are Unicode with UTF-8 binary encoding. For a list of code values, see ASCII Printable Characters.

", - "MessageAttributeValue$DataType": "

Amazon SQS supports the following logical data types: String, Number, and Binary. For the Number data type, you must use StringValue.

You can also append custom labels. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", + "MessageAttributeValue$DataType": "

Amazon SQS supports the following logical data types: String, Number, and Binary. For the Number data type, you must use StringValue.

You can also append custom labels. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", "MessageBodyAttributeMap$key": null, "MessageSystemAttributeMap$value": null, "MessageSystemAttributeValue$StringValue": "

Strings are Unicode with UTF-8 binary encoding. For a list of code values, see ASCII Printable Characters.

", - "MessageSystemAttributeValue$DataType": "

Amazon SQS supports the following logical data types: String, Number, and Binary. For the Number data type, you must use StringValue.

You can also append custom labels. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", + "MessageSystemAttributeValue$DataType": "

Amazon SQS supports the following logical data types: String, Number, and Binary. For the Number data type, you must use StringValue.

You can also append custom labels. For more information, see Amazon SQS Message Attributes in the Amazon Simple Queue Service Developer Guide.

", "PurgeQueueRequest$QueueUrl": "

The URL of the queue from which the PurgeQueue action deletes messages.

Queue URLs and names are case-sensitive.

", "QueueAttributeMap$value": null, "QueueUrlList$member": null, @@ -537,7 +537,7 @@ "SendMessageBatchResultEntry$MD5OfMessageSystemAttributes": "

An MD5 digest of the non-URL-encoded message system attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

", "SendMessageBatchResultEntry$SequenceNumber": "

This parameter applies only to FIFO (first-in-first-out) queues.

The large, non-consecutive number that Amazon SQS assigns to each message.

The length of SequenceNumber is 128 bits. As SequenceNumber continues to increase for a particular MessageGroupId.

", "SendMessageRequest$QueueUrl": "

The URL of the Amazon SQS queue to which a message is sent.

Queue URLs and names are case-sensitive.

", - "SendMessageRequest$MessageBody": "

The message to send. The maximum string size is 256 KB.

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

#x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

", + "SendMessageRequest$MessageBody": "

The message to send. The minimum size is one character. The maximum size is 256 KB.

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

#x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

", "SendMessageRequest$MessageDeduplicationId": "

This parameter applies only to FIFO (first-in-first-out) queues.

The token used for deduplication of sent messages. If a message with a particular MessageDeduplicationId is sent successfully, any messages sent with the same MessageDeduplicationId are accepted successfully but aren't delivered during the 5-minute deduplication interval. For more information, see Exactly-Once Processing in the Amazon Simple Queue Service Developer Guide.

The MessageDeduplicationId is available to the consumer of the message (this can be useful for troubleshooting delivery issues).

If a message is sent successfully but the acknowledgement is lost and the message is resent with the same MessageDeduplicationId after the deduplication interval, Amazon SQS can't detect duplicate messages.

Amazon SQS continues to keep track of the message deduplication ID even after the message is received and deleted.

The maximum length of MessageDeduplicationId is 128 characters. MessageDeduplicationId can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using MessageDeduplicationId, see Using the MessageDeduplicationId Property in the Amazon Simple Queue Service Developer Guide.

", "SendMessageRequest$MessageGroupId": "

This parameter applies only to FIFO (first-in-first-out) queues.

The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use MessageGroupId values (for example, session data for multiple users). In this scenario, multiple consumers can process the queue, but the session data of each user is processed in a FIFO fashion.

The length of MessageGroupId is 128 characters. Valid values: alphanumeric characters and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using MessageGroupId, see Using the MessageGroupId Property in the Amazon Simple Queue Service Developer Guide.

MessageGroupId is required for FIFO queues. You can't use it for Standard queues.

", "SendMessageResult$MD5OfMessageBody": "

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

", @@ -594,9 +594,9 @@ "base": null, "refs": { "ListDeadLetterSourceQueuesRequest$NextToken": "

Pagination token to request the next set of results.

", - "ListDeadLetterSourceQueuesResult$NextToken": "

Pagination token to include in the next request.

", + "ListDeadLetterSourceQueuesResult$NextToken": "

Pagination token to include in the next request. Token value is null if there are no additional results to request, or if you did not set MaxResults in the request.

", "ListQueuesRequest$NextToken": "

Pagination token to request the next set of results.

", - "ListQueuesResult$NextToken": "

Pagination token to include in the next request.

" + "ListQueuesResult$NextToken": "

Pagination token to include in the next request. Token value is null if there are no additional results to request, or if you did not set MaxResults in the request.

" } }, "TooManyEntriesInBatchRequest": { diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index eda02db66db..c163ee7e9c5 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -190,6 +190,7 @@ "protocols" : [ "https" ] }, "endpoints" : { + "af-south-1" : { }, "ap-east-1" : { }, "ap-northeast-1" : { }, "ap-northeast-2" : { }, @@ -199,6 +200,7 @@ "ca-central-1" : { }, "eu-central-1" : { }, "eu-north-1" : { }, + "eu-south-1" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, @@ -3549,7 +3551,6 @@ "ap-northeast-2" : { }, "ap-southeast-1" : { }, "eu-west-1" : { }, - "eu-west-2" : { }, "us-east-1" : { } } }, @@ -7546,13 +7547,13 @@ "credentialScope" : { "region" : "us-gov-east-1" }, - "hostname" : "elasticloadbalancing-fips.us-gov-east-1.amazonaws.com" + "hostname" : "elasticloadbalancing.us-gov-east-1.amazonaws.com" }, "fips-us-gov-west-1" : { "credentialScope" : { "region" : "us-gov-west-1" }, - "hostname" : "elasticloadbalancing-fips.us-gov-west-1.amazonaws.com" + "hostname" : "elasticloadbalancing.us-gov-west-1.amazonaws.com" }, "us-gov-east-1" : { }, "us-gov-west-1" : { diff --git a/service/backup/api.go b/service/backup/api.go index f9bd26b3672..24adf77fd5d 100644 --- a/service/backup/api.go +++ b/service/backup/api.go @@ -162,9 +162,9 @@ func (c *Backup) CreateBackupSelectionRequest(input *CreateBackupSelectionInput) // // * Resources: "arn:aws:ec2:region:account-id:volume/volume-id" // -// * ConditionKey:"department" ConditionValue:"finance" ConditionType:"STRINGEQUALS" +// * ConditionKey:"department" ConditionValue:"finance" ConditionType:"StringEquals" // -// * ConditionKey:"importance" ConditionValue:"critical" ConditionType:"STRINGEQUALS" +// * ConditionKey:"importance" ConditionValue:"critical" ConditionType:"StringEquals" // // Using these patterns would back up all Amazon Elastic Block Store (Amazon // EBS) volumes that are tagged as "department=finance", "importance=critical", @@ -5197,7 +5197,7 @@ func (s *CalculatedLifecycle) SetMoveToColdStorageAt(v time.Time) *CalculatedLif return s } -// Contains an array of triplets made up of a condition type (such as STRINGEQUALS), +// Contains an array of triplets made up of a condition type (such as StringEquals), // a key, and a value. Conditions are used to filter resources in a selection // that is assigned to a backup plan. type Condition struct { @@ -5209,7 +5209,7 @@ type Condition struct { // ConditionKey is a required field ConditionKey *string `type:"string" required:"true"` - // An operation, such as STRINGEQUALS, that is applied to a key-value pair used + // An operation, such as StringEquals, that is applied to a key-value pair used // to filter resources in a selection. // // ConditionType is a required field @@ -11214,14 +11214,14 @@ func (s *RuleInput) SetTargetBackupVaultName(v string) *RuleInput { type Selection struct { _ struct{} `type:"structure"` - // The ARN of the IAM role that AWS Backup uses to authenticate when restoring - // the target resource; for example, arn:aws:iam::123456789012:role/S3Access. + // The ARN of the IAM role that AWS Backup uses to authenticate when backing + // up the target resource; for example, arn:aws:iam::123456789012:role/S3Access. // // IamRoleArn is a required field IamRoleArn *string `type:"string" required:"true"` // An array of conditions used to specify a set of resources to assign to a - // backup plan; for example, "STRINGEQUALS": {"ec2:ResourceTag/Department": + // backup plan; for example, "StringEquals": {"ec2:ResourceTag/Department": // "accounting". ListOfTags []*Condition `type:"list"` diff --git a/service/cloudfront/api.go b/service/cloudfront/api.go index 8d66af6c338..1fc2a10e5ff 100644 --- a/service/cloudfront/api.go +++ b/service/cloudfront/api.go @@ -1368,6 +1368,102 @@ func (c *CloudFront) CreatePublicKeyWithContext(ctx aws.Context, input *CreatePu return out, req.Send() } +const opCreateRealtimeLogConfig = "CreateRealtimeLogConfig2020_05_31" + +// CreateRealtimeLogConfigRequest generates a "aws/request.Request" representing the +// client's request for the CreateRealtimeLogConfig operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See CreateRealtimeLogConfig for more information on using the CreateRealtimeLogConfig +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the CreateRealtimeLogConfigRequest method. +// req, resp := client.CreateRealtimeLogConfigRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/CreateRealtimeLogConfig +func (c *CloudFront) CreateRealtimeLogConfigRequest(input *CreateRealtimeLogConfigInput) (req *request.Request, output *CreateRealtimeLogConfigOutput) { + op := &request.Operation{ + Name: opCreateRealtimeLogConfig, + HTTPMethod: "POST", + HTTPPath: "/2020-05-31/realtime-log-config", + } + + if input == nil { + input = &CreateRealtimeLogConfigInput{} + } + + output = &CreateRealtimeLogConfigOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateRealtimeLogConfig API operation for Amazon CloudFront. +// +// Creates a real-time log configuration. +// +// After you create a real-time log configuration, you can attach it to one +// or more cache behaviors to send real-time log data to the specified Amazon +// Kinesis data stream. +// +// For more information about real-time log configurations, see Real-time logs +// (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html) +// in the Amazon CloudFront Developer Guide. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon CloudFront's +// API operation CreateRealtimeLogConfig for usage and error information. +// +// Returned Error Codes: +// * ErrCodeRealtimeLogConfigAlreadyExists "RealtimeLogConfigAlreadyExists" +// A real-time log configuration with this name already exists. You must provide +// a unique name. To modify an existing real-time log configuration, use UpdateRealtimeLogConfig. +// +// * ErrCodeTooManyRealtimeLogConfigs "TooManyRealtimeLogConfigs" +// You have reached the maximum number of real-time log configurations for this +// AWS account. For more information, see Quotas (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html) +// (formerly known as limits) in the Amazon CloudFront Developer Guide. +// +// * ErrCodeInvalidArgument "InvalidArgument" +// An argument is invalid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/CreateRealtimeLogConfig +func (c *CloudFront) CreateRealtimeLogConfig(input *CreateRealtimeLogConfigInput) (*CreateRealtimeLogConfigOutput, error) { + req, out := c.CreateRealtimeLogConfigRequest(input) + return out, req.Send() +} + +// CreateRealtimeLogConfigWithContext is the same as CreateRealtimeLogConfig with the addition of +// the ability to pass a context and additional request options. +// +// See CreateRealtimeLogConfig for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CloudFront) CreateRealtimeLogConfigWithContext(ctx aws.Context, input *CreateRealtimeLogConfigInput, opts ...request.Option) (*CreateRealtimeLogConfigOutput, error) { + req, out := c.CreateRealtimeLogConfigRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateStreamingDistribution = "CreateStreamingDistribution2020_05_31" // CreateStreamingDistributionRequest generates a "aws/request.Request" representing the @@ -2388,6 +2484,102 @@ func (c *CloudFront) DeletePublicKeyWithContext(ctx aws.Context, input *DeletePu return out, req.Send() } +const opDeleteRealtimeLogConfig = "DeleteRealtimeLogConfig2020_05_31" + +// DeleteRealtimeLogConfigRequest generates a "aws/request.Request" representing the +// client's request for the DeleteRealtimeLogConfig operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeleteRealtimeLogConfig for more information on using the DeleteRealtimeLogConfig +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DeleteRealtimeLogConfigRequest method. +// req, resp := client.DeleteRealtimeLogConfigRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/DeleteRealtimeLogConfig +func (c *CloudFront) DeleteRealtimeLogConfigRequest(input *DeleteRealtimeLogConfigInput) (req *request.Request, output *DeleteRealtimeLogConfigOutput) { + op := &request.Operation{ + Name: opDeleteRealtimeLogConfig, + HTTPMethod: "POST", + HTTPPath: "/2020-05-31/delete-realtime-log-config/", + } + + if input == nil { + input = &DeleteRealtimeLogConfigInput{} + } + + output = &DeleteRealtimeLogConfigOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteRealtimeLogConfig API operation for Amazon CloudFront. +// +// Deletes a real-time log configuration. +// +// You cannot delete a real-time log configuration if it’s attached to a cache +// behavior. First update your distributions to remove the real-time log configuration +// from all cache behaviors, then delete the real-time log configuration. +// +// To delete a real-time log configuration, you can provide the configuration’s +// name or its Amazon Resource Name (ARN). You must provide at least one. If +// you provide both, CloudFront uses the name to identify the real-time log +// configuration to delete. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon CloudFront's +// API operation DeleteRealtimeLogConfig for usage and error information. +// +// Returned Error Codes: +// * ErrCodeNoSuchRealtimeLogConfig "NoSuchRealtimeLogConfig" +// The real-time log configuration does not exist. +// +// * ErrCodeRealtimeLogConfigInUse "RealtimeLogConfigInUse" +// Cannot delete the real-time log configuration because it is attached to one +// or more cache behaviors. +// +// * ErrCodeInvalidArgument "InvalidArgument" +// An argument is invalid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/DeleteRealtimeLogConfig +func (c *CloudFront) DeleteRealtimeLogConfig(input *DeleteRealtimeLogConfigInput) (*DeleteRealtimeLogConfigOutput, error) { + req, out := c.DeleteRealtimeLogConfigRequest(input) + return out, req.Send() +} + +// DeleteRealtimeLogConfigWithContext is the same as DeleteRealtimeLogConfig with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteRealtimeLogConfig for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CloudFront) DeleteRealtimeLogConfigWithContext(ctx aws.Context, input *DeleteRealtimeLogConfigInput, opts ...request.Option) (*DeleteRealtimeLogConfigOutput, error) { + req, out := c.DeleteRealtimeLogConfigRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteStreamingDistribution = "DeleteStreamingDistribution2020_05_31" // DeleteStreamingDistributionRequest generates a "aws/request.Request" representing the @@ -3865,6 +4057,93 @@ func (c *CloudFront) GetPublicKeyConfigWithContext(ctx aws.Context, input *GetPu return out, req.Send() } +const opGetRealtimeLogConfig = "GetRealtimeLogConfig2020_05_31" + +// GetRealtimeLogConfigRequest generates a "aws/request.Request" representing the +// client's request for the GetRealtimeLogConfig operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See GetRealtimeLogConfig for more information on using the GetRealtimeLogConfig +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the GetRealtimeLogConfigRequest method. +// req, resp := client.GetRealtimeLogConfigRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/GetRealtimeLogConfig +func (c *CloudFront) GetRealtimeLogConfigRequest(input *GetRealtimeLogConfigInput) (req *request.Request, output *GetRealtimeLogConfigOutput) { + op := &request.Operation{ + Name: opGetRealtimeLogConfig, + HTTPMethod: "POST", + HTTPPath: "/2020-05-31/get-realtime-log-config/", + } + + if input == nil { + input = &GetRealtimeLogConfigInput{} + } + + output = &GetRealtimeLogConfigOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetRealtimeLogConfig API operation for Amazon CloudFront. +// +// Gets a real-time log configuration. +// +// To get a real-time log configuration, you can provide the configuration’s +// name or its Amazon Resource Name (ARN). You must provide at least one. If +// you provide both, CloudFront uses the name to identify the real-time log +// configuration to get. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon CloudFront's +// API operation GetRealtimeLogConfig for usage and error information. +// +// Returned Error Codes: +// * ErrCodeNoSuchRealtimeLogConfig "NoSuchRealtimeLogConfig" +// The real-time log configuration does not exist. +// +// * ErrCodeInvalidArgument "InvalidArgument" +// An argument is invalid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/GetRealtimeLogConfig +func (c *CloudFront) GetRealtimeLogConfig(input *GetRealtimeLogConfigInput) (*GetRealtimeLogConfigOutput, error) { + req, out := c.GetRealtimeLogConfigRequest(input) + return out, req.Send() +} + +// GetRealtimeLogConfigWithContext is the same as GetRealtimeLogConfig with the addition of +// the ability to pass a context and additional request options. +// +// See GetRealtimeLogConfig for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CloudFront) GetRealtimeLogConfigWithContext(ctx aws.Context, input *GetRealtimeLogConfigInput, opts ...request.Option) (*GetRealtimeLogConfigOutput, error) { + req, out := c.GetRealtimeLogConfigRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opGetStreamingDistribution = "GetStreamingDistribution2020_05_31" // GetStreamingDistributionRequest generates a "aws/request.Request" representing the @@ -4582,6 +4861,97 @@ func (c *CloudFront) ListDistributionsByOriginRequestPolicyIdWithContext(ctx aws return out, req.Send() } +const opListDistributionsByRealtimeLogConfig = "ListDistributionsByRealtimeLogConfig2020_05_31" + +// ListDistributionsByRealtimeLogConfigRequest generates a "aws/request.Request" representing the +// client's request for the ListDistributionsByRealtimeLogConfig operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListDistributionsByRealtimeLogConfig for more information on using the ListDistributionsByRealtimeLogConfig +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListDistributionsByRealtimeLogConfigRequest method. +// req, resp := client.ListDistributionsByRealtimeLogConfigRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/ListDistributionsByRealtimeLogConfig +func (c *CloudFront) ListDistributionsByRealtimeLogConfigRequest(input *ListDistributionsByRealtimeLogConfigInput) (req *request.Request, output *ListDistributionsByRealtimeLogConfigOutput) { + op := &request.Operation{ + Name: opListDistributionsByRealtimeLogConfig, + HTTPMethod: "POST", + HTTPPath: "/2020-05-31/distributionsByRealtimeLogConfig/", + } + + if input == nil { + input = &ListDistributionsByRealtimeLogConfigInput{} + } + + output = &ListDistributionsByRealtimeLogConfigOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListDistributionsByRealtimeLogConfig API operation for Amazon CloudFront. +// +// Gets a list of distribution that have a cache behavior that’s associated +// with the specified real-time log configuration. +// +// You can specify the real-time log configuration by its name or its Amazon +// Resource Name (ARN). You must provide at least one. If you provide both, +// CloudFront uses the name to identify the real-time log configuration to list +// distributions for. +// +// You can optionally specify the maximum number of items to receive in the +// response. If the total number of items in the list exceeds the maximum that +// you specify, or the default maximum, the response is paginated. To get the +// next page of items, send a subsequent request that specifies the NextMarker +// value from the current response as the Marker value in the subsequent request. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon CloudFront's +// API operation ListDistributionsByRealtimeLogConfig for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidArgument "InvalidArgument" +// An argument is invalid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/ListDistributionsByRealtimeLogConfig +func (c *CloudFront) ListDistributionsByRealtimeLogConfig(input *ListDistributionsByRealtimeLogConfigInput) (*ListDistributionsByRealtimeLogConfigOutput, error) { + req, out := c.ListDistributionsByRealtimeLogConfigRequest(input) + return out, req.Send() +} + +// ListDistributionsByRealtimeLogConfigWithContext is the same as ListDistributionsByRealtimeLogConfig with the addition of +// the ability to pass a context and additional request options. +// +// See ListDistributionsByRealtimeLogConfig for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CloudFront) ListDistributionsByRealtimeLogConfigWithContext(ctx aws.Context, input *ListDistributionsByRealtimeLogConfigInput, opts ...request.Option) (*ListDistributionsByRealtimeLogConfigOutput, error) { + req, out := c.ListDistributionsByRealtimeLogConfigRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opListDistributionsByWebACLId = "ListDistributionsByWebACLId2020_05_31" // ListDistributionsByWebACLIdRequest generates a "aws/request.Request" representing the @@ -5143,6 +5513,86 @@ func (c *CloudFront) ListPublicKeysWithContext(ctx aws.Context, input *ListPubli return out, req.Send() } +const opListRealtimeLogConfigs = "ListRealtimeLogConfigs2020_05_31" + +// ListRealtimeLogConfigsRequest generates a "aws/request.Request" representing the +// client's request for the ListRealtimeLogConfigs operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListRealtimeLogConfigs for more information on using the ListRealtimeLogConfigs +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListRealtimeLogConfigsRequest method. +// req, resp := client.ListRealtimeLogConfigsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/ListRealtimeLogConfigs +func (c *CloudFront) ListRealtimeLogConfigsRequest(input *ListRealtimeLogConfigsInput) (req *request.Request, output *ListRealtimeLogConfigsOutput) { + op := &request.Operation{ + Name: opListRealtimeLogConfigs, + HTTPMethod: "GET", + HTTPPath: "/2020-05-31/realtime-log-config", + } + + if input == nil { + input = &ListRealtimeLogConfigsInput{} + } + + output = &ListRealtimeLogConfigsOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListRealtimeLogConfigs API operation for Amazon CloudFront. +// +// Gets a list of real-time log configurations. +// +// You can optionally specify the maximum number of items to receive in the +// response. If the total number of items in the list exceeds the maximum that +// you specify, or the default maximum, the response is paginated. To get the +// next page of items, send a subsequent request that specifies the NextMarker +// value from the current response as the Marker value in the subsequent request. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon CloudFront's +// API operation ListRealtimeLogConfigs for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/ListRealtimeLogConfigs +func (c *CloudFront) ListRealtimeLogConfigs(input *ListRealtimeLogConfigsInput) (*ListRealtimeLogConfigsOutput, error) { + req, out := c.ListRealtimeLogConfigsRequest(input) + return out, req.Send() +} + +// ListRealtimeLogConfigsWithContext is the same as ListRealtimeLogConfigs with the addition of +// the ability to pass a context and additional request options. +// +// See ListRealtimeLogConfigs for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CloudFront) ListRealtimeLogConfigsWithContext(ctx aws.Context, input *ListRealtimeLogConfigsInput, opts ...request.Option) (*ListRealtimeLogConfigsOutput, error) { + req, out := c.ListRealtimeLogConfigsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opListStreamingDistributions = "ListStreamingDistributions2020_05_31" // ListStreamingDistributionsRequest generates a "aws/request.Request" representing the @@ -6467,75 +6917,172 @@ const opUpdatePublicKey = "UpdatePublicKey2020_05_31" // fmt.Println(resp) // } // -// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/UpdatePublicKey -func (c *CloudFront) UpdatePublicKeyRequest(input *UpdatePublicKeyInput) (req *request.Request, output *UpdatePublicKeyOutput) { +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/UpdatePublicKey +func (c *CloudFront) UpdatePublicKeyRequest(input *UpdatePublicKeyInput) (req *request.Request, output *UpdatePublicKeyOutput) { + op := &request.Operation{ + Name: opUpdatePublicKey, + HTTPMethod: "PUT", + HTTPPath: "/2020-05-31/public-key/{Id}/config", + } + + if input == nil { + input = &UpdatePublicKeyInput{} + } + + output = &UpdatePublicKeyOutput{} + req = c.newRequest(op, input, output) + return +} + +// UpdatePublicKey API operation for Amazon CloudFront. +// +// Update public key information. Note that the only value you can change is +// the comment. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon CloudFront's +// API operation UpdatePublicKey for usage and error information. +// +// Returned Error Codes: +// * ErrCodeAccessDenied "AccessDenied" +// Access denied. +// +// * ErrCodeCannotChangeImmutablePublicKeyFields "CannotChangeImmutablePublicKeyFields" +// You can't change the value of a public key. +// +// * ErrCodeInvalidArgument "InvalidArgument" +// An argument is invalid. +// +// * ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" +// The If-Match version is missing or not valid. +// +// * ErrCodeIllegalUpdate "IllegalUpdate" +// The update contains modifications that are not allowed. +// +// * ErrCodeNoSuchPublicKey "NoSuchPublicKey" +// The specified public key doesn't exist. +// +// * ErrCodePreconditionFailed "PreconditionFailed" +// The precondition given in one or more of the request header fields evaluated +// to false. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/UpdatePublicKey +func (c *CloudFront) UpdatePublicKey(input *UpdatePublicKeyInput) (*UpdatePublicKeyOutput, error) { + req, out := c.UpdatePublicKeyRequest(input) + return out, req.Send() +} + +// UpdatePublicKeyWithContext is the same as UpdatePublicKey with the addition of +// the ability to pass a context and additional request options. +// +// See UpdatePublicKey for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CloudFront) UpdatePublicKeyWithContext(ctx aws.Context, input *UpdatePublicKeyInput, opts ...request.Option) (*UpdatePublicKeyOutput, error) { + req, out := c.UpdatePublicKeyRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opUpdateRealtimeLogConfig = "UpdateRealtimeLogConfig2020_05_31" + +// UpdateRealtimeLogConfigRequest generates a "aws/request.Request" representing the +// client's request for the UpdateRealtimeLogConfig operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UpdateRealtimeLogConfig for more information on using the UpdateRealtimeLogConfig +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the UpdateRealtimeLogConfigRequest method. +// req, resp := client.UpdateRealtimeLogConfigRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/UpdateRealtimeLogConfig +func (c *CloudFront) UpdateRealtimeLogConfigRequest(input *UpdateRealtimeLogConfigInput) (req *request.Request, output *UpdateRealtimeLogConfigOutput) { op := &request.Operation{ - Name: opUpdatePublicKey, + Name: opUpdateRealtimeLogConfig, HTTPMethod: "PUT", - HTTPPath: "/2020-05-31/public-key/{Id}/config", + HTTPPath: "/2020-05-31/realtime-log-config/", } if input == nil { - input = &UpdatePublicKeyInput{} + input = &UpdateRealtimeLogConfigInput{} } - output = &UpdatePublicKeyOutput{} + output = &UpdateRealtimeLogConfigOutput{} req = c.newRequest(op, input, output) return } -// UpdatePublicKey API operation for Amazon CloudFront. +// UpdateRealtimeLogConfig API operation for Amazon CloudFront. // -// Update public key information. Note that the only value you can change is -// the comment. +// Updates a real-time log configuration. +// +// When you update a real-time log configuration, all the parameters are updated +// with the values provided in the request. You cannot update some parameters +// independent of others. To update a real-time log configuration: +// +// Call GetRealtimeLogConfig to get the current real-time log configuration. +// +// Locally modify the parameters in the real-time log configuration that you +// want to update. +// +// Call this API (UpdateRealtimeLogConfig) by providing the entire real-time +// log configuration, including the parameters that you modified and those that +// you didn’t. +// +// You cannot update a real-time log configuration’s Name or ARN. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. // // See the AWS API reference guide for Amazon CloudFront's -// API operation UpdatePublicKey for usage and error information. +// API operation UpdateRealtimeLogConfig for usage and error information. // // Returned Error Codes: -// * ErrCodeAccessDenied "AccessDenied" -// Access denied. -// -// * ErrCodeCannotChangeImmutablePublicKeyFields "CannotChangeImmutablePublicKeyFields" -// You can't change the value of a public key. +// * ErrCodeNoSuchRealtimeLogConfig "NoSuchRealtimeLogConfig" +// The real-time log configuration does not exist. // // * ErrCodeInvalidArgument "InvalidArgument" // An argument is invalid. // -// * ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" -// The If-Match version is missing or not valid. -// -// * ErrCodeIllegalUpdate "IllegalUpdate" -// The update contains modifications that are not allowed. -// -// * ErrCodeNoSuchPublicKey "NoSuchPublicKey" -// The specified public key doesn't exist. -// -// * ErrCodePreconditionFailed "PreconditionFailed" -// The precondition given in one or more of the request header fields evaluated -// to false. -// -// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/UpdatePublicKey -func (c *CloudFront) UpdatePublicKey(input *UpdatePublicKeyInput) (*UpdatePublicKeyOutput, error) { - req, out := c.UpdatePublicKeyRequest(input) +// See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/UpdateRealtimeLogConfig +func (c *CloudFront) UpdateRealtimeLogConfig(input *UpdateRealtimeLogConfigInput) (*UpdateRealtimeLogConfigOutput, error) { + req, out := c.UpdateRealtimeLogConfigRequest(input) return out, req.Send() } -// UpdatePublicKeyWithContext is the same as UpdatePublicKey with the addition of +// UpdateRealtimeLogConfigWithContext is the same as UpdateRealtimeLogConfig with the addition of // the ability to pass a context and additional request options. // -// See UpdatePublicKey for details on how to use this API operation. +// See UpdateRealtimeLogConfig for details on how to use this API operation. // // The context must be non-nil and will be used for request cancellation. If // the context is nil a panic will occur. In the future the SDK may create // sub-contexts for http.Requests. See https://golang.org/pkg/context/ // for more information on using Contexts. -func (c *CloudFront) UpdatePublicKeyWithContext(ctx aws.Context, input *UpdatePublicKeyInput, opts ...request.Option) (*UpdatePublicKeyOutput, error) { - req, out := c.UpdatePublicKeyRequest(input) +func (c *CloudFront) UpdateRealtimeLogConfigWithContext(ctx aws.Context, input *UpdateRealtimeLogConfigInput, opts ...request.Option) (*UpdateRealtimeLogConfigOutput, error) { + req, out := c.UpdateRealtimeLogConfigRequest(input) req.SetContext(ctx) req.ApplyOptions(opts...) return out, req.Send() @@ -7089,6 +7636,12 @@ type CacheBehavior struct { // PathPattern is a required field PathPattern *string `type:"string" required:"true"` + // The Amazon Resource Name (ARN) of the real-time log configuration that is + // attached to this cache behavior. For more information, see Real-time logs + // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html) + // in the Amazon CloudFront Developer Guide. + RealtimeLogConfigArn *string `type:"string"` + // Indicates whether you want to distribute media files in the Microsoft Smooth // Streaming format using the origin that is associated with this cache behavior. // If so, specify true; if not, specify false. If you specify true for SmoothStreaming, @@ -7270,6 +7823,12 @@ func (s *CacheBehavior) SetPathPattern(v string) *CacheBehavior { return s } +// SetRealtimeLogConfigArn sets the RealtimeLogConfigArn field's value. +func (s *CacheBehavior) SetRealtimeLogConfigArn(v string) *CacheBehavior { + s.RealtimeLogConfigArn = &v + return s +} + // SetSmoothStreaming sets the SmoothStreaming field's value. func (s *CacheBehavior) SetSmoothStreaming(v bool) *CacheBehavior { s.SmoothStreaming = &v @@ -9127,6 +9686,126 @@ func (s *CreatePublicKeyOutput) SetPublicKey(v *PublicKey) *CreatePublicKeyOutpu return s } +type CreateRealtimeLogConfigInput struct { + _ struct{} `locationName:"CreateRealtimeLogConfigRequest" type:"structure" xmlURI:"http://cloudfront.amazonaws.com/doc/2020-05-31/"` + + // Contains information about the Amazon Kinesis data stream where you are sending + // real-time log data. + // + // EndPoints is a required field + EndPoints []*EndPoint `type:"list" required:"true"` + + // A list of fields to include in each real-time log record. + // + // For more information about fields, see Real-time log configuration fields + // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-fields) + // in the Amazon CloudFront Developer Guide. + // + // Fields is a required field + Fields []*string `locationNameList:"Field" type:"list" required:"true"` + + // A unique name to identify this real-time log configuration. + // + // Name is a required field + Name *string `type:"string" required:"true"` + + // The sampling rate for this real-time log configuration. The sampling rate + // determines the percentage of viewer requests that are represented in the + // real-time log data. You must provide an integer between 1 and 100, inclusive. + // + // SamplingRate is a required field + SamplingRate *int64 `type:"long" required:"true"` +} + +// String returns the string representation +func (s CreateRealtimeLogConfigInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateRealtimeLogConfigInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateRealtimeLogConfigInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateRealtimeLogConfigInput"} + if s.EndPoints == nil { + invalidParams.Add(request.NewErrParamRequired("EndPoints")) + } + if s.Fields == nil { + invalidParams.Add(request.NewErrParamRequired("Fields")) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.SamplingRate == nil { + invalidParams.Add(request.NewErrParamRequired("SamplingRate")) + } + if s.EndPoints != nil { + for i, v := range s.EndPoints { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "EndPoints", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEndPoints sets the EndPoints field's value. +func (s *CreateRealtimeLogConfigInput) SetEndPoints(v []*EndPoint) *CreateRealtimeLogConfigInput { + s.EndPoints = v + return s +} + +// SetFields sets the Fields field's value. +func (s *CreateRealtimeLogConfigInput) SetFields(v []*string) *CreateRealtimeLogConfigInput { + s.Fields = v + return s +} + +// SetName sets the Name field's value. +func (s *CreateRealtimeLogConfigInput) SetName(v string) *CreateRealtimeLogConfigInput { + s.Name = &v + return s +} + +// SetSamplingRate sets the SamplingRate field's value. +func (s *CreateRealtimeLogConfigInput) SetSamplingRate(v int64) *CreateRealtimeLogConfigInput { + s.SamplingRate = &v + return s +} + +type CreateRealtimeLogConfigOutput struct { + _ struct{} `type:"structure"` + + // A real-time log configuration. + RealtimeLogConfig *RealtimeLogConfig `type:"structure"` +} + +// String returns the string representation +func (s CreateRealtimeLogConfigOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateRealtimeLogConfigOutput) GoString() string { + return s.String() +} + +// SetRealtimeLogConfig sets the RealtimeLogConfig field's value. +func (s *CreateRealtimeLogConfigOutput) SetRealtimeLogConfig(v *RealtimeLogConfig) *CreateRealtimeLogConfigOutput { + s.RealtimeLogConfig = v + return s +} + // The request to create a new streaming distribution. type CreateStreamingDistributionInput struct { _ struct{} `locationName:"CreateStreamingDistributionRequest" type:"structure" payload:"StreamingDistributionConfig"` @@ -9805,6 +10484,12 @@ type DefaultCacheBehavior struct { // in the Amazon CloudFront Developer Guide. OriginRequestPolicyId *string `type:"string"` + // The Amazon Resource Name (ARN) of the real-time log configuration that is + // attached to this cache behavior. For more information, see Real-time logs + // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html) + // in the Amazon CloudFront Developer Guide. + RealtimeLogConfigArn *string `type:"string"` + // Indicates whether you want to distribute media files in the Microsoft Smooth // Streaming format using the origin that is associated with this cache behavior. // If so, specify true; if not, specify false. If you specify true for SmoothStreaming, @@ -9977,6 +10662,12 @@ func (s *DefaultCacheBehavior) SetOriginRequestPolicyId(v string) *DefaultCacheB return s } +// SetRealtimeLogConfigArn sets the RealtimeLogConfigArn field's value. +func (s *DefaultCacheBehavior) SetRealtimeLogConfigArn(v string) *DefaultCacheBehavior { + s.RealtimeLogConfigArn = &v + return s +} + // SetSmoothStreaming sets the SmoothStreaming field's value. func (s *DefaultCacheBehavior) SetSmoothStreaming(v bool) *DefaultCacheBehavior { s.SmoothStreaming = &v @@ -10551,6 +11242,52 @@ func (s DeletePublicKeyOutput) GoString() string { return s.String() } +type DeleteRealtimeLogConfigInput struct { + _ struct{} `locationName:"DeleteRealtimeLogConfigRequest" type:"structure" xmlURI:"http://cloudfront.amazonaws.com/doc/2020-05-31/"` + + // The Amazon Resource Name (ARN) of the real-time log configuration to delete. + ARN *string `type:"string"` + + // The name of the real-time log configuration to delete. + Name *string `type:"string"` +} + +// String returns the string representation +func (s DeleteRealtimeLogConfigInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteRealtimeLogConfigInput) GoString() string { + return s.String() +} + +// SetARN sets the ARN field's value. +func (s *DeleteRealtimeLogConfigInput) SetARN(v string) *DeleteRealtimeLogConfigInput { + s.ARN = &v + return s +} + +// SetName sets the Name field's value. +func (s *DeleteRealtimeLogConfigInput) SetName(v string) *DeleteRealtimeLogConfigInput { + s.Name = &v + return s +} + +type DeleteRealtimeLogConfigOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteRealtimeLogConfigOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteRealtimeLogConfigOutput) GoString() string { + return s.String() +} + // The request to delete a streaming distribution. type DeleteStreamingDistributionInput struct { _ struct{} `locationName:"DeleteStreamingDistributionRequest" type:"structure"` @@ -11730,6 +12467,62 @@ func (s *EncryptionEntity) SetPublicKeyId(v string) *EncryptionEntity { return s } +// Contains information about the Amazon Kinesis data stream where you are sending +// real-time log data in a real-time log configuration. +type EndPoint struct { + _ struct{} `type:"structure"` + + // Contains information about the Amazon Kinesis data stream where you are sending + // real-time log data. + KinesisStreamConfig *KinesisStreamConfig `type:"structure"` + + // The type of data stream where you are sending real-time log data. The only + // valid value is Kinesis. + // + // StreamType is a required field + StreamType *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s EndPoint) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s EndPoint) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *EndPoint) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "EndPoint"} + if s.StreamType == nil { + invalidParams.Add(request.NewErrParamRequired("StreamType")) + } + if s.KinesisStreamConfig != nil { + if err := s.KinesisStreamConfig.Validate(); err != nil { + invalidParams.AddNested("KinesisStreamConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetKinesisStreamConfig sets the KinesisStreamConfig field's value. +func (s *EndPoint) SetKinesisStreamConfig(v *KinesisStreamConfig) *EndPoint { + s.KinesisStreamConfig = v + return s +} + +// SetStreamType sets the StreamType field's value. +func (s *EndPoint) SetStreamType(v string) *EndPoint { + s.StreamType = &v + return s +} + // A complex data type that includes the profile configurations and other options // specified for field-level encryption. type FieldLevelEncryption struct { @@ -13761,6 +14554,61 @@ func (s *GetPublicKeyOutput) SetPublicKey(v *PublicKey) *GetPublicKeyOutput { return s } +type GetRealtimeLogConfigInput struct { + _ struct{} `locationName:"GetRealtimeLogConfigRequest" type:"structure" xmlURI:"http://cloudfront.amazonaws.com/doc/2020-05-31/"` + + // The Amazon Resource Name (ARN) of the real-time log configuration to get. + ARN *string `type:"string"` + + // The name of the real-time log configuration to get. + Name *string `type:"string"` +} + +// String returns the string representation +func (s GetRealtimeLogConfigInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetRealtimeLogConfigInput) GoString() string { + return s.String() +} + +// SetARN sets the ARN field's value. +func (s *GetRealtimeLogConfigInput) SetARN(v string) *GetRealtimeLogConfigInput { + s.ARN = &v + return s +} + +// SetName sets the Name field's value. +func (s *GetRealtimeLogConfigInput) SetName(v string) *GetRealtimeLogConfigInput { + s.Name = &v + return s +} + +type GetRealtimeLogConfigOutput struct { + _ struct{} `type:"structure"` + + // A real-time log configuration. + RealtimeLogConfig *RealtimeLogConfig `type:"structure"` +} + +// String returns the string representation +func (s GetRealtimeLogConfigOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetRealtimeLogConfigOutput) GoString() string { + return s.String() +} + +// SetRealtimeLogConfig sets the RealtimeLogConfig field's value. +func (s *GetRealtimeLogConfigOutput) SetRealtimeLogConfig(v *RealtimeLogConfig) *GetRealtimeLogConfigOutput { + s.RealtimeLogConfig = v + return s +} + // To request to get a streaming distribution configuration. type GetStreamingDistributionConfigInput struct { _ struct{} `locationName:"GetStreamingDistributionConfigRequest" type:"structure"` @@ -14272,6 +15120,67 @@ func (s *KeyPairIds) SetQuantity(v int64) *KeyPairIds { return s } +// Contains information about the Amazon Kinesis data stream where you are sending +// real-time log data. +type KinesisStreamConfig struct { + _ struct{} `type:"structure"` + + // The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) + // role that CloudFront can use to send real-time log data to your Kinesis data + // stream. + // + // For more information the IAM role, see Real-time log configuration IAM role + // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-iam-role) + // in the Amazon CloudFront Developer Guide. + // + // RoleARN is a required field + RoleARN *string `type:"string" required:"true"` + + // The Amazon Resource Name (ARN) of the Kinesis data stream where you are sending + // real-time log data. + // + // StreamARN is a required field + StreamARN *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s KinesisStreamConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s KinesisStreamConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *KinesisStreamConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "KinesisStreamConfig"} + if s.RoleARN == nil { + invalidParams.Add(request.NewErrParamRequired("RoleARN")) + } + if s.StreamARN == nil { + invalidParams.Add(request.NewErrParamRequired("StreamARN")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetRoleARN sets the RoleARN field's value. +func (s *KinesisStreamConfig) SetRoleARN(v string) *KinesisStreamConfig { + s.RoleARN = &v + return s +} + +// SetStreamARN sets the StreamARN field's value. +func (s *KinesisStreamConfig) SetStreamARN(v string) *KinesisStreamConfig { + s.StreamARN = &v + return s +} + // A complex type that contains a Lambda function association. type LambdaFunctionAssociation struct { _ struct{} `type:"structure"` @@ -14730,6 +15639,84 @@ func (s *ListDistributionsByOriginRequestPolicyIdOutput) SetDistributionIdList(v return s } +type ListDistributionsByRealtimeLogConfigInput struct { + _ struct{} `locationName:"ListDistributionsByRealtimeLogConfigRequest" type:"structure" xmlURI:"http://cloudfront.amazonaws.com/doc/2020-05-31/"` + + // Use this field when paginating results to indicate where to begin in your + // list of distributions. The response includes distributions in the list that + // occur after the marker. To get the next page of the list, set this field’s + // value to the value of NextMarker from the current page’s response. + Marker *string `type:"string"` + + // The maximum number of distributions that you want in the response. + MaxItems *int64 `type:"integer"` + + // The Amazon Resource Name (ARN) of the real-time log configuration whose associated + // distributions you want to list. + RealtimeLogConfigArn *string `type:"string"` + + // The name of the real-time log configuration whose associated distributions + // you want to list. + RealtimeLogConfigName *string `type:"string"` +} + +// String returns the string representation +func (s ListDistributionsByRealtimeLogConfigInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListDistributionsByRealtimeLogConfigInput) GoString() string { + return s.String() +} + +// SetMarker sets the Marker field's value. +func (s *ListDistributionsByRealtimeLogConfigInput) SetMarker(v string) *ListDistributionsByRealtimeLogConfigInput { + s.Marker = &v + return s +} + +// SetMaxItems sets the MaxItems field's value. +func (s *ListDistributionsByRealtimeLogConfigInput) SetMaxItems(v int64) *ListDistributionsByRealtimeLogConfigInput { + s.MaxItems = &v + return s +} + +// SetRealtimeLogConfigArn sets the RealtimeLogConfigArn field's value. +func (s *ListDistributionsByRealtimeLogConfigInput) SetRealtimeLogConfigArn(v string) *ListDistributionsByRealtimeLogConfigInput { + s.RealtimeLogConfigArn = &v + return s +} + +// SetRealtimeLogConfigName sets the RealtimeLogConfigName field's value. +func (s *ListDistributionsByRealtimeLogConfigInput) SetRealtimeLogConfigName(v string) *ListDistributionsByRealtimeLogConfigInput { + s.RealtimeLogConfigName = &v + return s +} + +type ListDistributionsByRealtimeLogConfigOutput struct { + _ struct{} `type:"structure" payload:"DistributionList"` + + // A distribution list. + DistributionList *DistributionList `type:"structure"` +} + +// String returns the string representation +func (s ListDistributionsByRealtimeLogConfigOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListDistributionsByRealtimeLogConfigOutput) GoString() string { + return s.String() +} + +// SetDistributionList sets the DistributionList field's value. +func (s *ListDistributionsByRealtimeLogConfigOutput) SetDistributionList(v *DistributionList) *ListDistributionsByRealtimeLogConfigOutput { + s.DistributionList = v + return s +} + // The request to list distributions that are associated with a specified AWS // WAF web ACL. type ListDistributionsByWebACLIdInput struct { @@ -15230,6 +16217,65 @@ func (s *ListPublicKeysOutput) SetPublicKeyList(v *PublicKeyList) *ListPublicKey return s } +type ListRealtimeLogConfigsInput struct { + _ struct{} `locationName:"ListRealtimeLogConfigsRequest" type:"structure"` + + // Use this field when paginating results to indicate where to begin in your + // list of real-time log configurations. The response includes real-time log + // configurations in the list that occur after the marker. To get the next page + // of the list, set this field’s value to the value of NextMarker from the + // current page’s response. + Marker *string `location:"querystring" locationName:"Marker" type:"string"` + + // The maximum number of real-time log configurations that you want in the response. + MaxItems *int64 `location:"querystring" locationName:"MaxItems" type:"integer"` +} + +// String returns the string representation +func (s ListRealtimeLogConfigsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListRealtimeLogConfigsInput) GoString() string { + return s.String() +} + +// SetMarker sets the Marker field's value. +func (s *ListRealtimeLogConfigsInput) SetMarker(v string) *ListRealtimeLogConfigsInput { + s.Marker = &v + return s +} + +// SetMaxItems sets the MaxItems field's value. +func (s *ListRealtimeLogConfigsInput) SetMaxItems(v int64) *ListRealtimeLogConfigsInput { + s.MaxItems = &v + return s +} + +type ListRealtimeLogConfigsOutput struct { + _ struct{} `type:"structure" payload:"RealtimeLogConfigs"` + + // A list of real-time log configurations. + RealtimeLogConfigs *RealtimeLogConfigs `type:"structure"` +} + +// String returns the string representation +func (s ListRealtimeLogConfigsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListRealtimeLogConfigsOutput) GoString() string { + return s.String() +} + +// SetRealtimeLogConfigs sets the RealtimeLogConfigs field's value. +func (s *ListRealtimeLogConfigsOutput) SetRealtimeLogConfigs(v *RealtimeLogConfigs) *ListRealtimeLogConfigsOutput { + s.RealtimeLogConfigs = v + return s +} + // The request to list your streaming distributions. type ListStreamingDistributionsInput struct { _ struct{} `locationName:"ListStreamingDistributionsRequest" type:"structure"` @@ -17608,6 +18654,157 @@ func (s *QueryStringNames) SetQuantity(v int64) *QueryStringNames { return s } +// A real-time log configuration. +type RealtimeLogConfig struct { + _ struct{} `type:"structure"` + + // The Amazon Resource Name (ARN) of this real-time log configuration. + // + // ARN is a required field + ARN *string `type:"string" required:"true"` + + // Contains information about the Amazon Kinesis data stream where you are sending + // real-time log data for this real-time log configuration. + // + // EndPoints is a required field + EndPoints []*EndPoint `type:"list" required:"true"` + + // A list of fields that are included in each real-time log record. In an API + // response, the fields are provided in the same order in which they are sent + // to the Amazon Kinesis data stream. + // + // For more information about fields, see Real-time log configuration fields + // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-fields) + // in the Amazon CloudFront Developer Guide. + // + // Fields is a required field + Fields []*string `locationNameList:"Field" type:"list" required:"true"` + + // The unique name of this real-time log configuration. + // + // Name is a required field + Name *string `type:"string" required:"true"` + + // The sampling rate for this real-time log configuration. The sampling rate + // determines the percentage of viewer requests that are represented in the + // real-time log data. The sampling rate is an integer between 1 and 100, inclusive. + // + // SamplingRate is a required field + SamplingRate *int64 `type:"long" required:"true"` +} + +// String returns the string representation +func (s RealtimeLogConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s RealtimeLogConfig) GoString() string { + return s.String() +} + +// SetARN sets the ARN field's value. +func (s *RealtimeLogConfig) SetARN(v string) *RealtimeLogConfig { + s.ARN = &v + return s +} + +// SetEndPoints sets the EndPoints field's value. +func (s *RealtimeLogConfig) SetEndPoints(v []*EndPoint) *RealtimeLogConfig { + s.EndPoints = v + return s +} + +// SetFields sets the Fields field's value. +func (s *RealtimeLogConfig) SetFields(v []*string) *RealtimeLogConfig { + s.Fields = v + return s +} + +// SetName sets the Name field's value. +func (s *RealtimeLogConfig) SetName(v string) *RealtimeLogConfig { + s.Name = &v + return s +} + +// SetSamplingRate sets the SamplingRate field's value. +func (s *RealtimeLogConfig) SetSamplingRate(v int64) *RealtimeLogConfig { + s.SamplingRate = &v + return s +} + +// A list of real-time log configurations. +type RealtimeLogConfigs struct { + _ struct{} `type:"structure"` + + // A flag that indicates whether there are more real-time log configurations + // than are contained in this list. + // + // IsTruncated is a required field + IsTruncated *bool `type:"boolean" required:"true"` + + // Contains the list of real-time log configurations. + Items []*RealtimeLogConfig `type:"list"` + + // This parameter indicates where this list of real-time log configurations + // begins. This list includes real-time log configurations that occur after + // the marker. + // + // Marker is a required field + Marker *string `type:"string" required:"true"` + + // The maximum number of real-time log configurations requested. + // + // MaxItems is a required field + MaxItems *int64 `type:"integer" required:"true"` + + // If there are more items in the list than are in this response, this element + // is present. It contains the value that you should use in the Marker field + // of a subsequent request to continue listing real-time log configurations + // where you left off. + NextMarker *string `type:"string"` +} + +// String returns the string representation +func (s RealtimeLogConfigs) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s RealtimeLogConfigs) GoString() string { + return s.String() +} + +// SetIsTruncated sets the IsTruncated field's value. +func (s *RealtimeLogConfigs) SetIsTruncated(v bool) *RealtimeLogConfigs { + s.IsTruncated = &v + return s +} + +// SetItems sets the Items field's value. +func (s *RealtimeLogConfigs) SetItems(v []*RealtimeLogConfig) *RealtimeLogConfigs { + s.Items = v + return s +} + +// SetMarker sets the Marker field's value. +func (s *RealtimeLogConfigs) SetMarker(v string) *RealtimeLogConfigs { + s.Marker = &v + return s +} + +// SetMaxItems sets the MaxItems field's value. +func (s *RealtimeLogConfigs) SetMaxItems(v int64) *RealtimeLogConfigs { + s.MaxItems = &v + return s +} + +// SetNextMarker sets the NextMarker field's value. +func (s *RealtimeLogConfigs) SetNextMarker(v string) *RealtimeLogConfigs { + s.NextMarker = &v + return s +} + // A subscription configuration for additional CloudWatch metrics. type RealtimeMetricsSubscriptionConfig struct { _ struct{} `type:"structure"` @@ -19639,6 +20836,115 @@ func (s *UpdatePublicKeyOutput) SetPublicKey(v *PublicKey) *UpdatePublicKeyOutpu return s } +type UpdateRealtimeLogConfigInput struct { + _ struct{} `locationName:"UpdateRealtimeLogConfigRequest" type:"structure" xmlURI:"http://cloudfront.amazonaws.com/doc/2020-05-31/"` + + // The Amazon Resource Name (ARN) for this real-time log configuration. + ARN *string `type:"string"` + + // Contains information about the Amazon Kinesis data stream where you are sending + // real-time log data. + EndPoints []*EndPoint `type:"list"` + + // A list of fields to include in each real-time log record. + // + // For more information about fields, see Real-time log configuration fields + // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-fields) + // in the Amazon CloudFront Developer Guide. + Fields []*string `locationNameList:"Field" type:"list"` + + // The name for this real-time log configuration. + Name *string `type:"string"` + + // The sampling rate for this real-time log configuration. The sampling rate + // determines the percentage of viewer requests that are represented in the + // real-time log data. You must provide an integer between 1 and 100, inclusive. + SamplingRate *int64 `type:"long"` +} + +// String returns the string representation +func (s UpdateRealtimeLogConfigInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UpdateRealtimeLogConfigInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UpdateRealtimeLogConfigInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UpdateRealtimeLogConfigInput"} + if s.EndPoints != nil { + for i, v := range s.EndPoints { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "EndPoints", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetARN sets the ARN field's value. +func (s *UpdateRealtimeLogConfigInput) SetARN(v string) *UpdateRealtimeLogConfigInput { + s.ARN = &v + return s +} + +// SetEndPoints sets the EndPoints field's value. +func (s *UpdateRealtimeLogConfigInput) SetEndPoints(v []*EndPoint) *UpdateRealtimeLogConfigInput { + s.EndPoints = v + return s +} + +// SetFields sets the Fields field's value. +func (s *UpdateRealtimeLogConfigInput) SetFields(v []*string) *UpdateRealtimeLogConfigInput { + s.Fields = v + return s +} + +// SetName sets the Name field's value. +func (s *UpdateRealtimeLogConfigInput) SetName(v string) *UpdateRealtimeLogConfigInput { + s.Name = &v + return s +} + +// SetSamplingRate sets the SamplingRate field's value. +func (s *UpdateRealtimeLogConfigInput) SetSamplingRate(v int64) *UpdateRealtimeLogConfigInput { + s.SamplingRate = &v + return s +} + +type UpdateRealtimeLogConfigOutput struct { + _ struct{} `type:"structure"` + + // A real-time log configuration. + RealtimeLogConfig *RealtimeLogConfig `type:"structure"` +} + +// String returns the string representation +func (s UpdateRealtimeLogConfigOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UpdateRealtimeLogConfigOutput) GoString() string { + return s.String() +} + +// SetRealtimeLogConfig sets the RealtimeLogConfig field's value. +func (s *UpdateRealtimeLogConfigOutput) SetRealtimeLogConfig(v *RealtimeLogConfig) *UpdateRealtimeLogConfigOutput { + s.RealtimeLogConfig = v + return s +} + // The request to update a streaming distribution. type UpdateStreamingDistributionInput struct { _ struct{} `locationName:"UpdateStreamingDistributionRequest" type:"structure" payload:"StreamingDistributionConfig"` @@ -19875,6 +21181,11 @@ type ViewerCertificate struct { // including those that don’t support SNI. This is not recommended, and // results in additional monthly charges from CloudFront. // + // * static-ip - Do not specify this value unless your distribution has been + // enabled for this feature by the CloudFront team. If you have a use case + // that requires static IP addresses for a distribution, contact CloudFront + // through the AWS Support Center (https://console.aws.amazon.com/support/home). + // // If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, // don’t set a value for this field. SSLSupportMethod *string `type:"string" enum:"SSLSupportMethod"` @@ -20354,6 +21665,9 @@ const ( // SSLSupportMethodVip is a SSLSupportMethod enum value SSLSupportMethodVip = "vip" + + // SSLSupportMethodStaticIp is a SSLSupportMethod enum value + SSLSupportMethodStaticIp = "static-ip" ) // SSLSupportMethod_Values returns all elements of the SSLSupportMethod enum @@ -20361,6 +21675,7 @@ func SSLSupportMethod_Values() []string { return []string{ SSLSupportMethodSniOnly, SSLSupportMethodVip, + SSLSupportMethodStaticIp, } } diff --git a/service/cloudfront/cloudfrontiface/interface.go b/service/cloudfront/cloudfrontiface/interface.go index aa86c0e63fe..a14c656c5f8 100644 --- a/service/cloudfront/cloudfrontiface/interface.go +++ b/service/cloudfront/cloudfrontiface/interface.go @@ -100,6 +100,10 @@ type CloudFrontAPI interface { CreatePublicKeyWithContext(aws.Context, *cloudfront.CreatePublicKeyInput, ...request.Option) (*cloudfront.CreatePublicKeyOutput, error) CreatePublicKeyRequest(*cloudfront.CreatePublicKeyInput) (*request.Request, *cloudfront.CreatePublicKeyOutput) + CreateRealtimeLogConfig(*cloudfront.CreateRealtimeLogConfigInput) (*cloudfront.CreateRealtimeLogConfigOutput, error) + CreateRealtimeLogConfigWithContext(aws.Context, *cloudfront.CreateRealtimeLogConfigInput, ...request.Option) (*cloudfront.CreateRealtimeLogConfigOutput, error) + CreateRealtimeLogConfigRequest(*cloudfront.CreateRealtimeLogConfigInput) (*request.Request, *cloudfront.CreateRealtimeLogConfigOutput) + CreateStreamingDistribution(*cloudfront.CreateStreamingDistributionInput) (*cloudfront.CreateStreamingDistributionOutput, error) CreateStreamingDistributionWithContext(aws.Context, *cloudfront.CreateStreamingDistributionInput, ...request.Option) (*cloudfront.CreateStreamingDistributionOutput, error) CreateStreamingDistributionRequest(*cloudfront.CreateStreamingDistributionInput) (*request.Request, *cloudfront.CreateStreamingDistributionOutput) @@ -140,6 +144,10 @@ type CloudFrontAPI interface { DeletePublicKeyWithContext(aws.Context, *cloudfront.DeletePublicKeyInput, ...request.Option) (*cloudfront.DeletePublicKeyOutput, error) DeletePublicKeyRequest(*cloudfront.DeletePublicKeyInput) (*request.Request, *cloudfront.DeletePublicKeyOutput) + DeleteRealtimeLogConfig(*cloudfront.DeleteRealtimeLogConfigInput) (*cloudfront.DeleteRealtimeLogConfigOutput, error) + DeleteRealtimeLogConfigWithContext(aws.Context, *cloudfront.DeleteRealtimeLogConfigInput, ...request.Option) (*cloudfront.DeleteRealtimeLogConfigOutput, error) + DeleteRealtimeLogConfigRequest(*cloudfront.DeleteRealtimeLogConfigInput) (*request.Request, *cloudfront.DeleteRealtimeLogConfigOutput) + DeleteStreamingDistribution(*cloudfront.DeleteStreamingDistributionInput) (*cloudfront.DeleteStreamingDistributionOutput, error) DeleteStreamingDistributionWithContext(aws.Context, *cloudfront.DeleteStreamingDistributionInput, ...request.Option) (*cloudfront.DeleteStreamingDistributionOutput, error) DeleteStreamingDistributionRequest(*cloudfront.DeleteStreamingDistributionInput) (*request.Request, *cloudfront.DeleteStreamingDistributionOutput) @@ -208,6 +216,10 @@ type CloudFrontAPI interface { GetPublicKeyConfigWithContext(aws.Context, *cloudfront.GetPublicKeyConfigInput, ...request.Option) (*cloudfront.GetPublicKeyConfigOutput, error) GetPublicKeyConfigRequest(*cloudfront.GetPublicKeyConfigInput) (*request.Request, *cloudfront.GetPublicKeyConfigOutput) + GetRealtimeLogConfig(*cloudfront.GetRealtimeLogConfigInput) (*cloudfront.GetRealtimeLogConfigOutput, error) + GetRealtimeLogConfigWithContext(aws.Context, *cloudfront.GetRealtimeLogConfigInput, ...request.Option) (*cloudfront.GetRealtimeLogConfigOutput, error) + GetRealtimeLogConfigRequest(*cloudfront.GetRealtimeLogConfigInput) (*request.Request, *cloudfront.GetRealtimeLogConfigOutput) + GetStreamingDistribution(*cloudfront.GetStreamingDistributionInput) (*cloudfront.GetStreamingDistributionOutput, error) GetStreamingDistributionWithContext(aws.Context, *cloudfront.GetStreamingDistributionInput, ...request.Option) (*cloudfront.GetStreamingDistributionOutput, error) GetStreamingDistributionRequest(*cloudfront.GetStreamingDistributionInput) (*request.Request, *cloudfront.GetStreamingDistributionOutput) @@ -242,6 +254,10 @@ type CloudFrontAPI interface { ListDistributionsByOriginRequestPolicyIdWithContext(aws.Context, *cloudfront.ListDistributionsByOriginRequestPolicyIdInput, ...request.Option) (*cloudfront.ListDistributionsByOriginRequestPolicyIdOutput, error) ListDistributionsByOriginRequestPolicyIdRequest(*cloudfront.ListDistributionsByOriginRequestPolicyIdInput) (*request.Request, *cloudfront.ListDistributionsByOriginRequestPolicyIdOutput) + ListDistributionsByRealtimeLogConfig(*cloudfront.ListDistributionsByRealtimeLogConfigInput) (*cloudfront.ListDistributionsByRealtimeLogConfigOutput, error) + ListDistributionsByRealtimeLogConfigWithContext(aws.Context, *cloudfront.ListDistributionsByRealtimeLogConfigInput, ...request.Option) (*cloudfront.ListDistributionsByRealtimeLogConfigOutput, error) + ListDistributionsByRealtimeLogConfigRequest(*cloudfront.ListDistributionsByRealtimeLogConfigInput) (*request.Request, *cloudfront.ListDistributionsByRealtimeLogConfigOutput) + ListDistributionsByWebACLId(*cloudfront.ListDistributionsByWebACLIdInput) (*cloudfront.ListDistributionsByWebACLIdOutput, error) ListDistributionsByWebACLIdWithContext(aws.Context, *cloudfront.ListDistributionsByWebACLIdInput, ...request.Option) (*cloudfront.ListDistributionsByWebACLIdOutput, error) ListDistributionsByWebACLIdRequest(*cloudfront.ListDistributionsByWebACLIdInput) (*request.Request, *cloudfront.ListDistributionsByWebACLIdOutput) @@ -269,6 +285,10 @@ type CloudFrontAPI interface { ListPublicKeysWithContext(aws.Context, *cloudfront.ListPublicKeysInput, ...request.Option) (*cloudfront.ListPublicKeysOutput, error) ListPublicKeysRequest(*cloudfront.ListPublicKeysInput) (*request.Request, *cloudfront.ListPublicKeysOutput) + ListRealtimeLogConfigs(*cloudfront.ListRealtimeLogConfigsInput) (*cloudfront.ListRealtimeLogConfigsOutput, error) + ListRealtimeLogConfigsWithContext(aws.Context, *cloudfront.ListRealtimeLogConfigsInput, ...request.Option) (*cloudfront.ListRealtimeLogConfigsOutput, error) + ListRealtimeLogConfigsRequest(*cloudfront.ListRealtimeLogConfigsInput) (*request.Request, *cloudfront.ListRealtimeLogConfigsOutput) + ListStreamingDistributions(*cloudfront.ListStreamingDistributionsInput) (*cloudfront.ListStreamingDistributionsOutput, error) ListStreamingDistributionsWithContext(aws.Context, *cloudfront.ListStreamingDistributionsInput, ...request.Option) (*cloudfront.ListStreamingDistributionsOutput, error) ListStreamingDistributionsRequest(*cloudfront.ListStreamingDistributionsInput) (*request.Request, *cloudfront.ListStreamingDistributionsOutput) @@ -316,6 +336,10 @@ type CloudFrontAPI interface { UpdatePublicKeyWithContext(aws.Context, *cloudfront.UpdatePublicKeyInput, ...request.Option) (*cloudfront.UpdatePublicKeyOutput, error) UpdatePublicKeyRequest(*cloudfront.UpdatePublicKeyInput) (*request.Request, *cloudfront.UpdatePublicKeyOutput) + UpdateRealtimeLogConfig(*cloudfront.UpdateRealtimeLogConfigInput) (*cloudfront.UpdateRealtimeLogConfigOutput, error) + UpdateRealtimeLogConfigWithContext(aws.Context, *cloudfront.UpdateRealtimeLogConfigInput, ...request.Option) (*cloudfront.UpdateRealtimeLogConfigOutput, error) + UpdateRealtimeLogConfigRequest(*cloudfront.UpdateRealtimeLogConfigInput) (*request.Request, *cloudfront.UpdateRealtimeLogConfigOutput) + UpdateStreamingDistribution(*cloudfront.UpdateStreamingDistributionInput) (*cloudfront.UpdateStreamingDistributionOutput, error) UpdateStreamingDistributionWithContext(aws.Context, *cloudfront.UpdateStreamingDistributionInput, ...request.Option) (*cloudfront.UpdateStreamingDistributionOutput, error) UpdateStreamingDistributionRequest(*cloudfront.UpdateStreamingDistributionInput) (*request.Request, *cloudfront.UpdateStreamingDistributionOutput) diff --git a/service/cloudfront/errors.go b/service/cloudfront/errors.go index 533ff29608d..ced65fe86c9 100644 --- a/service/cloudfront/errors.go +++ b/service/cloudfront/errors.go @@ -321,6 +321,12 @@ const ( // The specified public key doesn't exist. ErrCodeNoSuchPublicKey = "NoSuchPublicKey" + // ErrCodeNoSuchRealtimeLogConfig for service response error code + // "NoSuchRealtimeLogConfig". + // + // The real-time log configuration does not exist. + ErrCodeNoSuchRealtimeLogConfig = "NoSuchRealtimeLogConfig" + // ErrCodeNoSuchResource for service response error code // "NoSuchResource". // @@ -387,6 +393,20 @@ const ( // No profile specified for the field-level encryption query argument. ErrCodeQueryArgProfileEmpty = "QueryArgProfileEmpty" + // ErrCodeRealtimeLogConfigAlreadyExists for service response error code + // "RealtimeLogConfigAlreadyExists". + // + // A real-time log configuration with this name already exists. You must provide + // a unique name. To modify an existing real-time log configuration, use UpdateRealtimeLogConfig. + ErrCodeRealtimeLogConfigAlreadyExists = "RealtimeLogConfigAlreadyExists" + + // ErrCodeRealtimeLogConfigInUse for service response error code + // "RealtimeLogConfigInUse". + // + // Cannot delete the real-time log configuration because it is attached to one + // or more cache behaviors. + ErrCodeRealtimeLogConfigInUse = "RealtimeLogConfigInUse" + // ErrCodeStreamingDistributionAlreadyExists for service response error code // "StreamingDistributionAlreadyExists". // @@ -634,6 +654,14 @@ const ( // (formerly known as limits) in the Amazon CloudFront Developer Guide. ErrCodeTooManyQueryStringsInOriginRequestPolicy = "TooManyQueryStringsInOriginRequestPolicy" + // ErrCodeTooManyRealtimeLogConfigs for service response error code + // "TooManyRealtimeLogConfigs". + // + // You have reached the maximum number of real-time log configurations for this + // AWS account. For more information, see Quotas (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html) + // (formerly known as limits) in the Amazon CloudFront Developer Guide. + ErrCodeTooManyRealtimeLogConfigs = "TooManyRealtimeLogConfigs" + // ErrCodeTooManyStreamingDistributionCNAMEs for service response error code // "TooManyStreamingDistributionCNAMEs". // diff --git a/service/ec2/api.go b/service/ec2/api.go index 80bed4cb280..dfbaad61741 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -89526,6 +89526,9 @@ type ModifyFleetInput struct { // FleetId is a required field FleetId *string `type:"string" required:"true"` + // The launch template and overrides. + LaunchTemplateConfigs []*FleetLaunchTemplateConfigRequest `locationName:"LaunchTemplateConfig" locationNameList:"item" type:"list"` + // The size of the EC2 Fleet. // // TargetCapacitySpecification is a required field @@ -89551,6 +89554,16 @@ func (s *ModifyFleetInput) Validate() error { if s.TargetCapacitySpecification == nil { invalidParams.Add(request.NewErrParamRequired("TargetCapacitySpecification")) } + if s.LaunchTemplateConfigs != nil { + for i, v := range s.LaunchTemplateConfigs { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "LaunchTemplateConfigs", i), err.(request.ErrInvalidParams)) + } + } + } if s.TargetCapacitySpecification != nil { if err := s.TargetCapacitySpecification.Validate(); err != nil { invalidParams.AddNested("TargetCapacitySpecification", err.(request.ErrInvalidParams)) @@ -89581,6 +89594,12 @@ func (s *ModifyFleetInput) SetFleetId(v string) *ModifyFleetInput { return s } +// SetLaunchTemplateConfigs sets the LaunchTemplateConfigs field's value. +func (s *ModifyFleetInput) SetLaunchTemplateConfigs(v []*FleetLaunchTemplateConfigRequest) *ModifyFleetInput { + s.LaunchTemplateConfigs = v + return s +} + // SetTargetCapacitySpecification sets the TargetCapacitySpecification field's value. func (s *ModifyFleetInput) SetTargetCapacitySpecification(v *TargetCapacitySpecificationRequest) *ModifyFleetInput { s.TargetCapacitySpecification = v @@ -91496,6 +91515,12 @@ type ModifySpotFleetRequestInput struct { // the Spot Fleet. ExcessCapacityTerminationPolicy *string `locationName:"excessCapacityTerminationPolicy" type:"string" enum:"ExcessCapacityTerminationPolicy"` + // The launch template and overrides. You can only use this parameter if you + // specified a launch template (LaunchTemplateConfigs) in your Spot Fleet request. + // If you specified LaunchSpecifications in your Spot Fleet request, then omit + // this parameter. + LaunchTemplateConfigs []*LaunchTemplateConfig `locationName:"LaunchTemplateConfig" locationNameList:"item" type:"list"` + // The number of On-Demand Instances in the fleet. OnDemandTargetCapacity *int64 `type:"integer"` @@ -91524,6 +91549,16 @@ func (s *ModifySpotFleetRequestInput) Validate() error { if s.SpotFleetRequestId == nil { invalidParams.Add(request.NewErrParamRequired("SpotFleetRequestId")) } + if s.LaunchTemplateConfigs != nil { + for i, v := range s.LaunchTemplateConfigs { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "LaunchTemplateConfigs", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -91537,6 +91572,12 @@ func (s *ModifySpotFleetRequestInput) SetExcessCapacityTerminationPolicy(v strin return s } +// SetLaunchTemplateConfigs sets the LaunchTemplateConfigs field's value. +func (s *ModifySpotFleetRequestInput) SetLaunchTemplateConfigs(v []*LaunchTemplateConfig) *ModifySpotFleetRequestInput { + s.LaunchTemplateConfigs = v + return s +} + // SetOnDemandTargetCapacity sets the OnDemandTargetCapacity field's value. func (s *ModifySpotFleetRequestInput) SetOnDemandTargetCapacity(v int64) *ModifySpotFleetRequestInput { s.OnDemandTargetCapacity = &v @@ -118889,6 +118930,9 @@ const ( // ResourceTypeDhcpOptions is a ResourceType enum value ResourceTypeDhcpOptions = "dhcp-options" + // ResourceTypeEgressOnlyInternetGateway is a ResourceType enum value + ResourceTypeEgressOnlyInternetGateway = "egress-only-internet-gateway" + // ResourceTypeElasticIp is a ResourceType enum value ResourceTypeElasticIp = "elastic-ip" @@ -119014,6 +119058,7 @@ func ResourceType_Values() []string { ResourceTypeCustomerGateway, ResourceTypeDedicatedHost, ResourceTypeDhcpOptions, + ResourceTypeEgressOnlyInternetGateway, ResourceTypeElasticIp, ResourceTypeElasticGpu, ResourceTypeExportImageTask, diff --git a/service/sqs/api.go b/service/sqs/api.go index 06e05ee2a13..45285d0a17b 100644 --- a/service/sqs/api.go +++ b/service/sqs/api.go @@ -1006,6 +1006,14 @@ func (c *SQS) ListDeadLetterSourceQueuesRequest(input *ListDeadLetterSourceQueue // Returns a list of your queues that have the RedrivePolicy queue attribute // configured with a dead-letter queue. // +// The ListDeadLetterSourceQueues methods supports pagination. Set parameter +// MaxResults in the request to specify the maximum number of results to be +// returned in the response. If you do not set MaxResults, the response includes +// a maximum of 1,000 results. If you set MaxResults and there are additional +// results to display, the response includes a value for NextToken. Use NextToken +// as a parameter in your next request to ListDeadLetterSourceQueues to receive +// the next page of results. +// // For more information about using dead-letter queues, see Using Amazon SQS // Dead-Letter Queues (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) // in the Amazon Simple Queue Service Developer Guide. @@ -1225,9 +1233,17 @@ func (c *SQS) ListQueuesRequest(input *ListQueuesInput) (req *request.Request, o // ListQueues API operation for Amazon Simple Queue Service. // -// Returns a list of your queues. The maximum number of queues that can be returned -// is 1,000. If you specify a value for the optional QueueNamePrefix parameter, -// only queues with a name that begins with the specified value are returned. +// Returns a list of your queues in the current region. The response includes +// a maximum of 1,000 results. If you specify a value for the optional QueueNamePrefix +// parameter, only queues with a name that begins with the specified value are +// returned. +// +// The listQueues methods supports pagination. Set parameter MaxResults in the +// request to specify the maximum number of results to be returned in the response. +// If you do not set MaxResults, the response includes a maximum of 1,000 results. +// If you set MaxResults and there are additional results to display, the response +// includes a value for NextToken. Use NextToken as a parameter in your next +// request to listQueues to receive the next page of results. // // Cross-account permissions don't apply to this action. For more information, // see Grant Cross-Account Permissions to a Role and a User Name (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name) @@ -2503,7 +2519,7 @@ type ChangeMessageVisibilityInput struct { // ReceiptHandle is a required field ReceiptHandle *string `type:"string" required:"true"` - // The new value for the message's visibility timeout (in seconds). Values values: + // The new value for the message's visibility timeout (in seconds). Values range: // 0 to 43200. Maximum: 12 hours. // // VisibilityTimeout is a required field @@ -3323,7 +3339,8 @@ func (s *GetQueueUrlOutput) SetQueueUrl(v string) *GetQueueUrlOutput { type ListDeadLetterSourceQueuesInput struct { _ struct{} `type:"structure"` - // Maximum number of results to include in the response. + // Maximum number of results to include in the response. Value range is 1 to + // 1000. You must set MaxResults to receive a value for NextToken in the response. MaxResults *int64 `type:"integer"` // Pagination token to request the next set of results. @@ -3382,7 +3399,9 @@ func (s *ListDeadLetterSourceQueuesInput) SetQueueUrl(v string) *ListDeadLetterS type ListDeadLetterSourceQueuesOutput struct { _ struct{} `type:"structure"` - // Pagination token to include in the next request. + // Pagination token to include in the next request. Token value is null if there + // are no additional results to request, or if you did not set MaxResults in + // the request. NextToken *string `type:"string"` // A list of source queue URLs that have the RedrivePolicy queue attribute configured @@ -3478,7 +3497,8 @@ func (s *ListQueueTagsOutput) SetTags(v map[string]*string) *ListQueueTagsOutput type ListQueuesInput struct { _ struct{} `type:"structure"` - // Maximum number of results to include in the response. + // Maximum number of results to include in the response. Value range is 1 to + // 1000. You must set MaxResults to receive a value for NextToken in the response. MaxResults *int64 `type:"integer"` // Pagination token to request the next set of results. @@ -3523,7 +3543,9 @@ func (s *ListQueuesInput) SetQueueNamePrefix(v string) *ListQueuesInput { type ListQueuesOutput struct { _ struct{} `type:"structure"` - // Pagination token to include in the next request. + // Pagination token to include in the next request. Token value is null if there + // are no additional results to request, or if you did not set MaxResults in + // the request. NextToken *string `type:"string"` // A list of queue URLs, up to 1,000 entries, or the value of MaxResults that @@ -3592,7 +3614,7 @@ type Message struct { MD5OfMessageAttributes *string `type:"string"` // Each message attribute consists of a Name, Type, and Value. For more information, - // see Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) + // see Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes) // in the Amazon Simple Queue Service Developer Guide. MessageAttributes map[string]*MessageAttributeValue `locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"` @@ -3681,7 +3703,7 @@ type MessageAttributeValue struct { // Binary. For the Number data type, you must use StringValue. // // You can also append custom labels. For more information, see Amazon SQS Message - // Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) + // Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes) // in the Amazon Simple Queue Service Developer Guide. // // DataType is a required field @@ -3769,7 +3791,7 @@ type MessageSystemAttributeValue struct { // Binary. For the Number data type, you must use StringValue. // // You can also append custom labels. For more information, see Amazon SQS Message - // Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) + // Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes) // in the Amazon Simple Queue Service Developer Guide. // // DataType is a required field @@ -4313,7 +4335,7 @@ type SendMessageBatchRequestEntry struct { Id *string `type:"string" required:"true"` // Each message attribute consists of a Name, Type, and Value. For more information, - // see Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) + // see Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes) // in the Amazon Simple Queue Service Developer Guide. MessageAttributes map[string]*MessageAttributeValue `locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"` @@ -4596,11 +4618,12 @@ type SendMessageInput struct { DelaySeconds *int64 `type:"integer"` // Each message attribute consists of a Name, Type, and Value. For more information, - // see Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) + // see Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes) // in the Amazon Simple Queue Service Developer Guide. MessageAttributes map[string]*MessageAttributeValue `locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"` - // The message to send. The maximum string size is 256 KB. + // The message to send. The minimum size is one character. The maximum size + // is 256 KB. // // A message can include only XML, JSON, and unformatted text. The following // Unicode characters are allowed: diff --git a/service/sqs/doc.go b/service/sqs/doc.go index 3a3f55f0980..523b40ee38a 100644 --- a/service/sqs/doc.go +++ b/service/sqs/doc.go @@ -10,6 +10,10 @@ // Amazon SQS moves data between distributed application components and helps // you decouple these components. // +// For information on the permissions you need to use this API, see Identity +// and access management (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) +// in the Amazon Simple Queue Service Developer Guide. +// // You can use AWS SDKs (http://aws.amazon.com/tools/#sdk) to access Amazon // SQS using your favorite programming language. The SDKs perform tasks such // as the following automatically: @@ -25,7 +29,7 @@ // * Amazon SQS Product Page (http://aws.amazon.com/sqs/) // // * Amazon Simple Queue Service Developer Guide Making API Requests (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-making-api-requests.html) -// Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) +// Amazon SQS Message Attributes (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes) // Amazon SQS Dead-Letter Queues (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) // // * Amazon SQS in the AWS CLI Command Reference (http://docs.aws.amazon.com/cli/latest/reference/sqs/index.html)