@aws-sdk/client-verifiedpermissions 3.661.0 → 3.664.0

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

@@ -188,6 +188,37 @@ declare const GetPolicyCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example To retrieve details about a policy
+ * ```javascript
+ * // The following example retrieves information about the specified policy contained in the specified policy store. In this example, the requested policy is a template-linked policy, so it returns the ID of the policy template, and the specific principal and resource used by this policy.
+ * const input = {
+ *   "policyId": "9wYixMplbbZQb5fcZHyJhY",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new GetPolicyCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "createdDate": "2024-08-12T18:20:50.99Z",
+ *   "definition": {
+ *     "static": {
+ *       "description": "Grant everyone of janeFriends UserGroup access to the vacationFolder Album",
+ *       "statement": "permit(principal, action, resource in Album::\"publicFolder\");"
+ *     }
+ *   },
+ *   "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *   "policyId": "9wYxMpljbbZQb5fcZHyJhY",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "policyType": "STATIC",
+ *   "resource": {
+ *     "entityId": "publicFolder",
+ *     "entityType": "Album"
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class GetPolicyCommand extends GetPolicyCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -158,6 +158,28 @@ declare const GetPolicyStoreCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example GetPolicyStore
+ * ```javascript
+ * // The following example retrieves details about the specified policy store.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new GetPolicyStoreCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "arn": "arn:aws:verifiedpermissions::123456789012:policy-store/C7v5xMplfFH3i3e4Jrzb1a",
+ *   "createdDate": "2024-08-12T18:20:50.99Z",
+ *   "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "validationSettings": {
+ *     "mode": "STRICT"
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class GetPolicyStoreCommand extends GetPolicyStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -157,6 +157,28 @@ declare const GetPolicyTemplateCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example GetPolicyTemplate
+ * ```javascript
+ * // The following example displays the details of the specified policy template.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "policyTemplateId": "PTEXAMPLEabcdefg111111"
+ * };
+ * const command = new GetPolicyTemplateCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "createdDate": "2024-08-12T18:20:50.99Z",
+ *   "description": "Template for research dept",
+ *   "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "policyTemplateId": "PTEXAMPLEabcdefg111111",
+ *   "statement": "permit(\n  principal ?principal,\n  action == Action::\"view\",\n  resource in ?resource\n) when {\n  principal has department && principal.department == \"research\" \n};"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class GetPolicyTemplateCommand extends GetPolicyTemplateCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -157,6 +157,30 @@ declare const GetSchemaCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example GetSchema
+ * ```javascript
+ * // The following example retrieves the current schema stored in the specified policy store.
+ * //
+ * // Note
+ * // The JSON in the parameters of this operation are strings that can contain embedded quotation marks (") within the outermost quotation mark pair. This requires that you stringify the JSON object by preceding all embedded quotation marks with a backslash character ( \" ) and combining all lines into a single text line with no line breaks.
+ * //
+ * // Example strings might be displayed wrapped across multiple lines here for readability, but the operation requires the parameters be submitted as single line strings.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new GetSchemaCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "createdDate": "2024-08-12T18:20:50.99Z",
+ *   "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "schema": "{\n\"My::Application\": {\n\"actions\": {\n\"remoteAccess\": {\n\"appliesTo\": {\n\"principalTypes\":   [\"Employee\"]\n}\n}\n},\n\"entityTypes\":   {\n\"Employee\": {\n\"shape\": {\n\"attributes\": {\n\"jobLevel\": { \"type\": \"Long\" },\n\"name\": { \"type\":\"String\" }\n},\n\"type\": \"Record\"\n}\n}\n}\n}\n  }"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class GetSchemaCommand extends GetSchemaCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -221,6 +221,72 @@ declare const IsAuthorizedCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example IsAuthorized - Example 1
+ * ```javascript
+ * // The following example requests an authorization decision for a principal of type User named Alice, who wants to perform the updatePhoto operation, on a resource of type Photo named VacationPhoto94.jpg.
+ * //
+ * // The response shows that the request was allowed by one policy.
+ * const input = {
+ *   "action": {
+ *     "actionId": "view",
+ *     "actionType": "Action"
+ *   },
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "principal": {
+ *     "entityId": "alice",
+ *     "entityType": "User"
+ *   },
+ *   "resource": {
+ *     "entityId": "VacationPhoto94.jpg",
+ *     "entityType": "Photo"
+ *   }
+ * };
+ * const command = new IsAuthorizedCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "errors": [],
+ *   "decision": "ALLOW",
+ *   "determiningPolicies": [
+ *     {
+ *       "policyId": "9wYxMpljbbZQb5fcZHyJhY"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
+ * @example IsAuthorized - Example 2
+ * ```javascript
+ * // The following example is the same as the previous example, except that the principal is User::"bob", and the policy store doesn't contain any policy that allows that user access to Album::"alice_folder". The output infers that the Deny was implicit because the list of DeterminingPolicies is empty.
+ * const input = {
+ *   "action": {
+ *     "actionId": "view",
+ *     "actionType": "Action"
+ *   },
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "principal": {
+ *     "entityId": "bob",
+ *     "entityType": "User"
+ *   },
+ *   "resource": {
+ *     "entityId": "VacationPhoto94.jpg",
+ *     "entityType": "Photo"
+ *   }
+ * };
+ * const command = new IsAuthorizedCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "errors": [],
+ *   "decision": "DENY",
+ *   "determiningPolicies": []
+ * }
+ * *\/
+ * // example id: example-2
+ * ```
+ *
  */
 export declare class IsAuthorizedCommand extends IsAuthorizedCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -231,6 +231,43 @@ declare const IsAuthorizedWithTokenCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example IsAuthorizedWithToken - Example 1
+ * ```javascript
+ * // The following example requests an authorization decision for a user who was authenticated by Amazon Cognito. The request uses the identity token provided by Amazon Cognito instead of the access token. In this example, the specified information store is configured to return principals as entities of type CognitoUser. The policy store contains a policy with the following statement.
+ * //
+ * // permit(
+ * //     principal == CognitoUser::"us-east-1_1a2b3c4d5|a1b2c3d4e5f6g7h8i9j0kalbmc",
+ * //     action,
+ * //     resource == Photo::"VacationPhoto94.jpg"
+ * // );
+ * const input = {
+ *   "action": {
+ *     "actionId": "View",
+ *     "actionType": "Action"
+ *   },
+ *   "identityToken": "EgZjxMPlbWUyBggAEEUYOdIBCDM3NDlqMGo3qAIAsAIA",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "resource": {
+ *     "entityId": "vacationPhoto94.jpg",
+ *     "entityType": "Photo"
+ *   }
+ * };
+ * const command = new IsAuthorizedWithTokenCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "errors": [],
+ *   "decision": "ALLOW",
+ *   "determiningPolicies": [
+ *     {
+ *       "policyId": "9wYxMpljbbZQb5fcZHyJhY"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class IsAuthorizedWithTokenCommand extends IsAuthorizedWithTokenCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -207,6 +207,38 @@ declare const ListIdentitySourcesCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example ListIdentitySources
+ * ```javascript
+ * // The following example request creates lists the identity sources currently defined in the specified policy store.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new ListIdentitySourcesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "identitySources": [
+ *     {
+ *       "createdDate": "2023-05-19T20:29:23.66812Z",
+ *       "details": {
+ *         "clientIds": [
+ *           "a1b2c3d4e5f6g7h8i9j0kalbmc"
+ *         ],
+ *         "discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_1a2b3c4d5",
+ *         "openIdIssuer": "COGNITO",
+ *         "userPoolArn": "arn:aws:cognito-idp:us-east-1:123456789012:userpool/us-east-1_1a2b3c4d5"
+ *       },
+ *       "identitySourceId": "ISEXAMPLEabcdefg111111",
+ *       "lastUpdatedDate": "2023-05-19T20:29:23.66812Z",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "principalEntityType": "User"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class ListIdentitySourcesCommand extends ListIdentitySourcesCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -211,6 +211,170 @@ declare const ListPoliciesCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example ListPolicies - Example 1
+ * ```javascript
+ * // The following example lists all policies in the policy store.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new ListPoliciesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "policies": [
+ *     {
+ *       "createdDate": "2024-08-12T18:20:50.99Z",
+ *       "definition": {
+ *         "static": {
+ *           "description": "Grant members of janeFriends UserGroup access to the vacationFolder Album"
+ *         }
+ *       },
+ *       "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *       "policyId": "9wYxMpljbbZQb5fcZHyJhY",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyType": "STATIC",
+ *       "principal": {
+ *         "entityId": "janeFriends",
+ *         "entityType": "UserGroup"
+ *       },
+ *       "resource": {
+ *         "entityId": "vacationFolder",
+ *         "entityType": "Album"
+ *       }
+ *     },
+ *     {
+ *       "createdDate": "2024-08-12T18:20:50.99Z",
+ *       "definition": {
+ *         "static": {
+ *           "description": "Grant everyone access to the publicFolder Album"
+ *         }
+ *       },
+ *       "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *       "policyId": "Et9KxMplyaDdyurDw8TeFa",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyType": "STATIC",
+ *       "resource": {
+ *         "entityId": "publicFolder",
+ *         "entityType": "Album"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
+ * @example ListPolicies - Example 2
+ * ```javascript
+ * // The following example lists all policies for a specified principal.
+ * const input = {
+ *   "filter": {
+ *     "principal": {
+ *       "identifier": {
+ *         "entityId": "alice",
+ *         "entityType": "User"
+ *       }
+ *     }
+ *   },
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new ListPoliciesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "policies": [
+ *     {
+ *       "createdDate": "2022-12-09T22:55:16.067533Z",
+ *       "definition": {
+ *         "static": {
+ *           "description": "An example policy"
+ *         }
+ *       },
+ *       "lastUpdatedDate": "2022-12-09T22:55:16.067533Z",
+ *       "policyId": "Et9KxMplyaDdyurDw8TeFa",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyType": "STATIC",
+ *       "principal": {
+ *         "entityId": "alice",
+ *         "entityType": "User"
+ *       },
+ *       "resource": {
+ *         "entityId": "bob_folder",
+ *         "entityType": "Album"
+ *       }
+ *     },
+ *     {
+ *       "createdDate": "2022-12-09T23:00:24.66266Z",
+ *       "definition": {
+ *         "static": {}
+ *       },
+ *       "lastUpdatedDate": "2022-12-09T23:00:24.66266Z",
+ *       "policyId": "9wYxMpljbbZQb5fcZHyJhY",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyType": "STATIC",
+ *       "principal": {
+ *         "entityId": "alice",
+ *         "entityType": "User"
+ *       },
+ *       "resource": {
+ *         "entityId": "alice_folder",
+ *         "entityType": "Album"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-2
+ * ```
+ *
+ * @example ListPolicies - Example 3
+ * ```javascript
+ * // The following example uses the Filter parameter to list only the template-linked policies in the specified policy store.
+ * const input = {
+ *   "filter": {
+ *     "policyType": "TEMPLATE_LINKED"
+ *   },
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new ListPoliciesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "policies": [
+ *     {
+ *       "createdDate": "2023-06-13T16:03:07.620867Z",
+ *       "definition": {
+ *         "templateLinked": {
+ *           "policyTemplateId": "PTEXAMPLEabcdefg111111",
+ *           "principal": {
+ *             "entityId": "alice",
+ *             "entityType": "User"
+ *           },
+ *           "resource": {
+ *             "entityId": "pic.jpg",
+ *             "entityType": "Photo"
+ *           }
+ *         }
+ *       },
+ *       "lastUpdatedDate": "2023-06-13T16:03:07.620867Z",
+ *       "policyId": "9wYxMpljbbZQb5fcZHyJhY",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyType": "TEMPLATE_LINKED",
+ *       "principal": {
+ *         "entityId": "alice",
+ *         "entityType": "User"
+ *       },
+ *       "resource": {
+ *         "entityId": "pic.jpg",
+ *         "entityType": "Photo"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-3
+ * ```
+ *
  */
 export declare class ListPoliciesCommand extends ListPoliciesCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -158,6 +158,31 @@ declare const ListPolicyStoresCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example ListPolicyStores
+ * ```javascript
+ * // The following example lists all policy stores in the AWS account in the AWS Region in which you call the operation.
+ * const input = {};
+ * const command = new ListPolicyStoresCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "policyStores": [
+ *     {
+ *       "arn": "arn:aws:verifiedpermissions::123456789012:policy-store/C7v5xMplfFH3i3e4Jrzb1a",
+ *       "createdDate": "2023-05-16T17:41:29.103459Z",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ *     },
+ *     {
+ *       "arn": "arn:aws:verifiedpermissions::123456789012:policy-store/PSEXAMPLEabcdefg222222",
+ *       "createdDate": "2023-05-16T18:23:04.985521Z",
+ *       "policyStoreId": "PSEXAMPLEabcdefg222222"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class ListPolicyStoresCommand extends ListPolicyStoresCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -162,6 +162,37 @@ declare const ListPolicyTemplatesCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example ListPolicyTemplates
+ * ```javascript
+ * // The following example retrieves a list of all of the policy templates in the specified policy store.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new ListPolicyTemplatesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "policyTemplates": [
+ *     {
+ *       "createdDate": "2024-08-12T18:20:50.99Z",
+ *       "description": "Generic template",
+ *       "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyTemplateId": "PTEXAMPLEabcdefg111111"
+ *     },
+ *     {
+ *       "createdDate": "2024-08-12T18:20:50.99Z",
+ *       "description": "Template for research dept",
+ *       "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *       "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *       "policyTemplateId": "PTEXAMPLEabcdefg222222"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class ListPolicyTemplatesCommand extends ListPolicyTemplatesCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -176,6 +176,35 @@ declare const PutSchemaCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example PutSchema
+ * ```javascript
+ * // The following example creates a new schema, or updates an existing schema, in the specified policy store. Note that the schema text is shown line wrapped for readability. You should submit the entire schema text as a single line of text.
+ * //
+ * // Note
+ * // The JSON in the parameters of this operation are strings that can contain embedded quotation marks (") within the outermost quotation mark pair. This requires that you stringify the JSON object by preceding all embedded quotation marks with a backslash character ( \" ) and combining all lines into a single text line with no line breaks.
+ * //
+ * // Example strings might be displayed wrapped across multiple lines here for readability, but the operation requires the parameters be submitted as single line strings.
+ * const input = {
+ *   "definition": {
+ *     "cedarJson": "{\"MySampleNamespace\": {\"actions\": {\"remoteAccess\": {\"appliesTo\": {\"principalTypes\": [\"Employee\"]}}},\"entityTypes\": {\"Employee\": {\"shape\": {\"attributes\": {\"jobLevel\": {\"type\": \"Long\"},\"name\": {\"type\": \"String\"}},\"type\": \"Record\"}}}}}"
+ *   },
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new PutSchemaCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "createdDate": "2023-06-13T19:28:06.003726Z",
+ *   "lastUpdatedDate": "2023-06-13T19:28:06.003726Z",
+ *   "namespaces": [
+ *     "My::Sample::Namespace"
+ *   ],
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class PutSchemaCommand extends PutSchemaCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -200,6 +200,34 @@ declare const UpdateIdentitySourceCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example UpdateIdentitySource
+ * ```javascript
+ * // The following example updates the configuration of the specified identity source with a new configuration.
+ * const input = {
+ *   "identitySourceId": "ISEXAMPLEabcdefg111111",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "updateConfiguration": {
+ *     "cognitoUserPoolConfiguration": {
+ *       "clientIds": [
+ *         "a1b2c3d4e5f6g7h8i9j0kalbmc"
+ *       ],
+ *       "userPoolArn": "arn:aws:cognito-idp:us-east-1:123456789012:userpool/us-east-1_1a2b3c4d5"
+ *     }
+ *   }
+ * };
+ * const command = new UpdateIdentitySourceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "createdDate": "2023-05-19T20:30:28.173926Z",
+ *   "identitySourceId": "ISEXAMPLEabcdefg111111",
+ *   "lastUpdatedDate": "2023-05-22T20:45:59.962216Z",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class UpdateIdentitySourceCommand extends UpdateIdentitySourceCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -234,6 +234,36 @@ declare const UpdatePolicyCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example UpdatePolicy
+ * ```javascript
+ * // The following example replaces the definition of the specified static policy with a new one.
+ * const input = {
+ *   "definition": {
+ *     "static": {
+ *       "statement": "permit(principal, action, resource in Album::\"public_folder\");"
+ *     }
+ *   },
+ *   "policyId": "9wYxMpljbbZQb5fcZHyJhY",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * };
+ * const command = new UpdatePolicyCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "createdDate": "2024-08-12T18:20:50.99Z",
+ *   "lastUpdatedDate": "2024-08-12T18:20:50.99Z",
+ *   "policyId": "9wYxMpljbbZQb5fcZHyJhY",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "policyType": "STATIC",
+ *   "resource": {
+ *     "entityId": "public_folder",
+ *     "entityType": "Album"
+ *   }
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class UpdatePolicyCommand extends UpdatePolicyCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -168,6 +168,28 @@ declare const UpdatePolicyStoreCommand_base: {
  * <p>Base exception class for all service exceptions from VerifiedPermissions service.</p>
  *
  * @public
+ * @example UpdatePolicyStore
+ * ```javascript
+ * // The following example turns off the validation settings for a policy store.
+ * const input = {
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a",
+ *   "validationSettings": {
+ *     "mode": "OFF"
+ *   }
+ * };
+ * const command = new UpdatePolicyStoreCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "arn": "arn:aws:verifiedpermissions::123456789012:policy-store/C7v5xMplfFH3i3e4Jrzb1a",
+ *   "createdDate": "2023-05-17T18:36:10.134448Z",
+ *   "lastUpdatedDate": "2023-05-23T18:18:12.443083Z",
+ *   "policyStoreId": "C7v5xMplfFH3i3e4Jrzb1a"
+ * }
+ * *\/
+ * // example id: example-1
+ * ```
+ *
  */
 export declare class UpdatePolicyStoreCommand extends UpdatePolicyStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */