Skip to content

Commit da68d81

Browse files
AllanZhengYPAllanZhengYP
committed
docs(clients): use interface for client input and resolved config
1 parent 5fe8ed6 commit da68d81

File tree

252 files changed

+3286
-504
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

252 files changed

+3286
-504
lines changed

‎clients/client-accessanalyzer/AccessAnalyzerClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -212,23 +212,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
212212
defaultUserAgentProvider?: Provider<__UserAgent>;
213213
}
214214

215-
export type AccessAnalyzerClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
215+
type AccessAnalyzerClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
216216
ClientDefaults &
217217
RegionInputConfig &
218218
EndpointsInputConfig &
219219
RetryInputConfig &
220220
HostHeaderInputConfig &
221221
AwsAuthInputConfig &
222222
UserAgentInputConfig;
223+
/**
224+
* The configuration interface of AccessAnalyzerClient class constructor that set the region, credentials and other options.
225+
*/
226+
export interface AccessAnalyzerClientConfig extends AccessAnalyzerClientConfigType {}
223227

224-
export type AccessAnalyzerClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
228+
type AccessAnalyzerClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
225229
Required<ClientDefaults> &
226230
RegionResolvedConfig &
227231
EndpointsResolvedConfig &
228232
RetryResolvedConfig &
229233
HostHeaderResolvedConfig &
230234
AwsAuthResolvedConfig &
231235
UserAgentResolvedConfig;
236+
/**
237+
* The resolved configuration interface of AccessAnalyzerClient class. This is resolved and normalized from the {@link AccessAnalyzerClientConfig | constructor configuration interface}.
238+
*/
239+
export interface AccessAnalyzerClientResolvedConfig extends AccessAnalyzerClientResolvedConfigType {}
232240

233241
/**
234242
* <p>AWS IAM Access Analyzer helps identify potential resource-access risks by enabling you to identify
@@ -245,6 +253,9 @@ export class AccessAnalyzerClient extends __Client<
245253
ServiceOutputTypes,
246254
AccessAnalyzerClientResolvedConfig
247255
> {
256+
/**
257+
* The resolved configuration of AccessAnalyzerClient class. This is resolved and normalized from the {@link AccessAnalyzerClientConfig | constructor configuration interface}.
258+
*/
248259
readonly config: AccessAnalyzerClientResolvedConfig;
249260

250261
constructor(configuration: AccessAnalyzerClientConfig) {

‎clients/client-acm-pca/ACMPCAClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -257,23 +257,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
257257
defaultUserAgentProvider?: Provider<__UserAgent>;
258258
}
259259

260-
export type ACMPCAClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
260+
type ACMPCAClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
261261
ClientDefaults &
262262
RegionInputConfig &
263263
EndpointsInputConfig &
264264
RetryInputConfig &
265265
HostHeaderInputConfig &
266266
AwsAuthInputConfig &
267267
UserAgentInputConfig;
268+
/**
269+
* The configuration interface of ACMPCAClient class constructor that set the region, credentials and other options.
270+
*/
271+
export interface ACMPCAClientConfig extends ACMPCAClientConfigType {}
268272

269-
export type ACMPCAClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
273+
type ACMPCAClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
270274
Required<ClientDefaults> &
271275
RegionResolvedConfig &
272276
EndpointsResolvedConfig &
273277
RetryResolvedConfig &
274278
HostHeaderResolvedConfig &
275279
AwsAuthResolvedConfig &
276280
UserAgentResolvedConfig;
281+
/**
282+
* The resolved configuration interface of ACMPCAClient class. This is resolved and normalized from the {@link ACMPCAClientConfig | constructor configuration interface}.
283+
*/
284+
export interface ACMPCAClientResolvedConfig extends ACMPCAClientResolvedConfigType {}
277285

278286
/**
279287
* <note>
@@ -299,6 +307,9 @@ export class ACMPCAClient extends __Client<
299307
ServiceOutputTypes,
300308
ACMPCAClientResolvedConfig
301309
> {
310+
/**
311+
* The resolved configuration of ACMPCAClient class. This is resolved and normalized from the {@link ACMPCAClientConfig | constructor configuration interface}.
312+
*/
302313
readonly config: ACMPCAClientResolvedConfig;
303314

304315
constructor(configuration: ACMPCAClientConfig) {

‎clients/client-acm/ACMClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -206,23 +206,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
206206
defaultUserAgentProvider?: Provider<__UserAgent>;
207207
}
208208

209-
export type ACMClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
209+
type ACMClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
210210
ClientDefaults &
211211
RegionInputConfig &
212212
EndpointsInputConfig &
213213
RetryInputConfig &
214214
HostHeaderInputConfig &
215215
AwsAuthInputConfig &
216216
UserAgentInputConfig;
217+
/**
218+
* The configuration interface of ACMClient class constructor that set the region, credentials and other options.
219+
*/
220+
export interface ACMClientConfig extends ACMClientConfigType {}
217221

