From 5eded7001123769dc5dd6d6d89b101fc778182d5 Mon Sep 17 00:00:00 2001
From: awstools Gets the list of CloudFront origin access controls in this Amazon Web Services account. Gets the list of CloudFront origin access controls (OACs) in this Amazon Web Services 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 another
* request that specifies the If you're not using origin access controls for your Amazon Web Services account, the
+ * NextMarker
value from the current response as
* the Marker
value in the next request.ListOriginAccessControls
operation doesn't return the
+ * Items
element in the response.
You must rename the ETag
field to IfMatch
,
- * leaving the value unchanged. (Set the value of IfMatch
to
- * the value of ETag
, then remove the ETag
- * field.)
You must copy the ETag
field value from the response. (You'll use it for the IfMatch
parameter in your request.) Then, remove the ETag
+ * field from the distribution configuration.
You can't change the value of CallerReference
.
Submit an UpdateDistribution
request, providing the distribution
+ *
Submit an UpdateDistribution
request, providing the updated distribution
* configuration. The new configuration replaces the existing configuration. The
* values that you specify in an UpdateDistribution
request are not
* merged into your existing configuration. Make sure to include all fields: the
diff --git a/clients/client-cloudfront/src/models/models_1.ts b/clients/client-cloudfront/src/models/models_1.ts
index 9c7fffe34ef7a..ceb07b312b2c3 100644
--- a/clients/client-cloudfront/src/models/models_1.ts
+++ b/clients/client-cloudfront/src/models/models_1.ts
@@ -5243,7 +5243,7 @@ export interface UpdateDistributionWithStagingConfigRequest {
*
The current versions (ETag
values) of both primary and staging distributions.
* Provide these in the following format:
- *
+ * <primary ETag>, <staging ETag>
*
Creates a CloudFront function.
\nTo create a function, you provide the function code and some configuration information\n\t\t\tabout the function. The response contains an Amazon Resource Name (ARN) that uniquely\n\t\t\tidentifies the function.
\nWhen you create a function, it's in the DEVELOPMENT
stage. In this stage,\n\t\t\tyou can test the function with TestFunction
, and update it with\n\t\t\t\tUpdateFunction
.
When you're ready to use your function with a CloudFront distribution, use\n\t\t\t\tPublishFunction
to copy the function from the DEVELOPMENT
\n\t\t\tstage to LIVE
. When it's live, you can attach the function to a\n\t\t\tdistribution's cache behavior, using the function's ARN.
Specifies the key value store resource to add to your account. In your account, the key value store names must be unique. You can also import key value store data in JSON format from an S3 bucket by providing a valid ImportSource
that you own.
Specifies the key value store to delete.
", + "smithy.api#examples": [ + { + "title": "To delete a KeyValueStore", + "documentation": "Use the following command to delete a KeyValueStore.", + "input": { + "Name": "my-keyvaluestore-name", + "IfMatch": "ETVPDKIKX0DER" + } + } + ], "smithy.api#http": { "method": "DELETE", "uri": "/2020-05-31/key-value-store/{Name}", @@ -6196,6 +6252,26 @@ ], "traits": { "smithy.api#documentation": "Specifies the key value store and its configuration.
", + "smithy.api#examples": [ + { + "title": "To describe a KeyValueStore", + "documentation": "Use the following command to describe a KeyValueStore.", + "input": { + "Name": "my-keyvaluestore-name" + }, + "output": { + "KeyValueStore": { + "Name": "my-keyvaluestore-name", + "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889", + "Comment": "my-key-valuestore-comment", + "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889", + "Status": "READY", + "LastModifiedTime": "2023-11-07T18:20:33.056Z" + }, + "ETag": "ETVPDKIKX0DER" + } + } + ], "smithy.api#http": { "method": "GET", "uri": "/2020-05-31/key-value-store/{Name}", @@ -8169,7 +8245,8 @@ } } ], - "minDelay": 60 + "minDelay": 60, + "maxDelay": 2100 } } } @@ -8649,7 +8726,8 @@ } } ], - "minDelay": 20 + "minDelay": 20, + "maxDelay": 600 } } } @@ -9481,7 +9559,8 @@ } } ], - "minDelay": 60 + "minDelay": 60, + "maxDelay": 1500 } } } @@ -11833,6 +11912,32 @@ ], "traits": { "smithy.api#documentation": "Specifies the key value stores to list.
", + "smithy.api#examples": [ + { + "title": "To get a list of KeyValueStores", + "documentation": "The following command retrieves a list of KeyValueStores with READY status.", + "input": { + "Status": "READY" + }, + "output": { + "KeyValueStoreList": { + "NextMarker": "", + "MaxItems": 100, + "Quantity": 1, + "Items": [ + { + "Name": "my-keyvaluestore-name", + "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889", + "Comment": "", + "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889", + "Status": "READY", + "LastModifiedTime": "2023-11-07T18:45:21.069Z" + } + ] + } + } + } + ], "smithy.api#http": { "method": "GET", "uri": "/2020-05-31/key-value-store", @@ -11904,7 +12009,7 @@ } ], "traits": { - "smithy.api#documentation": "Gets the list of CloudFront origin access controls in this Amazon Web Services account.
\nYou can optionally specify the maximum number of items to receive in the response. If\n\t\t\tthe total number of items in the list exceeds the maximum that you specify, or the\n\t\t\tdefault maximum, the response is paginated. To get the next page of items, send another\n\t\t\trequest that specifies the NextMarker
value from the current response as\n\t\t\tthe Marker
value in the next request.
Gets the list of CloudFront origin access controls (OACs) in this Amazon Web Services account.
\nYou can optionally specify the maximum number of items to receive in the response. If\n\t\t\tthe total number of items in the list exceeds the maximum that you specify, or the\n\t\t\tdefault maximum, the response is paginated. To get the next page of items, send another\n\t\t\trequest that specifies the NextMarker
value from the current response as\n\t\t\tthe Marker
value in the next request.
If you're not using origin access controls for your Amazon Web Services account, the\n\t\t\t\t\tListOriginAccessControls
operation doesn't return the\n\t\t\t\t\tItems
element in the response.
Updates the configuration for a CloudFront distribution.
\nThe update process includes getting the current distribution configuration, updating\n\t\t\tit to make your changes, and then submitting an UpdateDistribution
request\n\t\t\tto make the updates.
\n To update a web distribution using the CloudFront\n\t\t\tAPI\n
\nUse GetDistributionConfig
to get the current configuration,\n\t\t\t\t\tincluding the version identifier (ETag
).
Update the distribution configuration that was returned in the response. Note\n\t\t\t\t\tthe following important requirements and restrictions:
\nYou must rename the ETag
field to IfMatch
,\n\t\t\t\t\t\t\tleaving the value unchanged. (Set the value of IfMatch
to\n\t\t\t\t\t\t\tthe value of ETag
, then remove the ETag
\n\t\t\t\t\t\t\tfield.)
You can't change the value of CallerReference
.
Submit an UpdateDistribution
request, providing the distribution\n\t\t\t\t\tconfiguration. The new configuration replaces the existing configuration. The\n\t\t\t\t\tvalues that you specify in an UpdateDistribution
request are not\n\t\t\t\t\tmerged into your existing configuration. Make sure to include all fields: the\n\t\t\t\t\tones that you modified and also the ones that you didn't.
Updates the configuration for a CloudFront distribution.
\nThe update process includes getting the current distribution configuration, updating\n\t\t\tit to make your changes, and then submitting an UpdateDistribution
request\n\t\t\tto make the updates.
\n To update a web distribution using the CloudFront\n\t\t\tAPI\n
\nUse GetDistributionConfig
to get the current configuration,\n\t\t\t\t\tincluding the version identifier (ETag
).
Update the distribution configuration that was returned in the response. Note\n\t\t\t\t\tthe following important requirements and restrictions:
\nYou must copy the ETag
field value from the response. (You'll use it for the IfMatch
parameter in your request.) Then, remove the ETag
\n\t\t\t\t\t\t\tfield from the distribution configuration.
You can't change the value of CallerReference
.
Submit an UpdateDistribution
request, providing the updated distribution\n\t\t\t\t\tconfiguration. The new configuration replaces the existing configuration. The\n\t\t\t\t\tvalues that you specify in an UpdateDistribution
request are not\n\t\t\t\t\tmerged into your existing configuration. Make sure to include all fields: the\n\t\t\t\t\tones that you modified and also the ones that you didn't.
The current versions (ETag
values) of both primary and staging distributions.\n\t\t\tProvide these in the following format:
\n
\n
The current versions (ETag
values) of both primary and staging distributions.\n\t\t\tProvide these in the following format:
\n <primary ETag>, <staging ETag>
\n
Updates a CloudFront function.
\nYou can update a function's code or the comment that describes the function. You\n\t\t\tcannot update a function's name.
\nTo update a function, you provide the function's name and version (ETag
\n\t\t\tvalue) along with the updated function code. To get the name and version, you can use\n\t\t\t\tListFunctions
and DescribeFunction
.
Specifies the key value store to update.
", + "smithy.api#examples": [ + { + "title": "To update a KeyValueStore", + "documentation": "Use the following command to update a KeyValueStore.", + "input": { + "Name": "my-keyvaluestore-name", + "Comment": "my-changed-comment", + "IfMatch": "ETVPDKIKX0DER" + }, + "output": { + "KeyValueStore": { + "Name": "my-keyvaluestore-name", + "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889", + "Comment": "my-changed-comment", + "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889", + "Status": "READY", + "LastModifiedTime": "2023-11-07T18:45:21.069Z" + }, + "ETag": "E3UN6WX5RRO2AG" + } + } + ], "smithy.api#http": { "method": "PUT", "uri": "/2020-05-31/key-value-store/{Name}",