docs(clients): switch example generation from JS to Smithy, add streaming blob output examples (#6981)

* chore(codegen): sync for smithy example generation

* docs: remove JS-based example generation

* chore(client-s3): example docgen diff

* docs(clients): codegen sync

Author: kuhe

clients/client-accessanalyzer/src/commands/ApplyArchiveRuleCommand.ts

@@ -71,6 +71,7 @@ export interface ApplyArchiveRuleCommandOutput extends __MetadataBearer {}
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class ApplyArchiveRuleCommand extends $Command

clients/client-accessanalyzer/src/commands/CancelPolicyGenerationCommand.ts

@@ -65,6 +65,7 @@ export interface CancelPolicyGenerationCommandOutput extends CancelPolicyGenerat
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class CancelPolicyGenerationCommand extends $Command

clients/client-accessanalyzer/src/commands/CheckAccessNotGrantedCommand.ts

@@ -96,89 +96,87 @@ export interface CheckAccessNotGrantedCommandOutput extends CheckAccessNotGrante
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
- * @public
+ *
  * @example Passing check. Restrictive identity policy.
  * ```javascript
  * //
  * const input = {
- *   "access": [
+ *   access: [
  *     {
- *       "actions": [
+ *       actions: [
  *         "s3:PutObject"
  *       ]
  *     }
  *   ],
- *   "policyDocument": "{\"Version\":\"2012-10-17\",\"Id\":\"123\",\"Statement\":[{\"Sid\":\"AllowJohnDoe\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:user/JohnDoe\"},\"Action\":\"s3:GetObject\",\"Resource\":\"*\"}]}",
- *   "policyType": "RESOURCE_POLICY"
+ *   policyDocument: `{"Version":"2012-10-17","Id":"123","Statement":[{"Sid":"AllowJohnDoe","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:user/JohnDoe"},"Action":"s3:GetObject","Resource":"*"}]}`,
+ *   policyType: "RESOURCE_POLICY"
  * };
  * const command = new CheckAccessNotGrantedCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "message": "The policy document does not grant access to perform the listed actions or resources.",
- *   "result": "PASS"
+ *   message: "The policy document does not grant access to perform the listed actions or resources.",
+ *   result: "PASS"
  * }
  * *\/
- * // example id: example-1
  * ```
  *
  * @example Passing check. Restrictive S3 Bucket resource policy.
  * ```javascript
  * //
  * const input = {
- *   "access": [
+ *   access: [
  *     {
- *       "resources": [
+ *       resources: [
  *         "arn:aws:s3:::sensitive-bucket/*"
  *       ]
  *     }
  *   ],
- *   "policyDocument": "{\"Version\":\"2012-10-17\",\"Id\":\"123\",\"Statement\":[{\"Sid\":\"AllowJohnDoe\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:user/JohnDoe\"},\"Action\":\"s3:PutObject\",\"Resource\":\"arn:aws:s3:::non-sensitive-bucket/*\"}]}",
- *   "policyType": "RESOURCE_POLICY"
+ *   policyDocument: `{"Version":"2012-10-17","Id":"123","Statement":[{"Sid":"AllowJohnDoe","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:user/JohnDoe"},"Action":"s3:PutObject","Resource":"arn:aws:s3:::non-sensitive-bucket/*"}]}`,
+ *   policyType: "RESOURCE_POLICY"
  * };
  * const command = new CheckAccessNotGrantedCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "message": "The policy document does not grant access to perform the listed actions or resources.",
- *   "result": "PASS"
+ *   message: "The policy document does not grant access to perform the listed actions or resources.",
+ *   result: "PASS"
  * }
  * *\/
- * // example id: example-2
  * ```
  *
  * @example Failing check. Permissive S3 Bucket resource policy.
  * ```javascript
  * //
  * const input = {
- *   "access": [
+ *   access: [
  *     {
- *       "resources": [
+ *       resources: [
  *         "arn:aws:s3:::my-bucket/*"
  *       ]
  *     }
  *   ],
- *   "policyDocument": "{\"Version\":\"2012-10-17\",\"Id\":\"123\",\"Statement\":[{\"Sid\":\"AllowJohnDoe\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:user/JohnDoe\"},\"Action\":\"s3:PutObject\",\"Resource\":\"arn:aws:s3:::my-bucket/*\"}]}",
- *   "policyType": "RESOURCE_POLICY"
+ *   policyDocument: `{"Version":"2012-10-17","Id":"123","Statement":[{"Sid":"AllowJohnDoe","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:user/JohnDoe"},"Action":"s3:PutObject","Resource":"arn:aws:s3:::my-bucket/*"}]}`,
+ *   policyType: "RESOURCE_POLICY"
  * };
  * const command = new CheckAccessNotGrantedCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "message": "The policy document grants access to perform one or more of the listed actions or resources.",
- *   "reasons": [
+ *   message: "The policy document grants access to perform one or more of the listed actions or resources.",
+ *   reasons: [
  *     {
- *       "description": "One or more of the listed actions or resources in the statement with sid: AllowJohnDoe.",
- *       "statementId": "AllowJohnDoe",
- *       "statementIndex": 0
+ *       description: "One or more of the listed actions or resources in the statement with sid: AllowJohnDoe.",
+ *       statementId: "AllowJohnDoe",
+ *       statementIndex: 0
  *     }
  *   ],
- *   "result": "FAIL"
+ *   result: "FAIL"
  * }
  * *\/
- * // example id: example-3
  * ```
  *