218-
export type ACMClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
222+
type ACMClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
219223
Required<ClientDefaults> &
220224
RegionResolvedConfig &
221225
EndpointsResolvedConfig &
222226
RetryResolvedConfig &
223227
HostHeaderResolvedConfig &
224228
AwsAuthResolvedConfig &
225229
UserAgentResolvedConfig;
230+
/**
231+
* The resolved configuration interface of ACMClient class. This is resolved and normalized from the {@link ACMClientConfig | constructor configuration interface}.
232+
*/
233+
export interface ACMClientResolvedConfig extends ACMClientResolvedConfigType {}
226234

227235
/**
228236
* <fullname>AWS Certificate Manager</fullname>
@@ -238,6 +246,9 @@ export class ACMClient extends __Client<
238246
ServiceOutputTypes,
239247
ACMClientResolvedConfig
240248
> {
249+
/**
250+
* The resolved configuration of ACMClient class. This is resolved and normalized from the {@link ACMClientConfig | constructor configuration interface}.
251+
*/
241252
readonly config: ACMClientResolvedConfig;
242253

243254
constructor(configuration: ACMClientConfig) {

‎clients/client-alexa-for-business/AlexaForBusinessClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -545,23 +545,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
545545
defaultUserAgentProvider?: Provider<__UserAgent>;
546546
}
547547

548-
export type AlexaForBusinessClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
548+
type AlexaForBusinessClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
549549
ClientDefaults &
550550
RegionInputConfig &
551551
EndpointsInputConfig &
552552
RetryInputConfig &
553553
HostHeaderInputConfig &
554554
AwsAuthInputConfig &
555555
UserAgentInputConfig;
556+
/**
557+
* The configuration interface of AlexaForBusinessClient class constructor that set the region, credentials and other options.
558+
*/
559+
export interface AlexaForBusinessClientConfig extends AlexaForBusinessClientConfigType {}
556560

557-
export type AlexaForBusinessClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
561+
type AlexaForBusinessClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
558562
Required<ClientDefaults> &
559563
RegionResolvedConfig &
560564
EndpointsResolvedConfig &
561565
RetryResolvedConfig &
562566
HostHeaderResolvedConfig &
563567
AwsAuthResolvedConfig &
564568
UserAgentResolvedConfig;
569+
/**
570+
* The resolved configuration interface of AlexaForBusinessClient class. This is resolved and normalized from the {@link AlexaForBusinessClientConfig | constructor configuration interface}.
571+
*/
572+
export interface AlexaForBusinessClientResolvedConfig extends AlexaForBusinessClientResolvedConfigType {}
565573

566574
/**
567575
* <p>Alexa for Business helps you use Alexa in your organization. Alexa for Business provides you with the tools
@@ -579,6 +587,9 @@ export class AlexaForBusinessClient extends __Client<
579587
ServiceOutputTypes,
580588
AlexaForBusinessClientResolvedConfig
581589
> {
590+
/**
591+
* The resolved configuration of AlexaForBusinessClient class. This is resolved and normalized from the {@link AlexaForBusinessClientConfig | constructor configuration interface}.
592+
*/
582593
readonly config: AlexaForBusinessClientResolvedConfig;
583594

584595
constructor(configuration: AlexaForBusinessClientConfig) {

‎clients/client-amplify/AmplifyClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -290,23 +290,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
290290
defaultUserAgentProvider?: Provider<__UserAgent>;
291291
}
292292

293-
export type AmplifyClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
293+
type AmplifyClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
294294
ClientDefaults &
295295
RegionInputConfig &
296296
EndpointsInputConfig &
297297
RetryInputConfig &
298298
HostHeaderInputConfig &
299299
AwsAuthInputConfig &
300300
UserAgentInputConfig;
301+
/**
302+
* The configuration interface of AmplifyClient class constructor that set the region, credentials and other options.
303+
*/
304+
export interface AmplifyClientConfig extends AmplifyClientConfigType {}
301305

302-
export type AmplifyClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
306+
type AmplifyClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
303307
Required<ClientDefaults> &
304308
RegionResolvedConfig &
305309
EndpointsResolvedConfig &
306310
RetryResolvedConfig &
307311
HostHeaderResolvedConfig &
308312
AwsAuthResolvedConfig &
309313
UserAgentResolvedConfig;
314+
/**
315+
* The resolved configuration interface of AmplifyClient class. This is resolved and normalized from the {@link AmplifyClientConfig | constructor configuration interface}.
316+
*/
317+
export interface AmplifyClientResolvedConfig extends AmplifyClientResolvedConfigType {}
310318

