@aws-sdk/client-cloudfront 3.689.0 → 3.690.0

package/dist-types/commands/CreateFunctionCommand.d.ts

@@ -173,6 +173,58 @@ declare const CreateFunctionCommand_base: {
  * // example id: to-create-a-function-1699737558249
  * ```
  *
+ * @example To create a function
+ * ```javascript
+ * // Use the following command to create a function.
+ * const input = {
+ *   "FunctionCode": "function-code.js",
+ *   "FunctionConfig": {
+ *     "Comment": "my-function-comment",
+ *     "KeyValueStoreAssociations": {
+ *       "Items": [
+ *         {
+ *           "KeyValueStoreARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889"
+ *         }
+ *       ],
+ *       "Quantity": 1
+ *     },
+ *     "Runtime": "cloudfront-js-2.0"
+ *   },
+ *   "Name": "my-function-name"
+ * };
+ * const command = new CreateFunctionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ETag": "ETVPDKIKX0DER",
+ *   "FunctionSummary": {
+ *     "FunctionConfig": {
+ *       "Comment": "my-function-comment",
+ *       "KeyValueStoreAssociations": {
+ *         "Items": [
+ *           {
+ *             "KeyValueStoreARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889"
+ *           }
+ *         ],
+ *         "Quantity": 1
+ *       },
+ *       "Runtime": "cloudfront-js-2.0"
+ *     },
+ *     "FunctionMetadata": {
+ *       "CreatedTime": "2023-11-07T19:53:50.334Z",
+ *       "FunctionARN": "arn:aws:cloudfront::123456789012:function/my-function-name",
+ *       "LastModifiedTime": "2023-11-07T19:53:50.334Z",
+ *       "Stage": "DEVELOPMENT"
+ *     },
+ *     "Name": "my-function-name",
+ *     "Status": "UNPUBLISHED"
+ *   },
+ *   "Location": "https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront::123456789012:function/my-function-name"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class CreateFunctionCommand extends CreateFunctionCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/CreateKeyValueStoreCommand.d.ts

@@ -118,6 +118,36 @@ declare const CreateKeyValueStoreCommand_base: {
  * // example id: to-create-a-key-value-store-1699751722467
  * ```
  *
+ * @example To create a KeyValueStore
+ * ```javascript
+ * // Use the following command to create a KeyValueStore.
+ * const input = {
+ *   "Comment": "my-key-valuestore-comment",
+ *   "ImportSource": {
+ *     "SourceARN": "arn:aws:s3:::my-bucket/validJSON.json",
+ *     "SourceType": "S3"
+ *   },
+ *   "Name": "my-keyvaluestore-name"
+ * };
+ * const command = new CreateKeyValueStoreCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ETag": "ETVPDKIKX0DER",
+ *   "KeyValueStore": {
+ *     "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *     "Comment": "my-key-valuestore-comment",
+ *     "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *     "LastModifiedTime": "2023-11-07T18:15:52.042Z",
+ *     "Name": "my-keyvaluestore-name",
+ *     "Status": "PROVISIONING"
+ *   },
+ *   "Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class CreateKeyValueStoreCommand extends CreateKeyValueStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/DeleteKeyValueStoreCommand.d.ts

@@ -85,6 +85,18 @@ declare const DeleteKeyValueStoreCommand_base: {
  * // example id: to-delete-a-key-value-store-1699751759648
  * ```
  *
+ * @example To delete a KeyValueStore
+ * ```javascript
+ * // Use the following command to delete a KeyValueStore.
+ * const input = {
+ *   "IfMatch": "ETVPDKIKX0DER",
+ *   "Name": "my-keyvaluestore-name"
+ * };
+ * const command = new DeleteKeyValueStoreCommand(input);
+ * await client.send(command);
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class DeleteKeyValueStoreCommand extends DeleteKeyValueStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/DescribeKeyValueStoreCommand.d.ts

@@ -99,6 +99,30 @@ declare const DescribeKeyValueStoreCommand_base: {
  * // example id: to-describe-a-key-value-store-1699751788152
  * ```
  *
+ * @example To describe a KeyValueStore
+ * ```javascript
+ * // Use the following command to describe a KeyValueStore.
+ * const input = {
+ *   "Name": "my-keyvaluestore-name"
+ * };
+ * const command = new DescribeKeyValueStoreCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ETag": "ETVPDKIKX0DER",
+ *   "KeyValueStore": {
+ *     "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *     "Comment": "my-key-valuestore-comment",
+ *     "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *     "LastModifiedTime": "2023-11-07T18:20:33.056Z",
+ *     "Name": "my-keyvaluestore-name",
+ *     "Status": "READY"
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class DescribeKeyValueStoreCommand extends DescribeKeyValueStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListKeyValueStoresCommand.d.ts

@@ -112,6 +112,36 @@ declare const ListKeyValueStoresCommand_base: {
  * // example id: to-get-a-list-of-key-value-store-1699751799198
  * ```
  *
+ * @example To get a list of KeyValueStores
+ * ```javascript
+ * // The following command retrieves a list of KeyValueStores with READY status.
+ * const input = {
+ *   "Status": "READY"
+ * };
+ * const command = new ListKeyValueStoresCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "KeyValueStoreList": {
+ *     "Items": [
+ *       {
+ *         "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *         "Comment": "",
+ *         "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *         "LastModifiedTime": "2023-11-07T18:45:21.069Z",
+ *         "Name": "my-keyvaluestore-name",
+ *         "Status": "READY"
+ *       }
+ *     ],
+ *     "MaxItems": 100,
+ *     "NextMarker": "",
+ *     "Quantity": 1
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class ListKeyValueStoresCommand extends ListKeyValueStoresCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/UpdateFunctionCommand.d.ts

@@ -168,6 +168,58 @@ declare const UpdateFunctionCommand_base: {
  * // example id: to-update-a-function-1699751865053
  * ```
  *
+ * @example To update a function
+ * ```javascript
+ * // Use the following command to update a function.
+ * const input = {
+ *   "FunctionCode": "function-code-changed.js",
+ *   "FunctionConfig": {
+ *     "Comment": "my-changed-comment",
+ *     "KeyValueStoreAssociations": {
+ *       "Items": [
+ *         {
+ *           "KeyValueStoreARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889"
+ *         }
+ *       ],
+ *       "Quantity": 1
+ *     },
+ *     "Runtime": "cloudfront-js-2.0"
+ *   },
+ *   "IfMatch": "ETVPDKIKX0DER",
+ *   "Name": "my-function-name"
+ * };
+ * const command = new UpdateFunctionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ETag": "E3UN6WX5RRO2AG",
+ *   "FunctionSummary": {
+ *     "FunctionConfig": {
+ *       "Comment": "my-changed-comment",
+ *       "KeyValueStoreAssociations": {
+ *         "Items": [
+ *           {
+ *             "KeyValueStoreARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889"
+ *           }
+ *         ],
+ *         "Quantity": 1
+ *       },
+ *       "Runtime": "cloudfront-js-2.0"
+ *     },
+ *     "FunctionMetadata": {
+ *       "CreatedTime": "2023-11-07T19:53:50.334Z",
+ *       "FunctionARN": "arn:aws:cloudfront::123456789012:function/my-function-name",
+ *       "LastModifiedTime": "2023-11-07T20:01:37.174Z",
+ *       "Stage": "DEVELOPMENT"
+ *     },
+ *     "Name": "my-function-name",
+ *     "Status": "UNPUBLISHED"
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class UpdateFunctionCommand extends UpdateFunctionCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/UpdateKeyValueStoreCommand.d.ts

@@ -110,6 +110,32 @@ declare const UpdateKeyValueStoreCommand_base: {
  * // example id: to-update-a-key-value-store-1699751822090
  * ```
  *
+ * @example To update a KeyValueStore
+ * ```javascript
+ * // Use the following command to update a KeyValueStore.
+ * const input = {
+ *   "Comment": "my-changed-comment",
+ *   "IfMatch": "ETVPDKIKX0DER",
+ *   "Name": "my-keyvaluestore-name"
+ * };
+ * const command = new UpdateKeyValueStoreCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ETag": "E3UN6WX5RRO2AG",
+ *   "KeyValueStore": {
+ *     "ARN": "arn:aws:cloudfront::123456789012:key-value-store/54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *     "Comment": "my-changed-comment",
+ *     "Id": "54947df8-0e9e-4471-a2f9-9af509fb5889",
+ *     "LastModifiedTime": "2023-11-07T18:45:21.069Z",
+ *     "Name": "my-keyvaluestore-name",
+ *     "Status": "READY"
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class UpdateKeyValueStoreCommand extends UpdateKeyValueStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-cloudfront",
   "description": "AWS SDK for JavaScript Cloudfront Client for Node.js, Browser and React Native",
-  "version": "3.689.0",
+  "version": "3.690.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-cloudfront",