Skip to content

Commit c087759

Browse files
author
awstools
committed
feat(client-quicksight): Adding personalization in QuickSight data stories. Admins can enable or disable personalization through QuickSight settings.
1 parent 607ec0a commit c087759

11 files changed

+878
-171
lines changed

clients/client-quicksight/README.md

+16
Original file line numberDiff line numberDiff line change
@@ -839,6 +839,14 @@ DescribeNamespace
839839

840840
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/quicksight/command/DescribeNamespaceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/DescribeNamespaceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/DescribeNamespaceCommandOutput/)
841841

842+
</details>
843+
<details>
844+
<summary>
845+
DescribeQPersonalizationConfiguration
846+
</summary>
847+
848+
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/quicksight/command/DescribeQPersonalizationConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/DescribeQPersonalizationConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/DescribeQPersonalizationConfigurationCommandOutput/)
849+
842850
</details>
843851
<details>
844852
<summary>
@@ -1519,6 +1527,14 @@ UpdatePublicSharingSettings
15191527

15201528
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/quicksight/command/UpdatePublicSharingSettingsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/UpdatePublicSharingSettingsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/UpdatePublicSharingSettingsCommandOutput/)
15211529

1530+
</details>
1531+
<details>
1532+
<summary>
1533+
UpdateQPersonalizationConfiguration
1534+
</summary>
1535+
1536+
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/quicksight/command/UpdateQPersonalizationConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/UpdateQPersonalizationConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-quicksight/Interface/UpdateQPersonalizationConfigurationCommandOutput/)
1537+
15221538
</details>
15231539
<details>
15241540
<summary>

clients/client-quicksight/src/QuickSight.ts