311319
/**
312320
* <p>Amplify enables developers to develop and deploy cloud-powered mobile and web apps.
@@ -322,6 +330,9 @@ export class AmplifyClient extends __Client<
322330
ServiceOutputTypes,
323331
AmplifyClientResolvedConfig
324332
> {
333+
/**
334+
* The resolved configuration of AmplifyClient class. This is resolved and normalized from the {@link AmplifyClientConfig | constructor configuration interface}.
335+
*/
325336
readonly config: AmplifyClientResolvedConfig;
326337

327338
constructor(configuration: AmplifyClientConfig) {

‎clients/client-amplifybackend/AmplifyBackendClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -236,23 +236,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
236236
defaultUserAgentProvider?: Provider<__UserAgent>;
237237
}
238238

239-
export type AmplifyBackendClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
239+
type AmplifyBackendClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
240240
ClientDefaults &
241241
RegionInputConfig &
242242
EndpointsInputConfig &
243243
RetryInputConfig &
244244
HostHeaderInputConfig &
245245
AwsAuthInputConfig &
246246
UserAgentInputConfig;
247+
/**
248+
* The configuration interface of AmplifyBackendClient class constructor that set the region, credentials and other options.
249+
*/
250+
export interface AmplifyBackendClientConfig extends AmplifyBackendClientConfigType {}
247251

248-
export type AmplifyBackendClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
252+
type AmplifyBackendClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
249253
Required<ClientDefaults> &
250254
RegionResolvedConfig &
251255
EndpointsResolvedConfig &
252256
RetryResolvedConfig &
253257
HostHeaderResolvedConfig &
254258
AwsAuthResolvedConfig &
255259
UserAgentResolvedConfig;
260+
/**
261+
* The resolved configuration interface of AmplifyBackendClient class. This is resolved and normalized from the {@link AmplifyBackendClientConfig | constructor configuration interface}.
262+
*/
263+
export interface AmplifyBackendClientResolvedConfig extends AmplifyBackendClientResolvedConfigType {}
256264

257265
/**
258266
* <p>AWS Amplify Admin API</p>
@@ -263,6 +271,9 @@ export class AmplifyBackendClient extends __Client<
263271
ServiceOutputTypes,
264272
AmplifyBackendClientResolvedConfig
265273
> {
274+
/**
275+
* The resolved configuration of AmplifyBackendClient class. This is resolved and normalized from the {@link AmplifyBackendClientConfig | constructor configuration interface}.
276+
*/
266277
readonly config: AmplifyBackendClientResolvedConfig;
267278

268279
constructor(configuration: AmplifyBackendClientConfig) {

‎clients/client-api-gateway/APIGatewayClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -618,23 +618,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
618618
defaultUserAgentProvider?: Provider<__UserAgent>;
619619
}
620620

621-
export type APIGatewayClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
621+
type APIGatewayClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
622622
ClientDefaults &
623623
RegionInputConfig &
624624
EndpointsInputConfig &
625625
RetryInputConfig &
626626
HostHeaderInputConfig &
627627
AwsAuthInputConfig &
628628
UserAgentInputConfig;
629+
/**
630+
* The configuration interface of APIGatewayClient class constructor that set the region, credentials and other options.
631+
*/
632+
export interface APIGatewayClientConfig extends APIGatewayClientConfigType {}
629633

630-
export type APIGatewayClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
634+
type APIGatewayClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
631635
Required<ClientDefaults> &
632636
RegionResolvedConfig &
633637
EndpointsResolvedConfig &
634638
RetryResolvedConfig &
635639
HostHeaderResolvedConfig &
636640
AwsAuthResolvedConfig &
637641
UserAgentResolvedConfig;
642+
/**
643+
* The resolved configuration interface of APIGatewayClient class. This is resolved and normalized from the {@link APIGatewayClientConfig | constructor configuration interface}.
644+
*/
645+
export interface APIGatewayClientResolvedConfig extends APIGatewayClientResolvedConfigType {}
638646

639647
/**
640648
* <fullname>Amazon API Gateway</fullname>
@@ -646,6 +654,9 @@ export class APIGatewayClient extends __Client<
646654
ServiceOutputTypes,
647655
APIGatewayClientResolvedConfig
648656
> {
657+
/**
658+
* The resolved configuration of APIGatewayClient class. This is resolved and normalized from the {@link APIGatewayClientConfig | constructor configuration interface}.
659+
*/
649660
readonly config: APIGatewayClientResolvedConfig;
650661