+ * @public
  */
 export class CheckAccessNotGrantedCommand extends $Command
   .classBuilder<

clients/client-accessanalyzer/src/commands/CheckNoNewAccessCommand.ts

@@ -92,6 +92,7 @@ export interface CheckNoNewAccessCommandOutput extends CheckNoNewAccessResponse,
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class CheckNoNewAccessCommand extends $Command

clients/client-accessanalyzer/src/commands/CheckNoPublicAccessCommand.ts

@@ -87,50 +87,49 @@ export interface CheckNoPublicAccessCommandOutput extends CheckNoPublicAccessRes
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
- * @public
+ *
  * @example Passing check. S3 Bucket policy without public access.
  * ```javascript
  * //
  * const input = {
- *   "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Bob\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::111122223333:user/JohnDoe\"},\"Action\":[\"s3:GetObject\"]}]}",
- *   "resourceType": "AWS::S3::Bucket"
+ *   policyDocument: `{"Version":"2012-10-17","Statement":[{"Sid":"Bob","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::111122223333:user/JohnDoe"},"Action":["s3:GetObject"]}]}`,
+ *   resourceType: "AWS::S3::Bucket"
  * };
  * const command = new CheckNoPublicAccessCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "message": "The resource policy does not grant public access for the given resource type.",
- *   "result": "PASS"
+ *   message: "The resource policy does not grant public access for the given resource type.",
+ *   result: "PASS"
  * }
  * *\/
- * // example id: example-1
  * ```
  *
  * @example Failing check. S3 Bucket policy with public access.
  * ```javascript
  * //
  * const input = {
- *   "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Bob\",\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":[\"s3:GetObject\"]}]}",
- *   "resourceType": "AWS::S3::Bucket"
+ *   policyDocument: `{"Version":"2012-10-17","Statement":[{"Sid":"Bob","Effect":"Allow","Principal":"*","Action":["s3:GetObject"]}]}`,
+ *   resourceType: "AWS::S3::Bucket"
  * };
  * const command = new CheckNoPublicAccessCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "message": "The resource policy grants public access for the given resource type.",
- *   "reasons": [
+ *   message: "The resource policy grants public access for the given resource type.",
+ *   reasons: [
  *     {
- *       "description": "Public access granted in the following statement with sid: Bob.",
- *       "statementId": "Bob",
- *       "statementIndex": 0
+ *       description: "Public access granted in the following statement with sid: Bob.",
+ *       statementId: "Bob",
+ *       statementIndex: 0
  *     }
  *   ],
- *   "result": "FAIL"
+ *   result: "FAIL"
  * }
  * *\/
- * // example id: example-2
  * ```
  *
+ * @public
  */
 export class CheckNoPublicAccessCommand extends $Command
   .classBuilder<

clients/client-accessanalyzer/src/commands/CreateAccessPreviewCommand.ts

@@ -193,6 +193,7 @@ export interface CreateAccessPreviewCommandOutput extends CreateAccessPreviewRes
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class CreateAccessPreviewCommand extends $Command

clients/client-accessanalyzer/src/commands/CreateAnalyzerCommand.ts

@@ -116,6 +116,7 @@ export interface CreateAnalyzerCommandOutput extends CreateAnalyzerResponse, __M
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class CreateAnalyzerCommand extends $Command

clients/client-accessanalyzer/src/commands/CreateArchiveRuleCommand.ts

@@ -92,6 +92,7 @@ export interface CreateArchiveRuleCommandOutput extends __MetadataBearer {}
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class CreateArchiveRuleCommand extends $Command

clients/client-accessanalyzer/src/commands/DeleteAnalyzerCommand.ts

@@ -71,6 +71,7 @@ export interface DeleteAnalyzerCommandOutput extends __MetadataBearer {}
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class DeleteAnalyzerCommand extends $Command

clients/client-accessanalyzer/src/commands/DeleteArchiveRuleCommand.ts

@@ -70,6 +70,7 @@ export interface DeleteArchiveRuleCommandOutput extends __MetadataBearer {}
  * @throws {@link AccessAnalyzerServiceException}
  * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
  *
+ *
  * @public
  */
 export class DeleteArchiveRuleCommand extends $Command