+46
Original file line numberDiff line numberDiff line change
@@ -369,6 +369,11 @@ import {
369369
DescribeNamespaceCommandInput,
370370
DescribeNamespaceCommandOutput,
371371
} from "./commands/DescribeNamespaceCommand";
372+
import {
373+
DescribeQPersonalizationConfigurationCommand,
374+
DescribeQPersonalizationConfigurationCommandInput,
375+
DescribeQPersonalizationConfigurationCommandOutput,
376+
} from "./commands/DescribeQPersonalizationConfigurationCommand";
372377
import {
373378
DescribeRefreshScheduleCommand,
374379
DescribeRefreshScheduleCommandInput,
@@ -766,6 +771,11 @@ import {
766771
UpdatePublicSharingSettingsCommandInput,
767772
UpdatePublicSharingSettingsCommandOutput,
768773
} from "./commands/UpdatePublicSharingSettingsCommand";
774+
import {
775+
UpdateQPersonalizationConfigurationCommand,
776+
UpdateQPersonalizationConfigurationCommandInput,
777+
UpdateQPersonalizationConfigurationCommandOutput,
778+
} from "./commands/UpdateQPersonalizationConfigurationCommand";
769779
import {
770780
UpdateRefreshScheduleCommand,
771781
UpdateRefreshScheduleCommandInput,
@@ -906,6 +916,7 @@ const commands = {
906916
DescribeIpRestrictionCommand,
907917
DescribeKeyRegistrationCommand,
908918
DescribeNamespaceCommand,
919+
DescribeQPersonalizationConfigurationCommand,
909920
DescribeRefreshScheduleCommand,
910921
DescribeRoleCustomPermissionCommand,
911922
DescribeTemplateCommand,
@@ -991,6 +1002,7 @@ const commands = {
9911002
UpdateIpRestrictionCommand,
9921003
UpdateKeyRegistrationCommand,
9931004
UpdatePublicSharingSettingsCommand,
1005+
UpdateQPersonalizationConfigurationCommand,
9941006
UpdateRefreshScheduleCommand,
9951007
UpdateRoleCustomPermissionCommand,
9961008
UpdateSPICECapacityConfigurationCommand,
@@ -2243,6 +2255,23 @@ export interface QuickSight {
22432255
cb: (err: any, data?: DescribeNamespaceCommandOutput) => void
22442256
): void;
22452257

2258+
/**
2259+
* @see {@link DescribeQPersonalizationConfigurationCommand}
2260+
*/
2261+
describeQPersonalizationConfiguration(
2262+
args: DescribeQPersonalizationConfigurationCommandInput,
2263+
options?: __HttpHandlerOptions
2264+
): Promise<DescribeQPersonalizationConfigurationCommandOutput>;
2265+
describeQPersonalizationConfiguration(
2266+
args: DescribeQPersonalizationConfigurationCommandInput,
2267+
cb: (err: any, data?: DescribeQPersonalizationConfigurationCommandOutput) => void
2268+
): void;
2269+
describeQPersonalizationConfiguration(
2270+
args: DescribeQPersonalizationConfigurationCommandInput,
2271+
options: __HttpHandlerOptions,
2272+
cb: (err: any, data?: DescribeQPersonalizationConfigurationCommandOutput) => void
2273+
): void;
2274+
22462275
/**
22472276
* @see {@link DescribeRefreshScheduleCommand}
22482277
*/
@@ -3544,6 +3573,23 @@ export interface QuickSight {
35443573
cb: (err: any, data?: UpdatePublicSharingSettingsCommandOutput) => void
35453574
): void;
35463575

3576+
/**
3577+
* @see {@link UpdateQPersonalizationConfigurationCommand}
3578+
*/
3579+
updateQPersonalizationConfiguration(
3580+
args: UpdateQPersonalizationConfigurationCommandInput,
3581+
options?: __HttpHandlerOptions
3582+
): Promise<UpdateQPersonalizationConfigurationCommandOutput>;
3583+
updateQPersonalizationConfiguration(
3584+
args: UpdateQPersonalizationConfigurationCommandInput,
3585+
cb: (err: any, data?: UpdateQPersonalizationConfigurationCommandOutput) => void
3586+
): void;
3587+
updateQPersonalizationConfiguration(
3588+
args: UpdateQPersonalizationConfigurationCommandInput,
3589+
options: __HttpHandlerOptions,
3590+
cb: (err: any, data?: UpdateQPersonalizationConfigurationCommandOutput) => void
3591+
): void;
3592+
35473593
/**
35483594
* @see {@link UpdateRefreshScheduleCommand}
35493595
*/

clients/client-quicksight/src/QuickSightClient.ts

+12
Original file line numberDiff line numberDiff line change
@@ -270,6 +270,10 @@ import {
270270
DescribeKeyRegistrationCommandOutput,
271271
} from "./commands/DescribeKeyRegistrationCommand";
272272
import { DescribeNamespaceCommandInput, DescribeNamespaceCommandOutput } from "./commands/DescribeNamespaceCommand";
273+
import {
274+
DescribeQPersonalizationConfigurationCommandInput,
275+
DescribeQPersonalizationConfigurationCommandOutput,
276+
} from "./commands/DescribeQPersonalizationConfigurationCommand";
273277
import {
274278
DescribeRefreshScheduleCommandInput,
275279
DescribeRefreshScheduleCommandOutput,
@@ -493,6 +497,10 @@ import {
493497
UpdatePublicSharingSettingsCommandInput,
494498
UpdatePublicSharingSettingsCommandOutput,
495499
} from "./commands/UpdatePublicSharingSettingsCommand";
500+
import {
501+
UpdateQPersonalizationConfigurationCommandInput,
502+
UpdateQPersonalizationConfigurationCommandOutput,
503+
} from "./commands/UpdateQPersonalizationConfigurationCommand";
496504
import {
497505
UpdateRefreshScheduleCommandInput,
498506
UpdateRefreshScheduleCommandOutput,
@@ -628,6 +636,7 @@ export type ServiceInputTypes =
628636
| DescribeIpRestrictionCommandInput
629637
| DescribeKeyRegistrationCommandInput
630638
| DescribeNamespaceCommandInput
639+
| DescribeQPersonalizationConfigurationCommandInput
631640
| DescribeRefreshScheduleCommandInput
632641
| DescribeRoleCustomPermissionCommandInput
633642
| DescribeTemplateAliasCommandInput
@@ -713,6 +722,7 @@ export type ServiceInputTypes =
713722
| UpdateIpRestrictionCommandInput
714723
| UpdateKeyRegistrationCommandInput
715724
| UpdatePublicSharingSettingsCommandInput
725+
| UpdateQPersonalizationConfigurationCommandInput
716726
| UpdateRefreshScheduleCommandInput
717727
| UpdateRoleCustomPermissionCommandInput
718728
| UpdateSPICECapacityConfigurationCommandInput
@@ -811,6 +821,7 @@ export type ServiceOutputTypes =
811821
| DescribeIpRestrictionCommandOutput
812822
| DescribeKeyRegistrationCommandOutput
813823
| DescribeNamespaceCommandOutput
824+
| DescribeQPersonalizationConfigurationCommandOutput
814825
| DescribeRefreshScheduleCommandOutput
815826
| DescribeRoleCustomPermissionCommandOutput
816827
| DescribeTemplateAliasCommandOutput
@@ -896,6 +907,7 @@ export type ServiceOutputTypes =
896907
| UpdateIpRestrictionCommandOutput
897908
| UpdateKeyRegistrationCommandOutput
898909
| UpdatePublicSharingSettingsCommandOutput
910+
| UpdateQPersonalizationConfigurationCommandOutput
899911
| UpdateRefreshScheduleCommandOutput
900912
| UpdateRoleCustomPermissionCommandOutput
901913
| UpdateSPICECapacityConfigurationCommandOutput
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
// smithy-typescript generated code
2+
import { getEndpointPlugin } from "@smithy/middleware-endpoint";
3+
import { getSerdePlugin } from "@smithy/middleware-serde";
4+
import { Command as $Command } from "@smithy/smithy-client";
5+
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
6+
7+
import { commonParams } from "../endpoint/EndpointParameters";
8+
import {
9+
DescribeQPersonalizationConfigurationRequest,
10+
DescribeQPersonalizationConfigurationResponse,
11+
} from "../models/models_3";
12+
import {
13+
de_DescribeQPersonalizationConfigurationCommand,
14+
se_DescribeQPersonalizationConfigurationCommand,
15+
} from "../protocols/Aws_restJson1";
16+
import { QuickSightClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../QuickSightClient";
17+
18+
/**
19+
* @public
20+
*/
21+
export type { __MetadataBearer };
22+
export { $Command };
23+
/**
24+
* @public
25+
*
26+
* The input for {@link DescribeQPersonalizationConfigurationCommand}.
27+
*/
28+
export interface DescribeQPersonalizationConfigurationCommandInput
29+
extends DescribeQPersonalizationConfigurationRequest {}
30+
/**
31+
* @public
32+
*
33+
* The output of {@link DescribeQPersonalizationConfigurationCommand}.
34+
*/
35+
export interface DescribeQPersonalizationConfigurationCommandOutput
36+
extends DescribeQPersonalizationConfigurationResponse,
37+
__MetadataBearer {}
38+
39+
/**
40+
* <p>Describes a personalization configuration.</p>
41+
* @example
42+
* Use a bare-bones client and the command you need to make an API call.
43+
* ```javascript
44+
* import { QuickSightClient, DescribeQPersonalizationConfigurationCommand } from "@aws-sdk/client-quicksight"; // ES Modules import
45+
* // const { QuickSightClient, DescribeQPersonalizationConfigurationCommand } = require("@aws-sdk/client-quicksight"); // CommonJS import
46+
* const client = new QuickSightClient(config);
47+
* const input = { // DescribeQPersonalizationConfigurationRequest
48+
* AwsAccountId: "STRING_VALUE", // required
49+
* };
50+
* const command = new DescribeQPersonalizationConfigurationCommand(input);
51+
* const response = await client.send(command);
52+
* // { // DescribeQPersonalizationConfigurationResponse
53+
* // PersonalizationMode: "ENABLED" || "DISABLED",
54+
* // RequestId: "STRING_VALUE",
55+
* // Status: Number("int"),
56+
* // };
57+
*
58+
* ```
59+
*
60+
* @param DescribeQPersonalizationConfigurationCommandInput - {@link DescribeQPersonalizationConfigurationCommandInput}
61+
* @returns {@link DescribeQPersonalizationConfigurationCommandOutput}
62+
* @see {@link DescribeQPersonalizationConfigurationCommandInput} for command's `input` shape.
63+
* @see {@link DescribeQPersonalizationConfigurationCommandOutput} for command's `response` shape.
64+
* @see {@link QuickSightClientResolvedConfig | config} for QuickSightClient's `config` shape.
65+
*
66+
* @throws {@link AccessDeniedException} (client fault)
67+
* <p>You don't have access to this item. The provided credentials couldn't be
68+
* validated. You might not be authorized to carry out the request. Make sure that your
69+
* account is authorized to use the Amazon QuickSight service, that your policies have the
70+
* correct permissions, and that you are using the correct credentials.</p>
71+
*
72+
* @throws {@link ConflictException} (client fault)
73+
* <p>Updating or deleting a resource can cause an inconsistent state.</p>
74+
*
75+
* @throws {@link InternalFailureException} (server fault)
76+
* <p>An internal failure occurred.</p>
77+
*
78+
* @throws {@link InvalidParameterValueException} (client fault)
79+
* <p>One or more parameters has a value that isn't valid.</p>
80+
*
81+
* @throws {@link ResourceNotFoundException} (client fault)
82+
* <p>One or more resources can't be found.</p>
83+
*
84+
* @throws {@link ThrottlingException} (client fault)
85+
* <p>Access is throttled.</p>
86+
*
87+
* @throws {@link QuickSightServiceException}
88+
* <p>Base exception class for all service exceptions from QuickSight service.</p>
89+
*
90+
* @public
91+
*/
92+
export class DescribeQPersonalizationConfigurationCommand extends $Command
93+
.classBuilder<
94+
DescribeQPersonalizationConfigurationCommandInput,
95+
DescribeQPersonalizationConfigurationCommandOutput,
96+
QuickSightClientResolvedConfig,
97+
ServiceInputTypes,
98+
ServiceOutputTypes
99+
>()
100+
.ep(commonParams)
101+
.m(function (this: any, Command: any, cs: any, config: QuickSightClientResolvedConfig, o: any) {
102+
return [
103+
getSerdePlugin(config, this.serialize, this.deserialize),
104+
getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
105+
];
106+
})
107+
.s("QuickSight_20180401", "DescribeQPersonalizationConfiguration", {})
108+
.n("QuickSightClient", "DescribeQPersonalizationConfigurationCommand")
109+
.f(void 0, void 0)
110+
.ser(se_DescribeQPersonalizationConfigurationCommand)
111+
.de(de_DescribeQPersonalizationConfigurationCommand)
112+
.build() {
113+
/** @internal type navigation helper, not in runtime. */
114+
protected declare static __types: {
115+
api: {
116+
input: DescribeQPersonalizationConfigurationRequest;
117+
output: DescribeQPersonalizationConfigurationResponse;
118+
};
119+
sdk: {
120+
input: DescribeQPersonalizationConfigurationCommandInput;
121+
output: DescribeQPersonalizationConfigurationCommandOutput;
122+
};
123+
};
124+
}

clients/client-quicksight/src/commands/DescribeUserCommand.ts

+2-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ import { Command as $Command } from "@smithy/smithy-client";
55
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { commonParams } from "../endpoint/EndpointParameters";
8-
import { DescribeUserRequest, DescribeUserResponse } from "../models/models_3";
8+
import { DescribeUserRequest } from "../models/models_3";
9+
import { DescribeUserResponse } from "../models/models_4";
910
import { de_DescribeUserCommand, se_DescribeUserCommand } from "../protocols/Aws_restJson1";
1011
import { QuickSightClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../QuickSightClient";
1112

0 commit comments

Comments
 (0)