651662
constructor(configuration: APIGatewayClientConfig) {

‎clients/client-apigatewaymanagementapi/ApiGatewayManagementApiClient.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -155,23 +155,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
155155
defaultUserAgentProvider?: Provider<__UserAgent>;
156156
}
157157

158-
export type ApiGatewayManagementApiClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
158+
type ApiGatewayManagementApiClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
159159
ClientDefaults &
160160
RegionInputConfig &
161161
EndpointsInputConfig &
162162
RetryInputConfig &
163163
HostHeaderInputConfig &
164164
AwsAuthInputConfig &
165165
UserAgentInputConfig;
166+
/**
167+
* The configuration interface of ApiGatewayManagementApiClient class constructor that set the region, credentials and other options.
168+
*/
169+
export interface ApiGatewayManagementApiClientConfig extends ApiGatewayManagementApiClientConfigType {}
166170

167-
export type ApiGatewayManagementApiClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
171+
type ApiGatewayManagementApiClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
168172
Required<ClientDefaults> &
169173
RegionResolvedConfig &
170174
EndpointsResolvedConfig &
171175
RetryResolvedConfig &
172176
HostHeaderResolvedConfig &
173177
AwsAuthResolvedConfig &
174178
UserAgentResolvedConfig;
179+
/**
180+
* The resolved configuration interface of ApiGatewayManagementApiClient class. This is resolved and normalized from the {@link ApiGatewayManagementApiClientConfig | constructor configuration interface}.
181+
*/
182+
export interface ApiGatewayManagementApiClientResolvedConfig extends ApiGatewayManagementApiClientResolvedConfigType {}
175183

176184
/**
177185
* <p>The Amazon API Gateway Management API allows you to directly manage runtime aspects of your deployed APIs. To use it, you must explicitly set the SDK's endpoint to point to the endpoint of your deployed API. The endpoint will be of the form https://{api-id}.execute-api.{region}.amazonaws.com/{stage}, or will be the endpoint corresponding to your API's custom domain and base path, if applicable.</p>
@@ -182,6 +190,9 @@ export class ApiGatewayManagementApiClient extends __Client<
182190
ServiceOutputTypes,
183191
ApiGatewayManagementApiClientResolvedConfig
184192
> {
193+
/**
194+
* The resolved configuration of ApiGatewayManagementApiClient class. This is resolved and normalized from the {@link ApiGatewayManagementApiClientConfig | constructor configuration interface}.
195+
*/
185196
readonly config: ApiGatewayManagementApiClientResolvedConfig;
186197

187198
constructor(configuration: ApiGatewayManagementApiClientConfig) {

‎clients/client-apigatewayv2/ApiGatewayV2Client.ts

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -404,23 +404,31 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
404404
defaultUserAgentProvider?: Provider<__UserAgent>;
405405
}
406406

407-
export type ApiGatewayV2ClientConfig = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
407+
type ApiGatewayV2ClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
408408
ClientDefaults &
409409
RegionInputConfig &
410410
EndpointsInputConfig &
411411
RetryInputConfig &
412412
HostHeaderInputConfig &
413413
AwsAuthInputConfig &
414414
UserAgentInputConfig;
415+
/**
416+
* The configuration interface of ApiGatewayV2Client class constructor that set the region, credentials and other options.
417+
*/
418+
export interface ApiGatewayV2ClientConfig extends ApiGatewayV2ClientConfigType {}
415419

416-
export type ApiGatewayV2ClientResolvedConfig = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
420+
type ApiGatewayV2ClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
417421
Required<ClientDefaults> &
418422
RegionResolvedConfig &
419423
EndpointsResolvedConfig &
420424
RetryResolvedConfig &
421425
HostHeaderResolvedConfig &
422426
AwsAuthResolvedConfig &
423427
UserAgentResolvedConfig;
428+
/**
429+
* The resolved configuration interface of ApiGatewayV2Client class. This is resolved and normalized from the {@link ApiGatewayV2ClientConfig | constructor configuration interface}.
430+
*/
431+
export interface ApiGatewayV2ClientResolvedConfig extends ApiGatewayV2ClientResolvedConfigType {}
424432

425433
/**
426434
* <p>Amazon API Gateway V2</p>
@@ -431,6 +439,9 @@ export class ApiGatewayV2Client extends __Client<
431439
ServiceOutputTypes,
432440
ApiGatewayV2ClientResolvedConfig
433441
> {
442+
/**
443+
* The resolved configuration of ApiGatewayV2Client class. This is resolved and normalized from the {@link ApiGatewayV2ClientConfig | constructor configuration interface}.
444+
*/
434445
readonly config: ApiGatewayV2ClientResolvedConfig;
435446

436447
constructor(configuration: ApiGatewayV2ClientConfig) {

0 commit comments

Comments
 (0)